feat!: camera composition instead of inheritance (#7800)

* Use classes for all the events.

* Update changelog

* Fix comments.

* Update bundle size

* More event changes

* Update changelog

* Make evented generic to allow spcifying the event types.

* Improve imports, make evented abstract.

* Remove string from event registration.

* Remvoe dead event code.

* Fix render test typecheck.

* Fix docs generation

* Refactor: Map composes Camera instead of extending it

Major architectural change moving from inheritance to composition:
- Map now extends Evented<MapEventType> instead of Camera
- Map has a _camera property containing a Camera instance
- Camera is now a concrete class (was abstract)
- All camera-related state moved to Camera class
- Handlers initialized on Camera instance
- TransformProvider now receives Camera directly
- Dependency injection for handlers in handler constructors

This reduces coupling between Map and Camera while maintaining the same
public API. Camera is now a more self-contained component.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Fix: pass allowGestures parameter in Camera.stop()

The public stop() method was accepting the allowGestures parameter but not
passing it to _stop(), causing handlers to be reset when they shouldn't be.
This caused dragend and other end events to fire prematurely.

Fixes: 41 test failures in drag_pan, drag_rotate, and other handlers.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Restore CHANGELOG.md with complete version history

The composition refactoring commit accidentally wiped most of the CHANGELOG
content. Restored all versions from 6.0.0-7 onwards and updated the main
section with notes about the composition refactoring and Camera.stop() fix.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Update CHANGELOG with camera composition refactoring details

Added Camera composition feature note and Camera.stop() bugfix to main section.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Update chagelog

* Remove unwanted getters and setters.

* More changes to file to reduce decopling.

* Remove reference to camera in draw method.

* Update bundle size.

* Improve test.

* Improve public API and reduce breaking changes.

* Fix lint

* Fix changelog

* Update comments to avoid showing transform in the docs.

* Fix out-of-date comment

* Remove transform getter.

* Move getMatrixForModel into the example code.

* Remove the `getTerrain` callback.

* TransformProvider only needs the camera now.

* Fix lint, update changelog

---------

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

Author: HarelM

CHANGELOG.md

@@ -1,5 +1,6 @@
 ## main
 ### ✨ Features and improvements
+- ⚠️ `Map` now composes a `Camera` instead of extending it (`Map` extends `Evented` directly and forwards the camera API). The internal `map.transform` was removed — use map's public API instead or open a PR if you need something that's not exposed. Removed the internal `transform.getMatrixForModel` helper ([#7800](https://github.com/maplibre/maplibre-gl-js/pull/7800)) (by [@HarelM](https://github.com/HarelM))
 - _...Add new stuff here..._
 
 ### 🐞 Bug fixes

src/geo/projection/globe_transform.ts

@@ -448,10 +448,6 @@ export class GlobeTransform implements ITransform {
         return this._verticalPerspectiveTransform.getRayDirectionFromPixel(p);
     }
 
-    getMatrixForModel(location: LngLatLike, altitude?: number): mat4 {
-        return this.currentTransform.getMatrixForModel(location, altitude);
-    }
-
     getProjectionDataForCustomLayer(applyGlobeMatrix: boolean = true): CustomLayerProjectionData {
         const mercatorData = this._mercatorTransform.getProjectionDataForCustomLayer(applyGlobeMatrix);
 

src/geo/projection/mercator_transform.ts

@@ -1,7 +1,7 @@
 import {LngLat, type LngLatLike} from '../lng_lat.ts';
 import {MercatorCoordinate, mercatorXfromLng, mercatorYfromLat, mercatorZfromAltitude} from '../mercator_coordinate.ts';
 import Point from '@mapbox/point-geometry';
-import {wrap, clamp, createIdentityMat4f64, createMat4f64, degreesToRadians, createIdentityMat4f32, zoomScale, scaleZoom, type Mat4f32, type Mat4f64} from '../../util/util.ts';
+import {wrap, clamp, createMat4f64, degreesToRadians, createIdentityMat4f32, zoomScale, scaleZoom, type Mat4f32, type Mat4f64} from '../../util/util.ts';
 import {type mat2, mat4, vec3, vec4} from 'gl-matrix';
 import {UnwrappedTileID, OverscaledTileID, type CanonicalTileID, calculateTileKey} from '../../tile/tile_id.ts';
 import {interpolates} from '@maplibre/maplibre-gl-style-spec';
@@ -801,21 +801,6 @@ export class MercatorTransform implements ITransform {
         }
     }
 
-    getMatrixForModel(location: LngLatLike, altitude?: number): mat4 {
-        const modelAsMercatorCoordinate = MercatorCoordinate.fromLngLat(
-            location,
-            altitude
-        );
-        const scale = modelAsMercatorCoordinate.meterInMercatorCoordinateUnits();
-
-        const m = createIdentityMat4f64();
-        mat4.translate(m, m, [modelAsMercatorCoordinate.x, modelAsMercatorCoordinate.y, modelAsMercatorCoordinate.z]);
-        mat4.rotateZ(m, m, Math.PI);
-        mat4.rotateX(m, m, Math.PI / 2);
-        mat4.scale(m, m, [-scale, scale, scale]);
-        return m;
-    }
-
     getProjectionDataForCustomLayer(applyGlobeMatrix: boolean = true): CustomLayerProjectionData {
         const tileID = new OverscaledTileID(0, 0, 0, 0, 0);
         const rendererProjectionData = this.getProjectionData({overscaledTileID: tileID, applyGlobeMatrix});

src/geo/projection/vertical_perspective_transform.ts

@@ -978,19 +978,6 @@ export class VerticalPerspectiveTransform implements ITransform {
         return sphereSurfacePointToCoordinates(closestOnHorizon);
     }
 
-    getMatrixForModel(location: LngLatLike, altitude?: number): mat4 {
-        const lnglat = LngLat.convert(location);
-        const scale = 1.0 / earthRadius;
-
-        const m = createIdentityMat4f64();
-        mat4.rotateY(m, m, lnglat.lng / 180.0 * Math.PI);
-        mat4.rotateX(m, m, -lnglat.lat / 180.0 * Math.PI);
-        mat4.translate(m, m, [0, 0, 1 + altitude / earthRadius]);
-        mat4.rotateX(m, m, Math.PI * 0.5);
-        mat4.scale(m, m, [scale, scale, scale]);
-        return m;
-    }
-
     getProjectionDataForCustomLayer(applyGlobeMatrix: boolean = true): CustomLayerProjectionData {
         const globeData = this.getProjectionData({overscaledTileID: new OverscaledTileID(0, 0, 0, 0, 0), applyGlobeMatrix});
         globeData.tileMercatorCoords = [0, 0, 1, 1];

src/geo/transform_interface.ts

@@ -493,15 +493,6 @@ export interface IReadonlyTransform extends ITransformGetters {
      */
     projectTileCoordinates(x: number, y: number, unwrappedTileID: UnwrappedTileID, getElevation: (x: number, y: number) => number): PointProjection;
 
-    /**
-     * Returns a matrix that will place, rotate and scale a model to display at the given location and altitude
-     * while also being projected by the custom layer matrix.
-     * This function is intended to be called from custom layers.
-     * @param location - Location of the model.
-     * @param altitude - Altitude of the model. May be undefined.
-     */
-    getMatrixForModel(location: LngLatLike, altitude?: number): mat4;
-
     /**
      * Return projection data such that coordinates in mercator projection in range 0..1 will get projected to the map correctly.
      */

src/style/style.ts

@@ -1764,7 +1764,7 @@ export class Style extends Evented<MapEventType> {
     }
 
     _setProjectionInternal(name: ProjectionSpecification['type']): void {
-        const projectionObjects = createProjectionFromName(name, this.map.transformConstrain);
+        const projectionObjects = createProjectionFromName(name, this.map._camera?.transform.constrainOverride);
         this.projection = projectionObjects.projection;
         this.map.migrateProjection(projectionObjects.transform, projectionObjects.cameraHelper);
         for (const key in this.tileManagers) {

src/style/style_layer/custom_style_layer.ts

@@ -130,7 +130,7 @@ export type CustomRenderMethodInput = {
      * For more details of this object's internals, see its doc comments in `src/geo/projection/projection_data.ts`.
      *
      * These uniforms are set so that `projectTile` in shader accepts a vec2 in range 0..1 in web mercator coordinates.
-     * Use `map.transform.getProjectionData({overscaledTileID: tileID})` to get uniforms for a given tile and pass vec2 in tile-local range 0..EXTENT instead.
+     * Use `getProjectionData({overscaledTileID: tileID})` to get uniforms for a given tile and pass vec2 in tile-local range 0..EXTENT instead.
      *
      * For projection 3D features, use `projectTileFor3D` in the shader.
      *