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

package/dist/pmtiles/lib/encode-pmtiles.js

@@ -0,0 +1,268 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { GZipCompressor } from '@loaders.gl/compression';
+import { zxyToTileId } from 'pmtiles';
+/** PMTiles v3 has a fixed header and a root constrained to the first 16 KiB. */
+const HEADER_BYTES = 127;
+const MAX_ROOT_BYTES = 16384 - HEADER_BYTES;
+/** Payload type values defined by the PMTiles v3 specification. */
+const TILE_TYPES = { mvt: 1, png: 2, jpeg: 3, webp: 4, avif: 5, mlt: 6 };
+/** Compression values describe existing payload bytes or encoded internal sections. */
+const COMPRESSIONS = { none: 1, gzip: 2, brotli: 3, zstd: 4 };
+/**
+ * Packages explicit encoded XYZ tiles into a deterministic PMTiles v3 ArrayBuffer.
+ * Input payloads are opaque and must all match the declared format and compression.
+ * The input snapshots and complete output coexist in memory; this is not an out-of-core writer.
+ */
+export async function encodePMTiles(input, options) {
+    options?.signal?.throwIfAborted();
+    if (!options || !Object.hasOwn(TILE_TYPES, options.tileType))
+        throw new TypeError('PMTiles requires a supported tileType');
+    options = {
+        ...options,
+        bounds: options.bounds?.slice(),
+        center: options.center?.slice()
+    };
+    const tileCompression = options.tileCompression ?? 'none';
+    const internalCompression = options.internalCompression ?? 'none';
+    if (!Object.hasOwn(COMPRESSIONS, tileCompression) ||
+        !['none', 'gzip'].includes(internalCompression))
+        throw new TypeError('Unsupported PMTiles compression');
+    const maxTiles = validateLimit(options.maxTiles ?? 100000, 'tile');
+    const maxOutputBytes = validateLimit(options.maxOutputBytes ?? 256 * 1024 * 1024, 'output');
+    const maxMetadataBytes = validateLimit(options.maxMetadataBytes ?? 1024 * 1024, 'metadata');
+    const metadata = encodeMetadata(options.metadata ?? {}, options.tileType === 'mvt', maxMetadataBytes);
+    const tiles = [];
+    const tileIds = new Set();
+    const bounds = [180, 90, -180, -90];
+    let minZoom = 26;
+    let maxZoom = 0;
+    let payloadBytes = 0;
+    for await (const tile of input) {
+        options.signal?.throwIfAborted();
+        if (tiles.length >= maxTiles)
+            throw new RangeError('PMTiles tile limit exceeded');
+        if (!Number.isInteger(tile.z) ||
+            tile.z < 0 ||
+            tile.z > 26 ||
+            !Number.isInteger(tile.x) ||
+            !Number.isInteger(tile.y) ||
+            tile.x < 0 ||
+            tile.y < 0 ||
+            tile.x >= 2 ** tile.z ||
+            tile.y >= 2 ** tile.z)
+            throw new RangeError('Invalid PMTiles XYZ tile coordinate');
+        const tileId = zxyToTileId(tile.z, tile.x, tile.y);
+        if (tileIds.has(tileId))
+            throw new Error('Duplicate PMTiles tile coordinate');
+        const data = tile.data;
+        if (!(data instanceof Blob) && !(data instanceof ArrayBuffer) && !ArrayBuffer.isView(data))
+            throw new TypeError('PMTiles tile data must be a Blob, ArrayBuffer or typed-array view');
+        const size = data instanceof Blob ? data.size : data.byteLength;
+        if (!size)
+            throw new RangeError('PMTiles tile payload must be nonempty');
+        payloadBytes += size;
+        if (HEADER_BYTES + payloadBytes > maxOutputBytes)
+            throw new RangeError('PMTiles output limit exceeded');
+        const bytes = data instanceof Blob
+            ? new Uint8Array(await data.arrayBuffer())
+            : data instanceof ArrayBuffer
+                ? new Uint8Array(data).slice()
+                : new Uint8Array(data.buffer, data.byteOffset, data.byteLength).slice();
+        options.signal?.throwIfAborted();
+        tileIds.add(tileId);
+        tiles.push({ tileId, bytes });
+        minZoom = Math.min(minZoom, tile.z);
+        maxZoom = Math.max(maxZoom, tile.z);
+        const width = 2 ** tile.z;
+        bounds[0] = Math.min(bounds[0], (tile.x / width) * 360 - 180);
+        bounds[1] = Math.min(bounds[1], getLatitude((tile.y + 1) / width));
+        bounds[2] = Math.max(bounds[2], ((tile.x + 1) / width) * 360 - 180);
+        bounds[3] = Math.max(bounds[3], getLatitude(tile.y / width));
+    }
+    if (!tiles.length)
+        throw new RangeError('PMTiles requires at least one tile');
+    const outputBounds = options.bounds ?? bounds;
+    validateBounds(outputBounds);
+    const center = options.center ?? [
+        (outputBounds[0] + outputBounds[2]) / 2,
+        (outputBounds[1] + outputBounds[3]) / 2,
+        minZoom
+    ];
+    if (center.length !== 3 ||
+        !Number.isFinite(center[0]) ||
+        Math.abs(center[0]) > 180 ||
+        !Number.isFinite(center[1]) ||
+        Math.abs(center[1]) > 90 ||
+        !Number.isInteger(center[2]) ||
+        center[2] < minZoom ||
+        center[2] > maxZoom)
+        throw new RangeError('Invalid PMTiles center');
+    tiles.sort((first, second) => first.tileId - second.tileId);
+    let offset = 0;
+    const entries = tiles.map(tile => {
+        const entry = { tileId: tile.tileId, offset, length: tile.bytes.byteLength, runLength: 1 };
+        offset += entry.length;
+        return entry;
+    });
+    /** Compresses internal sections with the shared first-party codec, when requested. */
+    const compress = async (bytes) => {
+        options.signal?.throwIfAborted();
+        const result = internalCompression === 'gzip'
+            ? new Uint8Array(await new GZipCompressor().compress(bytes.buffer))
+            : bytes;
+        options.signal?.throwIfAborted();
+        return result;
+    };
+    let root = await compress(encodeDirectory(entries));
+    const leaves = [];
+    let leafBytes = 0;
+    if (root.byteLength > MAX_ROOT_BYTES) {
+        const pointers = [];
+        // Bound root entries even at zoom 26 with large offset varints.
+        const entriesPerLeaf = Math.max(1024, Math.ceil(entries.length / 512));
+        for (let index = 0; index < entries.length; index += entriesPerLeaf) {
+            const leaf = await compress(encodeDirectory(entries.slice(index, index + entriesPerLeaf)));
+            pointers.push({
+                tileId: entries[index].tileId,
+                offset: leafBytes,
+                length: leaf.byteLength,
+                runLength: 0
+            });
+            leaves.push(leaf);
+            leafBytes += leaf.byteLength;
+            if (HEADER_BYTES + leafBytes + payloadBytes > maxOutputBytes)
+                throw new RangeError('PMTiles output limit exceeded');
+        }
+        root = await compress(encodeDirectory(pointers));
+    }
+    if (root.byteLength > MAX_ROOT_BYTES)
+        throw new RangeError('PMTiles root directory limit exceeded');
+    const encodedMetadata = await compress(metadata);
+    const metadataOffset = HEADER_BYTES + root.byteLength;
+    const leafOffset = metadataOffset + encodedMetadata.byteLength;
+    const tileOffset = leafOffset + leafBytes;
+    const outputLength = tileOffset + payloadBytes;
+    if (outputLength > maxOutputBytes)
+        throw new RangeError('PMTiles output limit exceeded');
+    const output = new Uint8Array(outputLength);
+    output.set(new TextEncoder().encode('PMTiles'));
+    output[7] = 3;
+    const header = new DataView(output.buffer);
+    const fields = [
+        HEADER_BYTES,
+        root.byteLength,
+        metadataOffset,
+        encodedMetadata.byteLength,
+        leafOffset,
+        leafBytes,
+        tileOffset,
+        payloadBytes,
+        tiles.length,
+        tiles.length,
+        tiles.length
+    ];
+    fields.forEach((value, index) => header.setBigUint64(8 + index * 8, BigInt(value), true));
+    output.set([
+        1,
+        COMPRESSIONS[internalCompression],
+        COMPRESSIONS[tileCompression],
+        TILE_TYPES[options.tileType],
+        minZoom,
+        maxZoom
+    ], 96);
+    outputBounds.forEach((value, index) => header.setInt32(102 + index * 4, Math.round(value * 1e7), true));
+    output[118] = center[2];
+    header.setInt32(119, Math.round(center[0] * 1e7), true);
+    header.setInt32(123, Math.round(center[1] * 1e7), true);
+    offset = HEADER_BYTES;
+    for (const section of [root, encodedMetadata, ...leaves, ...tiles.map(tile => tile.bytes)]) {
+        output.set(section, offset);
+        offset += section.byteLength;
+    }
+    options.signal?.throwIfAborted();
+    return output.buffer;
+}
+/** Serializes directory columns with delta tile IDs and contiguous offset markers. */
+function encodeDirectory(entries) {
+    const bytes = [];
+    writeVarint(bytes, entries.length);
+    let previousTileId = 0;
+    for (const entry of entries) {
+        writeVarint(bytes, entry.tileId - previousTileId);
+        previousTileId = entry.tileId;
+    }
+    for (const entry of entries)
+        writeVarint(bytes, entry.runLength);
+    for (const entry of entries)
+        writeVarint(bytes, entry.length);
+    for (let index = 0; index < entries.length; index++) {
+        const entry = entries[index];
+        const previous = entries[index - 1];
+        writeVarint(bytes, previous && entry.offset === previous.offset + previous.length ? 0 : entry.offset + 1);
+    }
+    return Uint8Array.from(bytes);
+}
+/** Writes unsigned base-128 varints without 32-bit truncation of zoom-26 IDs. */
+function writeVarint(output, value) {
+    while (value >= 128) {
+        output.push((value % 128) + 128);
+        value = Math.floor(value / 128);
+    }
+    output.push(value);
+}
+/** Checks configurable budgets before consuming the caller's tile iterator. */
+function validateLimit(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new RangeError(`Invalid PMTiles ${name} limit`);
+    return value;
+}
+/** Validates geographic bounds independently of tile-local payload coordinates. */
+function validateBounds(bounds) {
+    if (bounds.length !== 4 ||
+        bounds.some(value => !Number.isFinite(value)) ||
+        Math.abs(bounds[0]) > 180 ||
+        Math.abs(bounds[2]) > 180 ||
+        Math.abs(bounds[1]) > 90 ||
+        Math.abs(bounds[3]) > 90 ||
+        bounds[0] > bounds[2] ||
+        bounds[1] > bounds[3])
+        throw new RangeError('Invalid PMTiles bounds');
+}
+/** Converts a normalized Web Mercator tile edge to latitude. */
+function getLatitude(value) {
+    return (Math.atan(Math.sinh(Math.PI * (1 - 2 * value))) * 180) / Math.PI;
+}
+/** Encodes a JSON object and enforces MVT's required TileJSON layer declarations. */
+function encodeMetadata(metadata, mvt, limit) {
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata))
+        throw new TypeError('PMTiles metadata must be a JSON object');
+    const json = JSON.stringify(metadata);
+    const normalized = JSON.parse(json);
+    if (!normalized || typeof normalized !== 'object' || Array.isArray(normalized))
+        throw new TypeError('PMTiles metadata must serialize to a JSON object');
+    if (mvt || normalized.vector_layers !== undefined) {
+        const layers = normalized.vector_layers;
+        const ids = new Set();
+        if (!Array.isArray(layers) || !layers.length)
+            throw new TypeError('PMTiles vector_layers must declare at least one layer');
+        for (const layer of layers) {
+            if (!layer ||
+                typeof layer.id !== 'string' ||
+                !layer.id ||
+                ids.has(layer.id) ||
+                !layer.fields ||
+                typeof layer.fields !== 'object' ||
+                Array.isArray(layer.fields) ||
+                Object.values(layer.fields).some(value => !['String', 'Number', 'Boolean'].includes(value)))
+                throw new TypeError('Invalid PMTiles vector_layers declaration');
+            ids.add(layer.id);
+        }
+    }
+    const bytes = new TextEncoder().encode(json);
+    if (bytes.byteLength > limit)
+        throw new RangeError('PMTiles metadata limit exceeded');
+    return bytes;
+}
+//# sourceMappingURL=encode-pmtiles.js.map

