improve docs

Author: zbigniewmatysek-tomtom

build/generate-docs.ts

@@ -20,7 +20,7 @@ type JsonSdkSupport = {
 type JsonObject = {
     required?: boolean;
     units?: string;
-    default?: string | number | boolean;
+    default?: string | number | boolean | {};
     type: string;
     doc: string;
     requires?: any[];
@@ -227,7 +227,7 @@ function convertPropertyToMarkdown(key: string, value: JsonObject, keyPrefix = '
         markdown += `Units in ${value.units}. `;
     }
     if (value.default !== undefined) {
-        markdown += `Defaults to \`${value.default}\`. `;
+        markdown += `Defaults to \`${JSON.stringify(value.default)}\`. `;
     }
     if (value.requires) {
         markdown += requiresToMarkdown(value.requires);

src/reference/v8.json

@@ -100,7 +100,7 @@
     "state": {
       "type": "*",
       "default": {},
-      "doc": "The initial state of the style. This object is a set of key-value pairs. The state key must be a string. The value can be an expression or primitive type. State values can be retrieved with the [`global-state`](https://maplibre.org/maplibre-style-spec/expressions/#global-state) expression.",
+      "doc": "The initial state of the style. This object is a set of key-value pairs. The state key must be a string. The value can be an expression or primitive type. State values can be retrieved with the [`global-state`](https://maplibre.org/maplibre-style-spec/expressions/#global-state) expression.\n\nThis property is required if any layer uses the `global-state` expression.",
       "example": {
         "mode": "light",
         "prioritizedPoiCategories": ["food", "drink"]
@@ -3303,7 +3303,7 @@
         }
       },
       "global-state": {
-        "doc": "Retrieves a property value from the global state. Returns null if the requested property is missing.\n\n - [Setting global state](https://maplibre.org/maplibre-gl-js/docs/examples/global-state/)",
+        "doc": "Retrieves a property value from the [state](https://maplibre.org/maplibre-style-spec/root/#state) property. Default values must be defined in the `state` property.\n\n - [Setting global state](https://maplibre.org/maplibre-gl-js/docs/examples/global-state/)",
         "group": "Lookup",
         "example": {
           "syntax": {