@maptiler/sdk 3.8.0 → 3.9.0-rc.2

package/dist/src/ImageViewer/ImageViewer.d.ts

@@ -1,8 +1,10 @@
-import { DoubleClickZoomHandler, DragPanHandler, EaseToOptions, PointLike, TwoFingersTouchZoomRotateHandler, default as MapLibre } from 'maplibre-gl';
-import { FlyToOptions, MapDataEvent, MapOptions, JumpToOptions, ScrollZoomHandler, BoxZoomHandler, KeyboardHandler, CooperativeGesturesHandler } from '..';
+import { default as MaplibreGL } from 'maplibre-gl';
+import { EaseToOptions, DoubleClickZoomHandler, DragPanHandler, TwoFingersTouchZoomRotateHandler, FlyToOptions, MapOptions, JumpToOptions, ScrollZoomHandler, BoxZoomHandler, KeyboardHandler, CooperativeGesturesHandler, LngLat, MapDataEvent, PointLike } from '..';
 import { Map } from '../Map';
+import { ImageViewerFitImageToBoundsControl } from '../controls/ImageViewerFitImageToBoundsControl';
+import { lngLatToPxInternalSymbolKey, pxToLngLatInternalSymbolKey } from './symbols';
+declare const Evented: typeof MaplibreGL.Evented;
 export type AllowedConstrcutorOptions = "container" | "apiKey" | "maxZoom" | "minZoom" | "zoom" | "bearing";
-declare const Evented: typeof MapLibre.Evented;
 export type ImageViewerFlyToOptions = Omit<FlyToOptions, "pitch"> & {
     center: [number, number];
 };
@@ -64,7 +66,6 @@ export default class ImageViewer extends Evented {
     /**
      * The metadata of the image.
      *
-     * @internal
      */
     private imageMetadata?;
     /**
@@ -97,6 +98,10 @@ export default class ImageViewer extends Evented {
      * The version of the ImageViewer / SDK.
      */
     get version(): string;
+    /**
+     * The control to fit the image to the viewport.
+     */
+    fitToBoundsControlInstance: ImageViewerFitImageToBoundsControl;
     /**
      * The constructor for the ImageViewer.
      *
@@ -283,26 +288,42 @@ export default class ImageViewer extends Evented {
      * @returns {[number, number]} The px coordinate.
      */
     private pxToLngLat;
+    /**
+     * Get the internal SDK instance.
+     *
+     * @returns {Map} The internal SDK instance.
+     * @internal
+     */
+    getSDKInternal(): Map;
+    /**
+     * Get the canvas of the internal SDK instance.
+     *
+     * @returns {HTMLCanvasElement} The canvas of the internal SDK instance.
+     */
+    getCanvas(): HTMLCanvasElement;
     /**
      * Fly to a given center.
      *
      * @param {ImageViewerFlyToOptions} options - The options for the fly to.
      * @param {MapDataEvent} eventData - The event data.
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    flyTo(options: ImageViewerFlyToOptions, eventData?: MapDataEvent): Map;
+    flyTo(options: ImageViewerFlyToOptions, eventData?: MapDataEvent): this;
     /**
      * Jump to a given center.
      *
      * @param {ImageViewerJumpToOptions} options - The options for the jump to.
      * @param {MapDataEvent} eventData - The event data.
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    jumpTo(options: ImageViewerJumpToOptions, eventData?: MapDataEvent): Map;
+    jumpTo(options: ImageViewerJumpToOptions, eventData?: MapDataEvent): this;
     /**
      * Set the zoom level.
      *
      * @param {number} zoom - The zoom level.
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    setZoom(zoom: number): void;
+    setZoom(zoom: number): this;
     /**
      * Get the zoom level.
      *
@@ -320,14 +341,16 @@ export default class ImageViewer extends Evented {
      * Set the center of the ImageViewer in pixels.
      *
      * @param {number} center - The center of the ImageViewer.
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    setCenter(center: [number, number]): void;
+    setCenter(center: [number, number]): this;
     /**
      * Set the bearing of the ImageViewer in degrees.
      *
      * @param {number} bearing - The bearing of the ImageViewer.
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    setBearing(bearing: number): void;
+    setBearing(bearing: number): this;
     /**
      * Get the bearing of the ImageViewer in degrees.
      *
@@ -340,15 +363,46 @@ export default class ImageViewer extends Evented {
      * @param {PointLike} delta - The delta to pan by.
      * @param {ImageViewerEaseToOptions} options - The options for the pan.
      * @param {any} eventData - The event data.
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    panBy(delta: PointLike, options?: ImageViewerEaseToOptions, eventData?: any): void;
+    panBy(delta: PointLike, options?: ImageViewerEaseToOptions, eventData?: any): this;
     /**
      * Pan to a given center in pixels.
      *
      * @param {number} center - The center to pan to.
      * @param {ImageViewerEaseToOptions} options - The options for the pan.
      * @param {any} eventData - The event data.
+     * @returns {ImageViewer} The ImageViewer instance.
+     */
+    panTo(center: [number, number], options?: ImageViewerEaseToOptions, eventData?: any): this;
+    /**
+     * Get the image metadata.
+     *
+     * @returns {ImageMetadata} The image metadata.
+     */
+    getImageMetadata(): ImageMetadata | undefined;
+    /**
+     * Get the visible bounds of the image in the viewport in imagePixels.
+     * [topLeft, bottomRight]
+     *
+     * @returns {[[number, number], [number, number]]} The visible bounds of the image.
+     */
+    getImageBounds(): number[][];
+    /**
+     * Set the bounds of the image.
+     *
+     * @param {[[number, number], [number, number]]} bounds - The bounds of the image.
+     * @returns {ImageViewer} The ImageViewer instance.
+     */
+    fitImageBounds([tl, br]: [[number, number], [number, number]]): this;
+    /**
+     * Destroys the ImageViewer, removes the map instance and all event listeners. Useful for cleanup.
+     *
+     * @returns {ImageViewer} The ImageViewer instance.
      */
-    panTo(center: [number, number], options?: ImageViewerEaseToOptions, eventData?: any): void;
+    remove(): void;
+    pointIsWithinImageBounds(px: [number, number]): boolean;
+    [lngLatToPxInternalSymbolKey]: (lngLat: LngLat) => [number, number];
+    [pxToLngLatInternalSymbolKey]: (px: [number, number]) => LngLat;
 }
 export {};

