@markuplint/html-spec 2.5.0 → 3.0.0-alpha.0

package/src/{attributes/svg_textPath.json → spec.svg_textPath.json}

@@ -1,7 +1,27 @@
+// https://svgwg.org/svg2-draft/text.html#TextPathElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-70
 {
-	"tag": "tspan",
-	"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElement",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": [
+					"#text",
+					"#SVGDescriptive",
+					"#SVGPaintServer",
+					"svg|a",
+					"svg|animate",
+					"svg|clipPath",
+					"svg|marker",
+					"svg|mask",
+					"svg|script",
+					"svg|set",
+					"svg|style",
+					"svg|tspan"
+				]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#HTMLGlobalAttrs": true,
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
@@ -81,8 +101,8 @@
 		"#XLinkAttrs": ["xlink:href", "xlink:title"]
 	},
 	"attributes": {
+		// https://svgwg.org/svg2-draft/text.html#TextElementLengthAdjustAttribute
 		"lengthAdjust": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementLengthAdjustAttribute",
 			"type": {
 				"enum": ["spacing", "spacingAndGlyphs"],
 				"disallowToSurroundBySpaces": false
@@ -90,28 +110,28 @@
 			"defaultValue": "spacing",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementTextLengthAttribute
 		"textLength": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementTextLengthAttribute",
 			"type": ["<svg-length>", "<percentage>"],
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextPathElementPathAttribute
 		"path": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElementPathAttribute",
 			"type": "<svg-path>",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextPathElementHrefAttribute
 		"href": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElementHrefAttribute",
 			"type": "URL",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextPathElementStartOffsetAttribute
 		"startOffset": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElementStartOffsetAttribute",
 			"type": ["<svg-length>", "<percentage>"],
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextPathElementMethodAttribute
 		"method": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElementMethodAttribute",
 			"type": {
 				"enum": ["align", "stretch"],
 				"disallowToSurroundBySpaces": false
@@ -119,8 +139,8 @@
 			"defaultValue": "align",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextPathElementSpacingAttribute
 		"spacing": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElementSpacingAttribute",
 			"type": {
 				"enum": ["auto", "exact"],
 				"disallowToSurroundBySpaces": false
@@ -128,8 +148,8 @@
 			"defaultValue": "exact",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextPathElementSideAttribute
 		"side": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextPathElementSideAttribute",
 			"type": {
 				"enum": ["left", "right"],
 				"disallowToSurroundBySpaces": false
@@ -137,5 +157,13 @@
 			"defaultValue": "left",
 			"animatable": true
 		}
+	},
+	"aria": {
+		// The role mappings for textPath and tspan are an open issue.
+		"implicitRole": "group",
+		"permittedRoles": {
+			"core-aam": true,
+			"graphics-aam": true
+		}
 	}
 }

package/src/spec.svg_title.json

@@ -0,0 +1,21 @@
+// https://svgwg.org/svg2-draft/struct.html#TitleElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-71
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": ["#SVGOtherXMLNamespace", "#text"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#SVGCoreAttrs": ["id", "tabindex", "autofocus", "lang", "xml:space", "class", "style"]
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false
+	}
+}

package/src/{attributes/svg_tspan.json → spec.svg_tspan.json}

@@ -1,7 +1,23 @@
+// https://svgwg.org/svg2-draft/text.html#elementdef-tspan
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-73
 {
-	"tag": "tspan",
-	"ref": "https://svgwg.org/svg2-draft/text.html#elementdef-tspan",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": [
+					"#SVGDescriptive",
+					"#SVGPaintServer",
+					"svg|a",
+					"svg|animate",
+					"svg|script",
+					"svg|set",
+					"svg|style",
+					"svg|tspan"
+				]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#HTMLGlobalAttrs": true,
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
@@ -80,38 +96,38 @@
 		]
 	},
 	"attributes": {
+		// https://svgwg.org/svg2-draft/text.html#TextElementXAttribute
 		"x": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementXAttribute",
 			"type": "<text-coordinate>",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementYAttribute
 		"y": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementYAttribute",
 			"type": "<text-coordinate>",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementDXAttribute
 		"dx": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementDXAttribute",
 			"type": "<text-coordinate>",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementDYAttribute
 		"dy": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementDYAttribute",
 			"type": "<text-coordinate>",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementRotateAttribute
 		"rotate": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementRotateAttribute",
 			"type": "<list-of-numbers>",
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementTextLengthAttribute
 		"textLength": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementTextLengthAttribute",
 			"type": ["<svg-length>", "<percentage>"],
 			"animatable": true
 		},
