maplibre-gl 3.3.0 → 3.3.1

package/dist/maplibre-gl.d.ts

@@ -5488,6 +5488,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 +5621,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 +5644,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 +9324,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 +9333,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 +9545,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 +9617,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 +9661,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)