@markuplint/rules 3.0.0-canary.3 → 3.0.0-dev.177

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 @@
-type Bullets = string[];
+type Bullets = readonly string[];
 type Options = {
-    spaceNeededBullets?: string[];
+	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: [
         /**
@@ -57,7 +57,8 @@ exports.default = (0, ml_core_1.createRule)({
     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) {
                 // empty
                 return;
@@ -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,7 +4,7 @@ exports.checkingImplicitRole = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
 const checkingImplicitRole = ({ attr }) => t => {
     var _a;
-    const implicitRole = (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;

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

@@ -34,7 +34,9 @@ const checkingInteractionInHidden = ({ el }) => t => {
     };
 };
 exports.checkingInteractionInHidden = checkingInteractionInHidden;
-function getClosestAriaHidden(el) {
+function getClosestAriaHidden(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
     let current = el;
     while (current) {
         const ariaHidden = current.getAttributeNode('aria-hidden');

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-existent-role.js

@@ -4,7 +4,7 @@ exports.checkingNonExistentRole = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
 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;

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.js

@@ -46,11 +46,13 @@ const checkingPresentationalChildren = ({ el }) => t => {
     };
 };
 exports.checkingPresentationalChildren = checkingPresentationalChildren;
-function getAncestorHasPresentationalChildren(el) {
+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.option.version);
+        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;
         }

package/lib/wai-aria/checkings/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;
+	}
+>;

package/lib/wai-aria/checkings/required-owned-elements.js

@@ -11,7 +11,7 @@ const checkingRequiredOwnedElements = ({ el, role }) => t => {
     if (!role) {
         return;
     }
-    if (!role.requiredOwnedElements.length) {
+    if (role.requiredOwnedElements.length === 0) {
         return;
     }
     /**
@@ -28,18 +28,13 @@ const checkingRequiredOwnedElements = ({ el, role }) => t => {
         return;
     }
     // TODO: Needs to resolve `aria-own`
-    if (el.isEmpty()) {
-        return {
-            scope: el,
-            message: t('{0}. Or, {1}', t('require {0}', role.requiredOwnedElements.length === 1
-                ? t('the "{0*}" {1}', role.requiredOwnedElements[0], 'role')
-                : t('the {0}', 'roles') + `: ${t(role.requiredOwnedElements)}`), t('require {0}', 'aria-busy="true"')),
-        };
-    }
     const children = Array.from(el.childNodes).map(child => {
         if (child.is(child.ELEMENT_NODE)) {
-            const computedChild = (0, ml_spec_1.getComputedRole)(child.ownerMLDocument.specs, child, child.rule.option.version);
-            if (role.requiredOwnedElements.some(ownedRole => (0, ml_spec_1.isRequiredOwnedElement)(computedChild, ownedRole, child.ownerMLDocument.specs, child.rule.option.version))) {
+            if (child.matches('[aria-busy="true" i]')) {
+                return [child, 'BUSY'];
+            }
+            const computedChild = (0, ml_spec_1.getComputedRole)(child.ownerMLDocument.specs, child, child.rule.options.version);
+            if (role.requiredOwnedElements.some(ownedRole => (0, ml_spec_1.isRequiredOwnedElement)(computedChild.el, computedChild.role, ownedRole, child.ownerMLDocument.specs, child.rule.options.version))) {
                 return [child, 'REQUIRED'];
             }
             return [child, 'OTHER'];
@@ -49,6 +44,9 @@ const checkingRequiredOwnedElements = ({ el, role }) => t => {
         }
         return [null, 'NO_ELEMENT'];
     });
+    if (children.some(([, type]) => type === 'BUSY')) {
+        return;
+    }
     /**
      * > Any element that will be owned by the element with this role.
      * > For example, an element with the role list
@@ -77,11 +75,29 @@ const checkingRequiredOwnedElements = ({ el, role }) => t => {
     if (el.hasMutableChildren(true)) {
         return;
     }
+    if (mayBeBeforeCreated(el)) {
+        return {
+            scope: el,
+            message: t('{0}. Or, {1}', t('require {0}', role.requiredOwnedElements.length === 1 && role.requiredOwnedElements[0]
+                ? t('the "{0*}" {1}', role.requiredOwnedElements[0], 'role')
+                : t('the {0}', 'roles') + `: ${t(role.requiredOwnedElements)}`), t('require {0}', 'aria-busy="true"')),
+        };
+    }
     return {
         scope: el,
-        message: t('{0} expects {1}', t('the "{0*}" {1}', role.name, 'role'), role.requiredOwnedElements.length === 1
+        message: t('{0} expects {1}', t('the "{0*}" {1}', role.name, 'role'), role.requiredOwnedElements.length === 1 && role.requiredOwnedElements[0]
             ? t('the "{0*}" {1}', role.requiredOwnedElements[0], 'role')
             : t('the {0}', 'roles') + `: ${t(role.requiredOwnedElements)}`),
     };
 };
 exports.checkingRequiredOwnedElements = checkingRequiredOwnedElements;
+function mayBeBeforeCreated(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    if (el.isEmpty()) {
+        return true;
+    }
+    return Array.from(el.children).every(child => {
+        return ['script', 'template'].includes(child.localName);
+    });
+}

package/lib/wai-aria/checkings/required-prop copy.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/required-prop copy.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/required-prop.d.ts

@@ -1,9 +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: ARIAProperty[];
-}>;
+export declare const checkingRequiredProp: ElementChecker<
+	boolean,
+	Options,
+	{
+		role?:
+			| (ARIARole & {
+					isImplicit?: boolean;
+			  })
+			| null;
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

package/lib/wai-aria/checkings/unadopted-explicit-roles.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 checkingUnadoptedExplicitRoles: ElementChecker<
+	boolean,
+	Options,
+	{
+		role?:
+			| (ARIARole & {
+					isImplicit?: boolean;
+			  })
+			| null;
+		propSpecs: readonly ARIAProperty[];
+	}
+>;

package/lib/wai-aria/checkings/unadopted-explicit-roles.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkingUnadoptedExplicitRoles = void 0;
+const checkingUnadoptedExplicitRoles = ({ el, role, propSpecs }) => t => {
+    if (!role) {
+        return;
+    }
+    if (role.name) {
+        console.log(el.localName, role.name);
+        return {
+            scope: el,
+            message: '',
+        };
+    }
+    return;
+};
+exports.checkingUnadoptedExplicitRoles = checkingUnadoptedExplicitRoles;

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

@@ -1,13 +1,22 @@
 import type { Options } from '../types';
 import type { AttrChecker } from '@markuplint/ml-core';
 import type { ARIAProperty, ARIARole } from '@markuplint/ml-spec';
-export declare const checkingValue: AttrChecker<boolean, Options, {
-    role?: ARIARole | null;
-    propSpecs: ARIAProperty[];
-    booleanish?: boolean;
-}>;
+export declare const checkingValue: AttrChecker<
+	boolean,
+	Options,
+	{
+		role?: ARIARole | null;
+		propSpecs: readonly ARIAProperty[];
+		booleanish?: boolean;
+	}
+>;
 /**
  *
  * @see https://www.w3.org/TR/wai-aria-1.2/#propcharacteristic_value
  */
-export declare function checkAriaValue(type: string, value: string, tokenEnum: string[], booleanish?: boolean): boolean;
+export declare function checkAriaValue(
+	type: string,
+	value: string,
+	tokenEnum: readonly string[],
+	booleanish?: boolean,
+): boolean;

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

@@ -14,7 +14,9 @@ const checkingValue = ({ attr, role, propSpecs, booleanish }) => t => {
     return {
         scope: attr,
         message: t('{0:c} on {1}', t('{0} is {1:c}', t('the "{0}"', attr.value), 'disallowed'), t('the "{0*}" {1}', attr.name, `ARIA ${(_a = propSpec === null || propSpec === void 0 ? void 0 : propSpec.type) !== null && _a !== void 0 ? _a : 'property'}`)) +
-            ('enum' in result && result.enum.length ? t('. ') + t('Allowed values are: {0}', t(result.enum)) : ''),
+            ('enum' in result && result.enum.length > 0
+                ? t('. ') + t('Allowed values are: {0}', t(result.enum))
+                : ''),
     };
 };
 exports.checkingValue = checkingValue;

package/lib/wai-aria/index.d.ts

@@ -1,3 +1,3 @@
 import type { Options } from './types';
-declare const _default: import("@markuplint/ml-core").RuleSeed<boolean, Options>;
+declare const _default: Readonly<import('@markuplint/ml-core').RuleSeed<boolean, Options>>;
 export default _default;