gen docs

Author: birkskyum

build/generate-docs.ts

@@ -225,10 +225,16 @@ function convertPropertyToMarkdown(key: string, value: JsonObject, keyPrefix = '
     const isProjection = value.type === 'projection' && value.values && !Array.isArray(value.values);
     if (isProjection) {
         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 += 'Projections:\n\r';
+
+        Object.keys(value.values['projections']).map((projection) =>{
+            markdown += `- \`${projection}\`: ${value.values['projections'][projection].doc}\n\r`;
+        })
         markdown += '\n\r';
+        markdown += 'Presets:\n\r';
+        Object.keys(value.values['presets']).map((projection) =>{
+            markdown += `- \`${projection}\`: ${value.values['presets'][projection].doc}\n\r`;
+        })
     }
 
     const isEnum = value.type === 'enum' && value.values && !Array.isArray(value.values);

build/generate-style-spec.ts

@@ -126,8 +126,8 @@ fs.writeFileSync('src/types.g.ts',
 
 export type ColorSpecification = string;
 
-export type ProjectionPresetT = ${projectionTypes.presets.map(p => `'${p}'`).join(' | ')};
-export type ProjectionPrimitiveT =  ${projectionTypes.projections.map(p => `'${p}'`).join(' | ')};
+export type ProjectionPresetT = ${Object.keys(projectionTypes.presets).map(p => `'${p}'`).join(' | ')};
+export type ProjectionPrimitiveT =  ${Object.keys(projectionTypes.projections).map(p => `'${p}'`).join(' | ')};
 export type ProjectionT = [ProjectionPrimitiveT, ProjectionPrimitiveT, number];
 export type ProjectionSpecification = ProjectionPresetT | ProjectionPrimitiveT | ProjectionT | PropertyValueSpecification<ProjectionT>
 

src/reference/v8.json

@@ -4602,13 +4602,19 @@
         ]
       },
       "values": {
-        "projections": [
-          "mercator",
-          "stereographic"
-        ],
-        "presets": [
-          "globe"
-        ]
+        "projections": {
+          "mercator": {
+            "doc": "Web Mercator projection."
+          },
+          "stereographic": {
+            "doc": "Stereographic projection."
+          }
+        },
+        "presets": {
+          "globe": {
+            "doc": "Globe projection with zoom transition from Stereographic projection to Web Mercator projection."
+          }
+        }
       },
       "property-type": "data-constant"
     }