@mapbox/mapbox-gl-style-spec 14.13.0 → 14.14.0-alpha.a4a566d51

package/expression/definitions/index.ts

@@ -25,6 +25,7 @@ import IndexOf from './index_of';
 import Match from './match';
 import Case from './case';
 import Slice from './slice';
+import Split from './split';
 import Step from './step';
 import Interpolate from './interpolate';
 import Coalesce from './coalesce';
@@ -91,7 +92,8 @@ const expressions: ExpressionRegistry = {
     'var': Var,
     'within': Within,
     'distance': Distance,
-    'config': Config
+    'config': Config,
+    'split': Split
 };
 
 function rgba(ctx: EvaluationContext, [r, g, b, a]: Expression[]) {

package/expression/definitions/split.ts

@@ -0,0 +1,56 @@
+import {
+    StringType,
+    array,
+} from '../types';
+
+import type {Expression, SerializedExpression} from '../expression';
+import type ParsingContext from '../parsing_context';
+import type EvaluationContext from '../evaluation_context';
+import type {Type} from '../types';
+
+class Split implements Expression {
+    type: Type;
+    str: Expression;
+    delimiter: Expression;
+
+    constructor(str: Expression, delimiter: Expression) {
+        this.type = array(StringType);
+        this.str = str;
+        this.delimiter = delimiter;
+    }
+
+    static parse(args: ReadonlyArray<unknown>, context: ParsingContext): Split | void {
+        if (args.length !== 3) {
+            return context.error(`Expected 2 arguments, but found ${args.length - 1} instead.`);
+        }
+
+        const str = context.parse(args[1], 1, StringType);
+        const delimiter = context.parse(args[2], 2, StringType);
+
+        if (!str || !delimiter) return;
+
+        return new Split(str, delimiter);
+    }
+
+    evaluate(ctx: EvaluationContext): string[] {
+        const str = (this.str.evaluate(ctx) as string);
+        const delimiter = (this.delimiter.evaluate(ctx) as string);
+
+        return str.split(delimiter);
+    }
+
+    eachChild(fn: (_: Expression) => void) {
+        fn(this.str);
+        fn(this.delimiter);
+    }
+
+    outputDefined(): boolean {
+        return false;
+    }
+
+    serialize(): SerializedExpression {
+        return ["split", this.str.serialize(), this.delimiter.serialize()];
+    }
+}
+
+export default Split;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapbox/mapbox-gl-style-spec",
-  "version": "14.13.0",
+  "version": "14.14.0-alpha.a4a566d51",
   "description": "a specification for mapbox gl styles",
   "author": "Mapbox",
   "license": "SEE LICENSE IN LICENSE.txt",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@mapbox/jsonlint-lines-primitives": "~2.0.2",
-    "@mapbox/point-geometry": "^0.1.0",
+    "@mapbox/point-geometry": "^1.1.0",
     "@mapbox/unitbezier": "^0.0.1",
     "cheap-ruler": "^4.0.0",
     "csscolorparser": "~1.0.2",

package/reference/v8.json

@@ -2037,6 +2037,72 @@
       },
       "property-type": "constant"
     },
+    "building-facade": {
+      "type": "boolean",
+      "default": false,
+      "doc": "Whether to render facade details on the buildings.",
+      "experimental": true,
+      "private": true,
+      "sdk-support": {
+        "basic functionality": {
+        },
+        "data-driven styling": {
+        }
+      },
+      "expression": {
+        "interpolated": false,
+        "parameters": [
+          "feature"
+        ]
+      },
+      "property-type": "data-driven"
+    },
+    "building-facade-floors": {
+      "type": "number",
+      "minimum": 1,
+      "maximum": 200,
+      "default": 3,
+      "doc": "Number of floors created when building-facade is enabled.",
+      "experimental": true,
+      "property-type": "data-driven",
+      "sdk-support": {
+        "basic functionality": {},
+        "data-driven styling": {}
+      },
+      "expression": {
+        "interpolated": false,
+        "parameters": [
+          "feature"
+        ]
+      },
+      "requires": [
+        "building-facade"
+      ]
+    },
+    "building-facade-window": {
+      "type": "array",
+      "length": 2,
+      "value": "number",
+      "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",
+      "experimental": true,
+      "property-type": "data-driven",
+      "sdk-support": {
+        "basic functionality": {},
+        "data-driven styling": {}
+      },
+      "expression": {
+        "interpolated": false,
+        "parameters": [
+          "feature"
+        ]
+      },
+      "requires": [
+        "building-facade"
+      ]
+    },
     "building-roof-shape": {
       "type": "enum",
       "values": {
@@ -4367,6 +4433,17 @@
           }
         }
       },
+      "split": {
+        "doc": "Returns an array of substrings from a string, split by a delimiter parameter.",
+        "group": "Lookup",
+        "sdk-support": {
+          "basic functionality": {
+            "js": "3.14.0",
+            "android": "11.14.0",
+            "ios": "11.14.0"
+          }
+        }
+      },
       "case": {
         "doc": "Selects the first output whose corresponding test condition evaluates to true, or the fallback value otherwise.",
         "group": "Decision",
@@ -7515,7 +7592,7 @@
       },
       "property-type": "data-constant"
     },