+		// https://svgwg.org/svg2-draft/text.html#TextElementLengthAdjustAttribute
 		"lengthAdjust": {
-			"ref": "https://svgwg.org/svg2-draft/text.html#TextElementLengthAdjustAttribute",
 			"type": {
 				"enum": ["spacing", "spacingAndGlyphs"],
 				"disallowToSurroundBySpaces": false
@@ -119,5 +135,13 @@
 			"defaultValue": "spacing",
 			"animatable": true
 		}
+	},
+	"aria": {
+		// The role mappings for textPath and tspan are an open issue.
+		"implicitRole": "group",
+		"permittedRoles": {
+			"core-aam": true,
+			"graphics-aam": true
+		}
 	}
 }

package/src/{attributes/svg_use.json → spec.svg_use.json}

@@ -1,7 +1,21 @@
+// https://svgwg.org/svg2-draft/struct.html#UseElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-74
 {
-	"tag": "use",
-	"ref": "https://svgwg.org/svg2-draft/struct.html#UseElement",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": [
+					"#SVGAnimation",
+					"#SVGDescriptive",
+					"svg|clipPath",
+					"svg|mask",
+					"svg|script",
+					"svg|style"
+				]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#HTMLGlobalAttrs": true,
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
@@ -85,9 +99,17 @@
 		"#XLinkAttrs": ["xlink:href", "xlink:title"]
 	},
 	"attributes": {
+		// https://svgwg.org/svg2-draft/struct.html#UseElementHrefAttribute
 		"href": {
-			"ref": "https://svgwg.org/svg2-draft/struct.html#UseElementHrefAttribute",
 			"type": "URL"
 		}
+	},
+	"aria": {
+		// Note that the re-used graphics in the use element's shadow tree may still be included in the accessibility tree, even if the host element is not.
+		"implicitRole": "graphics-object",
+		"permittedRoles": {
+			"core-aam": true,
+			"graphics-aam": true
+		}
 	}
 }

package/src/spec.svg_view.json

@@ -0,0 +1,45 @@
+// https://svgwg.org/svg2-draft/linking.html#ViewElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-76
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": ["#SVGAnimation", "#SVGDescriptive", "svg|script", "svg|style"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#SVGCoreAttrs": ["id", "tabindex", "autofocus", "lang", "xml:space", "class", "style"]
+	},
+	"attributes": {
+		// https://svgwg.org/svg2-draft/coords.html#ViewBoxAttribute
+		"viewBox": {
+			"type": "<view-box>"
+		},
+		// https://svgwg.org/svg2-draft/coords.html#PreserveAspectRatioAttribute
+		"preserveAspectRatio": {
+			"type": "<preserve-aspect-ratio>"
+		},
+		// https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/zoomAndPan
+		"zoomAndPan": {
+			"type": {
+				"enum": ["disable", "magnify"]
+			},
+			"defaultValue": "magnify",
+			"deprecated": true
+		},
+		// https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/viewTarget
+		"viewTarget": {
+			"type": "Any",
+			"deprecated": true
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false
+	}
+}

package/src/spec.table.json

