@mapbox/mapbox-gl-style-spec 14.15.0-beta.1 → 14.15.0

package/reference/v8.json

@@ -1315,6 +1315,108 @@
       }
     }
   },
+  "modelNodeOverride": {
+       "orientation": {
+         "type": "array",
+         "value": "number",
+         "length": 3,
+         "default": [0, 0, 0],
+         "period": 360,
+         "units": "degrees",
+         "doc": "Override the orientation of the model node in euler angles [x, y, z]."
+       }
+  },
+  "modelNodeOverrides": {
+    "*": {
+       "type": "modelNodeOverride",
+       "doc": "An object defining model node properties to override. Object key is the node name as defined in the model."
+    }
+  },
+  "modelMaterialOverride": {
+    "model-color": {
+      "type": "color",
+      "doc": "Override the tint color of the material."
+    },
+    "model-color-mix-intensity": {
+      "type": "number",
+      "doc": "Override the intensity of model-color (on a scale from 0 to 1) in color mix with original 3D model's colors."
+    },
+    "model-opacity": {
+      "type": "number",
+      "doc": "Override the opacity of the material."
+    },
+    "model-emissive-strength": {
+      "type": "number",
+      "units": "intensity",
+      "doc": "Override strength of the emission of material."
+    }
+  },
+  "modelMaterialOverrides": {
+    "*": {
+       "type": "modelMaterialOverride",
+        "doc": "An object defining material properties to override. Object key is the material name as defined in the model."
+    }
+  },
+  "modelSourceModel": {
+      "uri": {
+        "type": "string",
+        "required": true,
+        "doc": "A URL to a model resource. Supported protocols are `http:`, `https:`, and `mapbox://<Model ID>`."
+      },
+      "position": {
+        "type": "array",
+        "value": "number",
+        "length": 2,
+        "required": false,
+        "default": [0,0],
+        "minimum": [-180, -90],
+        "maximum": [180, 90],
+        "doc": "Position of the model in longitude and latitude [lng, lat]."
+      },
+      "orientation": {
+        "type": "array",
+        "value": "number",
+        "length": 3,
+        "required": false,
+        "default": [0,0,0],
+        "period": 360,
+        "units": "degrees",
+        "doc": "Orientation of the model in euler angles [x, y, z]."
+      },
+      "nodeOverrides": {
+        "type": "modelNodeOverrides",
+        "required": false,
+        "doc": "A collection of node overrides."
+      },
+      "materialOverrides": {
+        "type": "modelMaterialOverrides",
+        "required": false,
+        "doc": "A collection of material overrides."
+      },
+      "nodeOverrideNames": {
+        "type": "array",
+        "value": "string",
+        "doc" : "An array of one or more model node names whose transform will be overridden from model layer paint properties.",
+        "required": false
+      },
+      "materialOverrideNames": {
+        "type": "array",
+        "value": "string",
+        "doc" : "An array of one or more model material names whose properties will be overridden from model layer paint properties.",
+        "required": false
+      },
+      "featureProperties": {
+        "type": "*",
+        "doc": "An object defining custom properties of the model. Properties are accessible as feature properties in expressions.",
+        "required": false
+      }
+  },
+  "modelSourceModels": {
+    "*": {
+       "type": "modelSourceModel",
+       "doc": "A 3D model and its properties."
+    }
+  },
   "source_model" : {
     "type": {
       "required": true,
@@ -1342,7 +1444,11 @@
     "tiles": {
       "type": "array",
       "value": "string",
-      "doc": "An array of one or more tile source URLs, as in the TileJSON spec."
+      "doc": "An array of one or more tile source URLs, as in the TileJSON spec. Requires `batched-model` source type."
+    },
+    "models": {
+      "type": "modelSourceModels",
+      "doc": "Defines properties of 3D models in collection. Requires `model` source type."
     }
   },
   "layer": {
@@ -1417,6 +1523,9 @@
         "building": {
           "doc": "A procedural 3D building.",
           "sdk-support": {
+            "js": "3.16.0",
+            "android": "11.16.0",
+            "ios": "11.16.0"
           },
           "experimental": true,
           "private": true
@@ -1564,12 +1673,25 @@
   },
   "appearance": {
     "condition": {
-      "type": "expression",
-      "doc": "A boolean expression that determines when this appearance should be applied."
+      "type": "boolean",
+      "doc": "A boolean expression that determines when this appearance should be applied.",
+      "expression": {
+        "interpolated": false,
+        "parameters": [
+          "zoom",
+          "pitch",
+          "feature",
+          "feature-state",
+          "measure-light",
+          "distance-from-center"
+        ]
+      },
+      "property-type": "data-driven"
     },
     "name": {
       "type": "string",
-      "doc": "Optional name for this appearance. Non-empty names should be unique within a layer."
+      "doc": "Optional name for this appearance. Non-empty names should be unique within a layer.",
+      "property-type": "constant"
     },
     "properties": {
       "type": "*",
@@ -2051,6 +2173,9 @@
       "doc": "Whether this layer is displayed.",
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -2066,8 +2191,14 @@
       "private": true,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         },
         "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -2087,8 +2218,46 @@
       "experimental": true,
       "property-type": "data-driven",
       "sdk-support": {
-        "basic functionality": {},
-        "data-driven styling": {}
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        },
+        "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      },
+      "expression": {
+        "interpolated": false,
+        "parameters": [
+          "feature"
+        ]
+      },
+      "requires": [
+        "building-facade"
+      ]
+    },
+    "building-facade-unit-width": {
+      "type": "number",
+      "minimum": 1.0,
+      "maximum": 20.0,
+      "default": 3.1,
+      "doc": "Width of a floor. Think of this as measure how wide each unit should be. This effectively determines the number of units per each floor. Note that this does not affect the ground level facades (i.e. number of windows).",
+      "experimental": true,
+      "property-type": "data-driven",
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        },
+        "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
       },
       "expression": {
         "interpolated": false,
@@ -2107,12 +2276,20 @@
       "minimum": 0.1,
       "maximum": 1.0,
       "default": [0.9, 0.9],
-      "doc": "Given as fractions, specifies the percentage of floor area covered by windows when building-facade is enabled",
+      "doc": "Given as fractions, specifies the percentage of unit area covered by windows when building-facade is enabled. Note that the area of a unit is ultimately determined by `building-facade-unit-width` and `building-facade-floors`.",
       "experimental": true,
       "property-type": "data-driven",
       "sdk-support": {
-        "basic functionality": {},
-        "data-driven styling": {}
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        },
+        "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
       },
       "expression": {
         "interpolated": false,
@@ -2155,8 +2332,14 @@
       "private": true,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         },
         "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -2178,8 +2361,14 @@
       "private": true,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         },
         "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -2201,14 +2390,114 @@
       "private": true,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         },
         "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
         "interpolated": false
       },
       "property-type": "data-driven"