-    "building-ambient-occlusion-wall-intensity": {
+    "building-ambient-occlusion-intensity": {
       "property-type": "data-constant",
       "type": "number",
       "default": 0,
@@ -7524,13 +7601,12 @@
       "experimental": true,
       "private": true,
       "expression": {
-        "interpolated": true,
+        "interpolated": false,
         "parameters": [
-          "zoom"
         ]
       },
       "transition": true,
-      "doc": "Controls the intensity of shading concave angles between walls and building elements, such as facades and rooftop.",
+      "doc": "Controls the intensity of ambinet occlusion when shading concave angles between walls and roof crevices.",
       "sdk-support": {
         "basic functionality": {
         }
@@ -7649,7 +7725,8 @@
         "interpolated": true,
         "parameters": [
           "feature",
-          "feature-state"
+          "feature-state",
+          "measure-light"
         ]
       },
       "property-type": "data-driven"
@@ -7658,7 +7735,9 @@
       "type": "number",
       "default": 0,
       "minimum": 0,
-      "doc": "Controls the intensity of light emitted on the source features.",
+      "maximum": 5,
+      "units": "intensity",
+      "doc": "Controls the intensity of light emitted on the source features. There is no emission for value 0. For value 1.0, only emissive component (no shading) is displayed and values above 1.0 produce light contribution to surrounding area, for some of the parts (e.g. doors).",
       "experimental": true,
       "private": true,
       "sdk-support": {
@@ -7676,6 +7755,57 @@
         ]
       },
       "property-type": "data-driven"
+    },
+    "building-facade-emissive-chance": {
+      "type": "number",
+      "default": 0.35,
+      "minimum": 0,
+      "maximum": 1,
+      "doc": "Given as a fraction specifies the likelihood for the facades to be emissive when building-facade is enabled. A value of 0.0 means the window will never be emissive, while a value of 1.0 means the window will always be emissive. This can be used to create variations on a building where some windows are lit and some are not.",
+      "experimental": true,
+      "property-type": "data-constant",
+      "sdk-support": {
+        "basic functionality": {}
+      },
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "measure-light",
+          "zoom"
+        ]
+      }
+    },
+    "building-ambient-occlusion-window-intensity": {
+      "type": "number",
+      "default": 0,
+      "minimum": 0,
+      "maximum": 1,
+      "doc": "Controls the intensity of ambient occlusion applied to the windows of the buildings. A value of 0.0 means no ambient occlusion is applied, while a value of 1.0 means full ambient occlusion is applied.",
+      "experimental": true,
+      "property-type": "data-constant",
+      "sdk-support": {
+        "basic functionality": {}
+      },
+      "expression": {
+        "interpolated": false,
+        "parameters": [
+        ]
+      }
+    },
+    "building-cutoff-fade-range": {
+      "type": "number",
+      "default": 0.0,
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "doc": "This parameter defines the range for the fade-out effect before an automatic content cutoff on pitched map views. Fade out is implemented by scaling down and removing buildings in the fade range in a staggered fashion. Opacity is not changed. The fade range is expressed in relation to the height of the map view. A value of 1.0 indicates that the content is faded to the same extent as the map's height in pixels, while a value close to zero represents a sharp cutoff. When the value is set to 0.0, the cutoff is completely disabled. Note: The property has no effect on the map if terrain is enabled.",
+      "transition": false,
+      "expression": {
+        "interpolated": false
+      },
+      "sdk-support": {
+          "basic functionality": {}
+      },
+      "property-type": "data-constant"
     }
   },
   "paint_line": {

package/types.ts

@@ -1078,6 +1078,18 @@ export type BuildingLayerSpecification = {
     "filter"?: FilterSpecification,
     "layout"?: {
         "visibility"?: "visible" | "none" | ExpressionSpecification,
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "building-facade"?: DataDrivenPropertyValueSpecification<boolean>,
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "building-facade-floors"?: DataDrivenPropertyValueSpecification<number>,
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "building-facade-window"?: DataDrivenPropertyValueSpecification<[number, number]>,
         /**
          * @experimental This property is experimental and subject to change in future versions.
          */
@@ -1102,8 +1114,8 @@ export type BuildingLayerSpecification = {
         /**
          * @experimental This property is experimental and subject to change in future versions.
          */
-        "building-ambient-occlusion-wall-intensity"?: PropertyValueSpecification<number>,
-        "building-ambient-occlusion-wall-intensity-transition"?: TransitionSpecification,
+        "building-ambient-occlusion-intensity"?: ExpressionSpecification,
+        "building-ambient-occlusion-intensity-transition"?: TransitionSpecification,
         /**
          * @experimental This property is experimental and subject to change in future versions.
          */
@@ -1136,7 +1148,16 @@ export type BuildingLayerSpecification = {
         /**
          * @experimental This property is experimental and subject to change in future versions.
          */
-        "building-emissive-strength"?: DataDrivenPropertyValueSpecification<number>
+        "building-emissive-strength"?: DataDrivenPropertyValueSpecification<number>,
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "building-facade-emissive-chance"?: PropertyValueSpecification<number>,
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "building-ambient-occlusion-window-intensity"?: ExpressionSpecification,
+        "building-cutoff-fade-range"?: ExpressionSpecification
     }
 }