@@ -0,0 +1,64 @@
+// https://html.spec.whatwg.org/multipage/tables.html#the-table-element
+// https://www.w3.org/TR/html-aria/#el-table
+// https://w3c.github.io/html-aria/#el-table
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#script-supporting"
+			},
+			{
+				"optional": "caption"
+			},
+			{
+				"zeroOrMore": "#script-supporting"
+			},
+			{
+				"zeroOrMore": "colgroup"
+			},
+			{
+				"zeroOrMore": "#script-supporting"
+			},
+			{
+				"optional": "thead"
+			},
+			{
+				"zeroOrMore": "#script-supporting"
+			},
+			{
+				"choice": [
+					[
+						{
+							"zeroOrMore": "tbody"
+						}
+					],
+					[
+						{
+							"oneOrMore": "tr"
+						}
+					]
+				]
+			},
+			{
+				"zeroOrMore": "#script-supporting"
+			},
+			{
+				"optional": "tfoot"
+			},
+			{
+				"zeroOrMore": "#script-supporting"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "table",
+		"permittedRoles": true
+	}
+}

package/src/spec.tbody.json

@@ -0,0 +1,23 @@
+// https://html.spec.whatwg.org/multipage/tables.html#the-tbody-element
+// https://www.w3.org/TR/html-aria/#el-tbody
+// https://w3c.github.io/html-aria/#el-tbody
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "tr"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "rowgroup",
+		"permittedRoles": true
+	}
+}

package/src/spec.td.json

@@ -0,0 +1,37 @@
+// https://html.spec.whatwg.org/multipage/tables.html#the-td-element
+// https://www.w3.org/TR/html-aria/#el-td
+// https://w3c.github.io/html-aria/#el-td
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#flow"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLTableCellElementAttrs": ["colspan", "rowspan", "headers"]
+	},
+	"attributes": {},
+	"aria": {
+		// No corresponding role if the ancestor table element is not exposed as a role=table, grid or treegrid.
+		"implicitRole": false,
+		"permittedRoles": true,
+		"conditions": {
+			"table:is(:not([role]), [role=table]) > :is(thead, tfoot, tbody) > tr > td": {
+				"implicitRole": "cell"
+			},
+			"table:is([role=grid], [role=treegrid]) > :is(thead, tfoot, tbody) > tr > td": {
+				"implicitRole": "gridcell"
+			},
+			"table:is(:not([role]), [role=table], [role=grid], [role=treegrid]) > :is(thead, tfoot, tbody) > tr > td": {
+				// No role if the ancestor table element has role=table, grid, or treegrid; otherwise any role.
+				"permittedRoles": false
+			}
+		}
+	}
+}

package/src/spec.template.json

@@ -0,0 +1,24 @@
+// https://html.spec.whatwg.org/multipage/scripting.html#the-template-element
+// https://www.w3.org/TR/html-aria/#el-template
+// https://w3c.github.io/html-aria/#el-template
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#transparent"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
+}

package/src/spec.textarea.json

