ol-stac 1.5.0 → 1.6.0

package/README.md

@@ -17,11 +17,12 @@ Dig into the API documentation for all details:
 
 ### OpenLayers versions
 
-ol-stac works best with OpenLayers >= 10.9.0.
+ol-stac works best with OpenLayers >= 10.10.0.
 
 It should work with older versions >= 9.0.0, but certain features will be unavailable
 or work less reliably, for example:
 
+- Better no-data/transparency handling (requires >= 10.10.0)
 - Better per-band visualization of GeoTiff files (requires >= 10.9.0)
 - Automatic loading of missing projections for GeoTiff files (EPSG code retrieval requires >= 10.0.0, other projection codes require >= 10.8.0)
 - GeoZARR support (requires >= 10.8.0)

package/http.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Creates an `imageLoadFunction` (e.g. for `ol/source/ImageStatic`) that
+ * attaches the headers returned by the given function to the image requests.
+ * See {@link module:ol/http~load} for details.
+ *
+ * @param {GetHeadersFn} getHeaders Returns the headers to send for a URL.
+ * @param {OnErrorFn|null} [onError] Called when a request failed.
+ * @return {function(import('ol/Image.js').default, string): void} The image load function.
+ * @api
+ */
+export function createImageLoadFunction(getHeaders: GetHeadersFn, onError?: OnErrorFn | null | undefined): (arg0: import('ol/Image.js').default, arg1: string) => void;
+/**
+ * Creates a `tileLoadFunction` for image tile sources (e.g. `ol/source/XYZ`)
+ * that attaches the headers returned by the given function to the tile
+ * requests. The headers are requested per tile URL.
+ * See {@link module:ol/http~load} for details.
+ *
+ * @param {GetHeadersFn} getHeaders Returns the headers to send for a URL.
+ * @param {OnErrorFn|null} [onError] Called when a request failed.
+ * @return {function(import('ol/Tile.js').default, string): void} The tile load function.
+ * @api
+ */
+export function createTileLoadFunction(getHeaders: GetHeadersFn, onError?: OnErrorFn | null | undefined): (arg0: import('ol/Tile.js').default, arg1: string) => void;
+/**
+ * A function that returns the HTTP headers to send for the given URL,
+ * or `null` if no additional headers should be sent.
+ */
+export type GetHeadersFn = (arg0: string) => ({
+    [x: string]: string;
+} | null);
+/**
+ * A function that is called when a request has failed.
+ */
+export type OnErrorFn = (arg0: Error) => void;
+//# sourceMappingURL=http.d.ts.map

package/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/ol/http.js"],"names":[],"mappings":"AAyEA;;;;;;;;;GASG;AACH,oDALW,YAAY,kDAEF,OAAO,aAAa,EAAE,OAAO,QAAE,MAAM,KAAG,IAAI,CAQhE;AAED;;;;;;;;;;GAUG;AACH,mDALW,YAAY,kDAEF,OAAO,YAAY,EAAE,OAAO,QAAE,MAAM,KAAG,IAAI,CAU/D;;;;;kCArGqB,MAAM,KAAG,CAAC;QAAO,MAAM,GAAE,MAAM;IAAE,IAAI,CAAC;;;;+BAKtC,KAAK,KAAG,IAAI"}

package/http.js

