docs

Author: birkskyum

build/generate-docs.ts

@@ -219,6 +219,16 @@ function convertPropertyToMarkdown(key: string, value: JsonObject, keyPrefix = '
 
     markdown += '. ';
 
+    // Projection type:
+    const isProjectionTransition = value.type === 'projectionTransition' && value.values && !Array.isArray(value.values);
+    if (isProjectionTransition) {
+        markdown += '\n\r';
+        markdown += `Projections: ${value.values['projections'].map(val=>`\`${val}\``).join(', ')}. `;
+        markdown += '\n\r';
+        markdown += `Presets: ${value.values['presets'].map(val=>`\`${val}\``).join(', ')}. `;
+        markdown += '\n\r';
+    }
+    
     const isEnum = value.type === 'enum' && value.values && !Array.isArray(value.values);
     if (isEnum) {
         markdown += `Possible values: \`${Object.keys(value.values).join('`, `')}\`. `;

build/generate-style-spec.ts

@@ -124,9 +124,10 @@ fs.writeFileSync('src/types.g.ts',
 
 export type ColorSpecification = string;
 
-export type PrimitiveProjection = 'mercator' | 'globe';
-export type ProjectionTransition = [PrimitiveProjection, PrimitiveProjection, number];
-export type ProjectionTransitionSpecification = PrimitiveProjection | ProjectionTransition | PropertyValueSpecification<ProjectionTransition>
+export type ProjectionPreset = 'globe';
+export type ProjectionPrimitive = 'mercator' | 'stereographic';
+export type ProjectionTransition = [ProjectionPrimitive, ProjectionPrimitive, number];
+export type ProjectionTransitionSpecification = ProjectionPreset | ProjectionPrimitive | ProjectionTransition | PropertyValueSpecification<ProjectionTransition>
 
 
 export type PaddingSpecification = number | number[];
@@ -211,7 +212,7 @@ export type ExpressionSpecification =
     | ['interpolate', InterpolationSpecification, number | ExpressionSpecification,
         ...(number | number[] | ColorSpecification | ExpressionSpecification)[]] // alternating number and number | number[] | ColorSpecification
     | ['interpolate-projection', InterpolationSpecification, number | ExpressionSpecification,
-        ...(number | PrimitiveProjection)[]] // alternating Projection
+        ...(number | ProjectionPrimitive)[]] // alternating Projection
     | ['interpolate-hcl', InterpolationSpecification, number | ExpressionSpecification,
         ...(number | ColorSpecification)[]] // alternating number and ColorSpecificaton
     | ['interpolate-lab', InterpolationSpecification, number | ExpressionSpecification,

src/reference/v8.json

@@ -127,7 +127,7 @@
     },
     "projection": {
       "type": "projection",
-      "doc": "The projection type. Can be specified as a string, or as an expression for supported projection types.",
+      "doc": "The projection configuration",
       "example": {
         "type": [
           "interpolate-projection",
@@ -4593,21 +4593,23 @@
   "projection": {
     "type": {
       "type": "projectionTransition",
-      "doc": "The projection type. Can be specified as a string, or as an expression for supported projection types.",
+      "doc": "The projection type. Can be specified as a string, a transition state, or an expression.",
       "default": "mercator",
       "expression": {
         "interpolated": true,
         "parameters": [
           "zoom"
+        ]
+      },
+      "values": {
+        "projections": [
+          "mercator",
+          "stereographic"
         ],
-        "operators": [
-          "interpolate-projection"
+        "presets": [
+          "globe"
         ]
       },
-      "values": [
-        "mercator",
-        "globe"
-      ],
       "property-type": "data-constant"
     }
   },