@@ -0,0 +1,67 @@
+// https://html.spec.whatwg.org/multipage/form-elements.html#the-textarea-element
+// https://www.w3.org/TR/html-aria/#el-textarea
+// https://w3c.github.io/html-aria/#el-textarea
+{
+	"contentModel": {
+		"contents": [
+			{
+				"optional": "#text"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLFormControlElementAttrs": [
+			"autocomplete",
+			"dirname",
+			"disabled",
+			"form",
+			"maxlength",
+			"minlength",
+			"name",
+			"readonly",
+			"required"
+		]
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-textarea-cols",
+		"cols": {
+			"type": {
+				"type": "integer",
+				"gt": 0
+			},
+			"defaultValue": "20"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-textarea-placeholder",
+		"placeholder": {
+			"type": "Any"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-textarea-rows",
+		"rows": {
+			"type": {
+				"type": "integer",
+				"gt": 0
+			},
+			"defaultValue": "2"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-textarea-wrap",
+		"wrap": {
+			"type": {
+				"enum": ["soft", "hard"],
+				"missingValueDefault": "soft",
+				"invalidValueDefault": "soft"
+			}
+		}
+	},
+	"aria": {
+		"implicitRole": "textbox",
+		"permittedRoles": false,
+		"properties": {
+			"global": true,
+			"role": "textbox"
+		}
+	}
+}

package/src/spec.tfoot.json

@@ -0,0 +1,23 @@
+// https://html.spec.whatwg.org/multipage/tables.html#the-tfoot-element
+// https://www.w3.org/TR/html-aria/#el-tfoot
+// https://w3c.github.io/html-aria/#el-tfoot
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "tr"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "rowgroup",
+		"permittedRoles": true
+	}
+}

package/src/spec.th.json

@@ -0,0 +1,67 @@
+// https://html.spec.whatwg.org/multipage/tables.html#the-th-elemen
+// https://www.w3.org/TR/html-aria/#el-th
+// https://w3c.github.io/html-aria/#el-th
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#flow",
+				"notAllowedDescendants": ["header", "footer", "#sectioning", "#heading"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLTableCellElementAttrs": ["colspan", "rowspan", "headers"]
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/tables.html#attr-th-scope
+		"scope": {
+			"type": {
+				"enum": ["row", "col", "rowgroup", "colgroup"],
+				"missingValueDefault": "auto",
+				"invalidValueDefault": "auto"
+			}
+		},
+		// https://html.spec.whatwg.org/multipage/tables.html#attr-th-abbr
+		"abbr": {
+			"type": "Any"
+		}
+	},
+	"aria": {
+		// No corresponding role if the ancestor table element is not exposed as a role=table, grid or treegrid.
+		"implicitRole": false,
+		// No role if the ancestor table element has role=table, grid, or treegrid; otherwise any role.
+		"permittedRoles": true,
+		// role=columnheader, rowheader or cell if the ancestor table element is exposed as a role=table.
+		// role=columnheader, rowheader or gridcell if the ancestor table element is exposed as a role=grid or treegrid.
+		"conditions": {
+			"table:is(:not([role]), [role=table]) > :is(thead, tfoot, tbody) > tr > th": {
+				"implicitRole": "cell"
+			},
+			"table:is([role=grid], [role=treegrid]) > :is(thead, tfoot, tbody) > tr > th": {
+				"implicitRole": "gridcell"
+			},
+			"table:is(:not([role]), [role=table], [role=grid], [role=treegrid]) > thead > tr > th:not([scope])": {
+				"implicitRole": "columnheader"
+			},
+			"table:is(:not([role]), [role=table], [role=grid], [role=treegrid]) > :is(tfoot, tbody) > tr > th:not([scope])": {
+				"implicitRole": "rowheader"
+			},
+			// https://www.w3.org/TR/wai-aria-1.1/#columnheader Base Concept: HTML th[scope="col"]
+			"table:is(:not([role]), [role=table], [role=grid], [role=treegrid]) > :is(thead, tfoot, tbody) > tr > th[scope=col]": {
+				"implicitRole": "columnheader"
+			},
+			// https://www.w3.org/TR/wai-aria-1.1/#rowheader Base Concept: HTML th[scope="row"]
+			"table:is(:not([role]), [role=table], [role=grid], [role=treegrid]) > :is(thead, tfoot, tbody) > tr > th[scope=row]": {
+				"implicitRole": "rowheader"
+			},
+			"table:is(:not([role]), [role=table], [role=grid], [role=treegrid]) > :is(thead, tfoot, tbody) > tr > th": {
+				"permittedRoles": false
+			}
+		}
+	}
+}

package/src/spec.thead.json

@@ -0,0 +1,23 @@
+// https://html.spec.whatwg.org/multipage/tables.html#the-thead-element
+// https://www.w3.org/TR/html-aria/#el-thead
+// https://w3c.github.io/html-aria/#el-thead
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "tr"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "rowgroup",
+		"permittedRoles": true
+	}
+}

package/src/spec.time.json

@@ -0,0 +1,32 @@
+// https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-time-element
+// https://www.w3.org/TR/html-aria/#el-time
+// https://w3c.github.io/html-aria/#el-time
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#phrasing"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/text-level-semantics.html#attr-time-datetime
+		"datetime": {
+			"type": "DateTime"
+		}
+	},
+	"aria": {
+		"implicitRole": "time",
+		"permittedRoles": true,
+		"namingProhibited": true,
+		"1.1": {
+			"implicitRole": false
+		}
+	}
+}