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

package/dist/loader-utils/lib/sources/tile-source-adapter.js

@@ -0,0 +1,109 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getTileBounds, isTileIndexInRange, validateTileMatrix } from '@math.gl/geospatial';
+import { getRequestedTileMatrix } from "./tile-grid.js";
+/** Converts image-window requests into tiles in a configured grid, or legacy geographic XYZ. */
+export class TileSourceAdapter {
+    /** Image-window source used to fulfill tile requests. */
+    viewportSource;
+    /** Explicit geometry and availability; never inferred from image dataset bounds. */
+    tileGrid;
+    /** Wraps an image source, optionally using an authoritative matrix set. */
+    constructor(source, tileGrid) {
+        if (tileGrid &&
+            (!tileGrid.tileMatrixSet?.crs ||
+                !tileGrid.tileMatrixSet.matrices.length ||
+                new Set(tileGrid.tileMatrixSet.matrices.map(matrix => matrix.id)).size !==
+                    tileGrid.tileMatrixSet.matrices.length))
+            throw new Error('TileSourceAdapter requires complete tile matrix geometry.');
+        for (const matrix of tileGrid?.tileMatrixSet?.matrices || [])
+            validateTileMatrix(matrix);
+        this.viewportSource = source;
+        this.tileGrid = tileGrid;
+    }
+    /** Returns source metadata plus the explicitly configured tile grid. */
+    async getMetadata() {
+        const metadata = await this.viewportSource.getMetadata();
+        return this.tileGrid ? { ...metadata, tileGrid: this.tileGrid } : metadata;
+    }
+    /** Requests native matrix bounds and pixel dimensions without reprojection. */
+    getTile(parameters) {
+        let width = 512;
+        let height = 512;
+        let coordinateReferenceSystem = 'EPSG:4326';
+        const set = this.tileGrid?.tileMatrixSet;
+        if (set) {
+            if (parameters.crs && parameters.crs !== set.crs)
+                throw new Error('TileSourceAdapter does not support reprojection.');
+            const matrix = getRequestedTileMatrix(set.matrices, level => level.id, parameters);
+            if (!matrix)
+                return Promise.resolve(null);
+            const limits = this.tileGrid?.limits?.find(limit => limit.tileMatrix === matrix.id);
+            if ((this.tileGrid?.limits !== undefined && !limits) ||
+                !isTileIndexInRange(matrix, parameters.x, parameters.y, limits))
+                return Promise.resolve(null);
+            [width, height] = matrix.tileSize;
+            coordinateReferenceSystem = set.crs;
+        }
+        else if (parameters.tileMatrix !== undefined) {
+            throw new RangeError('Explicit tile matrix selection requires a configured grid.');
+        }
+        const boundingBox = this.getTileBoundingBox(parameters);
+        return this.viewportSource.getImage({
+            boundingBox,
+            layers: parameters.layers || [],
+            width,
+            height,
+            crs: coordinateReferenceSystem,
+            styles: parameters.styles,
+            format: parameters.format,
+            signal: parameters.signal
+        });
+    }
+    /** Preserves matrix identity and cancellation from deck.gl-compatible requests. */
+    getTileData(parameters) {
+        return this.getTile({
+            ...parameters.index,
+            tileMatrix: parameters.tileMatrix,
+            signal: parameters.signal
+        });
+    }
+    /** Returns native configured bounds, or longitude/latitude bounds for legacy XYZ requests. */
+    getTileBoundingBox(parameters) {
+        const set = this.tileGrid?.tileMatrixSet;
+        if (set) {
+            const matrix = getRequestedTileMatrix(set.matrices, level => level.id, parameters);
+            if (!matrix)
+                throw new RangeError('No tile matrix for request.');
+            const [minimumX, minimumY, maximumX, maximumY] = getTileBounds(matrix, parameters.x, parameters.y);
+            return [
+                [minimumX, minimumY],
+                [maximumX, maximumY]
+            ];
+        }
+        if (parameters.crs && parameters.crs !== 'EPSG:4326')
+            throw new Error('Legacy XYZ image bounds require EPSG:4326.');
+        const { x, y, z } = parameters;
+        if (!Number.isInteger(z) ||
+            z < 0 ||
+            z > 30 ||
+            !Number.isInteger(x) ||
+            !Number.isInteger(y) ||
+            x < 0 ||
+            y < 0 ||
+            x >= 2 ** z ||
+            y >= 2 ** z)
+            throw new RangeError('Invalid XYZ tile index.');
+        return [this.getTileLowerLeftCorner(x, y, z), this.getTileLowerLeftCorner(x + 1, y - 1, z)];
+    }
+    /** Returns a longitude/latitude lower-left corner of a canonical XYZ tile. */
+    getTileLowerLeftCorner(x, y, zoom) {
+        const count = 2 ** zoom;
+        return [
+            (x / count) * 360 - 180,
+            (180 / Math.PI) * Math.atan(Math.sinh(Math.PI * (1 - (2 * (y + 1)) / count)))
+        ];
+    }
+}
+//# sourceMappingURL=tile-source-adapter.js.map

