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

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

@@ -0,0 +1,302 @@
+import type { TileGrid } from "./tile-source.js";
+import type { TypedArray } from "../../types.js";
+import type { CRSDefinition, CRSIdentifier } from '@math.gl/geospatial/crs';
+/**
+ * Numeric channel types supported by viewport-driven raster payloads.
+ */
+export type RasterChannelDataType = 'uint8' | 'uint16' | 'uint32' | 'int8' | 'int16' | 'int32' | 'float32' | 'float64';
+/**
+ * Bounding box in source coordinates.
+ */
+export type RasterBoundingBox = [min: [x: number, y: number], max: [x: number, y: number]];
+/**
+ * Minimal viewport shape accepted by {@link RasterSource}.
+ *
+ * This shape is intentionally compatible with deck.gl style 2D viewports without
+ * introducing a dependency on deck.gl types into loader-utils.
+ */
+export type RasterViewport = {
+    /** Stable viewport identifier used by higher-level loading managers. */
+    id: string;
+    /** Viewport pixel width. */
+    width: number;
+    /** Viewport pixel height. */
+    height: number;
+    /** Viewport zoom level. */
+    zoom: number;
+    /** Viewport center in source coordinates. */
+    center: number[];
+    /** Optional coordinate reference system for the requested raster view. */
+    crs?: CRSIdentifier;
+    /** Optional explicit bounds in source coordinates. */
+    bounds?: RasterBoundingBox;
+    /** Optional callback used to derive bounds from a deck.gl compatible viewport. */
+    getBounds?: () => [west: number, south: number, east: number, north: number];
+    /** Project source coordinates into the viewport. */
+    project: (coordinates: number[]) => number[];
+    /** Unproject viewport coordinates into source coordinates. */
+    unprojectPosition: (position: number[]) => [number, number, number];
+};
+/**
+ * CPU-side raster payload that can be uploaded to a rendering texture.
+ */
+export type RasterData = {
+    /** Raster sample buffer(s). */
+    data: TypedArray | TypedArray[];
+    /** Raster width in pixels. */
+    width: number;
+    /** Raster height in pixels. */
+    height: number;
+    /** Number of bands represented by this payload. */
+    bandCount: number;
+    /** Numeric channel type. */
+    dtype: RasterChannelDataType;
+    /** `true` when multiple bands are interleaved into one typed array. */
+    interleaved?: boolean;
+    /** Source no-data value when defined. */
+    noData?: number | null;
+    /** Bounds covered by this payload in source coordinates. */
+    boundingBox?: RasterBoundingBox;
+    /** Coordinate reference system for the payload bounds. */
+    crs?: CRSDefinition;
+    /** Per-band raw-domain interpretation, in payload order. */
+    bands?: RasterBandMetadata[];
+    /** Affine [a, b, c, d, e, f]: x = a*column + b*row + c; y = d*column + e*row + f. */
+    transform?: RasterAffineTransform;
+    /** Area samples are centered at grid coordinates +0.5; point samples at integer coordinates. */
+    pixelRegistration?: 'area' | 'point';
+    /** Masks use zero for invalid samples; values do not override nodata. */
+    validityMasks?: RasterValidityMask[];
+    /** Actual selected native overview. */
+    overview?: number;
+    /** Effective source units per output pixel, on both axes. */
+    resolution?: [number, number];
+    /** Resolution of the selected native source overview, when available. */
+    nativeResolution?: [number, number];
+    /** Whether requested pixels are finer than the selected native overview. */
+    overzoom?: boolean;
+    /** Structured provenance without credentials or authorization headers. */
+    provenance?: {
+        sourceType: string;
+        revision?: string;
+    };
+    /** Computed statistics, separate from format-declared metadata. */
+    statistics?: RasterBandStatistics[];
+    /** Buffer ownership; sampling never mutates buffers. */
+    ownership?: 'borrowed' | 'owned' | 'transferred';
+    /** Format-specific metadata retained for styling or upload configuration. */
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Named indices selected from non-spatial raster dimensions.
+ *
+ * Sources define the supported dimension names in their source-specific metadata.
+ */
+export type RasterSelection = Readonly<Record<string, number>>;
+/**
+ * Parameters for {@link RasterSource.getRaster}.
+ */
+export type GetRasterParameters = {
+    /** Requested output viewport. */
+    viewport: RasterViewport;
+    /** Optional named indices for non-spatial dimensions such as time or vertical level. */
+    selection?: RasterSelection;
+    /** Optional sample indices to request. */
+    bands?: number[];
+    /** Whether to interleave multi-band output. Defaults to `false`. */
+    interleaved?: boolean;
+    /** Optional resampling method supported by the source implementation. */
+    resampleMethod?: 'nearest' | 'bilinear';
+    /** Abort signal forwarded to the underlying request. */
+    signal?: AbortSignal;
+};
+/**
+ * Description of one available overview level.
+ */
+export type RasterOverview = {
+    /** Zero-based image index or resolution level. */
+    index: number;
+    /** Overview width in pixels. */
+    width: number;
+    /** Overview height in pixels. */
+    height: number;
+    /** Source resolution for the overview when available. */
+    resolution?: [x: number, y: number];
+};
+/**
+ * Normalized metadata exposed by a viewport-driven raster source.
+ */
+export type RasterSourceMetadata = {
+    /** Name of the raster dataset. */
+    name?: string;
+    /** Human-readable title for the dataset. */
+    title?: string;
+    /** Dataset description. */
+    abstract?: string;
+    /** Dataset keywords. */
+    keywords?: string[];
+    /** Attribution strings. */
+    attributions?: string[];
+    /** Source coordinate reference system. */
+    crs?: CRSDefinition;
+    /** Dataset bounds in source coordinates. */
+    boundingBox?: RasterBoundingBox;
+    /** Full-resolution raster width. */
+    width: number;
+    /** Full-resolution raster height. */
+    height: number;
+    /** Number of raster bands. */
+    bandCount: number;
+    /** Numeric sample type. */
+    dtype: RasterChannelDataType;
+    /** Original band interpretation in source order. */
+    bands?: RasterBandMetadata[];
+    /** Native source-grid affine, when known. */
+    transform?: RasterAffineTransform;
+    /** Native grid registration. */
+    pixelRegistration?: 'area' | 'point';
+    /** Whether explicit numeric region requests are available. */
+    supportsRegion?: boolean;
+    /** Native tile dimensions when the source is tiled. */
+    tileSize?: {
+        width: number;
+        height: number;
+    };
+    /** Native tiled overview geometry; matrix IDs are source image indices. Edge tiles may extend beyond raster bounds. */
+    tileGrid?: TileGrid;
+    /** Available overview levels. */
+    overviews?: RasterOverview[];
+    /** Source no-data value when defined. */
+    noData?: number | null;
+    /** Format-specific metadata. */
+    metadata?: Record<string, unknown>;
+};
+/**
+ * RasterSource - data sources that allow typed raster data to be queried by viewport.
+ *
+ * @typeParam DataT Raster payload returned by the source.
+ * @typeParam ParametersT Request parameters accepted by the source.
+ * @typeParam MetadataT Metadata returned by the source.
+ */
+export interface RasterSource<DataT extends NumericRasterData = RasterData, ParametersT extends GetRasterParameters = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata> {
+    /** Additive explicit region capability, absent on legacy sources. */
+    readonly supportsRegion?: boolean;
+    /** Returns normalized dataset metadata without loading raster samples. */
+    getMetadata(options?: {
+        /** Optional metadata transport cancellation. */ signal?: AbortSignal;
+    }): Promise<MetadataT>;
+    /** Loads raster samples for the supplied viewport request. */
+    getRaster(parameters: ParametersT): Promise<DataT>;
+}
+/**
+ * Resolves viewport bounds from the local raster viewport shape.
+ */
+export declare function getRasterViewportBoundingBox(viewport: RasterViewport): RasterBoundingBox;
+/** Source grid to source-coordinate affine transform. */
+export type RasterAffineTransform = [number, number, number, number, number, number];
+/** Interpretation of one band, without modifying raw samples. */
+export type RasterBandMetadata = {
+    /** Original zero-based source index. */
+    index: number;
+    /** Actual array representation for this band. */
+    dtype: RasterChannelDataType;
+    /** Human-readable band name. */
+    name?: string;
+    /** Physical units. */
+    units?: string;
+    /** Raw-to-physical multiplier. */
+    scale?: number;
+    /** Raw-to-physical additive offset. */
+    offset?: number;
+    /** Raw-domain nodata value. */
+    noData?: number | null;
+    /** Source-declared statistics, separate from computed payload statistics. */
+    declaredStatistics?: RasterDeclaredBandStatistics;
+    /** Whether interpolation is inappropriate for this band. */
+    categorical?: boolean;
+};
+/** Explicit mask indexing: offset + row*rowStride + column*pixelStride. */
+export type RasterValidityMask = {
+    /** Mask bytes; zero means invalid. */
+    data: Uint8Array;
+    /** Payload band index, or all bands when omitted. */
+    band?: number;
+    /** Number of columns. */
+    width: number;
+    /** Number of rows. */
+    height: number;
+    /** Byte offset, default zero. */
+    offset?: number;
+    /** Byte stride between columns, default one. */
+    pixelStride?: number;
+    /** Byte stride between rows, default width. */
+    rowStride?: number;
+};
+/** Statistics over a bounded set of valid samples. */
+export type RasterBandStatistics = {
+    /** Original source band index. */
+    band: number;
+    /** Value interpretation. */
+    domain: 'raw' | 'physical';
+    /** Minimum valid value, absent for all-invalid samples. */
+    min?: number;
+    /** Maximum valid value, absent for all-invalid samples. */
+    max?: number;
+    /** Number of valid inspected samples. */
+    validCount: number;
+    /** Statistical scope. */
+    scope: 'payload';
+    /** Whether every pixel was inspected. */
+    method: 'exact' | 'sampled';
+};
+/** Source declarations whose domain or valid count may be unavailable. */
+export type RasterDeclaredBandStatistics = {
+    /** Original source band index. */
+    band: number;
+    /** Declared interpretation; unknown means callers must not assume raw or physical values. */
+    domain: 'raw' | 'physical' | 'unknown';
+    /** Finite declared minimum, when available. */
+    min?: number;
+    /** Finite declared maximum, when available. */
+    max?: number;
+    /** Declared valid sample count, omitted when unavailable; never inferred from rounded percentages. */
+    validCount?: number;
+    /** Scope of the declaration, independent of the returned payload window. */
+    scope: 'source' | 'overview';
+    /** Source-provided values; no assertion that this implementation computed exact extrema. */
+    method: 'declared';
+};
+/** Explicit non-wrapped source-coordinate request. */
+export type RasterRegionParameters = Omit<GetRasterParameters, 'viewport'> & {
+    /** Ordered finite bounds in canonical x/y order. */
+    bounds: RasterBoundingBox;
+    /** Explicit request CRS; conversion is the caller's responsibility. */
+    crs: CRSDefinition;
+    /** Positive integer output width. */
+    width: number;
+    /** Positive integer output height. */
+    height: number;
+    /** Maximum output pixels, default 16 million. */
+    maxPixels?: number;
+    /** Maximum decoded bytes, default 256 MiB. */
+    maxDecodedBytes?: number;
+};
+/** Additive region capability; sources without it retain their viewport contract. */
+export interface RasterRegionSource extends RasterSource {
+    /** Loads one independently georeferenced region. */
+    getRasterForRegion(parameters: RasterRegionParameters): Promise<NumericRasterData>;
+}
+/** Additive mixed-representation payload; every band retains its own typed array and dtype. */
+export type RasterMixedData = Omit<RasterData, 'data' | 'dtype' | 'interleaved' | 'bands'> & {
+    /** Separate arrays in payload band order. */
+    data: TypedArray[];
+    /** Discriminator; there is no common numeric representation. */
+    dtype: 'mixed';
+    /** Mixed representations cannot be interleaved. */
+    interleaved: false;
+    /** Required per-band interpretation describes each actual array representation. */
+    bands: RasterBandMetadata[];
+};
+/** Common or explicitly mixed numeric samples. */
+export type NumericRasterData = RasterData | RasterMixedData;
+//# sourceMappingURL=raster-source.d.ts.map

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

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

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

@@ -0,0 +1,20 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+/**
+ * Resolves viewport bounds from the local raster viewport shape.
+ */
+export function getRasterViewportBoundingBox(viewport) {
+    if (viewport.bounds) {
+        return viewport.bounds;
+    }
+    if (viewport.getBounds) {
+        const [west, south, east, north] = viewport.getBounds();
+        return [
+            [west, south],
+            [east, north]
+        ];
+    }
+    throw new Error('Raster viewport must provide bounds or getBounds().');
+}
+//# sourceMappingURL=raster-source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raster-source.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/raster-source.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,4DAA4D;AAgN5D;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAwB;IACnE,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxD,OAAO;YACL,CAAC,IAAI,EAAE,KAAK,CAAC;YACb,CAAC,IAAI,EAAE,KAAK,CAAC;SACd,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,36 @@
+/** Protocol-neutral service families understood by geospatial service sources. */
+export type GeoServiceType = 'wms' | 'wmts' | 'wfs' | 'csw' | 'arcgis-map-server' | 'arcgis-vector-tile-server' | 'arcgis-image-server' | 'arcgis-feature-server' | 'arcgis-scene-server' | 'unknown';
+/** A normalized description of a discoverable geospatial service. */
+export type ServiceCapabilities = {
+    /** Stable service URL. */
+    url?: string;
+    /** Protocol or vendor service family. */
+    type: GeoServiceType;
+    /** Machine-readable service identifier. */
+    name: string;
+    /** Human-readable service title. */
+    title?: string;
+    /** Service description. */
+    abstract?: string;
+    /** Supported coordinate reference systems. */
+    crs: string[];
+    /** Advertised response formats. */
+    formats: string[];
+    /** Named layers or feature types. */
+    layers: Array<{
+        name: string;
+        title?: string;
+        crs?: string[];
+        bounds?: number[];
+        id?: string;
+        url?: string;
+        profile?: string;
+        layerType?: string;
+        version?: string;
+    }>;
+    /** Supported request names, when advertised. */
+    operations: string[];
+    /** Original protocol-specific capability document. */
+    formatSpecificMetadata?: Record<string, unknown>;
+};
+//# sourceMappingURL=service-capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-capabilities.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/service-capabilities.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAClF,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,mBAAmB,GACnB,2BAA2B,GAC3B,qBAAqB,GACrB,uBAAuB,GACvB,qBAAqB,GACrB,SAAS,CAAC;AAEd,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG;IAChC,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,cAAc,CAAC;IACrB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,gDAAgD;IAChD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD,CAAC"}

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

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

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

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

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

@@ -0,0 +1,46 @@
+import type { GetTileParameters, TileGrid, TileGridMatrix } from "./tile-source.js";
+/**
+ * Builds a tile grid from advertised per-level metadata. `tileMatrixSet` is set only when every
+ * level is complete and valid, and the grid-wide fields are then derived from it. Otherwise the
+ * grid-wide fields describe the advertised first level, and the aligned `resolutions` and
+ * `matrixSizes` arrays are set only when every level has a value.
+ */
+export declare function createTileGrid(crs: string | undefined, matrices: TileGridMatrix[]): TileGrid;
+/** Advertised fields of one tile matrix, in the service's own axis order. */
+export type TileMatrixFields = {
+    /** Advertised matrix identifier. */
+    id: string;
+    /** Coordinate units per pixel, when known. */
+    resolution?: number;
+    /** Vertical coordinate units per pixel; defaults to the horizontal resolution. */
+    resolutionY?: number;
+    /** Origin as advertised; swapped to XY when `swapAxes` is set. */
+    point?: number[];
+    /** Whether the advertised coordinates are Y first. */
+    swapAxes: boolean;
+    /** Corner located by the origin; defaults to top-left. */
+    cornerOfOrigin?: 'topLeft' | 'bottomLeft';
+    /** Advertised tile width in pixels. */
+    tileWidth?: number;
+    /** Advertised tile height in pixels. */
+    tileHeight?: number;
+    /** Advertised matrix width in tiles. */
+    matrixWidth?: number;
+    /** Advertised matrix height in tiles. */
+    matrixHeight?: number;
+};
+/** Builds one tile-grid level, keeping only the fields the service advertises. */
+export declare function createTileGridMatrix(fields: TileMatrixFields): TileGridMatrix;
+/**
+ * Returns the matrix a tile request addresses. An explicit `tileMatrix` identifier is matched
+ * exactly and throws when the set does not contain it. Without one, `z` selects the matrix whose
+ * identifier is that number, otherwise the matrix at index `z`, without rounding or clamping.
+ */
+export declare function getRequestedTileMatrix<MatrixT>(matrices: readonly MatrixT[], getId: (matrix: MatrixT) => string, parameters: Pick<GetTileParameters, 'z' | 'tileMatrix'>): MatrixT | undefined;
+/**
+ * Returns the `{tileMatrix}` identifier for a request. With a known grid, the requested matrix
+ * must exist in it (see `getRequestedTileMatrix()`); a missing one throws instead of falling back
+ * to `z`. Without a grid, the explicit identifier is used verbatim, otherwise `z`.
+ */
+export declare function getTileGridMatrixId(tileGrid: TileGrid | undefined, parameters: Pick<GetTileParameters, 'z' | 'tileMatrix'>): string;
+//# sourceMappingURL=tile-grid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tile-grid.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/tile-grid.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAC,yBAAsB;AAI/E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,QAAQ,CAiC5F;AAsCD,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC1C,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAkB7E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAC5C,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,EAClC,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,GAAG,YAAY,CAAC,GACtD,OAAO,GAAG,SAAS,CAOrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,GAAG,YAAY,CAAC,GACtD,MAAM,CAKR"}

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

@@ -0,0 +1,128 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { validateTileMatrix } from '@math.gl/geospatial';
+/**
+ * Builds a tile grid from advertised per-level metadata. `tileMatrixSet` is set only when every
+ * level is complete and valid, and the grid-wide fields are then derived from it. Otherwise the
+ * grid-wide fields describe the advertised first level, and the aligned `resolutions` and
+ * `matrixSizes` arrays are set only when every level has a value.
+ */
+export function createTileGrid(crs, matrices) {
+    const tileMatrixSet = getTileMatrixSet(crs, matrices);
+    if (tileMatrixSet) {
+        const levels = tileMatrixSet.matrices;
+        return {
+            crs,
+            tileSize: [levels[0].tileSize[0], levels[0].tileSize[1]],
+            // The grid-wide origin is documented as top-left, so a bottom-left origin is per-level only.
+            origin: levels[0].cornerOfOrigin === 'topLeft'
+                ? [levels[0].origin[0], levels[0].origin[1]]
+                : undefined,
+            resolutions: levels.map(matrix => matrix.resolution),
+            matrixIds: levels.map(matrix => matrix.id),
+            matrixSizes: levels.map(matrix => [matrix.matrixSize[0], matrix.matrixSize[1]]),
+            tileMatrixSet,
+            matrices
+        };
+    }
+    return {
+        crs,
+        tileSize: matrices[0]?.tileSize,
+        // The grid-wide origin is documented as top-left, so a bottom-left origin is per-level only.
+        origin: matrices[0]?.cornerOfOrigin === 'bottomLeft' ? undefined : matrices[0]?.origin,
+        ...(matrices.length && matrices.every(matrix => matrix.resolution !== undefined)
+            ? { resolutions: matrices.map(matrix => matrix.resolution) }
+            : {}),
+        matrixIds: matrices.map(matrix => matrix.id),
+        matrixSizes: matrices.every(matrix => matrix.matrixSize)
+            ? matrices.map(matrix => matrix.matrixSize)
+            : undefined,
+        matrices
+    };
+}
+/** Returns complete geometry for every level, or undefined when any level is incomplete or invalid. */
+function getTileMatrixSet(crs, matrices) {
+    if (!crs || !matrices.length)
+        return undefined;
+    const tileMatrices = [];
+    for (const matrix of matrices) {
+        const tileMatrix = toTileMatrix(matrix);
+        if (!tileMatrix)
+            return undefined;
+        tileMatrices.push(tileMatrix);
+    }
+    return { crs, matrices: tileMatrices };
+}
+/** Converts one advertised level to math.gl geometry, or null when it is incomplete or invalid. */
+function toTileMatrix(matrix) {
+    const { id, resolution, resolutionY, origin, tileSize, matrixSize } = matrix;
+    if (resolution === undefined || !origin || !tileSize || !matrixSize)
+        return null;
+    const tileMatrix = {
+        id,
+        resolution,
+        ...(resolutionY !== undefined ? { resolutionY } : {}),
+        origin: [origin[0], origin[1]],
+        cornerOfOrigin: matrix.cornerOfOrigin ?? 'topLeft',
+        tileSize: [tileSize[0], tileSize[1]],
+        matrixSize: [matrixSize[0], matrixSize[1]]
+    };
+    try {
+        validateTileMatrix(tileMatrix);
+    }
+    catch {
+        return null;
+    }
+    return tileMatrix;
+}
+/** Builds one tile-grid level, keeping only the fields the service advertises. */
+export function createTileGridMatrix(fields) {
+    const { point, tileWidth, tileHeight } = fields;
+    const tileGridMatrix = { id: fields.id };
+    if (fields.resolution !== undefined)
+        tileGridMatrix.resolution = fields.resolution;
+    if (fields.resolutionY !== undefined)
+        tileGridMatrix.resolutionY = fields.resolutionY;
+    if (point && point.length >= 2) {
+        tileGridMatrix.origin = fields.swapAxes ? [point[1], point[0]] : [point[0], point[1]];
+    }
+    if (String(fields.cornerOfOrigin).toLowerCase() === 'bottomleft') {
+        tileGridMatrix.cornerOfOrigin = 'bottomLeft';
+    }
+    if (tileWidth !== undefined && tileHeight !== undefined) {
+        tileGridMatrix.tileSize = [tileWidth, tileHeight];
+    }
+    if (fields.matrixWidth !== undefined && fields.matrixHeight !== undefined) {
+        tileGridMatrix.matrixSize = [fields.matrixWidth, fields.matrixHeight];
+    }
+    return tileGridMatrix;
+}
+/**
+ * Returns the matrix a tile request addresses. An explicit `tileMatrix` identifier is matched
+ * exactly and throws when the set does not contain it. Without one, `z` selects the matrix whose
+ * identifier is that number, otherwise the matrix at index `z`, without rounding or clamping.
+ */
+export function getRequestedTileMatrix(matrices, getId, parameters) {
+    if (parameters.tileMatrix !== undefined) {
+        const matrix = matrices.find(candidate => getId(candidate) === parameters.tileMatrix);
+        if (!matrix)
+            throw new RangeError(`Unknown tile matrix "${parameters.tileMatrix}"`);
+        return matrix;
+    }
+    return matrices.find(matrix => getId(matrix) === String(parameters.z)) || matrices[parameters.z];
+}
+/**
+ * Returns the `{tileMatrix}` identifier for a request. With a known grid, the requested matrix
+ * must exist in it (see `getRequestedTileMatrix()`); a missing one throws instead of falling back
+ * to `z`. Without a grid, the explicit identifier is used verbatim, otherwise `z`.
+ */
+export function getTileGridMatrixId(tileGrid, parameters) {
+    if (!tileGrid?.matrices)
+        return parameters.tileMatrix ?? String(parameters.z);
+    const matrix = getRequestedTileMatrix(tileGrid.matrices, level => level.id, parameters);
+    if (!matrix)
+        throw new RangeError(`No tile matrix for z ${parameters.z}`);
+    return matrix.id;
+}
+//# sourceMappingURL=tile-grid.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { TileSource, GetTileParameters, GetTileDataParameters, TileGrid } from "./tile-source.js";
+import type { ImageSource, ImageSourceMetadata } from "./image-source.js";
+/** Converts image-window requests into tiles in a configured grid, or legacy geographic XYZ. */
+export declare class TileSourceAdapter<ImageSourceT extends ImageSource> implements TileSource {
+    /** Image-window source used to fulfill tile requests. */
+    readonly viewportSource: ImageSourceT;
+    /** Explicit geometry and availability; never inferred from image dataset bounds. */
+    readonly tileGrid?: TileGrid;
+    /** Wraps an image source, optionally using an authoritative matrix set. */
+    constructor(source: ImageSourceT, tileGrid?: TileGrid);
+    /** Returns source metadata plus the explicitly configured tile grid. */
+    getMetadata(): Promise<ImageSourceMetadata & {
+        tileGrid?: TileGrid;
+    }>;
+    /** Requests native matrix bounds and pixel dimensions without reprojection. */
+    getTile(parameters: GetTileParameters): Promise<unknown | null>;
+    /** Preserves matrix identity and cancellation from deck.gl-compatible requests. */
+    getTileData(parameters: GetTileDataParameters): Promise<unknown | null>;
+    /** Returns native configured bounds, or longitude/latitude bounds for legacy XYZ requests. */
+    protected getTileBoundingBox(parameters: GetTileParameters): [min: [number, number], max: [number, number]];
+    /** Returns a longitude/latitude lower-left corner of a canonical XYZ tile. */
+    getTileLowerLeftCorner(x: number, y: number, zoom: number): [number, number];
+}
+//# sourceMappingURL=tile-source-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tile-source-adapter.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/sources/tile-source-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,UAAU,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,QAAQ,EAAC,yBAAsB;AAClG,OAAO,KAAK,EAAC,WAAW,EAAE,mBAAmB,EAAC,0BAAuB;AAGrE,gGAAgG;AAChG,qBAAa,iBAAiB,CAAC,YAAY,SAAS,WAAW,CAAE,YAAW,UAAU;IACpF,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE7B,2EAA2E;gBAC/D,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAcrD,wEAAwE;IAClE,WAAW,IAAI,OAAO,CAAC,mBAAmB,GAAG;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAC,CAAC;IAKzE,+EAA+E;IAC/E,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAkC/D,mFAAmF;IACnF,WAAW,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQvE,8FAA8F;IAC9F,SAAS,CAAC,kBAAkB,CAC1B,UAAU,EAAE,iBAAiB,GAC5B,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAiCjD,8EAA8E;IAC9E,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAO7E"}