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

package/dist/pmtiles/pmtiles-loader-with-parser.js

@@ -0,0 +1,41 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { BlobFile } from '@loaders.gl/core/loader-utils';
+import { PMTilesTileSource } from "./pmtiles-source-loader.js";
+import { PMTilesLoader as PMTilesLoaderMetadata } from "./pmtiles-loader.js";
+const { preload: _PMTilesLoaderPreload, ...PMTilesLoaderMetadataWithoutPreload } = PMTilesLoaderMetadata;
+/**
+ * Loader for PMTiles metadata
+ * @note This loader is intended to allow PMTiles to be treated like other file types in top-level loading logic.
+ * @note For actual access to the tile data, use the PMTilesSourceLoader class.
+ */
+export const PMTilesLoaderWithParser = {
+    ...PMTilesLoaderMetadataWithoutPreload,
+    parse: async (arrayBuffer, options) => parseFileAsPMTiles(new BlobFile(new Blob([arrayBuffer])), options),
+    parseFile: parseFileAsPMTiles
+};
+async function parseFileAsPMTiles(file, options) {
+    const source = new PMTilesTileSource(file.handle, {
+        pmtiles: options?.pmtiles || {}
+    });
+    const formatSpecificMetadata = await source.getMetadata();
+    const { tileMIMEType, tilejson = {} } = formatSpecificMetadata;
+    const { layers = [] } = tilejson;
+    switch (tileMIMEType) {
+        case 'application/vnd.mapbox-vector-tile':
+        case 'application/vnd.maplibre-tile':
+            return {
+                shape: 'vector-source',
+                layers: layers.map(layer => ({ name: layer.name, schema: layer.schema })),
+                tables: [],
+                formatSpecificMetadata
+            };
+        case 'image/png':
+        case 'image/jpeg':
+            return { shape: 'image-source', formatSpecificMetadata };
+        default:
+            throw new Error(`PMTilesLoaderWithParser: Unsupported tile MIME type ${tileMIMEType}`);
+    }
+}
+//# sourceMappingURL=pmtiles-loader-with-parser.js.map

package/dist/pmtiles/pmtiles-loader-with-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-loader-with-parser.js","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-loader-with-parser.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,QAAQ,EAAC,MAAM,+BAA+B,CAAC;AAGvD,OAAO,EAAC,iBAAiB,EAA6B,mCAAgC;AACtF,OAAO,EAAC,aAAa,IAAI,qBAAqB,EAAC,4BAAyB;AAExE,MAAM,EAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,mCAAmC,EAAC,GAC5E,qBAAqB,CAAC;AAMxB;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,mCAAmC;IACtC,KAAK,EAAE,KAAK,EAAE,WAAwB,EAAE,OAA8B,EAAE,EAAE,CACxE,kBAAkB,CAAC,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IACpE,SAAS,EAAE,kBAAkB;CAK9B,CAAC;AAEF,KAAK,UAAU,kBAAkB,CAC/B,IAAkB,EAClB,OAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAuB,EAAE;QACjE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;KAChC,CAAC,CAAC;IACH,MAAM,sBAAsB,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,EAAC,YAAY,EAAE,QAAQ,GAAG,EAAE,EAAC,GAAG,sBAAsB,CAAC;IAC7D,MAAM,EAAC,MAAM,GAAG,EAAE,EAAC,GAAG,QAAQ,CAAC;IAC/B,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,oCAAoC,CAAC;QAC1C,KAAK,+BAA+B;YAClC,OAAO;gBACL,KAAK,EAAE,eAAe;gBACtB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC;gBACvE,MAAM,EAAE,EAAE;gBACV,sBAAsB;aACH,CAAC;QACxB,KAAK,WAAW,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,EAAC,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAoB,CAAC;QAC5E;YACE,MAAM,IAAI,KAAK,CAAC,uDAAuD,YAAY,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC"}

package/dist/pmtiles/pmtiles-loader.d.ts

