@markuplint/rules 5.2.0 → 5.4.0

package/lib/no-content-after-body/index.d.ts

@@ -7,8 +7,8 @@
  * > reprocess the token.
  *
  * Whitespace characters (U+0009/000A/000C/000D/0020) have their own case one
- * step above ("process using the rules for the 'in body' insertion mode"
- * without the parse error), so a trailing newline after `</body>` is normal
+ * step above (they are processed with the rules of the 'in body' insertion
+ * mode, without the parse error), so a trailing newline after `</body>` is normal
  * and out of scope here — only a start tag or non-whitespace text reaching
  * this insertion mode is the "Anything else" parse error. Because the
  * reprocessing switches back to "in body", the offending content still ends

package/lib/no-content-after-body/index.js

@@ -9,8 +9,8 @@ import meta from './meta.js';
  * > reprocess the token.
  *
  * Whitespace characters (U+0009/000A/000C/000D/0020) have their own case one
- * step above ("process using the rules for the 'in body' insertion mode"
- * without the parse error), so a trailing newline after `</body>` is normal
+ * step above (they are processed with the rules of the 'in body' insertion
+ * mode, without the parse error), so a trailing newline after `</body>` is normal
  * and out of scope here — only a start tag or non-whitespace text reaching
  * this insertion mode is the "Anything else" parse error. Because the
  * reprocessing switches back to "in body", the offending content still ends

package/lib/no-contradictory-aria-prop/index.js

@@ -2,6 +2,7 @@ import { createRule, ariaSpecs, getAttrSpecs, getSpec } from '@markuplint/ml-cor
 import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { checkingContradictoryAriaProp } from '../wai-aria/checkings/contradictory-aria-prop.js';
 import { defaultOptions } from '../wai-aria/default-options.js';
+import { isAriaAttr } from '../helpers.js';
 import meta from './meta.js';
 /**
  * Split from the former `wai-aria-implicit-props` rule (#3989): the
@@ -20,7 +21,7 @@ export default createRule({
                 return;
             if (!elSpec.globalAttrs['#ARIAAttrs'])
                 return;
-            const propAttrs = el.attributes.filter(attr => /^aria-/i.test(attr.name));
+            const propAttrs = el.attributes.filter(attr => isAriaAttr(attr));
             if (propAttrs.length === 0)
                 return;
             const ariaVersion = el.rule.options?.version ?? document.ruleCommonSettings?.ariaVersion ?? ARIA_RECOMMENDED_VERSION;

package/lib/no-default-aria-value/index.js

@@ -2,6 +2,7 @@ import { createRule, ariaSpecs, getSpec } from '@markuplint/ml-core';
 import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { checkingDefaultValue } from '../wai-aria/checkings/default-value.js';
 import { defaultOptions } from '../wai-aria/default-options.js';
+import { isAriaAttr } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta,
@@ -14,7 +15,7 @@ export default createRule({
                 return;
             if (!elSpec.globalAttrs['#ARIAAttrs'])
                 return;
-            const propAttrs = el.attributes.filter(attr => /^aria-/i.test(attr.name));
+            const propAttrs = el.attributes.filter(attr => isAriaAttr(attr));
             if (propAttrs.length === 0)
                 return;
             const ariaVersion = el.rule.options?.version ?? document.ruleCommonSettings?.ariaVersion ?? ARIA_RECOMMENDED_VERSION;

package/lib/no-default-value/index.js

@@ -1,5 +1,5 @@
 import { createRule, getAttrSpecs } from '@markuplint/ml-core';
-import { removeAttr, toNormalizedValue } from '../helpers.js';
+import { findAttrSpec, removeAttr, toNormalizedValue } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta: meta,
@@ -10,7 +10,7 @@ export default createRule({
             if (!attrSpec) {
                 return;
             }
-            const spec = attrSpec.find(s => s.name === attr.name);
+            const spec = findAttrSpec(attrSpec, attr);
             if (!spec) {
                 return;
             }

package/lib/no-deprecated-aria-prop/index.js

@@ -2,6 +2,7 @@ import { createRule, getComputedRole, ariaSpecs, getSpec } from '@markuplint/ml-
 import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { checkingDeprecatedProps } from '../wai-aria/checkings/deprecated-props.js';
 import { defaultOptions } from '../wai-aria/default-options.js';
+import { isAriaAttr } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta,
@@ -14,7 +15,7 @@ export default createRule({
                 return;
             if (!elSpec.globalAttrs['#ARIAAttrs'])
                 return;
-            const propAttrs = el.attributes.filter(attr => /^aria-/i.test(attr.name));
+            const propAttrs = el.attributes.filter(attr => isAriaAttr(attr));
             if (propAttrs.length === 0)
                 return;
             const ariaVersion = el.rule.options?.version ?? document.ruleCommonSettings?.ariaVersion ?? ARIA_RECOMMENDED_VERSION;

package/lib/no-deprecated-attr/index.js

@@ -1,4 +1,5 @@
 import { createRule, getAttrSpecs } from '@markuplint/ml-core';
+import { findAttrSpec } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta: meta,
@@ -12,7 +13,7 @@ export default createRule({
                 return;
             }
             const name = attr.name;
-            const attrSpec = attrSpecs.find(item => item.name === name);
+            const attrSpec = findAttrSpec(attrSpecs, attr);
             if (!attrSpec) {
                 return;
             }

package/lib/no-disallowed-attr/index.d.ts

@@ -9,10 +9,16 @@ type Option = {
      * defines. Shares its shape with `no-unknown-attr`'s option of the same
      * name — see that rule for the full description.
      *
+     * A name is compared as the DOM compares attribute names.
+     *
+     * @see https://markuplint.dev/docs/rules/no-unknown-attr#attribute-name-case
      * @since 3.7.0
      */
     allowAttrs?: (string | Attr)[] | Record<string, AttributeType | Pattern>;
