@markuplint/rules 5.1.1 → 5.3.0

package/lib/wai-aria/checkings/default-value.js

@@ -13,7 +13,7 @@ export const checkingDefaultValue = ({ attr, propSpecs }) => t => {
     if (attr.isDynamicValue) {
         return;
     }
-    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.nameKey);
     const value = attr.value.trim().toLowerCase();
     if (propSpec?.defaultValue != null && propSpec.defaultValue === value) {
         return {

package/lib/wai-aria/checkings/deprecated-props.js

@@ -13,9 +13,9 @@ export const checkingDeprecatedProps = ({ attr, role, propSpecs }) => t => {
     if (!role) {
         return;
     }
-    const props = role.ownedProperties.find(p => p.name === attr.name);
+    const props = role.ownedProperties.find(p => p.name === attr.nameKey);
     if (props?.deprecated) {
-        const propSpec = propSpecs.find(p => p.name === attr.name);
+        const propSpec = propSpecs.find(p => p.name === attr.nameKey);
         return {
             scope: attr,
             message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0*}" {1}', attr.name, `ARIA ${propSpec?.type ?? 'property'}`), 'deprecated'), t('the "{0*}" {1}', role.name, 'role')),

package/lib/wai-aria/checkings/element-supports-aria-prop.js

@@ -1,3 +1,4 @@
+import { isAriaAttr } from '../../helpers.js';
 import { ARIA_RECOMMENDED_VERSION, getARIA } from '@markuplint/ml-spec';
 /**
  * Checks the ARIA in HTML element-specific `aria-*` restrictions: spec data
@@ -13,13 +14,13 @@ import { ARIA_RECOMMENDED_VERSION, getARIA } from '@markuplint/ml-spec';
  * @returns A violation if the element-specific restriction disallows the property.
  */
 export const checkingElementSupportsAriaProp = ({ attr, role, propSpecs }) => t => {
-    if (!/^aria-/i.test(attr.name)) {
+    if (!isAriaAttr(attr)) {
         return;
     }
     const ariaVersion = attr.rule.options?.version ??
         attr.ownerMLDocument.ruleCommonSettings?.ariaVersion ??
         ARIA_RECOMMENDED_VERSION;
-    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.nameKey);
     const elAriaSpec = getARIA(attr.ownerMLDocument.specs, attr.ownerElement.localName, attr.ownerElement.namespaceURI, ariaVersion, attr.ownerElement.matches.bind(attr.ownerElement));
     // Spec data may set `properties: false` to forbid every aria-* attribute on
     // elements that have no implicit role and accept no explicit role
@@ -47,7 +48,7 @@ export const checkingElementSupportsAriaProp = ({ attr, role, propSpecs }) => t
     // already implemented in the `properties.without` branch below.
     if (elAriaSpec?.properties !== false && elAriaSpec?.properties?.only) {
         const onlyNames = elAriaSpec.properties.only.map(o => (typeof o === 'string' ? o : o.name));
-        if (!onlyNames.includes(attr.name)) {
+        if (!onlyNames.includes(attr.nameKey)) {
             return {
                 scope: attr,
                 message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0*}" {1}', attr.name, `ARIA ${propSpec?.type ?? 'property'}`), 'disallowed'), t('the "{0*}" {1}', attr.ownerElement.localName, 'element')),
@@ -56,7 +57,7 @@ export const checkingElementSupportsAriaProp = ({ attr, role, propSpecs }) => t
     }
     if (elAriaSpec?.properties !== false && elAriaSpec?.properties?.without) {
         for (const ignore of elAriaSpec.properties.without) {
-            if (ignore.name === attr.name) {
+            if (ignore.name === attr.nameKey) {
                 const hasNativeAttr = ignore.alt?.method === 'set-attr' && attr.ownerElement.hasAttribute(ignore.alt.target);
                 return {
                     scope: attr,

package/lib/wai-aria/checkings/interaction-in-hidden.d.ts

@@ -6,7 +6,7 @@ import type { ElementChecker } from '@markuplint/ml-core';
  * Including Elements in the Accessibility Tree
  *
  * @see https://w3c.github.io/aria/#tree_inclusion
- * > Elements that are not hidden and may fire an accessibility API event, including:
+ * > Elements that are not hidden and can fire an accessibility API event, including:
  * > - Elements that are currently focused, even if the element or one of its ancestor elements has its aria-hidden attribute set to true.
  * > - Elements that are a valid target of an aria-activedescendant attribute.
  *

package/lib/wai-aria/checkings/interaction-in-hidden.js

@@ -5,7 +5,7 @@ import { mayBeFocusable } from '@markuplint/ml-spec';
  * Including Elements in the Accessibility Tree
  *
  * @see https://w3c.github.io/aria/#tree_inclusion
- * > Elements that are not hidden and may fire an accessibility API event, including:
+ * > Elements that are not hidden and can fire an accessibility API event, including:
  * > - Elements that are currently focused, even if the element or one of its ancestor elements has its aria-hidden attribute set to true.
  * > - Elements that are a valid target of an aria-activedescendant attribute.
  *

package/lib/wai-aria/checkings/no-global-prop.js

@@ -9,7 +9,7 @@
  * @returns A violation if the property is not a global ARIA property.
  */
 export const checkingNoGlobalProp = ({ attr, propSpecs }) => t => {
-    const propSpec = propSpecs.find(prop => prop.name === attr.name);
+    const propSpec = propSpecs.find(prop => prop.name === attr.nameKey);
     if (propSpec && !propSpec.isGlobal) {
         return {
             scope: attr,

package/lib/wai-aria/checkings/presentational-children.d.ts

@@ -6,14 +6,14 @@ import type { ElementChecker } from '@markuplint/ml-core';
  *
  * Presentational Children
  *
- * @see https://www.w3.org/TR/wai-aria/#childrenArePresentational
+ * @see https://w3c.github.io/aria/#childrenArePresentational
  * @see https://w3c.github.io/aria/#childrenArePresentational
  *
- * > The DOM descendants are presentational.
+ * > Indicates whether DOM descendants are presentational.
  * > user agents SHOULD NOT expose descendants of
  * > this element through the platform accessibility API.
  * > If user agents do not hide the descendant nodes,
- * > some information may be read twice.
+ * > some information might be read twice.
  *
  * @see https://w3c.github.io/aria/#tree_exclusion
  *
@@ -26,7 +26,7 @@ import type { ElementChecker } from '@markuplint/ml-core';
  * @see https://w3c.github.io/aria/#tree_inclusion
  *
  * > Text equivalents for hidden referenced objects
- * > may still be used in the name and description computation
+ * > can still be used in the name and description computation
  * > even when not included in the accessibility tree.
  *
  * @param el - The element node to inspect for presentational ancestor context.

package/lib/wai-aria/checkings/presentational-children.js

@@ -1,3 +1,4 @@
+import { isAriaAttr } from '../../helpers.js';
 import { ARIA_RECOMMENDED_VERSION, getComputedRole } from '@markuplint/ml-spec';
 /**
  * Checks whether ARIA attributes are applied to descendants of an element whose
@@ -5,14 +6,14 @@ import { ARIA_RECOMMENDED_VERSION, getComputedRole } from '@markuplint/ml-spec';
  *
  * Presentational Children
  *
- * @see https://www.w3.org/TR/wai-aria/#childrenArePresentational
+ * @see https://w3c.github.io/aria/#childrenArePresentational
  * @see https://w3c.github.io/aria/#childrenArePresentational
  *
- * > The DOM descendants are presentational.
+ * > Indicates whether DOM descendants are presentational.
  * > user agents SHOULD NOT expose descendants of
  * > this element through the platform accessibility API.
  * > If user agents do not hide the descendant nodes,
- * > some information may be read twice.
+ * > some information might be read twice.
  *
  * @see https://w3c.github.io/aria/#tree_exclusion
  *
@@ -25,7 +26,7 @@ import { ARIA_RECOMMENDED_VERSION, getComputedRole } from '@markuplint/ml-spec';
  * @see https://w3c.github.io/aria/#tree_inclusion
  *
  * > Text equivalents for hidden referenced objects
- * > may still be used in the name and description computation
+ * > can still be used in the name and description computation
  * > even when not included in the accessibility tree.
  *
  * @param el - The element node to inspect for presentational ancestor context.
@@ -39,7 +40,7 @@ export const checkingPresentationalChildren = ({ el }) => t => {
     if (!ancestor.role) {
         return;
     }
-    const hasAriaAttr = [...el.attributes].some(attr => /^aria-|^role$/i.test(attr.name));
+    const hasAriaAttr = [...el.attributes].some(attr => isAriaAttr(attr) || attr.nameKey === 'role');
     if (!hasAriaAttr) {
         return;
     }

package/lib/wai-aria/checkings/prohibited-naming.js

@@ -1,9 +1,10 @@
+import { isAriaAttr } from '../../helpers.js';
 import { ARIA_RECOMMENDED_VERSION, getARIA } from '@markuplint/ml-spec';
 /**
  * ARIA naming attributes subject to the "naming prohibition" constraint
  * defined by ARIA in HTML.
  *
- * @see https://w3c.github.io/html-aria/#dfn-naming-prohibited
+ * @see https://www.w3.org/TR/html-aria/#dfn-naming-prohibited
  */
 const NAMING_ATTRS = new Set(['aria-label', 'aria-labelledby', 'aria-braillelabel']);
 /**
@@ -35,10 +36,10 @@ const NAMING_ATTRS = new Set(['aria-label', 'aria-labelledby', 'aria-braillelabe
  * @returns A violation if a naming attribute is used on a naming-prohibited element.
  */
 export const checkingProhibitedNaming = ({ attr, role, propSpecs }) => t => {
-    if (!/^aria-/i.test(attr.name)) {
+    if (!isAriaAttr(attr)) {
         return;
     }
-    if (!NAMING_ATTRS.has(attr.name)) {
+    if (!NAMING_ATTRS.has(attr.nameKey)) {
         return;
     }
     if (role) {
@@ -56,7 +57,7 @@ export const checkingProhibitedNaming = ({ attr, role, propSpecs }) => t => {
     if (elAriaSpec?.namingProhibited !== true && !isAutonomousCustomElement) {
         return;
     }
-    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.nameKey);
     return {
         scope: attr,
         message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0*}" {1}', attr.name, `ARIA ${propSpec?.type ?? 'property'}`), 'prohibited'), t('the "{0*}" {1}', attr.ownerElement.localName, 'element')),

package/lib/wai-aria/checkings/redundant-aria-prop.js

@@ -22,20 +22,18 @@ export const checkingRedundantAriaProp = ({ attr, propSpecs, attrSpecs }) => t =
     if (attr.isDynamicValue) {
         return;
     }
-    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.nameKey);
     if (!propSpec?.equivalentHtmlAttrs) {
         return;
     }
     for (const equivalentHtmlAttr of propSpec.equivalentHtmlAttrs) {
         const eligibility = resolveAttrEligibility(equivalentHtmlAttr.htmlAttrName, attr.ownerElement, attrSpecs);
         // Skip only when the native attribute doesn't apply to this element at all
-        // (unknown name, case mismatch, or an unmet condition) — mirrors the old
+        // (unknown name or an unmet condition) — mirrors the old
         // `invalidType === 'non-existent'` check. `noUse` still proceeds: an
         // explicitly-forbidden native attribute can still be "implicit" for
         // equivalence purposes.
-        if (eligibility.status === 'unknown' ||
-            eligibility.status === 'case-mismatch' ||
-            eligibility.status === 'condition-not-met') {
+        if (eligibility.status === 'unknown' || eligibility.status === 'condition-not-met') {
             continue;
         }
         if (!attr.ownerElement.hasAttribute(equivalentHtmlAttr.htmlAttrName)) {

package/lib/wai-aria/checkings/required-prop.js

@@ -34,10 +34,7 @@ export const checkingRequiredProp = ({ el, role, propSpecs }) => t => {
         return true;
     });
     for (const { name: requiredProp } of requiredProps) {
-        const has = el.attributes.some(attr => {
-            const attrName = attr.name.toLowerCase();
-            return attrName === requiredProp;
-        });
+        const has = el.attributes.some(attr => attr.nameKey === requiredProp);
         if (!has) {
             const propSpec = propSpecs.find(p => p.name === requiredProp);
             const ariaVersion = el.rule.options?.version ??

package/lib/wai-aria/checkings/role-supports-aria-prop.js

@@ -1,3 +1,4 @@
+import { isAriaAttr } from '../../helpers.js';
 /**
  * Checks whether an ARIA property or state is supported by the element's
  * computed role, per the role's WAI-ARIA definition (`ownedProperties`).
@@ -12,17 +13,17 @@
  * @returns A violation if the property is not supported by the given role.
  */
 export const checkingRoleSupportsAriaProp = ({ attr, role, propSpecs }) => t => {
-    if (!/^aria-/i.test(attr.name)) {
+    if (!isAriaAttr(attr)) {
         return;
     }
     if (!role) {
         return;
     }
-    const statesAndProp = role.ownedProperties.find(p => p.name === attr.name);
+    const statesAndProp = role.ownedProperties.find(p => p.name === attr.nameKey);
     if (statesAndProp) {
         return;
     }
-    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.nameKey);
     return {
         scope: attr,
         message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0*}" {1}', attr.name, `ARIA ${propSpec?.type ?? 'property'}`), 'disallowed'), t('the "{0*}" {1}', role.name, 'role')),

package/lib/wai-aria/checkings/tab-requires-tabpanel.d.ts

@@ -8,8 +8,9 @@ import type { ARIARole } from '@markuplint/ml-spec';
  * express it: the tab's `aria-controls` idref list points to a `tabpanel`, or some
  * `tabpanel` element's `aria-labelledby` idref list points back at the tab's own `id`.
  *
- * @see https://www.w3.org/TR/wai-aria-1.3/#tab — "Authors MUST ensure that if a tab
- * is active, a corresponding tabpanel that represents the active tab is rendered."
+ * > Authors MUST ensure that if a tab is active, a corresponding tabpanel that represents the active tab is rendered.
+ *
+ * @see https://w3c.github.io/aria/#tab
  * @param el - The element node to inspect.
  * @param role - The computed ARIA role of the element.
  * @returns A violation if the active tab has no corresponding tabpanel.

package/lib/wai-aria/checkings/tab-requires-tabpanel.js

@@ -6,8 +6,9 @@ import { ARIA_RECOMMENDED_VERSION, getComputedRole } from '@markuplint/ml-spec';
  * express it: the tab's `aria-controls` idref list points to a `tabpanel`, or some
  * `tabpanel` element's `aria-labelledby` idref list points back at the tab's own `id`.
  *
- * @see https://www.w3.org/TR/wai-aria-1.3/#tab — "Authors MUST ensure that if a tab
- * is active, a corresponding tabpanel that represents the active tab is rendered."
+ * > Authors MUST ensure that if a tab is active, a corresponding tabpanel that represents the active tab is rendered.
+ *
+ * @see https://w3c.github.io/aria/#tab
  * @param el - The element node to inspect.
  * @param role - The computed ARIA role of the element.
  * @returns A violation if the active tab has no corresponding tabpanel.

package/lib/wai-aria/checkings/value.d.ts

@@ -26,7 +26,7 @@ export declare const checkingValue: AttrChecker<boolean, Options, {
  * Supports token, token list, string, ID reference, true/false, tristate,
  * true/false/undefined, integer, and number value types.
  *
- * @see https://www.w3.org/TR/wai-aria-1.2/#propcharacteristic_value
+ * @see https://w3c.github.io/aria/#propcharacteristic_value
  * @param type - The ARIA value type (e.g., `"token"`, `"true/false"`, `"integer"`).
  * @param value - The raw attribute value to validate.
  * @param tokenEnum - The list of allowed token values for token-based types.

package/lib/wai-aria/checkings/value.js

@@ -16,7 +16,7 @@ export const checkingValue = ({ attr, role, propSpecs, booleanish }) => t => {
     if (attr.isDynamicValue) {
         return;
     }
-    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.nameKey);
     const result = checkAria(propSpec, attr.value, role?.name, booleanish);
     if (result.isValid) {
         return;
@@ -68,7 +68,7 @@ function checkAria(propSpec, currentValue, role, booleanish) {
  * Supports token, token list, string, ID reference, true/false, tristate,
  * true/false/undefined, integer, and number value types.
  *
- * @see https://www.w3.org/TR/wai-aria-1.2/#propcharacteristic_value
+ * @see https://w3c.github.io/aria/#propcharacteristic_value
  * @param type - The ARIA value type (e.g., `"token"`, `"true/false"`, `"integer"`).
  * @param value - The raw attribute value to validate.
  * @param tokenEnum - The list of allowed token values for token-based types.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/rules",
-	"version": "5.1.1",
+	"version": "5.3.0",
 	"description": "Built-in rules of markuplint",
 	"repository": {
 		"type": "git",
@@ -15,8 +15,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"types": "./lib/index.d.ts",
+			"default": "./lib/index.js"
 		}
 	},
 	"publishConfig": {
@@ -31,21 +31,21 @@
 		"./lib/permitted-contents/debug.js": "./lib/permitted-contents/debug.browser.js"
 	},
 	"dependencies": {
-		"@markuplint/html-spec": "5.1.1",
-		"@markuplint/ml-config": "5.1.1",
-		"@markuplint/ml-core": "5.1.1",
-		"@markuplint/ml-spec": "5.1.1",
-		"@markuplint/selector": "5.1.1",
-		"@markuplint/shared": "5.1.1",
-		"@markuplint/types": "5.1.1",
-		"@mdn/browser-compat-data": "^7.3.2",
-		"@types/debug": "4.1.13",
-		"ansi-colors": "4.1.3",
-		"browserslist": "^4.28.1",
-		"chrono-node": "2.9.0",
-		"debug": "4.4.3",
-		"image-size": "^2.0.2",
-		"type-fest": "5.6.0"
+		"@markuplint/html-spec": "5.3.0",
+		"@markuplint/ml-config": "5.3.0",
+		"@markuplint/ml-core": "5.3.0",
+		"@markuplint/ml-spec": "5.3.0",
+		"@markuplint/selector": "5.3.0",
+		"@markuplint/shared": "5.3.0",
+		"@markuplint/types": "5.3.0",
+		"@mdn/browser-compat-data": "^8.1.5",
+		"@types/debug": "^4.1.13",
+		"ansi-colors": "^4.1.3",
+		"browserslist": "^4.29.3",
+		"chrono-node": "^2.10.3",
+		"debug": "^4.4.3",
+		"image-size": "^2.0.4",
+		"type-fest": "^5.10.0"
 	},
-	"gitHead": "a940c8526e971d590d97395ce924910221208820"
+	"gitHead": "f587cf0206c8426e57369a48d6d5fb22306eafde"
 }