maplibre-gl 3.2.1 → 3.3.0

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.1",
+  "version": "3.3.0",
   "main": "dist/maplibre-gl.js",
   "style": "dist/maplibre-gl.css",
   "license": "BSD-3-Clause",
@@ -20,7 +20,7 @@
     "@mapbox/unitbezier": "^0.0.1",
     "@mapbox/vector-tile": "^1.3.1",
     "@mapbox/whoots-js": "^3.1.0",
-    "@maplibre/maplibre-gl-style-spec": "^19.2.2",
+    "@maplibre/maplibre-gl-style-spec": "^19.3.0",
     "@types/geojson": "^7946.0.10",
     "@types/mapbox__point-geometry": "^0.1.2",
     "@types/mapbox__vector-tile": "^1.3.0",
@@ -54,7 +54,7 @@
     "@types/d3": "^7.4.0",
     "@types/diff": "^5.0.3",
     "@types/earcut": "^2.1.1",
-    "@types/eslint": "^8.44.0",
+    "@types/eslint": "^8.44.2",
     "@types/gl": "^6.0.2",
     "@types/glob": "^8.1.0",
     "@types/jest": "^29.5.3",
@@ -62,40 +62,40 @@
     "@types/minimist": "^1.2.2",
     "@types/murmurhash-js": "^1.0.4",
     "@types/nise": "^1.4.1",
-    "@types/node": "^20.4.4",
+    "@types/node": "^20.4.8",
     "@types/offscreencanvas": "^2019.7.0",
     "@types/pixelmatch": "^5.2.4",
     "@types/pngjs": "^6.0.1",
-    "@types/react": "^18.2.15",
+    "@types/react": "^18.2.18",
     "@types/react-dom": "^18.2.7",
     "@types/request": "^2.48.8",
     "@types/shuffle-seed": "^1.1.0",
     "@types/window-or-global": "^1.0.4",
-    "@typescript-eslint/eslint-plugin": "^5.61.0",
-    "@typescript-eslint/parser": "^5.62.0",
+    "@typescript-eslint/eslint-plugin": "^6.2.1",
+    "@typescript-eslint/parser": "^6.2.1",
     "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.1170846",
+    "devtools-protocol": "^0.0.1179426",
     "diff": "^5.1.0",
     "dts-bundle-generator": "^8.0.1",
-    "eslint": "^8.45.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-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.33.0",
-    "expect": "^29.5.0",
+    "expect": "^29.6.2",
     "gl": "^6.0.2",
     "glob": "^10.3.3",
     "is-builtin-module": "^3.2.1",
-    "jest": "^29.6.1",
+    "jest": "^29.6.2",
     "jest-canvas-mock": "^2.5.2",
-    "jest-environment-jsdom": "^29.6.1",
+    "jest-environment-jsdom": "^29.6.2",
     "jsdom": "^22.1.0",
     "json-stringify-pretty-compact": "^4.0.0",
     "minimist": "^1.2.8",
@@ -107,14 +107,14 @@
     "pdf-merger-js": "^4.3.0",
     "pixelmatch": "^5.3.0",
     "pngjs": "^7.0.0",
-    "postcss": "^8.4.26",
+    "postcss": "^8.4.27",
     "postcss-cli": "^10.1.0",
     "postcss-inline-svg": "^6.0.0",
     "pretty-bytes": "^6.1.1",
-    "puppeteer": "^20.9.0",
+    "puppeteer": "^21.0.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "rollup": "^3.26.3",
+    "rollup": "^3.27.2",
     "rollup-plugin-sourcemaps": "^0.6.3",
     "rw": "^1.3.3",
     "semver": "^7.5.4",