-    /** Attribute name prefix(es) to ignore during validation. */
+    /**
+     * Attribute name prefix(es) to ignore during validation, compared as the DOM compares attribute
+     * names, like `allowAttrs`.
+     */
     ignoreAttrNamePrefix?: string | string[];
 };
 /**

package/lib/no-disallowed-attr/index.js

@@ -1,19 +1,15 @@
 import { createRule, getAttrSpecs, getSpec } from '@markuplint/ml-core';
 import { resolveAttrEligibility } from '../attr-eligibility.js';
+import { createNameOptionLookup, createPrefixMatcher } from '../helpers.js';
 import meta from './meta.js';
-function allowedNames(allowAttrs) {
-    if (!allowAttrs) {
-        return new Set();
-    }
-    if (Array.isArray(allowAttrs)) {
-        return new Set(allowAttrs.map(a => (typeof a === 'string' ? a : a.name)));
-    }
-    return new Set(Object.keys(allowAttrs));
-}
 export default createRule({
     meta: meta,
     defaultOptions: {},
     async verify({ document, report, t }) {
+        // Whether an entry of the options is the attribute is up to the attribute: the DOM decides
+        // whether two spellings are one name (`MLAttr#isNamedBy`, `MLAttr#isPrefixedBy`).
+        const lookupAllowed = createNameOptionLookup('Any');
+        const hasIgnoredPrefix = createPrefixMatcher();
         await document.walkOn('Attr', attr => {
             if (attr.isDirective) {
                 return;
@@ -21,8 +17,9 @@ export default createRule({
             const name = attr.name;
             const attrName = attr.nameNode;
             // https://html.spec.whatwg.org/multipage/custom-elements.html#attr-is
-            // "The is attribute must not be specified on an autonomous custom element"
-            if (name === 'is' && attr.ownerElement.elementType === 'web-component') {
+            // > The exception is the is attribute, which must not be specified on an autonomous custom element (and which will
+            // > have no effect if it is).
+            if (attr.nameKey === 'is' && attr.ownerElement.elementType === 'web-component') {
                 report({
                     scope: attr,
                     line: attrName?.startLine,
@@ -32,15 +29,11 @@ export default createRule({
                 });
                 return;
             }
-            if (attr.rule.options.ignoreAttrNamePrefix != null) {
-                const prefixes = Array.isArray(attr.rule.options.ignoreAttrNamePrefix)
-                    ? attr.rule.options.ignoreAttrNamePrefix
-                    : [attr.rule.options.ignoreAttrNamePrefix];
-                if (prefixes.some(prefix => name.indexOf(prefix) === 0)) {
-                    return;
-                }
+            if (hasIgnoredPrefix(attr.rule.options.ignoreAttrNamePrefix, attr)) {
+                return;
             }
-            if (allowedNames(attr.rule.options.allowAttrs).has(name)) {
+            // A name listed in `allowAttrs` is allowed whatever its value
+            if (lookupAllowed(attr.rule.options.allowAttrs, attr) !== undefined) {
                 return;
             }
             if (attr.ownerElement.elementType !== 'html') {
@@ -50,7 +43,7 @@ export default createRule({
             if (!attrSpecs) {
                 return;
             }
-            const eligibility = resolveAttrEligibility(name, attr.ownerElement, attrSpecs);
+            const eligibility = resolveAttrEligibility(name, attr.ownerElement, attrSpecs, attr);
             if (eligibility.status === 'no-use') {
                 report({
                     scope: attr,

package/lib/no-duplicate-attr/index.js

@@ -11,8 +11,7 @@ export default createRule({
                 if (attr.isDuplicatable) {
                     continue;
                 }
-                const attrName = attr.name;
-                const name = node.elementType === 'html' ? attrName.toLowerCase() : attrName;
+                const name = attr.nameKey;
                 if (attrNameStack.includes(name)) {
                     const scope = attr.nameNode ?? attr;
                     report({

package/lib/no-duplicate-autofocus/index.js

@@ -1,8 +1,8 @@
 import { createRule } from '@markuplint/ml-core';
 import meta from './meta.js';
 /**
- * The HTML Living Standard scopes autofocus uniqueness to the "nearest ancestor
- * autofocus scoping root element" — the element itself if it is a `dialog` or
+ * The HTML Living Standard scopes autofocus uniqueness to the nearest ancestor
+ * autofocus scoping root element — the element itself if it is a `dialog` or
  * has a `popover` attribute, otherwise the nearest such ancestor, otherwise the
  * document as a whole. Two `autofocus` elements only conflict when they share
  * the same scoping root; two `dialog`/`popover` elements can each carry their

package/lib/no-duplicate-h1/index.d.ts

@@ -12,7 +12,7 @@ export interface Options {
  * severity is `warning`. The former rule's `expected-once` option gated this
  * check; disabling this rule entirely is how to opt out now.
  *
- * @see https://www.w3.org/WAI/WCAG21/Techniques/html/H42
+ * @see https://www.w3.org/WAI/WCAG22/Techniques/html/H42
  */
 declare const _default: Readonly<import("@markuplint/ml-core").RuleSeed<boolean, Options>>;
 export default _default;