@@ -0,0 +1,41 @@
+import type { LoaderOptions } from '@loaders.gl/core/loader-utils';
+import { VectorSourceInfo, ImageSourceInfo } from "./source-info.js";
+import type { PMTilesSourceLoaderOptions } from "./pmtiles-source-loader.js";
+export type PMTilesLoaderOptions = LoaderOptions & {
+    pmtiles?: PMTilesSourceLoaderOptions['pmtiles'];
+};
+/** Preloads the parser-bearing PMTiles loader implementation. */
+declare function preload(): Promise<{
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: import("./pmtiles-loader-with-parser").PMTilesLoaderOptions) => Promise<VectorSourceInfo | ImageSourceInfo>;
+    readonly parseFile: (file: import("@loaders.gl/core/loader-utils").ReadableFile, options?: import("./pmtiles-loader-with-parser").PMTilesLoaderOptions) => Promise<VectorSourceInfo | ImageSourceInfo>;
+    readonly version: any;
+    readonly options: {
+        readonly pmtiles: {};
+    };
+    readonly name: "PMTiles";
+    readonly id: "pmtiles";
+    readonly module: "tiles";
+    readonly encoding: "binary";
+    readonly format: "pmtiles";
+    readonly extensions: ["pmtiles"];
+    readonly mimeTypes: ["application/vnd.pmtiles", "application/octet-stream"];
+    readonly tests: ["PMTiles"];
+}>;
+/** Metadata-only loader for PMTiles metadata. */
+export declare const PMTilesLoader: {
+    readonly version: any;
+    readonly options: {
+        readonly pmtiles: {};
+    };
+    readonly preload: typeof preload;
+    readonly name: "PMTiles";
+    readonly id: "pmtiles";
+    readonly module: "tiles";
+    readonly encoding: "binary";
+    readonly format: "pmtiles";
+    readonly extensions: ["pmtiles"];
+    readonly mimeTypes: ["application/vnd.pmtiles", "application/octet-stream"];
+    readonly tests: ["PMTiles"];
+};
+export {};
+//# sourceMappingURL=pmtiles-loader.d.ts.map

package/dist/pmtiles/pmtiles-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-loader.d.ts","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,aAAa,EAAC,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAC,gBAAgB,EAAE,eAAe,EAAC,yBAAsB;AAChE,OAAO,KAAK,EAAC,0BAA0B,EAAC,mCAAgC;AAGxE,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,OAAO,CAAC,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;CACjD,CAAC;AAEF,iEAAiE;AACjE,iBAAe,OAAO;;;;;;;;;;;;;;;GAGrB;AAED,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;CAOkE,CAAC"}

package/dist/pmtiles/pmtiles-loader.js

@@ -0,0 +1,20 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { VERSION } from "./lib/version.js";
+import { PMTilesFormat } from "./pmtiles-format.js";
+/** Preloads the parser-bearing PMTiles loader implementation. */
+async function preload() {
+    const { PMTilesLoaderWithParser } = await import("./pmtiles-loader-with-parser.js");
+    return PMTilesLoaderWithParser;
+}
+/** Metadata-only loader for PMTiles metadata. */
+export const PMTilesLoader = {
+    ...PMTilesFormat,
+    version: VERSION,
+    options: {
+        pmtiles: {}
+    },
+    preload
+};
+//# sourceMappingURL=pmtiles-loader.js.map

package/dist/pmtiles/pmtiles-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-loader.js","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,OAAO,EAAC,yBAAsB;AAItC,OAAO,EAAC,aAAa,EAAC,4BAAyB;AAM/C,iEAAiE;AACjE,KAAK,UAAU,OAAO;IACpB,MAAM,EAAC,uBAAuB,EAAC,GAAG,MAAM,MAAM,mCAAgC,CAAC;IAC/E,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,aAAa;IAChB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,EAAE;KACZ;IACD,OAAO;CACmF,CAAC"}

package/dist/pmtiles/pmtiles-source-loader.d.ts