package/dist/loader-utils/lib/sources/tile-source-adapter.js.map

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

package/dist/loader-utils/lib/sources/tile-source-utils.d.ts

@@ -0,0 +1,6 @@
+import type { GetTileDataBatchResult, GetTileDataParameters, TileSource } from "./tile-source.js";
+/**
+ * Request tile data in batches when a tile source supports it.
+ */
+export declare function getTileDataBatch<T = unknown>(source: TileSource, parameters: readonly GetTileDataParameters[]): GetTileDataBatchResult<T>;
+//# sourceMappingURL=tile-source-utils.d.ts.map

package/dist/loader-utils/lib/sources/tile-source-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-source-utils.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/tile-source-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,sBAAsB,EAAE,qBAAqB,EAAE,UAAU,EAAC,yBAAsB;AAE7F;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAC3C,sBAAsB,CAAC,CAAC,CAAC,CAM3B"}

package/dist/loader-utils/lib/sources/tile-source-utils.js

@@ -0,0 +1,13 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Request tile data in batches when a tile source supports it.
+ */
+export function getTileDataBatch(source, parameters) {
+    if (source.getTileDataBatch) {
+        return source.getTileDataBatch(parameters);
+    }
+    return parameters.map(parameter => source.getTileData(parameter));
+}
+//# sourceMappingURL=tile-source-utils.js.map

package/dist/loader-utils/lib/sources/tile-source-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-source-utils.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/tile-source-utils.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAkB,EAClB,UAA4C;IAE5C,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAA8B,CAAC;IAC1E,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAsB,CAAC,CAAC;AACzF,CAAC"}

package/dist/loader-utils/lib/sources/tile-source.d.ts

