@markuplint/ml-spec 3.0.0-alpha.82 → 3.0.0-dev.176

package/README.md

@@ -1,13 +1,18 @@
 # @markuplint/ml-spec
 
 [![npm version](https://badge.fury.io/js/%40markuplint%2Fml-spec.svg)](https://www.npmjs.com/package/@markuplint/ml-spec)
-[![Build Status](https://travis-ci.org/markuplint/markuplint.svg?branch=main)](https://travis-ci.org/markuplint/markuplint)
-[![Coverage Status](https://coveralls.io/repos/github/markuplint/markuplint/badge.svg?branch=main)](https://coveralls.io/github/markuplint/markuplint?branch=main)
 
 ## Install
 
-```sh
+[`markuplint`](https://www.npmjs.com/package/markuplint) package includes this package.
+
+<details>
+<summary>If you are installing purposely, how below:</summary>
+
+```shell
 $ npm install @markuplint/ml-spec
 
 $ yarn add @markuplint/ml-spec
 ```
+
+</details>

package/lib/constant/aria-version.d.ts

@@ -0,0 +1,2 @@
+export declare const ariaVersions: readonly ['1.1', '1.2', '1.3'];
+export declare const ARIA_RECOMMENDED_VERSION: '1.2';

package/lib/constant/aria-version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARIA_RECOMMENDED_VERSION = exports.ariaVersions = void 0;
+exports.ariaVersions = ['1.1', '1.2', '1.3'];
+exports.ARIA_RECOMMENDED_VERSION = '1.2';

package/lib/dom-traverse/accname-computation.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAccname = void 0;
 const dom_accessibility_api_1 = require("dom-accessibility-api");
-function getAccname(el) {
+function getAccname(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
     return (0, dom_accessibility_api_1.computeAccessibleName)(el);
 }
 exports.getAccname = getAccname;

package/lib/dom-traverse/get-attr-specs.d.ts

@@ -1,2 +1,2 @@
 import type { MLMLSpec } from '../types';
-export declare function getAttrSpecs(el: Element, schema: MLMLSpec): import("../types").Attribute[] | null;
+export declare function getAttrSpecs(el: Element, schema: MLMLSpec): readonly import('../types').Attribute[] | null;

package/lib/dom-traverse/get-attr-specs.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAttrSpecs = void 0;
 const get_attr_specs_1 = require("../specs/get-attr-specs");
-function getAttrSpecs(el, schema) {
+function getAttrSpecs(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, schema) {
     return (0, get_attr_specs_1.getAttrSpecs)(el.localName, el.namespaceURI, schema);
 }
 exports.getAttrSpecs = getAttrSpecs;

package/lib/dom-traverse/get-computed-aria-props.d.ts

@@ -0,0 +1,12 @@
+import type { ARIAVersion, MLMLSpec } from '../types';
+type ARIAProps = Record<string, ARIAProp>;
+type ARIAProp = {
+	name: string;
+	value: string | undefined;
+	required: boolean;
+	deprecated: boolean;
+	from: ARIAPropReferenceType;
+};
+type ARIAPropReferenceType = 'default' | 'html-attr' | 'aria-attr';
+export declare function getComputedAriaProps(specs: MLMLSpec, el: Element, version: ARIAVersion): ARIAProps;
+export {};

package/lib/dom-traverse/get-computed-aria-props.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getComputedAriaProps = void 0;
+const aria_specs_1 = require("../specs/aria-specs");
+const get_computed_role_1 = require("./get-computed-role");
+function getComputedAriaProps(specs, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version) {
+    const ariaSpecs = (0, aria_specs_1.ariaSpecs)(specs, version);
+    const { role } = (0, get_computed_role_1.getComputedRole)(specs, el, version);
+    if (!role) {
+        return {};
+    }
+    const props = {};
+    role.ownedProperties.forEach(ownedProp => {
+        var _a;
+        const spec = ariaSpecs.props.find(propSpec => propSpec.name === ownedProp.name);
+        if (!spec) {
+            return;
+        }
+        if (el.hasAttribute(spec.name)) {
+            const attrValue = el.getAttribute(spec.name);
+            if (attrValue && isValidAriaValue(spec, role.name, attrValue, spec.enum)) {
+                props[ownedProp.name] = {
+                    name: ownedProp.name,
+                    value: attrValue,
+                    deprecated: !!spec.deprecated,
+                    required: !!ownedProp.required,
+                    from: 'aria-attr',
+                };
+                return;
+            }
+        }
+        const equivalentHtmlAttr = (_a = spec.equivalentHtmlAttrs) === null || _a === void 0 ? void 0 : _a[0];
+        if (equivalentHtmlAttr && el.hasAttribute(equivalentHtmlAttr.htmlAttrName)) {
+            const value = equivalentHtmlAttr.value === null
+                ? el.getAttribute(equivalentHtmlAttr.htmlAttrName)
+                : equivalentHtmlAttr.value;
+            if (value != null) {
+                props[ownedProp.name] = {
+                    name: ownedProp.name,
+                    value,
+                    deprecated: !!spec.deprecated,
+                    required: !!ownedProp.required,
+                    from: 'html-attr',
+                };
+                return;
+            }
+        }
+        let defaultValue = spec.defaultValue;
+        /**
+         * @see https://www.w3.org/TR/html-aria/#el-h1-h6
+         */
+        if (ownedProp.name === 'aria-level' && /^H[1-6]$/.test(el.nodeName)) {
+            defaultValue = el.nodeName.replace('H', '');
+        }
+        props[ownedProp.name] = {
+            name: ownedProp.name,
+            value: defaultValue,
+            deprecated: !!spec.deprecated,
+            required: !!ownedProp.required,
+            from: 'default',
+        };
+    });
+    return props;
+}
+exports.getComputedAriaProps = getComputedAriaProps;
+function isValidAriaValue(spec, role, value, enumList) {
+    let type = spec.value;
+    if (spec.conditionalValue) {
+        for (const cond of spec.conditionalValue) {
+            if (cond.role.includes(role)) {
+                type = cond.value;
+            }
+        }
+    }
+    value = (value !== null && value !== void 0 ? value : '').trim();
+    switch (type) {
+        case 'string': {
+            return true;
+        }
+        case 'ID reference':
+        case 'ID reference list':
+        case 'URI': {
+            return !!value;
+        }
+        case 'integer':
+        case 'number': {
+            return !isNaN(parseFloat(value));
+        }
+        case 'token':
+        case 'token list': {
+            if (enumList.length === 0) {
+                throw new Error('Need an enum list in token and token list types');
+            }
+            return enumList.includes(value.toLowerCase());
+        }
+        case 'tristate': {
+            return ['true', 'false', 'mixed'].includes(value.toLowerCase());
+        }
+        case 'true/false': {
+            return ['true', 'false'].includes(value.toLowerCase());
+        }
+        case 'true/false/undefined': {
+            return ['true', 'false', 'undefined'].includes(value.toLowerCase());
+        }
+    }
+}

package/lib/dom-traverse/get-computed-role.d.ts

@@ -1,2 +1,7 @@
 import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types';
-export declare function getComputedRole(specs: Readonly<MLMLSpec>, el: Element, version: ARIAVersion): ComputedRole;
+export declare function getComputedRole(
+	specs: MLMLSpec,
+	el: Element,
+	version: ARIAVersion,
+	assumeSingleNode?: boolean,
+): ComputedRole;

package/lib/dom-traverse/get-computed-role.js

@@ -2,18 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getComputedRole = void 0;
 const aria_specs_1 = require("../specs/aria-specs");
-const get_selectors_by_content_model_category_1 = require("../specs/get-selectors-by-content-model-category");
 const is_presentational_1 = require("../specs/is-presentational");
 const get_attr_specs_1 = require("./get-attr-specs");
 const get_explicit_role_1 = require("./get-explicit-role");
 const get_implicit_role_1 = require("./get-implicit-role");
 const get_non_presentational_ancestor_1 = require("./get-non-presentational-ancestor");
 const has_required_owned_elements_1 = require("./has-required-owned-elements");
-function getComputedRole(specs, el, version) {
-    var _a, _b, _c, _d;
+const matches_context_role_1 = require("./matches-context-role");
+const may_be_focusable_1 = require("./may-be-focusable");
+function getComputedRole(specs, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version, assumeSingleNode = false) {
+    var _a, _b;
     const implicitRole = (0, get_implicit_role_1.getImplicitRole)(specs, el, version);
     const explicitRole = (0, get_explicit_role_1.getExplicitRole)(specs, el, version);
-    const computedRole = explicitRole.role ? explicitRole : implicitRole;
+    const computedRole = explicitRole.role
+        ? explicitRole
+        : {
+            ...implicitRole,
+            errorType: explicitRole.errorType === 'NO_EXPLICIT' ? undefined : explicitRole.errorType,
+        };
+    if (assumeSingleNode) {
+        return {
+            ...computedRole,
+            errorType: 'NO_OWNER',
+        };
+    }
     /**
      * Presentational Roles Conflict Resolution
      *
@@ -39,7 +53,20 @@ function getComputedRole(specs, el, version) {
      * However, the presentational role behaves transparently
      * according to the sample code in WAI-ARIA specification.
      */
-    if ((_a = computedRole.role) === null || _a === void 0 ? void 0 : _a.requiredContextRole.length) {
+    if (computedRole.role && computedRole.role.requiredContextRole.length > 0) {
+        /**
+         * An element fragment that serves as the root without a parent element
+         * cannot satisfy the "Required Context Role" condition.
+         * Therefore, under normal circumstances, the `role` will disappear.
+         * However, in this specific case, it will fall back to both explicit
+         * and implicit roles. Note that the explicit role takes precedence.
+         */
+        if (el.parentElement === null) {
+            return {
+                ...computedRole,
+                errorType: 'NO_OWNER',
+            };
+        }
         const nonPresentationalAncestor = (0, get_non_presentational_ancestor_1.getNonPresentationalAncestor)(el, specs, version);
         if (!nonPresentationalAncestor.role) {
             return {
@@ -48,7 +75,7 @@ function getComputedRole(specs, el, version) {
                 errorType: 'NO_OWNER',
             };
         }
-        if (!((_b = computedRole.role) === null || _b === void 0 ? void 0 : _b.requiredContextRole.includes(nonPresentationalAncestor.role.name))) {
+        if (!(0, matches_context_role_1.matchesContextRole)(computedRole.role.requiredContextRole, el, specs, version)) {
             return {
                 el,
                 role: null,
@@ -72,38 +99,26 @@ function getComputedRole(specs, el, version) {
      */
     if (
     /**
-     * Interactive element
+     * If interactive element
+     *
+     * 1. It may be focusable
+     *
+     * THIS CONDITION IS ALMOST MEANINGLESS.
+     * Because it has already been determined that
+     * the interactive elements can not specify the presentational role
+     * in the previous processing that computes the permitted role (`getExplicitRole`).
      */
-    [
-        /**
-         * Interactive content
-         *
-         * THIS CONDITION(SELECTORS) IS ALMOST MEANINGLESS.
-         * Because it has already been determined that
-         * the interactive elements can not specify the presentational role
-         * in the previous processing that computes the permitted role (`getExplicitRole`).
-         *
-         * @see  https://html.spec.whatwg.org/multipage/dom.html#interactive-content
-         */
-        ...(0, get_selectors_by_content_model_category_1.getSelectorsByContentModelCategory)(specs, '#interactive'),
-        /**
-         * Interaction
-         *
-         * @see  https://html.spec.whatwg.org/multipage/interaction.html
-         */
-        '[tabindex]',
-        '[contenteditable]:not([contenteditable="false" i])',
-    ].some(selector => el.matches(selector)) &&
+    (0, may_be_focusable_1.mayBeFocusable)(el, specs) &&
         /**
-         * No disabled
+         * 2. No disabled
          */
         !someAncestors(el, p => isEnabledAttr(p, specs, 'disabled')) &&
         /**
-         * No inert
+         * 3. No inert
          */
         !someAncestors(el, p => isEnabledAttr(p, specs, 'inert')) &&
         /**
-         * No hidden
+         * 4. No hidden
          */
         !someAncestors(el, p => isEnabledAttr(p, specs, 'hidden'))) {
         return {
@@ -123,12 +138,12 @@ function getComputedRole(specs, el, version) {
      */
     if (explicitRole.role) {
         const nonPresentationalAncestor = (0, get_non_presentational_ancestor_1.getNonPresentationalAncestor)(el, specs, version);
-        if ((_c = nonPresentationalAncestor.role) === null || _c === void 0 ? void 0 : _c.requiredOwnedElements.length) {
+        if (nonPresentationalAncestor.role && ((_a = nonPresentationalAncestor.role) === null || _a === void 0 ? void 0 : _a.requiredOwnedElements.length) > 0) {
             if (nonPresentationalAncestor.role.requiredOwnedElements.some(expected => {
                 // const ancestor = nonPresentationalAncestor.el;
                 // const ancestorImplicitRole = getImplicitRole(specs, ancestor, version);
                 // console.log({ nonPresentationalAncestor, ancestorImplicitRole });
-                return (0, has_required_owned_elements_1.isRequiredOwnedElement)(implicitRole, expected, specs, version);
+                return (0, has_required_owned_elements_1.isRequiredOwnedElement)(implicitRole.el, implicitRole.role, expected, specs, version);
             })) {
                 return {
                     ...implicitRole,
@@ -149,7 +164,7 @@ function getComputedRole(specs, el, version) {
      */
     const { props } = (0, aria_specs_1.ariaSpecs)(specs, version);
     for (const attr of Array.from(el.attributes)) {
-        if ((_d = props.find(p => p.name === attr.name)) === null || _d === void 0 ? void 0 : _d.isGlobal) {
+        if ((_b = props.find(p => p.name === attr.name)) === null || _b === void 0 ? void 0 : _b.isGlobal) {
             return {
                 ...implicitRole,
                 errorType: 'GLOBAL_PROP_MUST_NOT_BE_PRESENTATIONAL',
@@ -163,7 +178,9 @@ exports.getComputedRole = getComputedRole;
  * The attribute is available in its owner element,
  * it has the attribute.
  */
-function isEnabledAttr(el, specs, attrName) {
+function isEnabledAttr(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, attrName) {
     const attrs = (0, get_attr_specs_1.getAttrSpecs)(el, specs);
     const attr = attrs === null || attrs === void 0 ? void 0 : attrs.find(attr => attr.name === attrName);
     return !!attr && el.hasAttribute(attrName);
@@ -171,7 +188,9 @@ function isEnabledAttr(el, specs, attrName) {
 /**
  * Determines whether some ancestors match the condition that the specified callback function.
  */
-function someAncestors(el, predicate) {
+function someAncestors(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, predicate) {
     const list = [];
     let current = el;
     while (current) {

package/lib/dom-traverse/get-content-model.d.ts

@@ -0,0 +1,29 @@
+import type { ElementSpec } from '../types';
+type Specs = readonly Pick<ElementSpec, 'name' | 'contentModel'>[];
+export declare function getContentModel(
+	el: Element,
+	specs: Specs,
+):
+	| boolean
+	| readonly (
+			| import('type-fest/source/readonly-deep').ReadonlyObjectDeep<
+					import('../types/permitted-structures').PermittedContentRequire
+			  >
+			| import('type-fest/source/readonly-deep').ReadonlyObjectDeep<
+					import('../types/permitted-structures').PermittedContentOptional
+			  >
+			| import('type-fest/source/readonly-deep').ReadonlyObjectDeep<
+					import('../types/permitted-structures').PermittedContentOneOrMore
+			  >
+			| import('type-fest/source/readonly-deep').ReadonlyObjectDeep<
+					import('../types/permitted-structures').PermittedContentZeroOrMore
+			  >
+			| import('type-fest/source/readonly-deep').ReadonlyObjectDeep<
+					import('../types/permitted-structures').PermittedContentChoice
+			  >
+			| import('type-fest/source/readonly-deep').ReadonlyObjectDeep<
+					import('../types/permitted-structures').PermittedContentTransparent
+			  >
+	  )[]
+	| null;
+export {};

package/lib/dom-traverse/get-content-model.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContentModel = void 0;
+const get_spec_1 = require("./get-spec");
+const cachesBySpecs = new Map();
+function getContentModel(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs) {
+    var _a, _b;
+    const cacheByEl = (_a = cachesBySpecs.get(specs)) !== null && _a !== void 0 ? _a : new Map();
+    const cached = cacheByEl.get(el);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const spec = (0, get_spec_1.getSpec)(el, specs);
+    if (!spec) {
+        cacheByEl.set(el, null);
+        return null;
+    }
+    const conditions = (_b = spec.contentModel.conditional) !== null && _b !== void 0 ? _b : [];
+    for (const cond of conditions) {
+        if (el.matches(cond.condition)) {
+            cacheByEl.set(el, cond.contents);
+            return cond.contents;
+        }
+    }
+    cacheByEl.set(el, spec.contentModel.contents);
+    return spec.contentModel.contents;
+}
+exports.getContentModel = getContentModel;

package/lib/dom-traverse/get-explicit-role.js

@@ -4,16 +4,19 @@ exports.getExplicitRole = void 0;
 const get_role_spec_1 = require("../specs/get-role-spec");
 const resolve_namespace_1 = require("../utils/resolve-namespace");
 const get_permitted_roles_1 = require("./get-permitted-roles");
-function getExplicitRole(specs, el, version) {
+function getExplicitRole(specs, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version) {
+    var _a;
     const roleValue = el.getAttribute('role');
-    const roleNames = (roleValue === null || roleValue === void 0 ? void 0 : roleValue.toLowerCase().trim().split(/\s+/g)) || [];
+    const roleNames = (_a = roleValue === null || roleValue === void 0 ? void 0 : roleValue.toLowerCase().trim().split(/\s+/g)) !== null && _a !== void 0 ? _a : [];
     const permittedRoles = (0, get_permitted_roles_1.getPermittedRoles)(el, version, specs);
     const { namespaceURI } = (0, resolve_namespace_1.resolveNamespace)(el.localName, el.namespaceURI);
     let error = 'NO_EXPLICIT';
     /**
      * Resolve from values and **Handling Author Errors**
      *
-     * @see https://w3c.github.io/aria/#document-handling_author-errors_roles
+     * @see https://w3c.github.io/aria/#document-handling_author-errors
      */
     for (const roleName of roleNames) {
         const spec = (0, get_role_spec_1.getRoleSpec)(specs, roleName, namespaceURI, version);
@@ -83,7 +86,9 @@ exports.getExplicitRole = getExplicitRole;
 function isLandmarkRole(role) {
     return role === null || role === void 0 ? void 0 : role.superClassRoles.some(su => su.name === 'landmark');
 }
-function isValidLandmarkRole(el, role) {
+function isValidLandmarkRole(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, role) {
     if (!role.accessibleNameRequired) {
         return true;
     }

package/lib/dom-traverse/get-implicit-role.d.ts

@@ -1,3 +1,7 @@
 import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types';
-export declare function getImplicitRole(specs: Readonly<MLMLSpec>, el: Element, version: ARIAVersion): ComputedRole;
-export declare function getImplicitRoleName(el: Element, version: ARIAVersion, specs: Readonly<MLMLSpec>): import("..").ImplicitRole;
+export declare function getImplicitRole(specs: MLMLSpec, el: Element, version: ARIAVersion): ComputedRole;
+export declare function getImplicitRoleName(
+	el: Element,
+	version: ARIAVersion,
+	specs: MLMLSpec,
+): import('..').ImplicitRole;

package/lib/dom-traverse/get-implicit-role.js

@@ -4,7 +4,9 @@ exports.getImplicitRoleName = exports.getImplicitRole = void 0;
 const get_implicit_role_1 = require("../specs/get-implicit-role");
 const get_role_spec_1 = require("../specs/get-role-spec");
 const resolve_namespace_1 = require("../utils/resolve-namespace");
-function getImplicitRole(specs, el, version) {
+function getImplicitRole(specs, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version) {
     const implicitRole = getImplicitRoleName(el, version, specs);
     if (implicitRole === false) {
         // No Corresponding Role
@@ -31,7 +33,9 @@ function getImplicitRole(specs, el, version) {
     };
 }
 exports.getImplicitRole = getImplicitRole;
-function getImplicitRoleName(el, version, specs) {
+function getImplicitRoleName(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version, specs) {
     return (0, get_implicit_role_1.getImplicitRole)(specs, el.localName, el.namespaceURI, version, el.matches.bind(el));
 }
 exports.getImplicitRoleName = getImplicitRoleName;

package/lib/dom-traverse/get-non-presentational-ancestor.d.ts

@@ -1,5 +1,11 @@
 import type { ARIAVersion, MLMLSpec } from '../types';
-export declare function getNonPresentationalAncestor(el: Element, specs: MLMLSpec, version: ARIAVersion): import("../types").ComputedRole | {
-    el: null;
-    role: null;
-};
+export declare function getNonPresentationalAncestor(
+	el: Element,
+	specs: MLMLSpec,
+	version: ARIAVersion,
+):
+	| import('../types').ComputedRole
+	| {
+			el: null;
+			role: null;
+	  };

package/lib/dom-traverse/get-non-presentational-ancestor.js

@@ -3,11 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNonPresentationalAncestor = void 0;
 const is_presentational_1 = require("../specs/is-presentational");
 const get_computed_role_1 = require("./get-computed-role");
-function getNonPresentationalAncestor(el, specs, version) {
+function getNonPresentationalAncestor(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
     var _a;
     let ancestor = el.parentElement;
+    /**
+     * In ARIA 1.1 and 1.2, the role of an element is not affected by the role of its ancestor elements.
+     *
+     * It is due to implementation considerations in Markuplint.
+     */
+    const assumeSingleNode = version !== '1.1' && version !== '1.2';
     while (ancestor) {
-        const ancestorRole = (0, get_computed_role_1.getComputedRole)(specs, ancestor, version);
+        const ancestorRole = (0, get_computed_role_1.getComputedRole)(specs, ancestor, version, assumeSingleNode);
         if (!(0, is_presentational_1.isPresentational)((_a = ancestorRole.role) === null || _a === void 0 ? void 0 : _a.name)) {
             return ancestorRole;
         }

package/lib/dom-traverse/get-permitted-roles.d.ts

@@ -1,5 +1,9 @@
 import type { ARIAVersion, MLMLSpec } from '../types';
-export declare function getPermittedRoles(el: Element, version: ARIAVersion, specs: Readonly<MLMLSpec>): {
-    name: string;
-    deprecated?: boolean | undefined;
+export declare function getPermittedRoles(
+	el: Element,
+	version: ARIAVersion,
+	specs: MLMLSpec,
+): readonly {
+	readonly name: string;
+	readonly deprecated?: boolean | undefined;
 }[];

package/lib/dom-traverse/get-permitted-roles.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPermittedRoles = void 0;
 const get_permitted_roles_1 = require("../specs/get-permitted-roles");
-function getPermittedRoles(el, version, specs) {
+function getPermittedRoles(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version, specs) {
     return (0, get_permitted_roles_1.getPermittedRoles)(specs, el.localName, el.namespaceURI, version, el.matches.bind(el));
 }
 exports.getPermittedRoles = getPermittedRoles;

package/lib/dom-traverse/get-spec.d.ts

@@ -1,2 +1,5 @@
-import type { MLMLSpec } from '../types';
-export declare function getSpec(el: Element, schema: MLMLSpec): import("../types").ElementSpec | null;
+import type { ElementSpec } from '../types';
+export declare function getSpec<K extends keyof ElementSpec>(
+	el: Element,
+	specs: readonly Pick<ElementSpec, 'name' | K>[],
+): Pick<ElementSpec, 'name' | K> | null;

package/lib/dom-traverse/get-spec.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSpec = void 0;
 const get_spec_by_tag_name_1 = require("../specs/get-spec-by-tag-name");
-function getSpec(el, schema) {
-    return (0, get_spec_by_tag_name_1.getSpecByTagName)(schema, el.localName, el.namespaceURI);
+function getSpec(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs) {
+    return (0, get_spec_by_tag_name_1.getSpecByTagName)(specs, el.localName, el.namespaceURI);
 }
 exports.getSpec = getSpec;

package/lib/dom-traverse/has-required-owned-elements.d.ts

@@ -1,3 +1,9 @@
 import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types';
-export declare function hasRequiredOwnedElement(el: Element, specs: Readonly<MLMLSpec>, version: ARIAVersion): boolean;
-export declare function isRequiredOwnedElement(owned: ComputedRole, query: string, specs: MLMLSpec, version: ARIAVersion): boolean;
+export declare function hasRequiredOwnedElement(el: Element, specs: MLMLSpec, version: ARIAVersion): boolean;
+export declare function isRequiredOwnedElement(
+	el: Element,
+	role: ComputedRole['role'],
+	query: string,
+	specs: MLMLSpec,
+	version: ARIAVersion,
+): boolean;

package/lib/dom-traverse/has-required-owned-elements.js

@@ -5,14 +5,28 @@ const is_presentational_1 = require("../specs/is-presentational");
 const get_computed_role_1 = require("./get-computed-role");
 const get_explicit_role_1 = require("./get-explicit-role");
 const get_implicit_role_1 = require("./get-implicit-role");
-function hasRequiredOwnedElement(el, specs, version) {
+function hasRequiredOwnedElement(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
+    /**
+     * The element has aria-owns which means it may have owned elements.
+     *
+     * THIS CONDITION IS PARTIAL SUPPORT.
+     */
+    if (el.hasAttribute('aria-owns')) {
+        // FIXME
+        return true;
+    }
+    /**
+     * Otherwise, traverses descendants to find owned elements.
+     */
     const computed = (0, get_computed_role_1.getComputedRole)(specs, el, version);
     if (!computed.role || computed.role.requiredOwnedElements.length === 0) {
         return true;
     }
     for (const expectRole of computed.role.requiredOwnedElements) {
         for (const owned of getClosestNonPresentationalDescendants(el, specs, version)) {
-            if (isRequiredOwnedElement(owned, expectRole, specs, version)) {
+            if (isRequiredOwnedElement(owned.el, owned.role, expectRole, specs, version)) {
                 return true;
             }
         }
@@ -20,17 +34,19 @@ function hasRequiredOwnedElement(el, specs, version) {
     return false;
 }
 exports.hasRequiredOwnedElement = hasRequiredOwnedElement;
-function isRequiredOwnedElement(owned, query, specs, version) {
-    var _a, _b;
+function isRequiredOwnedElement(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, role, query, specs, version) {
+    var _a;
     const [baseRole, owningRole] = query.split(' > ');
-    if (((_a = owned.role) === null || _a === void 0 ? void 0 : _a.name) !== baseRole) {
+    if ((role === null || role === void 0 ? void 0 : role.name) !== baseRole) {
         return false;
     }
     if (!owningRole) {
         return true;
     }
-    for (const owning of getClosestNonPresentationalDescendants(owned.el, specs, version)) {
-        if (((_b = owning.role) === null || _b === void 0 ? void 0 : _b.name) === owningRole) {
+    for (const owning of getClosestNonPresentationalDescendants(el, specs, version)) {
+        if (((_a = owning.role) === null || _a === void 0 ? void 0 : _a.name) === owningRole) {
             return true;
         }
     }
@@ -52,7 +68,9 @@ exports.isRequiredOwnedElement = isRequiredOwnedElement;
  * However, the presentational role behaves transparently
  * according to the sample code in WAI-ARIA specification.
  */
-function getClosestNonPresentationalDescendants(el, specs, version) {
+function getClosestNonPresentationalDescendants(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
     var _a;
     const owned = [];
     for (const child of Array.from(el.children)) {