@@ -0,0 +1,85 @@
+import type { GeoArrowEncodingPreference, Schema } from '@loaders.gl/core/schema';
+import type { CoreAPI, VectorTile, VectorTileSource, GetTileParameters, GetTileDataParameters, ImageTileSource, ImageType, RangeRequestSchedulerProps } from '@loaders.gl/core/loader-utils';
+import { DataSource, DataSourceOptions } from '@loaders.gl/core/loader-utils';
+import { ImageBitmapLoaderOptions } from '@loaders.gl/images';
+import { MLTLoaderOptions } from '@loaders.gl/tiles/mlt';
+import { MVTLoaderOptions, TileJSONLoaderOptions } from '@loaders.gl/tiles/mvt';
+import * as pmtiles from 'pmtiles';
+import type { PMTilesMetadata } from "./lib/parse-pmtiles.js";
+/** Range request options for PMTiles URL sources. */
+export type PMTilesRangeRequestOptions = RangeRequestSchedulerProps & {
+    /** Reserved concurrency hint for range-request transports. */
+    maxConcurrentRequests?: number;
+};
+export type PMTilesSourceLoaderOptions = DataSourceOptions & TileJSONLoaderOptions & MLTLoaderOptions & MVTLoaderOptions & ImageBitmapLoaderOptions & {
+    /** Preferred encoding for Arrow geometry output. */
+    geoarrow?: {
+        encodingPreference?: GeoArrowEncodingPreference;
+    };
+    pmtiles?: {
+        /** Explicit source CRS contract; PMTiles addressing alone does not establish geographic geometry. */
+        coordinateReferenceSystem?: 'EPSG:3857';
+        /** Logical XYZ pixel frame, independent of encoded tile dimensions or vector extent. */
+        tileSize?: number;
+        /** Shape of returned vector tile data. */
+        shape?: 'geojson-table' | 'columnar-table' | 'binary-geometry' | 'arrow-table';
+        /** Preferred encoding for Arrow geometry output. */
+        geoarrow?: {
+            encodingPreference?: GeoArrowEncodingPreference;
+        };
+    };
+    rangeRequests?: PMTilesRangeRequestOptions;
+};
+/**
+ * Creates vector tile data sources for PMTiles urls or blobs
+ */
+export declare const PMTilesSourceLoader: {
+    readonly version: "1.0.0";
+    readonly type: "pmtiles";
+    readonly fromUrl: true;
+    readonly fromBlob: true;
+    readonly options: {
+        readonly pmtiles: {
+            readonly shape: "arrow-table";
+        };
+    };
+    readonly defaultOptions: {
+        readonly pmtiles: {};
+    };
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string | Blob, options: PMTilesSourceLoaderOptions, coreApi?: CoreAPI) => PMTilesTileSource;
+    readonly name: "PMTiles";
+    readonly id: "pmtiles";
+    readonly module: "tiles";
+    readonly encoding: "binary";
+    readonly format: "pmtiles";
+    readonly extensions: ["pmtiles"];
+    readonly mimeTypes: ["application/vnd.pmtiles", "application/octet-stream"];
+    readonly tests: ["PMTiles"];
+    readonly dataType: PMTilesTileSource;
+    readonly batchType: never;
+};
+/**
+ * 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 PMTilesTileSource extends DataSource<string | Blob, PMTilesSourceLoaderOptions> implements ImageTileSource, VectorTileSource {
+    mimeType: string | null;
+    pmtiles: pmtiles.PMTiles;
+    metadata: Promise<PMTilesMetadata>;
+    private pendingTileRequests;
+    private tileBatchTimer;
+    constructor(data: string | Blob, options: PMTilesSourceLoaderOptions, coreApi?: CoreAPI);
+    getSchema(): Promise<Schema>;
+    getMetadata(): Promise<PMTilesMetadata>;
+    getTile(tileParams: GetTileParameters): Promise<ArrayBuffer | null>;
+    getTileData(tileParams: GetTileDataParameters): Promise<any>;
+    getTileBatch(tileParams: readonly GetTileParameters[]): readonly Promise<ArrayBuffer | null>[];
+    getTileDataBatch(tileParams: readonly GetTileDataParameters[]): readonly Promise<any>[];
+    getImageTile(tileParams: GetTileParameters): Promise<ImageType | null>;
+    getVectorTile(tileParams: GetTileParameters): Promise<VectorTile | null>;
+    private getZxyBatched;
+    private scheduleTileBatch;
+    private flushTileBatch;
+}
+//# sourceMappingURL=pmtiles-source-loader.d.ts.map

package/dist/pmtiles/pmtiles-source-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-source-loader.d.ts","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-source-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,0BAA0B,EAAE,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EACV,OAAO,EAEP,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,UAAU,EACV,iBAAiB,EAIlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAoB,wBAAwB,EAAC,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAY,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAY,gBAAgB,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAGzF,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAOzD,qDAAqD;AACrD,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,GAAG;IACpE,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,iBAAiB,GACxD,qBAAqB,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,wBAAwB,GAAG;IACzB,oDAAoD;IACpD,QAAQ,CAAC,EAAE;QAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAA;KAAC,CAAC;IAC7D,OAAO,CAAC,EAAE;QACR,qGAAqG;QACrG,yBAAyB,CAAC,EAAE,WAAW,CAAC;QACxC,wFAAwF;QACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,0CAA0C;QAC1C,KAAK,CAAC,EAAE,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,aAAa,CAAC;QAC/E,oDAAoD;QACpD,QAAQ,CAAC,EAAE;YAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAA;SAAC,CAAC;KAC9D,CAAC;IACF,aAAa,CAAC,EAAE,0BAA0B,CAAC;CAC5C,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;4BAmBf,MAAM;qCACG,MAAM,GAAG,IAAI,WAAW,0BAA0B,YAAY,OAAO;;;;;;;;;uBAnBhE,iBAAiB;wBAC3B,KAAK;CAoB0B,CAAC;AAErD;;;GAGG;AACH,qBAAa,iBACX,SAAQ,UAAU,CAAC,MAAM,GAAG,IAAI,EAAE,0BAA0B,CAC5D,YAAW,eAAe,EAAE,gBAAgB;IAE5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,cAAc,CAA8C;gBAExD,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,0BAA0B,EAAE,OAAO,CAAC,EAAE,OAAO;IAgBjF,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IA0BvC,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA+BnE,WAAW,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC;IA0BlE,YAAY,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE;IAI9F,gBAAgB,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,OAAO,CAAC,GAAG,CAAC,EAAE;IAMjF,YAAY,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAStE,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqD9E,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;CAevB"}

package/dist/pmtiles/pmtiles-source-loader.js

@@ -0,0 +1,239 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { DataSource, resolvePath, resolveXYZTileParameters, waitForPromiseWithSignal } from '@loaders.gl/core/loader-utils';
+import { ImageBitmapLoader } from '@loaders.gl/images';
+import { MLTLoader } from '@loaders.gl/tiles/mlt';
+import { MVTLoader } from '@loaders.gl/tiles/mvt';
+import { PMTilesFormat } from "./pmtiles-format.js";
+import * as pmtiles from 'pmtiles';
+const { PMTiles } = pmtiles;
+import { parsePMTilesHeader } from "./lib/parse-pmtiles.js";
+import { BlobSource } from "./lib/blob-source.js";
+import { RangeRequestSource } from "./lib/range-request-source.js";
+const VERSION = '1.0.0';
+/**
+ * Creates vector tile data sources for PMTiles urls or blobs
+ */
+export const PMTilesSourceLoader = {
+    dataType: null,
+    batchType: null,
+    ...PMTilesFormat,
+    version: VERSION,
+    type: 'pmtiles',
+    fromUrl: true,
+    fromBlob: true,
+    options: {
+        pmtiles: {
+            shape: 'arrow-table'
+        }
+    },
+    defaultOptions: {
+        pmtiles: {}
+    },
+    testURL: (url) => url.endsWith('.pmtiles'),
+    createDataSource: (url, options, coreApi) => new PMTilesTileSource(url, options, coreApi)
+};
+/**
+ * A PMTiles data source
+ * @note Can be either a raster or vector tile source depending on the contents of the PMTiles file.
+ */
+export class PMTilesTileSource extends DataSource {
+    mimeType = null;
+    pmtiles;
+    metadata;
+    pendingTileRequests = [];
+    tileBatchTimer = null;
+    constructor(data, options, coreApi) {
+        super(data, options, PMTilesSourceLoader.defaultOptions, coreApi);
+        const rangeRequestOptions = options.rangeRequests;
+        const urlOrBlob = typeof data === 'string'
+            ? new RangeRequestSource(resolvePath(data), {
+                ...rangeRequestOptions,
+                batchDelayMs: 0,
+                fetch: this.fetch
+            })
+            : new BlobSource(data, 'pmtiles');
+        this.pmtiles = new PMTiles(urlOrBlob);
+        this.getTileData = this.getTileData.bind(this);
+        this.metadata = this.getMetadata();
+    }
+    async getSchema() {
+        return { fields: [], metadata: {} };
+    }
+    async getMetadata() {
+        const pmtilesHeader = await this.pmtiles.getHeader();
+        const pmtilesMetadata = (await this.pmtiles.getMetadata()) || {};
+        const metadata = parsePMTilesHeader(pmtilesHeader, pmtilesMetadata, {
+            includeFormatHeader: false,
+            coordinateReferenceSystem: this.options.pmtiles?.coordinateReferenceSystem,
+            tileSize: this.options.pmtiles?.tileSize
+        }, this.loadOptions);
+        // Add additional attribution if necessary
+        if (this.options.attributions) {
+            metadata.attributions = [
+                ...(this.options.core?.attributions || []),
+                ...(metadata.attributions || [])
+            ];
+        }
+        if (metadata?.tileMIMEType) {
+            this.mimeType = metadata?.tileMIMEType;
+        }
+        return metadata;
+    }
+    async getTile(tileParams) {
+        const resolved = resolveXYZTileParameters((await waitForPromiseWithSignal(this.metadata, tileParams.signal)).tileGrid, tileParams);
+        if (!resolved)
+            return null;
+        const { x, y, z } = resolved;
+        let rangeResponse;
+        try {
+            rangeResponse = await this.getZxyBatched(z, x, y, tileParams.signal);
+        }
+        catch (error) {
+            if (tileParams.signal?.aborted)
+                throw tileParams.signal.reason;
+            if (error instanceof Error && error.name === 'AbortError')
+                throw error;
+            this.reportError(error, `Failed to fetch tile ${this.url} ${JSON.stringify(tileParams)}`);
+            return null;
+        }
+        if (tileParams.signal?.aborted)
+            throw tileParams.signal.reason;
+        const arrayBuffer = rangeResponse?.data;
+        if (!arrayBuffer) {
+            this.reportError(new Error('Empty tile response'), `Failed to fetch tile ${this.url} ${JSON.stringify(tileParams)}`);
+            return null;
+        }
+        return arrayBuffer;
+    }
+    // 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;
+        const metadata = await waitForPromiseWithSignal(this.metadata, tileParams.signal);
+        switch (metadata.tileMIMEType) {
+            case 'application/vnd.mapbox-vector-tile':
+            case 'application/vnd.maplibre-tile':
+                return await this.getVectorTile({
+                    x,
+                    y,
+                    z,
+                    layers: [],
+                    tileMatrix: tileParams.tileMatrix,
+                    signal: tileParams.signal
+                });
+            default:
+                return await this.getImageTile({
+                    x,
+                    y,
+                    z,
+                    layers: [],
+                    tileMatrix: tileParams.tileMatrix,
+                    signal: tileParams.signal
+                });
+        }
+    }
+    getTileBatch(tileParams) {
+        return tileParams.map(tileParam => this.getTile(tileParam));
+    }
+    getTileDataBatch(tileParams) {
+        return tileParams.map(tileParam => this.getTileData(tileParam));
+    }
+    // ImageTileSource interface implementation
+    async getImageTile(tileParams) {
+        const arrayBuffer = await this.getTile(tileParams);
+        return arrayBuffer
+            ? (await this.coreApi.parse(arrayBuffer, ImageBitmapLoader, this.loadOptions))
+            : null;
+    }
+    // VectorTileSource interface implementation
+    async getVectorTile(tileParams) {
+        const metadata = await waitForPromiseWithSignal(this.metadata, tileParams.signal);
+        const resolved = resolveXYZTileParameters(metadata.tileGrid, tileParams);
+        if (!resolved)
+            return null;
+        tileParams = resolved;
+        const arrayBuffer = await this.getTile(tileParams);
+        const tileMIMEType = this.mimeType || metadata?.tileMIMEType;
+        if (tileMIMEType === 'application/vnd.maplibre-tile') {
+            const inheritedMLTOptions = this.loadOptions?.mlt;
+            const loadOptions = {
+                ...this.loadOptions,
+                mlt: {
+                    ...inheritedMLTOptions,
+                    shape: getMLTShape(this.options.pmtiles?.shape) || inheritedMLTOptions?.shape || 'arrow-table',
+                    coordinates: 'wgs84',
+                    tileIndex: { x: tileParams.x, y: tileParams.y, z: tileParams.z },
+                    layers: normalizeTileLayers(tileParams.layers) || inheritedMLTOptions?.layers,
+                    geoarrow: this.options.geoarrow ||
+                        this.options.pmtiles?.geoarrow ||
+                        inheritedMLTOptions?.geoarrow
+                }
+            };
+            return arrayBuffer
+                ? (await this.coreApi.parse(arrayBuffer, MLTLoader, loadOptions))
+                : null;
+        }
+        const inheritedMVTOptions = this.loadOptions?.mvt;
+        const selectedLayers = normalizeTileLayers(tileParams.layers) || inheritedMVTOptions?.layers;
+        const loadOptions = {
+            ...this.loadOptions,
+            mvt: {
+                ...inheritedMVTOptions,
+                shape: this.options.pmtiles?.shape || inheritedMVTOptions?.shape || 'arrow-table',
+                coordinates: 'wgs84',
+                tileIndex: { x: tileParams.x, y: tileParams.y, z: tileParams.z },
+                layers: selectedLayers,
+                geoarrow: this.options.geoarrow ||
+                    this.options.pmtiles?.geoarrow ||
+                    inheritedMVTOptions?.geoarrow
+            }
+        };
+        return arrayBuffer
+            ? (await this.coreApi.parse(arrayBuffer, MVTLoader, loadOptions))
+            : null;
+    }
+    getZxyBatched(z, x, y, signal) {
+        if (this.data instanceof Blob) {
+            return this.pmtiles.getZxy(z, x, y, signal);
+        }
+        return new Promise((resolve, reject) => {
+            this.pendingTileRequests.push({ z, x, y, signal, resolve, reject });
+            this.scheduleTileBatch();
+        });
+    }
+    scheduleTileBatch() {
+        if (this.tileBatchTimer) {
+            return;
+        }
+        const batchDelayMs = this.options.rangeRequests?.batchDelayMs ?? 50;
+        this.tileBatchTimer = setTimeout(() => this.flushTileBatch(), batchDelayMs);
+    }
+    flushTileBatch() {
+        if (this.tileBatchTimer) {
+            clearTimeout(this.tileBatchTimer);
+            this.tileBatchTimer = null;
+        }
+        const pendingTileRequests = this.pendingTileRequests;
+        this.pendingTileRequests = [];
+        for (const tileRequest of pendingTileRequests) {
+            this.pmtiles
+                .getZxy(tileRequest.z, tileRequest.x, tileRequest.y, tileRequest.signal)
+                .then(tileRequest.resolve, tileRequest.reject);
+        }
+    }
+}
+/** Normalizes a non-empty tile layer selection for the MVT decoder. */
+function normalizeTileLayers(layers) {
+    const normalizedLayers = typeof layers === 'string' ? [layers] : layers;
+    return normalizedLayers?.length ? normalizedLayers : undefined;
+}
+/** Returns a shape supported by the MLT decoder. */
+function getMLTShape(shape) {
+    if (shape === 'columnar-table') {
+        throw new Error('PMTilesTileSource: columnar-table shape is not supported for MLT tiles');
+    }
+    return shape;
+}
+//# sourceMappingURL=pmtiles-source-loader.js.map