package/dist/pmtiles/lib/encode-pmtiles.js.map

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

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

@@ -0,0 +1,52 @@
+import { type TileGrid, LoaderOptions } from '@loaders.gl/core/loader-utils';
+import type { TileJSON } from '@loaders.gl/tiles/mvt';
+import * as pmtiles from 'pmtiles';
+/** Metadata describing a PMTiles file */
+export type PMTilesMetadata = {
+    format: 'pmtiles';
+    /** Native XYZ levels; complete geometry requires an explicit source CRS contract. */
+    tileGrid?: TileGrid;
+    /** Version of pm tiles format used by this tileset */
+    formatVersion: number;
+    /** MIME type for tile contents. Unknown tile types will return 'application/octet-stream */
+    tileMIMEType: 'application/vnd.mapbox-vector-tile' | 'application/vnd.maplibre-tile' | 'image/png' | 'image/jpeg' | 'image/webp' | 'image/avif' | 'application/octet-stream';
+    /** Name of the tileset (extracted from JSON metadata if available) */
+    name?: string;
+    /** Attribution string (extracted from JSON metadata if available) */
+    attributions?: string[];
+    /** Minimal zoom level of tiles in this tileset */
+    minZoom: number;
+    /** Maximal zoom level of tiles in this tileset */
+    maxZoom: number;
+    /** Bounding box of tiles in this tileset `[[w, s], [e, n]]`  */
+    boundingBox: [min: [x: number, y: number], max: [x: number, y: number]];
+    /** Center long, lat of this tileset */
+    center: [number, number];
+    /** Center zoom level of this tileset */
+    centerZoom: number;
+    /** Cache tag */
+    etag?: string;
+    /** Parsed TileJSON/tilestats metadata, if present */
+    tilejson?: TileJSON;
+    /** @deprecated PMTiles format specific header */
+    formatHeader?: pmtiles.Header;
+    /** @deprecated Unparsed metadata (Assumption metadata generated by e.g. tippecanoe, typically TileJSON) */
+    formatMetadata?: Record<string, unknown>;
+};
+/**
+ * Parse PMTiles metdata from a PMTiles file
+ * @param header
+ * @param tilejsonMetadata
+ * @param options
+ * @param loadOptions
+ * @returns
+ */
+export declare function parsePMTilesHeader(header: pmtiles.Header, pmtilesMetadata: Record<string, unknown> | null, options?: {
+    /** Include the deprecated raw format header. */
+    includeFormatHeader?: boolean;
+    /** Explicit source contract for geographic XYZ geometry. */
+    coordinateReferenceSystem?: 'EPSG:3857';
+    /** Logical tile size; independent of encoded tile dimensions. */
+    tileSize?: number;
+}, loadOptions?: LoaderOptions): PMTilesMetadata;
+//# sourceMappingURL=parse-pmtiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-pmtiles.d.ts","sourceRoot":"","sources":["../../../src/pmtiles/lib/parse-pmtiles.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,QAAQ,EACb,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAC;AAGpD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IAEtB,4FAA4F;IAC5F,YAAY,EACR,oCAAoC,GACpC,+BAA+B,GAC/B,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,0BAA0B,CAAC;IAE/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,WAAW,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;IACxE,uCAAuC;IACvC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC;IAC9B,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC/C,OAAO,CAAC,EAAE;IACR,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4DAA4D;IAC5D,yBAAyB,CAAC,EAAE,WAAW,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,WAAW,CAAC,EAAE,aAAa,GAC1B,eAAe,CAqEjB"}

