@markuplint/rules 3.0.0-alpha.66 → 3.0.0-dev.176

package/lib/required-attr/index.js

@@ -6,15 +6,16 @@ exports.default = (0, ml_core_1.createRule)({
     defaultValue: [],
     async verify({ document, report, t }) {
         await document.walkOn('Element', el => {
+            var _a;
             if (el.hasSpreadAttr) {
                 return;
             }
             const customRequiredAttrs = typeof el.rule.value === 'string' ? [el.rule.value] : el.rule.value;
             const attrSpec = (0, ml_core_1.getAttrSpecs)(el, document.specs);
             const attributeSpecs = {};
-            if (attrSpec && !el.isCustomElement) {
+            if (attrSpec && el.elementType === 'html') {
                 for (const spec of attrSpec) {
-                    if (spec.required || spec.requiredEither || spec.condition) {
+                    if (spec.required != null || spec.requiredEither || spec.condition != null) {
                         attributeSpecs[spec.name] = {
                             ...spec,
                             values: [],
@@ -33,7 +34,7 @@ exports.default = (0, ml_core_1.createRule)({
                     if (Array.isArray(req.value)) {
                         values.push(...req.value);
                     }
-                    else {
+                    else if (req.value) {
                         values.push(req.value);
                     }
                 }
@@ -53,8 +54,8 @@ exports.default = (0, ml_core_1.createRule)({
                 else if (spec.required === true) {
                     invalid = (0, helpers_1.attrMatches)(el, spec.condition) && didntHave;
                 }
-                else if (spec.required) {
-                    const selector = Array.isArray(spec.required) ? spec.required.join(',') : spec.required;
+                else if (spec.required != null && spec.required !== false) {
+                    const selector = typeof spec.required === 'string' ? spec.required : spec.required.join(',');
                     invalid = el.matches(selector) && didntHave;
                 }
                 if (invalid) {
@@ -65,23 +66,25 @@ exports.default = (0, ml_core_1.createRule)({
                     });
                 }
                 const value = el.getAttribute(spec.name);
-                if (spec.values.length && value) {
+                if (spec.values.length > 0 && value) {
                     const matched = spec.values.some(pattern => (0, helpers_1.match)(value, pattern));
                     if (!matched) {
                         const expects = spec.values.length === 1 ? t(spec.values) : t('either {0}', t(spec.values));
                         const message = t('{0} expects {1}', t('the "{0*}" {1}', spec.name, 'attribute'), expects);
                         const attrToken = el.getAttributeToken(spec.name);
-                        const valueToken = attrToken[0].valueNode;
-                        const token = valueToken || attrToken[0];
-                        report({
-                            scope: {
-                                rule: el.rule,
-                                raw: token.raw,
-                                startCol: token.startCol,
-                                startLine: token.startLine,
-                            },
-                            message,
-                        });
+                        const valueToken = (_a = attrToken[0]) === null || _a === void 0 ? void 0 : _a.valueNode;
+                        const token = valueToken !== null && valueToken !== void 0 ? valueToken : attrToken[0];
+                        if (token) {
+                            report({
+                                scope: {
+                                    rule: el.rule,
+                                    raw: token.raw,
+                                    startCol: token.startCol,
+                                    startLine: token.startLine,
+                                },
+                                message,
+                            });
+                        }
                     }
                 }
             }

package/lib/required-element/index.d.ts

@@ -1,5 +1,5 @@
-declare type Options = {
-    ignoreHasMutableContents: boolean;
+type Options = {
+	ignoreHasMutableContents: boolean;
 };
-declare const _default: import("@markuplint/ml-core").RuleSeed<string[], Options>;
+declare const _default: Readonly<import('@markuplint/ml-core').RuleSeed<string[], Options>>;
 export default _default;

package/lib/required-element/index.js

@@ -7,6 +7,7 @@ exports.default = (0, ml_core_1.createRule)({
         ignoreHasMutableContents: true,
     },
     async verify({ document, report, t }) {
+        var _a, _b;
         const hasMutableContent = document.nodeList.some(n => n.is(n.ELEMENT_NODE) && n.hasMutableChildren());
         if (!hasMutableContent) {
             for (const query of document.rule.value) {
@@ -17,7 +18,7 @@ exports.default = (0, ml_core_1.createRule)({
                         message,
                         line: 1,
                         col: 1,
-                        raw: document.nodeList[0].raw.slice(0, 1),
+                        raw: (_b = (_a = document.nodeList[0]) === null || _a === void 0 ? void 0 : _a.raw.slice(0, 1)) !== null && _b !== void 0 ? _b : '',
                     });
                 }
             }
@@ -26,7 +27,7 @@ exports.default = (0, ml_core_1.createRule)({
             if (el.rule.value === document.rule.value) {
                 return;
             }
-            if (el.rule.option.ignoreHasMutableContents && el.hasMutableChildren()) {
+            if (el.rule.options.ignoreHasMutableContents && el.hasMutableChildren()) {
                 return;
             }
             for (const query of el.rule.value) {

package/lib/required-h1/index.d.ts

@@ -1,6 +1,6 @@
 export interface Options {
-    'expected-once': boolean;
-    'in-document-fragment': boolean;
+	'expected-once': boolean;
+	'in-document-fragment': boolean;
 }
-declare const _default: import("@markuplint/ml-core").RuleSeed<boolean, Options>;
+declare const _default: Readonly<import('@markuplint/ml-core').RuleSeed<boolean, Options>>;
 export default _default;

package/lib/required-h1/index.js

@@ -7,11 +7,12 @@ exports.default = (0, ml_core_1.createRule)({
         'in-document-fragment': false,
     },
     async verify({ document, report, t }) {
+        var _a, _b;
         const h1Stack = [];
         if (document.nodeList.length === 0) {
             return;
         }
-        if (!document.rule.option['in-document-fragment'] && document.isFragment) {
+        if (!document.rule.options['in-document-fragment'] && document.isFragment) {
             return;
         }
         await document.walkOn('Element', node => {
@@ -25,10 +26,10 @@ exports.default = (0, ml_core_1.createRule)({
                 message,
                 line: 1,
                 col: 1,
-                raw: document.nodeList[0].raw.slice(0, 1),
+                raw: (_b = (_a = document.nodeList[0]) === null || _a === void 0 ? void 0 : _a.raw.slice(0, 1)) !== null && _b !== void 0 ? _b : '',
             });
         }
-        else if (document.rule.option['expected-once'] && h1Stack.length > 1) {
+        else if (document.rule.options['expected-once'] && h1Stack.length > 1 && h1Stack[1]) {
             const message = t('{0} is {1:c}', t('the "{0*}" {1}', 'h1', 'element'), 'duplicated');
             report({
                 message,

package/lib/use-list/index.d.ts

@@ -1,6 +1,6 @@
-declare type Bullets = string[];
-declare type Options = {
-    spaceNeededBullets?: string[];
+type Bullets = readonly string[];
+type Options = {
+	spaceNeededBullets?: string[];
 };
-declare const _default: import("@markuplint/ml-core").RuleSeed<Bullets, Options>;
+declare const _default: Readonly<import('@markuplint/ml-core').RuleSeed<Bullets, Options>>;
 export default _default;

package/lib/use-list/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ml_core_1 = require("@markuplint/ml-core");
-const helpers_1 = require("../helpers");
+const shared_1 = require("@markuplint/shared");
 exports.default = (0, ml_core_1.createRule)({
     defaultValue: [
         /**
@@ -54,12 +54,13 @@ exports.default = (0, ml_core_1.createRule)({
             '+', // plus signs
         ],
     },
-    defaultServerity: 'warning',
+    defaultSeverity: 'warning',
     async verify({ document, report, t }) {
         await document.walkOn('Text', textNode => {
-            const text = (0, helpers_1.decodeCharRef)(textNode.raw.trim());
+            var _a;
+            const text = (0, shared_1.decodeEntities)(textNode.raw.trim());
             if (!text) {
-                // emtpy
+                // empty
                 return;
             }
             if (text.length === 1) {
@@ -67,7 +68,7 @@ exports.default = (0, ml_core_1.createRule)({
                 return;
             }
             const bullets = textNode.rule.value;
-            const spaceNeededBullets = textNode.rule.option.spaceNeededBullets || [];
+            const spaceNeededBullets = (_a = textNode.rule.options.spaceNeededBullets) !== null && _a !== void 0 ? _a : [];
             if (isMayListItem(text, bullets, spaceNeededBullets)) {
                 report({
                     scope: textNode,
@@ -78,15 +79,16 @@ exports.default = (0, ml_core_1.createRule)({
     },
 });
 function isMayListItem(text, bullets, spaceNeededBullets) {
+    var _a;
     const textArray = Array.from(text);
-    const firstLetter = textArray[0];
+    const firstLetter = (_a = textArray[0]) !== null && _a !== void 0 ? _a : '';
     const isBullet = bullets.includes(firstLetter);
     const needSpace = spaceNeededBullets.includes(firstLetter);
     const continuous = firstLetter === textArray[1];
     if (continuous) {
         return false;
     }
-    if (isBullet && needSpace) {
+    if (isBullet && needSpace && text[1]) {
         const secondLetter = text[1];
         const isSpace = /^\s$/.test(secondLetter);
         return isSpace;

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

@@ -0,0 +1,15 @@
+import type { Options } from '../types';
+import type { ElementChecker } from '@markuplint/ml-core';
+import type { ARIAProperty, ARIARole } from '@markuplint/ml-spec';
+export declare const checkingRequiredProp: ElementChecker<
+	boolean,
+	Options,
+	{
+		role?:
+			| (ARIARole & {
+					isImplicit?: boolean;
+			  })
+			| null;
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkingRequiredProp = void 0;
+const checkingRequiredProp = ({ el, role, propSpecs }) => t => {
+    var _a;
+    if (!role) {
+        return;
+    }
+    if (role.isImplicit) {
+        return;
+    }
+    const requiredProps = role.ownedProperties.filter(s => s.required).map(s => s.name);
+    for (const requiredProp of requiredProps) {
+        const has = el.attributes.some(attr => {
+            const attrName = attr.name.toLowerCase();
+            return attrName === requiredProp;
+        });
+        if (!has) {
+            const propSpec = propSpecs.find(p => p.name === requiredProp);
+            return {
+                scope: el,
+                message: t('{0:c} on {1}', t('Require {0}', t('the "{0*}" {1}', requiredProp, `ARIA ${(_a = propSpec === null || propSpec === void 0 ? void 0 : propSpec.type) !== null && _a !== void 0 ? _a : 'property'}`)), t('the "{0*}" {1}', role.name, 'role')),
+            };
+        }
+    }
+};
+exports.checkingRequiredProp = checkingRequiredProp;

package/lib/wai-aria/checkings/abstract-role.js

@@ -4,7 +4,7 @@ exports.checkingAbstractRole = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
 const checkingAbstractRole = ({ attr }) => t => {
     var _a;
-    const { roles } = (0, ml_spec_1.ariaSpecs)(attr.ownerMLDocument.specs, attr.rule.option.version);
+    const { roles } = (0, ml_spec_1.ariaSpecs)(attr.ownerMLDocument.specs, attr.rule.options.version);
     const tokens = (_a = attr.tokenList) === null || _a === void 0 ? void 0 : _a.allTokens();
     if (!tokens) {
         return;

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

@@ -1,6 +1,10 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
 import type { ARIAProperty } from '@markuplint/ml-spec';
-export declare const checkingDefaultValue: AttrChecker<boolean, Options, {
-    propSpecs: ARIAProperty[];
-}>;
+export declare const checkingDefaultValue: AttrChecker<
+	boolean,
+	Options,
+	{
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

package/lib/wai-aria/checkings/deprecated-props.d.ts

@@ -1,7 +1,11 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
 import type { ARIAProperty, ARIARole } from '@markuplint/ml-spec';
-export declare const checkingDeprecatedProps: AttrChecker<boolean, Options, {
-    role: ARIARole | null;
-    propSpecs: ARIAProperty[];
-}>;
+export declare const checkingDeprecatedProps: AttrChecker<
+	boolean,
+	Options,
+	{
+		role: ARIARole | null;
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

package/lib/wai-aria/checkings/disallowed-prop.d.ts

@@ -1,7 +1,11 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
 import type { ARIAProperty, ARIARole } from '@markuplint/ml-spec';
-export declare const checkingDisallowedProp: AttrChecker<boolean, Options, {
-    role: ARIARole | null;
-    propSpecs: ARIAProperty[];
-}>;
+export declare const checkingDisallowedProp: AttrChecker<
+	boolean,
+	Options,
+	{
+		role: ARIARole | null;
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

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

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkingDisallowedProp = void 0;
+const ml_spec_1 = require("@markuplint/ml-spec");
 const checkingDisallowedProp = ({ attr, role, propSpecs }) => t => {
-    var _a;
+    var _a, _b, _c, _d;
     if (!role) {
         return;
     }
@@ -10,13 +11,36 @@ const checkingDisallowedProp = ({ attr, role, propSpecs }) => t => {
         return;
     }
     const statesAndProp = role.ownedProperties.find(p => p.name === attr.name);
+    const propSpec = propSpecs.find(p => p.name === attr.name);
+    const elAriaSpec = (0, ml_spec_1.getARIA)(attr.ownerMLDocument.specs, attr.ownerElement.localName, attr.ownerElement.namespaceURI, attr.rule.options.version, attr.ownerElement.matches.bind(attr.ownerElement));
+    if ((elAriaSpec === null || elAriaSpec === void 0 ? void 0 : elAriaSpec.properties) !== false && ((_a = elAriaSpec === null || elAriaSpec === void 0 ? void 0 : elAriaSpec.properties) === null || _a === void 0 ? void 0 : _a.without)) {
+        for (const ignore of elAriaSpec.properties.without) {
+            if (ignore.name === attr.name) {
+                return {
+                    scope: attr,
+                    message: t('{0:c} on {1}', t(ignore.type === 'must-not'
+                        ? '{0} must not {1}'
+                        : ignore.type === 'should-not'
+                            ? '{0} should not {1}'
+                            : '{0} is not recommended to {1}', 
+                    // {0}
+                    t('the "{0*}" {1}', attr.name, `ARIA ${(_b = propSpec === null || propSpec === void 0 ? void 0 : propSpec.type) !== null && _b !== void 0 ? _b : 'property'}`), 
+                    // {1}
+                    'use'), t('the "{0*}" {1}', attr.ownerElement.localName, 'element')) +
+                        (ignore.alt
+                            ? t('. ') +
+                                t('{0} if you {1} {2}', t(ignore.alt.method === 'remove-attr' ? 'Remove {0}' : 'Add {0}', t('the "{0*}" {1}', ignore.alt.target, 'attribute')), 'use', t('the {0}', `ARIA ${(_c = propSpec === null || propSpec === void 0 ? void 0 : propSpec.type) !== null && _c !== void 0 ? _c : 'property'}`))
+                            : ''),
+                };
+            }
+        }
+    }
     if (statesAndProp) {
         return;
     }
-    const propSpec = propSpecs.find(p => p.name === attr.name);
     return {
         scope: attr,
-        message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0*}" {1}', attr.name, `ARIA ${(_a = propSpec === null || propSpec === void 0 ? void 0 : propSpec.type) !== null && _a !== void 0 ? _a : 'property'}`), 'disallowed'), t('the "{0*}" {1}', role.name, 'role')),
+        message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0*}" {1}', attr.name, `ARIA ${(_d = propSpec === null || propSpec === void 0 ? void 0 : propSpec.type) !== null && _d !== void 0 ? _d : 'property'}`), 'disallowed'), t('the "{0*}" {1}', role.name, 'role')),
     };
 };
 exports.checkingDisallowedProp = checkingDisallowedProp;

package/lib/wai-aria/checkings/implicit-props.d.ts

@@ -1,7 +1,11 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
 import type { ARIAProperty, Attribute } from '@markuplint/ml-spec';
-export declare const checkingImplicitProps: AttrChecker<boolean, Options, {
-    propSpecs: ARIAProperty[];
-    attrSpecs: Attribute[] | null;
-}>;
+export declare const checkingImplicitProps: AttrChecker<
+	boolean,
+	Options,
+	{
+		propSpecs: readonly ARIAProperty[];
+		attrSpecs: readonly Attribute[] | null;
+	}
+>;

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkingImplicitProps = void 0;
 const helpers_1 = require("../../helpers");
 const checkingImplicitProps = ({ attr, propSpecs, attrSpecs }) => t => {
+    var _a;
     if (!attrSpecs) {
         return;
     }
@@ -15,8 +16,8 @@ const checkingImplicitProps = ({ attr, propSpecs, attrSpecs }) => t => {
     }
     for (const equivalentHtmlAttr of propSpec.equivalentHtmlAttrs) {
         const htmlAttrSpec = attrSpecs.find(a => a.name === equivalentHtmlAttr.htmlAttrName);
-        const isValid = (0, helpers_1.isValidAttr)(t, equivalentHtmlAttr.htmlAttrName, equivalentHtmlAttr.value || '', false, attr.ownerElement, attrSpecs);
-        if (isValid && isValid.invalidType === 'non-existent') {
+        const isValid = (0, helpers_1.isValidAttr)(t, equivalentHtmlAttr.htmlAttrName, (_a = equivalentHtmlAttr.value) !== null && _a !== void 0 ? _a : '', false, attr.ownerElement, attrSpecs);
+        if (isValid !== false && isValid.invalidType === 'non-existent') {
             continue;
         }
         const value = attr.value.trim().toLowerCase();

package/lib/wai-aria/checkings/implicit-role.js

@@ -4,13 +4,13 @@ exports.checkingImplicitRole = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
 const checkingImplicitRole = ({ attr }) => t => {
     var _a;
-    const implictRole = (0, ml_spec_1.getImplicitRoleName)(attr.ownerElement, attr.rule.option.version, attr.ownerMLDocument.specs);
+    const implicitRole = (0, ml_spec_1.getImplicitRoleName)(attr.ownerElement, attr.rule.options.version, attr.ownerMLDocument.specs);
     const tokens = (_a = attr.tokenList) === null || _a === void 0 ? void 0 : _a.allTokens();
     if (!tokens) {
         return;
     }
     for (const token of tokens) {
-        if (implictRole === token.raw) {
+        if (implicitRole === token.raw) {
             return {
                 scope: token,
                 message: t('{0} is {1}', t('the "{0*}" {1}', token.raw, 'role'), t('{0} of {1}', 'the implicit role', t('the "{0*}" {1}', attr.ownerElement.localName, 'element'))),

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

@@ -0,0 +1,11 @@
+import type { Options } from '../types';
+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 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.
+ */
+export declare const checkingInteractionInHidden: ElementChecker<boolean, Options>;

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

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkingInteractionInHidden = void 0;
+const ml_spec_1 = require("@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 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.
+ */
+// フォーカスがあたっている場合に限り、先祖がaria-hidden=trueでもアクセシビリティツリーに提示される
+// なので、aria-hidden=trueの子孫要素で且つインタラクティブ要素である場合、
+// それは開発者にとってはほとんどの場合、意図しないことが多いはずなので、
+// 仕様上不正にはならないが、十分に注意しなければならない状態である。
+const checkingInteractionInHidden = ({ el }) => t => {
+    if (!(0, ml_spec_1.mayBeFocusable)(el, el.ownerMLDocument.specs)) {
+        return;
+    }
+    const ariaHidden = getClosestAriaHidden(el);
+    if (!ariaHidden) {
+        return;
+    }
+    if (el === ariaHidden.ownerElement) {
+        return {
+            scope: el,
+            message: t('It may be focusable in spite of it has aria-hidden=true'),
+        };
+    }
+    return {
+        scope: el,
+        message: t('It may be focusable in spite of it has the ancestor that has aria-hidden=true'),
+    };
+};
+exports.checkingInteractionInHidden = checkingInteractionInHidden;
+function getClosestAriaHidden(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    let current = el;
+    while (current) {
+        const ariaHidden = current.getAttributeNode('aria-hidden');
+        if ((ariaHidden === null || ariaHidden === void 0 ? void 0 : ariaHidden.value) === 'true') {
+            return ariaHidden;
+        }
+        current = current.parentElement;
+    }
+    return null;
+}

package/lib/wai-aria/checkings/no-global-prop.d.ts

@@ -1,6 +1,10 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
 import type { ARIAProperty } from '@markuplint/ml-spec';
-export declare const checkingNoGlobalProp: AttrChecker<boolean, Options, {
-    propSpecs: ARIAProperty[];
-}>;
+export declare const checkingNoGlobalProp: AttrChecker<
+	boolean,
+	Options,
+	{
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

package/lib/wai-aria/checkings/{non-existant-role.d.ts → non-existent-role.d.ts}

@@ -1,3 +1,3 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
-export declare const checkingNonExistantRole: AttrChecker<boolean, Options>;
+export declare const checkingNonExistentRole: AttrChecker<boolean, Options>;

package/lib/wai-aria/checkings/{non-existant-role.js → non-existent-role.js}

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkingNonExistantRole = void 0;
+exports.checkingNonExistentRole = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
-const checkingNonExistantRole = ({ attr }) => t => {
+const checkingNonExistentRole = ({ attr }) => t => {
     var _a;
-    const { roles, graphicsRoles } = (0, ml_spec_1.ariaSpecs)(attr.ownerMLDocument.specs, attr.rule.option.version);
+    const { roles, graphicsRoles } = (0, ml_spec_1.ariaSpecs)(attr.ownerMLDocument.specs, attr.rule.options.version);
     const tokens = (_a = attr.tokenList) === null || _a === void 0 ? void 0 : _a.allTokens();
     if (!tokens) {
         return;
@@ -25,4 +25,4 @@ const checkingNonExistantRole = ({ attr }) => t => {
         }
     }
 };
-exports.checkingNonExistantRole = checkingNonExistantRole;
+exports.checkingNonExistentRole = checkingNonExistentRole;

package/lib/wai-aria/checkings/permitted-roles.js

@@ -5,7 +5,7 @@ const ml_spec_1 = require("@markuplint/ml-spec");
 const checkingPermittedRoles = ({ attr }) => t => {
     var _a;
     const el = attr.ownerElement;
-    const permittedRoles = (0, ml_spec_1.getPermittedRoles)(el, el.rule.option.version, attr.ownerMLDocument.specs);
+    const permittedRoles = (0, ml_spec_1.getPermittedRoles)(el, el.rule.options.version, attr.ownerMLDocument.specs);
     if (permittedRoles.length === 0) {
         return {
             scope: attr,

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

@@ -0,0 +1,29 @@
+import type { Options } from '../types';
+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
+ *
+ * > The 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.
+ *
+ * @see https://w3c.github.io/aria/#tree_exclusion
+ *
+ * > Any descendants of elements that have the characteristic "Children Presentational: True"
+ * > unless the descendant is not allowed to be presentational
+ * > because it meets one of the conditions for exception described
+ * > in Presentational Roles Conflict Resolution.
+ * > However, the text content of any excluded descendants is included.
+ *
+ * @see https://w3c.github.io/aria/#tree_inclusion
+ *
+ *  > Text equivalents for hidden referenced objects
+ * > may still be used in the name and description computation
+ * > even when not included in the accessibility tree.
+ */
+export declare const checkingPresentationalChildren: ElementChecker<boolean, Options>;

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

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkingPresentationalChildren = void 0;
+const ml_spec_1 = require("@markuplint/ml-spec");
+/**
+ * Presentational Children
+ *
+ * @see https://www.w3.org/TR/wai-aria/#childrenArePresentational
+ * @see https://w3c.github.io/aria/#childrenArePresentational
+ *
+ * > The 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.
+ *
+ * @see https://w3c.github.io/aria/#tree_exclusion
+ *
+ * > Any descendants of elements that have the characteristic "Children Presentational: True"
+ * > unless the descendant is not allowed to be presentational
+ * > because it meets one of the conditions for exception described
+ * > in Presentational Roles Conflict Resolution.
+ * > However, the text content of any excluded descendants is included.
+ *
+ * @see https://w3c.github.io/aria/#tree_inclusion
+ *
+ *  > Text equivalents for hidden referenced objects
+ * > may still be used in the name and description computation
+ * > even when not included in the accessibility tree.
+ */
+const checkingPresentationalChildren = ({ el }) => t => {
+    const ancestor = getAncestorHasPresentationalChildren(el);
+    if (!ancestor) {
+        return;
+    }
+    if (!ancestor.role) {
+        return;
+    }
+    const hasAriaAttr = Array.from(el.attributes).some(attr => /^aria-|^role$/i.test(attr.name));
+    if (!hasAriaAttr) {
+        return;
+    }
+    return {
+        scope: el,
+        message: t('it may be ineffective because {0}', t("it has {0} as an ancestor that doesn't expose its descendants to the accessibility tree", t('the "{0*}" {1}', ancestor.role.name, 'role'))),
+    };
+};
+exports.checkingPresentationalChildren = checkingPresentationalChildren;
+function getAncestorHasPresentationalChildren(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    var _a;
+    let current = el.parentElement;
+    while (current) {
+        const computed = (0, ml_spec_1.getComputedRole)(el.ownerMLDocument.specs, current, el.rule.options.version);
+        if ((_a = computed.role) === null || _a === void 0 ? void 0 : _a.childrenPresentational) {
+            return computed;
+        }
+        current = current.parentElement;
+    }
+    return null;
+}

package/lib/wai-aria/checkings/{checking-required-owned-elements.d.ts → required-owned-elements.d.ts}

@@ -6,6 +6,10 @@ import type { ARIARole } from '@markuplint/ml-spec';
  *
  * @see https://w3c.github.io/aria/#mustContain
  */
-export declare const checkingRequiredOwnedElements: ElementChecker<boolean, Options, {
-    role?: ARIARole | null;
-}>;
+export declare const checkingRequiredOwnedElements: ElementChecker<
+	boolean,
+	Options,
+	{
+		role?: ARIARole | null;
+	}
+>;