package/dist/src/ImageViewer/ImageViewerMarker.d.ts

@@ -0,0 +1,236 @@
+import { Alignment, Subscription, MarkerOptions, PointLike, Popup } from '../index';
+import { default as MapLibreGL } from 'maplibre-gl';
+import { default as ImageViewer } from './ImageViewer';
+declare const Evented: typeof MapLibreGL.Evented;
+export type ImageViewerMarkerOptions = MarkerOptions & {};
+export interface ImageViewerMarkerInterface {
+    on(event: MarkerEventTypes, listener: (e: ImageViewerMarkerEvent) => void): Subscription;
+    off(event: MarkerEventTypes, listener: (e: ImageViewerMarkerEvent) => void): void;
+    fire(event: ImageViewerMarkerEvent): void;
+    getPosition(): [number, number];
+    getOffset(): PointLike;
+    getPitchAlignment(): Alignment;
+    getPopup(): Popup;
+    getRotation(): number;
+    getRotationAlignment(): Alignment;
+    isDraggable(): boolean;
+    remove(): void;
+    removeClassName(className: string): void;
+    setDraggable(draggable: boolean): void;
+    setPosition(px: [number, number]): void;
+    setOffset(offset: PointLike): void;
+    setOpacity(opacity?: string, opacityWhenCovered?: string): void;
+    setPitchAlignment(pitchAlignment: Alignment): void;
+    setPopup(popup: Popup): void;
+    setRotation(rotation: number): void;
+    setRotationAlignment(rotationAlignment: Alignment): void;
+    setSubpixelPositioning(subpixelPositioning: boolean): void;
+    toggleClassName(className: string): void;
+    togglePopup(): void;
+}
+export declare class ImageViewerMarker extends Evented {
+    private viewer;
+    private readonly marker;
+    private readonly position;
+    constructor({ ...markerOptions }: ImageViewerMarkerOptions);
+    /**
+     * Adds the ImageViewerMarker to an instance of ImageViewer.
+     *
+     * @param {ImageViewer} viewer - The instance of ImageViewer to add the ImageViewerMarker to.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    addTo(viewer: ImageViewer): this;
+    /**
+     * Adds a class name to the ImageViewerMarker.
+     *
+     * @param {string} className - The class name to add to the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    addClassName(className: string): this;
+    /**
+     * Gets the element of the ImageViewerMarker.
+     *
+     * @returns {HTMLElement} The element of the ImageViewerMarker.
+     */
+    getElement(): HTMLElement;
+    /**
+     * Gets the position of the ImageViewerMarker.
+     *
+     * @returns {PointLike} The position of the ImageViewerMarker.
+     * @see  [PointLike](https://docs.maptiler.com/sdk-js/api/geography/#pointlike)
+     *
+     */
+    getPosition(): [number, number];
+    /**
+     * Gets the offset of the ImageViewerMarker.
+     *
+     * @returns {PointLike} The offset of the ImageViewerMarker.
+     * @see  [PointLike](https://docs.maptiler.com/sdk-js/api/geography/#pointlike)
+     */
+    getOffset(): MapLibreGL.Point;
+    /**
+     * Gets the pitch alignment of the ImageViewerMarker.
+     *
+     * @returns {Alignment} The pitch alignment of the ImageViewerMarker.
+     * @see  [MapLibreGL.Alignment](https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/Alignment/)
+     */
+    getPitchAlignment(): Alignment;
+    /**
+     * Gets the popup of the ImageViewerMarker.
+     *
+     * @returns {Popup} The popup of the ImageViewerMarker.
+     * @see [Popup](https://docs.maptiler.com/sdk-js/api/markers/#popup)
+     */
+    getPopup(): MapLibreGL.Popup;
+    /**
+     * Gets the rotation of the ImageViewerMarker.
+     *
+     * @returns {number} The rotation of the ImageViewerMarker.
+     */
+    getRotation(): number;
+    /**
+     * Gets the rotation alignment of the ImageViewerMarker.
+     *
+     * @returns {Alignment} The rotation alignment of the ImageViewerMarker.
+     * @see  [MapLibreGL.Alignment](https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/Alignment/)
+     */
+    getRotationAlignment(): Alignment;
+    /**
+     * Checks if the ImageViewerMarker is draggable.
+     *
+     * @returns {boolean} True if the ImageViewerMarker is draggable, false otherwise.
+     */
+    isDraggable(): boolean;
+    /**
+     * Fires an event on the ImageViewerMarker.
+     *
+     * @param {MarkerEventTypes | Event} event - The event to fire.
+     * @param {Record<string, any>} data - The data to fire the event with.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    fire(event: MarkerEventTypes | Event, data?: Record<string, any>): this;
+    /**
+     * Removes an event listener from the ImageViewerMarker.
+     *
+     * @param {MarkerEventTypes} event - The event to remove the listener from.
+     * @param {ImageViewerMarkerEvent} listener - The listener to remove.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    off(event: MarkerEventTypes, listener: (e: ImageViewerMarkerEvent) => void): this;
+    /**
+     * Adds an event listener to the ImageViewerMarker.
+     *
+     * @param {MarkerEventTypes} event - The event to add the listener to.
+     * @param {ImageViewerMarkerEvent} listener - The listener to add.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    on(event: MarkerEventTypes, listener: (e: ImageViewerMarkerEvent) => void): Subscription;
+    /**
+     * Checks if the ImageViewerMarker is within the image bounds.
+     *
+     * @returns {boolean} True if the ImageViewerMarker is within the image bounds, false otherwise.
+     */
+    isWithinImageBounds(): boolean;
+    /**
+     * Removes the ImageViewerMarker from the ImageViewer and cleans up the event listeners.
+     *
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    remove(): this;
+    /**
+     * Removes a class name from the ImageViewerMarker dom element.
+     *
+     * @param {string} className - The class name to remove from the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    removeClassName(className: string): this;
+    /**
+     * Sets the draggable state of the ImageViewerMarker.
+     *
+     * @param {boolean} draggable - The draggable state of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    setDraggable(draggable: boolean): this;
+    /**
+     * Sets the position of the ImageViewerMarker.
+     *
+     * @param {[number, number]} px - The position of the ImageViewerMarker in image pixels.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    setPosition(px: [number, number]): this;
+    /**
+     * Sets the offset of the ImageViewerMarker.
+     *
+     * @param {PointLike} offset - The offset of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    setOffset(offset: PointLike): this;
+    /**
+     * Sets the opacity of the ImageViewerMarker.
+     *
+     * @param {string} opacity - The opacity of the ImageViewerMarker.
+     * @param {string} opacityWhenCovered - The opacity of the ImageViewerMarker when covered.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    setOpacity(opacity?: string, opacityWhenCovered?: string): this;
+    /**
+     * Sets the pitch alignment of the ImageViewerMarker.
+     *
+     * @param {Alignment} pitchAlignment - The pitch alignment of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     * @see  [MapLibreGL.Alignment](https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/Alignment/)
+     */
+    setPitchAlignment(pitchAlignment: Alignment): this;
+    /**
+     * Sets the popup of the ImageViewerMarker.
+     *
+     * @param {Popup} popup - The popup of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     * @see [Popup](https://docs.maptiler.com/sdk-js/api/markers/#popup)
+     */
+    setPopup(popup: Popup): this;
+    /**
+     * Sets the rotation of the ImageViewerMarker.
+     *
+     * @param {number} rotation - The rotation of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    setRotation(rotation: number): this;
+    /**
+     * Sets the rotation alignment of the ImageViewerMarker.
+     *
+     * @param {Alignment} rotationAlignment - The rotation alignment of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     * @see  [MapLibreGL.Alignment](https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/Alignment/)
+     */
+    setRotationAlignment(rotationAlignment: Alignment): this;
+    /**
+     * Sets if subpixel positioning is enabled for the ImageViewerMarker.
+     *
+     * @param {boolean} subpixelPositioning - The subpixel positioning of the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    setSubpixelPositioning(subpixelPositioning: boolean): this;
+    /**
+     * Toggles a class name on the ImageViewerMarker dom element.
+     *
+     * @param {string} className - The class name to toggle on the ImageViewerMarker.
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    toggleClassName(className: string): this;
+    /**
+     * Toggles the popup of the ImageViewerMarker.
+     *
+     * @returns {ImageViewerMarker} The ImageViewerMarker instance.
+     */
+    togglePopup(): this;
+}
+declare const MARKER_EVENT_TYPES: readonly ["dragstart", "drag", "dragend"];
+type MarkerEventTypes = (typeof MARKER_EVENT_TYPES)[number];
+export declare class ImageViewerMarkerEvent {
+    readonly type: string;
+    readonly target: ImageViewerMarker;
+    [key: string]: any;
+    constructor(type: MarkerEventTypes, marker: ImageViewerMarker, data: Record<string, any>);
+}
+export {};

