add a formatter

Author: CommanderStorm

.oxfmtrc.jsonc

@@ -0,0 +1,6 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "tabWidth": 4,
+  "singleQuote": true,
+  "bracketSpacing": false
+}

bin/gl-style-migrate.ts

@@ -16,4 +16,3 @@ function help() {
     console.log('usage:');
     console.log('  gl-style-migrate style-v7.json > style-v8.json');
 }
-

build/bump-version-changelog.js

@@ -13,7 +13,8 @@ const changelogPath = 'CHANGELOG.md';
 let changelog = readFileSync(changelogPath, 'utf8');
 changelog = changelog.replace('## main', `## ${process.argv[2]}`);
 changelog = changelog.replaceAll('- _...Add new stuff here..._\n', '');
-changelog = `## main
+changelog =
+    `## main
 
 ### ✨ Features and improvements
 - _...Add new stuff here..._

build/generate-docs.ts

@@ -1,4 +1,4 @@
-import v8 from '../src/reference/v8.json' with { type: 'json' };
+import v8 from '../src/reference/v8.json' with {type: 'json'};
 import fs from 'fs';
 import {formatJSON} from './util';
 
@@ -19,15 +19,15 @@ type JsonExpressionSyntax = {
         type: string;
         doc?: string;
     }[];
-}
+};
 
 type JsonSdkSupport = {
     [info: string]: {
         js?: string;
         android?: string;
         ios?: string;
     };
-}
+};
 
 type JsonObject = {
     required?: boolean;
@@ -37,12 +37,12 @@ type JsonObject = {
     doc: string;
     requires?: any[];
     example: string | object | number;
-    expression?: { interpolated?: boolean; parameters?: string[]};
+    expression?: {interpolated?: boolean; parameters?: string[]};
     transition?: boolean;
-    values?: {[key: string]: { doc: string; 'sdk-support'?: JsonSdkSupport }} | number[];
+    values?: {[key: string]: {doc: string; 'sdk-support'?: JsonSdkSupport}} | number[];
     minimum?: number;
     maximum?: number;
-}
+};
 
 /**
  * Capitalizes the first letter of the word.
@@ -61,15 +61,17 @@ function capitalize(word: string) {
  * @returns true if the element should be a topic, false otherwise
  */
 function topicElement(key: string, value: JsonObject): boolean {
-    return value.type !== 'number' &&
+    return (
+        value.type !== 'number' &&
         value.type !== 'boolean' &&
         key !== 'center' &&
         value.type !== '*' &&
         value.type !== 'enum' &&
         key !== 'name' &&
         key !== 'sprite' &&
         key !== 'layers' &&
-        key !== 'sources';
+        key !== 'sources'
+    );
 }
 
 /**
@@ -99,7 +101,7 @@ function supportCell(support?: string): string {
     // if the string is an issue link, generate a link to it
     // there is no support yet but there is a tracking issue
     const maplibreIssue = /https:\/\/github.com\/maplibre\/[^/]+\/issues\/(\d+)/;
-    const match  = support.match(maplibreIssue);
+    const match = support.match(maplibreIssue);
     if (match) return `❌ ([#${match[1]}](${support}))`;
     return support;
 }
@@ -230,7 +232,12 @@ function formatRange(minimum?: number, maximum?: number) {
  * @param paintLayoutText - the text to be used for the paint/layout property
  * @returns the markdown string
  */