package/dist/pmtiles/pmtiles-source-loader.js.map

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

package/dist/pmtiles/pmtiles-writer-types.d.ts

@@ -0,0 +1,39 @@
+/** One encoded tile, addressed using the XYZ convention (north-origin Y). */
+export interface PMTilesTile {
+    /** Tile zoom, an integer from 0 through 26. */
+    readonly z: number;
+    /** Tile column at this zoom. */
+    readonly x: number;
+    /** Tile row at this zoom. */
+    readonly y: number;
+    /** Encoded payload; views preserve their byte offset and length. */
+    readonly data: ArrayBuffer | ArrayBufferView | Blob;
+}
+/** Explicit finite tile enumeration; async iteration does not imply streaming output. */
+export type PMTilesTileInput = Iterable<PMTilesTile> | AsyncIterable<PMTilesTile>;
+/** A single payload format applies to every tile in the archive. */
+export type PMTilesTileType = 'mvt' | 'mlt' | 'png' | 'jpeg' | 'webp' | 'avif';
+/** Encoding controls for a bounded, in-memory PMTiles v3 archive. */
+export type PMTilesEncodeOptions = {
+    /** Declares the existing payload format; required, never inferred from opaque bytes. */
+    readonly tileType: PMTilesTileType;
+    /** Existing compression of all payloads; default none. Payloads are not recompressed. */
+    readonly tileCompression?: 'none' | 'gzip' | 'brotli' | 'zstd';
+    /** Directory and metadata compression; default none. */
+    readonly internalCompression?: 'none' | 'gzip';
+    /** JSON metadata. MVT requires TileJSON vector_layers with layer IDs and fields. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    /** Geographic bounds [west, south, east, north]; defaults to selected tile footprints. */
+    readonly bounds?: readonly [number, number, number, number];
+    /** Initial view [longitude, latitude, zoom]; defaults to bounds midpoint and minimum zoom. */
+    readonly center?: readonly [number, number, number];
+    /** Maximum enumerated tiles; default 100,000. */
+    readonly maxTiles?: number;
+    /** Maximum archive bytes, including headers and directories; default 256 MiB. */
+    readonly maxOutputBytes?: number;
+    /** Maximum UTF-8 JSON metadata bytes before compression; default 1 MiB. */
+    readonly maxMetadataBytes?: number;
+    /** Cancellation checked during enumeration and between encoding stages. */
+    readonly signal?: AbortSignal;
+};
+//# sourceMappingURL=pmtiles-writer-types.d.ts.map

