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

package/src/spec.ins.json

@@ -0,0 +1,36 @@
+// https://html.spec.whatwg.org/multipage/edits.html#the-ins-element
+// https://www.w3.org/TR/html-aria/#el-ins
+// https://w3c.github.io/html-aria/#el-ins
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#transparent"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		"cite": {
+			// https://html.spec.whatwg.org/multipage/edits.html#attr-mod-cite
+			"type": "URL"
+		},
+		"datetime": {
+			// https://html.spec.whatwg.org/multipage/edits.html#attr-mod-datetime
+			"type": "DateTime"
+		}
+	},
+	"aria": {
+		"implicitRole": "insertion",
+		"permittedRoles": true,
+		"namingProhibited": true,
+		"1.1": {
+			"implicitRole": false
+		}
+	}
+}

package/src/spec.kbd.json

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

package/src/spec.label.json

@@ -0,0 +1,30 @@
+// https://html.spec.whatwg.org/multipage/forms.html#the-label-element
+// https://www.w3.org/TR/html-aria/#el-label
+// https://w3c.github.io/html-aria/#el-label
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#phrasing",
+				"notAllowedDescendants": ["label"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/forms.html#attr-label-for
+		"for": {
+			"type": "DOMID"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"namingProhibited": true
+	}
+}

package/src/spec.legend.json

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

package/src/spec.li.json

@@ -0,0 +1,40 @@
+// https://html.spec.whatwg.org/multipage/grouping-content.html#the-li-element
+// https://www.w3.org/TR/html-aria/#el-li
+// https://w3c.github.io/html-aria/#el-li
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#flow"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/grouping-content.html#attr-li-value
+		"value": {
+			"type": "Int",
+			"condition": "ol > li"
+		}
+	},
+	"aria": {
+		"implicitRole": "listitem",
+		"permittedRoles": [
+			"menuitem",
+			"menuitemcheckbox",
+			"menuitemradio",
+			"option",
+			"none",
+			"presentation",
+			"radio",
+			"separator",
+			"tab",
+			"treeitem"
+		]
+	}
+}

package/src/spec.link.json