-function convertPropertyToMarkdown(key: string, value: JsonObject, keyPrefix = '##', paintLayoutText = '') {
+function convertPropertyToMarkdown(
+    key: string,
+    value: JsonObject,
+    keyPrefix = '##',
+    paintLayoutText = '',
+) {
     let markdown = `${keyPrefix} ${key}\n*`;
     if (paintLayoutText) {
         markdown += `[${paintLayoutText}](#${paintLayoutText.toLowerCase()}) property. `;
@@ -267,8 +274,9 @@ function convertPropertyToMarkdown(key: string, value: JsonObject, keyPrefix = '
     }
     if (value.expression?.interpolated) {
         if (value.expression.parameters.includes('feature-state')) {
-            markdown += 'Supports [feature-state](expressions.md#feature-state) and [interpolate](expressions.md#interpolate) expressions. ';
-        }  else {
+            markdown +=
+                'Supports [feature-state](expressions.md#feature-state) and [interpolate](expressions.md#interpolate) expressions. ';
+        } else {
             markdown += 'Supports [interpolate](expressions.md#interpolate) expressions. ';
         }
     }
@@ -337,7 +345,7 @@ function createLayersContent() {
         content += convertPropertyToMarkdown(key, value as JsonObject, '###');
     }
 
-    for (const layoutKey of Object.keys(v8).filter(key => key.startsWith('layout_'))) {
+    for (const layoutKey of Object.keys(v8).filter((key) => key.startsWith('layout_'))) {
         const layerName = layoutKey.replace('layout_', '');
         content += `## ${capitalize(layerName)}\n\n`;
         for (const [key, value] of Object.entries(v8[layoutKey])) {
@@ -360,143 +368,137 @@ function createSourcesContent() {
             doc: 'A vector tile source. Tiles must be in [Mapbox Vector Tile format](https://github.com/mapbox/vector-tile-spec). All geometric coordinates in vector tiles must be between \`-1 * extent\` and \`(extent * 2) - 1\` inclusive. All layers that use a vector source must specify a [`source-layer`](layers.md#source-layer) value. Note that features are only rendered within their originating tile, which may lead to visual artifacts when large values for width, radius, size or offset are specified. To mitigate rendering issues, either reduce the value of the property causing the artifact or, if you have control over the tile generation process, increase the buffer size to ensure that features are fully rendered within the tile.',
             example: {
                 'maplibre-streets': {
-                    'type': 'vector',
-                    'tiles': [
-                        'http://a.example.com/tiles/{z}/{x}/{y}.pbf'
-                    ],
-                }
+                    type: 'vector',
+                    tiles: ['http://a.example.com/tiles/{z}/{x}/{y}.pbf'],
+                },
             },
             'sdk-support': {
                 'basic functionality': {
                     js: '0.10.0',
                     android: '2.0.1',
-                    ios: '2.0.0'
-                }
-            }
+                    ios: '2.0.0',
+                },
+            },
         },
         raster: {
             doc: 'A raster tile source.',
             example: {
                 'maplibre-satellite': {
-                    'type': 'raster',
-                    'tiles': [
-                        'http://a.example.com/tiles/{z}/{x}/{y}.png'
-                    ],
-                    'tileSize': 256
-                }
+                    type: 'raster',
+                    tiles: ['http://a.example.com/tiles/{z}/{x}/{y}.png'],
+                    tileSize: 256,
+                },
             },
             'sdk-support': {
                 'basic functionality': {
                     js: '0.10.0',
                     android: '2.0.1',
-                    ios: '2.0.0'
-                }
-            }
+                    ios: '2.0.0',
+                },
+            },
         },
         'raster-dem': {
             doc: 'A raster DEM source. Only supports [Mapbox Terrain RGB](https://blog.mapbox.com/global-elevation-data-6689f1d0ba65) and Mapzen Terrarium tiles.',
             example: {
                 'maplibre-terrain-rgb': {
-                    'type': 'raster-dem',
-                    'encoding': 'mapbox',
-                    'tiles': [
-                        'http://a.example.com/dem-tiles/{z}/{x}/{y}.png'
-                    ],
-                }
+                    type: 'raster-dem',
+                    encoding: 'mapbox',
+                    tiles: ['http://a.example.com/dem-tiles/{z}/{x}/{y}.png'],
+                },
             },
             'sdk-support': {
                 'basic functionality': {
                     js: '0.43.0',
                     android: '6.0.0',
-                    ios: '4.0.0'
-                }
-            }
+                    ios: '4.0.0',
+                },
+            },
         },
         geojson: {
             doc: 'A [GeoJSON](http://geojson.org/) source. Data must be provided via a \`"data"\` property, whose value can be a URL or inline GeoJSON. When using in a browser, the GeoJSON data must be on the same domain as the map or served with [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) headers.',
             example: {
                 'geojson-marker': {
-                    'type': 'geojson',
-                    'data': {
-                        'type': 'Feature',
-                        'geometry': {
-                            'type': 'Point',
-                            'coordinates': [12.550343, 55.665957]
+                    type: 'geojson',
+                    data: {
+                        type: 'Feature',
+                        geometry: {
+                            type: 'Point',
+                            coordinates: [12.550343, 55.665957],
                         },
-                        'properties': {
-                            'title': 'Somewhere',
-                            'marker-symbol': 'monument'
-                        }
-                    }
+                        properties: {
+                            title: 'Somewhere',
+                            'marker-symbol': 'monument',
+                        },
+                    },
                 },
                 'geojson-lines': {
-                    'type': 'geojson',
-                    'data': './lines.geojson'
-                }
+                    type: 'geojson',
+                    data: './lines.geojson',
+                },
             },
             'sdk-support': {
                 'basic functionality': {
                     js: '0.10.0',
                     android: '2.0.1',
-                    ios: '2.0.0'
+                    ios: '2.0.0',
                 },
                 clustering: {
                     js: '0.14.0',
                     android: '4.2.0',
-                    ios: '3.4.0'
+                    ios: '3.4.0',
                 },
                 'line distance metrics': {
                     js: '0.45.0',
                     android: '6.5.0',
-                    ios: '4.4.0'
-                }
-            }
+                    ios: '4.4.0',
+                },
+            },
         },
         image: {
             doc: 'An image source. The `url` value contains the image location. The `coordinates` array contains `[longitude, latitude]` pairs for the image corners listed in clockwise order: top left, top right, bottom right, bottom left.',
             example: {
-                'image': {
-                    'type': 'image',
-                    'url': 'https://maplibre.org/maplibre-gl-js/docs/assets/radar.gif',
-                    'coordinates': [
+                image: {
+                    type: 'image',
+                    url: 'https://maplibre.org/maplibre-gl-js/docs/assets/radar.gif',
+                    coordinates: [
                         [-80.425, 46.437],
                         [-71.516, 46.437],
                         [-71.516, 37.936],
-                        [-80.425, 37.936]
-                    ]
-                }
+                        [-80.425, 37.936],
+                    ],
+                },
             },
             'sdk-support': {
                 'basic functionality': {
                     js: '0.10.0',
                     android: '5.2.0',
-                    ios: '3.7.0'
-                }
-            }
+                    ios: '3.7.0',
+                },
+            },
         },
         video: {
-            doc: 'A video source. The `urls` value is an array. For each URL in the array, a video element [source](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source) will be created. To support the video across browsers, supply URLs in multiple formats.\n\nThe `coordinates` array contains `[longitude, latitude]` pairs for the video corners listed in clockwise order: top left, top right, bottom right, bottom left.\n\nWhen rendered as a [raster layer](layers.md#raster), the layer\'s [`raster-fade-duration`](layers.md#raster-fade-duration) property will cause the video to fade in. This happens when playback is started, paused and resumed, or when the video\'s coordinates are updated. To avoid this behavior, set the layer\'s [`raster-fade-duration`](layers.md#raster-fade-duration) property to `0`.',
+            doc: "A video source. The `urls` value is an array. For each URL in the array, a video element [source](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source) will be created. To support the video across browsers, supply URLs in multiple formats.\n\nThe `coordinates` array contains `[longitude, latitude]` pairs for the video corners listed in clockwise order: top left, top right, bottom right, bottom left.\n\nWhen rendered as a [raster layer](layers.md#raster), the layer's [`raster-fade-duration`](layers.md#raster-fade-duration) property will cause the video to fade in. This happens when playback is started, paused and resumed, or when the video's coordinates are updated. To avoid this behavior, set the layer's [`raster-fade-duration`](layers.md#raster-fade-duration) property to `0`.",
             example: {
-                'video': {
-                    'type': 'video',
-                    'urls': [
+                video: {
+                    type: 'video',
+                    urls: [
                         'https://static-assets.mapbox.com/mapbox-gl-js/drone.mp4',
-                        'https://static-assets.mapbox.com/mapbox-gl-js/drone.webm'
+                        'https://static-assets.mapbox.com/mapbox-gl-js/drone.webm',
                     ],
-                    'coordinates': [
+                    coordinates: [
                         [-122.51596391201019, 37.56238816766053],
                         [-122.51467645168304, 37.56410183312965],
                         [-122.51309394836426, 37.563391708549425],
-                        [-122.51423120498657, 37.56161849366671]
-                    ]
-                }
+                        [-122.51423120498657, 37.56161849366671],
+                    ],
+                },
             },
             'sdk-support': {
                 'basic functionality': {
-                    js: '0.10.0'
-                }
-            }
-        }
+                    js: '0.10.0',
+                },
+            },
+        },
     };
 
     let content = '# Sources\n\n';