feat: update role states and properties

* Addition of `aria-braillelabel`
* Addition of `aria-brailleroledescription`
* Addition of `aria-description`
* Fixes to some `prohibitedProps` and `nameFrom` fields

Author: jlp-craigmorten

__tests__/src/elementRoleMap-test.js

@@ -72,8 +72,8 @@ const entriesList = [
   [{"name": "h4"}, ["heading"]],
   [{"name": "h5"}, ["heading"]],
   [{"name": "h6"}, ["heading"]],
-  [{"attributes": [{"constraints": ["set"], "name": "alt"}], "name": "img"}, ["img"]],
-  [{"attributes": [{"constraints": ["undefined"], "name": "alt"}], "name": "img"}, ["img"]],
+  [{"attributes": [{"constraints": ["set"], "name": "alt"}], "name": "img"}, ["image", "img"]],
+  [{"attributes": [{"constraints": ["undefined"], "name": "alt"}], "name": "img"}, ["image", "img"]],
   [{"name": "ins"}, ["insertion"]],
   [{"attributes": [{"constraints": ["set"], "name": "href"}], "name": "a"}, ["link"]],
   [{"attributes": [{"constraints": ["set"], "name": "href"}], "name": "area"}, ["link"]],
@@ -90,9 +90,9 @@ const entriesList = [
   [{"name": "math"}, ["math"]],
   [{"name": "meter"}, ["meter"]],
   [{"name": "nav"}, ["navigation"]],
+  [{"attributes": [{"name": "alt", "value": ""}], "name": "img"}, ["none", "presentation"]],
   [{"name": "option"}, ["option"]],
   [{"name": "p"}, ["paragraph"]],
-  [{"attributes": [{"name": "alt", "value": ""}], "name": "img"}, ["presentation"]],
   [{"name": "progress"}, ["progressbar"]],
   [{"attributes": [{"name": "aria-valuemax"}, {"name": "aria-valuemin", "value": 0}, {"name": "aria-valuenow"}], "constraints": ["the progress bar is determinate"],"name": "progress"}, ["progressbar"]],
   [{"attributes": [{"name": "type", "value": "radio"}], "name": "input"}, ["radio"]],

__tests__/src/roleElementMap-test.js

@@ -33,6 +33,7 @@ const entriesList = [
   ["gridcell", [{"constraints": ["ancestor table element has grid role", "ancestor table element has treegrid role"], "name": "td"}]],
   ["group", [{"name": "details"}, {"name": "fieldset"}, {"name": "optgroup"}, {"name": "address"}]],
   ["heading", [{"name": "h1"}, {"name": "h2"}, {"name": "h3"}, {"name": "h4"}, {"name": "h5"}, {"name": "h6"}]],
+  ["image", [{"attributes": [{"constraints": ["set"], "name": "alt"}], "name": "img"}, {"attributes": [{"constraints": ["undefined"], "name": "alt"}], "name": "img"}]],
   ["img", [{"attributes": [{"constraints": ["set"], "name": "alt"}], "name": "img"}, {"attributes": [{"constraints": ["undefined"], "name": "alt"}], "name": "img"}]],
   ["insertion", [{"name": "ins"}]],
   ["link", [{"attributes": [{"constraints": ["set"], "name": "href"}], "name": "a"}, {"attributes": [{"constraints": ["set"], "name": "href"}], "name": "area"}]],
@@ -44,6 +45,7 @@ const entriesList = [
   ["math", [{"name": "math"}]],
   ["meter", [{"name": "meter"}]],
   ["navigation", [{"name": "nav"}]],
+  ["none", [{"attributes": [{"name": "alt", "value": ""}], "name": "img"}]],
   ["option", [{"name": "option"}]],
   ["paragraph", [{"name": "p"}]],
   ["presentation", [{"attributes": [{"name": "alt", "value": ""}], "name": "img"}]],
@@ -72,7 +74,7 @@ const entriesList = [
 test('roleElementMap API', (t) => {
   const predicate = (role, [r]) => role === r;
 
-  testIteration(t, roleElementMap, entriesList, 55, predicate);
+  testIteration(t, roleElementMap, entriesList, 57, predicate);
 
   testForEach(t, roleElementMap, entriesList, predicate);
 

__tests__/src/rolesMap-test.js

@@ -20,6 +20,7 @@ const entriesList = [
   ["code", null],
   ["columnheader", null],
   ["combobox", null],
+  ["comment", null],
   ["command", null],
   ["complementary", null],
   ["composite", null],
@@ -38,6 +39,7 @@ const entriesList = [
   ["gridcell", null],
   ["group", null],
   ["heading", null],
+  ["image", null],
   ["img", null],
   ["input", null],
   ["insertion", null],
@@ -85,6 +87,7 @@ const entriesList = [
   ["strong", null],
   ["structure", null],
   ["subscript", null],
+  ["suggestion", null],
   ["superscript", null],
   ["switch", null],
   ["tab", null],
@@ -151,7 +154,7 @@ const entriesList = [
 test('rolesMap API', (t) => {
   const predicate = (role, [r]) => role === r;
 
-  testIteration(t, rolesMap, entriesList, 139, predicate);
+  testIteration(t, rolesMap, entriesList, 142, predicate);
 
   testForEach(t, rolesMap, entriesList, predicate);
 

flow/aria.js

@@ -55,6 +55,7 @@ type ARIADocumentStructureRole =
   | 'blockquote'
   | 'caption'
   | 'cell'
+  | 'comment'
   | 'columnheader'
   | 'definition'
   | 'deletion'
@@ -66,6 +67,7 @@ type ARIADocumentStructureRole =
   | 'generic'
   | 'group'
   | 'heading'
+  | 'image'
   | 'img'
   | 'insertion'
   | 'list'
@@ -83,6 +85,7 @@ type ARIADocumentStructureRole =
   | 'separator'
   | 'strong'
   | 'subscript'
+  | 'suggestion'
   | 'superscript'
   | 'table'
   | 'term'