@@ -0,0 +1,190 @@
+import type { CRSIdentifier } from '@math.gl/geospatial/crs';
+import type { TileMatrixLimits, TileMatrixSet } from '@math.gl/geospatial';
+/**
+ * Props for a TileSource
+ */
+export type TileSourceProps = {};
+/**
+ * MapTileSource - data sources that allow data to be queried by (geospatial) extents
+ * @note
+ * - If geospatial, bounding box is expected to be in web mercator coordinates
+ */
+export interface TileSource {
+    /** MIME type of decoded tile payloads, when known. */
+    readonly mimeType?: string | null;
+    /** Whether decoded vector coordinates are local to each tile. */
+    readonly localCoordinates?: boolean;
+    getMetadata(): Promise<TileSourceMetadata>;
+    /** Flat parameters */
+    getTile(parameters: GetTileParameters): Promise<unknown | null>;
+    /** Flat parameters, batched */
+    getTileBatch?(parameters: readonly GetTileParameters[]): readonly Promise<unknown | null>[];
+    /** deck.gl compatibility: TileLayer and MTVLayer */
+    getTileData(parameters: GetTileDataParameters): Promise<unknown | null>;
+    /** deck.gl compatibility: batched tile data */
+    getTileDataBatch?(parameters: readonly GetTileDataParameters[]): readonly Promise<unknown | null>[];
+}
+/**
+ * Normalized capabilities of an tile service
+ * Sources are expected to normalize the response to capabilities
+ */
+export type TileSourceMetadata = {
+    format?: string;
+    formatHeader?: unknown;
+    /** Name of the tileset (extracted from JSON metadata if available) */
+    name?: string;
+    title?: string;
+    abstract?: string;
+    keywords?: 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]];
+    /** Advertised tile grid, when the service exposes matrix or level metadata. */
+    tileGrid?: TileGrid;
+    /** Layer information */
+    layer?: {
+        name: string;
+        title?: string;
+        srs?: CRSIdentifier[];
+        boundingBox?: [number, number, number, number];
+        layers: TileSourceLayer[];
+    };
+};
+/**
+ * Normalized tile matrix information shared by WMTS and vendor tile services.
+ *
+ * `tileMatrixSet` is the authoritative geometry when present. The grid-wide fields are kept for
+ * compatibility; when `tileMatrixSet` is set they are derived from it and describe its first level.
+ */
+export type TileGrid = {
+    /** Coordinate reference system used by the grid. */
+    crs?: CRSIdentifier;
+    /** Tile width and height in pixels. */
+    tileSize?: [number, number];
+    /** Top-left origin in grid coordinates. */
+    origin?: [number, number];
+    /** Horizontal coordinate units per pixel in matrix order, when CRS units are known. */
+    resolutions?: number[];
+    /** Matrix identifiers in zoom order. */
+    matrixIds?: string[];
+    /** Matrix width and height in tile units in zoom order. */
+    matrixSizes?: Array<[number, number]>;
+    /**
+     * Complete per-level geometry in advertised order, set only when every advertised level has a
+     * resolution, origin, tile size and matrix size that pass math.gl `validateTileMatrix()`. Use it
+     * with the `@math.gl/geospatial` tile-matrix utilities. Origins are in XY order.
+     */
+    tileMatrixSet?: TileMatrixSet;
+    /**
+     * Per-level metadata as the service advertises it, aligned with `matrixIds`. Entries may be
+     * incomplete, for example without a resolution when the CRS unit is unknown, so this is not
+     * usable geometry on its own; prefer `tileMatrixSet`.
+     */
+    matrices?: TileGridMatrix[];
+    /** Inclusive source coverage. Omitted means unrestricted; an empty list allows no tiles. */
+    limits?: TileGridLimits[];
+};
+/** Inclusive source coverage for one matrix, independent of its geometric definition. */
+export type TileGridLimits = TileMatrixLimits & {
+    /** Identifier of the covered matrix. Matrices absent from a present limits list are unavailable. */
+    tileMatrix: string;
+};
+/** One advertised level of a tile grid. Fields the service does not advertise are omitted. */
+export type TileGridMatrix = {
+    /** Matrix identifier used in tile requests. */
+    id: string;
+    /** Horizontal coordinate units per pixel, also vertical unless resolutionY is supplied. */
+    resolution?: number;
+    /** Vertical coordinate units per pixel; defaults to `resolution` when omitted. */
+    resolutionY?: number;
+    /**
+     * Origin in grid coordinates, at the corner named by `cornerOfOrigin`. Sources swap it to XY
+     * only where they know the axis order; see each source's documentation.
+     */
+    origin?: [number, number];
+    /** Matrix corner that `origin` locates; omitted means top-left. */
+    cornerOfOrigin?: 'topLeft' | 'bottomLeft';
+    /** Tile width and height in pixels. */
+    tileSize?: [number, number];
+    /** Matrix width and height in tile units. */
+    matrixSize?: [number, number];
+};
+/**
+ * Description of one data layer in the image source
+ */
+export type TileSourceLayer = {
+    name: string;
+    title?: string;
+    srs?: CRSIdentifier[];
+    boundingBox?: [number, number, number, number];
+    layers: TileSourceLayer[];
+};
+/**
+ * Generic parameters for requesting an tile from an tile source
+ */
+export type GetTileParameters = {
+    /** bounding box of the requested map image */
+    z: number;
+    /** tile x coordinate */
+    x: number;
+    /** tile y coordinate */
+    y: number;
+    /**
+     * Identifier of the tile matrix to request, used verbatim. Sources that know their matrix set
+     * reject an unknown identifier. When omitted, `z` selects the matrix whose identifier is that
+     * number, otherwise the matrix at that index.
+     */
+    tileMatrix?: string;
+    /** Coordinate reference system for the tile */
+    crs?: CRSIdentifier;
+    /** Layers to render */
+    layers?: string | string[];
+    /** Styling */
+    styles?: unknown;
+    /** requested format for the return image (in case of bitmap tiles) */
+    format?: 'image/png';
+    /** Abort signal for canceling metadata, range, and tile-content requests. */
+    signal?: AbortSignal;
+};
+/** deck.gl compatibility: parameters for TileSource.getTileData() */
+export type GetTileDataParameters = {
+    /** Native matrix identifier, independent of the renderer's numeric index. */
+    tileMatrix?: string;
+    /** Tile index */
+    index: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    id: string;
+    /** Bounding Box */
+    bbox: TileBoundingBox;
+    /** Zoom level */
+    zoom?: number;
+    url?: string | null;
+    signal?: AbortSignal;
+    userData?: Record<string, any>;
+};
+export type GetTileDataBatchResult<T = unknown> = readonly Promise<T | null>[];
+/** deck.gl compatibility: bounding box */
+export type TileBoundingBox = NonGeoBoundingBox | GeoBoundingBox;
+/** deck.gl compatibility: bounding box */
+export type GeoBoundingBox = {
+    west: number;
+    north: number;
+    east: number;
+    south: number;
+};
+/** deck.gl compatibility: bounding box */
+export type NonGeoBoundingBox = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+};
+//# sourceMappingURL=tile-source.d.ts.map

