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

package/src/spec.section.json

@@ -0,0 +1,73 @@
+// https://html.spec.whatwg.org/multipage/sections.html#the-section-element
+// https://www.w3.org/TR/html-aria/#el-section
+// https://w3c.github.io/html-aria/#el-section
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#flow"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		// role=region if the section element has an accessible name. Otherwise, no corresponding role.
+		"implicitRole": false,
+		"permittedRoles": [
+			"alert",
+			"alertdialog",
+			"application",
+			"banner",
+			"complementary",
+			"contentinfo",
+			"dialog",
+			"document",
+			"feed",
+			"group",
+			"log",
+			"main",
+			"marquee",
+			"navigation",
+			"none",
+			"note",
+			"presentation",
+			"search",
+			"status",
+			"tabpanel"
+		],
+		"conditions": {
+			":aria(has name)": {
+				"implicitRole": "region"
+			}
+		},
+		"1.1": {
+			"permittedRoles": [
+				"alert",
+				"alertdialog",
+				"application",
+				"banner",
+				"complementary",
+				"contentinfo",
+				"dialog",
+				"document",
+				"feed",
+				"log",
+				"main",
+				"marquee",
+				"navigation",
+				"none",
+				"note",
+				"presentation",
+				"search",
+				"status",
+				"tabpanel"
+			]
+		}
+	}
+}

package/src/spec.select.json

@@ -0,0 +1,66 @@
+// https://html.spec.whatwg.org/multipage/form-elements.html#the-select-element
+// https://www.w3.org/TR/html-aria/#el-select
+// https://w3c.github.io/html-aria/#el-select
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": ["option", "optgroup"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLFormControlElementAttrs": ["autocomplete", "disabled", "form", "name", "required"]
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-select-multiple
+		"multiple": {
+			"type": "Boolean"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-select-size
+		"size": {
+			"type": {
+				"type": "integer",
+				"gt": 0
+			}
+		}
+	},
+	"aria": {
+		"implicitRole": "combobox",
+		"permittedRoles": ["menu"],
+		"properties": {
+			// Otherwise, any global aria-* attributes and any other aria-* attributes applicable to the combobox or menu role.
+			"global": true,
+			"role": ["combobox", "menu"],
+			// Authors SHOULD NOT use the aria-multiselectable attribute on a select element.
+			"whithout": [
+				{
+					"type": "should-not",
+					"name": "aria-multiselectable"
+				}
+			]
+		},
+		"conditions": {
+			"[multiple], [size]:not([size=1])": {
+				"implicitRole": "listbox",
+				"permittedRoles": false,
+				"properties": {
+					// Otherwise, any global aria-* attributes and any other aria-* attributes applicable to the listbox role.
+					"global": true,
+					"role": "listbox",
+					// Authors SHOULD NOT use the aria-multiselectable attribute on a select element.
+					"whithout": [
+						{
+							"type": "should-not",
+							"name": "aria-multiselectable"
+						}
+					]
+				}
+			}
+		}
+	}
+}

package/src/spec.slot.json

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

package/src/spec.small.json

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

package/src/spec.source.json

