@xweather/mapsgl 1.8.4 → 1.8.5

package/dist/mapsgl.css

@@ -1,6 +1,6 @@
 /*!
  * 
- * 	@xweather/mapsgl - 1.8.4
+ * 	@xweather/mapsgl - 1.8.5
  * 	(c) 2026 Vaisala Xweather
  * 	License: BSD
  * 	https://www.xweather.com

package/dist/mapsgl.d.ts

@@ -1693,15 +1693,6 @@ export declare class Bounds {
     constructor(left: number, right: number, top: number, bottom: number);
 }
 
-/**
- * Defines the granularity of subdivision for circles with `circle-pitch-alignment: 'map'` and for heatmap kernels.
- * More subdivision will cause circles to more closely follow the planet's surface.
- *
- * Possible values: 1, 3, 5, 7.
- * Subdivision of 1 results in a simple quad.
- */
-export declare type CircleGranularity = 1 | 3 | 5 | 7;
-
 /**
  * Circle style properties control how circles get rendered on a map. Use these properties in conjunction with `fill`
  * and `stroke` to define the style for a circle layer.
@@ -2104,6 +2095,7 @@ export declare class DownloadManager<Task extends DownloadTask<any>> extends Eve
 
 /**
      * Gets the progress tracker for download operations.
+     * Progress is calculated from actual task states for accuracy.
      * @returns The Progress instance tracking download statistics.
      */
     get progress(): Progress;
@@ -2129,12 +2121,6 @@ export declare class DownloadManager<Task extends DownloadTask<any>> extends Eve
      * @returns The cached task data, or undefined if not found.
      */
     get(key: string): TaskData<Task> | undefined;
-    /**
-     * Sets the tile fetcher function to use for requests.
-     * The fetcher function should return a Promise that resolves with a Response object.
-     * @param fetcher -
-     */
-    setFetcher(fetcher: Fetcher<Task>): void;
     /**
      * Sets the task runner function used to execute download tasks.
      * @param runner - The task runner function that handles task execution with retry logic.
@@ -2160,13 +2146,15 @@ export declare class DownloadManager<Task extends DownloadTask<any>> extends Eve
      * @param predicate - A callback that receives a task and returns true for a match.
      */
     hasTask(predicate: (task: Task) => boolean): boolean;
+    private _totalTasks;
     /**
      * Adds a task to the download queue and optionally starts processing.
      * Tasks are organized by host for per-host concurrency control and sorted by priority.
      * @param task - The download task to enqueue.
      * @param start - If true, immediately starts processing the queue. Defaults to true.
+     * @param isRetry - If true, this is a retry and should not increment total. Defaults to false.
      */
-    enqueue(task: Task, start?: boolean): void;
+    enqueue(task: Task, start?: boolean, isRetryParam?: boolean): void;
     /**
      * Aborts a specific download task.
      * If the task is in-flight, the request is aborted. If pending, it's removed from the queue.
@@ -2179,6 +2167,9 @@ export declare class DownloadManager<Task extends DownloadTask<any>> extends Eve
      * @param predicate - A callback that receives a task and returns true if it should be aborted.
      */
     abortWhere(predicate: (task: Task) => boolean): void;
+    /**
+     * Aborts all tasks.
+     */
     abortAll(): void;
 
 }
