global-state expression support in filter and paint properties (#5613)

* add global-state expression support

* set global state on style load

* use forked spec

* temporarily build in prepare step

* temporary build fix

* fix unit tests

* test setGlobalState

* add setGlobalStateProperty

* add getGlobalState

* jsdoc

* update to support schema

* validate style fixes

* use exported types

* remove validation

* cleanout

* update filter evaluation in all layer types

* cleanout

* use style spec fork, fix worker transfer

* cleanout

* tests & fixes

* fixes + example

* minor fixes

* update CHANGELOG

* review fixes

* review fixes

* fix tests

* add global state diff

* include optional sharp dependencies

* full diff implementation, example fixes

* fix spellcheck

* update bundle size test

* review fixes

* review fix

* review fixes

* fix types

* update tests

* use latest spec

* _setGlobalState -> setGlobalState

* more tests

* ensure 100% coverage for new style methods

Author: zbigniewmatysek-tomtom

CHANGELOG.md

@@ -1,7 +1,7 @@
 ## main
 
 ### ✨ Features and improvements
-
+- Add `setGlobalStateProperty()` and `getGlobalState()` to the map public API ([#5613](https://github.com/maplibre/maplibre-gl-js/pull/5613))
 - _...Add new stuff here..._
 
 ### 🐞 Bug fixes

docs/assets/examples/filter-symbols-using-global-state.png

@@ -0,0 +1,103 @@
+{
+  "type": "FeatureCollection",
+  "features": [
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funivia Pani d\"Erna",
+              "type": "lift"
+          },
+          "geometry": {
+              "coordinates": [
+                  9.428832133068624,
+                  45.86316915700536
+              ],
+              "type": "Point"
+          }
+      },
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funicolare Como-Brunate",
+              "type": "railway"
+          },
+          "geometry": {
+              "coordinates": [
+                  9.082724408221196,
+                  45.8175517969448
+              ],
+              "type": "Point"
+          },
+          "id": 1
+      },
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funivia Pigra Argegno",
+              "type": "lift"
+          },
+          "geometry": {
+              "coordinates": [
+                  9.129994484478942,
+                  45.94660892078414
+              ],
+              "type": "Point"
+          }
+      },
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funicolare Sacro Monte",
+              "type": "railway"
+          },
+          "geometry": {
+              "coordinates": [
+                  8.787919643563527,
+                  45.85848217923672
+              ],
+              "type": "Point"
+          }
+      },
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funicolare Cassarate Monte Brè",
+              "type": "railway"
+          },
+          "geometry": {
+              "coordinates": [
+                  8.970232317680455,
+                  46.00646782864027
+              ],
+              "type": "Point"
+          }
+      },
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funicolare Monte San Salvatore"
+          },
+          "geometry": {
+              "coordinates": [
+                  8.945347867434748,
+                  45.990386744943265
+              ],
+              "type": "Point"
+          }
+      },
+      {
+          "type": "Feature",
+          "properties": {
+              "name": "Funivia Monte Lema",
+              "type": "lift"
+          },
+          "geometry": {
+              "coordinates": [
+                  8.856229999561407,
+                  46.0237566800011
+              ],
+              "type": "Point"
+          }
+      }
+  ]
+}

docs/assets/funicolares-and-funivias-como.json

@@ -94,6 +94,6 @@ Note too that if the CSS isn't available by the first render, as soon as the CSS
 MapLibre GL JS is also distributed via UNPKG. Our latest version can installed by adding below tags this in the html `<head>`. Further instructions on how to select specific versions and semver ranges can be found on at [unpkg.com](https://unpkg.com).
 
 ```html
-<script src="https://unpkg.com/maplibre-gl@^5.4.0/dist/maplibre-gl.js"></script>
-<link href="https://unpkg.com/maplibre-gl@^5.4.0/dist/maplibre-gl.css" rel="stylesheet" />
+<script src="https://unpkg.com/maplibre-gl@^5.5.0/dist/maplibre-gl.js"></script>
+<link href="https://unpkg.com/maplibre-gl@^5.5.0/dist/maplibre-gl.css" rel="stylesheet" />
 ```