@markuplint/html-spec 4.7.2 → 4.8.1-alpha.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [4.8.1-alpha.0](https://github.com/markuplint/markuplint/compare/@markuplint/html-spec@4.8.0...@markuplint/html-spec@4.8.1-alpha.0) (2024-06-02)
+
+**Note:** Version bump only for package @markuplint/html-spec
+
+
+
+
+
+# [4.8.0](https://github.com/markuplint/markuplint/compare/@markuplint/html-spec@4.7.2...@markuplint/html-spec@4.8.0) (2024-05-28)
+
+### Features
+
+- **html-spec:** add the new `shadowrootserializable` attribute to the `template` element ([0ffbace](https://github.com/markuplint/markuplint/commit/0ffbace70332dfc7394bdb79c58abf1695c7fe5b))
+- **html-spec:** exports JSON directly ([38489bb](https://github.com/markuplint/markuplint/commit/38489bbac006ecdfd5af6a4a55db5fb46c281202))
+
 ## [4.7.2](https://github.com/markuplint/markuplint/compare/@markuplint/html-spec@4.7.1...@markuplint/html-spec@4.7.2) (2024-05-12)
 
 **Note:** Version bump only for package @markuplint/html-spec

package/index.js

@@ -1,4 +1,4 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
+/* eslint-disable no-restricted-globals, unicorn/prefer-module */
 
 const json = require('./index.json');
 module.exports = json;

package/index.json

@@ -1754,7 +1754,7 @@
 					},
 					{
 						"name": "alertdialog",
-						"description": "A type of dialog that contains an alert message, where initial focus goes to an element within the dialog. See related alert and dialog.\n\nAlert dialogs are used to convey messages to alert the user. The alertdialog role goes on the node containing both the alert message and the rest of the dialog. Content authors SHOULD make alert dialogs modal by ensuring that, while the alertdialog is shown, keyboard and mouse interactions only operate within the dialog. See aria-modal.\n\nUnlike alert, alertdialog can receive a response from the user. For example, to confirm that the user understands the alert being generated. When the alert dialog is displayed, authors SHOULD set focus to an active element within the alert dialog, such as a form control or confirmation button. The user agent SHOULD fire a system alert event through the accessibility API when the alert is created, provided one is specified by the intended accessibility API.\n\nAuthors SHOULD use aria-describedby on an alertdialog to reference the alert message element in the dialog. If they do not, an assistive technology can resort to its internal recovery mechanism to determine the contents of the alert message.",
+						"description": "A type of dialog that contains an alert message, where initial focus goes to an element within the dialog. See related alert and dialog.\n\nAlert dialogs are used to convey messages to alert the user. The alertdialog role goes on the node containing both the alert message and the rest of the dialog. Authors SHOULD make alert dialogs modal by ensuring that, while the alertdialog is shown, keyboard and mouse interactions only operate within the dialog. See aria-modal.\n\nUnlike alert, alertdialog can receive a response from the user. For example, to confirm that the user understands the alert being generated. When the alert dialog is displayed, authors SHOULD set focus to an active element within the alert dialog, such as a form control or confirmation button. The user agent SHOULD fire a system alert event through the accessibility API when the alert is created, provided one is specified by the intended accessibility API.\n\nAuthors SHOULD use aria-describedby on an alertdialog to reference the alert message element in the dialog. If they do not, an assistive technology can resort to its internal recovery mechanism to determine the contents of the alert message.",
 						"generalization": ["alert", "dialog"],
 						"requiredContextRole": [],
 						"requiredOwnedElements": [],
@@ -5926,7 +5926,7 @@
 					},
 					{
 						"name": "link",
-						"description": "An interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource. See related button.\n\nIf this is a native link in the host language (such as an HTML anchor with an href value), activating the link causes the user agent to navigate to that resource. If this is a simulated link, the web application author is responsible for managing navigation.\n\nIf pressing the link triggers an action but does not change browser focus or page location, authors are advised to consider using the button role instead of the link role.",
+						"description": "An interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource. See related button.\n\nIf this is a native link in the host language (such as an HTML anchor with an href value), activating the link causes the user agent to navigate to that resource. If this is a simulated link, the author is responsible for managing navigation.\n\nIf pressing the link triggers an action but does not change browser focus or page location, authors are advised to consider using the button role instead of the link role.",
 						"generalization": ["command"],
 						"requiredContextRole": [],
 						"requiredOwnedElements": [],
@@ -7218,7 +7218,7 @@
 					},
 					{
 						"name": "menuitem",
-						"description": "An option in a set of choices contained by a menu or menubar.\n\nAuthors MUST ensure elements with role menuitem are accessibility children of an element with role menu or an element with role group that is an accessibility child of an element with role menu.\n\nAuthors MAY disable a menu item with the aria-disabled attribute. If the menu item has its aria-haspopup attribute set to true, it indicates that the menu item can be used to launch a sub-level menu, and authors SHOULD display a new sub-level menu when the menu item is activated.\n\nIn order to identify that they are related widgets, authors MUST ensure that menu items are accessibility descendants of an element with role menu or menubar. Authors MAY separate menu items into sets by use of a separator or an element with an equivalent role from the native markup language.",
+						"description": "An option in a set of choices contained by a menu or menubar.\n\nAuthors MUST ensure elements with role menuitem are accessibility children of an element with role menu, menubar, or an element with role group that is an accessibility child of an element with role menu or menubar.\n\nAuthors MAY disable a menu item with the aria-disabled attribute. If the menu item has its aria-haspopup attribute set to true, it indicates that the menu item can be used to launch a sub-level menu, and authors SHOULD display a new sub-level menu when the menu item is activated.\n\nIn order to identify that they are related widgets, authors MUST ensure that menu items are accessibility descendants of an element with role menu or menubar. Authors MAY separate menu items into sets by use of a separator or an element with an equivalent role from the native markup language.",
 						"generalization": ["command"],
 						"requiredContextRole": ["menu", "menubar", "menu > group", "menubar > group"],
 						"requiredOwnedElements": [],
@@ -7337,7 +7337,7 @@
 					},
 					{
 						"name": "menuitemcheckbox",
-						"description": "A menuitem with a checkable state whose possible values are true, false, or mixed.\n\nAuthors MUST ensure elements with role menuitemcheckbox are accessibility children of an element with role menu or an element with role group that is the accessibility child of an element with role menu.\n\nThe aria-checked attribute of a menuitemcheckbox indicates whether the menu item is checked (true), unchecked (false), or represents a sub-level menu of other menu items that have a mixture of checked and unchecked values (mixed).\n\nIn order to identify that they are related widgets, authors MUST ensure that menu item checkboxes are the accessibility descendants of an element with role menu or menubar. Authors MAY separate menu items into sets by use of a separator or an element with an equivalent role from the native markup language.",
+						"description": "A menuitem with a checkable state whose possible values are true, false, or mixed.\n\nAuthors MUST ensure elements with role menuitemcheckbox are accessibility children of an element with role menu, menubar, or an element with role group that is an accessibility child of an element with role menu or menubar.\n\nThe aria-checked attribute of a menuitemcheckbox indicates whether the menu item is checked (true), unchecked (false), or represents a sub-level menu of other menu items that have a mixture of checked and unchecked values (mixed).\n\nIn order to identify that they are related widgets, authors MUST ensure that menu item checkboxes are the accessibility descendants of an element with role menu or menubar. Authors MAY separate menu items into sets by use of a separator or an element with an equivalent role from the native markup language.",
 						"generalization": ["menuitem"],
 						"requiredContextRole": ["menu", "menubar", "menu > group", "menubar > group"],
 						"requiredOwnedElements": [],
@@ -7466,7 +7466,7 @@
 					},
 					{
 						"name": "menuitemradio",
-						"description": "A checkable menuitem in a set of elements with the same role, only one of which can be checked at a time.\n\nAuthors MUST ensure elements with role menuitemradio are accessibility children of an element with role menu or of an element with role group that is the accessibility child of an element with role menu.\n\nAuthors SHOULD enforce that only one menuitemradio 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\nIn order to identify that they are related widgets, authors MUST ensure that menu item radios are accessibility descendants of an element with role menu or menubar.\n\nIf a menu or menubar contains more than one group of menuitemradio elements, or if the menu contains one group and other, unrelated menu items, authors SHOULD contain each set of related menuitemradio elements in an element using the group role. Authors MAY also delimit the group from other menu items with an element using the separator role, or an element with an equivalent role from the native markup language.",
+						"description": "A checkable menuitem in a set of elements with the same role, only one of which can be checked at a time.\n\nAuthors MUST ensure elements with role menuitemradio are accessibility children of an element with role menu, menubar, or an element with role group that is an accessibility child of an element with role menu or menubar.\n\nAuthors SHOULD enforce that only one menuitemradio 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\nIn order to identify that they are related widgets, authors MUST ensure that menu item radios are accessibility descendants of an element with role menu or menubar.\n\nIf a menu or menubar contains more than one group of menuitemradio elements, or if the menu contains one group and other, unrelated menu items, authors SHOULD contain each set of related menuitemradio elements in an element using the group role. Authors MAY also delimit the group from other menu items with an element using the separator role, or an element with an equivalent role from the native markup language.",
 						"generalization": ["menuitem"],
 						"requiredContextRole": ["menu", "menubar", "menu > group", "menubar > group"],
 						"requiredOwnedElements": [],
@@ -41083,6 +41083,9 @@
 						"missingValueDefault": "none",
 						"invalidValueDefault": "none"
 					}
+				},
+				"shadowrootserializable": {
+					"type": "Boolean"
 				}
 			}
 		},
@@ -48386,7 +48389,7 @@
 			"name": "svg:view",
 			"namespace": "http://www.w3.org/2000/svg",
 			"cite": "https://developer.mozilla.org/en-US/docs/Web/SVG/Element/view",
-			"description": "A view is a defined way to view the image, like a zoom level or a detail view.",
+			"description": "The <view> SVG element defines a particular view of an SVG document. A specific view can be displayed by referencing the <view> element's id as the target fragment of a URL.",
 			"categories": [],
 			"contentModel": {
 				"contents": [

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/html-spec",
-	"version": "4.7.2",
+	"version": "4.8.1-alpha.0",
 	"description": "A specification of HTML Living Standard for markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -8,6 +8,16 @@
 	"private": false,
 	"main": "index.js",
 	"types": "index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"default": "./index.js",
+				"types": "./index.d.ts"
+			},
+			"require": "./index.js"
+		},
+		"./json": "./index.json"
+	},
 	"publishConfig": {
 		"access": "public"
 	},