@@ -0,0 +1,101 @@
+/**
+ * @module ol/http
+ */
+/**
+ * A function that returns the HTTP headers to send for the given URL,
+ * or `null` if no additional headers should be sent.
+ * @typedef {function(string): (Object<string, string>|null)} GetHeadersFn
+ */
+/**
+ * A function that is called when a request has failed.
+ * @typedef {function(Error): void} OnErrorFn
+ */
+/**
+ * Checks whether the given headers are a non-empty object.
+ * @param {*} headers The headers to check.
+ * @return {boolean} `true` if there's at least one header, `false` otherwise.
+ */
+function hasHeaders(headers) {
+    return (typeof headers === 'object' &&
+        headers !== null &&
+        Object.keys(headers).length > 0);
+}
+/**
+ * Loads the given source into the image element.
+ *
+ * If headers are returned for the source URL, the source is requested
+ * through the Fetch API with the headers attached and the response is
+ * assigned to the image element as an object URL, which is revoked once
+ * the image has loaded. Otherwise, the source is assigned directly.
+ *
+ * On request failure, the error is reported and the source is assigned
+ * directly as a fallback, so that errors are reported through the image
+ * element as usual.
+ *
+ * @param {HTMLImageElement} img The image element to load the source into.
+ * @param {string} src The source URL.
+ * @param {GetHeadersFn} getHeaders Returns the headers to send for a URL.
+ * @param {OnErrorFn|null} onError Called when the request failed.
+ */
+function load(img, src, getHeaders, onError) {
+    const headers = getHeaders(src);
+    if (!hasHeaders(headers)) {
+        img.src = src;
+        return;
+    }
+    fetch(src, { headers })
+        .then((response) => {
+        if (!response.ok) {
+            throw new Error(`Unexpected response from ${src}: ${response.status}`);
+        }
+        return response.blob();
+    })
+        .then((blob) => {
+        const objectUrl = URL.createObjectURL(blob);
+        const revoke = () => URL.revokeObjectURL(objectUrl);
+        img.addEventListener('load', revoke, { once: true });
+        img.addEventListener('error', revoke, { once: true });
+        img.src = objectUrl;
+    })
+        .catch((error) => {
+        if (onError) {
+            onError(error);
+        }
+        img.src = src;
+    });
+}
+/**
+ * Creates an `imageLoadFunction` (e.g. for `ol/source/ImageStatic`) that
+ * attaches the headers returned by the given function to the image requests.
+ * See {@link module:ol/http~load} for details.
+ *
+ * @param {GetHeadersFn} getHeaders Returns the headers to send for a URL.
+ * @param {OnErrorFn|null} [onError] Called when a request failed.
+ * @return {function(import('ol/Image.js').default, string): void} The image load function.
+ * @api
+ */
+export function createImageLoadFunction(getHeaders, onError = null) {
+    return (image, src) => {
+        const img = /** @type {HTMLImageElement} */ (image.getImage());
+        load(img, src, getHeaders, onError);
+    };
+}
+/**
+ * Creates a `tileLoadFunction` for image tile sources (e.g. `ol/source/XYZ`)
+ * that attaches the headers returned by the given function to the tile
+ * requests. The headers are requested per tile URL.
+ * See {@link module:ol/http~load} for details.
+ *
+ * @param {GetHeadersFn} getHeaders Returns the headers to send for a URL.
+ * @param {OnErrorFn|null} [onError] Called when a request failed.
+ * @return {function(import('ol/Tile.js').default, string): void} The tile load function.
+ * @api
+ */
+export function createTileLoadFunction(getHeaders, onError = null) {
+    return (tile, src) => {
+        const img = /** @type {HTMLImageElement} */ (
+        /** @type {import('ol/ImageTile.js').default} */ (tile).getImage());
+        load(img, src, getHeaders, onError);
+    };
+}
+//# sourceMappingURL=http.js.map

package/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/ol/http.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AAEH;;;GAGG;AAEH;;;;GAIG;AACH,SAAS,UAAU,CAAC,OAAO;IACzB,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;QACxB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;QACd,OAAO;KACR;IACD,KAAK,CAAC,GAAG,EAAE,EAAC,OAAO,EAAC,CAAC;SAClB,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;SACxE;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QACpD,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;QACnD,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC;IACtB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,CAAC;SAChB;QACD,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAChE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,+BAA+B,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAC/D,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,+BAA+B,CAAC;QAC1C,gDAAgD,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CACnE,CAAC;QACF,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC"}

package/layer/STAC.d.ts

@@ -8,6 +8,10 @@ export type STACObject = any;
 export type Map = import("ol/Map.js").default;
 export type Style = import('ol/style/Style.js').default;
 export type SourceOptions = import('../source/type.js').SourceOptions;
