@markuplint/ml-spec 3.0.0-canary.5 → 3.0.0-dev.176

package/README.md

@@ -9,7 +9,7 @@
 <details>
 <summary>If you are installing purposely, how below:</summary>
 
-```sh
+```shell
 $ npm install @markuplint/ml-spec
 
 $ yarn add @markuplint/ml-spec

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

@@ -1,12 +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;
+	name: string;
+	value: string | undefined;
+	required: boolean;
+	deprecated: boolean;
+	from: ARIAPropReferenceType;
 };
 type ARIAPropReferenceType = 'default' | 'html-attr' | 'aria-attr';
-export declare function getComputedAriaProps(specs: Readonly<MLMLSpec>, el: Element, version: ARIAVersion): ARIAProps;
+export declare function getComputedAriaProps(specs: MLMLSpec, el: Element, version: ARIAVersion): ARIAProps;
 export {};

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

@@ -3,7 +3,9 @@ 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, el, version) {
+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) {
@@ -88,7 +90,7 @@ function isValidAriaValue(spec, role, value, enumList) {
         }
         case 'token':
         case 'token list': {
-            if (!enumList.length) {
+            if (enumList.length === 0) {
                 throw new Error('Need an enum list in token and token list types');
             }
             return enumList.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

@@ -8,12 +8,26 @@ 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");
+const matches_context_role_1 = require("./matches-context-role");
 const may_be_focusable_1 = require("./may-be-focusable");
-function getComputedRole(specs, el, version) {
-    var _a, _b, _c, _d;
+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,
@@ -111,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,
@@ -137,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',
@@ -151,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);
@@ -159,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

@@ -1,3 +1,29 @@
 import type { ElementSpec } from '../types';
-import type { PermittedContentPattern } from '../types/permitted-structures';
-export declare function getContentModel(el: Element, specs: Pick<ElementSpec, 'name' | 'contentModel'>[]): boolean | PermittedContentPattern[] | null;
+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

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getContentModel = void 0;
 const get_spec_1 = require("./get-spec");
 const cachesBySpecs = new Map();
-function getContentModel(el, specs) {
+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) {
+    if (cached !== undefined) {
         return cached;
     }
     const spec = (0, get_spec_1.getSpec)(el, specs);

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 { ElementSpec } from '../types';
-export declare function getSpec<K extends keyof ElementSpec>(el: Element, specs: Pick<ElementSpec, 'name' | K>[]): Pick<ElementSpec, "name" | K> | null;
+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, specs) {
+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,7 +5,9 @@ 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.
      *
@@ -24,7 +26,7 @@ function hasRequiredOwnedElement(el, specs, version) {
     }
     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;
             }
         }
@@ -32,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;
         }
     }
