@maptiler/sdk 3.7.0 → 3.8.0-rc.9

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

@@ -0,0 +1,354 @@
+import { DoubleClickZoomHandler, DragPanHandler, EaseToOptions, PointLike, TwoFingersTouchZoomRotateHandler, default as MapLibre } from 'maplibre-gl';
+import { FlyToOptions, MapDataEvent, MapOptions, JumpToOptions, ScrollZoomHandler, BoxZoomHandler, KeyboardHandler, CooperativeGesturesHandler } from '..';
+import { Map } from '../Map';
+export type AllowedConstrcutorOptions = "container" | "apiKey" | "maxZoom" | "minZoom" | "zoom" | "bearing";
+declare const Evented: typeof MapLibre.Evented;
+export type ImageViewerFlyToOptions = Omit<FlyToOptions, "pitch"> & {
+    center: [number, number];
+};
+export type ImageViewerJumpToOptions = Omit<JumpToOptions, "pitch"> & {
+    center: [number, number];
+};
+export type ImageViewerEaseToOptions = Omit<EaseToOptions, "pitch"> & {
+    center: [number, number];
+};
+export type ImageViewerConstructorOptions = Pick<MapOptions, AllowedConstrcutorOptions> & {
+    /**
+     * The UUID of the image.
+     */
+    imageUUID: string;
+    /**
+     * Whether to show debug information.
+     */
+    debug?: boolean;
+    /**
+     * The center of the image.
+     */
+    center?: [number, number];
+    /**
+     * Whether to show a control to fit the image to the viewport.
+     */
+    fitToBoundsControl?: boolean;
+    /**
+     * Whether to show a navigation control.
+     */
+    navigationControl?: boolean;
+};
+/**
+ * The metadata of the image. This is the shape of the response from the API.
+ * And used to convert px to lnglat and vice versa.
+ */
+export type ImageMetadata = {
+    id: string;
+    description: string;
+    attribution: string;
+    width: number;
+    height: number;
+    minzoom: number;
+    maxzoom: number;
+    tileSize: number;
+};
+export default class ImageViewer extends Evented {
+    /**
+     * The UUID of the image.
+     *
+     * @internal
+     */
+    private imageUUID;
+    /**
+     * Whether to enable debug mode.
+     *
+     * @internal
+     */
+    private debug;
+    /**
+     * The metadata of the image.
+     *
+     * @internal
+     */
+    private imageMetadata?;
+    /**
+     * Why not extend the Map class?
+     * Because ImageViewer technically operates in screen space and not in map space.
+     * We wrap map and perform calculations in screen space.
+     * We do not want to have to extend the Map class and give access to
+     * methods and properties that operate in LngLat space.   *
+     */
+    private sdk;
+    /**
+     * The options for the ImageViewer.
+     *
+     * @internal
+     */
+    private options;
+    /**
+     * The size of the image.
+     *
+     * @internal
+     */
+    private imageSize?;
+    /**
+     * The padded size max.
+     *
+     * @internal
+     */
+    private paddedSizeMax?;
+    /**
+     * The version of the ImageViewer / SDK.
+     */
+    get version(): string;
+    /**
+     * The constructor for the ImageViewer.
+     *
+     * @param {Partial<ImageViewerConstructorOptions>} imageViewerConstructorOptions - The options for the ImageViewer.
+     * @example
+     * ```ts
+     * import "@maptiler/sdk/dist/maptiler-sdk.css"; // import css
+     * import { ImageViewer } from "@maptiler/sdk"; // import the sdk
+     *
+     * const imageViewer = new ImageViewer({
+     *   container: document.getElementById("map"),
+     *   imageUUID: "01986025-ceb9-7487-9ea6-7a8637dcc1a1",
+     *   debug: true, // show tile boundaries, padding, collision boxes etc
+     *   fitToBoundsControl: true, // show a control to fit the image to the viewport
+     *   navigationControl: true, // show a navigation control
+     *   center: [0, 0], // center in pixels
+     *   zoom: 1, // zoom level
+     *   bearing: 0, // bearing
+     * });
+     * ```
+     */
+    constructor(imageViewerConstructorOptions: Partial<ImageViewerConstructorOptions>);
+    /**
+     * Waits for the ImageViewer to be ready.
+     *
+     * @returns {Promise<void>}
+     */
+    onReadyAsync(): Promise<void>;
+    shouldFitImageToViewport: boolean;
+    /**
+     * Initializes the ImageViewer
+     *  - fetches the image metadata
+     *  - adds the image source to the sdk instance
+     *  - sets the center to the middle of the image (if center is not provided)
+     *  - monkeypatches the maplibre-gl sdk transform method to allow for overpanning and underzooming.
+     *  - sets up global event forwarding / intercepting from the map instance
+     *  - sets the center to the middle of the image (if center is not provided)
+     *
+     * @internal
+     * @returns {Promise<void>}
+     */
+    private init;
+    /**
+     * Fits the image to the viewport.
+     *
+     * @param {Object} options - The options for the fit image to viewport.
+     * @param {boolean} options.ease - Whether to ease to the viewport bounds.
+     */
+    fitImageToViewport({ ease }?: {
+        ease?: boolean;
+    }): void;
+    /**
+     * Fetches the image metadata from the API.
+     *
+     * @internal
+     * @returns {Promise<void>}
+     */
+    private fetchImageMetadata;
+    /**
+     * Adds the image source to the sdk instance.
+     *
+     * @internal
+     * @returns {void}
+     */
+    private addImageSource;
+    /**
+     * Triggers a repaint of the ImageViewer. Same as map.triggerRepaint().
+     *
+     * @internal
+     * @returns {void}
+     */
+    triggerRepaint(): void;
+    /**
+     * The scroll zoom handler.
+     *
+     * @internal
+     * @returns {ScrollZoomHandler}
+     */
+    get scrollZoom(): ScrollZoomHandler;
+    /**
+     * The scroll zoom handler.
+     *
+     * @internal
+     * @param {ScrollZoomHandler} value - The scroll zoom handler.
+     */
+    set scrollZoom(value: ScrollZoomHandler);
+    /**
+     * The box zoom handler.
+     *
+     * @internal
+     * @returns {BoxZoomHandler}
+     */
+    get boxZoom(): BoxZoomHandler;
+    /**
+     * The box zoom handler.
+     *
+     * @internal
+     * @param {BoxZoomHandler} value - The box zoom handler.
+     */
+    set boxZoom(value: BoxZoomHandler);
+    /**
+     * The drag pan handler.
+     *
+     * @internal
+     * @returns {DragPanHandler}
+     */
+    get dragPan(): DragPanHandler;
+    /**
+     * The drag pan handler.
+     *
+     * @internal
+     * @param {DragPanHandler} value - The drag pan handler.
+     */
+    set dragPan(value: DragPanHandler);
+    /**
+     * The keyboard handler.
+     *
+     * @internal
+     * @returns {KeyboardHandler}
+     */
+    get keyboard(): KeyboardHandler;
+    /**
+     * The keyboard handler.
+     *
+     * @internal
+     * @param {KeyboardHandler} value - The keyboard handler.
+     */
+    set keyboard(value: KeyboardHandler);
+    /**
+     * The double click zoom handler.
+     *
+     * @internal
+     * @returns {DoubleClickZoomHandler}
+     */
+    get doubleClickZoom(): DoubleClickZoomHandler;
+    /**
+     * The double click zoom handler.
+     *
+     * @internal
+     * @param {DoubleClickZoomHandler} value - The double click zoom handler.
+     */
+    set doubleClickZoom(value: DoubleClickZoomHandler);
+    /**
+     * The touch zoom rotate handler.
+     *
+     * @internal
+     * @returns {TwoFingersTouchZoomRotateHandler}
+     */
+    get touchZoomRotate(): TwoFingersTouchZoomRotateHandler;
+    /**
+     * The touch zoom rotate handler.
+     *
+     * @internal
+     * @param {TwoFingersTouchZoomRotateHandler} value - The touch zoom rotate handler.
+     */
+    set touchZoomRotate(value: TwoFingersTouchZoomRotateHandler);
+    /**
+     * The cooperative gestures handler.
+     *
+     * @internal
+     * @returns {CooperativeGesturesHandler}
+     */
+    get cooperativeGestures(): CooperativeGesturesHandler;
+    /**
+     * The cooperative gestures handler.
+     *
+     * @internal
+     * @param {CooperativeGesturesHandler} value - The cooperative gestures handler.
+     */
+    set cooperativeGestures(value: CooperativeGesturesHandler);
+    /**
+     * Converts a LngLat to a px coordinate, based on the image metadata.
+     *
+     * @internal
+     * @param {LngLat} lngLat - The LngLat to convert.
+     * @returns {[number, number]} The px coordinate.
+     */
+    private lngLatToPx;
+    /**
+     * Converts a px coordinate to a LngLat, based on the image metadata.
+     *
+     * @internal
+     * @param {LngLat} lngLat - The LngLat to convert.
+     * @returns {[number, number]} The px coordinate.
+     */
+    private pxToLngLat;
+    /**
+     * Fly to a given center.
+     *
+     * @param {ImageViewerFlyToOptions} options - The options for the fly to.
+     * @param {MapDataEvent} eventData - The event data.
+     */
+    flyTo(options: ImageViewerFlyToOptions, eventData?: MapDataEvent): Map;
+    /**
+     * Jump to a given center.
+     *
+     * @param {ImageViewerJumpToOptions} options - The options for the jump to.
+     * @param {MapDataEvent} eventData - The event data.
+     */
+    jumpTo(options: ImageViewerJumpToOptions, eventData?: MapDataEvent): Map;
+    /**
+     * Set the zoom level.
+     *
+     * @param {number} zoom - The zoom level.
+     */
+    setZoom(zoom: number): void;
+    /**
+     * Get the zoom level.
+     *
+     * @returns {number} The zoom level.
+     */
+    getZoom(): number;
+    /**
+     * Get the center of the ImageViewer in pixels.
+     *
+     * @internal
+     * @returns {[number, number]} The center of the ImageViewer.
+     */
+    getCenter(): [number, number];
+    /**
+     * Set the center of the ImageViewer in pixels.
+     *
+     * @param {number} center - The center of the ImageViewer.
+     */
+    setCenter(center: [number, number]): void;
+    /**
+     * Set the bearing of the ImageViewer in degrees.
+     *
+     * @param {number} bearing - The bearing of the ImageViewer.
+     */
+    setBearing(bearing: number): void;
+    /**
+     * Get the bearing of the ImageViewer in degrees.
+     *
+     * @returns {number} The bearing of the ImageViewer.
+     */
+    getBearing(): number;
+    /**
+     * Pan by a given delta in pixels.
+     *
+     * @param {PointLike} delta - The delta to pan by.
+     * @param {ImageViewerEaseToOptions} options - The options for the pan.
+     * @param {any} eventData - The event data.
+     */
+    panBy(delta: PointLike, options?: ImageViewerEaseToOptions, eventData?: any): void;
+    /**
+     * 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.
+     */
+    panTo(center: [number, number], options?: ImageViewerEaseToOptions, eventData?: any): void;
+}
+export {};

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