+export type LayerOptions = import('./type.js').LayerOptions;
+export type GetHeadersFn = import('../http.js').GetHeadersFn;
+export type OnErrorFn = import('../http.js').OnErrorFn;
+export type LoadFunction = (arg0: (import("ol/Image.js").default | import("ol/Tile.js").default), arg1: string) => void;
 export type Options = {
     /**
      * The STAC URL. Any of `url` and `data` must be provided.
@@ -45,10 +49,19 @@ export type Options = {
      * Optional function that can be used to configure the underlying sources. The function can do any additional work
      * and return the completed options or a promise for the same. The function will be called with the current source options
      * and the STAC Asset or Link.
-     * This can be useful for adding auth information such as an API token, either via query parameter or HTTP headers.
-     * Please be aware that sending HTTP headers may not be supported by all sources.
+     * This can be useful for advanced per-source customization such as signed URLs.
+     * To add credentials via query parameters, use the `getRequestUrl` option instead;
+     * to send credentials via HTTP headers, use the `getRequestHeaders` option instead.
      */
     getSourceOptions?: ((arg0: SourceType, arg1: SourceOptions, arg2: (Asset | Link)) => (SourceOptions | Promise<SourceOptions>)) | undefined;
+    /**
+     * Optional function that can be used to configure the individual layers that are created for the assets and links.
+     * The function can do any additional (asynchronous) work and return the completed options or a promise for the same.
+     * The function will be called with the layer type, the current layer options and the STAC Asset or Link.
+     * This can be useful to customize the layers, e.g. to apply a style to a GeoTIFF or GeoZarr layer that is
+     * loaded from the STAC metadata.
+     */
+    getLayerOptions?: ((arg0: LayerType, arg1: LayerOptions, arg2: (Asset | Link)) => (LayerOptions | Promise<LayerOptions>)) | undefined;
     /**
      * Allows to hide the footprints (bounding box/geometry) of the STAC object
      * by default.
@@ -67,10 +80,21 @@ export type Options = {
      */
     displayPreview?: boolean | undefined;
     /**
-     * Allow to display COGs/WOZs and, if `displayGeoTiffByDefault` is enabled, GeoTiffs,
+     * Allow to display COGs, Zarr and, if `displayGeoTiffByDefault` is enabled, GeoTiffs,
      * usually an asset with role `overview` or `visual`.
+     * Zarr assets other than Web-Optimized Zarr are only displayed if the STAC metadata declares what to render
+     * (see the datacube extension) and the store is within the `maxDisplayPixels` limit.
      */
     displayOverview?: boolean | undefined;
+    /**
+     * The maximum number of pixels the coarsest resolution level
+     * of a GeoTIFF or Zarr asset may have to be displayed client-side, as displaying the full extent of an asset
+     * loads every tile of that level. Files without (sufficient) overviews can easily exceed this limit.
+     * Larger assets are not chosen for the default visualization, and selecting one explicitly through `assets`
+     * reports an error through the `error` event (or renders through the tile server if `buildTileUrlTemplate`
+     * and `useTileLayerAsFallback` are set). Set to `Infinity` to display assets of any size.
+     */
+    maxDisplayPixels?: number | undefined;
     /**
      * Allow to display a layer
      * based on the information provided through the web map links extension.
@@ -84,6 +108,13 @@ export type Options = {
      * The style for GeoTIFF and GeoZarr layers (WebGLTileLayer style).
      */
     style?: import("ol/layer/WebGLTile.js").Style | null | undefined;
+    /**
+     * The colors of the colormap
+     * that is used for continuous single-band data when neither the STAC metadata nor the `style` option define
+     * a coloring. The colors are evenly distributed over the value range of the data (e.g. from the STAC
+     * `statistics`). If not set, the data is stretched to grayscale.
+     */
+    defaultColormap?: (string | import("ol/color.js").Color)[] | null | undefined;
     /**
      * The style for the overall bounds / footprint.
      */
@@ -101,8 +132,10 @@ export type Options = {
      * A function that generates a URL template for a tile server (XYZ),
      * which will be used instead of the client-side GeoTIFF rendering (except if `useTileLayerAsFallback` is `true`).
      * The function provided can return a promise (i.e. be async) or a string.
+     * The function can return `null` to not pass the given asset or link to the tile server,
+     * e.g. to filter by media type or protocol. In this case client-side rendering is used instead.
      */
-    buildTileUrlTemplate?: ((arg0: (Asset | Link)) => Promise<string> | string | null) | undefined;
+    buildTileUrlTemplate?: ((arg0: (Asset | Link)) => Promise<string | null> | string | null) | undefined;
     /**
      * Uses the given URL template only when the client-side GeoTIFF rendering fails.
      */
@@ -162,8 +195,32 @@ export type Options = {
      * Sets a custom function to make HTTP requests with.
      * The first parameter is the URL to request and the output is a promise that resolves with the response body.
      * The second parameter is the return type, either `json` (default) or `text`.
+     * The STAC Asset or Link the request is made for is passed as third parameter, if available.
      */
     httpRequestFn?: ((arg0: string, arg1: string) => (any)) | undefined;
+    /**
+     * The HTTP headers (e.g. for authentication) to send with the requests made by this layer,
+     * either as a plain object or as a function that returns the headers (or `null` for none) and
+     * is called with the STAC Asset or Link that is shown (if available) and the URL that is requested.
+     * Use a function to restrict the headers to specific hosts, as tile server URLs and asset URLs
+     * may point to hosts that should not receive the credentials.
+     * The headers are attached to requests made by the default `httpRequestFn`, to GeoTIFF, GeoZarr
+     * and PMTiles requests, and via image/tile load functions (through the Fetch API and object URLs)
+     * to preview images and XYZ, TileJSON, WMS and WMTS tiles.
+     */
+    getRequestHeaders?: {
+        [x: string]: string;
+    } | ((arg0: (Asset | Link | STACObject | null), arg1: string) => ({
+        [x: string]: string;
+    } | null)) | undefined;
+    /**
+     * Rewrites a URL before a request is made or a source is created, e.g. to append query
+     * parameters for authentication (signed URLs, API keys). The function is called with the
+     * STAC Asset or Link that is shown (if available) and the URL, and returns the new URL or
+     * `null` to keep the URL unchanged. The rewrite is applied before `getSourceOptions` is called.
+     * For tiled sources the tile URL template is rewritten, not the individual tile URLs.
+     */
+    getRequestUrl?: ((arg0: (Asset | Link | STACObject | null), arg1: string) => (string | null)) | undefined;
 };
 /**
  * @typedef {import("ol/extent.js").Extent} Extent
@@ -192,6 +249,18 @@ export type Options = {
 /**
  * @typedef {import('../source/type.js').SourceOptions} SourceOptions
  */
+/**
+ * @typedef {import('./type.js').LayerOptions} LayerOptions
+ */
+/**
+ * @typedef {import('../http.js').GetHeadersFn} GetHeadersFn
+ */
+/**
+ * @typedef {import('../http.js').OnErrorFn} OnErrorFn
+ */
+/**
+ * @typedef {function((import("ol/Image.js").default|import("ol/Tile.js").default), string): void} LoadFunction
+ */
 /**
  * @typedef {Object} Options
  * @property {string} [url] The STAC URL. Any of `url` and `data` must be provided.
@@ -212,8 +281,15 @@ export type Options = {
  * Optional function that can be used to configure the underlying sources. The function can do any additional work
  * and return the completed options or a promise for the same. The function will be called with the current source options
  * and the STAC Asset or Link.
- * This can be useful for adding auth information such as an API token, either via query parameter or HTTP headers.
- * Please be aware that sending HTTP headers may not be supported by all sources.
+ * This can be useful for advanced per-source customization such as signed URLs.
+ * To add credentials via query parameters, use the `getRequestUrl` option instead;
+ * to send credentials via HTTP headers, use the `getRequestHeaders` option instead.
+ * @property {function(LayerType, LayerOptions, (Asset|Link)):(LayerOptions|Promise<LayerOptions>)} [getLayerOptions]
+ * Optional function that can be used to configure the individual layers that are created for the assets and links.
+ * The function can do any additional (asynchronous) work and return the completed options or a promise for the same.
+ * The function will be called with the layer type, the current layer options and the STAC Asset or Link.
+ * This can be useful to customize the layers, e.g. to apply a style to a GeoTIFF or GeoZarr layer that is
+ * loaded from the STAC metadata.
  * @property {boolean} [displayFootprint=true] Allows to hide the footprints (bounding box/geometry) of the STAC object
  * by default.
  * @property {boolean} [displayGeoTiffByDefault=false] Allow to choose non-cloud-optimized GeoTiffs as default image to show,
@@ -222,8 +298,16 @@ export type Options = {
  * i.e. assets with any of the roles `thumbnail`, `overview`, or a link with relation type `preview`.
  * The previews are usually not covering the full extents and as such may be placed incorrectly on the map.
  * For performance reasons, it is recommended to enable this option if you pass in STAC API Items instead of `displayOverview`.
- * @property {boolean} [displayOverview=true] Allow to display COGs/WOZs and, if `displayGeoTiffByDefault` is enabled, GeoTiffs,
+ * @property {boolean} [displayOverview=true] Allow to display COGs, Zarr and, if `displayGeoTiffByDefault` is enabled, GeoTiffs,
  * usually an asset with role `overview` or `visual`.
+ * Zarr assets other than Web-Optimized Zarr are only displayed if the STAC metadata declares what to render
+ * (see the datacube extension) and the store is within the `maxDisplayPixels` limit.
+ * @property {number} [maxDisplayPixels=16777216] The maximum number of pixels the coarsest resolution level
+ * of a GeoTIFF or Zarr asset may have to be displayed client-side, as displaying the full extent of an asset
+ * loads every tile of that level. Files without (sufficient) overviews can easily exceed this limit.
+ * Larger assets are not chosen for the default visualization, and selecting one explicitly through `assets`
+ * reports an error through the `error` event (or renders through the tile server if `buildTileUrlTemplate`
+ * and `useTileLayerAsFallback` are set). Set to `Infinity` to display assets of any size.
  * @property {string|boolean|Array<Link|string>} [displayWebMapLink=false] Allow to display a layer
  * based on the information provided through the web map links extension.
  * If an array of links or link ids (property `id` in a Link Object) is provided, all corresponding layers will be shown.
@@ -231,13 +315,19 @@ export type Options = {
  * it lets this library choose a web map link to show, but only if no other data is shown.
  * To disable the functionality set this to `false`.
  * @property {import("ol/layer/WebGLTile.js").Style|null} [style=null] The style for GeoTIFF and GeoZarr layers (WebGLTileLayer style).
+ * @property {Array<import("ol/color.js").Color|string>|null} [defaultColormap=null] The colors of the colormap
+ * that is used for continuous single-band data when neither the STAC metadata nor the `style` option define
+ * a coloring. The colors are evenly distributed over the value range of the data (e.g. from the STAC
+ * `statistics`). If not set, the data is stretched to grayscale.
  * @property {Style} [boundsStyle] The style for the overall bounds / footprint.
  * @property {Style} [collectionStyle] The style for individual children in a list of STAC Items or Collections.
  * @property {null|string} [crossOrigin] For thumbnails: The `crossOrigin` attribute for loaded images / tiles.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
- * @property {function((Asset|Link)):Promise<string>|string|null} [buildTileUrlTemplate=null] A function that generates a URL template for a tile server (XYZ),
+ * @property {function((Asset|Link)):Promise<string|null>|string|null} [buildTileUrlTemplate=null] A function that generates a URL template for a tile server (XYZ),
  * which will be used instead of the client-side GeoTIFF rendering (except if `useTileLayerAsFallback` is `true`).
  * The function provided can return a promise (i.e. be async) or a string.
+ * The function can return `null` to not pass the given asset or link to the tile server,
+ * e.g. to filter by media type or protocol. In this case client-side rendering is used instead.
  * @property {boolean} [useTileLayerAsFallback=false] Uses the given URL template only when the client-side GeoTIFF rendering fails.
  * @property {number} [opacity=1] Opacity (0, 1).
  * @property {boolean} [visible=true] Visibility.
@@ -261,6 +351,22 @@ export type Options = {
  * @property {function(string,string):(*)} [httpRequestFn=null] Sets a custom function to make HTTP requests with.
  * The first parameter is the URL to request and the output is a promise that resolves with the response body.
  * The second parameter is the return type, either `json` (default) or `text`.
+ * The STAC Asset or Link the request is made for is passed as third parameter, if available.
+ * @property {Object<string, string>|function((Asset|Link|STACObject|null), string):(Object<string, string>|null)} [getRequestHeaders=null]
+ * The HTTP headers (e.g. for authentication) to send with the requests made by this layer,
+ * either as a plain object or as a function that returns the headers (or `null` for none) and
+ * is called with the STAC Asset or Link that is shown (if available) and the URL that is requested.
+ * Use a function to restrict the headers to specific hosts, as tile server URLs and asset URLs
+ * may point to hosts that should not receive the credentials.
+ * The headers are attached to requests made by the default `httpRequestFn`, to GeoTIFF, GeoZarr
+ * and PMTiles requests, and via image/tile load functions (through the Fetch API and object URLs)
+ * to preview images and XYZ, TileJSON, WMS and WMTS tiles.
+ * @property {function((Asset|Link|STACObject|null), string):(string|null)} [getRequestUrl=null]
+ * Rewrites a URL before a request is made or a source is created, e.g. to append query
+ * parameters for authentication (signed URLs, API keys). The function is called with the
+ * STAC Asset or Link that is shown (if available) and the URL, and returns the new URL or
+ * `null` to keep the URL unchanged. The rewrite is applied before `getSourceOptions` is called.
+ * For tiled sources the tile URL template is rewritten, not the individual tile URLs.
  */
 /**
  * @classdesc
@@ -284,6 +390,21 @@ declare class STACLayer extends LayerGroup {
      * @private
      */
     private getSourceOptions_;
+    /**
+     * @type {function(LayerType, LayerOptions, (Asset|Link)):(LayerOptions|Promise<LayerOptions>)}
+     * @private
+     */
+    private getLayerOptions_;
+    /**
+     * @type {Object<string, string>|function((Asset|Link|STACObject|null), string):(Object<string, string>|null)|null}
+     * @private
+     */
+    private getRequestHeaders_;
+    /**
+     * @type {function((Asset|Link|STACObject|null), string):(string|null)|null}
+     * @private
+     */
+    private getRequestUrl_;
     /**
      * @type {Array<STAC>|null}
      * @private
@@ -334,7 +455,12 @@ declare class STACLayer extends LayerGroup {
      */
     displayWebMapLink_: string | boolean | Array<Link | string>;
     /**
-     * @type {function((Asset|Link)):Promise<string>|string|null}
+     * @type {number|undefined}
+     * @private
+     */
+    private maxDisplayPixels_;
+    /**
+     * @type {function((Asset|Link)):Promise<string|null>|string|null}
      * @private
      */
     private buildTileUrlTemplate_;
@@ -348,6 +474,11 @@ declare class STACLayer extends LayerGroup {
      * @private
      */
     private style_;
+    /**
+     * @type {Array<import("ol/color.js").Color|string>|null}
+     * @private
+     */
+    private defaultColormap_;
     /**
      * @type {Style}
      * @private
@@ -383,9 +514,39 @@ declare class STACLayer extends LayerGroup {
      *
      * @param {string} url The URL to request and the output is a promise that resolves with the response body.
      * @param {string} responseType The return type, either `json` (default) or `text`.
+     * @param {Asset|Link|STACObject|null} [ref] The STAC Asset or Link the request is made for, if available.
      * @return {Promise<*>} The (parsed) response body.
      */
-    fetch_(url: string, responseType?: string): Promise<any>;
+    fetch_(url: string, responseType?: string, ref?: Asset | Link | STACObject | null): Promise<any>;
+    /**
+     * Rewrites the given URL based on the `getRequestUrl` option.
+     *
+     * @param {string} url The URL that is requested.
+     * @param {Asset|Link|STACObject|null} [ref] The STAC Asset or Link that is shown, if available.
+     * @return {string} The rewritten URL, or the given URL if it is not rewritten.
+     */
+    getRequestUrlFor_(url: string, ref?: Asset | Link | STACObject | null): string;
+    /**
+     * Returns the HTTP headers to send for the given URL, based on the
+     * `getRequestHeaders` option.
+     *
+     * @param {string} url The URL that is requested.
+     * @param {Asset|Link|STACObject|null} [ref] The STAC Asset or Link that is shown, if available.
+     * @return {Object<string, string>|null} The headers, or `null` if there are none.
+     */
+    getRequestHeadersFor_(url: string, ref?: Asset | Link | STACObject | null): {
+        [x: string]: string;
+    } | null;
+    /**
+     * Creates a load function for images or tiles that attaches the headers
+     * from the `getRequestHeaders` option and reports errors through the
+     * layer's error event, or `undefined` if no headers are configured.
+     *
+     * @param {function(GetHeadersFn, OnErrorFn=):LoadFunction} factory `createImageLoadFunction` or `createTileLoadFunction`.
+     * @param {Asset|Link|STACObject|null} ref The STAC Asset or Link that is shown, if available.
+     * @return {LoadFunction|undefined} The load function.
+     */
+    createLoadFunction_(factory: (arg0: GetHeadersFn, arg1: OnErrorFn | undefined) => LoadFunction, ref: Asset | Link | STACObject | null): LoadFunction | undefined;
     /**
      * Returns the vector layer that visualizes the bounds / footprint.
      * @return {VectorLayer|null} The vector layer for the bounds
@@ -462,16 +623,29 @@ declare class STACLayer extends LayerGroup {
     addLayerForLink(link: any): Promise<Array<Layer> | undefined>;
     /**
      * @param {Asset} [asset] A STAC Asset
+     * @param {boolean} [autoDisplay] Whether the asset was chosen automatically
+     * (not explicitly requested): skip it silently instead of reporting an
+     * error when it can't be displayed within the configured limits.
      * @return {Promise<Layer|undefined>} Resolves with a Layer or undefined when complete.
      * @private
      */
     private addGeoTiff_;
     /**
      * @param {Asset|Link} [data] A STAC Asset or Link
-     * @return {Promise<TileLayer>} Resolves with a TileLayer when complete.
+     * @return {Promise<TileLayer|undefined>} Resolves with a TileLayer, or undefined if no tile server URL was provided.
      * @private
      */
     private addTileLayerForImagery_;
+    /**
+     * Passes the layer options through the `getLayerOptions` function, if given.
+     *
+     * @param {LayerType} type The type of the layer that is going to be created.
+     * @param {LayerOptions} options The layer options.
+     * @param {Asset|Link} reference The STAC Asset or Link the layer is created for.
+     * @return {Promise<*>} The updated layer options.
+     * @private
+     */
+    private updateLayerOptions_;
     /**
      * @param {Layer|LayerGroup} [layer] A Layer to add to the LayerGroup
      * @param {STACObject} [data] The STAC object, can be any class exposed by stac-js
@@ -491,15 +665,15 @@ declare class STACLayer extends LayerGroup {
      */
     private addGeoJson_;
     /**
-     * Creates a GeoJSON vector layer from the given GeoJSON object.
+     * Creates the options for a GeoJSON vector layer from the given GeoJSON object.
      *
      * @param {GeoJSON} [geojson] The GeoJSON object.
      * @param {Style} [style] The style for the layer.
      * @param {boolean} [visible] Whether the layer is visible.
-     * @return {VectorLayer} The new vector layer.
+     * @return {import("ol/layer/Vector.js").Options} The vector layer options.
      * @private
      */
-    private createGeoJsonLayer_;
+    private getGeoJsonLayerOptions_;
     /**
      * Adds GeoJSON labels and GeoTIFF source imagery to the map based on the label extension.
      *
@@ -507,7 +681,29 @@ declare class STACLayer extends LayerGroup {
      * @private
      */
     private addLabelExtension_;
-    addGeoZarr_(asset: any): Promise<WebGLTileLayer | TileLayer<import("ol/source/Tile.js").default<import("ol/Tile.js").default>> | undefined>;
+    /**
+     * Checks the `maxDisplayPixels` limit for the given source.
+     * Returns `true` when the layer must not be added: automatically chosen
+     * assets are limited silently, for explicitly requested assets an error
+     * is thrown so that callers can fall back or report it.
+     * @param {import('ol/source/Tile.js').default} source The configured (ready) source.
+     * @param {Asset} asset The asset the source was created for.
+     * @param {boolean} autoDisplay Whether the asset was chosen automatically.
+     * @return {boolean} `true` if the asset must not be displayed.
+     * @private
+     */
+    private checkDisplayLimit_;
+    /**
+     * Adds a layer for a GeoZarr asset.
+     * @param {Asset} asset The Zarr asset to show.
+     * @param {boolean} [autoDisplay] Whether the asset was chosen automatically
+     * (not explicitly requested): skip it silently instead of reporting an
+     * error when it doesn't declare what to render or can't be displayed
+     * within the configured limits.
+     * @return {Promise<Layer|undefined>} The layer, if one was added.
+     * @private
+     */
+    private addGeoZarr_;
     /**
      * Update the layers shown manually based on the current configuration.
      * Usually this doesn't need to be called manually.
@@ -534,6 +730,17 @@ declare class STACLayer extends LayerGroup {
      * @api
      */
     setStyle(style: import("ol/layer/WebGLTile.js").Style | null): void;
+    /**
+     * Set the colors of the colormap that is used for continuous single-band
+     * data when neither the STAC metadata nor the `style` option define a
+     * coloring. The colors are evenly distributed over the value range of the
+     * data (e.g. from the STAC `statistics`). Set to `null` to stretch the
+     * data to grayscale instead.
+     * @param {Array<import("ol/color.js").Color|string>|null} colormap The colors of the colormap.
+     * @return {Promise} Resolves once the layers are updated.
+     * @api
+     */
+    setDefaultColormap(colormap: Array<import("ol/color.js").Color | string> | null): Promise<any>;
     /**
      * Update the assets to be rendered.
      * @param {Array<string|Asset>|null} assets The assets to show.
@@ -591,6 +798,7 @@ declare class STACLayer extends LayerGroup {
     /**
      * Gets the WMTS capabilities from the given web-map-links URL.
      * @param {string} url Base URL for the WMTS
+     * @param {Link} link The web map link the request is made for.
      * @param {string} [encoding] The request encoding, either `kvp` (default) or `rest`.
      * @return {Promise<Object|null>} Resolves with the WMTS Capabilities object
      * @private
@@ -598,8 +806,7 @@ declare class STACLayer extends LayerGroup {
     private getWmtsCapabilities_;
 }
 import SourceType from '../source/type.js';
+import LayerType from './type.js';
 import LayerGroup from 'ol/layer/Group.js';
 import VectorLayer from 'ol/layer/Vector.js';
-import WebGLTileLayer from 'ol/layer/WebGLTile.js';
-import TileLayer from 'ol/layer/Tile.js';
 //# sourceMappingURL=STAC.d.ts.map

package/layer/STAC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"STAC.d.ts","sourceRoot":"","sources":["../../../src/ol/layer/STAC.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"STAC.d.ts","sourceRoot":"","sources":["../../../src/ol/layer/STAC.js"],"names":[],"mappings":"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"}