@xweather/mapsgl 1.9.0 → 1.9.1-beta.1

package/dist/mapsgl.css

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

package/dist/mapsgl.d.ts

@@ -2032,6 +2032,7 @@ declare abstract class DataSource<Spec extends SourceSpecification = SourceSpeci
      * The map layers that are currently using this data source.
      */
     consumingLayers: Array<DataSourceConsumer>;
+    private _consumingLayerIds;
     /**
      * The type of data source and data it manages.
      * @readonly
@@ -2142,6 +2143,12 @@ 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;
+    /**
+     * Retrieves an active (pending or in-flight) task by key.
+     * @param key - The unique identifier for the task.
+     * @returns The active task if present, otherwise undefined.
+     */
+    getTask(key: string): Task | undefined;
     /**
      * Sets the task runner function used to execute download tasks.
      * @param runner - The task runner function that handles task execution with retry logic.
@@ -2617,6 +2624,7 @@ declare const ExpressionOperator: {
     readonly case: "case";
     readonly match: "match";
     readonly let: "let";
+    readonly time: "time";
 };
 
 export declare type ExpressionOperator = ObjectValue<typeof ExpressionOperator>;
@@ -3968,6 +3976,8 @@ dispose(all?: boolean): void;
 export declare class MapCamera {
     private _transform;
     private _orientation;
+    private readonly _quat;
+    private readonly _vec3;
     get position(): Vector3;
     set position(value: Vector3);
     get orientation(): Quaternion;
@@ -3983,6 +3993,10 @@ export declare class MapCamera {
      * @returns The view matrix
      */
     worldToCameraMatrix(worldSize: number, pixelsPerMeter?: number): Matrix4;
+    /**
+     * Writes world->camera matrix into `out` to avoid per-frame allocations.
+     */
+    worldToCameraMatrixInto(out: Matrix4, worldSize: number, pixelsPerMeter?: number): Matrix4;
     calculateCameraOrientation(bearing: number, pitch: number): Quaternion;
 }
 
@@ -4324,7 +4338,27 @@ get needsViewportUpdate(): boolean;
      */
     setRefreshInterval(minutes: number, advanceToNow?: boolean): void;
     private _triggerPreloadAnimation;
+    private _preloadAnimationRequestId;
+    private _activePreloadAnimationPromise?;
+    private _hasPendingPreloadAnimationRequest;
+    /**
+     * Schedules animation preload work and returns the active drain promise.
+     * Calls are coalesced: if preload is already running, this only marks that another pass should run after the
+     * current one completes.
+     */
     preloadAnimationData(): Promise<void>;
+    /**
+     * Processes queued preload requests until no further requests are pending.
+     * If a newer request arrives during a preload pass, marks animators dirty so the next pass recomputes against
+     * the newest viewport and timeline state.
+     */
+    private _drainPreloadAnimationQueue;
+    /**
+     * Invalidates in-flight preload work.
+     * This does not abort the current async operation directly; it marks the current pass stale and forces the next
+     * queued pass to refresh from latest state.
+     */
+    private cancelPreloadAnimationData;
     private debouncedPreloadAnimationData;
     private setNeedsPreloadAnimationData;
     private preloadAnimationDataIfNeeded;
@@ -5574,6 +5608,7 @@ export declare class SourceMetadata extends EventDispatcher {
     private _transformer;
     private _hasLoaded;
     private _lastRequestOptions;
+    private _validTimesCache;
     
     /**
      * Creates an instance of SourceMetadata
@@ -5669,6 +5704,7 @@ export declare class SourceMetadata extends EventDispatcher {
      * @returns A promise that resolves with the metadata for the source.
      */
     load(options?: Partial<UrlRequestOptions>): Promise<Partial<SourceMetadataSchema>>;
+    cancel(): void;
     protected processMetadata(json: Record<string, any>): Partial<SourceMetadataSchema>;
 }
 
@@ -6621,6 +6657,12 @@ export declare interface TileLayerConfig extends WebGLLayerConfig {
     zoomOffset: number;
 }
 
+export declare type TilePositionData = {
+    translation: Vector3;
+    scale: Vector3;
+    matrix: Matrix4;
+};
+
 export declare type TileQuadrant = 'tl' | 'tc' | 'tr' | 'ml' | 'mc' | 'mr' | 'bl' | 'bc' | 'br';
 
 /**
@@ -6705,6 +6747,9 @@ declare abstract class TileSource<Data = any, Source extends TileSourceSpecifica
      * deduplication vs. load-generation guard.
      */
     private _tileLoadRequestId;
+    private _metadataLoadPromise?;
+    private _pendingTaskCountByCoord;
+    private _pendingIntervalsByCoord;
     /**
      * The minimum zoom level for the source.  Defaults to `0`.
      */
@@ -6819,7 +6864,8 @@ constructor(id: string, spec: Partial<Source>);
         headers: Headers | null;
     }>;
     getMetadata(options?: Partial<UrlRequestOptions>): Promise<unknown>;
-    removeConsumer(consumer: DataSourceConsumer): void;
+
+removeConsumer(consumer: DataSourceConsumer): void;
     /**
      * Aborts a tile request.
      * @param tile - The tile to abort.
@@ -7742,13 +7788,10 @@ export declare type WeatherLayerOptions = {
      */
     legend: Partial<LegendOptions> | false;
     /**
-     * Time range information about the map's current timeline.
+     * The map's live timeline animation instance, used by source generators for both time range
+     * parameters and per-feature animation controllers.
      */
-    timeline: {
-        from: Date;
-        to: Date;
-        current: Date;
-    };
+    timeline: TimeAnimation;
     /**
      * Options for configuring a mask to apply to the layer.
      */
@@ -7839,6 +7882,8 @@ declare abstract class WebGLLayer<Source extends DataSource = DataSource> extend
      * Whether to invert the mask layer's output.
      */
     invertMaskLayer: boolean;
+    
+    private _renderFrameContext;
 
 /**
      * Returns the render paint style configuration for this layer.