@@ -0,0 +1,52 @@
+// https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source
+// https://www.w3.org/TR/html-aria/#el-source
+// https://w3c.github.io/html-aria/#el-source
+{
+	"contentModel": {
+		"contents": false
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLEmbededAndMediaContentAttrs": ["height", "srcset", "sizes", "width"]
+	},
+	"attributes": {
+		"type": {
+			// https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-type
+			"type": "MIMEType"
+		},
+		"src": {
+			// https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-src
+			"type": "URL",
+			"required": ":is(video, audio) > source"
+		},
+		"srcset": {
+			// https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-srcset
+			"condition": "picture > source"
+		},
+		"sizes": {
+			// https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-sizes
+			"condition": "picture > source"
+		},
+		"media": {
+			// https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-media
+			"type": "<media-query-list>",
+			"condition": "picture > source"
+		},
+		"width": {
+			// https://html.spec.whatwg.org/multipage/embedded-content-other.html#attr-dim-width
+			"condition": "picture > source"
+		},
+		"height": {
+			// https://html.spec.whatwg.org/multipage/embedded-content-other.html#attr-dim-height
+			"condition": "picture > source"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
+}

package/src/spec.span.json

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

package/src/spec.strong.json

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

package/src/spec.style.json

@@ -0,0 +1,35 @@
+// https://html.spec.whatwg.org/multipage/semantics.html#the-style-element
+// https://www.w3.org/TR/html-aria/#el-style
+// https://w3c.github.io/html-aria/#el-style
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#text"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-style-media
+		"media": {
+			"type": "<media-query-list>"
+		},
+		// https://html.spec.whatwg.org/multipage/urls-and-fetching.html#render-blocking
+		"blocking": {
+			"type": {
+				"enum": ["render"]
+			}
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
+}

package/src/spec.sub.json

@@ -0,0 +1,27 @@
+// https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-sub-and-sup-elements
+// https://www.w3.org/TR/html-aria/#el-sub
+// https://w3c.github.io/html-aria/#el-sub
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#phrasing"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "subscript",
+		"permittedRoles": true,
+		"namingProhibited": true,
+		"1.1": {
+			"implicitRole": false
+		}
+	}
+}

package/src/spec.summary.json

@@ -0,0 +1,38 @@
+// https://html.spec.whatwg.org/multipage/interactive-elements.html#the-summary-element
+// https://www.w3.org/TR/html-aria/#el-summary
+// https://w3c.github.io/html-aria/#el-summary
+{
+	"contentModel": {
+		"contents": [
+			{
+				"choice": [
+					[
+						{
+							"zeroOrMore": "#phrasing"
+						}
+					],
+					[
+						{
+							"require": "#heading"
+						}
+					]
+				]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "button",
+		"permittedRoles": false,
+		"properties": {
+			"global": true,
+			"role": "button"
+		}
+	}
+}

package/src/spec.sup.json

@@ -0,0 +1,27 @@
+// https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-sub-and-sup-elements
+// https://www.w3.org/TR/html-aria/#el-sup
+// https://w3c.github.io/html-aria/#el-sup
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#phrasing"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "superscript",
+		"permittedRoles": true,
+		"namingProhibited": true,
+		"1.1": {
+			"implicitRole": false
+		}
+	}
+}

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

@@ -1,7 +1,25 @@
+// https://svgwg.org/svg2-draft/linking.html#elementdef-a
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-0
 {
-	"tag": "a",
-	"ref": "https://svgwg.org/svg2-draft/linking.html#elementdef-a",
-	"global": {
+	"contentModel": {
+		"conditional": [
+			{
+				"condition": "svg|switch > svg|a",
+				"contents": [
+					{
+						"zeroOrMore": "#transparent"
+					}
+				]
+			}
+		],
+		"contents": [
+			{
+				"zeroOrMore": ["#SVGDescriptive", "#transparent"],
+				"ignore": "svg|a"
+			}
+		]
+	},
+	"globalAttrs": {
 		"#HTMLGlobalAttrs": true,
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
@@ -81,5 +99,21 @@
 		"#XLinkAttrs": ["xlink:href", "xlink:title"],
 		"#HTMLLinkAndFetchingAttrs": ["href", "target", "download", "ping", "rel", "hreflang", "type", "referrerpolicy"]
 	},
-	"attributes": {}
+	"attributes": {},
+	"aria": {
+		// link role if the element has a valid href or xlink:href attribute.
+		// For a elements that are not links,
+		// use the mapping for tspan if the a element is a descendent of text,
+		// or the mapping for g otherwise.
+		"implicitRole": "group",
+		"permittedRoles": {
+			"core-aam": true,
+			"graphics-aam": true
+		},
+		"conditions": {
+			"[href], [xlink|href]": {
+				"implicitRole": "link"
+			}
+		}
+	}
 }

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

@@ -1,7 +1,14 @@
+// https://svgwg.org/specs/animations/#AnimateElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-1
 {
-	"tag": "animate",
-	"ref": "https://svgwg.org/specs/animations/#AnimateElement",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": ["#SVGDescriptive", "svg|script"]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
 		"#SVGAnimationAdditionAttrs": ["additive", "accumulate"],
@@ -93,5 +100,10 @@
 			"writing-mode"
 		]
 	},
