npm · #4479 most downloaded on npm

@maplibre/maplibre-gl-style-spec

26.4.4maplibre/maplibre-style-spec ↗New releases in your daily digest, changelog included.

a specification for maplibre styles

Last release 19 days ago
15 Sep 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
92 releases · first in 2021

Release timeline

92 releases since 2021

202120222023202420252026

20212026

One column per quarter.

Releases

26.4.415 Sept 20262 sources agree
Fix semiliteral parsing in array-valued properties and at operands, and report invalid children at their nested expression locations instead of throwi
🐞 Bug fixes

Fix semiliteral parsing in array-valued properties and at operands, and report invalid children at their nested expression locations instead of throwing (#1878)

Order the setTerrain diff command around the source commands, so terrain is set after its source is added and unset before it is removed (#1879)
Open source →
26.4.314 Sept 20262 sources agree
Tighten the diff command types: DiffCommand is now a discriminated union, so a switch on command narrows args , and the unused legacy class argument w
✨ Features and improvements

Tighten the diff command types: DiffCommand is now a discriminated union, so a switch on command narrows args, and the unused legacy class argument was dropped from setPaintProperty and setLayoutProperty (#1876) (by @HarelM)

26.4.28 Sept 20262 sources agree

Allow negative fill-extrusion-base and fill-extrusion-height values, extruding below ground level (e.g. underground floors) ( #1794 ) (by @clement-igo

✨ Features and improvements

Allow negative fill-extrusion-base and fill-extrusion-height values, extruding below ground level (e.g. underground floors) (#1794) (by @clement-igonet)
Add SDK support tracking for SDF fill pattern colorization (#1854) (by @deniial00)

🐞 Bug fixes

Validate -transition properties on sky the same way light already does, so sky-color-transition and similar keys no longer report as unknown properties (#1867) (by @Yasser-Ameur)

Open source →

26.4.125 Aug 20262 sources agree

Publish the ESM build ( dist/index.mjs , referenced by package.json#module ) as one module per source file instead of a single bundle, so that bundler

✨ Features and improvements

Publish the ESM build (dist/index.mjs, referenced by package.json#module) as one module per source file instead of a single bundle, so that bundlers which eliminate dead code at module granularity can drop unused parts of the package (#1829) (by @ahocevar)

🐞 Bug fixes

Fix validation and typescript types for font-faces (#1840) (by @HarelM)

Open source →

26.4.024 Aug 20262 sources agree

Enable data-driven icon-rotation-alignment ( #1836 ) (by @Turbo87 )

✨ Features and improvements

Enable data-driven icon-rotation-alignment (#1836) (by @Turbo87)
Make url optional for image sources. An image source can now be defined with only type and coordinates; it renders nothing until an image is set at runtime (#1817)

🐞 Bug fixes

Fix missing setFontFaces operation when style changes (#1837) (by @HarelM)

Open source →

26.3.024 Aug 20262 sources agree

Add semiliteral operator for expressions inside arrays and objects ( #951 ) (by @sargunv )

✨ Features and improvements

Add semiliteral operator for expressions inside arrays and objects (#951) (by @sargunv)
Add symbol-height-offset and symbol-height-anchor properties to symbol layers to allow icons and text to be elevated above the ground (#1508) (by @HatulaPro)

Open source →

26.2.123 Jul 20262 sources agree

Fix fill-extrusion-rounded-corner-distance being documented as an paint instead of an layout property as implemnented ( #1784 ) (by @CommanderStorm )

✨ Features and improvements

🐞 Bug fixes

Fix fill-extrusion-rounded-corner-distance being documented as an paint instead of an layout property as implemnented (#1784) (by @CommanderStorm)

Open source →

26.2.023 Jul 20262 sources agree

Add fill-extrusion-rounded-corner-distance ( #1781 , #1782 ) (by @louwers )

✨ Features and improvements

Add fill-extrusion-rounded-corner-distance (#1781, #1782) (by @louwers)

🐞 Bug fixes

Support global-state (and other value-typed) expressions in projectionDefinition properties such as projection.type (#1772) (by @CommanderStorm)

Open source →

26.1.014 Jul 20262 sources agree

Add v8.json types called StyleSpecificationReference ( #1767 ) (by @HarelM )

✨ Features and improvements

Add v8.json types called StyleSpecificationReference (#1767) (by @HarelM)

🐞 Bug fixes

Fix index.d.ts file wrong json import (#1767) (by @HarelM)
Restore missing interpolationType, globalStateRefs and isStateDependent fields on legacy stop functions (#1768) (by @HarelM)

Open source →

26.0.012 Jul 2026

Add a severity field to ValidationError . It is only set on non-fatal findings ( "warning" ); an absent severity still means "error" , so existing con

✨ Features and improvements

Add a severity field to ValidationError. It is only set on non-fatal findings ("warning"); an absent severity still means "error", so existing consumers are unaffected (#1751) (by @HarelM)
⚠️ Allow debugging runtime warnings by attaching location of an warning and what will happen (#1740) (by @CommanderStorm)

🐞 Bug fixes

Stop reporting pure legacy filters as mixed legacy/expression syntax. ["has", key] means the same thing in both syntaxes for example (#1751) (by @HarelM)
Stop mixed-filter diagnostics from blanking the whole map (#1751) (#1752) (by @HarelM)

Open source →

Additional notes

✨ Features and improvements

Add a severity field to ValidationError and imporve legacy filter recognition (#1752) (by @HarelM)
⚠️ Allow debugging runtime warnings by attaching location of an warning and what will happen (#1740) (by @CommanderStorm)

Open source →

25.0.27 Jul 20262 sources agree

Remove rollup dependencies and a stale replace for jsonlint ( #1749 ) (by @HarelM )

✨ Features and improvements

Remove rollup dependencies and a stale replace for jsonlint (#1749) (by @HarelM)

Open source →

25.0.129 Jun 20262 sources agree

has filter now returns false when a property exists but is set to undefined ( #1712 ) (by @xavierjs )

🐞 Bug fixes

has filter now returns false when a property exists but is set to undefined (#1712) (by @xavierjs)
Fix incorrect replacement suggestion in error messages for mixed legacy+expression $type filters (#1727, #1728) (by @ciscorn)

Open source →

25.0.015 Jun 20262 sources agree

⚠️ Change legacy filter expression validation to add suggestions on invalid expressions ( #1709 ) (by HarelM )

✨ Features and improvements

⚠️ Change legacy filter expression validation to add suggestions on invalid expressions (#1709) (by HarelM)
Allow global state expressions in fill-layer-opacity and line-layer-opacity. (#1699) (by @CommanderStorm)

Open source →

24.10.08 Jun 20262 sources agree

Added {line,fill}-layer-opacity paint property. It applies opacity to the whole layer as a whole layer so overlapping features change in an uniform wa

✨ Features and improvements

Added {line,fill}-layer-opacity paint property. It applies opacity to the whole layer as a whole layer so overlapping features change in an uniform way. (#1650) (by @CommanderStorm)

Open source →

24.9.07 Jun 20262 sources agree

Allow fill-color when fill-pattern is set, for SDF fill pattern colorization (#1683) (by @bradymadden97)

✨ Features and improvements

Allow fill-color when fill-pattern is set, for SDF fill pattern colorization (#1683) (by @bradymadden97)

🐞 Bug fixes

Resolve ["global-state", key] to null instead of undefined when the key is unset but other global state keys are set (#1531) (by @SAY-5)

Open source →

24.8.55 May 20262 sources agree

Added missing exported types (#1638) (by @scottg521)

🐞 Bug fixes

Added missing exported types (#1638) (by @scottg521)

Open source →

24.8.45 May 20262 sources agree

Replace rw with node:fs. Resolves #1625 (#1635) (by @birkskyum)

✨ Features and improvements

🐞 Bug fixes

Replace rw with node:fs. Resolves #1625 (#1635) (by @birkskyum)

Open source →

24.8.33 May 20262 sources agree

Restore Specification type exports dropped in v24.8.2 (#1627) (by @birkskyum)

🐞 Bug fixes

Restore Specification type exports dropped in v24.8.2 (#1627) (by @birkskyum)

Open source →

24.8.21 May 20262 sources agree

Move from rollup->rolldown and ts6->ts7 for builds/typecheck. (#1132) (by birkskyum)

✨ Features and improvements

Move from rollup->rolldown and ts6->ts7 for builds/typecheck. (#1132) (by birkskyum)

Open source →

24.8.13 Apr 20262 sources agree

Add AllPaintProperties and AllLayoutProperties typescript definitions (#1579) (by @CommanderStorm)

✨ Features and improvements

Add AllPaintProperties and AllLayoutProperties typescript definitions (#1579) (by @CommanderStorm)
Update TS definitions to allow var as the 3rd arg of comparator functions (#1564) (by k-yle)

🐞 Bug fixes

Fix get expression inside join expression (#1583) (by 1ec5)

Open source →

24.8.02 Apr 20262 sources agree

Enable data driven stylng for line-{cap,round-limit,miter-limit} (#1566) (by @CommanderStorm)

✨ Features and improvements

Enable data driven stylng for line-{cap,round-limit,miter-limit} (#1566) (by @CommanderStorm)

Open source →

24.7.08 Mar 20262 sources agree

Validate that raster layers do not specify both resampling and raster-resampling paint properties (#1532) (by larsmaxfield)

✨ Features and improvements

Validate that raster layers do not specify both resampling and raster-resampling paint properties (#1532) (by larsmaxfield)

Open source →

24.6.026 Feb 20262 sources agree

Add split and join expressions (#1518) (by 1ec5)

✨ Features and improvements

Add split and join expressions (#1518) (by 1ec5)

Open source →

24.5.023 Feb 20262 sources agree

Add "unit" option to "number-format" (#1335) (by ginnyTheCat)

✨ Features and improvements

Add "unit" option to "number-format" (#1335) (by ginnyTheCat)
Add resampling paint property to raster, hillshade, and color relief layers (#1447) (by larsmaxfield)
Include 'transparent' as a permitted color name (#1442) (by zstadler)
Migrate docs to zensical (#1394) (by CommanderStorm)

Open source →

24.4.115 Dec 20252 sources agree

Consolidate workflows (#1423) (by HarelM)

✨ Features and improvements

Consolidate workflows (#1423) (by HarelM)

Open source →

24.4.010 Dec 2025

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.3.1:

✨ Features and improvements

Allow global state expressions in layer visibility (#1364)
Only alert to an unknown or required object-properties being undefined instead of any object-property being undefined (#1415)

🐞 Bug fixes

The optional center property is now validated to be a [lon,lat] array (#1372)

Open source →

Additional notes

✨ Features and improvements

Update Node.js to 24.11 (#1418)
Allow global state expressions in layer visibility (#1364)
Only alert to an unknown or required object-properties being undefined instead of any object-property being undefined (#1415)

🐞 Bug fixes

The optional center property is now validated to be a [lon,lat] array (#1372)

Open source →

24.3.130 Oct 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.3.0:

🐞 Bug fixes

The validator no longer fails if the style lacks a glyphs property (#1347)

Open source →

24.3.015 Oct 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.2.0:

✨ Features and improvements

Add optional encoding property to vector source to allow for MapLibre Tile vector sources

Open source →

24.2.027 Sept 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.1.1:

✨ Features and improvements

Add note regarding visual artifacts that can appear with large width/size/offset values on vector tile layers, highlight remediation options (#4160)
Implement data-driven styling support for line-dasharray (#5812)

🐞 Bug fixes

Replace additional spread operator (...) due to esbuild limitations (#1297)

Open source →

Additional notes

Compare

Open source →

24.1.119 Sept 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.1.0:

🐞 Bug fixes

Replace spread operator (...) due to esbuild limitations (#1286)

Open source →

24.1.015 Sept 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.0.0:

✨ Features and improvements

Added global-state parameter to featureFilter function (#1279)

Open source →

24.0.012 Sept 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.3.0:

✨ Features and improvements

⚠️ Change passing global-state to expression from the evaluate function to the constructor (#1267) - you can add an empty object for global state to overcome this.

🐞 Bug fixes

Open source →

23.3.017 May 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.3:

✨ Features and improvements

Add new layer type: `color-relief (#1067)

🐞 Bug fixes

Add missing global-state expression typing (#1130)

Open source →

23.2.313 May 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.2:

✨ Features and improvements

Restructure expression syntax documentation (#1112)
Add global state ref support (#1120)

Open source →

23.2.230 Apr 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.1:

🐞 Bug fixes

Fix state validation - no error case (#1109)

Open source →

23.2.123 Apr 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.0:

🐞 Bug fixes

Validate that numberArray and colorArray values are non-empty (#1094)

Open source →

23.2.022 Apr 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.1.0:

✨ Features and improvements

glyphs is now optional even if a symbol layer specifies text-field; if it is unset, text-font is interpreted as a fallback font list (#1068)
hillshade layer now supports multiple methods, and the multidirectional method supports array values for illumination properties (#1088)
Add global-state expression and state root property (#1044).

🐞 Bug fixes

Fix RuntimeError class, make it inherited from Error (#983)
Validate that layers array items are objects instead of throwing an error if not (#1026)
Multiple fixes related to validating and parsing of strings containing object prototype keys
- Fix validate_object crashing when object prototype keys used in style's objects (#1028)
- Fix validate_color crashing when object prototype keys used as color strings (#1036)
- Fix color coercion in expressions (e.g. to_color) producing invalid colors when object prototype keys used as color strings (#1036)

Open source →

23.1.014 Jan 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.0.0:

✨ Features and improvements

Add vertical-align option to format expression (#832)

Open source →

23.0.012 Jan 20252 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v22.0.1:

✨ Features and improvements

Adjust geometry-type expression specification and MapLibre GL JS implementation to the historic behavior of only returning Point, LineString or Polygon, not the Multi... variants of these. This reverts a recent change to the implementation, which was causing issues in a large number of styles.

Open source →

22.0.128 Nov 2024

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v22.0.0:

🐞 Bug fixes

Fix issue with geomtry-type filter (#924)

Open source →

Additional notes

🐞 Bug fixes

~~Fix issue with geomtry-type filter (#924)~~ This was reverted in 23.0.0 due to causing issues in a large number of styles.

Open source →

22.0.017 Nov 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v21.2.0:

✨ Features and improvements

Use named imports internally - no package entrypoints changed (#904)
Add projection type expression syntax (#888)

Open source →

21.2.08 Nov 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v21.1.0:

✨ Features and improvements

Add vertical-perspective projection (#890)

Open source →

21.1.031 Oct 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v21.0.0:

✨ Features and improvements

Added centerAltitude property to stylesheet (#851)

Open source →

21.0.022 Oct 2024

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.4.0:

✨ Features and improvements

Aligned the implementation of ["geometry-type"] with its spec. Now, when applicable, ["geometry-type"] returns values not available while using "$type": "MultiPoint", "MultiLineString", and "MultiPolygon". The behaviour of "$type" has not changed. (#519)

Open source →

Additional notes

✨ Features and improvements

Aligned the implementation of ["geometry-type"] with its spec. Now, when applicable, ["geometry-type"] returns values not available while using "$type": "MultiPoint", "MultiLineString", and "MultiPolygon". The behaviour of "$type" has not changed. (#519) This was reverted in 23.0.0 due to causing issues in a large number of styles.

Open source →

20.4.016 Oct 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.3.1:

✨ Features and improvements

Added roll property to stylesheet (#850)

Open source →

20.3.117 Aug 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.3.0:

🐞 Bug fixes

The index-of, length, and slice expression operators count a UTF-16 surrogate pair as a single character. (#779)

Open source →

20.3.031 May 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.2.0:

✨ Features and improvements

Added Projection specifications #687
Updated Sky specifications to support atmosphere and other required features #686

🐞 Bug fixes

Change assert to with in JSON modules. Requires Node.js 18.20.0 or later, and supports Node.js 22.0.0 or later - #675

Open source →

20.2.04 May 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.1.1:

✨ Features and improvements

Support distance expression in web style spec - #642

Open source →

20.1.14 Feb 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.1.0:

🐞 Bug fixes

Add missing sky in diff results #518

Open source →

20.1.011 Jan 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.0.0:

✨ Features and improvements

Add latest.json to dist folder to allow using the full version of the spec #490

Open source →

20.0.09 Jan 20242 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.3:

✨ Features and improvements

Add back migrate, validate and format to the exported methods of this package #464
Add terrain to diff method and improve type. This also removes the operations from the API #460
Improve the type of data in the GeoJSONSourceSpecification for TypeScript #463.
Add expression tests to this repo #476
Add Sky spec, this is only the definition, no implementation at this point, only validation #478

🐞 Bug fixes

Fix queryRenderedFeatures Within a FeatureCollection of polygons #477

Open source →

19.3.320 Oct 2023

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.2:

Improve types for feature to include unknown #365
Improve sprite documentation and supported versions #390

Open source →

Additional notes

✨ Features and improvements

Improve types for feature to include unknown #365
Improve sprite documentation and supported versions #390

Open source →

19.3.227 Sept 2023

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.1:

Add raster dem source redFactor, greenFactor, blueFactor, baseShift properties #326
Improve error messages around hillshade layers not using raster-dem sources #353

Open source →

Additional notes

✨ Features and improvements

Add raster dem source redFactor, greenFactor, blueFactor, baseShift properties #326
Improve error messages around hillshade layers not using raster-dem sources #353

Open source →

19.3.113 Sept 2023

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.0:

Document raster-fade-duration property's effect on rendering a video. #297
Add and expose isZoomExpression. #267

Open source →

Additional notes

✨ Features and improvements

Document raster-fade-duration property's effect on rendering a video. #297
Add and expose isZoomExpression. #267

Open source →

19.3.019 Jul 20232 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.2.2:

✨ Features and improvements

Add style property definition and validation for symbol layer text-variable-anchor-offset layout property. #112

Open source →

19.2.211 Jul 20232 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.2.1:

✨ Features and improvements

Trim css color before parsing #255

Open source →

19.2.126 May 20232 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.2.0:

✨ Features and improvements

Skip running color match regex for hex color or rgb, if not required #186

Open source →

19.2.022 May 20232 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.1.0:

✨ Features and improvements

Remove mapbox reference from docs and test cases #111
Custom CSS Color 4 compliant css color parser #175

Open source →

19.1.030 Apr 20232 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.0.1:

✨ Features and improvements

Use D50 white point instead of D65 in HCL/LAB color spaces #146
Automated migration of not-CSS-Color-specification-compliant hsl color values #135

Open source →

19.0.117 Apr 20232 sources agree

https://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.0.0:

🐛 Bug fixes

Restore support for Color instances in Color.parse #128

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →