@maptiler/sdk 3.11.1 → 4.0.0-rc.1

package/dist/src/Map.d.ts

@@ -482,16 +482,6 @@ export declare class Map extends maplibregl.Map {
      * Returns whether a globe projection is currently being used
      */
     isGlobeProjection(): boolean;
-    /**
-     * Activate the globe projection and persist this change during future style changes.
-     * @deprecated Will be removed in v4.0.0. Use `map.setProjection("globe", { persist: true })` instead.
-     */
-    enableGlobeProjection(): void;
-    /**
-     * Activate the mercator projection and persist this change during future style changes.
-     * @deprecated Will be removed in v4.0.0. Use `map.setProjection("mercator", { persist: true })` instead.
-     */
-    enableMercatorProjection(): void;
     /**
      * Sets the projection to one of {@linkcode ProjectionTypes}.
      * @param projection - the projection type to set

package/dist/src/config.d.ts

@@ -19,9 +19,9 @@ declare class SdkConfig extends EventEmitter {
     /**
      * Setting on whether of not the SDK runs with a session logic.
      * A "session" is started at the initialization of the SDK and finished when the browser
-     * page is being refreshed.
+     * page is being closed or refreshed.
      * When `session` is enabled (default: true), the extra URL param `mtsid` is added to queries
-     * on the MapTiler Cloud API. This allows MapTiler to enable "session based billing".
+     * to the MapTiler Cloud API. This allows MapTiler to enable "session based billing".
      */
     session: boolean;
     /**

package/dist/src/geocoding.d.ts

@@ -0,0 +1,25 @@
+import * as client from "@maptiler/client";
+export type ExtraGeocodingOptions = {
+    /**
+     * Specifies whether the geocoding request runs with a session logic.
+     * A "session" is started at the initialization of the SDK and finished when the browser
+     * page is being closed or refreshed.
+     * When this option is enabled, extra URL param `mtsid` is added to queries
+     * to the MapTiler Cloud API. This allows MapTiler to enable "session based billing".
+     *
+     * Default: value of this option in global config (which is `true` by default).
+     */
+    session?: boolean;
+};
+export type LanguageGeocodingOptions = client.LanguageGeocodingOptions;
+export type BaseGeocodingOptions = client.BaseGeocodingOptions & ExtraGeocodingOptions;
+export type CommonForwardAndReverseGeocodingOptions = client.CommonForwardAndReverseGeocodingOptions & ExtraGeocodingOptions;
+export type GeocodingOptions = client.GeocodingOptions & ExtraGeocodingOptions;
+export type ReverseGeocodingOptions = client.ReverseGeocodingOptions & ExtraGeocodingOptions;
+export type ByIdGeocodingOptions = client.ByIdGeocodingOptions & ExtraGeocodingOptions;
+export declare const geocoding: {
+    forward: (query: string, options?: GeocodingOptions) => Promise<client.GeocodingSearchResult>;
+    reverse: (position: client.Position, options?: ReverseGeocodingOptions) => Promise<client.GeocodingSearchResult>;
+    byId: (id: string, options?: ByIdGeocodingOptions) => Promise<client.GeocodingSearchResult>;
+    batch: (queries: string[], options?: GeocodingOptions) => Promise<client.GeocodingSearchResult[]>;
+};

package/dist/src/index.d.ts

@@ -84,8 +84,9 @@ export { MapTouchEvent } from './MLAdapters/MapTouchEvent';
 export { MapMouseEvent } from './MLAdapters/MapMouseEvent';
 export * from './ml-types';
 export { Map, GeolocationType, type MapOptions, type LoadWithTerrainEvent } from './Map';
+export { type BaseGeocodingOptions, type ByIdGeocodingOptions, type CommonForwardAndReverseGeocodingOptions, type GeocodingOptions, type LanguageGeocodingOptions, type ReverseGeocodingOptions, geocoding, } from './geocoding';
 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 { type AutomaticStaticMapOptions, type BoundedStaticMapOptions, type BufferToPixelDataFunction, type CenteredStaticMapOptions, 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 GeocodingSearchResult, type GeolocationInfoOptions, type GeolocationResult, type GetDataOptions, MapStyle, type MapStylePreset, type MapStyleType, MapStyleVariant, type PixelData, ReferenceMapStyle, ServiceError, type StaticMapBaseOptions, type StaticMapMarker, type TileJSON, type XYZ, bufferToPixelDataBrowser, circumferenceAtLatitude, coordinates, data, elevation, expandMapStyle, 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';

package/dist/src/tools.d.ts

@@ -66,6 +66,7 @@ export declare function checkNamePattern(str: string, localized: boolean): {
  * Replaces the occurences of {name:xx} in a string by a provided object-expression to return a concat object expression
  */
 export declare function replaceLanguage(origLang: string, newLang: maplibregl.ExpressionSpecification, localized: boolean): maplibregl.ExpressionSpecification;
+export declare function addFormatElevationExpressionFromString(expression: maplibregl.ExpressionSpecification | string): maplibregl.ExpressionSpecification | string;
 /**
  * Find languages used in string label definition.
  * The returned array contains languages such as "en", "fr" but

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maptiler/sdk",
-  "version": "3.11.1",
+  "version": "4.0.0-rc.1",
   "description": "The Javascript & TypeScript map SDK tailored for MapTiler Cloud",
   "author": "MapTiler",
   "module": "dist/maptiler-sdk.mjs",
@@ -98,7 +98,7 @@
   },
   "dependencies": {
     "@maplibre/maplibre-gl-style-spec": "~24.4.1",
-    "@maptiler/client": "~2.6.0 || ~2.7.0",
+    "@maptiler/client": "^3.0.0-rc.1",
     "eslint-plugin-compat": "^6.1.0",
     "events": "^3.3.0",
     "gl-matrix": "^3.4.4",