ol 9.2.5-sh.1 → 10.0.0

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,17 +179,10 @@ 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.
+   * @override
    */
   getResolutions(projection) {
     const tileGrid = projection
@@ -252,7 +201,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();
@@ -345,23 +294,14 @@ class TileSource extends Source {
     this.tileCache.clear();
   }
 
+  /**
+   * @override
+   */
   refresh() {
     this.clear();
     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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TileArcGISRest.d.ts","sourceRoot":"","sources":["TileArcGISRest.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkCc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAvBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH;;;;;;;;GAQG;AACH;IACE;;OAEG;IACH,2CAsCC;IAnBC;;;OAGG;IACH,gBAAgD;IAEhD;;;OAGG;IACH,eAAgE;IAEhE;;;OAGG;IACH,mBAA+B;IAKjC;;;OAGG;IACH,yBAOC;IAED;;;;;OAKG;IACH,iBAEC;IAED;;;;;;;;;OASG;IACH,uBA8BC;IAWD;;;;OAIG;IACH,gCAGC;CA+CF;sBA5OqB,gBAAgB"}
+{"version":3,"file":"TileArcGISRest.d.ts","sourceRoot":"","sources":["TileArcGISRest.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkCc,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAvBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH;;;;;;;;GAQG;AACH;IACE;;OAEG;IACH,2CAsCC;IAnBC;;;OAGG;IACH,gBAAgD;IAEhD;;;OAGG;IACH,eAAgE;IAEhE;;;OAGG;IACH,mBAA+B;IAKjC;;;OAGG;IACH,yBAOC;IAED;;;;;OAKG;IACH,iBAEC;IAED;;;;;;;;;OASG;IACH,uBA8BC;IAYD;;;;OAIG;IACH,gCAGC;CA+CF;sBA7OqB,gBAAgB"}

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.
@@ -178,6 +178,7 @@ class TileArcGISRest extends TileImage {
    * Get the tile pixel ratio for this source.
    * @param {number} pixelRatio Pixel ratio.
    * @return {number} Tile pixel ratio.
+   * @override
    */
   getTilePixelRatio(pixelRatio) {
     return this.hidpi_ ? pixelRatio : 1;

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/TileEventType.d.ts

@@ -4,5 +4,5 @@ declare namespace _default {
     let TILELOADERROR: string;
 }
 export default _default;
-export type TileSourceEventTypes = 'tileloadstart' | 'tileloadend' | 'tileloaderror';
+export type TileSourceEventTypes = "tileloadstart" | "tileloadend" | "tileloaderror";
 //# sourceMappingURL=TileEventType.d.ts.map

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
@@ -213,8 +209,9 @@ declare class TileImage extends UrlTile {
      * @param {number} pixelRatio Pixel ratio.
      * @param {import("../proj/Projection.js").default} projection Projection.
      * @return {!(ImageTile|ReprojTile)} Tile.
+     * @override
      */
-    getTile(z: number, x: number, y: number, pixelRatio: number, projection: import("../proj/Projection.js").default): (ImageTile | ReprojTile);
+    override getTile(z: number, x: number, y: number, pixelRatio: number, projection: import("../proj/Projection.js").default): (ImageTile | ReprojTile);
     /**
      * @param {number} z Tile coordinate z.
      * @param {number} x Tile coordinate x.

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,OAAA,CAG+C;IAEhE;;;OAGG;IACH,qBAFU,OAAO,SAAS,CAGuC;IAEjE;;;OAGG;IACH,kCAFU;YAAQ,MAAM,GAAE,SAAS;KAAC,CAEJ;IAEhC;;;OAGG;IACH,iCAFU;YAAQ,MAAM,GAAE,OAAO,yBAAyB,EAAE,OAAO;KAAC,CAErC;IAE/B;;;OAGG;IACH,oCAAqE;IAErE;;;OAGG;IACH,iCAAqC;IAqDvC;;OAEG;IACH,aAFY,MAAM,CAIjB;IAoDD;;;;;;;;;OASG;IACH,oBAoBC;IAED;;;;;;;;OAQG;IACH,oBARW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACtC,CAAE,SAAS,GAAC,UAAU,CAAC,CA0DlC;IAED;;;;;;;;OAQG;IACH,6BARW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACN,OAAQ,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;CAWF;sBArZqB,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,
@@ -133,6 +131,7 @@ class TileImage extends UrlTile {
 
   /**
    * @return {boolean} Can expire cache.
+   * @override
    */
   canExpireCache() {
     if (this.tileCache.canExpireCache()) {
@@ -150,6 +149,7 @@ class TileImage extends UrlTile {
   /**
    * @param {import("../proj/Projection.js").default} projection Projection.
    * @param {!Object<string, boolean>} usedTiles Used tiles.
+   * @override
    */
   expireCache(projection, usedTiles) {
     const usedTileCache = this.getTileCacheForProjection(projection);
@@ -166,6 +166,7 @@ class TileImage extends UrlTile {
   /**
    * @param {import("../proj/Projection.js").default} projection Projection.
    * @return {number} Gutter.
+   * @override
    */
   getGutterForProjection(projection) {
     if (
@@ -188,6 +189,7 @@ class TileImage extends UrlTile {
   /**
    * Return the key to be used for all tiles in the source.
    * @return {string} The key for all tiles.
+   * @override
    */
   getKey() {
     let key = super.getKey();
@@ -197,24 +199,10 @@ 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.
+   * @override
    */
   getTileGridForProjection(projection) {
     const thisProj = this.getProjection();
@@ -232,6 +220,7 @@ class TileImage extends UrlTile {
   /**
    * @param {import("../proj/Projection.js").default} projection Projection.
    * @return {import("../TileCache.js").default} Tile cache.
+   * @override
    */
   getTileCacheForProjection(projection) {
     const thisProj = this.getProjection();
@@ -286,6 +275,7 @@ class TileImage extends UrlTile {
    * @param {number} pixelRatio Pixel ratio.
    * @param {import("../proj/Projection.js").default} projection Projection.
    * @return {!(ImageTile|ReprojTile)} Tile.
+   * @override
    */
   getTile(z, x, y, pixelRatio, projection) {
     const sourceProjection = this.getProjection();
@@ -337,8 +327,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 +344,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;
   }
@@ -423,6 +398,9 @@ class TileImage extends UrlTile {
     }
   }
 
+  /**
+   * @override
+   */
   clear() {
     super.clear();
     for (const id in this.tileCacheForProjection) {

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TileJSON.d.ts","sourceRoot":"","sources":["TileJSON.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAyBc,MAAM,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAT3B;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EAgDjB;IA/BC;;;OAGG;IACH,kBAAqB;IAErB;;;OAGG;IACH,kBAAiC;IAuBnC;;;OAGG;IACH,mBAeC;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,eAHY,MAAM,CAKjB;IAED;;;OAGG;IACH,2CAFW,MAAM,QAuChB;IAED;;OAEG;IACH,sCAEC;CACF;sBAvMqB,gBAAgB"}
+{"version":3,"file":"TileJSON.d.ts","sourceRoot":"","sources":["TileJSON.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAyBc,KAAK,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAT3B;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EAgDjB;IA/BC;;;OAGG;IACH,kBAAqB;IAErB;;;OAGG;IACH,kBAAiC;IAuBnC;;;OAGG;IACH,mBAeC;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,eAHY,MAAM,CAKjB;IAED;;;OAGG;IACH,2CAFW,MAAM,QAuChB;IAED;;OAEG;IACH,sCAEC;CACF;sBAvMqB,gBAAgB"}

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwBc;YAAO,MAAM,GAAC,GAAC;KAAC;;;;;;;;;;;;;;;;;;;;iBAehB,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,UACnC,GAAO,GAIN,MAAM,GAAC,SAAS,CA6D3B;IAED;;;;;;;;;;;;;OAaG;IACH,6DAHY,MAAM,GAAC,SAAS,CAmC3B;IAUD;;;;;OAKG;IACH,iBAEC;IAED;;;;;;;;OAQG;IACH,uBAwBC;IAYD;;;OAGG;IACH,yBAOC;IAED;;;;OAIG;IACH,gCAIC;IAED;;OAEG;IACH,mBAGC;CA4CF;sBA/YqB,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,
@@ -269,6 +266,7 @@ class TileWMS extends TileImage {
 
   /**
    * @return {number} Gutter.
+   * @override
    */
   getGutter() {
     return this.gutter_;
@@ -323,6 +321,7 @@ class TileWMS extends TileImage {
    * Get the tile pixel ratio for this source.
    * @param {number} pixelRatio Pixel ratio.
    * @return {number} Tile pixel ratio.
+   * @override
    */
   getTilePixelRatio(pixelRatio) {
     return !this.hidpi_ || this.serverType_ === undefined ? 1 : pixelRatio;

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.
      */
@@ -239,15 +239,17 @@ declare class UTFGrid extends TileSource {
      * @param {number} pixelRatio Pixel ratio.
      * @param {import("../proj/Projection.js").default} projection Projection.
      * @return {!CustomTile} Tile.
+     * @override
      */
-    getTile(z: number, x: number, y: number, pixelRatio: number, projection: import("../proj/Projection.js").default): CustomTile;
+    override getTile(z: number, x: number, y: number, pixelRatio: number, projection: import("../proj/Projection.js").default): CustomTile;
     /**
      * Marks a tile coord as being used, without triggering a load.
      * @param {number} z Tile coordinate z.
      * @param {number} x Tile coordinate x.
      * @param {number} y Tile coordinate y.
+     * @override
      */
-    useTile(z: number, x: number, y: number): void;
+    override useTile(z: number, x: number, y: number): void;
 }
 import TileSource from './Tile.js';
 //# sourceMappingURL=UTFGrid.d.ts.map

package/source/UTFGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UTFGrid.d.ts","sourceRoot":"","sources":["UTFGrid.js"],"names":[],"mappings":"AAgBA;;;;;GAKG;AAEH;IACE;;;;;;;OAOG;IACH,uBAPW,OAAO,iBAAiB,EAAE,SAAS,mBAEnC,MAAM,UACN,OAAO,cAAc,EAAE,MAAM,cAC7B,OAAO,SACP,OAAO,EA8CjB;IAzCC;;;OAGG;IACH,aAAe;IAEf;;;OAGG;IACH,gBAAqB;IAErB;;;OAGG;IACH,oBAA6B;IAE7B;;;OAGG;IACH,cAAiB;IAEjB;;;OAGG;IACH,cAAiB;IAEjB;;;OAGG;IACH,cAAiB;IAEjB;;;OAGG;IACH,eAAmB;IAGrB;;;OAGG;IACH,YAFY,gBAAgB,CAI3B;IAED;;;;OAIG;IACH,oBAHW,OAAO,kBAAkB,EAAE,UAAU,OAqC/C;IAED;;;;;;;OAOG;IACH,gCALW,OAAO,kBAAkB,EAAE,UAAU,2BACxB,IAAI,uCAyB3B;IAUD;;OAEG;IACH,qBAGC;IAED;;;OAGG;IACH,oBAOC;IAED;;OAEG;IACH,sBAiBC;IAED;;;OAGG;IACH,mBAiBC;IAED;;;OAGG;IACH,oBAEC;CAWF;;;;;;UAvOa,MAAM,MAAM,CAAC;;;;UACb,MAAM,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAdV,YAAY;AAsP7B;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EAsDjB;IA5CC;;;OAGG;IACH,oBAC8D;IAE9D;;;OAGG;IACH,yBAA2C;IAE3C;;;OAGG;IACH,kBAA0B;IAE1B;;;OAGG;IACH,eAAoC;IAuBtC;;;OAGG;IACH,mBAiBC;IAED;;;OAGG;IACH,oBAEC;IAED;;;;OAIG;IACH,eAHY,MAAM,GAAC,SAAS,CAK3B;IAED;;;;;;;;;;OAUG;IACH,6CAPW,OAAO,kBAAkB,EAAE,UAAU,cACrC,MAAM,2BACO,IAAI,uCA4B3B;IAED;;OAEG;IACH,sCAEC;IAED;;;;OAIG;IACH,2CAFW,OAAO,eAAe,EAAE,MAAM,QA8CxC;IAED;;;;;;;OAOG;IACH,WAPW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACrC,UAAU,CAuBtB;IAED;;;;;OAKG;IACH,WAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;CACF;uBAzfsB,WAAW"}
+{"version":3,"file":"UTFGrid.d.ts","sourceRoot":"","sources":["UTFGrid.js"],"names":[],"mappings":"AAgBA;;;;;GAKG;AAEH;IACE;;;;;;;OAOG;IACH,uBAPW,OAAO,iBAAiB,EAAE,SAAS,SACnC,GAAiC,OACjC,MAAM,UACN,OAAO,cAAc,EAAE,MAAM,cAC7B,OAAO,SACP,OAAO,EA8CjB;IAzCC;;;OAGG;IACH,aAAe;IAEf;;;OAGG;IACH,gBAAqB;IAErB;;;OAGG;IACH,oBAA6B;IAE7B;;;OAGG;IACH,cAAiB;IAEjB;;;OAGG;IACH,cAAiB;IAEjB;;;OAGG;IACH,cAAiB;IAEjB;;;OAGG;IACH,eAAmB;IAGrB;;;OAGG;IACH,YAFY,gBAAgB,CAI3B;IAED;;;;OAIG;IACH,oBAHW,OAAO,kBAAkB,EAAE,UAAU,GACpC,GAAC,CAoCZ;IAED;;;;;;;OAOG;IACH,gCALW,OAAO,kBAAkB,EAAE,UAAU,YACrC,CAAS,IAAC,EAAD,GAAC,KAAG,IAAI,uCAoB3B;IAWD;;OAEG;IACH,qBAGC;IAED;;;OAGG;IACH,oBAOC;IAED;;OAEG;IACH,sBAiBC;IAED;;;OAGG;IACH,mBAiBC;IAED;;;OAGG;IACH,oBAEC;CAYF;;;;;;UApOa,KAAK,CAAC,MAAM,CAAC;;;;UACb,KAAK,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAdV,YAAY;AAmP7B;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EAsDjB;IA5CC;;;OAGG;IACH,oBAC8D;IAE9D;;;OAGG;IACH,yBAA2C;IAE3C;;;OAGG;IACH,kBAA0B;IAE1B;;;OAGG;IACH,eAAoC;IAuBtC;;;OAGG;IACH,mBAiBC;IAED;;;OAGG;IACH,oBAEC;IAED;;;;OAIG;IACH,eAHY,MAAM,GAAC,SAAS,CAK3B;IAED;;;;;;;;;;OAUG;IACH,6CAPW,OAAO,kBAAkB,EAAE,UAAU,cACrC,MAAM,YACN,CAAS,IAAC,EAAD,GAAC,KAAG,IAAI,uCA4B3B;IAED;;OAEG;IACH,sCAEC;IAED;;;;OAIG;IACH,2CAFW,OAAO,eAAe,EAAE,MAAM,QA8CxC;IAED;;;;;;;;OAQG;IACH,oBARW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,cACN,OAAO,uBAAuB,EAAE,OAAO,GACrC,UAAU,CAwBtB;IAED;;;;;;OAMG;IACH,oBALW,MAAM,KACN,MAAM,KACN,MAAM,QAQhB;CACF;uBAxfsB,WAAW"}