@xweather/mapsgl 1.8.2 → 1.8.3

package/dist/mapsgl.css

@@ -1,6 +1,6 @@
 /*!
  * 
- * 	@xweather/mapsgl - 1.8.2
+ * 	@xweather/mapsgl - 1.8.3
  * 	(c) 2025 Vaisala Xweather
  * 	License: BSD
  * 	https://www.xweather.com

package/dist/mapsgl.d.ts

@@ -1898,16 +1898,16 @@ declare const CtoF: (c: number) => number;
 declare const CtoFUnit: (c: number) => number;
 
 export declare interface DataEvaluator {
-    title: string | ((value: any) => string);
+    title: string | ((data: FeatureQueryResult) => string);
     alwaysShow?: boolean;
-    fn: (value: number | Record<string, number>) => string;
+    fn: (data: FeatureQueryResult) => string;
 }
 
 export declare class DataInspector {
     readonly map: AnyMapController;
     constructor(map: AnyMapController);
-    query(coord: Coordinate): Record<string, any>;
-    queryPromise(coord: Coordinate): Promise<Record<string, any>>;
+    query(coord: Coordinate): Record<string, FeatureQueryResult> | undefined;
+    queryPromise(coord: Coordinate): Promise<Record<string, FeatureQueryResult>>;
 }
 
 export declare class DataInspectorControl {
@@ -1934,7 +1934,7 @@ export declare class DataInspectorControl {
     handleMouseOutEvent: (e: any) => void;
     _queryFeatures: (coord: Coordinate) => void;
     _queryFeaturesAsync: (coord: Coordinate) => Promise<void>;
-    _setFeatures(coord: Coordinate, features: Record<string, any>): void;
+    _setFeatures(coord: Coordinate, features: Record<string, FeatureQueryResult>): void;
 }
 
 export declare interface DataInspectorControlOptions {
@@ -2071,6 +2071,14 @@ export declare interface Disposable {
     dispose(): void;
 }
 
+declare const DownloadPriority: {
+    readonly critical: 0;
+    readonly high: 1;
+    readonly warm: 2;
+};
+
+export declare type DownloadPriority = ObjectValue<typeof DownloadPriority>;
+
 /**
  * Set of common easing functions.
  */
@@ -2320,9 +2328,12 @@ ExpressionInputType,
 ];
 
 export declare type FeatureQueryResult = {
-    value: number | Record<string, any>;
+    value: number;
+    angle?: number;
+    unit?: string;
+    features?: Array<FeatureData>;
     nodata: boolean;
-} | Array<any>;
+};
 
 export declare type FillPattern = string | RemoteSymbolImage;
 
@@ -3027,6 +3038,10 @@ export declare interface LayerRenderer {
      * @param layer - The layer that was resized.
      */
     onResize(layer: WebGLLayer): void;
+    /**
+     * Called when the layer's mask state changes.
+     */
+    onMaskStateChange(): void;
     /**
      * Flags the renderer as dirty so that it is updated during the next render frame.
      */
@@ -3517,6 +3532,13 @@ export declare interface MapAdapterOptions {
          * the animation if desired using `timeline.resume()` or `timeline.start()`.
          */
         resumeOnMoveEnd: boolean;
+        /**
+         * Whether to always preload data for the animation. If `true`, then the animation will always preload data
+         * for the animation when the map viewport changes or when animatable layers are added, even if the animation
+         * is not currently playing. This is useful for ensuring that the animation has data to play when it is started.
+         * Default is `false`.
+         */
+        preloadData: boolean;
     }>;
 }
 
@@ -3908,7 +3930,11 @@ get needsViewportUpdate(): boolean;
      * then the timeline's current position will remain unchanged. Defaults to `true`.
      */
     setRefreshInterval(minutes: number, advanceToNow?: boolean): void;
+    private _triggerPreloadAnimation;
     preloadAnimationData(): Promise<void>;
