maplibre-gl 3.2.0 → 3.2.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "maplibre-gl",
   "description": "BSD licensed community fork of mapbox-gl, a WebGL interactive maps library",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "main": "dist/maplibre-gl.js",
   "style": "dist/maplibre-gl.css",
   "license": "BSD-3-Clause",
@@ -20,11 +20,12 @@
     "@mapbox/unitbezier": "^0.0.1",
     "@mapbox/vector-tile": "^1.3.1",
     "@mapbox/whoots-js": "^3.1.0",
-    "@maplibre/maplibre-gl-style-spec": "^19.2.1",
+    "@maplibre/maplibre-gl-style-spec": "^19.2.2",
     "@types/geojson": "^7946.0.10",
     "@types/mapbox__point-geometry": "^0.1.2",
     "@types/mapbox__vector-tile": "^1.3.0",
     "@types/pbf": "^3.0.2",
+    "@types/supercluster": "^7.1.0",
     "earcut": "^2.2.4",
     "geojson-vt": "^3.2.1",
     "gl-matrix": "^3.4.3",
@@ -41,7 +42,7 @@
   "devDependencies": {
     "@mapbox/mapbox-gl-rtl-text": "^0.2.3",
     "@mapbox/mvt-fixtures": "^3.10.0",
-    "@rollup/plugin-commonjs": "^25.0.2",
+    "@rollup/plugin-commonjs": "^25.0.3",
     "@rollup/plugin-json": "^6.0.0",
     "@rollup/plugin-node-resolve": "^15.1.0",
     "@rollup/plugin-replace": "^5.0.2",
@@ -53,49 +54,48 @@
     "@types/d3": "^7.4.0",
     "@types/diff": "^5.0.3",
     "@types/earcut": "^2.1.1",
-    "@types/eslint": "^8.40.2",
+    "@types/eslint": "^8.44.1",
     "@types/gl": "^6.0.2",
     "@types/glob": "^8.1.0",
-    "@types/jest": "^29.5.2",
+    "@types/jest": "^29.5.3",
     "@types/jsdom": "^21.1.1",
     "@types/minimist": "^1.2.2",
     "@types/murmurhash-js": "^1.0.4",
     "@types/nise": "^1.4.1",
-    "@types/node": "^20.3.3",
+    "@types/node": "^20.4.5",
     "@types/offscreencanvas": "^2019.7.0",
     "@types/pixelmatch": "^5.2.4",
     "@types/pngjs": "^6.0.1",
-    "@types/react": "^18.2.14",
-    "@types/react-dom": "^18.2.6",
+    "@types/react": "^18.2.17",
+    "@types/react-dom": "^18.2.7",
     "@types/request": "^2.48.8",
     "@types/shuffle-seed": "^1.1.0",
-    "@types/supercluster": "^7.1.0",
     "@types/window-or-global": "^1.0.4",
-    "@typescript-eslint/eslint-plugin": "^5.60.1",
-    "@typescript-eslint/parser": "^5.60.1",
+    "@typescript-eslint/eslint-plugin": "^6.2.0",
+    "@typescript-eslint/parser": "^6.2.0",
     "address": "^1.2.2",
     "benchmark": "^2.1.4",
     "canvas": "^2.11.2",
     "cssnano": "^6.0.1",
     "d3": "^7.8.5",
     "d3-queue": "^3.0.7",
-    "devtools-protocol": "^0.0.1165014",
+    "devtools-protocol": "^0.0.1173815",
     "diff": "^5.1.0",
     "dts-bundle-generator": "^8.0.1",
-    "eslint": "^8.44.0",
+    "eslint": "^8.46.0",
     "eslint-config-mourner": "^3.0.0",
     "eslint-plugin-html": "^7.1.0",
-    "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-jest": "^27.2.2",
+    "eslint-plugin-import": "^2.28.0",
+    "eslint-plugin-jest": "^27.2.3",
+    "eslint-plugin-react": "^7.33.1",
     "eslint-plugin-tsdoc": "0.2.17",
-    "eslint-plugin-react": "^7.32.2",
-    "expect": "^29.5.0",
+    "expect": "^29.6.2",
     "gl": "^6.0.2",
-    "glob": "^10.3.1",
+    "glob": "^10.3.3",
     "is-builtin-module": "^3.2.1",
-    "jest": "^29.5.0",
+    "jest": "^29.6.2",
     "jest-canvas-mock": "^2.5.2",
-    "jest-environment-jsdom": "^29.5.0",
+    "jest-environment-jsdom": "^29.6.2",
     "jsdom": "^22.1.0",
     "json-stringify-pretty-compact": "^4.0.0",
     "minimist": "^1.2.8",
@@ -107,28 +107,28 @@
     "pdf-merger-js": "^4.3.0",
     "pixelmatch": "^5.3.0",
     "pngjs": "^7.0.0",
-    "postcss": "^8.4.24",
+    "postcss": "^8.4.27",
     "postcss-cli": "^10.1.0",
     "postcss-inline-svg": "^6.0.0",
-    "pretty-bytes": "^6.1.0",
-    "puppeteer": "^20.7.4",
+    "pretty-bytes": "^6.1.1",
+    "puppeteer": "^20.9.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "rollup": "^3.26.0",
+    "rollup": "^3.27.0",
     "rollup-plugin-sourcemaps": "^0.6.3",
     "rw": "^1.3.3",
-    "semver": "^7.5.3",
+    "semver": "^7.5.4",
     "shuffle-seed": "^1.1.6",
     "source-map-explorer": "^2.5.3",
     "st": "^3.0.0",
-    "stylelint": "^15.10.1",
-    "stylelint-config-standard": "^33.0.0",
+    "stylelint": "^15.10.2",
+    "stylelint-config-standard": "^34.0.0",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.1",
-    "tslib": "^2.6.0",
+    "tslib": "^2.6.1",
     "typedoc": "^0.24.8",
-    "typedoc-plugin-markdown": "^3.15.3",
-    "typedoc-plugin-missing-exports": "^2.0.0",
+    "typedoc-plugin-markdown": "^3.15.4",
+    "typedoc-plugin-missing-exports": "^2.0.1",
     "typescript": "^5.1.6"
   },
   "overrides": {

package/src/data/array_types.g.ts

@@ -5,6 +5,7 @@ import {register} from '../util/web_worker_transfer';
 import Point from '@mapbox/point-geometry';
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[2]
  *
@@ -36,6 +37,7 @@ StructArrayLayout2i4.prototype.bytesPerElement = 4;
 register('StructArrayLayout2i4', StructArrayLayout2i4);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[3]
  *
@@ -68,6 +70,7 @@ StructArrayLayout3i6.prototype.bytesPerElement = 6;
 register('StructArrayLayout3i6', StructArrayLayout3i6);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[4]
  *
@@ -101,6 +104,7 @@ StructArrayLayout4i8.prototype.bytesPerElement = 8;
 register('StructArrayLayout4i8', StructArrayLayout4i8);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[2]
  * [4]: Int16[4]
@@ -137,6 +141,7 @@ StructArrayLayout2i4i12.prototype.bytesPerElement = 12;
 register('StructArrayLayout2i4i12', StructArrayLayout2i4i12);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[2]
  * [4]: Uint8[4]
@@ -174,6 +179,7 @@ StructArrayLayout2i4ub8.prototype.bytesPerElement = 8;
 register('StructArrayLayout2i4ub8', StructArrayLayout2i4ub8);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[2]
  *
@@ -205,6 +211,7 @@ StructArrayLayout2f8.prototype.bytesPerElement = 8;
 register('StructArrayLayout2f8', StructArrayLayout2f8);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint16[10]
  *
@@ -244,6 +251,7 @@ StructArrayLayout10ui20.prototype.bytesPerElement = 20;
 register('StructArrayLayout10ui20', StructArrayLayout10ui20);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[4]
  * [8]: Uint16[4]
@@ -289,6 +297,7 @@ StructArrayLayout4i4ui4i24.prototype.bytesPerElement = 24;
 register('StructArrayLayout4i4ui4i24', StructArrayLayout4i4ui4i24);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[3]
  *
@@ -321,6 +330,7 @@ StructArrayLayout3f12.prototype.bytesPerElement = 12;
 register('StructArrayLayout3f12', StructArrayLayout3f12);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint32[1]
  *
@@ -351,6 +361,7 @@ StructArrayLayout1ul4.prototype.bytesPerElement = 4;
 register('StructArrayLayout1ul4', StructArrayLayout1ul4);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[6]
  * [12]: Uint32[1]
@@ -396,6 +407,7 @@ StructArrayLayout6i1ul2ui20.prototype.bytesPerElement = 20;
 register('StructArrayLayout6i1ul2ui20', StructArrayLayout6i1ul2ui20);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[2]
  * [4]: Int16[2]
@@ -433,6 +445,7 @@ StructArrayLayout2i2i2i12.prototype.bytesPerElement = 12;
 register('StructArrayLayout2i2i2i12', StructArrayLayout2i2i2i12);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[2]
  * [8]: Float32[1]
@@ -472,6 +485,7 @@ StructArrayLayout2f1f2i16.prototype.bytesPerElement = 16;
 register('StructArrayLayout2f1f2i16', StructArrayLayout2f1f2i16);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint8[2]
  * [4]: Float32[2]
@@ -507,6 +521,7 @@ StructArrayLayout2ub2f12.prototype.bytesPerElement = 12;
 register('StructArrayLayout2ub2f12', StructArrayLayout2ub2f12);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint16[3]
  *
@@ -539,6 +554,7 @@ StructArrayLayout3ui6.prototype.bytesPerElement = 6;
 register('StructArrayLayout3ui6', StructArrayLayout3ui6);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[2]
  * [4]: Uint16[2]
@@ -600,6 +616,7 @@ StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48.prototype.bytesPerElement = 48;
 register('StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48', StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[8]
  * [16]: Uint16[15]
@@ -667,6 +684,7 @@ StructArrayLayout8i15ui1ul4f68.prototype.bytesPerElement = 68;
 register('StructArrayLayout8i15ui1ul4f68', StructArrayLayout8i15ui1ul4f68);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[1]
  *
@@ -697,6 +715,7 @@ StructArrayLayout1f4.prototype.bytesPerElement = 4;
 register('StructArrayLayout1f4', StructArrayLayout1f4);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint32[1]
  * [4]: Uint16[2]
@@ -733,6 +752,7 @@ StructArrayLayout1ul2ui8.prototype.bytesPerElement = 8;
 register('StructArrayLayout1ul2ui8', StructArrayLayout1ul2ui8);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint16[2]
  *
@@ -764,6 +784,7 @@ StructArrayLayout2ui4.prototype.bytesPerElement = 4;
 register('StructArrayLayout2ui4', StructArrayLayout2ui4);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint16[1]
  *
@@ -794,6 +815,7 @@ StructArrayLayout1ui2.prototype.bytesPerElement = 2;
 register('StructArrayLayout1ui2', StructArrayLayout1ui2);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[4]
  *
@@ -826,7 +848,7 @@ class StructArrayLayout4f16 extends StructArray {
 StructArrayLayout4f16.prototype.bytesPerElement = 16;
 register('StructArrayLayout4f16', StructArrayLayout4f16);
 
-/** */
+/** @internal */
 class CollisionBoxStruct extends Struct {
     _structArray: CollisionBoxArray;
     get anchorPointX() { return this._structArray.int16[this._pos2 + 0]; }
@@ -845,7 +867,7 @@ CollisionBoxStruct.prototype.size = 20;
 
 export type CollisionBox = CollisionBoxStruct;
 
-/** */
+/** @internal */
 export class CollisionBoxArray extends StructArrayLayout6i1ul2ui20 {
     /**
      * Return the CollisionBoxStruct at the given location in the array.
@@ -858,7 +880,7 @@ export class CollisionBoxArray extends StructArrayLayout6i1ul2ui20 {
 
 register('CollisionBoxArray', CollisionBoxArray);
 
-/** */
+/** @internal */
 class PlacedSymbolStruct extends Struct {
     _structArray: PlacedSymbolArray;
     get anchorX() { return this._structArray.int16[this._pos2 + 0]; }
@@ -887,7 +909,7 @@ PlacedSymbolStruct.prototype.size = 48;
 
 export type PlacedSymbol = PlacedSymbolStruct;
 
-/** */
+/** @internal */
 export class PlacedSymbolArray extends StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48 {
     /**
      * Return the PlacedSymbolStruct at the given location in the array.
@@ -900,7 +922,7 @@ export class PlacedSymbolArray extends StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48
 
 register('PlacedSymbolArray', PlacedSymbolArray);
 
-/** */
+/** @internal */
 class SymbolInstanceStruct extends Struct {
     _structArray: SymbolInstanceArray;
     get anchorX() { return this._structArray.int16[this._pos2 + 0]; }
@@ -938,7 +960,7 @@ SymbolInstanceStruct.prototype.size = 68;
 
 export type SymbolInstance = SymbolInstanceStruct;
 
-/** */
+/** @internal */
 export class SymbolInstanceArray extends StructArrayLayout8i15ui1ul4f68 {
     /**
      * Return the SymbolInstanceStruct at the given location in the array.
@@ -951,14 +973,14 @@ export class SymbolInstanceArray extends StructArrayLayout8i15ui1ul4f68 {
 
 register('SymbolInstanceArray', SymbolInstanceArray);
 
-/** */
+/** @internal */
 export class GlyphOffsetArray extends StructArrayLayout1f4 {
     getoffsetX(index: number) { return this.float32[index * 1 + 0]; }
 }
 
 register('GlyphOffsetArray', GlyphOffsetArray);
 
-/** */
+/** @internal */
 export class SymbolLineVertexArray extends StructArrayLayout3i6 {
     getx(index: number) { return this.int16[index * 3 + 0]; }
     gety(index: number) { return this.int16[index * 3 + 1]; }
@@ -967,7 +989,7 @@ export class SymbolLineVertexArray extends StructArrayLayout3i6 {
 
 register('SymbolLineVertexArray', SymbolLineVertexArray);
 
-/** */
+/** @internal */
 class FeatureIndexStruct extends Struct {
     _structArray: FeatureIndexArray;
     get featureIndex() { return this._structArray.uint32[this._pos4 + 0]; }
@@ -979,7 +1001,7 @@ FeatureIndexStruct.prototype.size = 8;
 
 export type FeatureIndex = FeatureIndexStruct;
 
-/** */
+/** @internal */
 export class FeatureIndexArray extends StructArrayLayout1ul2ui8 {
     /**
      * Return the FeatureIndexStruct at the given location in the array.

package/src/data/bucket/circle_bucket.ts

@@ -35,6 +35,7 @@ function addCircleVertex(layoutVertexArray, x, y, extrudeX, extrudeY) {
 }
 
 /**
+ * @internal
  * Circles are represented by two triangles.
  *
  * Each corner has a pos that is the center of the circle and an extrusion

package/src/data/bucket/line_bucket.ts

@@ -82,6 +82,7 @@ type GradientTexture = {
 };
 
 /**
+ * @internal
  * Line bucket class
  */
 export class LineBucket implements Bucket {

package/src/data/bucket/symbol_bucket.ts

@@ -276,6 +276,7 @@ class CollisionBuffers {
 register('CollisionBuffers', CollisionBuffers);
 
 /**
+ * @internal
  * Unlike other buckets, which simply implement #addFeature with type-specific
  * logic for (essentially) triangulating feature geometries, SymbolBucket
  * requires specialized behavior:

package/src/data/feature_index.ts

@@ -40,6 +40,7 @@ type QueryParameters = {
 };
 
 /**
+ * @internal
  * An in memory index class to allow fast interaction with features
  */
 export class FeatureIndex {

package/src/data/program_configuration.ts

@@ -393,6 +393,7 @@ class CrossFadedCompositeBinder implements AttributeBinder {
 }
 
 /**
+ * @internal
  * ProgramConfiguration contains the logic for binding style layer properties and tile
  * layer feature data into GL program uniforms and vertex attributes.
  *

package/src/data/segment.ts

@@ -6,6 +6,7 @@ import type {VertexArrayObject} from '../render/vertex_array_object';
 import type {StructArray} from '../util/struct_array';
 
 /**
+ * @internal
  * A single segment of a vector
  */
 export type Segment = {
@@ -18,6 +19,7 @@ export type Segment = {
 };
 
 /**
+ * @internal
  * Used for calculations on vector segments
  */
 export class SegmentVector {

package/src/geo/transform.test.ts

@@ -406,13 +406,16 @@ describe('transform', () => {
         transform.resize(512, 512);
 
         // expect same values because of no elevation change
-        transform.getElevation = () => 200;
-        transform.recalculateZoom(null);
+        const terrain = {
+            getElevationForLngLatZoom: () => 200,
+            pointCoordinate: () => null
+        };
+        transform.recalculateZoom(terrain as any);
         expect(transform.zoom).toBe(14);
 
         // expect new zoom because of elevation change
-        transform.getElevation = () => 400;
-        transform.recalculateZoom(null);
+        terrain.getElevationForLngLatZoom = () => 400;
+        transform.recalculateZoom(terrain as any);
         expect(transform.zoom).toBe(14.127997275621933);
         expect(transform.elevation).toBe(400);
 
@@ -420,8 +423,8 @@ describe('transform', () => {
         expect(transform._center.lat).toBe(50.00000000000017);
 
         // expect new zoom because of elevation change to point below sea level
-        transform.getElevation = () => -200;
-        transform.recalculateZoom(null);
+        terrain.getElevationForLngLatZoom = () => -200;
+        transform.recalculateZoom(terrain as any);
         expect(transform.zoom).toBe(13.773740316343467);
         expect(transform.elevation).toBe(-200);
     });
@@ -458,14 +461,4 @@ describe('transform', () => {
         expect(top).toBeCloseTo(79.1823898251593, 10);
         expect(transform.getBounds().getNorthWest().toArray()).toStrictEqual(transform.pointLocation(new Point(0, top)).toArray());
     });
-
-    test('getElevation with lng less than -180 wraps correctly', () => {
-        const OVERSCALETILEID_DOES_NOT_THROW = 4;
-        const terrain = {
-            getElevation: () => OVERSCALETILEID_DOES_NOT_THROW
-        } as any as Terrain;
-        const transform = new Transform(0, 22, 0, 85, true);
-        expect(transform.getElevation(new LngLat(-183, 40), terrain)).toBe(OVERSCALETILEID_DOES_NOT_THROW);
-    });
-
 });

package/src/geo/transform.ts

@@ -14,6 +14,7 @@ import type {PaddingOptions} from './edge_insets';
 import {Terrain} from '../render/terrain';
 
 /**
+ * @internal
  * A single transform, generally used for a single tile to be
  * scaled, rotated, and zoomed.
  */
@@ -30,7 +31,6 @@ export class Transform {
     rotationMatrix: mat2;
     pixelsToGLUnits: [number, number];
     cameraToCenterDistance: number;
-    cameraToSeaLevelDistance: number;
     mercatorMatrix: mat4;
     projMatrix: mat4;
     invProjMatrix: mat4;
@@ -40,7 +40,6 @@ export class Transform {
     pixelMatrixInverse: mat4;
     glCoordMatrix: mat4;
     labelPlaneMatrix: mat4;
-    freezeElevation: boolean;
     _fov: number;
     _pitch: number;
     _zoom: number;
@@ -57,11 +56,11 @@ export class Transform {
     _constraining: boolean;
     _posMatrixCache: {[_: string]: mat4};
     _alignedPosMatrixCache: {[_: string]: mat4};
+    _minEleveationForCurrentTile: number;
 
     constructor(minZoom?: number, maxZoom?: number, minPitch?: number, maxPitch?: number, renderWorldCopies?: boolean) {
         this.tileSize = 512; // constant
         this.maxValidLatitude = 85.051129; // constant
-        this.freezeElevation = false;
 
         this._renderWorldCopies = renderWorldCopies === undefined ? true : !!renderWorldCopies;
         this._minZoom = minZoom || 0;
@@ -84,6 +83,7 @@ export class Transform {
         this._edgeInsets = new EdgeInsets();
         this._posMatrixCache = {};
         this._alignedPosMatrixCache = {};
+        this._minEleveationForCurrentTile = 0;
     }
 
     clone(): Transform {
@@ -99,6 +99,7 @@ export class Transform {
         this.height = that.height;
         this._center = that._center;
         this._elevation = that._elevation;
+        this._minEleveationForCurrentTile = that._minEleveationForCurrentTile;
         this.zoom = that.zoom;
         this.angle = that.angle;
         this._fov = that._fov;
@@ -470,30 +471,6 @@ export class Transform {
 
     get point(): Point { return this.project(this.center); }
 
-    /**
-     * Updates the center-elevation value unless freezeElevation is activated.
-     * @param terrain - the terrain
-     */
-    updateElevation(terrain?: Terrain) {
-        if (this.freezeElevation) return;
-        this.elevation = terrain ? this.getElevation(this._center, terrain) : 0;
-    }
-
-    /**
-     * get the elevation from terrain for the current zoomlevel.
-     * @param lnglat - the location
-     * @param terrain - the terrain
-     * @returns elevation in meters
-     */
-    getElevation(lnglat: LngLat, terrain: Terrain): number {
-        const merc = MercatorCoordinate.fromLngLat(lnglat.wrap());
-        const worldSize = (1 << this.tileZoom) * EXTENT;
-        const mercX = merc.x * worldSize, mercY = merc.y * worldSize;
-        const tileX = Math.floor(mercX / EXTENT), tileY = Math.floor(mercY / EXTENT);
-        const tileID = new OverscaledTileID(this.tileZoom, 0, this.tileZoom, tileX, tileY);
-        return terrain.getElevation(tileID, mercX % EXTENT, mercY % EXTENT, EXTENT);
-    }
-
     /**
      * get the camera position in LngLat and altitudes in meter
      * @returns An object with lngLat & altitude.
@@ -516,7 +493,7 @@ export class Transform {
     recalculateZoom(terrain: Terrain) {
         // find position the camera is looking on
         const center = this.pointLocation(this.centerPoint, terrain);
-        const elevation = this.getElevation(center, terrain);
+        const elevation = terrain.getElevationForLngLatZoom(center, this.tileZoom);
         const deltaElevation = this.elevation - elevation;
         if (!deltaElevation) return;
 
@@ -557,7 +534,7 @@ export class Transform {
      */
     locationPoint(lnglat: LngLat, terrain?: Terrain): Point {
         return terrain ?
-            this.coordinatePoint(this.locationCoordinate(lnglat), this.getElevation(lnglat, terrain), this.pixelMatrix3D) :
+            this.coordinatePoint(this.locationCoordinate(lnglat), terrain.getElevationForLngLatZoom(lnglat, this.tileZoom), this.pixelMatrix3D) :
             this.coordinatePoint(this.locationCoordinate(lnglat));
     }
 
@@ -827,9 +804,11 @@ export class Transform {
         this.glCoordMatrix = m;
 
         // Calculate the camera to sea-level distance in pixel in respect of terrain
-        // In case of negative elevation (e.g. the dead see) use the lower plane for calculation
-        this.cameraToSeaLevelDistance = this.cameraToCenterDistance + this._elevation * this._pixelPerMeter / Math.cos(this._pitch);
-        const lowestPlane = this._elevation < 0 ? this.cameraToCenterDistance : this.cameraToSeaLevelDistance;
+        const cameraToSeaLevelDistance = this.cameraToCenterDistance + this._elevation * this._pixelPerMeter / Math.cos(this._pitch);
+        // In case of negative minimum elevation (e.g. the dead see, under the sea maps) use a lower plane for calculation
+        const minElevation = Math.min(this.elevation, this._minEleveationForCurrentTile);
+        const cameraToLowestPointDistance = cameraToSeaLevelDistance - minElevation * this._pixelPerMeter / Math.cos(this._pitch);
+        const lowestPlane = minElevation < 0 ? cameraToLowestPointDistance : cameraToSeaLevelDistance;
 
         // Find the distance from the center point [width/2 + offset.x, height/2 + offset.y] to the
         // center top point [width/2 + offset.x, 0] in Z units, using the law of sines.

package/src/gl/context.ts

@@ -24,6 +24,7 @@ type ClearArgs = {
 };
 
 /**
+ * @internal
  * A webgl wrapper class to allow injection, mocking and abstaction
  */
 export class Context {

package/src/gl/framebuffer.ts

@@ -3,6 +3,7 @@ import {ColorAttachment, DepthAttachment, DepthStencilAttachment} from './value'
 import type {Context} from './context';
 
 /**
+ * @internal
  * A framebuffer holder object
  */
 export class Framebuffer {

package/src/gl/index_buffer.ts

@@ -4,6 +4,7 @@ import type {TriangleIndexArray, LineIndexArray, LineStripIndexArray} from '../d
 import type {Context} from '../gl/context';
 
 /**
+ * @internal
  * an index buffer class
  */
 export class IndexBuffer {

package/src/gl/render_pool.ts

@@ -10,7 +10,8 @@ export type PoolObject = {
     inUse: boolean;
 };
 /**
- * RenderPool a resource pool for textures and framebuffers
+ * @internal
+ * `RenderPool` is a resource pool for textures and framebuffers
  */
 export class RenderPool {
     private _objects: Array<PoolObject>;

package/src/gl/vertex_buffer.ts

@@ -21,6 +21,7 @@ const AttributeType = {
 };
 
 /**
+ * @internal
  * The `VertexBuffer` class turns a `StructArray` into a WebGL buffer. Each member of the StructArray's
  * Struct type is converted to a WebGL attribute.
  */

package/src/render/draw_fill.test.ts

@@ -28,7 +28,7 @@ describe('drawFill', () => {
         const painterMock: Painter = constructMockPainer();
         const layer: FillStyleLayer = constructMockLayer();
 
-        const programMock = new Program(null as any, null as any, null as any, null as any, null as any, null as any, null as any);
+        const programMock = new Program(null as any, null as any, null as any, null as any, null as any, null as any);
         (painterMock.useProgram as jest.Mock).mockReturnValue(programMock);
 
         const mockTile = constructMockTile(layer);