package/dist/loader-utils/lib/sources/tile-source.d.ts.map

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

package/dist/loader-utils/lib/sources/tile-source.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=tile-source.js.map

package/dist/loader-utils/lib/sources/tile-source.js.map

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

package/dist/loader-utils/lib/sources/utils/image-type.d.ts

@@ -0,0 +1,10 @@
+/** Supported Image Types @note duplicates definition in images/schema to avoid circular deps */
+export type ImageType = ImageBitmap | ImageDataType | HTMLImageElement;
+/** data images @note duplicates definition in images/schema to avoid circular deps */
+export type ImageDataType = {
+    data: Uint8Array;
+    width: number;
+    height: number;
+    compressed?: boolean;
+};
+//# sourceMappingURL=image-type.d.ts.map

package/dist/loader-utils/lib/sources/utils/image-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-type.d.ts","sourceRoot":"","sources":["../../../../../src/loader-utils/lib/sources/utils/image-type.ts"],"names":[],"mappings":"AAIA,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEvE,sFAAsF;AACtF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC"}

package/dist/loader-utils/lib/sources/utils/image-type.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=image-type.js.map

package/dist/loader-utils/lib/sources/utils/image-type.js.map

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

package/dist/loader-utils/lib/sources/utils/utils.d.ts

@@ -0,0 +1,13 @@
+import type { LoaderOptions } from "../../../loader-types.js";
+/**
+ * Gets the current fetch function from options
+ * @todo - move to loader-utils module
+ * @todo - use in core module counterpart
+ * @param options
+ * @param context
+ */
+export declare function getFetchFunction(options?: LoaderOptions): import("../../..").FetchLike;
+export declare function mergeImageSourceLoaderProps<Props extends {
+    loadOptions?: any;
+}>(props: Props): Required<Props>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/loader-utils/lib/sources/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/loader-utils/lib/sources/utils/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,iCAA8B;AAGzD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,aAAa,gCAEvD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,SAAS;IAAC,WAAW,CAAC,EAAE,GAAG,CAAA;CAAC,EAC3E,KAAK,EAAE,KAAK,GACX,QAAQ,CAAC,KAAK,CAAC,CAUjB"}