@@ -125,10 +125,10 @@
     "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,14 +616,16 @@ StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48.prototype.bytesPerElement = 48;
 register('StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48', StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Int16[8]
  * [16]: Uint16[15]
  * [48]: Uint32[1]
- * [52]: Float32[4]
+ * [52]: Float32[2]
+ * [60]: Uint16[2]
  *
  */
-class StructArrayLayout8i15ui1ul4f68 extends StructArray {
+class StructArrayLayout8i15ui1ul2f2ui64 extends StructArray {
     uint8: Uint8Array;
     int16: Int16Array;
     uint16: Uint16Array;
@@ -629,8 +647,8 @@ class StructArrayLayout8i15ui1ul4f68 extends StructArray {
     }
 
     public emplace(i: number, v0: number, v1: number, v2: number, v3: number, v4: number, v5: number, v6: number, v7: number, v8: number, v9: number, v10: number, v11: number, v12: number, v13: number, v14: number, v15: number, v16: number, v17: number, v18: number, v19: number, v20: number, v21: number, v22: number, v23: number, v24: number, v25: number, v26: number, v27: number) {
-        const o2 = i * 34;
-        const o4 = i * 17;
+        const o2 = i * 32;
+        const o4 = i * 16;
         this.int16[o2 + 0] = v0;
         this.int16[o2 + 1] = v1;
         this.int16[o2 + 2] = v2;
@@ -657,16 +675,17 @@ class StructArrayLayout8i15ui1ul4f68 extends StructArray {
         this.uint32[o4 + 12] = v23;
         this.float32[o4 + 13] = v24;
         this.float32[o4 + 14] = v25;
-        this.float32[o4 + 15] = v26;
-        this.float32[o4 + 16] = v27;
+        this.uint16[o2 + 30] = v26;
+        this.uint16[o2 + 31] = v27;
         return i;
     }
 }
 
-StructArrayLayout8i15ui1ul4f68.prototype.bytesPerElement = 68;
-register('StructArrayLayout8i15ui1ul4f68', StructArrayLayout8i15ui1ul4f68);
+StructArrayLayout8i15ui1ul2f2ui64.prototype.bytesPerElement = 64;
+register('StructArrayLayout8i15ui1ul2f2ui64', StructArrayLayout8i15ui1ul2f2ui64);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[1]
  *
@@ -697,6 +716,44 @@ StructArrayLayout1f4.prototype.bytesPerElement = 4;
 register('StructArrayLayout1f4', StructArrayLayout1f4);
 
 /**
+ * @internal
+ * Implementation of the StructArray layout:
+ * [0]: Uint16[1]
+ * [4]: Float32[2]
+ *
+ */
+class StructArrayLayout1ui2f12 extends StructArray {
+    uint8: Uint8Array;
+    uint16: Uint16Array;
+    float32: Float32Array;
+
+    _refreshViews() {
+        this.uint8 = new Uint8Array(this.arrayBuffer);
+        this.uint16 = new Uint16Array(this.arrayBuffer);
+        this.float32 = new Float32Array(this.arrayBuffer);
+    }
+
+    public emplaceBack(v0: number, v1: number, v2: number) {
+        const i = this.length;
+        this.resize(i + 1);
+        return this.emplace(i, v0, v1, v2);
+    }
+
+    public emplace(i: number, v0: number, v1: number, v2: number) {
+        const o2 = i * 6;
+        const o4 = i * 3;
+        this.uint16[o2 + 0] = v0;
+        this.float32[o4 + 1] = v1;
+        this.float32[o4 + 2] = v2;
+        return i;
+    }
+}
+
+StructArrayLayout1ui2f12.prototype.bytesPerElement = 12;
+register('StructArrayLayout1ui2f12', StructArrayLayout1ui2f12);
+
+/**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint32[1]
  * [4]: Uint16[2]
@@ -733,6 +790,7 @@ StructArrayLayout1ul2ui8.prototype.bytesPerElement = 8;
 register('StructArrayLayout1ul2ui8', StructArrayLayout1ul2ui8);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint16[2]
  *
@@ -764,6 +822,7 @@ StructArrayLayout2ui4.prototype.bytesPerElement = 4;
 register('StructArrayLayout2ui4', StructArrayLayout2ui4);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Uint16[1]
  *
@@ -794,6 +853,7 @@ StructArrayLayout1ui2.prototype.bytesPerElement = 2;
 register('StructArrayLayout1ui2', StructArrayLayout1ui2);
 
 /**
+ * @internal
  * Implementation of the StructArray layout:
  * [0]: Float32[4]
  *
@@ -826,7 +886,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 +905,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 +918,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 +947,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 +960,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]; }
@@ -929,17 +989,17 @@ class SymbolInstanceStruct extends Struct {
     get crossTileID() { return this._structArray.uint32[this._pos4 + 12]; }
     set crossTileID(x: number) { this._structArray.uint32[this._pos4 + 12] = x; }
     get textBoxScale() { return this._structArray.float32[this._pos4 + 13]; }
-    get textOffset0() { return this._structArray.float32[this._pos4 + 14]; }
-    get textOffset1() { return this._structArray.float32[this._pos4 + 15]; }
-    get collisionCircleDiameter() { return this._structArray.float32[this._pos4 + 16]; }
+    get collisionCircleDiameter() { return this._structArray.float32[this._pos4 + 14]; }
+    get textAnchorOffsetStartIndex() { return this._structArray.uint16[this._pos2 + 30]; }
+    get textAnchorOffsetEndIndex() { return this._structArray.uint16[this._pos2 + 31]; }
 }
 
-SymbolInstanceStruct.prototype.size = 68;
+SymbolInstanceStruct.prototype.size = 64;
 
 export type SymbolInstance = SymbolInstanceStruct;
 
-/** */
-export class SymbolInstanceArray extends StructArrayLayout8i15ui1ul4f68 {
+/** @internal */
+export class SymbolInstanceArray extends StructArrayLayout8i15ui1ul2f2ui64 {
     /**
      * Return the SymbolInstanceStruct at the given location in the array.
      * @param index The index of the element.
@@ -951,14 +1011,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 +1027,32 @@ export class SymbolLineVertexArray extends StructArrayLayout3i6 {
 
 register('SymbolLineVertexArray', SymbolLineVertexArray);
 
-/** */
+/** @internal */
+class TextAnchorOffsetStruct extends Struct {
+    _structArray: TextAnchorOffsetArray;
+    get textAnchor() { return this._structArray.uint16[this._pos2 + 0]; }
+    get textOffset0() { return this._structArray.float32[this._pos4 + 1]; }
+    get textOffset1() { return this._structArray.float32[this._pos4 + 2]; }
+}
+
+TextAnchorOffsetStruct.prototype.size = 12;
+
+export type TextAnchorOffset = TextAnchorOffsetStruct;
+
+/** @internal */
+export class TextAnchorOffsetArray extends StructArrayLayout1ui2f12 {
+    /**
+     * Return the TextAnchorOffsetStruct at the given location in the array.
+     * @param index The index of the element.
+     */
+    get(index: number): TextAnchorOffsetStruct {
+        return new TextAnchorOffsetStruct(this, index);
+    }
+}
+
+register('TextAnchorOffsetArray', TextAnchorOffsetArray);
+
+/** @internal */
 class FeatureIndexStruct extends Struct {
     _structArray: FeatureIndexArray;
     get featureIndex() { return this._structArray.uint32[this._pos4 + 0]; }
@@ -979,7 +1064,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.
@@ -1029,8 +1114,9 @@ export {
     StructArrayLayout2ub2f12,
     StructArrayLayout3ui6,
     StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48,
-    StructArrayLayout8i15ui1ul4f68,
+    StructArrayLayout8i15ui1ul2f2ui64,
     StructArrayLayout1f4,
+    StructArrayLayout1ui2f12,
     StructArrayLayout1ul2ui8,
     StructArrayLayout2ui4,
     StructArrayLayout1ui2,

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_attributes.ts

@@ -100,8 +100,9 @@ export const symbolInstance = createLayout([
     {type: 'Uint16', name: 'useRuntimeCollisionCircles'},
     {type: 'Uint32', name: 'crossTileID'},
     {type: 'Float32', name: 'textBoxScale'},
-    {type: 'Float32', components: 2, name: 'textOffset'},
     {type: 'Float32', name: 'collisionCircleDiameter'},
+    {type: 'Uint16', name: 'textAnchorOffsetStartIndex'},
+    {type: 'Uint16', name: 'textAnchorOffsetEndIndex'}
 ]);
 
 export const glyphOffset = createLayout([
@@ -113,3 +114,8 @@ export const lineVertex = createLayout([
     {type: 'Int16', name: 'y'},
     {type: 'Int16', name: 'tileUnitDistanceFromAnchor'}
 ]);
+
+export const textAnchorOffset = createLayout([
+    {type: 'Uint16', name: 'textAnchor'},
+    {type: 'Float32', components: 2, name: 'textOffset'}
+]);

package/src/data/bucket/symbol_bucket.ts

@@ -13,7 +13,8 @@ import {SymbolLayoutArray,
     PlacedSymbolArray,
     SymbolInstanceArray,
     GlyphOffsetArray,
-    SymbolLineVertexArray
+    SymbolLineVertexArray,
+    TextAnchorOffsetArray
 } from '../array_types.g';
 
 import Point from '@mapbox/point-geometry';
@@ -276,6 +277,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:
@@ -332,6 +334,7 @@ export class SymbolBucket implements Bucket {
     lineVertexArray: SymbolLineVertexArray;
     features: Array<SymbolFeature>;
     symbolInstances: SymbolInstanceArray;
+    textAnchorOffsets: TextAnchorOffsetArray;
     collisionArrays: Array<CollisionArrays>;
     sortKeyRanges: Array<SortKeyRange>;
     pixelRatio: number;
@@ -411,6 +414,7 @@ export class SymbolBucket implements Bucket {
         this.glyphOffsetArray = new GlyphOffsetArray();
         this.lineVertexArray = new SymbolLineVertexArray();
         this.symbolInstances = new SymbolInstanceArray();
+        this.textAnchorOffsets = new TextAnchorOffsetArray();
     }
 
     calculateGlyphDependencies(text: string, stack: {[_: number]: boolean}, textAlongLine: boolean, allowVerticalPlacement: boolean, doesAllowVerticalWritingMode: boolean) {

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.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.
  */

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.
  */