Changelog

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:

• ⚠️ 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 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

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 for loading custom data

2022.10.0

October 14, 2022

New features:

• Add Controls

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 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 - 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/radiantearth/stac-spec/pull/1181

2022.4.0

May 11, 2022

New features:

• Use Calendar Versioning
• Add Grid layer

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 - add standalone demos without deck.gl (experimental)

Peer dependencies:

• Update deck.gl to 8.7.5