+    },
+    "building-flood-light-wall-radius": {
+      "property-type": "data-driven",
+      "type": "number",
+      "experimental": true,
+      "units": "meters",
+      "default": 0,
+      "minimum": 0,
+      "doc": "The extent of the flood light effect on the walls of the buildings in meters.",
+      "requires": [
+        "lights"
+      ],
+      "transition": true,
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "feature",
+          "feature-state"
+        ]
+      },
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        },
+        "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      }
+    },
+    "building-flood-light-ground-radius": {
+      "property-type": "data-driven",
+      "type": "number",
+      "experimental": true,
+      "units": "meters",
+      "default": 0,
+      "doc": "The extent of the flood light effect on the ground beneath the buildings in meters.",
+      "requires": [
+        "lights"
+      ],
+      "transition": true,
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "feature",
+          "feature-state"
+        ]
+      },
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        },
+        "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      }
+    },
+    "building-flip-roof-orientation": {
+      "property-type": "data-driven",
+      "type": "boolean",
+      "experimental": true,
+      "units": "meters",
+      "default": false,
+      "doc": "Flips the orientation of the roofs for the buildings. This only affects simple geometries. Namely buildings whose footprints form a quadrilateral. By default (false), the roof ridge takes the direction of the longer edge of the quadrilateral.",
+      "transition": true,
+      "requires": [
+        "building-roof-shape"
+      ],
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "feature",
+          "feature-state"
+        ]
+      },
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        },
+        "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      }
     }
   },
   "layout_line": {
@@ -2691,6 +2980,11 @@
           "ios": "11.9.0"
         }
       },
+      "requires": [
+        {
+          "symbol-z-elevate": true
+        }
+      ],
       "expression": {
         "interpolated": false,
         "parameters": [
@@ -7608,6 +7902,9 @@
       "private": true,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -7635,6 +7932,9 @@
       "doc": "Controls the intensity of ambient occlusion when shading concave angles between walls and roof crevices and windows.",
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       }
     },
@@ -7656,6 +7956,9 @@
       "doc": "Controls the intensity of shading near ground",
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       }
     },
@@ -7676,6 +7979,9 @@
       "doc": "The extent of the ambient occlusion effect on the ground beneath the procedural buildings in meters.",
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       }
     },
