@maptiler/sdk 3.2.0-rc.1 → 3.3.0-rc2

package/dist/src/MLAdapters/ScaleControl.d.ts

@@ -1,8 +1,5 @@
 import { default as maplibregl, Map as MapMLGL } from 'maplibre-gl';
 import { Map as SDKMap } from '../Map';
-/**
- * @deprecated Please use MaptilerScaleControl from '@maptiler/sdk' instead.
- */
 export declare class ScaleControl extends maplibregl.ScaleControl {
     onAdd(map: SDKMap | MapMLGL): HTMLElement;
 }

package/dist/src/Map.d.ts

@@ -2,8 +2,10 @@ import { default as maplibregl, StyleSpecification, MapOptions as MapOptionsML,
 import { ReferenceMapStyle, MapStyleVariant } from '@maptiler/client';
 import { SdkConfig } from './config';
 import { LanguageInfo } from './language';
-import { MinimapOptionsInput } from './Minimap';
+import { MinimapOptionsInput } from './controls/Minimap';
 import { Telemetry } from './Telemetry';
+import { CubemapDefinition, CubemapLayer, CubemapLayerConstructorOptions } from './custom-layers/CubemapLayer';
+import { GradientDefinition, RadialGradientLayer, RadialGradientLayerOptions } from './custom-layers/RadialGradientLayer';
 export type LoadWithTerrainEvent = {
     type: "loadWithTerrain";
     target: Map;
@@ -126,18 +128,29 @@ export type MapOptions = Omit<MapOptionsML, "style" | "maplibreLogo"> & {
      */
     projection?: ProjectionTypes;
     /**
-     * Enable or disable all default controls. When false, no default controls will be added.
-     * Individual controls can still be added manually using addControl().
-     * @default true
+     * Turn on/off spacebox.
+     *
+     * Default: { color: "#1D29F1" }
      */
-    defaultControls?: boolean;
+    space?: CubemapLayerConstructorOptions | boolean;
+    halo?: RadialGradientLayerOptions | boolean;
 };
 /**
  * The Map class can be instanciated to display a map in a `<div>`
  */
 export declare class Map extends maplibregl.Map {
-    private options;
     readonly telemetry: Telemetry;
+    private space?;
+    private halo?;
+    getSpace(): CubemapLayer | undefined;
+    setSpace(space: CubemapDefinition): void;
+    private setSpaceFromCurrentStyle;
+    private setHaloFromCurrentStyle;
+    private initSpace;
+    private initHalo;
+    getHalo(): RadialGradientLayer | undefined;
+    setHalo(halo: GradientDefinition): void;
+    private options;
     private isTerrainEnabled;
     private terrainExaggeration;
     private primaryLanguage;
@@ -155,7 +168,6 @@ export declare class Map extends maplibregl.Map {
     private isStyleLocalized;
     private languageIsUpdated;
     constructor(options: MapOptions);
-    private checkControlsConfiguration;
     /**
      * Recreates the map instance with the same options.
      * Useful for WebGL context loss.

package/dist/src/config.d.ts

@@ -1,7 +1,7 @@
 import { default as EventEmitter } from 'events';
 import { LanguageInfo } from './language';
 import { FetchFunction } from '@maptiler/client';
-import { Unit } from './unit';
+import { Unit } from './types';
 export declare const MAPTILER_SESSION_ID: string;
 /**
  * Configuration class for the SDK

package/dist/src/{MaptilerGeolocateControl.d.ts → controls/MaptilerGeolocateControl.d.ts}

@@ -1,10 +1,4 @@
-import { GeolocateControlOptions, Map as MapMLGL } from 'maplibre-gl';
-import { GeolocateControl } from './MLAdapters/GeolocateControl';
-import { Map as SDKMap } from './Map';
-type MaptilerGeolocateControlOptions = GeolocateControlOptions & {
-    geolocateElement?: HTMLElement;
-    removeDefaultDOM?: boolean;
-};
+import { GeolocateControl } from '../MLAdapters/GeolocateControl';
 /**
  * The MaptilerGeolocateControl is an extension of the original GeolocateControl
  * with a few changes. In this version, the active mode persists as long as the
@@ -13,10 +7,6 @@ type MaptilerGeolocateControlOptions = GeolocateControlOptions & {
  */
 export declare class MaptilerGeolocateControl extends GeolocateControl {
     private lastUpdatedCenter;
-    private removeDefaultDOM;
-    private externalGeolocateElement?;
-    constructor(options?: MaptilerGeolocateControlOptions);
-    onAdd(map: SDKMap | MapMLGL): HTMLElement;
     /**
      * Update the camera location to center on the current position
      *
@@ -29,4 +19,3 @@ export declare class MaptilerGeolocateControl extends GeolocateControl {
     _onZoom: () => void;
     _setErrorState(): void;
 }
-export {};

package/dist/src/{MaptilerLogoControl.d.ts → controls/MaptilerLogoControl.d.ts}

@@ -1,10 +1,9 @@
 import { LogoControlOptions as LogoControlOptionsML } from 'maplibre-gl';
-import { LogoControl } from './MLAdapters/LogoControl';
-import { Map as SDKMap } from './Map';
+import { LogoControl } from '../MLAdapters/LogoControl';
+import { Map as SDKMap } from '../Map';
 type LogoControlOptions = LogoControlOptionsML & {
     logoURL?: string;
     linkURL?: string;
-    defaultControlsEnabled?: boolean;
 };
 /**
  * This LogoControl extends the MapLibre LogoControl but instead can use any image URL and
@@ -14,10 +13,7 @@ export declare class MaptilerLogoControl extends LogoControl {
     _compact: boolean;
     private logoURL;
     private linkURL;
-    private defaultControlsEnabled;
     constructor(options?: LogoControlOptions);
     onAdd(map: SDKMap): HTMLElement;
-    _createAnchor(): HTMLAnchorElement;
-    _externalControlsEnabled(): void;
 }
 export {};

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

@@ -0,0 +1,17 @@
+import { NavigationControlOptions } from 'maplibre-gl';
+import { NavigationControl } from '../MLAdapters/NavigationControl';
+type HTMLButtonElementPlus = HTMLButtonElement & {
+    clickFunction: (e?: Event) => unknown;
+};
+export declare class MaptilerNavigationControl extends NavigationControl {
+    constructor(options?: NavigationControlOptions);
+    /**
+     * Overloading: the button now stores its click callback so that we can later on delete it and replace it
+     */
+    _createButton(className: string, fn: (e?: Event) => unknown): HTMLButtonElementPlus;
+    /**
+     * Overloading: Limit how flat the compass icon can get
+     */
+    _rotateCompassArrow: () => void;
+}
+export {};

package/dist/src/{MaptilerProjectionControl.d.ts → controls/MaptilerProjectionControl.d.ts}

@@ -1,9 +1,5 @@
-import { Map as SDKMap } from './Map';
+import { Map as SDKMap } from '../Map';
 import { IControl } from 'maplibre-gl';
-type MaptilerProjectionControlOptions = {
-    removeDefaultDOM?: boolean;
-    projectionElement?: HTMLElement;
-};
 /**
  * A `MaptilerProjectionControl` control adds a button to switch from Mercator to Globe projection.
  */
@@ -11,14 +7,8 @@ export declare class MaptilerProjectionControl implements IControl {
     map: SDKMap;
     container: HTMLElement;
     projectionButton: HTMLButtonElement;
-    private externalProjection?;
-    private options;
-    constructor(options?: MaptilerProjectionControlOptions);
     onAdd(map: SDKMap): HTMLElement;
     onRemove(): void;
-    private setupExternalElements;
     private toggleProjection;
-    private updateExternalTitle;
     private updateProjectionIcon;
 }
-export {};

package/dist/src/{MaptilerTerrainControl.d.ts → controls/MaptilerTerrainControl.d.ts}

@@ -1,25 +1,16 @@
-import { Map as SDKMap } from './Map';
+import { Map as SDKMap } from '../Map';
 import { IControl } from 'maplibre-gl';
 /**
  * A `MaptilerTerrainControl` control adds a button to turn terrain on and off
  * by triggering the terrain logic that is already deployed in the Map object.
  */
-type MaptilerTerrainControlOptions = {
-    removeDefaultDOM?: boolean;
-    terrainElement?: HTMLElement;
-};
 export declare class MaptilerTerrainControl implements IControl {
     _map: SDKMap;
     _container: HTMLElement;
     _terrainButton: HTMLButtonElement;
-    private externalTerrain?;
-    private options;
-    constructor(options?: MaptilerTerrainControlOptions);
+    constructor();
     onAdd(map: SDKMap): HTMLElement;
-    private setupInternalElements;
-    private setupExternalElements;
     onRemove(): void;
-    _toggleTerrain: () => void;
-    _updateTerrainIcon: () => void;
+    _toggleTerrain(): void;
+    _updateTerrainIcon(): void;
 }
-export {};

package/dist/src/{Minimap.d.ts → controls/Minimap.d.ts}

@@ -1,4 +1,4 @@
-import { Map as SDKMap, MapOptions } from './Map';
+import { Map as SDKMap, MapOptions } from '../Map';
 import { ControlPosition, CustomLayerInterface, FillLayerSpecification, FilterSpecification, IControl, LayerSpecification, LineLayerSpecification, SourceSpecification, StyleOptions, StyleSetterOptions, StyleSpecification, StyleSwapOptions } from 'maplibre-gl';
 import { MapStyleVariant, ReferenceMapStyle } from '@maptiler/client';
 export interface ParentRect {

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

@@ -0,0 +1,6 @@
+export * from './MaptilerGeolocateControl';
+export * from './MaptilerLogoControl';
+export * from './MaptilerTerrainControl';
+export * from './MaptilerNavigationControl';
+export * from './MaptilerProjectionControl';
+export * from './Minimap';

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

@@ -0,0 +1,29 @@
+import { CustomLayerInterface, CustomRenderMethodInput } from 'maplibre-gl';
+import { Map as MapSDK } from '../../Map';
+import { WebGLContext } from '../../utils/webgl-utils';
+import { CubemapDefinition, CubemapLayerConstructorOptions } from './types';
+declare class CubemapLayer implements CustomLayerInterface {
+    id: string;
+    type: CustomLayerInterface["type"];
+    renderingMode: CustomLayerInterface["renderingMode"];
+    private map;
+    private faces?;
+    private useCubemapTexture;
+    private currentFadeOpacity;
+    private cubeMapNeedsUpdate;
+    private bgColor;
+    private gl;
+    private cubemap?;
+    private texture?;
+    constructor(cubemapConfig: CubemapLayerConstructorOptions | true);
+    updateCubemap(): void;
+    onAdd(map: MapSDK, gl: WebGLRenderingContext | WebGL2RenderingContext): void;
+    onRemove(_map: MapSDK, gl: WebGLRenderingContext | WebGL2RenderingContext): void;
+    prerender(gl: WebGLContext, _options: CustomRenderMethodInput): void;
+    private animateIn;
+    render(gl: WebGLRenderingContext | WebGL2RenderingContext, _options: CustomRenderMethodInput): void;
+    setCubemap(cubemap: CubemapDefinition): void;
+    show(): void;
+    hide(): void;
+}
+export { CubemapLayer };

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

@@ -0,0 +1,3 @@
+declare const VERTICES: number[];
+declare const INDICES: number[];
+export { VERTICES, INDICES };

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

@@ -0,0 +1,2 @@
+export * from './CubemapLayer';
+export * from './types';

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

@@ -0,0 +1,6 @@
+import { CubemapFaces } from './types';
+export declare function loadCubemapTexture({ gl, faces, onLoadedCallback }: {
+    gl: WebGLRenderingContext | WebGL2RenderingContext;
+    faces?: CubemapFaces;
+    onLoadedCallback?: () => void;
+}): WebGLTexture | undefined;

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

@@ -0,0 +1,37 @@
+export declare enum CubemapImagesPresets {
+    UNIVERSE_DARK = "universe-dark"
+}
+export type CubemapLayerConstructorOptions = CubemapDefinition & {};
+export type CubemapDefinition = {
+    path: {
+        baseUrl: string;
+        format?: "png" | "jpg" | "webp";
+    };
+    faces?: never;
+    preset?: never;
+    color?: string;
+} | {
+    faces: CubemapFaces;
+    path?: never;
+    preset?: never;
+    color?: string;
+} | {
+    preset: string;
+    path?: never;
+    faces?: never;
+    color?: string;
+} | {
+    color: string;
+    path?: never;
+    faces?: never;
+    preset?: never;
+};
+export declare enum CubemapFaceNames {
+    POSITIVE_X = "pX",
+    NEGATIVE_X = "nX",
+    POSITIVE_Y = "pY",
+    NEGATIVE_Y = "nY",
+    POSITIVE_Z = "pZ",
+    NEGATIVE_Z = "nZ"
+}
+export type CubemapFaces = Record<CubemapFaceNames, string>;

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

@@ -0,0 +1,23 @@
+import { CustomLayerInterface, CustomRenderMethodInput } from 'maplibre-gl';
+import { Map as MapSDK } from '../../Map';
+import { GradientDefinition, RadialGradientLayerOptions } from './types';
+export declare class RadialGradientLayer implements CustomLayerInterface {
+    id: string;
+    type: CustomLayerInterface["type"];
+    renderingMode: CustomLayerInterface["renderingMode"];
+    private gradient;
+    private scale;
+    private map;
+    private plane?;
+    constructor(gradient: RadialGradientLayerOptions | boolean);
+    onAdd(map: MapSDK, gl: WebGLRenderingContext | WebGL2RenderingContext): void;
+    onRemove(_map: MapSDK, gl: WebGLRenderingContext | WebGL2RenderingContext): void;
+    prerender(_gl: WebGLRenderingContext | WebGL2RenderingContext, _options: CustomRenderMethodInput): void;
+    render(gl: WebGLRenderingContext | WebGL2RenderingContext, options: CustomRenderMethodInput): void;
+    /**
+     * Value settings methods
+     */
+    setGradient(gradient: GradientDefinition): void;
+    show(): void;
+    hide(): void;
+}

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

@@ -0,0 +1,2 @@
+export * from './RadialGradientLayer';
+export * from './types';

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

@@ -0,0 +1,11 @@
+import { Object3D } from '../../utils/webgl-utils';
+export type Color = string;
+export type GradientStop = number;
+export type RadialGradientLayerOptions = GradientDefinition;
+export type GradientDefinition = {
+    stops: Array<[GradientStop, Color]>;
+    scale: number;
+};
+export type GradientAttributeKey = "vertexPosition";
+export type GradientUniformKey = "stopsNumber" | "stops" | "colors";
+export type GradientPlaneObject3D = Pick<Object3D<GradientAttributeKey, GradientUniformKey>, "shaderProgram" | "programInfo" | "positionBuffer">;

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

@@ -0,0 +1,17 @@
+import { Map as MapSDK } from '../Map';
+import { StyleSpecification } from 'maplibre-gl';
+import { CubemapLayerConstructorOptions, RadialGradientLayerOptions } from 'custom-layers';
+export type StyleSpecificationWithMetaData = StyleSpecification & {
+    metadata?: {
+        "maptiler:copyright": string;
+        maptiler?: {
+            halo: RadialGradientLayerOptions;
+            space: CubemapLayerConstructorOptions;
+        };
+    };
+};
+export interface IExtractCustomLayerStyleOptions {
+    map: MapSDK;
+    property: "halo" | "space";
+}
+export default function extractCustomLayerStyle<T extends CubemapLayerConstructorOptions | RadialGradientLayerOptions | null>(options: IExtractCustomLayerStyleOptions): T | null;

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

@@ -0,0 +1,5 @@
+import { RadialGradientLayer } from './RadialGradientLayer';
+import { CubemapLayer } from './CubemapLayer';
+export { RadialGradientLayer, CubemapLayer };
+export * from './RadialGradientLayer/types';
+export * from './CubemapLayer/types';

package/dist/src/helpers/stylehelper.d.ts

@@ -1,5 +1,5 @@
 import { DataDrivenPropertyValueSpecification, ExpressionSpecification } from 'maplibre-gl';
-import { ColorRamp } from '../colorramp';
+import { ColorRamp } from '../ColorRamp';
 import { DataDrivenStyle, PropertyValues, ZoomNumberValues, ZoomStringValues } from './vectorlayerhelpers';
 export type ColorPalette = [string, string, string, string];
 export declare const colorPalettes: Array<ColorPalette>;

package/dist/src/helpers/vectorlayerhelpers.d.ts

@@ -1,6 +1,6 @@
 import { FeatureCollection } from 'geojson';
 import { Map as SDKMap } from '../Map';
-import { ColorRamp } from '../colorramp';
+import { ColorRamp } from '../ColorRamp';
 /**
  * Array of string values that depend on zoom level
  */

package/dist/src/index.d.ts

@@ -1,7 +1,8 @@
 import { default as maplibregl } from 'maplibre-gl';
 export type * from 'maplibre-gl';
 /**
- * Get the version of MapTiler SDK
+ * Get the version of MapTiler SDK, this is declared in the vite config
+ * to avoid importing the entire package.json
  */
 export declare function getVersion(): string;
 declare const MapMLGL: typeof maplibregl.Map;
@@ -73,19 +74,14 @@ export { TwoFingersTouchPitchHandler } from './MLAdapters/TwoFingersTouchPitchHa
 export { MapWheelEvent } from './MLAdapters/MapWheelEvent';
 export { MapTouchEvent } from './MLAdapters/MapTouchEvent';
 export { MapMouseEvent } from './MLAdapters/MapMouseEvent';
-export { Map, GeolocationType, type MapOptions, type LoadWithTerrainEvent, } from './Map';
-export * from './MaptilerGeolocateControl';
-export * from './MaptilerLogoControl';
-export * from './MaptilerTerrainControl';
-export * from './MaptilerNavigationControl';
-export * from './MaptilerProjectionControl';
-export * from './MaptilerScaleControl';
+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, } from '@maptiler/client';
 export { getWebGLSupportError, displayWebGLContextLostWarning } from './tools';
 export { config, SdkConfig } from './config';
 export * from './language';
-export type { Unit } from './unit';
-export * from './Minimap';
+export type { Unit } from './types';
 export * from './converters';
-export * from './colorramp';
-export * from './helpers';
+export * as helpers from './helpers';
+export * from './ColorRamp';
+export * from './utils';

package/dist/src/tools.d.ts

@@ -2,8 +2,6 @@ import { default as maplibregl, RequestParameters, ResourceType, RequestTransfor
 import { Map as MapSDK } from './Map';
 export declare function enableRTL(): void;
 export declare function bindAll(fns: Array<string>, context: any): void;
-export declare function DOMcreate<K extends keyof HTMLElementTagNameMap>(tagName: K, className?: string, container?: HTMLElement): HTMLElementTagNameMap[K];
-export declare function DOMRemove(node: HTMLElement): void;
 /**
  * This function is meant to be used as transformRequest by any Map instance created.
  * It adds the session ID as well as the MapTiler Cloud key from the config to all the requests

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

@@ -0,0 +1,2 @@
+export declare function DOMcreate<K extends keyof HTMLElementTagNameMap>(tagName: K, className?: string, container?: HTMLElement): HTMLElementTagNameMap[K];
+export declare function DOMremove(node: HTMLElement): void;

package/dist/src/utils/geo-utils.d.ts

@@ -0,0 +1,6 @@
+import { LngLat } from 'maplibre-gl';
+declare function getAntipode(lngLat: LngLat): {
+    lat: number;
+    lng: number;
+};
+export { getAntipode };

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

@@ -0,0 +1 @@
+export * from './dom';

package/dist/src/utils/math-utils.d.ts

@@ -0,0 +1,4 @@
+declare function minMax(value: number, min: number, max: number): number;
+declare function normalize(value: number, min: number, max: number): number;
+declare function diagonalOfSquare(side: number): number;
+export { minMax, normalize, diagonalOfSquare };

package/dist/src/utils/webgl-utils.d.ts

@@ -0,0 +1,49 @@
+export type WebGLContext = WebGLRenderingContext | WebGL2RenderingContext;
+/**
+ * Load a shader from a source string
+ */
+export declare function loadShader({ gl, type, source }: {
+    gl: WebGLContext;
+    type: GLenum;
+    source: string;
+}): WebGLShader;
+/**
+ * Create a set of shaders (vertex and fragment) and link them into a program
+ *
+ * @param gl WebGL context
+ * @param vertexShaderSource Vertex shader source code
+ * @param fragmentShaderSource Fragment shader source code
+ *
+ * @returns WebGL program
+ */
+export declare function createShadersSetProgram({ gl, vertexShaderSource, fragmentShaderSource }: {
+    gl: WebGLContext;
+    vertexShaderSource: string;
+    fragmentShaderSource: string;
+}): WebGLProgram;
+/**
+ * null-free version of getUniformLocation
+ */
+export declare function getUniformLocation(gl: WebGLRenderingContext | WebGL2RenderingContext, program: WebGLProgram, name: string): WebGLUniformLocation;
+export type Object3D<Attribute extends string, Uniform extends string> = {
+    shaderProgram: WebGLProgram;
+    programInfo: {
+        attributesLocations: Record<Attribute, number>;
+        uniformsLocations: Record<Uniform, WebGLUniformLocation>;
+    };
+    positionBuffer: WebGLBuffer;
+    indexBuffer?: WebGLBuffer;
+    indexBufferLength?: number;
+};
+export declare function createObject3D<Attribute extends string, Uniform extends string>({ gl, vertexShaderSource, fragmentShaderSource, attributesKeys, uniformsKeys, vertices, indices, }: {
+    gl: WebGLContext;
+    vertexShaderSource: string;
+    fragmentShaderSource: string;
+    attributesKeys: readonly Attribute[];
+    uniformsKeys: readonly Uniform[];
+    vertices: Array<number>;
+    indices?: Array<number>;
+}): Object3D<Attribute, Uniform>;
+export type Vec4 = [number, number, number, number];
+export declare function parseColorStringToVec4(color?: string): Vec4;
+export declare function degreesToRadians(degrees: number): number;

package/dist/vite.config-test.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;

package/dist/vitest-setup-tests.d.ts

@@ -0,0 +1 @@
+export {};

package/eslint.config.mjs

@@ -27,6 +27,7 @@ export default tseslint.config(
       "@typescript-eslint/no-base-to-string": "warn",
       "@typescript-eslint/no-confusing-void-expression": "warn",
       "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-empty-function": "warn", // this is to satisfy maplibre-gl custom layer interface
       "@typescript-eslint/no-floating-promises": "warn",
       "@typescript-eslint/no-inferrable-types": "off",
       "@typescript-eslint/no-misused-promises": "warn",
@@ -34,7 +35,7 @@ export default tseslint.config(
       "@typescript-eslint/no-unnecessary-condition": "warn",
       "@typescript-eslint/no-unnecessary-type-arguments": "off",
       "@typescript-eslint/no-unnecessary-type-assertion": "off",
-      "@typescript-eslint/no-unnecessary-type-parameters": "warn",
+      "@typescript-eslint/no-unnecessary-type-parameters": "off", // as we are a lib, types serve as documentation
       "@typescript-eslint/no-unused-vars": "warn",
       "@typescript-eslint/no-unsafe-argument": "warn",
       "@typescript-eslint/no-unsafe-assignment": "warn",

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@maptiler/sdk",
-  "version": "3.2.0-rc.1",
+  "version": "3.3.0-rc2",
   "description": "The Javascript & TypeScript map SDK tailored for MapTiler Cloud",
   "author": "MapTiler",
   "module": "dist/maptiler-sdk.mjs",
   "types": "dist/maptiler-sdk.d.ts",
   "style": "dist/maptiler-sdk.css",
   "type": "module",
+  "main": "dist/maptiler-sdk.mjs",
   "exports": {
     ".": {
       "import": "./dist/maptiler-sdk.mjs",
@@ -38,9 +39,10 @@
     "prepare": "husky",
     "doc": "rm -rf docs/* && typedoc --out docs && cp -r images docs/",
     "ncu": "npx npm-check-updates",
-    "lint": "npx eslint src",
-    "lint:fix": "npx eslint src --fix",
-    "test": "vitest run -c vite.config-test.ts",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test:watch": "vitest watch -c vite.config-test.ts --dom",
+    "test": "vitest run -c vite.config-test.ts --dom",
     "install:clean": "rm -rf build/ dist/ node_modules/ && npm ci",
     "dev": "concurrently \"vite -c vite.config-dev.ts\" \"npm run dev-umd\"",
     "dev-umd": "npm run build-css && tsc && NODE_ENV=development vite build -w -c vite.config-umd.ts",
@@ -53,15 +55,23 @@
   "lint-staged": {
     "*.ts": "npm run lint:fix"
   },
+  "ts-typecheck": {
+    "*.ts": "npm tsc --noEmit"
+  },
   "devDependencies": {
+    "@canvas/image-data": "^1.0.0",
     "@eslint/js": "^9.21.0",
+    "@types/color-convert": "^2.0.4",
+    "@types/color-name": "^2.0.0",
     "@types/uuid": "^10.0.0",
     "@types/xmldom": "^0.1.31",
+    "@vitest/web-worker": "^3.0.9",
     "@xmldom/xmldom": "^0.8.10",
     "concurrently": "^9.1.2",
     "eslint": "^9.21.0",
     "eslint-config-prettier": "^10.0.2",
     "eslint-plugin-prettier": "^5.2.3",
+    "happy-dom": "^17.4.4",
     "husky": "^8.0.0",
     "lint-staged": "^15.4.3",
     "prettier": "3.5.2",
@@ -70,12 +80,13 @@
     "typescript-eslint": "^8.25.0",
     "vite": "^6.0.7",
     "vite-plugin-dts": "^4.5.0",
-    "vitest": "^2.1.8"
+    "vitest": "^3.0.9"
   },
   "dependencies": {
     "@maplibre/maplibre-gl-style-spec": "^23.0.0",
-    "@maptiler/client": "^2.2.0",
+    "@maptiler/client": "^2.3.0",
     "events": "^3.3.0",
+    "gl-matrix": "^3.4.3",
     "js-base64": "^3.7.7",
     "maplibre-gl": "^5.0.1",
     "uuid": "^11.0.5"

package/tsconfig.json

@@ -26,6 +26,9 @@
   },
   "include": [
     "src",
-    "./eslint.config.mjs"
+    "./eslint.config.mjs",
+    "test",
+    "./vite.config-test.ts",
+    "./vitest-setup-tests.ts"
   ],
 }

package/vite.config-dev.ts

@@ -1,9 +1,13 @@
 import { defineConfig } from "vitest/config";
+import packagejson from "./package.json";
 
 export default defineConfig({
   server: {
     port: 3000,
   },
+  define: {
+    __MT_SDK_VERSION__: JSON.stringify(packagejson.version),
+  },
   plugins: [
     {
       name: 'url-override',

package/vite.config-es.ts

@@ -1,6 +1,7 @@
 import { resolve } from 'path';
 import { defineConfig } from 'vite';
 import dts from 'vite-plugin-dts';
+import packagejson from "./package.json";
 
 const isProduction = process.env.NODE_ENV === "production";
 
@@ -43,6 +44,9 @@ export default defineConfig({
         globals: {},
       },
     },
+  },
+    define: {
+    __MT_SDK_VERSION__: JSON.stringify(packagejson.version),
   },
   plugins,
 })