ol 9.2.5-dev.1718652616882 → 9.2.5-dev.1718925536936

package/source/Tile.js

@@ -4,16 +4,15 @@
 import Event from '../events/Event.js';
 import Source from './Source.js';
 import TileCache from '../TileCache.js';
-import TileState from '../TileState.js';
 import {abstract} from '../util.js';
 import {assert} from '../asserts.js';
 import {equivalent} from '../proj.js';
-import {getKeyZXY, withinExtentAndZ} from '../tilecoord.js';
 import {
   getForProjection as getTileGridForProjection,
   wrapX,
 } from '../tilegrid.js';
 import {scale as scaleSize, toSize} from '../size.js';
+import {withinExtentAndZ} from '../tilecoord.js';
 
 /***
  * @template Return
@@ -28,8 +27,7 @@ import {scale as scaleSize, toSize} from '../size.js';
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] CacheSize.
- * @property {boolean} [opaque=false] Whether the layer is opaque.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {number} [tilePixelRatio] TilePixelRatio.
  * @property {import("../proj.js").ProjectionLike} [projection] Projection.
  * @property {import("./Source.js").State} [state] State.
@@ -47,6 +45,8 @@ import {scale as scaleSize, toSize} from '../size.js';
  * Abstract base class; normally only used for creating subclasses and not
  * instantiated in apps.
  * Base class for sources providing images divided into a tile grid.
+ *
+ * @template {import("../Tile.js").default} [TileType=import("../Tile.js").default]
  * @abstract
  * @api
  */