package/dist/loader-utils/lib/sources/utils/utils.js

@@ -0,0 +1,26 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getAuthenticatedFetch } from "../../request-utils/request-credentials.js";
+/**
+ * Gets the current fetch function from options
+ * @todo - move to loader-utils module
+ * @todo - use in core module counterpart
+ * @param options
+ * @param context
+ */
+export function getFetchFunction(options) {
+    return getAuthenticatedFetch(options);
+}
+export function mergeImageSourceLoaderProps(props) {
+    // @ts-expect-error
+    return {
+        // Default fetch
+        ...props,
+        loadOptions: {
+            ...props.loadOptions,
+            fetch: getFetchFunction(props.loadOptions)
+        }
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/loader-utils/lib/sources/utils/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/loader-utils/lib/sources/utils/utils.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,qBAAqB,EAAC,mDAAgD;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAY;IAEZ,mBAAmB;IACnB,OAAO;QACL,gBAAgB;QAChB,GAAG,KAAK;QACR,WAAW,EAAE;YACX,GAAG,KAAK,CAAC,WAAW;YACpB,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/dist/loader-utils/lib/sources/vector-source.d.ts

@@ -0,0 +1,76 @@
+import type { ArrowTable, BinaryFeatureCollection, GeoArrowEncodingPreference, GeoJSONTable, Schema } from '@loaders.gl/core/schema';
+import type { CRSIdentifier, SpatialReference } from '@math.gl/geospatial/crs';
+export type VectorSourceProps = {};
+/** Valid vector-source response tables. */
+export type VectorSourceData = GeoJSONTable | BinaryFeatureCollection | ArrowTable;
+/**
+ * VectorSource - data sources that allow features to be queried by (geospatial) extents
+ * Coordinates in returned geometry and normalized bounds use `xy` order (x/easting or
+ * longitude first). Service requests may use a different wire-axis order; adapters translate
+ * from the canonical `xy` input according to the requested CRS.
+ */
+export interface VectorSource {
+    getSchema(): Promise<Schema>;
+    getMetadata(options: {
+        formatSpecificMetadata?: boolean;
+    }): Promise<VectorSourceMetadata>;
+    getFeatures(parameters: GetFeaturesParameters): Promise<VectorSourceData>;
+}
+/**
+ * Normalized capabilities of an Image service
+ * @example
+ *  The WMSSourceLoader will normalize the response to the WMS `GetCapabilities`
+ *  data structure extracted from WMS XML response into an VectorSourceMetadata.
+ */
+export type VectorSourceMetadata = {
+    name: string;
+    title?: string;
+    abstract?: string;
+    keywords: string[];
+    layers: VectorSourceLayer[];
+    /**
+     * Attempts to preserve the original format specific metadata from the underlying source,
+     * May be an approximate representation
+     */
+    formatSpecificMetadata?: Record<string, any>;
+};
+/** Description of one data layer in the image source */
+export type VectorSourceLayer = {
+    /** Name of this layer */
+    name?: string;
+    /** Human readable title of this layer */
+    title?: string;
+    /** Coordinate systems supported by this layer */
+    crs?: CRSIdentifier[];
+    /** Normalized source CRS discovery, including representation and unknown/default state. */
+    spatialReference?: SpatialReference;
+    /** layer limits in unspecified CRS:84-like lng/lat, for quick access w/o CRS calculations. */
+    boundingBox?: [min: [x: number, y: number], max: [x: number, y: number]];
+    /** Sub layers of this layer */
+    layers?: VectorSourceLayer[];
+};
+/** Generic parameters for requesting an image from an image source */
+export type GetFeaturesParameters = {
+    /** Map zoom for scale-dependent sources such as clustering. Fractional values are allowed. */
+    zoom?: number;
+    /** Layers to render */
+    layers: string | string[];
+    /** bounding box on the map (only return features within this bbox) */
+    boundingBox: [min: [x: number, y: number], max: [x: number, y: number]];
+    /** CRS for returned feature coordinates. */
+    crs?: CRSIdentifier;
+    /** CRS in which `boundingBox` is expressed. Defaults to the service's native request CRS. */
+    requestCrs?: CRSIdentifier;
+    /**
+     * Requested feature encoding for the returned table.
+     * `arrow` returns a loaders.gl `ArrowTable` with `shape: 'arrow-table'`.
+     */
+    format?: 'geojson' | 'binary' | 'arrow';
+    /** Preferred GeoArrow encoding when `format` is `arrow`. */
+    geoarrow?: {
+        encodingPreference?: GeoArrowEncodingPreference;
+    };
+    /** Abort signal for canceling in-flight requests. */
+    signal?: AbortSignal;
+};
+//# sourceMappingURL=vector-source.d.ts.map

package/dist/loader-utils/lib/sources/vector-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-source.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/vector-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,EACZ,MAAM,EACP,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAC,aAAa,EAAE,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AAE7E,MAAM,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEnC,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,uBAAuB,GAAG,UAAU,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,OAAO,EAAE;QAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxF,WAAW,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3E;AAID;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9C,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC;IACtB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,8FAA8F;IAC9F,WAAW,CAAC,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;IACzE,+BAA+B;IAC/B,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC9B,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,sEAAsE;IACtE,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,4CAA4C;IAC5C,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE;QAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAA;KAAC,CAAC;IAC7D,qDAAqD;IACrD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC"}

package/dist/loader-utils/lib/sources/vector-source.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=vector-source.js.map

package/dist/loader-utils/lib/sources/vector-source.js.map

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

package/dist/loader-utils/lib/sources/vector-tile-source.d.ts

@@ -0,0 +1,15 @@
+import type { Schema, Feature, GeoJSONTable, BinaryFeatureCollection, ArrowTable } from '@loaders.gl/core/schema';
+import { TileSource, TileSourceProps, GetTileParameters } from "./tile-source.js";
+import type { GetTileDataParameters } from "./tile-source.js";
+export type VectorTile = Feature[] | GeoJSONTable | BinaryFeatureCollection | ArrowTable;
+export type VectorTileSourceProps = TileSourceProps;
+/**
+ * VectorTileSource - data sources that allow data to be queried by (geospatial) tile
+ * @note If geospatial, bounding box is expected to be in web mercator coordinates
+ */
+export interface VectorTileSource extends TileSource {
+    getSchema(): Promise<Schema>;
+    getVectorTile(parameters: GetTileParameters): Promise<VectorTile | null>;
+    getTileData(parameters: GetTileDataParameters): Promise<Feature[] | GeoJSONTable | BinaryFeatureCollection | ArrowTable | null>;
+}
+//# sourceMappingURL=vector-tile-source.d.ts.map

package/dist/loader-utils/lib/sources/vector-tile-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-tile-source.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/vector-tile-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAC,yBAAsB;AAC7E,OAAO,KAAK,EAAC,qBAAqB,EAAC,yBAAsB;AAEzD,MAAM,MAAM,UAAU,GAAG,OAAO,EAAE,GAAG,YAAY,GAAG,uBAAuB,GAAG,UAAU,CAAC;AAEzF,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzE,WAAW,CACT,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,OAAO,EAAE,GAAG,YAAY,GAAG,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC;CACpF"}

package/dist/loader-utils/lib/sources/vector-tile-source.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=vector-tile-source.js.map

package/dist/loader-utils/lib/sources/vector-tile-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-tile-source.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/vector-tile-source.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC"}

package/dist/loader-utils/lib/sources/xyz-grid.d.ts

@@ -0,0 +1,9 @@
+import type { GetTileParameters, TileGrid } from "./tile-source.js";
+/**
+ * Creates the canonical XYZ world grid for an explicitly established Web Mercator source.
+ * `tileSize` defines the logical pixel frame, independently of encoded raster size or vector extent.
+ */
+export declare function createWebMercatorTileGrid(minZoom: number, maxZoom: number, tileSize?: number): TileGrid;
+/** Resolves a canonical XYZ matrix identifier/index and rejects coordinates outside its world. */
+export declare function resolveXYZTileParameters(grid: TileGrid | undefined, parameters: GetTileParameters): GetTileParameters | null;
+//# sourceMappingURL=xyz-grid.d.ts.map

package/dist/loader-utils/lib/sources/xyz-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xyz-grid.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/xyz-grid.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,iBAAiB,EAAE,QAAQ,EAAiB,yBAAsB;AAM/E;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,SAAM,GACb,QAAQ,CA0BV;AAED,kGAAkG;AAClG,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,UAAU,EAAE,iBAAiB,GAC5B,iBAAiB,GAAG,IAAI,CA+B1B"}

package/dist/loader-utils/lib/sources/xyz-grid.js

@@ -0,0 +1,63 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { createTileGrid, getRequestedTileMatrix } from "./tile-grid.js";
+/** Half the circumference of the EPSG:3857 projected world, in metres. */
+const WEB_MERCATOR_HALF_WORLD = 20037508.342789244;
+/**
+ * Creates the canonical XYZ world grid for an explicitly established Web Mercator source.
+ * `tileSize` defines the logical pixel frame, independently of encoded raster size or vector extent.
+ */
+export function createWebMercatorTileGrid(minZoom, maxZoom, tileSize = 256) {
+    if (!Number.isInteger(minZoom) ||
+        !Number.isInteger(maxZoom) ||
+        minZoom < 0 ||
+        maxZoom < minZoom ||
+        maxZoom > 31 ||
+        !Number.isSafeInteger(tileSize) ||
+        tileSize <= 0) {
+        throw new RangeError('XYZ grids require integer zooms 0–31 and a positive integer tile size.');
+    }
+    return createTileGrid('EPSG:3857', Array.from({ length: maxZoom - minZoom + 1 }, (_, index) => {
+        const zoom = minZoom + index;
+        const count = 2 ** zoom;
+        return {
+            id: String(zoom),
+            resolution: (WEB_MERCATOR_HALF_WORLD * 2) / (tileSize * count),
+            origin: [-WEB_MERCATOR_HALF_WORLD, WEB_MERCATOR_HALF_WORLD],
+            tileSize: [tileSize, tileSize],
+            matrixSize: [count, count]
+        };
+    }));
+}
+/** Resolves a canonical XYZ matrix identifier/index and rejects coordinates outside its world. */
+export function resolveXYZTileParameters(grid, parameters) {
+    if (!grid?.matrices) {
+        if (parameters.tileMatrix !== undefined)
+            throw new RangeError('Tile matrix selection requires an established XYZ grid.');
+        return parameters;
+    }
+    const matrix = getRequestedTileMatrix(grid.matrices, level => level.id, parameters);
+    if (!matrix)
+        return null;
+    const size = matrix.matrixSize;
+    const zoom = Number(matrix.id);
+    if (!size ||
+        !Number.isInteger(zoom) ||
+        zoom < 0 ||
+        zoom > 31 ||
+        String(zoom) !== matrix.id ||
+        size[0] !== 2 ** zoom ||
+        size[1] !== 2 ** zoom) {
+        throw new RangeError('XYZ matrices require canonical zoom IDs and world dimensions.');
+    }
+    if (!Number.isSafeInteger(parameters.x) ||
+        !Number.isSafeInteger(parameters.y) ||
+        parameters.x < 0 ||
+        parameters.y < 0 ||
+        parameters.x >= size[0] ||
+        parameters.y >= size[1])
+        return null;
+    return { ...parameters, z: zoom, tileMatrix: matrix.id };
+}
+//# sourceMappingURL=xyz-grid.js.map