@@ -64,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)) {

package/lib/dom-traverse/is-exposed.d.ts

@@ -8,4 +8,4 @@ import type { ARIAVersion, MLMLSpec } from '../types';
  * @param el
  * @param version
  */
-export declare function isExposed(el: Element, specs: Readonly<MLMLSpec>, version: ARIAVersion): boolean;
+export declare function isExposed(el: Element, specs: MLMLSpec, version: ARIAVersion): boolean;

package/lib/dom-traverse/is-exposed.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isExposed = void 0;
 const aria_specs_1 = require("../specs/aria-specs");
-const is_palpable_elements_1 = require("../specs/is-palpable-elements");
+const get_spec_by_tag_name_1 = require("../specs/get-spec-by-tag-name");
 const is_presentational_1 = require("../specs/is-presentational");
+const resolve_namespace_1 = require("../utils/resolve-namespace");
 const get_computed_role_1 = require("./get-computed-role");
 /**
  * Detect including/excluding from the Accessibility Tree
@@ -14,14 +15,22 @@ const get_computed_role_1 = require("./get-computed-role");
  * @param el
  * @param version
  */
-function isExposed(el, specs, version) {
+function isExposed(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
     // According to WAI-ARIA
     if (isExcluding(el, specs, version)) {
         return false;
     }
+    // Return true if the element is unknown, deprecated, or obsolete.
+    const { localName, namespace } = (0, resolve_namespace_1.resolveNamespace)(el.localName, el.namespaceURI);
+    const spec = (0, get_spec_by_tag_name_1.getSpecByTagName)(specs.specs, localName, namespace);
+    if (!spec || spec.deprecated || spec.obsolete != null) {
+        return true;
+    }
     // According to HTML and SVG Specs with **the author's interpretation**
     {
-        if (!(0, is_palpable_elements_1.isPalpableElement)(el, specs, { extendsSvg: true, extendsExposableElements: true })) {
+        if (!isExposedElement(el, specs)) {
             return false;
         }
     }
@@ -45,7 +54,10 @@ exports.isExposed = isExposed;
  * @param el
  * @param version
  */
-function isExcluding(el, specs, version) {
+function isExcluding(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
+    var _a;
     /**
      * The following elements are not exposed via the accessibility API and
      * user agents MUST NOT include them in the accessibility tree:
@@ -70,7 +82,7 @@ function isExcluding(el, specs, version) {
      *   These exceptions and conditions are documented in the presentation (role)
      *   section.
      */
-    if ((0, is_presentational_1.isPresentational)((el.getAttribute('role') || '').split(/\s+/)[0])) {
+    if ((0, is_presentational_1.isPresentational)(((_a = el.getAttribute('role')) !== null && _a !== void 0 ? _a : '').split(/\s+/)[0])) {
         return true;
     }
     /**
@@ -124,7 +136,9 @@ function isExcluding(el, specs, version) {
  * @param el
  * @param version
  */
-function isIncluding(el, specs, version) {
+function isIncluding(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
     /**
      * > **meet any** of the following criteria:
      */
@@ -171,7 +185,9 @@ function isIncluding(el, specs, version) {
     // results.push(true);
     return results.includes(true);
 }
-function hasDisplayNodeOrVisibilityHidden(el) {
+function hasDisplayNodeOrVisibilityHidden(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
     const style = el.getAttribute('style');
     if (!style) {
         return false;
@@ -179,3 +195,23 @@ function hasDisplayNodeOrVisibilityHidden(el) {
     // TODO: Improve accuracy
     return /display\s*:\s*none|visibility\s*:\s*hidden/gi.test(style);
 }
+function isExposedElement(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs) {
+    var _a;
+    const svgRenderedConditions = (_a = specs.def['#contentModels']['#SVGRenderable']) === null || _a === void 0 ? void 0 : _a.join(',');
+    if (svgRenderedConditions && el.matches(svgRenderedConditions)) {
+        return true;
+    }
+    return isNotMetaOrHiddenHTMLElement(el, specs);
+}
+function isNotMetaOrHiddenHTMLElement(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs) {
+    var _a;
+    const metadataConditions = (_a = specs.def['#contentModels']['#metadata']) === null || _a === void 0 ? void 0 : _a.join(',');
+    if (metadataConditions && el.matches(metadataConditions)) {
+        return false;
+    }
+    return !el.matches('input[type=hidden i]');
+}

package/lib/dom-traverse/matches-context-role.d.ts

@@ -0,0 +1,7 @@
+import type { ARIAVersion, MLMLSpec } from '../types';
+export declare function matchesContextRole(
+	conditions: readonly string[],
+	ownedEl: Element,
+	specs: MLMLSpec,
+	version: ARIAVersion,
+): boolean;

package/lib/dom-traverse/matches-context-role.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesContextRole = void 0;
+const get_computed_role_1 = require("./get-computed-role");
+function matchesContextRole(conditions, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+ownedEl, specs, version) {
+    return conditions.some(condition => matchesCondition(condition, ownedEl.parentElement, specs, version));
+}
+exports.matchesContextRole = matchesContextRole;
+function matchesCondition(condition, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+parentEl, specs, version) {
+    const conditions = condition.split(/\s+>\s+/g).reverse();
+    while (conditions.length > 0) {
+        if (!parentEl) {
+            return false;
+        }
+        const condition = conditions.shift();
+        const parentRole = (0, get_computed_role_1.getComputedRole)(specs, parentEl, version, true).role;
+        if (condition !== (parentRole === null || parentRole === void 0 ? void 0 : parentRole.name)) {
+            return false;
+        }
+        parentEl = parentEl.parentElement;
+    }
+    return true;
+}

package/lib/dom-traverse/may-be-focusable.d.ts

@@ -1,2 +1,2 @@
 import type { MLMLSpec } from '../types';
-export declare function mayBeFocusable(el: Element, specs: Readonly<MLMLSpec>): boolean;
+export declare function mayBeFocusable(el: Element, specs: MLMLSpec): boolean;

package/lib/dom-traverse/may-be-focusable.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mayBeFocusable = void 0;
 const get_selectors_by_content_model_category_1 = require("../specs/get-selectors-by-content-model-category");
-function mayBeFocusable(el, specs) {
+function mayBeFocusable(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs) {
     return [
         /**
          * Interactive content