@@ -79,12 +79,6 @@ class TileSource extends Source {
      */
     this.un;
 
-    /**
-     * @private
-     * @type {boolean}
-     */
-    this.opaque_ = options.opaque !== undefined ? options.opaque : false;
-
     /**
      * @private
      * @type {number}
@@ -157,44 +151,6 @@ class TileSource extends Source {
     }
   }
 
-  /**
-   * @param {import("../proj/Projection.js").default} projection Projection.
-   * @param {number} z Zoom level.
-   * @param {import("../TileRange.js").default} tileRange Tile range.
-   * @param {function(import("../Tile.js").default):(boolean|void)} callback Called with each
-   *     loaded tile.  If the callback returns `false`, the tile will not be
-   *     considered loaded.
-   * @return {boolean} The tile range is fully covered with loaded tiles.
-   */
-  forEachLoadedTile(projection, z, tileRange, callback) {
-    const tileCache = this.getTileCacheForProjection(projection);
-    if (!tileCache) {
-      return false;
-    }
-
-    let covered = true;
-    let tile, tileCoordKey, loaded;
-    for (let x = tileRange.minX; x <= tileRange.maxX; ++x) {
-      for (let y = tileRange.minY; y <= tileRange.maxY; ++y) {
-        tileCoordKey = getKeyZXY(z, x, y);
-        loaded = false;
-        if (tileCache.containsKey(tileCoordKey)) {
-          tile = /** @type {!import("../Tile.js").default} */ (
-            tileCache.get(tileCoordKey)
-          );
-          loaded = tile.getState() === TileState.LOADED;
-          if (loaded) {
-            loaded = callback(tile) !== false;
-          }
-        }
-        if (!loaded) {
-          covered = false;
-        }
-      }
-    }
-    return covered;
-  }
-
   /**
    * @param {import("../proj/Projection.js").default} projection Projection.
    * @return {number} Gutter.
@@ -223,14 +179,6 @@ class TileSource extends Source {
     }
   }
 
-  /**
-   * @param {import("../proj/Projection.js").default} projection Projection.
-   * @return {boolean} Opaque.
-   */
-  getOpaque(projection) {
-    return this.opaque_;
-  }
-
   /**
    * @param {import("../proj/Projection").default} [projection] Projection.
    * @return {Array<number>|null} Resolutions.
@@ -252,7 +200,7 @@ class TileSource extends Source {
    * @param {number} y Tile coordinate y.
    * @param {number} pixelRatio Pixel ratio.
    * @param {import("../proj/Projection.js").default} projection Projection.
-   * @return {!import("../Tile.js").default} Tile.
+   * @return {TileType|null} Tile.
    */
   getTile(z, x, y, pixelRatio, projection) {
     return abstract();
@@ -350,18 +298,6 @@ class TileSource extends Source {
     super.refresh();
   }
 
-  /**
-   * Increases the cache size if needed
-   * @param {number} tileCount Minimum number of tiles needed.
-   * @param {import("../proj/Projection.js").default} projection Projection.
-   */
-  updateCacheSize(tileCount, projection) {
-    const tileCache = this.getTileCacheForProjection(projection);
-    if (tileCount > tileCache.highWaterMark) {
-      tileCache.highWaterMark = tileCount;
-    }
-  }
-
   /**
    * Marks a tile coord as being used, without triggering a load.
    * @abstract

package/source/TileArcGISRest.d.ts

@@ -5,7 +5,7 @@ export type Options = {
      */
     attributions?: import("./Source.js").AttributionLike | undefined;
     /**
-     * Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+     * Deprecated.  Use the cacheSize option on the layer instead.
      */
     cacheSize?: number | undefined;
     /**
@@ -93,7 +93,7 @@ export type Options = {
 /**
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.

package/source/TileArcGISRest.js

@@ -12,7 +12,7 @@ import {hash as tileCoordHash} from '../tilecoord.js';
 /**
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.

package/source/TileDebug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TileDebug.d.ts","sourceRoot":"","sources":["TileDebug.js"],"names":[],"mappings":";;;;;iBAUc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;AAFjD;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH;IACE;;OAEG;IACH,2CAmCC;CACF;gBAhEe,UAAU"}
+{"version":3,"file":"TileDebug.d.ts","sourceRoot":"","sources":["TileDebug.js"],"names":[],"mappings":";;;;;iBAUc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;AAFjD;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH;IACE;;OAEG;IACH,2CAkCC;CACF;gBA/De,UAAU"}

package/source/TileDebug.js

@@ -37,7 +37,6 @@ class TileDebug extends XYZ {
     options = options || {};
 
     super({
-      opaque: false,
       projection: options.projection,
       tileGrid: options.tileGrid,
       wrapX: options.wrapX !== undefined ? options.wrapX : true,

package/source/TileImage.d.ts

@@ -9,7 +9,7 @@ export type Options = {
      */
     attributionsCollapsible?: boolean | undefined;
     /**
-     * Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+     * Deprecated.  Use the cacheSize option on the layer instead.
      */
     cacheSize?: number | undefined;
     /**
@@ -23,10 +23,6 @@ export type Options = {
      * linear interpolation is used when resampling.  Set to false to use the nearest neighbor instead.
      */
     interpolate?: boolean | undefined;
-    /**
-     * Whether the layer is opaque.
-     */
-    opaque?: boolean | undefined;
     /**
      * Projection. Default is the view projection.
      */
@@ -66,7 +62,8 @@ export type Options = {
      */
     tilePixelRatio?: number | undefined;
     /**
-     * Optional function to get tile URL given a tile coordinate and the projection.
+     * Deprecated.  Use an ImageTile source and provide a function
+     * for the url option instead.
      */
     tileUrlFunction?: import("../Tile.js").UrlFunction | undefined;
     /**
@@ -105,13 +102,12 @@ export type Options = {
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
  * @property {boolean} [interpolate=true] Use interpolated values when resampling.  By default,
  * linear interpolation is used when resampling.  Set to false to use the nearest neighbor instead.
- * @property {boolean} [opaque=false] Whether the layer is opaque.
  * @property {import("../proj.js").ProjectionLike} [projection] Projection. Default is the view projection.
  * @property {number} [reprojectionErrorThreshold=0.5] Maximum allowed reprojection error (in pixels).
  * Higher values can increase reprojection performance, but decrease precision.
@@ -129,7 +125,8 @@ export type Options = {
  * service advertizes 256px by 256px tiles but actually sends 512px
  * by 512px images (for retina/hidpi devices) then `tilePixelRatio`
  * should be set to `2`.
- * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] Optional function to get tile URL given a tile coordinate and the projection.
+ * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] Deprecated.  Use an ImageTile source and provide a function
+ * for the url option instead.
  * @property {string} [url] URL template. Must include `{x}`, `{y}` or `{-y}`, and `{z}` placeholders.
  * A `{?-?}` template pattern, for example `subdomain{a-f}.domain.com`, may be
  * used instead of defining each one separately in the `urls` option.
@@ -146,8 +143,7 @@ export type Options = {
  * zoom levels. See {@link module:ol/tilegrid/TileGrid~TileGrid#getZForResolution}.
  */
 /**
- * @classdesc
- * Base class for sources providing images divided into a tile grid.
+ * @deprecated Use the ol/source/ImageTile.js instead.
  *
  * @fires import("./Tile.js").TileSourceEvent
  * @api

package/source/TileImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TileImage.d.ts","sourceRoot":"","sources":["TileImage.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAXjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;;GAMG;AACH;IACE;;OAEG;IACH,qBAFY,OAAO,EA+DlB;IArCC;;;OAGG;IACH,uBAFW,MAAM,QAG+C;IAEhE;;;OAGG;IACH,qBAFU,gBAAgB,CAGuC;IAEjE;;;OAGG;IACH;YAFkB,MAAM,GAAE,SAAS;MAEH;IAEhC;;;OAGG;IACH;YAFkB,MAAM,GAAE,OAAO,yBAAyB,EAAE,OAAO;MAEpC;IAE/B;;;OAGG;IACH,oCAAqE;IAErE;;;OAGG;IACH,iCAAqC;IAkDvC;;OAEG;IACH,aAFY,MAAM,CAIjB;IAgED;;;;;;;;;OASG;IACH,oBAoBC;IAED;;;;;;;OAOG;IACH,WAPW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACrC,CAAC,SAAS,GAAC,UAAU,CAAC,CA2DlC;IAED;;;;;;;;OAQG;IACH,6BARW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACL,OAAO,uBAAuB,EAAE,OAAO,GACtC,SAAS,CA+BrB;IAED;;;;OAIG;IACH,mCAHW,OAAO,QAYjB;IAED;;;;;;;;;;;OAWG;IACH,qCAJW,OAAO,YAAY,EAAE,cAAc,YACnC,OAAO,yBAAyB,EAAE,OAAO,QAWnD;CAQF;sBA3aqB,iBAAiB;oBAInB,cAAc;sBAFZ,iBAAiB;uBADhB,mBAAmB"}
+{"version":3,"file":"TileImage.d.ts","sourceRoot":"","sources":["TileImage.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAVjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;GAKG;AACH;IACE;;OAEG;IACH,qBAFY,OAAO,EA8DlB;IArCC;;;OAGG;IACH,uBAFW,MAAM,QAG+C;IAEhE;;;OAGG;IACH,qBAFU,gBAAgB,CAGuC;IAEjE;;;OAGG;IACH;YAFkB,MAAM,GAAE,SAAS;MAEH;IAEhC;;;OAGG;IACH;YAFkB,MAAM,GAAE,OAAO,yBAAyB,EAAE,OAAO;MAEpC;IAE/B;;;OAGG;IACH,oCAAqE;IAErE;;;OAGG;IACH,iCAAqC;IAkDvC;;OAEG;IACH,aAFY,MAAM,CAIjB;IAiDD;;;;;;;;;OASG;IACH,oBAoBC;IAED;;;;;;;OAOG;IACH,WAPW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACrC,CAAC,SAAS,GAAC,UAAU,CAAC,CAyDlC;IAED;;;;;;;;OAQG;IACH,6BARW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACL,OAAO,uBAAuB,EAAE,OAAO,GACtC,SAAS,CAkBrB;IAED;;;;OAIG;IACH,mCAHW,OAAO,QAYjB;IAED;;;;;;;;;;;OAWG;IACH,qCAJW,OAAO,YAAY,EAAE,cAAc,YACnC,OAAO,yBAAyB,EAAE,OAAO,QAWnD;CAQF;sBA3YqB,iBAAiB;oBAInB,cAAc;sBAFZ,iBAAiB;uBADhB,mBAAmB"}

package/source/TileImage.js

@@ -16,13 +16,12 @@ import {getUid} from '../util.js';
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
  * @property {boolean} [interpolate=true] Use interpolated values when resampling.  By default,
  * linear interpolation is used when resampling.  Set to false to use the nearest neighbor instead.
- * @property {boolean} [opaque=false] Whether the layer is opaque.
  * @property {import("../proj.js").ProjectionLike} [projection] Projection. Default is the view projection.
  * @property {number} [reprojectionErrorThreshold=0.5] Maximum allowed reprojection error (in pixels).
  * Higher values can increase reprojection performance, but decrease precision.
@@ -40,7 +39,8 @@ import {getUid} from '../util.js';
  * service advertizes 256px by 256px tiles but actually sends 512px
  * by 512px images (for retina/hidpi devices) then `tilePixelRatio`
  * should be set to `2`.
- * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] Optional function to get tile URL given a tile coordinate and the projection.
+ * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] Deprecated.  Use an ImageTile source and provide a function
+ * for the url option instead.
  * @property {string} [url] URL template. Must include `{x}`, `{y}` or `{-y}`, and `{z}` placeholders.
  * A `{?-?}` template pattern, for example `subdomain{a-f}.domain.com`, may be
  * used instead of defining each one separately in the `urls` option.
@@ -58,8 +58,7 @@ import {getUid} from '../util.js';
  */
 
 /**
- * @classdesc
- * Base class for sources providing images divided into a tile grid.
+ * @deprecated Use the ol/source/ImageTile.js instead.
  *
  * @fires import("./Tile.js").TileSourceEvent
  * @api
@@ -72,7 +71,6 @@ class TileImage extends UrlTile {
     super({
       attributions: options.attributions,
       cacheSize: options.cacheSize,
-      opaque: options.opaque,
       projection: options.projection,
       state: options.state,
       tileGrid: options.tileGrid,
@@ -197,21 +195,6 @@ class TileImage extends UrlTile {
     return key;
   }
 
-  /**
-   * @param {import("../proj/Projection.js").default} projection Projection.
-   * @return {boolean} Opaque.
-   */
-  getOpaque(projection) {
-    if (
-      this.getProjection() &&
-      projection &&
-      !equivalent(this.getProjection(), projection)
-    ) {
-      return false;
-    }
-    return super.getOpaque(projection);
-  }
-
   /**
    * @param {import("../proj/Projection.js").default} projection Projection.
    * @return {!import("../tilegrid/TileGrid.js").default} Tile grid.
@@ -337,8 +320,6 @@ class TileImage extends UrlTile {
     newTile.key = key;
 
     if (tile) {
-      newTile.interimTile = tile;
-      newTile.refreshInterimChain();
       cache.replace(tileCoordKey, newTile);
     } else {
       cache.set(tileCoordKey, newTile);
@@ -356,31 +337,18 @@ class TileImage extends UrlTile {
    * @protected
    */
   getTileInternal(z, x, y, pixelRatio, projection) {
-    let tile = null;
     const tileCoordKey = getKeyZXY(z, x, y);
     const key = this.getKey();
     if (!this.tileCache.containsKey(tileCoordKey)) {
-      tile = this.createTile_(z, x, y, pixelRatio, projection, key);
+      const tile = this.createTile_(z, x, y, pixelRatio, projection, key);
       this.tileCache.set(tileCoordKey, tile);
-    } else {
-      tile = this.tileCache.get(tileCoordKey);
-      if (tile.key != key) {
-        // The source's params changed. If the tile has an interim tile and if we
-        // can use it then we use it. Otherwise we create a new tile.  In both
-        // cases we attempt to assign an interim tile to the new tile.
-        const interimTile = tile;
-        tile = this.createTile_(z, x, y, pixelRatio, projection, key);
+      return tile;
+    }
 
-        //make the new tile the head of the list,
-        if (interimTile.getState() == TileState.IDLE) {
-          //the old tile hasn't begun loading yet, and is now outdated, so we can simply discard it
-          tile.interimTile = interimTile.interimTile;
-        } else {
-          tile.interimTile = interimTile;
-        }
-        tile.refreshInterimChain();
-        this.tileCache.replace(tileCoordKey, tile);
-      }
+    let tile = this.tileCache.get(tileCoordKey);
+    if (tile.key != key) {
+      tile = this.createTile_(z, x, y, pixelRatio, projection, key);
+      this.tileCache.replace(tileCoordKey, tile);
     }
     return tile;
   }

package/source/TileJSON.d.ts

@@ -59,7 +59,7 @@ export type Options = {
      */
     attributions?: import("./Source.js").AttributionLike | undefined;
     /**
-     * Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+     * Deprecated.  Use the cacheSize option on the layer instead.
      */
     cacheSize?: number | undefined;
     /**
@@ -140,7 +140,7 @@ export type Options = {
 /**
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.

package/source/TileJSON.js

@@ -34,7 +34,7 @@ import {jsonp as requestJSONP} from '../net.js';
 /**
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.

package/source/TileWMS.d.ts

@@ -9,7 +9,7 @@ export type Options = {
      */
     attributionsCollapsible?: boolean | undefined;
     /**
-     * Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+     * Deprecated.  Use the cacheSize option on the layer instead.
      */
     cacheSize?: number | undefined;
     /**
@@ -116,7 +116,7 @@ export type Options = {
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.

package/source/TileWMS.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TileWMS.d.ts","sourceRoot":"","sources":["TileWMS.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwBqB,MAAM;;;;;;;;;;;;;;;;;;;;;iBAeb,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAzBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,2CAgEC;IAtCC;;;OAGG;IACH,gBAAgE;IAEhE;;;OAGG;IACH,gBAAqB;IAErB;;;OAGG;IACH,aAAgB;IAEhB;;;OAGG;IACH,oBAAqC;IAErC;;;OAGG;IACH,eAAgE;IAEhE;;;OAGG;IACH,mBAA+B;IAMjC;;;;;;;;;;;;;OAaG;IACH,8BAVW,OAAO,kBAAkB,EAAE,UAAU,cACrC,MAAM,cACN,OAAO,YAAY,EAAE,cAAc,gBAKlC,MAAM,GAAC,SAAS,CA6D3B;IAED;;;;;;;;;;;;;OAaG;IACH,6DAHY,MAAM,GAAC,SAAS,CAmC3B;IASD;;;;;OAKG;IACH,iBAEC;IAED;;;;;;;;OAQG;IACH,uBAwBC;IAWD;;;OAGG;IACH,yBAOC;IAED;;;;OAIG;IACH,gCAIC;IAED;;OAEG;IACH,mBAGC;CA4CF;sBAhZqB,gBAAgB"}
+{"version":3,"file":"TileWMS.d.ts","sourceRoot":"","sources":["TileWMS.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwBqB,MAAM;;;;;;;;;;;;;;;;;;;;;iBAeb,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAzBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,2CA6DC;IAtCC;;;OAGG;IACH,gBAAgE;IAEhE;;;OAGG;IACH,gBAAqB;IAErB;;;OAGG;IACH,aAAgB;IAEhB;;;OAGG;IACH,oBAAqC;IAErC;;;OAGG;IACH,eAAgE;IAEhE;;;OAGG;IACH,mBAA+B;IAMjC;;;;;;;;;;;;;OAaG;IACH,8BAVW,OAAO,kBAAkB,EAAE,UAAU,cACrC,MAAM,cACN,OAAO,YAAY,EAAE,cAAc,gBAKlC,MAAM,GAAC,SAAS,CA6D3B;IAED;;;;;;;;;;;;;OAaG;IACH,6DAHY,MAAM,GAAC,SAAS,CAmC3B;IASD;;;;;OAKG;IACH,iBAEC;IAED;;;;;;;;OAQG;IACH,uBAwBC;IAWD;;;OAGG;IACH,yBAOC;IAED;;;;OAIG;IACH,gCAIC;IAED;;OAEG;IACH,mBAGC;CA4CF;sBA7YqB,gBAAgB"}

package/source/TileWMS.js

@@ -16,7 +16,7 @@ import {hash as tileCoordHash} from '../tilecoord.js';
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] Initial tile cache size. Will auto-grow to hold at least the number of tiles in the viewport.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images.  Note that
  * you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer.
  * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
@@ -84,15 +84,12 @@ class TileWMS extends TileImage {
 
     const params = Object.assign({}, options.params);
 
-    const transparent = 'TRANSPARENT' in params ? params['TRANSPARENT'] : true;
-
     super({
       attributions: options.attributions,
       attributionsCollapsible: options.attributionsCollapsible,
       cacheSize: options.cacheSize,
       crossOrigin: options.crossOrigin,
       interpolate: options.interpolate,
-      opaque: !transparent,
       projection: options.projection,
       reprojectionErrorThreshold: options.reprojectionErrorThreshold,
       tileClass: options.tileClass,

package/source/UTFGrid.d.ts

@@ -169,7 +169,7 @@ import Tile from '../Tile.js';
  * Layer source for UTFGrid interaction data loaded from TileJSON format.
  * @api
  */
-declare class UTFGrid extends TileSource {
+declare class UTFGrid extends TileSource<Tile> {
     /**
      * @param {Options} options Source options.
      */

package/source/UrlTile.d.ts

@@ -9,13 +9,9 @@ export type Options = {
      */
     attributionsCollapsible?: boolean | undefined;
     /**
-     * Cache size.
+     * Deprecated.  Use the cacheSize option on the layer instead.
      */
     cacheSize?: number | undefined;
-    /**
-     * Whether the layer is opaque.
-     */
-    opaque?: boolean | undefined;
     /**
      * Projection.
      */
@@ -37,7 +33,8 @@ export type Options = {
      */
     tilePixelRatio?: number | undefined;
     /**
-     * TileUrlFunction.
+     * Deprecated.  Use an ImageTile source and provide a function
+     * for the url option instead.
      */
     tileUrlFunction?: import("../Tile.js").UrlFunction | undefined;
     /**
@@ -74,14 +71,14 @@ export type Options = {
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] Cache size.
- * @property {boolean} [opaque=false] Whether the layer is opaque.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {import("../proj.js").ProjectionLike} [projection] Projection.
  * @property {import("./Source.js").State} [state] State.
  * @property {import("../tilegrid/TileGrid.js").default} [tileGrid] TileGrid.
  * @property {import("../Tile.js").LoadFunction} tileLoadFunction TileLoadFunction.
  * @property {number} [tilePixelRatio] TilePixelRatio.
- * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] TileUrlFunction.
+ * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] Deprecated.  Use an ImageTile source and provide a function
+ * for the url option instead.
  * @property {string} [url] Url.
  * @property {Array<string>} [urls] Urls.
  * @property {boolean} [wrapX=true] WrapX.
@@ -92,12 +89,11 @@ export type Options = {
  * the nearest neighbor is used when resampling.
  */
 /**
- * @classdesc
- * Base class for sources providing tiles divided into a tile grid over http.
+ * @deprecated Use the ol/source/ImageTile.js instead.
  *
  * @fires import("./Tile.js").TileSourceEvent
  */
-declare class UrlTile extends TileSource {
+declare class UrlTile extends TileSource<import("../Tile.js").default> {
     /**
      * @param {Options} options Image tile options.
      */
@@ -130,18 +126,21 @@ declare class UrlTile extends TileSource {
      */
     private tileLoadingKeys_;
     /**
+     * Deprecated.  Use an ImageTile source instead.
      * Return the tile load function of the source.
      * @return {import("../Tile.js").LoadFunction} TileLoadFunction
      * @api
      */
     getTileLoadFunction(): import("../Tile.js").LoadFunction;
     /**
+     * Deprecated.  Use an ImageTile source instead.
      * Return the tile URL function of the source.
      * @return {import("../Tile.js").UrlFunction} TileUrlFunction
      * @api
      */
     getTileUrlFunction(): import("../Tile.js").UrlFunction;
     /**
+     * Deprecated.  Use an ImageTile source instead.
      * Return the URLs used for this source.
      * When a tileUrlFunction is used instead of url or urls,
      * null will be returned.
@@ -156,12 +155,14 @@ declare class UrlTile extends TileSource {
      */
     protected handleTileChange(event: import("../events/Event.js").default): void;
     /**
+     * Deprecated.  Use an ImageTile source instead.
      * Set the tile load function of the source.
      * @param {import("../Tile.js").LoadFunction} tileLoadFunction Tile load function.
      * @api
      */
     setTileLoadFunction(tileLoadFunction: import("../Tile.js").LoadFunction): void;
     /**
+     * Deprecated.  Use an ImageTile source instead.
      * Set the tile URL function of the source.
      * @param {import("../Tile.js").UrlFunction} tileUrlFunction Tile URL function.
      * @param {string} [key] Optional new tile key for the source.
@@ -175,6 +176,7 @@ declare class UrlTile extends TileSource {
      */
     setUrl(url: string): void;
     /**
+     * Deprecated.  Use an ImageTile source instead.
      * Set the URLs to use for requests.
      * @param {Array<string>} urls URLs.
      * @api

package/source/UrlTile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UrlTile.d.ts","sourceRoot":"","sources":["UrlTile.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;iBAgBc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;sBAGnC,OAAO,YAAY,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAT/C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;GAKG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EAqDjB;IAlCC;;;OAGG;IACH,iCAC4D;IAE5D;;;OAGG;IACH,4BAFU,OAAO,YAAY,EAAE,YAAY,CAEK;IAwIlD;;;;;OAKG;IACH,2BALW,OAAO,iBAAiB,EAAE,SAAS,cACnC,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACtC,MAAM,GAAC,SAAS,CAI3B;IA1IC;;;OAGG;IACH,gBAFW,MAAM,MAAM,CAAC,GAAC,IAAI,CAEb;IAQhB;;;OAGG;IACH,yBAA0B;IAG5B;;;;OAIG;IACH,uBAHY,OAAO,YAAY,EAAE,YAAY,CAK5C;IAED;;;;OAIG;IACH,sBAHY,OAAO,YAAY,EAAE,WAAW,CAO3C;IAED;;;;;;OAMG;IACH,WAHa,MAAM,MAAM,CAAC,GAAC,IAAI,CAK9B;IAED;;;;OAIG;IACH,kCAHW,OAAO,oBAAoB,EAAE,OAAO,QAuB9C;IAED;;;;OAIG;IACH,sCAHW,OAAO,YAAY,EAAE,YAAY,QAO3C;IAED;;;;;OAKG;IACH,oCAJW,OAAO,YAAY,EAAE,WAAW,kCAY1C;IAED;;;;OAIG;IACH,YAHW,MAAM,QAOhB;IAED;;;;OAIG;IACH,cAHW,MAAM,MAAM,CAAC,QAWvB;IAYD;;;;;OAKG;IACH,WAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;CACF;uBAhOyC,WAAW"}
+{"version":3,"file":"UrlTile.d.ts","sourceRoot":"","sources":["UrlTile.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;iBAgBc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;sBAGnC,OAAO,YAAY,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAR/C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EAoDjB;IAlCC;;;OAGG;IACH,iCAC4D;IAE5D;;;OAGG;IACH,4BAFU,OAAO,YAAY,EAAE,YAAY,CAEK;IA8IlD;;;;;OAKG;IACH,2BALW,OAAO,iBAAiB,EAAE,SAAS,cACnC,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACtC,MAAM,GAAC,SAAS,CAI3B;IAhJC;;;OAGG;IACH,gBAFW,MAAM,MAAM,CAAC,GAAC,IAAI,CAEb;IAQhB;;;OAGG;IACH,yBAA0B;IAG5B;;;;;OAKG;IACH,uBAHY,OAAO,YAAY,EAAE,YAAY,CAK5C;IAED;;;;;OAKG;IACH,sBAHY,OAAO,YAAY,EAAE,WAAW,CAO3C;IAED;;;;;;;OAOG;IACH,WAHa,MAAM,MAAM,CAAC,GAAC,IAAI,CAK9B;IAED;;;;OAIG;IACH,kCAHW,OAAO,oBAAoB,EAAE,OAAO,QAuB9C;IAED;;;;;OAKG;IACH,sCAHW,OAAO,YAAY,EAAE,YAAY,QAO3C;IAED;;;;;;OAMG;IACH,oCAJW,OAAO,YAAY,EAAE,WAAW,kCAY1C;IAED;;;;OAIG;IACH,YAHW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,cAHW,MAAM,MAAM,CAAC,QAWvB;IAYD;;;;;OAKG;IACH,WAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;CACF;uBArOyC,WAAW"}

package/source/UrlTile.js

@@ -4,7 +4,8 @@
 import TileEventType from './TileEventType.js';
 import TileSource, {TileSourceEvent} from './Tile.js';
 import TileState from '../TileState.js';
-import {createFromTemplates, expandUrl} from '../tileurlfunction.js';
+import {createFromTemplates} from '../tileurlfunction.js';
+import {expandUrl} from '../uri.js';
 import {getKeyZXY} from '../tilecoord.js';
 import {getUid} from '../util.js';
 
@@ -12,14 +13,14 @@ import {getUid} from '../util.js';
  * @typedef {Object} Options
  * @property {import("./Source.js").AttributionLike} [attributions] Attributions.
  * @property {boolean} [attributionsCollapsible=true] Attributions are collapsible.
- * @property {number} [cacheSize] Cache size.
- * @property {boolean} [opaque=false] Whether the layer is opaque.
+ * @property {number} [cacheSize] Deprecated.  Use the cacheSize option on the layer instead.
  * @property {import("../proj.js").ProjectionLike} [projection] Projection.
  * @property {import("./Source.js").State} [state] State.
  * @property {import("../tilegrid/TileGrid.js").default} [tileGrid] TileGrid.
  * @property {import("../Tile.js").LoadFunction} tileLoadFunction TileLoadFunction.
  * @property {number} [tilePixelRatio] TilePixelRatio.
- * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] TileUrlFunction.
+ * @property {import("../Tile.js").UrlFunction} [tileUrlFunction] Deprecated.  Use an ImageTile source and provide a function
+ * for the url option instead.
  * @property {string} [url] Url.
  * @property {Array<string>} [urls] Urls.
  * @property {boolean} [wrapX=true] WrapX.
@@ -31,8 +32,7 @@ import {getUid} from '../util.js';
  */
 
 /**
- * @classdesc
- * Base class for sources providing tiles divided into a tile grid over http.
+ * @deprecated Use the ol/source/ImageTile.js instead.
  *
  * @fires import("./Tile.js").TileSourceEvent
  */
@@ -44,7 +44,6 @@ class UrlTile extends TileSource {
     super({
       attributions: options.attributions,
       cacheSize: options.cacheSize,
-      opaque: options.opaque,
       projection: options.projection,
       state: options.state,
       tileGrid: options.tileGrid,
@@ -94,6 +93,7 @@ class UrlTile extends TileSource {
   }
 
   /**
+   * Deprecated.  Use an ImageTile source instead.
    * Return the tile load function of the source.
    * @return {import("../Tile.js").LoadFunction} TileLoadFunction
    * @api
@@ -103,6 +103,7 @@ class UrlTile extends TileSource {
   }
 
   /**
+   * Deprecated.  Use an ImageTile source instead.
    * Return the tile URL function of the source.
    * @return {import("../Tile.js").UrlFunction} TileUrlFunction
    * @api
@@ -114,6 +115,7 @@ class UrlTile extends TileSource {
   }
 
   /**
+   * Deprecated.  Use an ImageTile source instead.
    * Return the URLs used for this source.
    * When a tileUrlFunction is used instead of url or urls,
    * null will be returned.
@@ -152,6 +154,7 @@ class UrlTile extends TileSource {
   }
 
   /**
+   * Deprecated.  Use an ImageTile source instead.
    * Set the tile load function of the source.
    * @param {import("../Tile.js").LoadFunction} tileLoadFunction Tile load function.
    * @api
@@ -163,6 +166,7 @@ class UrlTile extends TileSource {
   }
 
   /**
+   * Deprecated.  Use an ImageTile source instead.
    * Set the tile URL function of the source.
    * @param {import("../Tile.js").UrlFunction} tileUrlFunction Tile URL function.
    * @param {string} [key] Optional new tile key for the source.
@@ -190,6 +194,7 @@ class UrlTile extends TileSource {
   }
 
   /**
+   * Deprecated.  Use an ImageTile source instead.
    * Set the URLs to use for requests.
    * @param {Array<string>} urls URLs.
    * @api