@@ -2413,16 +2404,25 @@ export declare interface EncodedRasterDataset {
  */
 export declare interface EncodedSourceSpecification<Dataset extends EncodedRasterDataset> extends TileSourceSpecification {
     /**
-     * The datasets that are encoded in the tile data.
+     * The datasets that are encoded in the tile data. These are used for requesting tiles from the server.
+     * If the data is transformed (e.g., converting precip to snowfall), use `effectiveDatasets` to provide
+     * the transformed datasets with updated dataMin/dataMax values for operations and rendering.
      */
     datasets: Array<Partial<Dataset>>;
+    /**
+     * The effective datasets used for operations and rendering. If not provided, defaults to `datasets`.
+     * Use this when data transformations change the dataMin/dataMax values (e.g., converting precipitation
+     * to snowfall). The original `datasets` are still used for tile requests.
+     */
+    effectiveDatasets?: Array<Partial<Dataset>>;
     /**
      * Optional function to transform tile data after it has been loaded. This allows for custom processing or
      * modification of the tile data before it is used for rendering, such as converting it to other values
      * derived from the original encoded data.
      * @param data - The loaded tile data as an RGBA image.
      * @param datasets - An array of dataset objects associated with this source, which contains information about the
-     * original encoded data and its value ranges.
+     * original encoded data and its value ranges. This array can be modified in-place to update dataMin/dataMax
+     * values for transformed data.
      */
     transformTileData?: (data: RGBAImage, datasets: Array<Dataset>) => void;
 }
@@ -2441,8 +2441,8 @@ export declare class EncodedTileSource<Source extends EncodedSourceSpecification
     
     get type(): string;
     constructor(id: string, spec: Partial<Source>);
-    
-    /**
+
+/**
      * Returns the metadata for the specified band, if available.
      * @param band - The band to get metadata for.
      * @returns
@@ -2771,6 +2771,10 @@ export declare type GeoJsonProperties = {
  * A subclass of {@link VectorTileSource} that is used to represent GeoJSON data.
  */
 export declare class GeoJSONSource extends VectorTileSource {
+    /**
+     * Whether the GeoJSON data is dynamic, meaning it will be updated frequently. Default is `false`.
+     */
+    dynamic: boolean;
     
     private _transformGeoJSON?;
     get type(): string;
@@ -2783,8 +2787,9 @@ export declare class GeoJSONSource extends VectorTileSource {
      * The GeoJSON data associated with the source, either provided statically or from a remote source.
      */
     get data(): GeoJSONFeatureCollection;
-    private coalesce;
     private pendingLoad;
+    private needsUpdate;
+    private dataRevision;
     constructor(id: string, spec: Partial<GeoJSONSourceSpecification>);
     /**
      * Sets the URL of the GeoJSON data.
@@ -2805,6 +2810,7 @@ export declare class GeoJSONSource extends VectorTileSource {
     expireAllTiles(): void;
     reload(): void;
     private updateWorkerData;
+    private processWorkerUpdate;
 }
 
 /**
@@ -2819,6 +2825,10 @@ export declare interface GeoJSONSourceSpecification extends SourceSpecification
      * The GeoJSON URL template string to use when requesting GeoJSON data.
      */
     url: string;
+    /**
+     * Whether the GeoJSON data is dynamic, meaning it will be updated frequently. Default is `false`.
+     */
+    dynamic?: boolean;
     /**
      * A function that transforms the GeoJSON data before it is sent to the worker for processing.
      * @param source - The GeoJSON source.
@@ -3358,6 +3368,14 @@ export declare interface LayerSpecification {
      * Type of layer.
      */
     type: LayerType;
+    /**
+     * The minimum zoom level for the layer.
+     */
+    minZoom?: number;
+    /**
+     * The maximum zoom level for the layer.
+     */
+    maxZoom?: number;
     /**
      * Data source associated with the layer.
      * @remarks
@@ -4101,14 +4119,14 @@ get needsViewportUpdate(): boolean;
     
     /**
      * Adds a new weather layer to the map.
-     * @param id - One of the supported weather layer identifiers.
+     * @param idOrConfig - One of the supported weather layer identifiers or a weather layer configuration object.
      * @param overrides - An object containing data and render style overrides for the weather layer.
      * @param beforeId - The identifier of an existing map layer to insert the new layer before, which will result in
      * the new layer appearing below the target layer. If not provided, then the new layer will be added to the end of
      * the layer stack and above all other layers.
      * @returns The newly added map layer or an array of layers if the weather layer identifier maps to multiple layers.
      */
-    addWeatherLayer(id: string, overrides?: Partial<WeatherLayerOptions>, beforeId?: string): WebGLLayer | Array<WebGLLayer>;
+    addWeatherLayer(idOrConfig: WeatherLayerConfiguration | string, overrides?: Partial<WeatherLayerOptions>, beforeId?: string): WebGLLayer | Array<WebGLLayer>;
     /**
      * Removes a weather layer from the map.
      * @param id - One of the supported weather layer identifiers.
@@ -4909,22 +4927,22 @@ export declare const ParticleDensity: {
      * Least amount of particles will be rendered. This density setting may not provide enough speed and direction
      * information on the map since coverage is minimal. Sets the particle count per tile to 8^2.
      */
-    readonly minimal: 8;
+    readonly minimal: 16;
     /**
      * Slightly less particle density than `normal`, allowing the most visibiilty to content underneath while
      * providing good speed and direction information. Sets the particle count per tile to 16^2.
      */
-    readonly low: 24;
+    readonly low: 32;
     /**
      * Provides a good amount of particles and speed and direction information while still allowing a good portion
      * of content underneath to remain visible. Sets the particle count per tile to 48^2.
      */
-    readonly normal: 48;
+    readonly normal: 64;
     /**
      * Slightly higher particle density than `normal` while still allowing some content underneath to remain visible.
      * Sets the particle count per tile to 76^2.
      */
-    readonly high: 76;
+    readonly high: 96;
     /**
      * Highest density that will essentially fill the layer with particle data, preventing content underneath from
      * being visible. Note that overall map performance may be affected with this setting for some hardware
@@ -5773,6 +5791,8 @@ export declare const styles: {
         };
         prate: (string | number)[];
         precip_accum: (string | number)[];
+        sleet_accum: (string | number)[];
+        ice_accum: (string | number)[];
         radar: {
             rain: (string | number)[];
             mix: (string | number)[];
@@ -5794,93 +5814,7 @@ export declare const styles: {
  * data-driven styling.
  */
 export declare type StyleValue<T> = T | ((data: StylableData) => T);
-
-/**
- * Controls how much subdivision happens for a given type of geometry at different zoom levels.
- */
-export declare class SubdivisionGranularityExpression {
-    /**
-     * A tile of zoom level 0 will be subdivided to this granularity level.
-     * Each subsequent zoom level will have its granularity halved.
-     */
-    private readonly _baseZoomGranularity;
-    /**
-     * No tile will have granularity level smaller than this.
-     */
-    private readonly _minGranularity;
-    constructor(baseZoomGranularity: number, minGranularity: number);
-    getGranularityForZoomLevel(zoomLevel: number): number;
-}
-
-export declare interface SubdivisionGranularityOptions {
-    /**
-     * Granularity settings used for fill and fill-extrusion layers (for fill, both polygons and their anti-aliasing outlines).
-     */
-    fill: {
-        base: number;
-        min: number;
-    };
-    /**
-     * Granularity used for the line layer.
-     */
-    line: {
-        base: number;
-        min: number;
-    };
-    /**
-     * Granularity used for geometry covering the entire tile: stencil masks, raster tiles, etc.
-     */
-    tile: {
-        base: number;
-        min: number;
-    };
-    /**
-     * Granularity used for stencil masks for tiles.
-     */
-    stencil: {
-        base: number;
-        min: number;
-    };
-    /**
-     * Controls the granularity of `pitch-alignment: map` circles and heatmap kernels.
-     * More granular circles will more closely follow the map's surface.
-     */
-    circle: CircleGranularity;
-}
-
-/**
- * An object describing how much subdivision should be applied to different types of geometry at different zoom levels.
- */
-export declare class SubdivisionGranularitySetting {
-    /**
-     * Granularity settings used for fill and fill-extrusion layers (for fill, both polygons and their anti-aliasing outlines).
-     */
-    readonly fill: SubdivisionGranularityExpression;
-    /**
-     * Granularity used for the line layer.
-     */
-    readonly line: SubdivisionGranularityExpression;
-    /**
-     * Granularity used for geometry covering the entire tile: raster tiles, etc.
-     */
-    readonly tile: SubdivisionGranularityExpression;
-    /**
-     * Granularity used for stencil masks for tiles.
-     */
-    readonly stencil: SubdivisionGranularityExpression;
-    /**
-     * Controls the granularity of `pitch-alignment: map` circles and heatmap kernels.
-     * More granular circles will more closely follow the map's surface.
-     */
-    readonly circle: CircleGranularity;
-    constructor(options: SubdivisionGranularityOptions);
-    /**
-     * Granularity settings that disable subdivision altogether.
-     */
-    static readonly noSubdivision: SubdivisionGranularityOptions;
-    static readonly globeSubdivision: SubdivisionGranularityOptions;
-}
-
+
 /**
  * Supported color bands.
  */
@@ -6054,8 +5988,6 @@ export declare type TaskRunner<Task extends DownloadTask<any>> = (task: Task, co
  * @template Task - The download task type that extends DownloadTask
  */
 export declare interface TaskRunnerConfig<Task extends DownloadTask<any>> {
-    /** Function that performs the fetch operation. */
-    fetcher: Fetcher<Task>;
     /** Maximum number of retry attempts for failed tasks. */
     maxRetries: number;
     /** HTTP status code range [min, max] that triggers retry attempts. */
@@ -6373,16 +6305,7 @@ export declare type TileCoordinateBounds = {
     nw: TileCoordinate;
     se: TileCoordinate;
 };
-
-export declare class TileDownloadTask extends DownloadTask<{
-    data: Blob;
-    headers: Headers;
-}> {
-    readonly coord: TileCoord;
-    readonly intervals: Array<number>;
-    constructor(key: string, coord: TileCoord, intervals: Array<number>, url: string, options: Partial<TileRequestOptions>, priority?: DownloadPriority);
-}
-
+
 export declare interface TileInfo {
     x: number;
     y: number;
@@ -6516,13 +6439,13 @@ constructor(id: string, spec: Partial<Source>);
      */
     hasTile(coord: TileCoord, layerId?: string): boolean;
     /**
-     * Returns whether or not the source has tile data for the given tile coordinate. If the tile's state is `expired`,
-     * this method will return `false` even if the tile has data.
+     * Checks if tile data exists for the given coordinate.
      * @param coord - The tile coordinate.
-     * @param layerId -
-     * @returns Whether or not the source has tile data for the given tile coordinate.
+     * @param layerId - Optional layer ID for per-layer data (unused but retained for API compatibility).
+     * @param allowExpired - If true, allows expired tiles to be considered as having data.
+     * @returns Whether tile data exists (optionally including expired/stale).
      */
-    hasTileData(coord: TileCoord, layerId?: string): boolean;
+    hasTileData(coord: TileCoord, layerId?: string, allowExpired?: boolean): boolean;
     /**
      * Returns the data for the given tile coordinate.
      * @param coord - The tile coordinate.
@@ -6547,7 +6470,7 @@ constructor(id: string, spec: Partial<Source>);
      * @param options - Additional options to use when requesting the tile.
      * @returns A promise that resolves with the tile data.
      */
-    requestTile(coord: TileCoord, options?: Partial<TileRequestOptions>): Promise<Data>;
+    requestTile(coord: TileCoord, options?: Partial<TileRequestOptions>): Promise<Data | null>;
     /**
      * Returns a tile instance for the given tile coordinate. If the tile does not exist, it will be created and added
      * to the cache.
@@ -6940,6 +6863,11 @@ export declare type TimeSeriesOperation = {
      * Bands to restrict the operation to. If not specified, the operation will be applied to all bands.
      */
     bands?: Array<ColorBand>;
+    /**
+     * The data range to remap the data to. If not specified, the data range will not be remapped and use provided data
+     * range or the range based on the datasets being used by the operation.
+     */
+    remappedDataRange?: ValueRange;
 };
 
 /**
@@ -7246,19 +7174,19 @@ export declare class VectorTileSource extends TileSource<VectorData, VectorSourc
     
     constructor(id: string, spec: Partial<VectorSourceSpecification>);
     hasTile(coord: TileCoord, layerId?: string): boolean;
-    hasTileData(coord: TileCoord, layerId?: string): boolean;
+    hasTileData(coord: TileCoord, layerId?: string, allowExpired?: boolean): boolean;
     expireAllTiles(): void;
     expireTile(tile: Tile<VectorData>): void;
     /**
      * Refreshes the data for all tiles in the source.
      */
-    refreshAllTileData(): void;
+    refreshAllTileData(layerId?: string): void;
     /**
      * Refreshes the data for a single tile in the source by re-parsing the existing data. This is useful when the
      * filter expression has changed for a consuming layer.
      * @param tile - The tile to refresh.
      */
-    refreshTileData(tile: Tile<VectorData>): Promise<void>;
+    refreshTileData(tile: Tile<VectorData>, layerId?: string): Promise<void>;
     
 }
 
@@ -7375,6 +7303,14 @@ export declare type WeatherLayerOptions = {
      * The render style to use for rendering the layer's data.
      */
     type: LayerType;
+    /**
+     * The minimum zoom level for the layer.
+     */
+    minZoom?: number;
+    /**
+     * The maximum zoom level for the layer.
+     */
+    maxZoom?: number;
     /**
      * Whether the layer should be hidden by default. Default is `false`.
      */
@@ -7477,6 +7413,12 @@ constructor(account: Account);
      * Returns the metadata for all available weather layers.
      */
     getLayerMetadata(): Promise<Array<WeatherLayerMetadata>>;
+    /**
+     * Returns a weather layer configuration for the specified Xweather Raster Maps layer code.
+     * @param code - The raster layer code to get the configuration for.
+     * @returns The weather layer configuration.
+     */
+    getRasterLayerConfig(code: string): WeatherLayerConfiguration;
     /**
      * Returns the weather layer configuration for the specified weather code. If the code represents a combined layer,
      * then an array of weather codes will be returned instead.
@@ -7510,6 +7452,14 @@ declare abstract class WebGLLayer<Source extends DataSource = DataSource> extend
      * The type of layer.
      */
     type: LayerType;
+    /**
+     * The minimum zoom level for the layer.
+     */
+    minZoom: number;
+    /**
+     * The maximum zoom level for the layer.
+     */
+    maxZoom: number;
     /**
      * The map controller that this layer is associated with.
      */