-	"attributes": {}
+	"attributes": {},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
 }

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

@@ -1,7 +1,31 @@
+// https://svgwg.org/specs/animations/#AnimateMotionElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-2
 {
-	"tag": "animateMotion",
-	"ref": "https://svgwg.org/specs/animations/#AnimateMotionElement",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"interleave": [
+					[
+						{
+							"oneOrMore": ["#SVGDescriptive", "svg|script"]
+						},
+						{
+							"optional": "svg|mpath"
+						}
+					],
+					[
+						{
+							"optional": "svg|mpath"
+						},
+						{
+							"oneOrMore": ["#SVGDescriptive", "svg|script"]
+						}
+					]
+				]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
 		"#SVGAnimationAdditionAttrs": ["additive", "accumulate"],
@@ -23,22 +47,27 @@
 		"#SVGCoreAttrs": ["id", "tabindex", "autofocus", "lang", "xml:space", "class", "style"]
 	},
 	"attributes": {
+		// https://svgwg.org/specs/animations/#AnimateMotionElementPathAttribute
 		"path": {
-			"ref": "https://svgwg.org/specs/animations/#AnimateMotionElementPathAttribute",
 			"type": "<svg-path>"
 		},
+		// https://svgwg.org/specs/animations/#KeyPointsAttribute
 		"keyPoints": {
-			"ref": "https://svgwg.org/specs/animations/#KeyPointsAttribute",
 			"type": "<key-points>"
 		},
+		// https://svgwg.org/specs/animations/#RotateAttribute
 		"rotate": {
-			"ref": "https://svgwg.org/specs/animations/#RotateAttribute",
 			"type": "<rotate>"
 		},
+		// https://svgwg.org/specs/animations/#OriginAttribute
 		"origin": {
-			"ref": "https://svgwg.org/specs/animations/#OriginAttribute",
 			"type": "<origin>",
 			"defaultValue": "default"
 		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
 	}
 }

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

@@ -1,7 +1,14 @@
+// https://svgwg.org/specs/animations/#AnimateTransformElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-3
 {
-	"tag": "animateTransform",
-	"ref": "https://svgwg.org/specs/animations/#AnimateTransformElement",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": ["#SVGDescriptive", "svg|script"]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
 		"#SVGAnimationAdditionAttrs": ["additive", "accumulate"],
@@ -24,12 +31,17 @@
 		"#SVGCoreAttrs": ["id", "tabindex", "autofocus", "lang", "xml:space", "class", "style"]
 	},
 	"attributes": {
+		// https://svgwg.org/specs/animations/#AnimateTransformElementTypeAttribute
 		"type": {
-			"ref": "https://svgwg.org/specs/animations/#AnimateTransformElementTypeAttribute",
 			"type": {
 				"enum": ["translate", "scale", "rotate", "skewX", "skewY"]
 			},
 			"defaultValue": "translate"
 		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
 	}
 }

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

@@ -1,7 +1,23 @@
+// https://svgwg.org/svg2-draft/shapes.html#CircleElement
+// https://www.w3.org/TR/svg-aam-1.0/#details-id-6
 {
-	"tag": "circle",
-	"ref": "https://svgwg.org/svg2-draft/shapes.html#CircleElement",
-	"global": {
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": [
+					"#SVGAnimation",
+					"#SVGDescriptive",
+					"#SVGPaintServer",
+					"svg|clipPath",
+					"svg|marker",
+					"svg|mask",
+					"svg|script",
+					"svg|style"
+				]
+			}
+		]
+	},
+	"globalAttrs": {
 		"#HTMLGlobalAttrs": true,
 		"#GlobalEventAttrs": true,
 		"#DocumentElementEventAttrs": true,
@@ -83,10 +99,15 @@
 		]
 	},
 	"attributes": {
+		// https://svgwg.org/svg2-draft/paths.html#PathLengthAttribute
 		"pathLength": {
-			"ref": "https://svgwg.org/svg2-draft/paths.html#PathLengthAttribute",
 			"type": "<number>",
 			"animatable": true
 		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
 	}
 }