@@ -7697,6 +8003,9 @@
       },
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       }
     },
@@ -7717,6 +8026,9 @@
       },
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       }
     },
@@ -7728,7 +8040,10 @@
       "experimental": true,
       "private": true,
       "sdk-support": {
-          "basic functionality": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "property-type": "data-constant"
@@ -7743,8 +8058,14 @@
       "transition": false,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         },
         "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -7768,8 +8089,14 @@
       "private": true,
       "sdk-support": {
         "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         },
         "data-driven styling": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
         }
       },
       "expression": {
@@ -7791,7 +8118,11 @@
       "experimental": true,
       "property-type": "data-constant",
       "sdk-support": {
-        "basic functionality": {}
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
       },
       "expression": {
         "interpolated": true,
@@ -7812,9 +8143,92 @@
         "interpolated": false
       },
       "sdk-support": {
-          "basic functionality": {}
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
       },
       "property-type": "data-constant"
+    },
+    "building-flood-light-color": {
+      "property-type": "data-constant",
+      "type": "color",
+      "experimental": true,
+      "default": "#ffffff",
+      "doc": "The color of the flood light effect on the walls of the buildings.",
+      "requires": [
+        "lights"
+      ],
+      "use-theme": true,
+      "transition": true,
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "zoom",
+          "measure-light"
+        ]
+      },
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      }
+    },
+    "building-flood-light-intensity": {
+      "property-type": "data-constant",
+      "type": "number",
+      "experimental": true,
+      "default": 0.0,
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "doc": "The intensity of the flood light color.",
+      "requires": [
+        "lights"
+      ],
+      "transition": true,
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "zoom",
+          "measure-light"
+        ]
+      },
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      }
+    },
+    "building-flood-light-ground-attenuation": {
+      "property-type": "data-constant",
+      "type": "number",
+      "experimental": true,
+      "default": 0.69,
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "doc": "Provides a control to futher fine-tune the look of the flood light on the ground beneath the buildings. Lower values give the effect a more solid look while higher values make it smoother.",
+      "requires": [
+        "lights"
+      ],
+      "transition": true,
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "zoom"
+        ]
+      },
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.16.0",
+          "android": "11.16.0",
+          "ios": "11.16.0"
+        }
+      }
     }
   },
   "paint_line": {
@@ -9576,6 +9990,11 @@
           "ios": "11.7.0"
         }
       },
+      "requires": [
+        {
+          "symbol-z-elevate": true
+        }
+      ],
       "expression": {
         "interpolated": true,
         "parameters": [
@@ -10940,6 +11359,32 @@
           "js": "3.5.0"
         }
       }
+    },
+    "model-elevation-reference": {
+      "type": "enum",
+      "doc": "Selects the base of the model. Some modes might require precomputed elevation data in the tileset.",
+      "values": {
+        "sea": {
+          "doc": "Elevated rendering is enabled. Use this mode to elevate models relative to the sea level."
+        },
+        "ground": {
+          "doc": "Elevated rendering is enabled. Use this mode to elevate models relative to the ground's height below them."
+        },
+        "hd-road-markup": {
+          "doc": "Elevated rendering is enabled. Use this mode to describe additive and stackable features that should exist only on top of road polygons."
+        }
+      },
+      "default": "ground",
+      "transition": false,
+      "expression": {
+        "interpolated": false
+      },
+      "property-type": "data-constant",
+      "experimental": true,
+      "sdk-support": {
+        "basic functionality": {
+        }
+      }
     }
   },
   "transition": {

package/rollup.config.js

@@ -31,6 +31,7 @@ const config = [{
         }),
         esbuild({tsconfig: `${__dirname}/../../tsconfig.json`}),
         json(),
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
         unassert({include: ['*.js', '**/*.js', '*.ts', '**/*.ts']}),
         resolve({
             browser: true,

package/test.js

@@ -4,6 +4,7 @@ import fs from 'fs';
 import {execSync} from 'child_process';
 import {createRequire} from 'module';
 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
 const packageJson = JSON.parse(fs.readFileSync('./package.json').toString());
 
 process.on('unhandledRejection', (/** @type {Error} */ error) => {
@@ -17,7 +18,9 @@ const require = createRequire(import.meta.url);
 const stylePath = require.resolve('mapbox-gl-styles/styles/basic-v9.json');
 
 try {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
     for (const bin in packageJson.bin) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
         const script = packageJson.bin[bin];
         const command = [script, stylePath].join(' ');
 
@@ -25,6 +28,7 @@ try {
         execSync(command).toString();
     }
 } catch (error) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
     console.log(error.message);
     process.exit(1);
 }