docs

Author: birkskyum

docs/types.md

@@ -134,13 +134,18 @@ The following example applies 2em padding on top and bottom and 3em padding left
 }
 ```
 
-## Projection Type
+## ProjectionType
 
-There are currently two projection types implemented.
+The `projectionType` type is used to define the projection of the map.
+
+There are currently two projections implemented.
 
 - `mercator` - Web Mercator projection
 - `globe` - Globe projection
 
+This value can be uses either with a single projection or as an intermediate between two.
+
+It's possible to use an expression to change projection between zoom levels using a [`camera expression`](./expressions.md#camera-expressions), either with an immediate [`step`](./expressions.md#step), or an animated [`interpolate-projection`](./expressions.md#interpolate-projection).
 
 **Use a single projection**
 

src/reference/v8.json

@@ -3064,6 +3064,21 @@
           }
         }
       },
+      "interpolate-projection": {
+        "doc": "Produces continuous, smooth results by interpolating between pairs of input and output values (\"stops\"). Works like `interpolate`, but the output type must be a projection transition of shape `[from, to, transition]: [string, string, number]`.",
+        "example": {
+          "syntax": {
+            "method": ["[\"linear\"] | [\"exponential\", base] | [\"cubic-bezier\", x1, y1, x2, y2]", "number", "string", "number", "..."],
+            "result": "projection"
+          },
+          "value": ["interpolate-projection", ["linear"], ["zoom"], 0, "globe", 10, "globe", 12, "mercator"]
+        },
+        "group": "Ramps, scales, curves",
+        "sdk-support": {
+          "basic functionality": {
+          }
+        }
+      },
       "ln2": {
         "doc": "Returns mathematical constant ln(2).",
         "example": {