@@ -0,0 +1,140 @@
+// https://html.spec.whatwg.org/multipage/semantics.html#the-link-element
+// https://www.w3.org/TR/html-aria/#el-link
+// https://w3c.github.io/html-aria/#el-link
+{
+	"contentModel": {
+		"contents": false
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLLinkAndFetchingAttrs": [
+			"crossorigin",
+			"href",
+			"hreflang",
+			"type",
+			"referrerpolicy",
+			"integrity",
+			"media",
+			"fetchpriority"
+		]
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-rel
+		"rel": {
+			"type": [
+				"Any",
+				{
+					"token": {
+						"enum": [
+							"alternate",
+							"canonical",
+							"author",
+							"dns-prefetch",
+							"help",
+							"icon",
+							"manifest",
+							"modulepreload",
+							"license",
+							"next",
+							"pingback",
+							"preconnect",
+							"prefetch",
+							"preload",
+							"prerender",
+							"prev",
+							"search",
+							"stylesheet"
+						]
+					},
+					"unique": true,
+					"separator": "space"
+				}
+			],
+			"requiredEither": ["itemprop"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#the-link-element:names:-the-itemprop-attribute
+		"itemprop": {
+			"requiredEither": ["rel"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-integrity
+		"integrity": {
+			"condition": ["[rel~='stylesheet' i]", "[rel~='preload' i]", "[rel~='modulepreload' i]"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-sizes
+		"sizes": {
+			"type": {
+				"token": "IconSize",
+				"caseInsensitive": true,
+				"ordered": false,
+				"unique": true,
+				"separator": "space"
+			},
+			"condition": ["[rel~='icon' i]", "[rel~='apple-touch-icon' i]"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-imagesrcset
+		"imagesrcset": {
+			"type": "Srcset",
+			"condition": "[imagesizes][rel~='preload' i][as='image' i]",
+			"required": "[imagesizes]"
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-imagesizes
+		"imagesizes": {
+			"type": "SourceSizeList",
+			"condition": "[imagesrcset][rel~='preload' i][as='image' i]",
+			"required": "[imagesrcset]"
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-as
+		"as": {
+			"type": {
+				"enum": [
+					"fetch",
+					"audio",
+					"audioworklet",
+					"document",
+					"embed",
+					"font",
+					"frame",
+					"iframe",
+					"image",
+					"manifest",
+					"object",
+					"paintworklet",
+					"report",
+					"script",
+					"serviceworker",
+					"sharedworker",
+					"style",
+					"track",
+					"video",
+					"worker",
+					"xslt"
+				]
+			},
+			// If the rel attribute is modulepreload, invalidValueDefault and missingValueDefault will be `script`
+			"condition": ["[rel='preload' i]", "[rel='modulepreload' i]"]
+		},
+		// https://html.spec.whatwg.org/multipage/urls-and-fetching.html#render-blocking
+		"blocking": {
+			"type": {
+				"enum": ["render"]
+			}
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-color
+		"color": {
+			"type": "<color>",
+			"condition": "[rel~='mask-icon' i]"
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-link-disabled
+		"disabled": {
+			"type": "Boolean"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
+}

package/src/spec.main.json

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

package/src/spec.map.json

@@ -0,0 +1,30 @@
+// https://html.spec.whatwg.org/multipage/image-maps.html#attr-map-name
+// https://www.w3.org/TR/html-aria/#el-map
+// https://w3c.github.io/html-aria/#el-map
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#transparent"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/image-maps.html#attr-map-name
+		"name": {
+			// TODO: "The value must not include whitespace"
+			"type": "NoEmptyAny"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
+}

package/src/spec.mark.json

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

package/src/spec.math.json

@@ -0,0 +1,20 @@
+// https://momdo.github.io/html/embedded-content-other.html#mathml
+// https://www.w3.org/TR/html-aria/#el-math
+// https://w3c.github.io/html-aria/#el-math
+{
+	"contentModel": {
+		"contents": true
+	},
+	"globalAttrs": {
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "math",
+		"permittedRoles": false,
+		"properties": {
+			"global": true,
+			"role": "math"
+		}
+	}
+}

package/src/spec.menu.json

@@ -0,0 +1,53 @@
+// https://html.spec.whatwg.org/multipage/grouping-content.html#the-menu-element
+// https://www.w3.org/TR/html-aria/#el-menu
+// https://w3c.github.io/html-aria/#el-menu
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": ["li", "#script-supporting"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "list",
+		"permittedRoles": [
+			"group",
+			"listbox",
+			"menu",
+			"menubar",
+			"none",
+			"presentation",
+			"radiogroup",
+			"tablist",
+			"toolbar",
+			"tree",
+			{
+				"name": "directory",
+				"deprecated": true
+			}
+		],
+		"1.1": {
+			"permittedRoles": [
+				"directory",
+				"group",
+				"listbox",
+				"menu",
+				"menubar",
+				"none",
+				"presentation",
+				"radiogroup",
+				"tablist",
+				"toolbar",
+				"tree"
+			]
+		}
+	}
+}

package/src/spec.meta.json

@@ -0,0 +1,59 @@
+// https://html.spec.whatwg.org/multipage/semantics.html#the-meta-element
+// https://www.w3.org/TR/html-aria/#el-meta
+// https://w3c.github.io/html-aria/#el-meta
+{
+	"contentModel": {
+		"contents": false
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLLinkAndFetchingAttrs": ["media"]
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/semantics.html#the-meta-element:names:-the-itemprop-attribute-5
+		"itemprop": {
+			"requiredEither": ["name", "http-equiv", "charset"],
+			"condition": [":not([name])", ":not([http-equiv])", ":not([charset])"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-meta-name
+		"name": {
+			"type": "Any",
+			"requiredEither": ["itemprop", "http-equiv", "charset"],
+			"condition": [":not([itemprop])", ":not([http-equiv])", ":not([charset])"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-meta-http-equiv
+		"http-equiv": {
+			"type": {
+				"enum": ["content-type", "default-style", "refresh", "x-ua-compatible", "content-security-policy"]
+			},
+			"requiredEither": ["itemprop", "name", "charset"],
+			"condition": [":not([itemprop])", ":not([name])", ":not([charset])"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-meta-content
+		"content": {
+			"type": "Any",
+			"required": ["[name]", "[http-equiv]", "[itemprop]"],
+			"condition": ["[name]", "[http-equiv]", "[itemprop]"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-meta-charset
+		"charset": {
+			"type": {
+				"enum": ["utf-8"],
+				"caseInsensitive": true
+			},
+			"condition": [":not([itemprop])", ":not([name])", ":not([http-equiv])"]
+		},
+		// https://html.spec.whatwg.org/multipage/semantics.html#attr-meta-media
+		"media": {
+			"condition": "[name='theme-color']"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": false
+	}
+}

package/src/spec.meter.json

@@ -0,0 +1,63 @@
+// https://html.spec.whatwg.org/multipage/form-elements.html#the-meter-element
+// https://www.w3.org/TR/html-aria/#el-meter
+// https://w3c.github.io/html-aria/#el-meter
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#phrasing",
+				"notAllowedDescendants": ["meter"]
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-meter-value
+		"value": {
+			"type": "Number"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-meter-min
+		"min": {
+			"type": "Number"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-meter-max
+		"max": {
+			"type": "Number"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-meter-low
+		"low": {
+			"type": "Number"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-meter-high
+		"high": {
+			"type": "Number"
+		},
+		// https://html.spec.whatwg.org/multipage/form-elements.html#attr-meter-optimum
+		"optimum": {
+			"type": "Number"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": false,
+		"properties": {
+			"global": true,
+			// Authors SHOULD NOT use the aria-valuemax or aria-valuemin attributes on meter elements.
+			"whithout": [
+				{
+					"type": "should-not",
+					"name": "aria-valuemax"
+				},
+				{
+					"type": "should-not",
+					"name": "aria-valuemin"
+				}
+			]
+		}
+	}
+}

package/src/spec.nav.json

@@ -0,0 +1,26 @@
+// https://html.spec.whatwg.org/multipage/sections.html#the-nav-element
+// https://www.w3.org/TR/html-aria/#el-nav
+// https://w3c.github.io/html-aria/#el-nav
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#flow"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true
+	},
+	"attributes": {},
+	"aria": {
+		"implicitRole": "navigation",
+		"permittedRoles": ["menu", "menubar", "none", "presentation", "tablist"],
+		"1.1": {
+			"permittedRoles": ["menu", "menubar", "tablist"]
+		}
+	}
+}

package/src/spec.noscript.json

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

package/src/spec.object.json

@@ -0,0 +1,40 @@
+// https://html.spec.whatwg.org/multipage/iframe-embed-object.html#the-object-element
+// https://www.w3.org/TR/html-aria/#el-object
+// https://w3c.github.io/html-aria/#el-object
+{
+	"contentModel": {
+		"contents": [
+			{
+				"zeroOrMore": "#flow"
+			}
+		]
+	},
+	"globalAttrs": {
+		"#HTMLGlobalAttrs": true,
+		"#GlobalEventAttrs": true,
+		"#DocumentElementEventAttrs": true,
+		"#ARIAAttrs": true,
+		"#HTMLEmbededAndMediaContentAttrs": ["height", "width"],
+		"#HTMLFormControlElementAttrs": ["form"]
+	},
+	"attributes": {
+		// https://html.spec.whatwg.org/multipage/iframe-embed-object.html#attr-object-data
+		"data": {
+			"type": "URL",
+			"requiredEither": ["type"]
+		},
+		// https://html.spec.whatwg.org/multipage/iframe-embed-object.html#attr-object-type
+		"type": {
+			"type": "MIMEType",
+			"requiredEither": ["data"]
+		},
+		// https://html.spec.whatwg.org/multipage/iframe-embed-object.html#attr-object-name
+		"name": {
+			"type": "BrowsingContextName"
+		}
+	},
+	"aria": {
+		"implicitRole": false,
+		"permittedRoles": ["application", "document", "img"]
+	}
+}