@markuplint/html-spec 5.0.0-alpha.3 → 5.0.0-rc.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-rc.0](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.3...v5.0.0-rc.0) (2026-03-12)
+
+### Features
+
+- **html-spec:** add experimental focusgroup and focusgroupstart global attributes ([ff406f1](https://github.com/markuplint/markuplint/commit/ff406f1be43c9669e57ea0f05de161b797fc5ecc)), closes [#3384](https://github.com/markuplint/markuplint/issues/3384)
+
 # [5.0.0-alpha.3](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.2...v5.0.0-alpha.3) (2026-02-26)
 
 **Note:** Version bump only for package @markuplint/html-spec

package/docs/element-spec-format.ja.md

@@ -362,16 +362,20 @@ spec.mml_mn.jsonc       # <mml:mn> 要素
 
 スペースまたはカンマ区切りのトークンリストを定義します。
 
-| フィールド        | 型                   | 説明                          |
-| ----------------- | -------------------- | ----------------------------- |
-| `token`           | `string`             | トークンの型名                |
-| `separator`       | `"space" \| "comma"` | 区切り文字                    |
-| `unique`          | `boolean`            | 重複を許可しない              |
-| `caseInsensitive` | `boolean`            | 大文字小文字を区別しない      |
-| `ordered`         | `boolean`            | 順序が重要                    |
-| `number`          | `string`             | 個数制約（`"zeroOrMore"` 等） |
+| フィールド        | 型                       | 説明                                                                      |
+| ----------------- | ------------------------ | ------------------------------------------------------------------------- |
+| `token`           | `string \| { enum: [] }` | トークンの型名（文字列）、またはインライン列挙定義（`enum` オブジェクト） |
+| `separator`       | `"space" \| "comma"`     | 区切り文字                                                                |
+| `unique`          | `boolean`                | 重複を許可しない                                                          |
+| `caseInsensitive` | `boolean`                | 大文字小文字を区別しない                                                  |
+| `ordered`         | `boolean`                | 順序が重要                                                                |
+| `number`          | `string`                 | 個数制約（`"zeroOrMore"` 等）                                             |
+
+`token` が文字列の場合、名前付き型（例: `"Accept"`, `"DOMID"`）を参照します。
+`token` が `enum` を含むオブジェクトの場合、許可されるキーワードのセットをインラインで定義します:
 
 ```jsonc
+// 文字列型名を参照する例
 "accept": {
   "type": {
     "token": "Accept",
@@ -381,6 +385,20 @@ spec.mml_mn.jsonc       # <mml:mn> 要素
   },
   "condition": "[type='file' i]"
 }
+
+// インライン列挙定義の例
+"focusgroup": {
+  "type": {
+    "token": {
+      "enum": ["toolbar", "tablist", "radiogroup", "listbox", "menu", "menubar", "none",
+               "inline", "block", "wrap", "nowrap", "nomemory"]
+    },
+    "separator": "space",
+    "unique": true,
+    "caseInsensitive": true
+  },
+  "experimental": true
+}
 ```
 
 #### 数値制約型

package/docs/element-spec-format.md

@@ -263,14 +263,25 @@ set that particular flag.
 { "token": "Accept", "separator": "comma", "unique": true, "caseInsensitive": true }
 ```
 
-| Field             | Description                                      |
-| ----------------- | ------------------------------------------------ |
-| `token`           | Token type name                                  |
-| `separator`       | `"space"` or `"comma"`                           |
-| `unique`          | Whether tokens must be unique                    |
-| `caseInsensitive` | Whether matching is case-insensitive             |
-| `ordered`         | Whether order matters                            |
-| `number`          | Cardinality: `"zeroOrMore"`, `"oneOrMore"`, etc. |
+| Field             | Description                                                             |
+| ----------------- | ----------------------------------------------------------------------- |
+| `token`           | Token type: a string (type name) or an object with `enum` (inline enum) |
+| `separator`       | `"space"` or `"comma"`                                                  |
+| `unique`          | Whether tokens must be unique                                           |
+| `caseInsensitive` | Whether matching is case-insensitive                                    |
+| `ordered`         | Whether order matters                                                   |
+| `number`          | Cardinality: `"zeroOrMore"`, `"oneOrMore"`, etc.                        |
+
+When `token` is a string, it references a named type (e.g., `"Accept"`, `"DOMID"`).
+When `token` is an object with `enum`, it defines an inline set of allowed keywords:
+
+```json
+{
+  "token": { "enum": ["allow-forms", "allow-scripts", "allow-popups"] },
+  "separator": "space",
+  "unique": true
+}
+```
 
 **Number constraint type:**
 

package/index.json

@@ -308,6 +308,34 @@
 						"enum": ["enter", "done", "go", "next", "previous", "search", "send"]
 					}
 				},
+				"focusgroup": {
+					"type": {
+						"token": {
+							"enum": [
+								"toolbar",
+								"tablist",
+								"radiogroup",
+								"listbox",
+								"menu",
+								"menubar",
+								"none",
+								"inline",
+								"block",
+								"wrap",
+								"nowrap",
+								"nomemory"
+							]
+						},
+						"separator": "space",
+						"unique": true,
+						"caseInsensitive": true
+					},
+					"experimental": true
+				},
+				"focusgroupstart": {
+					"type": "Boolean",
+					"experimental": true
+				},
 				"headingoffset": {
 					"type": {
 						"type": "integer",
@@ -5202,7 +5230,7 @@
 					},
 					{
 						"name": "group",
-						"description": "A set of user interface objects that is not intended to be included in a page summary or table of contents by assistive technologies.\n\nContrast with region, which is a grouping of user interface objects that will be included in a page summary or table of contents.\n\nAuthors SHOULD use a group to form a logical collection of items in a widget, such as children in a tree widget forming a collection of siblings in a hierarchy. However, when a group is used in the context of a listbox, for example, authors MUST limit its children to option elements. Therefore, proper handling of group by authors and assistive technologies is determined by the context in which it is provided.\n\nAuthors MAY nest group elements. If a section is significant enough to warrant inclusion in the web page's table of contents, the author SHOULD assign it a role of region or a standard landmark role.",
+						"description": "A set of user interface objects and information that is not intended to be included in a page summary or table of contents by assistive technologies.\n\nContrast with region, which is a grouping of user interface objects and information that will be included in a page summary or table of contents.\n\nAuthors SHOULD use a group to form a logical collection of items in a widget, such as children in a tree widget forming a collection of siblings in a hierarchy. However, when a group is used in the context of a listbox, for example, authors MUST limit its children to option elements. Therefore, proper handling of group by authors and assistive technologies is determined by the context in which it is provided.\n\nAuthors MAY nest group elements. If a section is significant enough to warrant inclusion in the web page's table of contents, the author SHOULD assign it a role of region or a standard landmark role.",
 						"generalization": ["section"],
 						"requiredContextRole": [],
 						"requiredOwnedElements": [],
@@ -8707,7 +8735,7 @@
 					},
 					{
 						"name": "radiogroup",
-						"description": "A group of radio buttons.\n\nA radiogroup is a type of select list that can only have a single entry checked at any one time. Authors SHOULD enforce that only one radio button in a group can be checked at the same time. When one item in the group is checked, the previously checked item becomes unchecked (its aria-checked attribute becomes false).\n\nAuthors SHOULD provide an accessible name for a radiogroup, which can be done with the aria-label or aria-labelledby attribute. Authors SHOULD reference a visible label with aria-labelledby if a visible label is present for the radiogroup.",
+						"description": "A group of radio buttons.\n\nA radiogroup is a type of select list that can only have a single entry checked at any one time. Authors SHOULD enforce that only one radio button in a group can be checked at the same time. When one item in the group is checked, the previously checked item becomes unchecked (its aria-checked attribute becomes false).\n\nAuthors SHOULD provide an accessible name for a radiogroup, which can be done with the aria-label or aria-labelledby attribute. Authors SHOULD reference a visible label with aria-labelledby if a visible label is present for the radiogroup.\n\nWhile a radiogroup is primarily meant to group and thus associate related radio buttons, a radiogroup can contain other non-radio button elements. For instance, descriptive text beyond what serves as the radio button's label, or even in some cases, form controls or other information that are enabled, revealed or both when a specific radio button has been chosen (checked).\n\nHowever, including non-radio button content into a radiogroup is not without its potential UX drawbacks. As it is generally expected to use arrow keys to navigate between radio buttons, any non-radio button content could go unnoticed by some users, as arrowing through the radio buttons would mean that any other tabbable elements (e.g., hyperlinks or other form fields) would be skipped. When creating a radiogroup with other arbitrary content, consider if the non-radio content could be just as impactful if it was presented as an immediate sibling after the radiogroup.",
 						"generalization": ["select"],
 						"requiredContextRole": [],
 						"requiredOwnedElements": [],
@@ -52706,7 +52734,7 @@
 			},
 			"attributes": {
 				"as": {
-					"description": "This attribute is required when rel=\"preload\" has been set on the <link> element, optional when rel=\"modulepreload\" has been set, and otherwise should not be used. It specifies the type of content being loaded by the <link>, which is necessary for request matching, application of correct content security policy, and setting of correct Accept request header. Furthermore, rel=\"preload\" uses this as a signal for request prioritization. The table below lists the valid values for this attribute and the elements or resources they apply to. Value Applies To audio <audio> elements document <iframe> and <frame> elements embed <embed> elements fetch fetch, XHR Note: This value also requires <link> to contain the crossorigin attribute, see CORS-enabled fetches. font CSS @font-face Note: This value also requires <link> to contain the crossorigin attribute, see CORS-enabled fetches. image <img> and <picture> elements with srcset or imageset attributes, SVG <image> elements, CSS *-image rules object <object> elements script <script> elements, Worker importScripts style <link rel=stylesheet> elements, CSS @import track <track> elements video <video> elements worker Worker, SharedWorker",
+					"description": "This attribute is required when rel=\"preload\" has been set on the <link> element, optional when rel=\"modulepreload\" has been set, and otherwise should not be used. It specifies the type of content being loaded by the <link>, which is necessary for request matching, application of correct content security policy, and setting of correct Accept request header. Furthermore, rel=\"preload\" uses this as a signal for request prioritization. The table below lists the valid values for this attribute and the elements or resources they apply to. Value Applies To audio <audio> elements document <iframe> and <frame> elements embed <embed> elements fetch fetch, XHR Note: This value also requires <link> to contain the crossorigin attribute, see CORS-enabled fetches. font CSS @font-face Note: This value also requires <link> to contain the crossorigin attribute, see CORS-enabled fetches. image <img> and <picture> elements with srcset or imageset attributes, SVG <image> elements, CSS *-image rules json modulepreload destinations. object <object> elements script <script> elements, Worker importScripts, and modulepreload destinations. style <link rel=stylesheet> elements, CSS @import and modulepreload destinations. track <track> elements video <video> elements worker Worker, SharedWorker",
 					"type": {
 						"enum": [
 							"audioworklet",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/html-spec",
-	"version": "5.0.0-alpha.3",
+	"version": "5.0.0-rc.0",
 	"description": "A specification of HTML Living Standard for markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -29,12 +29,12 @@
 		"gen:prettier": "npx prettier --write index.json"
 	},
 	"devDependencies": {
-		"@markuplint/spec-generator": "5.0.0-alpha.3",
-		"@markuplint/test-tools": "5.0.0-alpha.3",
+		"@markuplint/spec-generator": "5.0.0-rc.0",
+		"@markuplint/test-tools": "5.0.0-rc.0",
 		"jsonc-parser": "3.3.1"
 	},
 	"dependencies": {
-		"@markuplint/ml-spec": "5.0.0-alpha.3"
+		"@markuplint/ml-spec": "5.0.0-rc.0"
 	},
-	"gitHead": "2fbdf26daa3d021ac628ccc2f59f0eeae6ddd53d"
+	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
 }