maplibre-gl 3.3.0 → 3.4.0

package/dist/maplibre-gl.d.ts

@@ -2292,6 +2292,7 @@ export declare class Actor {
 	processTask(id: number, task: any): void;
 	remove(): void;
 }
+export type DEMEncoding = "mapbox" | "terrarium" | "custom";
 export declare class DEMData {
 	uid: string;
 	data: Uint32Array;
@@ -2299,13 +2300,15 @@ export declare class DEMData {
 	dim: number;
 	min: number;
 	max: number;
-	encoding: "mapbox" | "terrarium";
-	constructor(uid: string, data: RGBAImage, encoding: "mapbox" | "terrarium");
+	redFactor: number;
+	greenFactor: number;
+	blueFactor: number;
+	baseShift: number;
+	constructor(uid: string, data: RGBAImage, encoding: DEMEncoding, redFactor?: number, greenFactor?: number, blueFactor?: number, baseShift?: number);
 	get(x: number, y: number): number;
 	getUnpackVector(): number[];
 	_idx(x: number, y: number): number;
-	_unpackMapbox(r: number, g: number, b: number): number;
-	_unpackTerrarium(r: number, g: number, b: number): number;
+	unpack(r: number, g: number, b: number): number;
 	getPixels(): RGBAImage;
 	backfillBorder(borderTile: DEMData, dx: number, dy: number): void;
 }
@@ -5488,6 +5491,13 @@ export type StyleSwapOptions = {
 	 */
 	transformStyle?: TransformStyleFunction;
 };
+/**
+ * Specifies a layer to be added to a {@link Style}. In addition to a standard {@link LayerSpecification}
+ * or a {@link CustomLayerInterface}, a {@link LayerSpecification} with an embedded {@link SourceSpecification} can also be provided.
+ */
+export type AddLayerObject = LayerSpecification | (Omit<LayerSpecification, "source"> & {
+	source: SourceSpecification;
+}) | CustomLayerInterface;
 export declare class Style extends Evented {
 	map: Map;
 	stylesheet: StyleSpecification;
@@ -5614,7 +5624,7 @@ export declare class Style extends Evented {
 	 * @param options - Style setter options.
 	 * @returns `this`.
 	 */
-	addLayer(layerObject: LayerSpecification | CustomLayerInterface, before?: string, options?: StyleSetterOptions): this;
+	addLayer(layerObject: AddLayerObject, before?: string, options?: StyleSetterOptions): this;
 	/**
 	 * Moves a layer to a different z-position. The layer will be inserted before the layer with
 	 * ID `before`, or appended if `before` is omitted.
@@ -5637,7 +5647,7 @@ export declare class Style extends Evented {
 	 * @param id - id of the desired layer
 	 * @returns a layer, if one with the given `id` exists
 	 */
-	getLayer(id: string): StyleLayer;
+	getLayer(id: string): StyleLayer | undefined;
 	/**
 	 * checks if a specific layer is present within the style.
 	 *
@@ -9317,7 +9327,7 @@ export declare class Map extends Camera {
 	 * map.setTerrain({ source: 'terrain' });
 	 * ```
 	 */
-	setTerrain(options: TerrainSpecification): this;
+	setTerrain(options: TerrainSpecification | null): this;
 	/**
 	 * Get the terrain-options if terrain is loaded
 	 * @returns the TerrainSpecification passed to setTerrain
@@ -9326,7 +9336,7 @@ export declare class Map extends Camera {
 	 * map.getTerrain(); // { source: 'terrain' };
 	 * ```
 	 */
-	getTerrain(): TerrainSpecification;
+	getTerrain(): TerrainSpecification | null;
 	/**
 	 * Returns a Boolean indicating whether all tiles in the viewport from all sources on
 	 * the style are loaded.
@@ -9538,7 +9548,7 @@ export declare class Map extends Camera {
 	 *
 	 * @param layer - The layer to add,
 	 * conforming to either the MapLibre Style Specification's [layer definition](https://maplibre.org/maplibre-style-spec/layers) or,
-	 * less commonly, the {@link CustomLayerInterface} specification.
+	 * less commonly, the {@link CustomLayerInterface} specification. Can also be a layer definition with an embedded source definition.
 	 * The MapLibre Style Specification's layer definition is appropriate for most layers.
 	 *
 	 * @param beforeId - The ID of an existing layer to insert the new layer before,
@@ -9610,9 +9620,7 @@ export declare class Map extends Camera {
 	 * @see [Add a vector tile source](https://maplibre.org/maplibre-gl-js/docs/examples/vector-source/)
 	 * @see [Add a WMS source](https://maplibre.org/maplibre-gl-js/docs/examples/wms/)
 	 */
-	addLayer(layer: (LayerSpecification & {
-		source?: string | SourceSpecification;
-	}) | CustomLayerInterface, beforeId?: string): this;
+	addLayer(layer: AddLayerObject, beforeId?: string): this;
 	/**
 	 * Moves a layer to a different z-position.
 	 *
@@ -9656,7 +9664,7 @@ export declare class Map extends Camera {
 	 * @see [Filter symbols by toggling a list](https://maplibre.org/maplibre-gl-js/docs/examples/filter-markers/)
 	 * @see [Filter symbols by text input](https://maplibre.org/maplibre-gl-js/docs/examples/filter-markers-by-input/)
 	 */
-	getLayer(id: string): StyleLayer;
+	getLayer(id: string): StyleLayer | undefined;
 	/**
 	 * Sets the zoom extent for the specified style layer. The zoom extent includes the
 	 * [minimum zoom level](https://maplibre.org/maplibre-style-spec/layers/#minzoom)
@@ -9728,6 +9736,7 @@ export declare class Map extends Camera {
 	 * @param name - The name of the paint property to set.
 	 * @param value - The value of the paint property to set.
 	 * Must be of a type appropriate for the property, as defined in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/).
+	 * Pass `null` to unset the existing value.
 	 * @param options - Options object.
 	 * @returns `this`
 	 * @example
@@ -10668,7 +10677,7 @@ export declare class Marker extends Evented {
 	 */
 	togglePopup(): this;
 	_update: (e?: {
-		type: "move" | "moveend";
+		type: "move" | "moveend" | "terrain" | "render";
 	}) => void;
 	/**
 	 * Get the marker's offset.
@@ -11287,7 +11296,11 @@ export declare class RasterTileSource extends Evented implements Source {
 	hasTransition(): boolean;
 }
 export declare class RasterDEMTileSource extends RasterTileSource implements Source {
-	encoding: "mapbox" | "terrarium";
+	encoding: DEMEncoding;
+	redFactor?: number;
+	greenFactor?: number;
+	blueFactor?: number;
+	baseShift?: number;
 	constructor(id: string, options: RasterDEMSourceSpecification, dispatcher: Dispatcher, eventedParent: Evented);
 	loadTile(tile: Tile, callback: Callback<void>): void;
 	_getNeighboringTiles(tileID: OverscaledTileID): {};