> For the complete documentation index, see [llms.txt](https://docs.weatherlayers.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.weatherlayers.com/weatherlayers-gl/changelog.md).

# Changelog

### 2026.5.2

*May 24th, 2026*

Bug fixes:

* Round numParticles to a multiple of 4, to improve compatibility with strict GPUs

### 2026.5.1

*May 11th, 2026*

Bug fixes:

* Fix "Binding bitmapTexture not set: Not found in shader layout" warning

### 2026.5.0

*May 10th, 2026*

Peer dependencies:

* **⚠️ Upgrade to deck.gl 9.3.2**

### 2026.2.0

*February 1st, 2026*

Minor changes:

* Use \_renderLayersInGroups for Maplibre/Mapbox interleaved demo
* Improve HighLow layer performance
  * Use filterSubLayer for minZoom/maxZoom, to avoid using shouldUpdateState with changeFlags.viewportChanged

Peer dependencies:

* Upgrade to deck.gl 9.2.6
* Upgrade to geotiff.js 3.0.0

### 2025.12.0

*December 11th, 2025*

Bug fixes:

* Fix "bytesPerRow must be a multiple of bytesPerPixel for rgba8unorm" error
  * <https://github.com/weatherlayers/weatherlayers-gl/issues/24>

Peer dependencies:

* Upgrade to deck.gl 9.2.5

### 2025.11.0

*November 16th, 2025*

New features:

* Add support for loading data with abort signal
  * This loads data with `fetch` as a blob instead of as an image
* Add `borderEnabled`, `borderWidth`, `borderColor`, `gridEnabled`, `gridSize`, `gridColor` to Raster layer

Peer dependencies:

* **⚠️ Upgrade to deck.gl 9.2.0**

### 2025.8.0

*August 8th, 2025*

Bug fixes:

* Fix CJS bundler error by updating transitive dependencies (cpt2js, geodesy-fn) to export dist files with .cjs file extension while keeping ESM default

### 2025.7.2

*July 13th, 2025*

Bug fixes:

* Fix "Image can't be decoded" error by avoiding multiple parallel decodes to hit a memory limit
  * <https://issues.chromium.org/issues/40676514>
* Fix loading GridLayer icons in an insecure context by using the loaded URL as a cache key directly instead of hashing it

### 2025.7.1

*July 6th, 2025*

Bug fixes:

* Fix Grid layer occasionally not displaying interpolated points due to floating-point calculation precision loss

### 2025.7.0

*July 4th, 2025*

Bug fixes:

* Fix bundler error "Module not found: Error: Default condition should be last one" by adding a default package export
* Fix runtime error "TypeError: Cannot read private member from an object whose class did not declare it" by improving compatibility with HMR proxies by using TS private fields instead of ESM private fields
* Fix Particle layer warning "Ignoring buffer for unknown attribute"

### 2025.6.1

*June 7th, 2025*

Bug fixes:

* Wait for image to be loaded before decoding

### 2025.6.0

*June 1st, 2025*

New features:

* Add `gridEnabled` to Raster layer
* Add support for loading data with custom HTTP headers
  * ⚠️ Use an options object as the second argument in `loadTextureData`
  * This loads data with `fetch` as a blob instead of as an image

Bug fixes:

* Fix grid offset for local images

### 2025.5.1

*May 18th, 2025*

Bug fixes:

* Add rollup-plugin-worker-factory to dependencies to avoid a strict bundler error

### 2025.5.0

*May 4th, 2025*

Bug fixes:

* Drop particles by position instead of color, fixes drop detection on Android

### 2025.3.0

*March 3rd, 2025*

New features:

* **⚠️ Open-source, dual-license with MPL**

Minor changes:

* Remove license file check and watermark
* Remove `setLicense` function
* Stop bundling dependencies

Bug fixes:

* Reorder exports by priority, fixes warning with Vite 6

### 2025.1.0

*January 26nd, 2025*

New features:

* Support for MapLibre globe projection
  * Requires MapLibre >= 5.0.0. See <https://github.com/maplibre/maplibre-gl-js/releases/tag/v5.0.0>

Bug fixes:

* Uniform grid point density in all latitudes in globe projection
* Uniform particle speed in all latitudes in globe projection

Peer dependencies:

* **⚠️ Upgrade to deck.gl 9.1.0**

### 2024.9.1

*September 28nd, 2024*

Minor changes:

* Replace uniforms with Uniform Buffer Objects as preparation for deck.gl 9.1
* Repeat the texture for global data, clamp the texture for regional data

### 2024.9.0

*September 22nd, 2024*

Bug fixes:

* Fix nodata detection for float inaccuracy in alpha channel

### 2024.8.2

*August 23rd, 2024*

Bug fixes:

* &#x20;**⚠️ Fix `The provided float value is non-finite.` error in Chrome 128**
  * Versions since 2024.2.0 are affected

### 2024.8.1

*August 20th, 2024*

Minor changes:

* Replace TS enums with string constants for cross-bundle compatibility between `weatherlayers-gl` and `weatherlayers-gl/client`
  * <https://www.totaltypescript.com/books/total-typescript-essentials/deriving-types#using-as-const-for-javascript-style-enums>

### 2024.8.0

*August 11th, 2024*

Minor changes:

* Split `UnitDefinition` interface (with `UnitSystem`) from `UnitFormat` interface (without `UnitSystem`)

Bug fixes:

* Fix basemap flickering during basemap zoom/pan interaction due to ParticleLayer animation in React

Peer dependencies:

* Upgrade to deck.gl 9.0.27

### 2024.7.0

*July 20, 2024*

New features:

* Display progress in Timeline control loader text

Bug fixes:

* Fix HighLow and Grid layer to not calculate points when disabled

### 2024.6.2

*July 2, 2024*

Bug fixes:

* Import optional dependencies with a static import instead of a dynamic import, to prevent Webpack warning "Critical dependency: the request of a dependency is an expression"

### 2024.6.1

*July 1, 2024*

Bug fixes:

* Fix corrupted build (internal dependencies missing in the bundle by mistake)

### 2024.6.0

*June 30, 2024*

Bug fixes:

* Add setLibrary function to set optional dependencies environments which don't support dynamic import
* Make geotiff dependency to be truly optional

Peer dependencies:

* Upgrade to deck.gl 9.0.20

### 2024.5.2

*May 27, 2024*

Minor features:

* Support loading images as data URIs

Bug fixes:

* Remove required `data:` protocol from CSP content-src by loading iconAtlas as images
* Fix LegendControl, TimelineControl interfaces

Peer dependencies:

* Upgrade to deck.gl 9.0.16

### 2024.5.1

*May 11, 2024*

Bug fixes:

* Fix updating Front layer data
* Remove reference to missing sourcemaps

### 2024.5.0

*May 9, 2024*

Bug fixes:

* Fix support for Angular by downgrading to ES2016 target in WebWorkers\
  <https://github.com/angular/angular-cli/issues/22191>

### 2024.4.3

*April 28, 2024*

Bug fixes:

* Fix Particle layer in Safari

Peer dependencies:

* Set geotiff.js as optional

### 2024.4.2

*April 15, 2024*

Bug fixes:

* Fix palette rendering

### 2024.4.1

*April 14, 2024*

Bug fixes:

* Fix basemap flickering during basemap zoom/pan interaction due to ParticleLayer animation in MapLibre/Mapbox interleaved mode
* Fix missing exported TS typings
* Disable unused mipmaps

Peer dependencies:

* Upgrade to deck.gl 9.0.7

### 2024.4.0

*April 3, 2024*

Peer dependencies:

* **⚠️ Upgrade to deck.gl 9.0.4**
  * This drops support for WebGL1 in favour of WebGL2. See <https://deck.gl/docs/whats-new> and <https://deck.gl/docs/upgrade-guide> for upgrading.
  * MapLibre: requires MapLibre >= 3.0.0 if using MapLibre with deck.gl interleaved to support WebGL2. See <https://github.com/maplibre/maplibre-gl-js/releases/tag/v3.0.0>
  * Mapbox: requires Mapbox >= 3.0.0 if using Mapbox with deck.gl interleaved to support WebGL2. See <https://github.com/mapbox/mapbox-gl-js/releases/tag/v3.0.0>
* Update geotiff.js to 2.1.3

### 2024.3.1

*March 29, 2024*

Bug fixes:

* Fix accepting custom `iconBounds` for wind barbs in Grid layer

### 2024.3.0

*March 24, 2024*

New features:

* Add `directionOrigin`, `followCursorOffset`, `followCursorPlacement` to Tooltip control

Minor changes:

* Slow down particles in higher latitudes to make the particle speed constant, generate more particles in higher latitudes to keep the particle density uniform

Bug fixes:

* Fix detecting NaN in Float data, so that they are ignored for rendering

### 2024.2.3

*February 13, 2024*

Minor changes:

* Allow array in `iconSize`, merge `iconSize` and `iconMinSize` in Grid layer
  * ⚠️ Use an array value in `iconSize` instead of `iconMinSize`

### 2024.2.2

*February 12, 2024*

New features:

* Add `iconMinSize` to Grid layer, enables smooth scaled icon sizes
  * ⚠️ Set `iconMinSize` for the original behavior of scaled icon sizes by values

Bug fixes:

* Fix refreshing Grid and HighLow layer properties

### 2024.2.1

*February 8, 2024*

New features:

* Add `majorInterval` to Contour layer
  * ⚠️ Set `majorInterval` to `5 * interval` for the original behavior of every 5th contour line to be a major contour line

### 2024.2.0

*February 6, 2024*

New features:

* Add `palette` to Particle, Contour, Grid, HighLow layers
* Add `imageMinValue` and `imageMaxValue` to Particle, Raster, Contour, Grid, HighLow layers

Minor changes:

* Improve Particle layer performance
  * ⚠️ Use `ClipExtension` to hide particles outside of Mercator bounds
* Merge `getRasterPoints` function arguments to `ImageProperties` type
* Update default colors to remove opacity, prefer separate opacity

Peer dependencies:

* Update deck.gl to 8.9.34
* Update geotiff.js to 2.1.2

### 2024.1.1

*January 23, 2024*

Bug fixes:

* Fix rendering of regional data at left/right bound

### 2024.1.0

*January 14, 2024*

Minor changes:

* Update TooltipControl `followCursor` position origin between value and direction
* Update TooltipControl direction icon

Bug fixes:

* Fix interpolating nodata values at data edges

Peer dependencies:

* Update deck.gl to 8.9.33
* Update geotiff.js to 2.1.1

### 2023.12.1

*December 21, 2023*

New features:

* Add `density` to GridLayer

### 2023.12.0

*December 2, 2023*

New features:

* Add WebP support for custom data
* Enable picking in OpenLayers
* Add `minZoom`, `maxZoom` to all layers
  * ContourLayer has default `maxZoom = 10`. ParticleLayer has default `maxZoom = 15`. Other layers have no default values.
  * It's possible to override a lower default value to a higher value, but rendering artifacts may occur in high zoom levels due to a low precision.

Bug fixes:

* Fix parsing hex colors in RasterLayer palette\
  <https://github.com/weatherlayers/cpt2js/issues/3>
* Fix TooltipControl z-index for Leaflet

### 2023.11.1

*November 3, 2023*

Bug fixes:

* Drop grid points out of bounds

### 2023.11.0

*November 3, 2023*

New features:

* Add direction arrow icon to TooltipControl
* Add `directionFormat` to TooltipControl
* Add `followCursor` to TooltipControl

Peer dependencies:

* Update deck.gl to 8.9.32
* Update geotiff.js to 2.1.0

### 2023.10.3

*October 14, 2023*

New features:

* Enable picking in Mapbox/MapLibre interleaved mode

Bug fixes:

* Fix rendering incorrect nodata pixels in Safari

### 2023.10.2

*October 14, 2023*

Bug fixes:

* Use scoped CSS class names to avoid conflicts with global CSS class names

### 2023.10.1

*October 14, 2023*

Bug fixes:

* Fix basemap flickering due to ParticleLayer animation in MapLibre/Mapbox interleaved mode

Dependencies:

* Update deck.gl to 8.9.31

### 2023.10.0

*October 5, 2023*

New features:

* Add support for single-band Uint8 data format

### 2023.9.0

*September 30, 2023*

Bug fixes:

* Fix disabling layers in MapLibre/Mapbox interleaved mode
* Discard displaying obsolete points in HighLowLayer
* Download GeoTIFF file in a single request

Dependencies:

* Update deck.gl to 8.9.30

### 2023.8.1

*September 5, 2023*

Bug fixes:

* Fix corrupted build (internal dependencies missing in the bundle by mistake)

### 2023.8.0

*September 5, 2023*

Minor changes:

* Add support for license development domains

Bug fixes:

* Fix controls to be clickable when added as MapLibre/Mapbox control

Dependencies:

* Update deck.gl to 8.9.27

### 2023.5.1

*May 21, 2023*

Bug fixes:

* Fix bundling with Webpack

### 2023.5.0

*May 16, 2023*

Minor changes:

* Add loader to TimelineControl
* Add LogoControl

### 2023.4.3

*May 5, 2023*

Bug fixes:

* Fix TimelineControl compatibility with older browsers

### 2023.4.2

*May 4, 2023*

Minor changes:

* Add `fps` config property to TimelineControl

### 2023.4.1

*May 4, 2023*

Bug fixes:

* Fix TimelineControl compatibility with older browsers

### 2023.4.0

*April 30, 2023*

New features:

* Add `getRasterPoints` function to get raster points for the given positions

Minor changes:

* Add `offsetDatetime` and `offsetDatetimeRange` functions to add hours to the given datetime
* Remove unused `loadText` function

Bug fixes:

* Verify that the library is deployed on a secure origin
* Verify that the license has an expected type before verifying the signature
* Log image URL if image decoding fails

Dependencies:

* Update deck.gl to 8.9.9

### 2023.3.4

*April 4, 2023*

Bug fixes:

* Fix broken build

### 2023.3.3

*April 4, 2023*

Bug fixes:

* Fix browser crash when ESM build is used with Vite

Dependencies:

* Update deck.gl to 8.9.6

### 2023.3.2

*March 31, 2023*

Minor changes:

* Update selected datetime in TimelineControl when updating the datetime from outside
* Add `pause` and `reset` methods to TimelineControl
* Add `datetimeFormatFunction` to TimelineControl
* Add `DatetimeISOString` type

### 2023.3.1

*March 31, 2023*

Minor changes:

* Optimize bundle size

Bug fixes:

* Update package exports to expose a default export for TS moduleResolution = node and unpkg.com
* Update TS typings to enable arbitrary layer props such as layer extensions

### 2023.3.0

*March 29, 2023*

New features:

* Publish as npm package
  * Install the library with `npm install weatherlayers-gl`
  * Use the library with `import WeatherLayers from 'weatherlayers-gl'`
* Update licensing approach to a separate `license.json` file
  * [Contact us](mailto:support@weatherlayers.com) to receive your license file
  * Provide the license file to the library with `WeatherLayers.setLicense(license)`
* Migrate to TypeScript
  * Typing files are provided as part of the distribution package
* Add [Front layer](/weatherlayers-gl/layers/front-layer.md)

Minor changes:

* Add `image2`, `imageSmoothing` and `imageWeight` to HighLow layer
* Improve HighLow layer performance when zooming in/out
* Add `toggle`, `start`, `stop`, `stepBackward` and `stepForward` methods to TimelineControl

Bug fixes:

* Prefer default values over provided `undefined` values
* Remove references to `worker_threads` Node dependency

Peer dependencies:

* Update deck.gl to 8.9.4

### 2023.2.1

*March 20, 2023*

Bug fixes:

* Remove references to `worker_threads` Node dependency

### 2023.2.0

*February 16, 2023*

New features:

* Add cubic interpolation for smoother visualization\
  Rename `imageInterpolate` data property to `imageInterpolation`, change type from boolean to enum\
  Add `imageSmoothing` data property

Bug fixes:

* Fix parsing palettes with values in scientific notation\
  <https://github.com/weatherlayers/cpt2js/issues/2>
* Clamp to edge data on poles

### 2022.11.0

*November 17, 2022*

Minor changes:

* Add `unitFormat` to Grid and HighLow layer for consistent value formatting across layers and controls
* Add [Load Functions](/weatherlayers-gl/functions.md#load-functions) for loading custom data

### 2022.10.0

*October 14, 2022*

New features:

* Add [Controls](/weatherlayers-gl/controls.md)

Bug fixes:

* Fix Particle layer to drop particles out of bounds, to support regional vector data\
  <https://github.com/weatherlayers/deck.gl-particle/issues/10>

Minor changes:

* Rename HighLow and Grid layer `textFunction` style property to `textFormatFunction`

Peer dependencies:

* Update deck.gl to 8.8.4

### 2022.6.0

*July 8, 2022*

New features:

* Add [Contour layer](/weatherlayers-gl/layers/contour-layer.md) computed on GPU for animation support\
  Replace previous Contour layer computed on CPU

Bug fixes:

* Fix half-pixel data rendering misalignment

Minor changes:

* Remove deprecated Raster layer `colormapBreaks` style property, use `palette` instead
* [Demo](https://demo.weatherlayers.com/) - separate overlaid and interleaved demos

Peer dependencies:

* Update deck.gl to 8.8.2

### 2022.5.0

*June 3, 2022*

New features:

* Add support for color palette text format\
  Deprecate raster layer `colormapBreaks` style property, use `palette` instead\
  <https://github.com/weatherlayers/cpt2js>[\
  https://github.com/stac-extensions/raster/issues/17](https://github.com/stac-extensions/raster/issues/17)\
  <https://github.com/radiantearth/stac-spec/pull/1181>

### 2022.4.0

*May 11, 2022*

New features:

* Use [Calendar Versioning](https://calver.org/)
* Add [Grid layer](/weatherlayers-gl/layers/grid-layer.md)

Bug fixes:

* Fix particle layer breaking in deck.gl auto-offset mode at zoom >= 12 on Mac M1\
  <https://github.com/weatherlayers/deck.gl-particle/issues/5>
* Fix raster layer opacity with Google Maps vector basemap\
  <https://github.com/visgl/deck.gl/issues/6296>\
  <https://github.com/visgl/deck.gl/pull/6804>
* Fix raster layer disappearing in deck.gl auto-offset mode at zoom >= 12\
  <https://github.com/visgl/deck.gl/issues/6798>\
  <https://github.com/visgl/deck.gl/pull/6801>

Minor changes:

* [Demo](https://demo.weatherlayers.com/) - add standalone demos without deck.gl (experimental)

Peer dependencies:

* Update deck.gl to 8.7.5