package/dist/src/ImageViewer/events.d.ts

@@ -6,6 +6,9 @@ export declare class ImageViewerEvent {
     readonly target: ImageViewer;
     readonly originalEvent: MouseEvent | TouchEvent | WheelEvent | WebGLContextEvent | null;
     [key: string]: any;
+    imageX: number;
+    imageY: number;
+    isOutOfBounds: boolean;
     constructor(type: string, viewer: ImageViewer, originalEvent?: MouseEvent | TouchEvent | WheelEvent | WebGLContextEvent | null, data?: Record<string, any>);
 }
 declare const BASE_MAP_EVENT_TYPES: readonly ["idle", "render", "load", "remove", "idle"];
@@ -16,7 +19,7 @@ declare const CAMERA_EVENTS: readonly ["moveend", "movestart", "move", "zoomend"
 declare const UI_EVENTS: readonly ["click", "dblclick", "mousedown", "mouseup", "mousemove", "mouseout", "mouseover", "contextmenu", "touchstart", "touchend", "touchmove", "touchcancel"];
 declare const COOPERATIVE_GESTURE_EVENTS: readonly ["cooperativegestureprevented"];
 declare const DATA_EVENTS: readonly ["data", "dataloading", "sourcedata", "sourcedataloading", "dataabort", "sourcedataabort"];
-export declare const IMAGE_VIEWER_EVENT_TYPES: ("data" | "error" | "load" | "idle" | "remove" | "render" | "resize" | "webglcontextlost" | "webglcontextrestored" | "dataloading" | "sourcedataloading" | "sourcedata" | "dataabort" | "sourcedataabort" | "boxzoomcancel" | "boxzoomstart" | "boxzoomend" | "touchcancel" | "touchmove" | "touchend" | "touchstart" | "click" | "contextmenu" | "dblclick" | "mousemove" | "mouseup" | "mousedown" | "mouseout" | "mouseover" | "movestart" | "move" | "moveend" | "zoomstart" | "zoom" | "zoomend" | "rotatestart" | "rotate" | "rotateend" | "dragstart" | "drag" | "dragend" | "cooperativegestureprevented")[];
+export declare const IMAGE_VIEWER_EVENT_TYPES: ("error" | "load" | "idle" | "remove" | "render" | "resize" | "webglcontextlost" | "webglcontextrestored" | "dataloading" | "data" | "sourcedataloading" | "sourcedata" | "dataabort" | "sourcedataabort" | "boxzoomcancel" | "boxzoomstart" | "boxzoomend" | "touchcancel" | "touchmove" | "touchend" | "touchstart" | "click" | "contextmenu" | "dblclick" | "mousemove" | "mouseup" | "mousedown" | "mouseout" | "mouseover" | "movestart" | "move" | "moveend" | "zoomstart" | "zoom" | "zoomend" | "rotatestart" | "rotate" | "rotateend" | "dragstart" | "drag" | "dragend" | "cooperativegestureprevented")[];
 type BaseMapEventKeys = (typeof BASE_MAP_EVENT_TYPES)[number];
 type UiEventKeys = (typeof UI_EVENTS)[number];
 type CameraEventKeys = (typeof CAMERA_EVENTS)[number];
@@ -25,7 +28,7 @@ type ResizeEventKeys = (typeof RESIZE_EVENTS)[number];
 type WebglContextEventKeys = (typeof WEBGL_CONTEXT_EVENTS)[number];
 type DataEventKeys = (typeof DATA_EVENTS)[number];
 type CooperativeGestureEventKeys = (typeof COOPERATIVE_GESTURE_EVENTS)[number];
-export type ImageViewerEventTypes = BaseMapEventKeys | UiEventKeys | CameraEventKeys | ErrorEventKeys | ResizeEventKeys | WebglContextEventKeys | DataEventKeys | CooperativeGestureEventKeys | "imageviewerready" | "imagevieweriniterror";
+export type ImageViewerEventTypes = BaseMapEventKeys | UiEventKeys | CameraEventKeys | ErrorEventKeys | ResizeEventKeys | WebglContextEventKeys | DataEventKeys | CooperativeGestureEventKeys | "imageviewerready" | "imagevieweriniterror" | "beforeremove";
 type LngLatToPixel = (lngLat: LngLat) => [number, number];
 interface SetupGlobalMapEventForwarderOptions {
     map: Map;

package/dist/src/ImageViewer/index.d.ts

@@ -1,4 +1,5 @@
 export { default as ImageViewer } from './ImageViewer';
+export { ImageViewerMarker, ImageViewerMarkerEvent, type ImageViewerMarkerOptions } from './ImageViewerMarker';
 export type { ImageViewerEventTypes } from './events';
 export type { ImageViewerConstructorOptions, ImageViewerFlyToOptions, ImageViewerJumpToOptions, ImageMetadata } from './ImageViewer';
 export { ImageViewerEvent } from './events';

package/dist/src/ImageViewer/monkeyPatchML.d.ts

@@ -1,4 +1,11 @@
-import { LngLat, Point } from '../index';
+import { LngLat, Marker, Point, PositionAnchor } from '../index';
 import { Map } from '../Map';
 export declare function unprojectFromWorldCoordinates(worldSize: number, point: Point): LngLat;
 export declare function monkeyPatchMapTransformInstance(instance: Map): void;
+export declare const anchorTranslate: Record<PositionAnchor, string>;
+/**
+ * Monkey patches the Marker instance to remove wrapping. Because pixel projection does not wrap like lnglat.
+ * See here https://github.com/maplibre/maplibre-gl-js/blob/14f56b00e0f08784681ef98f0731c60f3923a4a9/src/ui/marker.ts#L601
+ * @param {Marker} marker - The Marker instance to patch.
+ */
+export declare function monkeyPatchMarkerInstanceToRemoveWrapping(marker: Marker): void;

package/dist/src/ImageViewer/symbols.d.ts

@@ -0,0 +1,2 @@
+export declare const lngLatToPxInternalSymbolKey: unique symbol;
+export declare const pxToLngLatInternalSymbolKey: unique symbol;

package/dist/src/Map.d.ts

@@ -1,4 +1,4 @@
-import { default as maplibregl, StyleSpecification, MapOptions as MapOptionsML, ControlPosition, StyleSwapOptions, StyleOptions, RequestTransformFunction, LayerSpecification, SourceSpecification, CustomLayerInterface, FilterSpecification, StyleSetterOptions } from 'maplibre-gl';
+import { default as maplibregl, StyleSpecification, MapOptions as MapOptionsML, ControlPosition, StyleSwapOptions, StyleOptions, RequestTransformFunction, LayerSpecification, SourceSpecification, CustomLayerInterface, FilterSpecification, StyleSetterOptions, ProjectionSpecification } from 'maplibre-gl';
 import { ReferenceMapStyle, MapStyleVariant } from '@maptiler/client';
 import { SdkConfig } from './config';
 import { LanguageInfo } from './language';
@@ -155,7 +155,7 @@ export declare class Map extends maplibregl.Map {
      * If an option is not set it will internally revert to the default option
      * unless explicitly set when calling.
      */
-    setSpace(space: CubemapDefinition | boolean): void;
+    setSpace(space: CubemapDefinition | boolean, updateOptions?: boolean): void;
     /**
      * Enables the animations for the space layer.
      */
@@ -439,6 +439,15 @@ export declare class Map extends maplibregl.Map {
      *  map.setTransformRequest((url: string, resourceType: string) => {});
      */
     setTransformRequest(transformRequest: RequestTransformFunction): this;
+    /**
+     * Gets the {@link ProjectionSpecification}.
+     * @returns the projection specification.
+     * @example
+     * ```ts
+     * let projection = map.getProjection();
+     * ```
+     */
+    getProjection(): ProjectionSpecification;
     /**
      * Returns whether a globe projection is currently being used
      */
@@ -451,6 +460,7 @@ export declare class Map extends maplibregl.Map {
      * Activate the mercator projection.
      */
     enableMercatorProjection(): void;
+    setProjection(projection: maplibregl.ProjectionSpecification): this;
     /**
      * Returns `true` is the language was ever updated, meaning changed
      * from what is delivered in the style.

package/dist/src/index.d.ts

@@ -1,6 +1,5 @@
 import { default as maplibregl } from 'maplibre-gl';
 export type * from 'maplibre-gl';
-export type { ColorRamp as ColorRampML } from 'maplibre-gl';
 /**
  * Get the version of MapTiler SDK, this is declared in the vite config
  * to avoid importing the entire package.json
@@ -32,7 +31,15 @@ declare const TwoFingersTouchPitchHandlerMLGL: typeof maplibregl.TwoFingersTouch
 declare const MapWheelEventMLGL: typeof maplibregl.MapWheelEvent;
 declare const MapTouchEventMLGL: typeof maplibregl.MapTouchEvent;
 declare const MapMouseEventMLGL: typeof maplibregl.MapMouseEvent;
-declare const configMLGL: maplibregl.Config;
+declare const configMLGL: {
+    MAX_PARALLEL_IMAGE_REQUESTS: number;
+    MAX_PARALLEL_IMAGE_REQUESTS_PER_FRAME: number;
+    MAX_TILE_CACHE_ZOOM_LEVELS: number;
+    REGISTERED_PROTOCOLS: {
+        [x: string]: maplibregl.AddProtocolAction;
+    };
+    WORKER_URL: string;
+};
 declare const getMapLibreVersion: typeof maplibregl.getVersion;
 declare const setRTLTextPlugin: typeof maplibregl.setRTLTextPlugin, getRTLTextPluginStatus: typeof maplibregl.getRTLTextPluginStatus, LngLat: typeof maplibregl.LngLat, LngLatBounds: typeof maplibregl.LngLatBounds, MercatorCoordinate: typeof maplibregl.MercatorCoordinate, Evented: typeof maplibregl.Evented, AJAXError: typeof maplibregl.AJAXError, prewarm: typeof maplibregl.prewarm, clearPrewarmedResources: typeof maplibregl.clearPrewarmedResources, Hash: typeof maplibregl.Hash, Point: typeof maplibregl.Point, EdgeInsets: typeof maplibregl.EdgeInsets, DragRotateHandler: typeof maplibregl.DragRotateHandler, DragPanHandler: typeof maplibregl.DragPanHandler, TwoFingersTouchZoomRotateHandler: typeof maplibregl.TwoFingersTouchZoomRotateHandler, DoubleClickZoomHandler: typeof maplibregl.DoubleClickZoomHandler, TwoFingersTouchZoomHandler: typeof maplibregl.TwoFingersTouchZoomHandler, TwoFingersTouchRotateHandler: typeof maplibregl.TwoFingersTouchRotateHandler, getWorkerCount: typeof maplibregl.getWorkerCount, setWorkerCount: typeof maplibregl.setWorkerCount, getMaxParallelImageRequests: typeof maplibregl.getMaxParallelImageRequests, setMaxParallelImageRequests: typeof maplibregl.setMaxParallelImageRequests, getWorkerUrl: typeof maplibregl.getWorkerUrl, setWorkerUrl: typeof maplibregl.setWorkerUrl, addSourceType: (name: string, SourceType: maplibregl.SourceClass) => Promise<void>, importScriptInWorkers: typeof maplibregl.importScriptInWorkers, addProtocol: typeof maplibregl.addProtocol, removeProtocol: typeof maplibregl.removeProtocol;
 export { setRTLTextPlugin, getRTLTextPluginStatus, LngLat, LngLatBounds, MercatorCoordinate, Evented, AJAXError, prewarm, clearPrewarmedResources, Hash, Point, EdgeInsets, DragRotateHandler, DragPanHandler, TwoFingersTouchZoomRotateHandler, DoubleClickZoomHandler, TwoFingersTouchZoomHandler, TwoFingersTouchRotateHandler, getWorkerCount, setWorkerCount, getMaxParallelImageRequests, setMaxParallelImageRequests, getWorkerUrl, setWorkerUrl, addSourceType, importScriptInWorkers, addProtocol, removeProtocol, getMapLibreVersion, MapMLGL, MarkerMLGL, PopupMLGL, StyleMLGL, CanvasSourceMLGL, GeoJSONSourceMLGL, ImageSourceMLGL, RasterTileSourceMLGL, RasterDEMTileSourceMLGL, VectorTileSourceMLGL, VideoSourceMLGL, NavigationControMLGL, GeolocateControlMLGL, AttributionControlMLGL, LogoControlMLGL, ScaleControlMLGL, FullscreenControlMLGL, TerrainControMLGL, BoxZoomHandlerMLGL, ScrollZoomHandlerMLGL, CooperativeGesturesHandlerMLGL, KeyboardHandlerMLGL, TwoFingersTouchPitchHandlerMLGL, MapWheelEventMLGL, MapTouchEventMLGL, MapMouseEventMLGL, configMLGL, };

package/dist/src/mapstyle.d.ts

@@ -13,5 +13,5 @@ type StyleValidationReport = {
     isValidStyle: boolean;
     styleObject: maplibregl.StyleSpecification | null;
 };
-export declare function convertToStyleSpecificationString(str: string): StyleValidationReport;
+export declare function convertStringToStyleSpecification(str: string): StyleValidationReport;
 export {};

package/dist/src/tools.d.ts

@@ -1,6 +1,6 @@
 import { default as maplibregl, RequestParameters, ResourceType, RequestTransformFunction } from 'maplibre-gl';
 import { Map as MapSDK } from './Map';
-export declare function enableRTL(): void;
+export declare function enableRTL(customPluginURL?: string): Promise<void>;
 export declare function bindAll(fns: Array<string>, context: any): void;
 /**
  * This function is meant to be used as transformRequest by any Map instance created.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maptiler/sdk",
-  "version": "3.8.0",
+  "version": "3.9.0-rc.2",
   "description": "The Javascript & TypeScript map SDK tailored for MapTiler Cloud",
   "author": "MapTiler",
   "module": "dist/maptiler-sdk.mjs",
@@ -86,12 +86,12 @@
     "vitest": "^3.0.9"
   },
   "dependencies": {
-    "@maplibre/maplibre-gl-style-spec": "~23.3.0",
-    "@maptiler/client": "~2.5.1",
+    "@maplibre/maplibre-gl-style-spec": "~24.2.0",
+    "@maptiler/client": "2.6.0-rc.3",
     "events": "^3.3.0",
     "gl-matrix": "^3.4.3",
     "js-base64": "^3.7.7",
-    "maplibre-gl": "~5.6.0",
+    "maplibre-gl": "~5.9.0",
     "uuid": "^11.0.5"
   }
 }