package/lib/no-duplicate-h1/index.js

@@ -7,7 +7,7 @@ import meta from './meta.js';
  * severity is `warning`. The former rule's `expected-once` option gated this
  * check; disabling this rule entirely is how to opt out now.
  *
- * @see https://www.w3.org/WAI/WCAG21/Techniques/html/H42
+ * @see https://www.w3.org/WAI/WCAG22/Techniques/html/H42
  */
 export default createRule({
     meta: meta,

package/lib/no-empty-table-track/index.d.ts

@@ -1,7 +1,11 @@
 /**
  * HTML LS [§4.9.12.1 *Forming a table*](https://html.spec.whatwg.org/multipage/tables.html#forming-a-table)
- * Step 20: "if a column or a row does not have at least one cell anchored to it, that also
- * constitutes a table model error" — covers both a `<tr>` with no cell anchored in it and a
+ * Step 20:
+ *
+ * > If there exists a row or column in the table containing only slots that do not have a cell anchored to them, then
+ * > this is a table model error.
+ *
+ * Covers both a `<tr>` with no cell anchored in it and a
  * column that no cell (nor a `<col>` / `<colgroup>` it belongs to) ever anchors a cell to.
  *
  * Split from the original `table-row-column-alignment` rule. Skips a table that

package/lib/no-empty-table-track/index.js

@@ -3,8 +3,12 @@ import { Grid } from '../table-row-column-alignment/grid.js';
 import meta from './meta.js';
 /**
  * HTML LS [§4.9.12.1 *Forming a table*](https://html.spec.whatwg.org/multipage/tables.html#forming-a-table)
- * Step 20: "if a column or a row does not have at least one cell anchored to it, that also
- * constitutes a table model error" — covers both a `<tr>` with no cell anchored in it and a
+ * Step 20:
+ *
+ * > If there exists a row or column in the table containing only slots that do not have a cell anchored to them, then
+ * > this is a table model error.
+ *
+ * Covers both a `<tr>` with no cell anchored in it and a
  * column that no cell (nor a `<col>` / `<colgroup>` it belongs to) ever anchors a cell to.
  *
  * Split from the original `table-row-column-alignment` rule. Skips a table that

package/lib/no-experimental-features/index.d.ts

@@ -2,7 +2,11 @@
  * Options for the `no-experimental-features` rule.
  */
 type Options = {
-    /** Features to ignore. Element name ("dialog") or attribute pattern ("input[list]"). */
+    /**
+     * Features to ignore: an element name ("dialog") or an attribute of an element ("input[list]"). The
+     * element name is compared as the document compares tag names, the attribute name as the DOM
+     * compares it with the attribute that is checked.
+     */
     readonly ignoreFeatures?: readonly string[];
 };
 declare const _default: Readonly<import("@markuplint/ml-core").RuleSeed<boolean, Options>>;

package/lib/no-experimental-features/index.js

@@ -1,12 +1,12 @@
 import { createRule, getAttrSpecs, getSpec } from '@markuplint/ml-core';
+import { createIgnoreFeaturesLookup, findAttrSpec } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta: meta,
     defaultSeverity: 'warning',
     defaultOptions: {},
     async verify({ document, report, t }) {
-        const options = document.rule.options;
-        const ignoreFeatures = new Set(options.ignoreFeatures);
+        const ignored = createIgnoreFeaturesLookup(document.tagNameCaseSensitive, document.rule.options.ignoreFeatures);
         await document.walkOn('Element', el => {
             // Web components and authored elements (JSX/Vue/Svelte) reach this rule
             // via `pretenders`: they masquerade as a known HTML element on `el.localName`,
@@ -16,9 +16,8 @@ export default createRule({
                 return;
             }
             const elName = el.localName;
-            const elOptions = el.rule.options;
-            const elIgnoreFeatures = new Set(elOptions.ignoreFeatures ?? ignoreFeatures);
-            if (!elIgnoreFeatures.has(elName)) {
+            const elIgnoreFeatures = el.rule.options.ignoreFeatures;
+            if (!ignored.isElementIgnored(elIgnoreFeatures, elName)) {
                 const spec = getSpec(el, document.specs.specs);
                 if (spec?.experimental) {
                     report({
@@ -33,11 +32,10 @@ export default createRule({
                     continue;
                 }
                 const attrName = attr.name;
-                const ignoreKey = `${elName}[${attrName}]`;
-                if (elIgnoreFeatures.has(ignoreKey)) {
+                if (ignored.isAttrIgnored(elIgnoreFeatures, elName, attr)) {
                     continue;
                 }
-                const attrSpec = attrSpecs?.find(s => s.name === attrName);
+                const attrSpec = attrSpecs && findAttrSpec(attrSpecs, attr);
                 if (attrSpec?.experimental) {
                     report({
                         scope: attr,

package/lib/no-hardcoded-id/index.js

@@ -8,7 +8,7 @@ export default createRule({
             return;
         }
         await document.walkOn('Attr', attr => {
-            if (attr.name.toLowerCase() === 'id' && !attr.isDynamicValue && attr.valueType !== 'code') {
+            if (attr.nameKey === 'id' && !attr.isDynamicValue && attr.valueType !== 'code') {
                 report({
                     scope: attr,
                     line: attr.startLine,

package/lib/no-ineffective-attr/index.js

@@ -1,6 +1,6 @@
 import { createRule, getAttrSpecs } from '@markuplint/ml-core';
 import { toNoEmptyStringArrayFromStringOrArray } from '@markuplint/shared';
-import { removeAttr } from '../helpers.js';
+import { findAttrSpec, removeAttr } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta: meta,
@@ -12,7 +12,7 @@ export default createRule({
                 return;
             }
             const name = attr.name;
-            const spec = attrSpec.find(s => s.name === name);
+            const spec = findAttrSpec(attrSpec, attr);
             if (!spec) {
                 return;
             }

package/lib/no-input-file-value/index.d.ts

@@ -1,8 +1,14 @@
 /**
- * `<input type="file">` may carry the `value` attribute only when its
- * value is the empty string. Per HTML LS §4.10.5.1.18 (File Upload
- * state): "The value attribute, if specified, must have a value that
- * is the empty string."
+ * Reports a non-empty `value` attribute on `<input type="file">`.
+ *
+ * Superseded by `no-disallowed-attr`: HTML LS §4.10.5.1.17 (File Upload
+ * state) does not allow the attribute at all, an empty one included.
+ * This rule was written against a sentence that is not in the spec
+ * (that the attribute, if specified, must have a value that is the empty
+ * string) and so lets `value=""` through. Its behavior is kept for configurations that
+ * name it; it is removed in v6.
+ *
+ * > The element's value attribute must be omitted.
  *
  * @see https://html.spec.whatwg.org/multipage/input.html#file-upload-state-(type=file)
  */

package/lib/no-input-file-value/index.js

@@ -1,10 +1,16 @@
 import { createRule } from '@markuplint/ml-core';
 import meta from './meta.js';
 /**
- * `<input type="file">` may carry the `value` attribute only when its
- * value is the empty string. Per HTML LS §4.10.5.1.18 (File Upload
- * state): "The value attribute, if specified, must have a value that
- * is the empty string."
+ * Reports a non-empty `value` attribute on `<input type="file">`.
+ *
+ * Superseded by `no-disallowed-attr`: HTML LS §4.10.5.1.17 (File Upload
+ * state) does not allow the attribute at all, an empty one included.
+ * This rule was written against a sentence that is not in the spec
+ * (that the attribute, if specified, must have a value that is the empty
+ * string) and so lets `value=""` through. Its behavior is kept for configurations that
+ * name it; it is removed in v6.
+ *
+ * > The element's value attribute must be omitted.
  *
  * @see https://html.spec.whatwg.org/multipage/input.html#file-upload-state-(type=file)
  */

package/lib/no-invalid-aria-prop-value/index.js

@@ -2,6 +2,7 @@ import { createRule, getComputedRole, ariaSpecs, getSpec } from '@markuplint/ml-
 import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { checkingValue } from '../wai-aria/checkings/value.js';
 import { defaultOptions } from '../wai-aria/default-options.js';
+import { isAriaAttr } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta,
@@ -13,7 +14,7 @@ export default createRule({
                 return;
             if (!elSpec.globalAttrs['#ARIAAttrs'])
                 return;
-            const propAttrs = el.attributes.filter(attr => /^aria-/i.test(attr.name));
+            const propAttrs = el.attributes.filter(attr => isAriaAttr(attr));
             if (propAttrs.length === 0)
                 return;
             const ariaVersion = el.rule.options?.version ?? document.ruleCommonSettings?.ariaVersion ?? ARIA_RECOMMENDED_VERSION;

package/lib/no-invalid-attr-value/index.d.ts

@@ -10,6 +10,9 @@ type Option = {
      * `no-unknown-attr`'s option of the same name — the name-eligibility half
      * lives there, this rule only consumes the value constraint.
      *
+     * A name is compared as the DOM compares attribute names.
+     *
+     * @see https://markuplint.dev/docs/rules/no-unknown-attr#attribute-name-case
      * @since 3.7.0
      */
     allowAttrs?: (string | Attr)[] | Record<string, AttributeType | Pattern>;

package/lib/no-invalid-attr-value/index.js

@@ -2,33 +2,16 @@ import { createRule, getAttrSpecs } from '@markuplint/ml-core';
 import { attrCheck } from '../attr-check.js';
 import { resolveAttrEligibility } from '../attr-eligibility.js';
 import { log as ruleLog } from '../debug.js';
+import { createNameOptionLookup } from '../helpers.js';
 import meta from './meta.js';
 const log = ruleLog.extend('no-invalid-attr-value');
-function allowedTypes(allowAttrs) {
-    const map = new Map();
-    if (!allowAttrs) {
-        return map;
-    }
-    if (Array.isArray(allowAttrs)) {
-        for (const allowAttr of allowAttrs) {
-            if (typeof allowAttr === 'string') {
-                map.set(allowAttr, 'Any');
-                continue;
-            }
-            map.set(allowAttr.name, allowAttr.value);
-        }
-    }
-    else {
-        for (const [name, type] of Object.entries(allowAttrs)) {
-            map.set(name, type);
-        }
-    }
-    return map;
-}
 export default createRule({
     meta: meta,
     defaultOptions: {},
     async verify({ document, report, t }) {
+        // Whether an entry of `allowAttrs` is the attribute is up to the attribute: the DOM decides
+        // whether two spellings are one name (`MLAttr#isNamedBy`).
+        const lookupAllowed = createNameOptionLookup('Any');
         await document.walkOn('Attr', attr => {
             if (attr.isDirective) {
                 return;
@@ -36,7 +19,7 @@ export default createRule({
             const name = attr.name;
             const value = attr.value;
             const valueNode = attr.valueNode;
-            const allowType = allowedTypes(attr.rule.options.allowAttrs).get(name);
+            const allowType = lookupAllowed(attr.rule.options.allowAttrs, attr);
             let invalid = false;
             if (allowType === undefined) {
                 if (attr.ownerElement.elementType !== 'html') {
@@ -46,8 +29,10 @@ export default createRule({
                 if (!attrSpecs) {
                     return;
                 }
-                log('Checking %s[%s="%s"]', attr.nodeName, name, value);
-                const eligibility = resolveAttrEligibility(name, attr.ownerElement, attrSpecs);
+                if (log.enabled) {
+                    log('Checking %s[%s="%s"]', attr.nodeName, name, value);
+                }
+                const eligibility = resolveAttrEligibility(name, attr.ownerElement, attrSpecs, attr);
                 if (eligibility.status !== 'ok') {
                     return;
                 }

package/lib/no-nonstandard-features/index.d.ts

@@ -2,7 +2,11 @@
  * Options for the `no-nonstandard-features` rule.
  */
 type Options = {
-    /** Features to ignore. Element name ("dialog") or attribute pattern ("input[list]"). */
+    /**
+     * Features to ignore: an element name ("dialog") or an attribute of an element ("input[list]"). The
+     * element name is compared as the document compares tag names, the attribute name as the DOM
+     * compares it with the attribute that is checked.
+     */
     readonly ignoreFeatures?: readonly string[];
 };
 declare const _default: Readonly<import("@markuplint/ml-core").RuleSeed<boolean, Options>>;

package/lib/no-nonstandard-features/index.js

@@ -1,12 +1,12 @@
 import { createRule, getAttrSpecs, getSpec } from '@markuplint/ml-core';
+import { createIgnoreFeaturesLookup, findAttrSpec } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta: meta,
     defaultSeverity: 'warning',
     defaultOptions: {},
     async verify({ document, report, t }) {
-        const options = document.rule.options;
-        const ignoreFeatures = new Set(options.ignoreFeatures);
+        const ignored = createIgnoreFeaturesLookup(document.tagNameCaseSensitive, document.rule.options.ignoreFeatures);
         await document.walkOn('Element', el => {
             // Web components and authored elements (JSX/Vue/Svelte) reach this rule
             // via `pretenders`: they masquerade as a known HTML element on `el.localName`,
@@ -16,9 +16,8 @@ export default createRule({
                 return;
             }
             const elName = el.localName;
-            const elOptions = el.rule.options;
-            const elIgnoreFeatures = new Set(elOptions.ignoreFeatures ?? ignoreFeatures);
-            if (!elIgnoreFeatures.has(elName)) {
+            const elIgnoreFeatures = el.rule.options.ignoreFeatures;
+            if (!ignored.isElementIgnored(elIgnoreFeatures, elName)) {
                 const spec = getSpec(el, document.specs.specs);
                 if (spec?.nonStandard) {
                     report({
@@ -33,11 +32,10 @@ export default createRule({
                     continue;
                 }
                 const attrName = attr.name;
-                const ignoreKey = `${elName}[${attrName}]`;
-                if (elIgnoreFeatures.has(ignoreKey)) {
+                if (ignored.isAttrIgnored(elIgnoreFeatures, elName, attr)) {
                     continue;
                 }
-                const attrSpec = attrSpecs?.find(s => s.name === attrName);
+                const attrSpec = attrSpecs && findAttrSpec(attrSpecs, attr);
                 if (attrSpec?.nonStandard) {
                     report({
                         scope: attr,

package/lib/no-obsolete-attr/index.js

@@ -1,4 +1,5 @@
 import { createRule, getAttrSpecs } from '@markuplint/ml-core';
+import { findAttrSpec } from '../helpers.js';
 import meta from './meta.js';
 export default createRule({
     meta: meta,
@@ -8,8 +9,7 @@ export default createRule({
             if (!attrSpecs) {
                 return;
             }
-            const name = attr.name;
-            const attrSpec = attrSpecs.find(item => item.name === name);
+            const attrSpec = findAttrSpec(attrSpecs, attr);
             if (!attrSpec) {
                 return;
             }
@@ -19,7 +19,7 @@ export default createRule({
                     line: attr.nameNode?.startLine,
                     col: attr.nameNode?.startCol,
                     raw: attr.nameNode?.raw,
-                    message: t('{0} is {1:c}', t('the "{0*}" {1}', name, 'attribute'), 'obsolete'),
+                    message: t('{0} is {1:c}', t('the "{0*}" {1}', attrSpec.name, 'attribute'), 'obsolete'),
                 });
             }
         });

package/lib/no-prohibited-naming/index.js

@@ -2,6 +2,7 @@ import { createRule, getComputedRole, ariaSpecs, getSpec } from '@markuplint/ml-
 import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { checkingProhibitedNaming } from '../wai-aria/checkings/prohibited-naming.js';
 import { defaultOptions } from '../wai-aria/default-options.js';
+import { isAriaAttr } from '../helpers.js';
 import meta from './meta.js';
 /**
  * Split from the former `wai-aria-disallowed-props` rule (#3989): the naming-
@@ -22,7 +23,7 @@ export default createRule({
                 return;
             if (elSpec && !elSpec.globalAttrs['#ARIAAttrs'])
                 return;
-            const propAttrs = el.attributes.filter(attr => /^aria-/i.test(attr.name));
+            const propAttrs = el.attributes.filter(attr => isAriaAttr(attr));
             if (propAttrs.length === 0)
                 return;
             const ariaVersion = el.rule.options?.version ?? document.ruleCommonSettings?.ariaVersion ?? ARIA_RECOMMENDED_VERSION;

package/lib/no-redundant-accessible-name/index.js

@@ -48,11 +48,27 @@ document, options,
 computed) {
     const sources = [];
     // 1. aria-labelledby
+    //
+    // A node that references itself is not overridden by its own aria-labelledby: when the
+    // traversal reaches the node again, accname step 2B is skipped and the name falls through
+    // to 2D–2F (aria-label, native sources, content). aria-labelledby then only composes the
+    // node's own name with the other referenced elements, so it is not a competing source.
+    // https://w3c.github.io/accname/#comp_labelledby (see Example 5 under 2D)
+    //
+    // The remaining sources are still ranked as usual: inside the self-referencing traversal,
+    // aria-label (2D) still wins over a label (2E) or content (2F), so those are reported exactly
+    // as on an element without aria-labelledby. A self-reference is not an exemption from that.
+    //
+    // Known limitation: step 2C (Embedded Control) is not modeled, so a self-referencing
+    // textbox, combobox, listbox or range is treated like any other element.
     const ariaLabelledby = el.getAttribute('aria-labelledby');
     if (ariaLabelledby && ariaLabelledby.trim()) {
         const ids = ariaLabelledby.trim().split(/\s+/);
+        // An IDREF resolves to the first element with that id, so with duplicate ids a
+        // reference only counts as self-referencing when this element is that first match.
+        const isSelfReferencing = ids.some(id => id === el.id && document.querySelector(`[id="${id}"]`) === el);
         const hasResolvableId = ids.some(id => document.querySelector(`[id="${id}"]`));
-        if (hasResolvableId) {
+        if (hasResolvableId && !isSelfReferencing) {
             sources.push({ label: 'aria-labelledby' });
         }
     }

package/lib/no-redundant-aria-prop/index.js

@@ -2,6 +2,7 @@ import { createRule, ariaSpecs, getAttrSpecs, getSpec } from '@markuplint/ml-cor
 import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { checkingRedundantAriaProp } from '../wai-aria/checkings/redundant-aria-prop.js';
 import { defaultOptions } from '../wai-aria/default-options.js';
+import { isAriaAttr } from '../helpers.js';
 import meta from './meta.js';
 /**
  * Split from the former `wai-aria-implicit-props` rule (#3989): the
@@ -21,7 +22,7 @@ export default createRule({
                 return;
             if (!elSpec.globalAttrs['#ARIAAttrs'])
                 return;
-            const propAttrs = el.attributes.filter(attr => /^aria-/i.test(attr.name));
+            const propAttrs = el.attributes.filter(attr => isAriaAttr(attr));
             if (propAttrs.length === 0)
                 return;
             const ariaVersion = el.rule.options?.version ?? document.ruleCommonSettings?.ariaVersion ?? ARIA_RECOMMENDED_VERSION;