Add roll angle to stylesheet

Author: NathanMOlson

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ### ✨ Features and improvements
 
+* Added `roll` property to stylesheet ([#850](https://github.com/maplibre/maplibre-style-spec/issues/850))
 - _...Add new stuff here..._
 
 ### 🐞 Bug fixes

src/diff.test.ts

@@ -302,6 +302,16 @@ describe('diff', () => {
         ]);
     });
 
+    test('set roll', () => {
+        expect(diffStyles({
+            roll: 0
+        } as StyleSpecification, {
+            roll: 1
+        } as StyleSpecification)).toEqual([
+            {command: 'setRoll', args: [1]}
+        ]);
+    });
+
     test('no changes in light', () => {
         expect(diffStyles({
             light: {

src/diff.ts

@@ -22,6 +22,7 @@ export type DiffOperationsMap = {
     'setZoom': [number];
     'setBearing': [number];
     'setPitch': [number];
+    'setRoll': [number];
     'setSprite': [SpriteSpecification];
     'setGlyphs': [string];
     'setTransition': [TransitionSpecification];
@@ -287,6 +288,9 @@ function diffStyles(before: StyleSpecification, after: StyleSpecification): Diff
         if (!isEqual(before.pitch, after.pitch)) {
             commands.push({command: 'setPitch', args: [after.pitch]});
         }
+        if (!isEqual(before.roll, after.roll)) {
+            commands.push({command: 'setRoll', args: [after.roll]});
+        }
         if (!isEqual(before.sprite, after.sprite)) {
             commands.push({command: 'setSprite', args: [after.sprite]});
         }

src/reference/v8.json

@@ -54,6 +54,13 @@
       "doc": "Default pitch, in degrees. Zero is perpendicular to the surface, for a look straight down at the map, while a greater value like 60 looks ahead towards the horizon. The style pitch will be used only if the map has not been positioned by other means (e.g. map options or user interaction).",
       "example": 50
     },
+    "roll": {
+      "type": "number",
+      "default": 0,
+      "units": "degrees",
+      "doc": "Default roll, in degrees. The roll angle is measured counterclockwise about the camera boresight. The style roll will be used only if the map has not been positioned by other means (e.g. map options or user interaction).",
+      "example": 45
+    },
     "light": {
       "type": "light",
       "doc": "The global light source.",

test/integration/style-spec/tests/roll.input.json

@@ -0,0 +1,6 @@
+{
+  "version": 8,
+  "roll": "45",
+  "sources": {},
+  "layers": []
+}

test/integration/style-spec/tests/roll.output-api-supported.json

@@ -0,0 +1,6 @@
+[
+  {
+    "message": "roll: number expected, string found",
+    "line": 3
+  }
+]

test/integration/style-spec/tests/roll.output.json

@@ -0,0 +1,6 @@
+[
+  {
+    "message": "roll: number expected, string found",
+    "line": 3
+  }
+]