package/dist/pmtiles/lib/parse-pmtiles.js

@@ -0,0 +1,95 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { createTileGrid, createWebMercatorTileGrid } from '@loaders.gl/core/loader-utils';
+import { parseTileJSON } from '@loaders.gl/tiles/mvt';
+// import {Source, PMTiles, Header, TileType} from 'pmtiles';
+import * as pmtiles from 'pmtiles';
+const { TileType } = pmtiles;
+/**
+ * Parse PMTiles metdata from a PMTiles file
+ * @param header
+ * @param tilejsonMetadata
+ * @param options
+ * @param loadOptions
+ * @returns
+ */
+export function parsePMTilesHeader(header, pmtilesMetadata, options, loadOptions) {
+    // Ironically, to use the TileJSON loader we need to stringify the metadata again.
+    // This is the price of integrating with the existing pmtiles library.
+    // TODO - provide a non-standard TileJSONLoader parsers that accepts a JSON object?
+    let tilejson = null;
+    if (pmtilesMetadata) {
+        try {
+            tilejson = parseTileJSON(pmtilesMetadata, loadOptions?.tilejson) || null;
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.warn('PMTiles metadata could not be interpreted as TileJSON', error);
+        }
+    }
+    const partialMetadata = {};
+    if (typeof tilejson?.name === 'string') {
+        partialMetadata.name = tilejson.name;
+    }
+    if (typeof tilejson?.htmlAttribution === 'string') {
+        partialMetadata.attributions = [tilejson.htmlAttribution];
+    }
+    // Preserve native header metadata even when its range cannot form a supported numeric grid.
+    const canonicalGrid = Number.isInteger(header.minZoom) &&
+        Number.isInteger(header.maxZoom) &&
+        header.minZoom >= 0 &&
+        header.maxZoom >= header.minZoom &&
+        header.maxZoom <= 31
+        ? createWebMercatorTileGrid(header.minZoom, header.maxZoom, options?.tileSize ?? 256)
+        : undefined;
+    const tileGrid = !canonicalGrid || options?.coordinateReferenceSystem === 'EPSG:3857'
+        ? canonicalGrid
+        : createTileGrid(undefined, canonicalGrid.matrices.map(({ id, tileSize, matrixSize }) => ({ id, tileSize, matrixSize })));
+    const metadata = {
+        ...partialMetadata,
+        format: 'pmtiles',
+        tileGrid,
+        formatVersion: header.specVersion,
+        attributions: [],
+        tileMIMEType: decodeTileType(header.tileType),
+        minZoom: header.minZoom,
+        maxZoom: header.maxZoom,
+        boundingBox: [
+            [header.minLon, header.minLat],
+            [header.maxLon, header.maxLat]
+        ],
+        center: [header.centerLon, header.centerLat],
+        centerZoom: header.centerZoom,
+        etag: header.etag
+    };
+    if (tilejson) {
+        metadata.tilejson = tilejson;
+    }
+    // Application can optionally include the raw header and metadata.
+    if (options?.includeFormatHeader) {
+        metadata.formatHeader = header;
+        metadata.formatMetadata = metadata;
+    }
+    return metadata;
+}
+/** Extract a MIME type for tiles from vector tile header  */
+function decodeTileType(tileType) {
+    switch (tileType) {
+        case TileType.Mvt:
+            return 'application/vnd.mapbox-vector-tile';
+        case TileType.Mlt:
+            return 'application/vnd.maplibre-tile';
+        case TileType.Png:
+            return 'image/png';
+        case TileType.Jpeg:
+            return 'image/jpeg';
+        case TileType.Webp:
+            return 'image/webp';
+        case TileType.Avif:
+            return 'image/avif';
+        default:
+            return 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=parse-pmtiles.js.map

package/dist/pmtiles/lib/parse-pmtiles.js.map

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

package/dist/pmtiles/lib/range-request-source.d.ts

@@ -0,0 +1,24 @@
+import { type RangeRequestSchedulerProps } from '@loaders.gl/core/loader-utils';
+import type { Source, RangeResponse } from 'pmtiles';
+/** Options for the PMTiles range-request source adapter. */
+export type RangeRequestSourceOptions = RangeRequestSchedulerProps & {
+    /** Fetch function used for PMTiles HTTP requests. */
+    fetch?: (url: string, options?: RequestInit) => Promise<Response>;
+};
+/**
+ * PMTiles compatible source that reads HTTP byte ranges through a coalescing scheduler.
+ */
+export declare class RangeRequestSource implements Source {
+    /** URL of the PMTiles archive. */
+    readonly url: string;
+    private readonly fetch;
+    private readonly scheduler;
+    private readonly requestContext;
+    /** Creates a PMTiles package Source backed by scheduled HTTP range requests. */
+    constructor(url: string, options?: RangeRequestSourceOptions);
+    /** Returns the PMTiles source cache key. */
+    getKey(): string;
+    /** Reads an exact byte range from the PMTiles archive. */
+    getBytes(offset: number, length: number, signal?: AbortSignal): Promise<RangeResponse>;
+}
+//# sourceMappingURL=range-request-source.d.ts.map

package/dist/pmtiles/lib/range-request-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-request-source.d.ts","sourceRoot":"","sources":["../../../src/pmtiles/lib/range-request-source.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAC,MAAM,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAEnD,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG;IACnE,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAmB,YAAW,MAAM;IAC/C,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4D;IAClF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;IAErC,gFAAgF;gBACpE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B;IAahE,4CAA4C;IAC5C,MAAM,IAAI,MAAM;IAIhB,0DAA0D;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAa7F"}

package/dist/pmtiles/lib/range-request-source.js

@@ -0,0 +1,45 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { RangeRequestScheduler } from '@loaders.gl/core/loader-utils';
+/**
+ * PMTiles compatible source that reads HTTP byte ranges through a coalescing scheduler.
+ */
+export class RangeRequestSource {
+    /** URL of the PMTiles archive. */
+    url;
+    fetch;
+    scheduler;
+    requestContext = {};
+    /** Creates a PMTiles package Source backed by scheduled HTTP range requests. */
+    constructor(url, options = {}) {
+        this.url = url;
+        this.fetch = options.fetch || fetch;
+        this.scheduler = new RangeRequestScheduler({
+            batchDelayMs: options.batchDelayMs ?? 0,
+            maxGapBytes: options.maxGapBytes,
+            rangeExpansionBytes: options.rangeExpansionBytes,
+            maxMergedBytes: options.maxMergedBytes,
+            stats: options.stats,
+            onEvent: options.onEvent
+        });
+    }
+    /** Returns the PMTiles source cache key. */
+    getKey() {
+        return this.url;
+    }
+    /** Reads an exact byte range from the PMTiles archive. */
+    async getBytes(offset, length, signal) {
+        const data = await this.scheduler.fetch({
+            sourceId: this.url,
+            url: this.url,
+            offset,
+            length,
+            signal,
+            isolationKey: this.requestContext,
+            fetch: this.fetch
+        });
+        return { data };
+    }
+}
+//# sourceMappingURL=range-request-source.js.map

package/dist/pmtiles/lib/range-request-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-request-source.js","sourceRoot":"","sources":["../../../src/pmtiles/lib/range-request-source.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EACL,qBAAqB,EAEtB,MAAM,+BAA+B,CAAC;AASvC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B,kCAAkC;IACzB,GAAG,CAAS;IACJ,KAAK,CAA4D;IACjE,SAAS,CAAwB;IACjC,cAAc,GAAG,EAAE,CAAC;IAErC,gFAAgF;IAChF,YAAY,GAAW,EAAE,UAAqC,EAAE;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAqB,CAAC;YACzC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;YACvC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAED,4CAA4C;IAC5C,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,MAAc,EAAE,MAAoB;QACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM;YACN,MAAM;YACN,MAAM;YACN,YAAY,EAAE,IAAI,CAAC,cAAc;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,OAAO,EAAC,IAAI,EAAC,CAAC;IAChB,CAAC;CACF"}

package/dist/pmtiles/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: any;
+//# sourceMappingURL=version.d.ts.map

package/dist/pmtiles/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/pmtiles/lib/version.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,KAA8D,CAAC"}

package/dist/pmtiles/lib/version.js

@@ -0,0 +1,8 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Version constant cannot be imported, it needs to correspond to the build version of **this** module.
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+export const VERSION = typeof "5.0.0-alpha.13" !== 'undefined' ? "5.0.0-alpha.13" : 'latest';
+//# sourceMappingURL=version.js.map

package/dist/pmtiles/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/pmtiles/lib/version.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,uGAAuG;AACvG,yDAAyD;AACzD,qDAAqD;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,uBAAkB,KAAK,WAAW,CAAC,CAAC,kBAAa,CAAC,CAAC,QAAQ,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * PMTiles
+ */
+export declare const PMTilesFormat: {
+    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-format.d.ts.map

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

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

package/dist/pmtiles/pmtiles-format.js

@@ -0,0 +1,17 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * PMTiles
+ */
+export const PMTilesFormat = {
+    name: 'PMTiles',
+    id: 'pmtiles',
+    module: 'tiles',
+    encoding: 'binary',
+    format: 'pmtiles',
+    extensions: ['pmtiles'],
+    mimeTypes: ['application/vnd.pmtiles', 'application/octet-stream'],
+    tests: ['PMTiles']
+};
+//# sourceMappingURL=pmtiles-format.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-format.js","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-format.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,CAAC,SAAS,CAAC;IACvB,SAAS,EAAE,CAAC,yBAAyB,EAAE,0BAA0B,CAAC;IAClE,KAAK,EAAE,CAAC,SAAS,CAAC;CACO,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { LoaderOptions, ReadableFile } from '@loaders.gl/core/loader-utils';
+import { VectorSourceInfo, ImageSourceInfo } from "./source-info.js";
+import { PMTilesSourceLoaderOptions } from "./pmtiles-source-loader.js";
+export type PMTilesLoaderOptions = LoaderOptions & {
+    pmtiles?: PMTilesSourceLoaderOptions['pmtiles'];
+};
+/**
+ * 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 declare const PMTilesLoaderWithParser: {
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: PMTilesLoaderOptions) => Promise<VectorSourceInfo | ImageSourceInfo>;
+    readonly parseFile: typeof parseFileAsPMTiles;
+    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"];
+};
+declare function parseFileAsPMTiles(file: ReadableFile, options?: PMTilesLoaderOptions): Promise<VectorSourceInfo | ImageSourceInfo>;
+export {};
+//# sourceMappingURL=pmtiles-loader-with-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pmtiles-loader-with-parser.d.ts","sourceRoot":"","sources":["../../src/pmtiles/pmtiles-loader-with-parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,aAAa,EAAE,YAAY,EAAC,MAAM,+BAA+B,CAAC;AAGjG,OAAO,EAAC,gBAAgB,EAAE,eAAe,EAAC,yBAAsB;AAChE,OAAO,EAAoB,0BAA0B,EAAC,mCAAgC;AAMtF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,OAAO,CAAC,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;CACjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;kCAEP,WAAW,YAAY,oBAAoB;;;;;;;;;;;;;;CAOvE,CAAC;AAEF,iBAAe,kBAAkB,CAC/B,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,gBAAgB,GAAG,eAAe,CAAC,CAsB7C"}