@maptiler/sdk 5.0.0-beta.m-r.1 → 5.0.0-beta.m-r.2

package/dist/Map.d.ts

@@ -2,6 +2,7 @@ import { Map as MapMLGL, StyleSpecification, MapOptions as MapOptionsML, Control
 import { ReferenceMapStyle, MapStyleVariant } from '@maptiler/client';
 import { SdkConfig } from './config';
 import { LanguageInfo } from './language';
+import { AdaptiveColorSet } from './adaptive-colors';
 import { MinimapOptionsInput } from './controls/Minimap';
 import { PreloadTilesForBoundsOptions, PreloadTilesForCameraPositionsOptions, PreloadTilesOptions, WithTilePreload } from './tile-preloading/types';
 import { Telemetry } from './Telemetry';
@@ -406,6 +407,18 @@ export declare class Map extends MapMLGL {
      * doesn't follow the MapTiler Cloud `/maps/<id>/style.json` shape.
      */
     getStyleId(): string | undefined;
+    /**
+     * Returns the default (adaptive) colours for the current style — the colours
+     * markers fall back to when none are set. Resolved from {@link getStyleId},
+     * or the stylesheet's `id` when that's `undefined`; unknown styles resolve to
+     * the `base` colours.
+     * @returns The current style's colour set. The object is frozen and shared, so spread it to modify a copy.
+     * @example
+     * ```ts
+     * const { innerColor, outerColor } = map.getAdaptiveColorsForCurrentStyle();
+     * ```
+     */
+    getAdaptiveColorsForCurrentStyle(): AdaptiveColorSet;
     /**
      * Adds a [MapLibre style layer](https://maplibre.org/maplibre-style-spec/layers)
      * to the map's style.

package/dist/Marker/Marker.d.ts

@@ -1,6 +1,6 @@
 import { Marker as MLMarker, CustomLayerProjectionData, LngLatLike, PointLike, Subscription } from 'maplibre-gl';
 import { Map as SDKMap } from '../Map';
-import { MapTilerMarkerElementOptions, MapTilerMarkerSVGOptions, PendingMarkerUpdates, Vector2, MapTilerMarkerOptions, MarkerCollisionEventData, MarkerCollisionDisplayState, MapTilerMarkerUIStateName, UIStateSpec, MarkerTransitionProperty, MapTilerMarkerTransitions, MarkerTransitionSpec, MarkerEventTypeSDK, GroundLineOptions, AltitudeReference, SetAltitudeOptions } from './types';
+import { MapTilerMarkerElementOptions, MapTilerMarkerSVGOptions, PendingMarkerUpdates, Vector2, MapTilerMarkerOptions, MarkerCollisionEventData, MarkerCollisionDisplayState, MapTilerMarkerUIStateName, UIStateSpec, MarkerTransitionProperty, MapTilerMarkerTransitions, MarkerTransitionSpec, MarkerEventTypeSDK, GroundLineOptions, AltitudeReference, SetAltitudeOptions, MarkerStyle } from './types';
 import { MarkerFootprint } from './collision-helpers';
 import { PendingUpdatesSymbol, DetachFromDOMSymbol, FlushDOMUpdatesSymbol, MarkerElementSymbol, RefreshAdaptiveColorSymbol, CollisionFootprintSymbol, EmitCollisionDiffSymbol, ApplyCollisionDisplayStateSymbol, ApplyAltitudeFrameSymbol, MeasuredElementSizeSymbol, ClearFocusStateSymbol, AttachToMapSymbol } from './marker-symbols';
 /** MapLibre's `Marker` extended with 2-D scale, named shapes, colour tokens, and batched DOM updates. */
@@ -281,6 +281,12 @@ export declare class Marker extends MLMarker {
      * @returns Rotation in degrees; `0` if never set.
      */
     getRotation(): number;
+    /**
+     * Returns the marker's visual style. Colours are only included when set
+     * explicitly — unlike {@link getOuterColor} and friends, map-style defaults
+     * are not resolved, so the result stays adaptive wherever it's reused.
+     */
+    getStyle(): MarkerStyle;
     private attachUIStateListeners;
     /** Blurs the marker's focusable element. Called by {@link MarkerManager} on map `click`. */
     [ClearFocusStateSymbol](): void;

package/dist/Marker/marker-adaptive-colors.d.ts

@@ -1,32 +1,8 @@
-import { defaultReferenceStyleMap } from '@maptiler/client';
-/**
- * Unversioned reference-style key, matching the reference styles of
- * `MapStyle` from `@maptiler/client` (e.g. `MapStyle.STREETS` → `"streets"`).
- */
-export type ReferenceStyleKey = Lowercase<keyof typeof defaultReferenceStyleMap>;
-/**
- * Style key the marker colours can target: an unversioned reference-style id,
- * optionally with a variant suffix (e.g. `"streets"`, `"streets-dark"`).
- * Versioned style ids (`"streets-v4-dark"`) are normalised to this form by
- * {@link getAdaptiveColors}.
- */
-export type AdaptiveStyleKey = ReferenceStyleKey | `${ReferenceStyleKey}-${string}`;
-/** The colours of each marker part for one map style. */
-export type AdaptiveColorSet = {
-    /** Fill of the inner area. */
-    innerColor: string;
-    /** Fill of the outer body / border. */
-    outerColor: string;
-    /** Colour of the content (text, glyph). */
-    contentColor: string;
-    /** Stroke of the outline (only visible when an outline width is set). */
-    outlineColor: string;
-};
+import { AdaptiveColorSet } from '../adaptive-colors';
 /**
  * Resolves the default marker colours for a given map style and shape.
  *
- * Lookup order: exact style key (version stripped, variant kept) → reference
- * style without variant → `base`, so an unknown style id resolves to `base`.
+ * The style's colours come from {@link getAdaptiveColorsForStyle}.
  * Shapes in {@link INVERTED_COLOR_SHAPES} get the style's colours swapped: the
  * accent colour on the body and the mark, the body colour on the inner fill.
  * @param styleId - Style id, versioned (`"streets-v4-dark"`) or not (`"streets-dark"`).

package/dist/Marker/marker-canvas.d.ts

@@ -0,0 +1,31 @@
+import { MarkerStyle } from './types';
+export type MarkerCanvasOptions = {
+    /** Device pixels per CSS pixel. Defaults to `window.devicePixelRatio`. */
+    pixelRatio?: number;
+    /** Map style id used to resolve unset colours to their adaptive defaults. Defaults to the `base` colours. */
+    styleId?: string;
+};
+export type MarkerCanvas = {
+    /** The drawn marker, `pixelRatio` device pixels per CSS pixel. */
+    canvas: HTMLCanvasElement;
+    pixelRatio: number;
+    /**
+     * Transparent margin in CSS px on every side of the marker's nominal
+     * `SIZE_PX` box, leaving room for the outline and shadow. Equal on all
+     * sides, so the image centre is the box centre and `getShapeAnchorOffset`
+     * applies unchanged.
+     */
+    padding: number;
+};
+/**
+ * Draws a marker to a canvas, matching the DOM marker built from the same
+ * style. Opacity is not baked in — apply it at display time, as the DOM path
+ * does on its wrapper.
+ *
+ * Text content is drawn with whatever font is available at call time —
+ * await `document.fonts.load()` for the marker font first, or the text falls
+ * back to the next family in {@link MARKER_FONT_FAMILY}.
+ * @param style - Visual style of the marker.
+ * @param options - Pixel ratio and style id for adaptive colours.
+ */
+export declare function drawMarkerCanvas(style: MarkerStyle, options?: MarkerCanvasOptions): MarkerCanvas;

package/dist/Marker/marker-constants.d.ts

@@ -1,7 +1,6 @@
 import { MarkerOptions } from 'maplibre-gl';
 import { EasingFunctionName } from '../MaptilerAnimation/types';
 import { EnterAnimationPreset, ExitAnimationPreset, IdleAnimationPreset, MapTilerMarkerUIStateName, MapTilerMarkerShape, MapTilerMarkerSize, MapTilerMarkerShadow } from './types';
-import { AdaptiveColorSet, AdaptiveStyleKey } from './marker-adaptive-colors';
 import { ContentMetrics, ShapeSize } from './marker-svg-config';
 export declare const DEFAULT_SHAPE: MapTilerMarkerShape;
 export declare const DEFAULT_SIZE: MapTilerMarkerSize;
@@ -22,16 +21,18 @@ export declare const DEFAULT_PROXIMITY_PADDING = 4;
 /** Matches the fade duration in the SDK stylesheet (`.maptiler-marker-collision-fade`). */
 export declare const COLLISION_FADE_DURATION_MS = 150;
 export declare const SIZE_PX: Record<MapTilerMarkerSize, number>;
+/** Drop-shadow geometry in CSS px. `blur` follows the CSS `drop-shadow()` / canvas `shadowBlur` convention (twice the Gaussian standard deviation). */
+export type MarkerShadowParams = {
+    offsetX: number;
+    offsetY: number;
+    blur: number;
+    color: string;
+};
+/** Single source of truth for marker shadows — the DOM path's CSS filter and the canvas path's `shadow*` settings are both derived from it. */
+export declare const SHADOW_PARAMS: Record<MapTilerMarkerShadow, MarkerShadowParams | null>;
 export declare const SHADOW_FILTER: Record<MapTilerMarkerShadow, string>;
 /** Content sizing per marker size, shared by every shape (px). */
 export declare const CONTENT_METRICS: Record<ShapeSize, ContentMetrics>;
-/**
- * Default marker colours per map style. `base` doubles as the fallback for
- * styles without a dedicated entry.
- */
-export declare const ADAPTIVE_COLORS: {
-    base: AdaptiveColorSet;
-} & Partial<Record<AdaptiveStyleKey, AdaptiveColorSet>>;
 /**
  * Shapes whose default colours are the map style's, swapped: a blue body with a white inner fill and
  * a blue mark. Colours set explicitly aren't touched.

package/dist/Marker/types.d.ts

@@ -415,6 +415,13 @@ export type MapTilerMarkerSVGOptions = MapTilerMarkerBaseOptions & Exclude<Marke
 type MapTilerMarkerElementPropKeys = "shape" | "outerColor" | "innerColor" | "contentColor" | "outline" | "outlineColor" | "shadow" | "opacity" | "title" | "content" | "htmlAttributes" | "rotation" | "scale" | "size" | "debug" | "priority";
 export type MapTilerMarkerElementProps = Pick<MapTilerMarkerBaseOptions, MapTilerMarkerElementPropKeys>;
 export type MapTilerMarkerOptions = MapTilerMarkerBaseOptions & MarkerContent;
+/**
+ * Visual subset of {@link MapTilerMarkerBaseOptions} — everything that
+ * determines how a marker looks, and nothing about how it behaves or where
+ * it sits. Unset fields fall back to the marker defaults; unset colours
+ * fall back to the current map style's adaptive colours.
+ */
+export type MarkerStyle = Pick<MapTilerMarkerBaseOptions, "shape" | "size" | "outerColor" | "innerColor" | "contentColor" | "outline" | "outlineColor" | "shadow" | "opacity" | "content">;
 /**
  * Batch of property updates waiting to be flushed to the DOM.
  * A key being present (even with an `undefined` value) means "apply this

package/dist/adaptive-colors.d.ts

@@ -0,0 +1,48 @@
+import { defaultReferenceStyleMap } from '@maptiler/client';
+/**
+ * Unversioned reference-style key, matching the reference styles of
+ * `MapStyle` from `@maptiler/client` (e.g. `MapStyle.STREETS` → `"streets"`).
+ */
+export type ReferenceStyleKey = Lowercase<keyof typeof defaultReferenceStyleMap>;
+/**
+ * Style key the adaptive colours can target: an unversioned reference-style id,
+ * optionally with a variant suffix (e.g. `"streets"`, `"streets-dark"`).
+ * Versioned style ids (`"streets-v4-dark"`) are normalised to this form by
+ * {@link getAdaptiveColorsForStyle}.
+ */
+export type AdaptiveStyleKey = ReferenceStyleKey | `${ReferenceStyleKey}-${string}`;
+/** The default colours of each marker part for one map style. */
+export type AdaptiveColorSet = {
+    /** Fill of the inner area. */
+    innerColor: string;
+    /** Fill of the outer body / border. */
+    outerColor: string;
+    /** Colour of the content (text, glyph). */
+    contentColor: string;
+    /** Stroke of the outline (only visible when an outline width is set). */
+    outlineColor: string;
+};
+/**
+ * Default colours per map style. `base` doubles as the fallback for styles
+ * without a dedicated entry. Frozen, as lookups hand out these objects as is.
+ */
+export declare const ADAPTIVE_COLORS: {
+    base: AdaptiveColorSet;
+} & Partial<Record<AdaptiveStyleKey, AdaptiveColorSet>>;
+/**
+ * Resolves the default (adaptive) colours for a given map style.
+ *
+ * Lookup order: exact style key (version stripped, variant kept) → reference
+ * style without variant → `base`, so an unknown style id resolves to `base`.
+ * @param styleId - Style id, versioned (`"streets-v4-dark"`) or not (`"streets-dark"`).
+ * @returns The style's colour set. The object is frozen and shared, so spread it to modify a copy.
+ * @example
+ * ```ts
+ * getAdaptiveColorsForStyle("streets-v4-dark").innerColor; // "#4D97FF"
+ * ```
+ * @example
+ * ```ts
+ * getAdaptiveColorsForStyle("my-custom-style"); // falls back to the `base` colours
+ * ```
+ */
+export declare function getAdaptiveColorsForStyle(styleId: string): AdaptiveColorSet;

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { setRTLTextPlugin, getRTLTextPluginStatus, LngLat, LngLatBounds, Mercato
 export { getVersion as getMapLibreVersion, Map as MapMLGL, Marker as MarkerMLGL, Popup as PopupMLGL, Style as StyleMLGL, CanvasSource as CanvasSourceMLGL, GeoJSONSource as GeoJSONSourceMLGL, ImageSource as ImageSourceMLGL, RasterTileSource as RasterTileSourceMLGL, RasterDEMTileSource as RasterDEMTileSourceMLGL, VectorTileSource as VectorTileSourceMLGL, VideoSource as VideoSourceMLGL, NavigationControl as NavigationControMLGL, GeolocateControl as GeolocateControlMLGL, AttributionControl as AttributionControlMLGL, LogoControl as LogoControlMLGL, ScaleControl as ScaleControlMLGL, FullscreenControl as FullscreenControlMLGL, TerrainControl as TerrainControMLGL, BoxZoomHandler as BoxZoomHandlerMLGL, ScrollZoomHandler as ScrollZoomHandlerMLGL, CooperativeGesturesHandler as CooperativeGesturesHandlerMLGL, KeyboardHandler as KeyboardHandlerMLGL, TwoFingersTouchPitchHandler as TwoFingersTouchPitchHandlerMLGL, MapWheelEvent as MapWheelEventMLGL, MapTouchEvent as MapTouchEventMLGL, MapMouseEvent as MapMouseEventMLGL, config as configMLGL, } from 'maplibre-gl';
 export * from './Marker';
 export { Marker } from './Marker';
+export { getAdaptiveColorsForStyle, type AdaptiveColorSet, type AdaptiveStyleKey, type ReferenceStyleKey } from './adaptive-colors';
 export { Popup, Style, CanvasSource, GeoJSONSource, ImageSource, RasterTileSource, RasterDEMTileSource, VectorTileSource, VideoSource, NavigationControl, GeolocateControl, AttributionControl, LogoControl, ScaleControl, FullscreenControl, TerrainControl, BoxZoomHandler, ScrollZoomHandler, CooperativeGesturesHandler, KeyboardHandler, TwoFingersTouchPitchHandler, MapWheelEvent, MapTouchEvent, MapMouseEvent, } from 'maplibre-gl';
 export { Map, GeolocationType, type AttributionControlOptions, type MapOptions, type LoadWithTerrainEvent, type MaptilerMapEventType, type MapEventTypeSDK } from './Map';
 export type { CameraPosition, TilePreloadOptions, WithTilePreload, PreloadTilesForBoundsOptions, PreloadTilesForCameraPositionsOptions, PreloadTilesOptions, TilePreloadErrorCallback, TilePreloadProgressCallback, } from './tile-preloading';