package/dist/pmtiles/pmtiles-writer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-writer-types.d.ts","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-writer-types.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,CAAC;CACrD;AAED,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAElF,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/E,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG;IACjC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,yFAAyF;IACzF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/D,wDAAwD;IACxD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5D,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC"}

package/dist/{point-cloud-tile-source-types.js → pmtiles/pmtiles-writer-types.js}

@@ -2,4 +2,4 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 export {};
-//# sourceMappingURL=point-cloud-tile-source-types.js.map
+//# sourceMappingURL=pmtiles-writer-types.js.map

package/dist/pmtiles/pmtiles-writer-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-writer-types.js","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-writer-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC"}

package/dist/pmtiles/pmtiles-writer.d.ts

@@ -0,0 +1,22 @@
+import type { WriterOptions } from '@loaders.gl/core/loader-utils';
+import type { PMTilesEncodeOptions, PMTilesTileInput } from "./pmtiles-writer-types.js";
+/** Options for packaging already encoded tiles with the standard writer API. */
+export type PMTilesWriterOptions = WriterOptions & {
+    /** Archive format, metadata, compression declarations and resource budgets. */
+    pmtiles?: PMTilesEncodeOptions;
+};
+/** Bounded, portable PMTiles v3 writer; tile payloads are copied without transcoding. */
+export declare const PMTilesWriter: {
+    readonly version: any;
+    readonly options: {};
+    readonly encode: (tiles: PMTilesTileInput, options?: PMTilesWriterOptions) => Promise<ArrayBuffer>;
+    readonly name: "PMTiles";
+    readonly id: "pmtiles";
+    readonly module: "tiles";
+    readonly encoding: "binary";
+    readonly format: "pmtiles";
+    readonly extensions: ["pmtiles"];
+    readonly mimeTypes: ["application/vnd.pmtiles", "application/octet-stream"];
+    readonly tests: ["PMTiles"];
+};
+//# sourceMappingURL=pmtiles-writer.d.ts.map