@@ -17,11 +27,11 @@
 		"gen:prettier": "prettier --write index.json"
 	},
 	"devDependencies": {
-		"@markuplint/spec-generator": "4.6.2",
-		"@markuplint/test-tools": "4.5.2"
+		"@markuplint/spec-generator": "4.6.4-alpha.0",
+		"@markuplint/test-tools": "4.5.4-alpha.0"
 	},
 	"dependencies": {
-		"@markuplint/ml-spec": "4.6.0"
+		"@markuplint/ml-spec": "4.6.2-alpha.0"
 	},
-	"gitHead": "ca7dc6bf40eac4f2813e492878f889eb77751a70"
+	"gitHead": "b1cabc178e3553fd66c7ed4357b4124eb2585327"
 }

package/test/structure.spec.mjs

@@ -1,98 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { resolveNamespace, getAttrSpecsByNames } from '@markuplint/ml-spec';
-import { glob } from '@markuplint/test-tools';
-import Ajv from 'ajv';
-import strip from 'strip-json-comments';
-import { describe, test, expect } from 'vitest';
-
-import htmlSpec from '../index.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const require = createRequire(import.meta.url);
-
-const schemas = {
-	element: {
-		$id: '@markuplint/ml-spec/schemas/element.schema.json',
-		...require('../../ml-spec/schemas/element.schema.json'),
-	},
-	aria: {
-		$id: '@markuplint/ml-spec/schemas/aria.schema.json',
-		...require('../../ml-spec/schemas/aria.schema.json'),
-	},
-	contentModels: {
-		$id: '@markuplint/ml-spec/schemas/content-models.schema.json',
-		...require('../../ml-spec/schemas/content-models.schema.json'),
-	},
-	globalAttributes: {
-		$id: '@markuplint/ml-spec/schemas/global-attributes.schema.json',
-		...require('../../ml-spec/schemas/global-attributes.schema.json'),
-	},
-	attributes: {
-		$id: '@markuplint/ml-spec/schemas/attributes.schema.json',
-		...require('../../ml-spec/schemas/attributes.schema.json'),
-	},
-	types: {
-		$id: '@markuplint/types/types.schema.json',
-		...require('../../types/types.schema.json'),
-	},
-};
-
-test('structure', () => {
-	// eslint-disable-next-line import/no-named-as-default-member
-	for (const el of htmlSpec.specs) {
-		const { localName, namespaceURI } = resolveNamespace(el.name);
-		try {
-			getAttrSpecsByNames(localName, namespaceURI, htmlSpec);
-		} catch {
-			throw el;
-		}
-	}
-});
-
-describe('schema', () => {
-	const map = [
-		[
-			'spec.*.json',
-			new Ajv({
-				schemas: [
-					schemas.element,
-					schemas.aria,
-					schemas.contentModels,
-					schemas.globalAttributes,
-					schemas.attributes,
-					schemas.types,
-				],
-			}).getSchema(schemas.element.$id),
-
-			path.resolve(__dirname, 'spec.*.json'),
-		],
-		[
-			'spec-common.attributes.json',
-			new Ajv({
-				schemas: [schemas.globalAttributes, schemas.attributes, schemas.types],
-			}).getSchema(schemas.globalAttributes.$id),
-
-			path.resolve(__dirname, 'spec-common.attributes.json'),
-		],
-	];
-
-	for (const [testName, validator, targetFiles] of map) {
-		test(testName, async () => {
-			const files = await glob(targetFiles);
-			for (const jsonPath of files) {
-				const json = JSON.parse(strip(await readFile(jsonPath, { encoding: 'utf-8' })));
-				const isValid = validator(json);
-				if (!isValid) {
-					throw new Error(`${path.basename(jsonPath)} is invalid (${validator.schemaEnv.baseId})`);
-				}
-			}
-			expect(testName).toBe(testName);
-		});
-	}
-});