+    private debouncedPreloadAnimationData;
+    private setNeedsPreloadAnimationData;
+    private preloadAnimationDataIfNeeded;
     triggerRedraw(): void;
     protected getTransform(map: MapType, projection?: ProjectionType): MapTransform;
     getProjection(): ProjectionType;
@@ -6077,6 +6103,10 @@ export declare type TileRequestOptions = {
      * The {@link AbortSignal} to use for the request.
      */
     signal: AbortSignal;
+    /**
+     * The download priority of the request.
+     */
+    priority: DownloadPriority;
     /**
      * Whether to reload the tile if it has already been loaded.
      */
@@ -6239,6 +6269,11 @@ constructor(id: string, spec: Partial<Source>);
      */
     cancelAllRequests(): void;
     
+    protected onLoadStart(): void;
+    protected onLoadProgress(e: any): void;
+    protected onLoadComplete(): void;
+    protected onTileLoaded(tile: Tile<Data>, data: Data): void;
+    protected onTileError(tile: Tile<Data>, err: any): void;
     dispose(): void;
 }
 
@@ -6309,16 +6344,33 @@ export declare class TimeAnimation extends Animation {
      */
     get startDate(): Date;
     set startDate(value: Date);
+    /**
+     * The offset between the start date and the animation's reference date in milliseconds. The reference date is the
+     * current date at the time the animation was instantiated or the last time the start/end date was set.
+     * @readonly
+     */
+    get startOffset(): number;
     /**
      * The end date of the animation.
      */
     get endDate(): Date;
     set endDate(value: Date);
+    /**
+     * The offset between the end date and the animation's reference date in milliseconds. The reference date is the
+     * current date at the time the animation was instantiated or the last time the start/end date was set.
+     * @readonly
+     */
+    get endOffset(): number;
     /**
      * The current date of the animation based on the animation's current position.
      * @readonly
      */
     get currentDate(): Date;
+    /**
+     * The reference date of the animation. The reference date is the current date at the time the animation was
+     * instantiated or the last time the start/end date was set.
+     * @readonly
+     */
     get referenceDate(): Date;
     /**
      * Whether the animation includes time in the past.
@@ -6351,7 +6403,9 @@ export declare class TimeAnimation extends Animation {
      */
     get info(): TimeAnimationInfo;
     private _startDate;
+    private _startOffset;
     private _endDate;
+    private _endOffset;
     private _now;
     constructor({ start, end, alwaysStopAtStart, ...animationOpts }: Partial<TimeAnimationOptions>);
     /**
@@ -6611,6 +6665,11 @@ export declare type TimeSeriesOperationPeriod = 'none' | 'hour' | 'day' | 'week'
  */
 export declare type TimeSeriesOperationType = 'none' | 'sum' | 'diff' | 'max' | 'min';
 
+export declare type TimestampledPixel = {
+    interval: TimeInterval;
+    pixel: RGB;
+};
+
 /**
  * A unit converter function.
  */
@@ -7174,7 +7233,6 @@ declare abstract class WebGLLayer<Source extends DataSource = DataSource> extend
      */
     timing: LayerTiming;
     
-    isLayerMask: boolean;
     /**
      * Whether to invert the mask layer's output.
      */
@@ -7193,6 +7251,8 @@ declare abstract class WebGLLayer<Source extends DataSource = DataSource> extend
 
 get mask(): LayerMask;
     set mask(value: LayerMask);
+    get isLayerMask(): boolean;
+    set isLayerMask(value: boolean);
     /**
      * Returns whether this layer is visible or not.
      * @readonly
@@ -7272,7 +7332,8 @@ protected addSourceEventHandler(event: string, handler: (e: any) => void, once?:
     
     protected onReady(): void;
 
-protected eventPayload(): Record<string, any>;
+protected onMaskStateChange(): void;
+    protected eventPayload(): Record<string, any>;
     /**
      * Disposes of all cached data and resources associated with the layer. This method is automatically called when
      * the layer is removed from a MapController instance.