@@ -0,0 +1,44 @@
+import { Map } from '../Map';
+import { default as ImageViewer } from './ImageViewer';
+import { LngLat } from 'maplibre-gl';
+export declare class ImageViewerEvent {
+    readonly type: string;
+    readonly target: ImageViewer;
+    readonly originalEvent: MouseEvent | TouchEvent | WheelEvent | WebGLContextEvent | null;
+    [key: string]: any;
+    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"];
+declare const ERROR_EVENTS: readonly ["error"];
+declare const RESIZE_EVENTS: readonly ["resize"];
+declare const WEBGL_CONTEXT_EVENTS: readonly ["webglcontextlost", "webglcontextrestored"];
+declare const CAMERA_EVENTS: readonly ["moveend", "movestart", "move", "zoomend", "zoomstart", "zoom", "rotatestart", "rotateend", "rotate", "dragstart", "dragend", "drag", "boxzoomcancel", "boxzoomend", "boxzoomstart"];
+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")[];
+type BaseMapEventKeys = (typeof BASE_MAP_EVENT_TYPES)[number];
+type UiEventKeys = (typeof UI_EVENTS)[number];
+type CameraEventKeys = (typeof CAMERA_EVENTS)[number];
+type ErrorEventKeys = (typeof ERROR_EVENTS)[number];
+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";
+type LngLatToPixel = (lngLat: LngLat) => [number, number];
+interface SetupGlobalMapEventForwarderOptions {
+    map: Map;
+    viewer: ImageViewer;
+    lngLatToPx: LngLatToPixel;
+}
+/**
+ * Sets up event forwarding from Map to ImageViewer with proper categorization
+ * @param {SetupGlobalMapEventForwarderOptions} options - The options for setting up the event forwarder.
+ * @param {Map} options.map - The map to forward events from.
+ * @param {ImageViewer} options.viewer - The viewer to forward events to.
+ * @param {LngLatToPixel} options.lngLatToPx - A function to convert LngLat to pixel coordinates.
+ * @returns {void}
+ */
+export declare function setupGlobalMapEventForwarder({ map, viewer, lngLatToPx }: SetupGlobalMapEventForwarderOptions): void;
+export {};

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

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

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

@@ -0,0 +1,4 @@
+import { LngLat, Point } from '../index';
+import { Map } from '../Map';
+export declare function unprojectFromWorldCoordinates(worldSize: number, point: Point): LngLat;
+export declare function monkeyPatchMapTransformInstance(instance: Map): void;

package/dist/src/Map.d.ts

@@ -90,6 +90,10 @@ export type MapOptions = Omit<MapOptionsML, "style" | "maplibreLogo"> & {
      * Show the full screen control. (default: `false`, will show if `true`)
      */
     fullscreenControl?: boolean | ControlPosition;
+    /**
+     * Detect custom external controls. (default: `false`, will detect automatically if `true`)
+     */
+    customControls?: boolean | string;
     /**
      * Display a minimap in a user defined corner of the map. (default: `bottom-left` corner)
      * If set to true, the map will assume it is a minimap and forego the attribution control.
@@ -151,7 +155,33 @@ 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): void;
+    setSpace(space: CubemapDefinition | boolean): void;
+    /**
+     * Enables the animations for the space layer.
+     */
+    enableSpaceAnimations(): void;
+    /**
+     * Disables the animations for the space layer.
+     */
+    disableSpaceAnimations(): void;
+    /**
+     * Enables the animations for the halo layer.
+     */
+    enableHaloAnimations(): void;
+    /**
+     * Disables the animations for the halo layer.
+     */
+    disableHaloAnimations(): void;
+    /**
+     * Sets whether the halo layer should be animated in and out.
+     * @param active - Whether the animation should be active.
+     */
+    setHaloAnimationActive(active: boolean): void;
+    /**
+     * Sets whether the space layer should be animated in and out.
+     * @param active - Whether the animation should be active.
+     */
+    setSpaceAnimationActive(active: boolean): void;
     private setSpaceFromStyle;
     private setHaloFromStyle;
     private initSpace;

package/dist/src/Telemetry.d.ts

@@ -5,6 +5,7 @@ import { Map as MapSDK } from './Map';
 export declare class Telemetry {
     private map;
     private registeredModules;
+    private viewerType;
     /**
      *
      * @param map : a Map instance
@@ -17,5 +18,6 @@ export declare class Telemetry {
      * of each module.
      */
     registerModule(name: string, version: string): void;
+    registerViewerType(viewerType?: string): void;
     private preparePayload;
 }

package/dist/src/controls/ImageViewerFitImageToBoundsControl.d.ts

@@ -0,0 +1,13 @@
+import { IControl } from 'maplibre-gl';
+import { ImageViewer } from '../ImageViewer';
+import { Map as MapSDK } from '../Map';
+export declare class ImageViewerFitImageToBoundsControl implements IControl {
+    private viewer;
+    private container;
+    constructor({ imageViewer }: {
+        imageViewer: ImageViewer;
+    });
+    handleClick: () => void;
+    onAdd(_map: MapSDK): HTMLElement;
+    onRemove(): void;
+}

package/dist/src/controls/MaptilerCustomControl.d.ts

@@ -0,0 +1,17 @@
+import { Map as SDKMap } from '../Map';
+import { IControl, MapLibreEvent } from 'maplibre-gl';
+export type MaptilerCustomControlCallback<E> = (map: SDKMap, element: HTMLElement, event: E) => void;
+/**
+ * The MaptilerCustomControl allows any existing element to become a map control.
+ */
+export declare class MaptilerCustomControl implements IControl {
+    #private;
+    /**
+     * @param selectorOrElement Element to be used as control, specified as either reference to element itself or a CSS selector to find the element in DOM
+     * @param onClick Function called when the element is clicked
+     * @param onRender Function called every time the underlying map renders a new state
+     */
+    constructor(selectorOrElement: string | HTMLElement, onClick?: MaptilerCustomControlCallback<Event>, onRender?: MaptilerCustomControlCallback<MapLibreEvent>);
+    onAdd(map: SDKMap): HTMLElement;
+    onRemove(): void;
+}

package/dist/src/controls/MaptilerExternalControl.d.ts

@@ -0,0 +1,25 @@
+import { Map as SDKMap } from '../Map';
+import { IControl } from 'maplibre-gl';
+import { MaptilerCustomControl, MaptilerCustomControlCallback } from './MaptilerCustomControl';
+export type MaptilerExternalControlType = "zoom-in" | "zoom-out" | "toggle-projection" | "toggle-terrain" | "reset-view" | "reset-bearing" | "reset-pitch" | "reset-roll";
+/**
+ * The MaptilerExternalControl allows any existing element to automatically become a map control. Used for detected controls if `customControls` config is turned on.
+ */
+export declare class MaptilerExternalControl extends MaptilerCustomControl implements IControl {
+    #private;
+    static controlCallbacks: Record<MaptilerExternalControlType, MaptilerCustomControlCallback<Event>>;
+    /**
+     * Constructs an instance of External Control to have a predefined functionality
+     * @param controlElement Element to be used as control, specified as reference to element itself
+     * @param controlType One of the predefined types of functionality
+     */
+    constructor(controlElement: HTMLElement, controlType?: MaptilerExternalControlType);
+    onAdd(map: SDKMap): HTMLElement;
+    onRemove(): void;
+    /**
+     * Configure a child element to be part of this control and to have a predefined functionality added
+     * @param controlElement Element that is a descendant of the control element and that optionally should have some functionality
+     * @param controlType One of the predefined types of functionality
+     */
+    configureGroupItem(controlElement: HTMLElement, controlType: MaptilerExternalControlType | undefined): void;
+}

package/dist/src/controls/MaptilerProjectionControl.d.ts

@@ -12,3 +12,4 @@ export declare class MaptilerProjectionControl implements IControl {
     private toggleProjection;
     private updateProjectionIcon;
 }
+export declare function toggleProjection(map: SDKMap): void;

package/dist/src/controls/MaptilerTerrainControl.d.ts

@@ -14,3 +14,4 @@ export declare class MaptilerTerrainControl implements IControl {
     _toggleTerrain(): void;
     _updateTerrainIcon(): void;
 }
+export declare function toggleTerrain(map: SDKMap): void;

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

@@ -1,3 +1,5 @@
+export * from './MaptilerCustomControl';
+export * from './MaptilerExternalControl';
 export * from './MaptilerGeolocateControl';
 export * from './MaptilerLogoControl';
 export * from './MaptilerTerrainControl';

package/dist/src/custom-layers/CubemapLayer/CubemapLayer.d.ts

@@ -96,6 +96,7 @@ declare class CubemapLayer implements CustomLayerInterface {
      * @private
      */
     private options;
+    private animationActive;
     /**
      * Creates a new instance of CubemapLayer
      *
@@ -186,6 +187,7 @@ declare class CubemapLayer implements CustomLayerInterface {
      * @private
      */
     private animateOut;
+    setAnimationActive(active: boolean): void;
     /**
      * Renders the cubemap layer to the WebGL context.
      * This method is called internally during the rendering phase of the map.
@@ -214,7 +216,7 @@ declare class CubemapLayer implements CustomLayerInterface {
      * and if so, it updates the cubemap faces.
      * Finally, it calls `updateCubemap` to apply the changes and trigger a repaint of the map.
      */
-    setCubemap(cubemap: CubemapDefinition): Promise<void>;
+    setCubemap(spec: CubemapDefinition | boolean): Promise<void>;
     /**
      * Shows the cubemap layer by setting its visibility to "visible".
      * This method is used to make the cubemap layer visible on the map.
@@ -226,5 +228,5 @@ declare class CubemapLayer implements CustomLayerInterface {
      */
     hide(): void;
 }
-export declare function validateSpaceSpecification(space: CubemapDefinition | boolean): boolean;
+export declare function validateSpaceSpecification(space?: CubemapDefinition | boolean): boolean;
 export { CubemapLayer };

package/dist/src/custom-layers/RadialGradientLayer/RadialGradientLayer.d.ts

@@ -67,6 +67,12 @@ export declare class RadialGradientLayer implements CustomLayerInterface {
      * @type {Object3D<(typeof ATTRIBUTES_KEYS)[number], (typeof UNIFORMS_KEYS)[number]>}
      */
     private plane?;
+    /**
+     * Whether the halo should be animated in and out.
+     * @private
+     * @type {boolean}
+     */
+    private animationActive;
     /**
      * Creates a new RadialGradientLayer instance.
      *
@@ -128,7 +134,8 @@ export declare class RadialGradientLayer implements CustomLayerInterface {
      * @param {GradientDefinition} gradient - The new gradient definition to set for this layer.
      * @returns {Promise<void>} A promise that resolves when the new gradient is set and animated in.
      */
-    setGradient(gradient: GradientDefinition): Promise<void>;
+    setGradient(gradient: GradientDefinition | boolean): Promise<void>;
+    setAnimationActive(active: boolean): void;
     show(): void;
     hide(): void;
 }

package/dist/src/index.d.ts

@@ -78,6 +78,7 @@ export { MapMouseEvent } from './MLAdapters/MapMouseEvent';
 export { Map, GeolocationType, type MapOptions, type LoadWithTerrainEvent } from './Map';
 export * from './controls';
 export { type AutomaticStaticMapOptions, type BoundedStaticMapOptions, type BufferToPixelDataFunction, type ByIdGeocodingOptions, type CenteredStaticMapOptions, type CommonForwardAndReverseGeocodingOptions, type CoordinateExport, type CoordinateGrid, type CoordinateId, type CoordinateSearch, type CoordinateSearchResult, type CoordinateTransformResult, type CoordinateTransformation, type Coordinates, type CoordinatesSearchOptions, type CoordinatesTransformOptions, type DefaultTransformation, type ElevationAtOptions, type ElevationBatchOptions, type FeatureHierarchy, type FetchFunction, type GeocodingFeature, type GeocodingOptions, type GeocodingSearchResult, type GeolocationInfoOptions, type GeolocationResult, type GetDataOptions, type LanguageGeocodingOptions, MapStyle, type MapStylePreset, type MapStyleType, MapStyleVariant, type PixelData, ReferenceMapStyle, type ReverseGeocodingOptions, ServiceError, type StaticMapBaseOptions, type StaticMapMarker, type TileJSON, type XYZ, bufferToPixelDataBrowser, circumferenceAtLatitude, coordinates, data, elevation, expandMapStyle, geocoding, geolocation, getBufferToPixelDataParser, getTileCache, mapStylePresetList, math, misc, staticMaps, styleToStyle, type LanguageInfo, areSameLanguages, toLanguageInfo, isLanguageInfo, getAutoLanguage, getLanguageInfoFromFlag, getLanguageInfoFromCode, getLanguageInfoFromKey, canParsePixelData, } from '@maptiler/client';
+export * from './ImageViewer';
 export { getWebGLSupportError, displayWebGLContextLostWarning } from './tools';
 export { config, SdkConfig } from './config';
 export * from './language';

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class FetchError extends Error {
+    status: number;
+    statusText: string;
+    constructor(response: Response, resource: string, module: string);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maptiler/sdk",
-  "version": "3.7.0",
+  "version": "3.8.0-rc.9",
   "description": "The Javascript & TypeScript map SDK tailored for MapTiler Cloud",
   "author": "MapTiler",
   "module": "dist/maptiler-sdk.mjs",
@@ -86,11 +86,14 @@
     "vitest": "^3.0.9"
   },
   "dependencies": {
+    "@koa/cors": "^5.0.0",
+    "@koa/router": "^13.1.1",
     "@maplibre/maplibre-gl-style-spec": "~23.3.0",
-    "@maptiler/client": "~2.5.0",
+    "@maptiler/client": "~2.5.1",
     "events": "^3.3.0",
     "gl-matrix": "^3.4.3",
     "js-base64": "^3.7.7",
+    "koa": "^3.0.0",
     "maplibre-gl": "~5.6.0",
     "uuid": "^11.0.5"
   }

package/vitest-setup-tests.ts

@@ -1,4 +1,3 @@
 import ImageData from "@canvas/image-data";
-
 // @ts-expect-error: Global type missing
 global.ImageData = ImageData;