package/dist/pmtiles/pmtiles-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-writer.d.ts","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAoB,MAAM,+BAA+B,CAAC;AAGpF,OAAO,KAAK,EAAC,oBAAoB,EAAE,gBAAgB,EAAC,kCAA+B;AAKnF,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,+EAA+E;IAC/E,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,aAAa;;;6BAIR,gBAAgB,YAAY,oBAAoB,KAAG,OAAO,CAAC,WAAW,CAAC;;;;;;;;;CAEJ,CAAC"}

package/dist/pmtiles/pmtiles-writer.js

@@ -0,0 +1,15 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { PMTilesFormat } from "./pmtiles-format.js";
+import { encodePMTiles } from "./lib/encode-pmtiles.js";
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof "5.0.0-alpha.13" !== 'undefined' ? "5.0.0-alpha.13" : 'latest';
+/** Bounded, portable PMTiles v3 writer; tile payloads are copied without transcoding. */
+export const PMTilesWriter = {
+    ...PMTilesFormat,
+    version: VERSION,
+    options: {},
+    encode: (tiles, options) => encodePMTiles(tiles, options?.pmtiles)
+};
+//# sourceMappingURL=pmtiles-writer.js.map

package/dist/pmtiles/pmtiles-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-writer.js","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-writer.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,aAAa,EAAC,4BAAyB;AAC/C,OAAO,EAAC,aAAa,EAAC,gCAA6B;AAGnD,qDAAqD;AACrD,MAAM,OAAO,GAAG,uBAAkB,KAAK,WAAW,CAAC,CAAC,kBAAa,CAAC,CAAC,QAAQ,CAAC;AAQ5E,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,aAAa;IAChB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,CAAC,KAAuB,EAAE,OAA8B,EAAwB,EAAE,CACxF,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC;CAC2C,CAAC"}