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

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

@@ -0,0 +1,11 @@
+import type { ARIAVersion, MLMLSpec } from '../types';
+/**
+ * Detect including/excluding from the Accessibility Tree
+ *
+ * @see https://www.w3.org/TR/wai-aria-1.2/#accessibility_tree
+ *
+ * @param specs
+ * @param el
+ * @param version
+ */
+export declare function isExposed(el: Element, specs: MLMLSpec, version: ARIAVersion): boolean;

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

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExposed = void 0;
+const aria_specs_1 = require("../specs/aria-specs");
+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
+ *
+ * @see https://www.w3.org/TR/wai-aria-1.2/#accessibility_tree
+ *
+ * @param specs
+ * @param el
+ * @param 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 (!isExposedElement(el, specs)) {
+            return false;
+        }
+    }
+    // According to WAI-ARIA
+    {
+        const exposable = isIncluding(el, specs, version);
+        if (exposable) {
+            return true;
+        }
+    }
+    // Default
+    return true;
+}
+exports.isExposed = isExposed;
+/**
+ * Excluding Elements from the Accessibility Tree
+ *
+ * @see https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion
+ *
+ * @param specs
+ * @param el
+ * @param 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:
+     * - Elements, including their descendent elements,
+     *   that have host language semantics specifying
+     *   that the element is not displayed, such as CSS display:none,
+     *   visibility:hidden, or the HTML hidden attribute.
+     */
+    {
+        let currentEl = el;
+        while (currentEl) {
+            if (hasDisplayNodeOrVisibilityHidden(currentEl) || currentEl.hasAttribute('hidden')) {
+                return true;
+            }
+            currentEl = currentEl.parentElement;
+        }
+    }
+    /**
+     * - Elements with none or presentation as the first role in the role attribute.
+     *   However, their exclusion is conditional. In addition,
+     *   the element's descendants and text content are generally included.
+     *   These exceptions and conditions are documented in the presentation (role)
+     *   section.
+     */
+    if ((0, is_presentational_1.isPresentational)(((_a = el.getAttribute('role')) !== null && _a !== void 0 ? _a : '').split(/\s+/)[0])) {
+        return true;
+    }
+    /**
+     * If not already excluded from the accessibility tree per the above rules,
+     * user agents SHOULD NOT include the following elements
+     * in the accessibility tree:
+     * - Elements, including their descendants, that have aria-hidden set to true.
+     *   In other words, aria-hidden="true" on a parent overrides aria-hidden="false"
+     *   on descendants.
+     */
+    {
+        let currentEl = el;
+        while (currentEl) {
+            if (currentEl.getAttribute('aria-hidden') === 'true') {
+                return true;
+            }
+            currentEl = currentEl.parentElement;
+        }
+    }
+    /**
+     * - 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.
+     */
+    {
+        let currentEl = el.parentElement;
+        while (currentEl) {
+            const { role } = (0, get_computed_role_1.getComputedRole)(specs, currentEl, version);
+            if (role === null || role === void 0 ? void 0 : role.childrenPresentational) {
+                return true;
+            }
+            currentEl = currentEl.parentElement;
+        }
+    }
+    return false;
+}
+/**
+ * Including Elements in the Accessibility Tree
+ *
+ * If not excluded from or marked as hidden in the accessibility tree
+ * per the rules above in Excluding Elements in the Accessibility Tree,
+ * user agents MUST provide an accessible object in the accessibility tree
+ * for DOM elements that meet any of the following criteria:
+ *
+ * @see https://www.w3.org/TR/wai-aria-1.2/#tree_inclusion
+ *
+ * @param specs
+ * @param el
+ * @param version
+ */
+function isIncluding(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, version) {
+    /**
+     * > **meet any** of the following criteria:
+     */
+    const results = [];
+    /**
+     * 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.
+     */
+    // 🚫 Can't detect the element is focused.
+    // results.push(true);
+    /**
+     * - Elements that are a valid target of an aria-activedescendant attribute.
+     */
+    // TODO: Compute aria-activedescendant.
+    // results.push(true);
+    /**
+     * Elements that have an explicit role or a global WAI-ARIA attribute and
+     * do not have aria-hidden set to true.
+     * (See Excluding Elements in the Accessibility Tree for
+     * additional guidance on aria-hidden.)
+     */
+    if (el.getAttribute('aria-hidden') !== 'true') {
+        const globalAria = (0, aria_specs_1.ariaSpecs)(specs, version).props.filter(prop => prop.isGlobal);
+        const { role } = (0, get_computed_role_1.getComputedRole)(specs, el, version);
+        // Has an explicit role
+        if (role && !role.isImplicit) {
+            results.push(true);
+        }
+        // Has a global WAI-ARIA attribute
+        for (const attr of Array.from(el.attributes)) {
+            if (globalAria.some(aria => aria.name === attr.localName)) {
+                results.push(true);
+                break;
+            }
+        }
+    }
+    /**
+     * Elements that are not hidden and have an ID that is referenced
+     * by another element via a WAI-ARIA property.
+     */
+    // TODO: Compute refering ID.
+    // results.push(true);
+    return results.includes(true);
+}
+function hasDisplayNodeOrVisibilityHidden(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    const style = el.getAttribute('style');
+    if (!style) {
+        return false;
+    }
+    // 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

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

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

@@ -0,0 +1,24 @@
+"use strict";
+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(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs) {
+    return [
+        /**
+         * Interactive content
+         *
+         * @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));
+}
+exports.mayBeFocusable = mayBeFocusable;

package/lib/index.d.ts

@@ -1,17 +1,27 @@
+export * from './constant/aria-version';
 export * from './dom-traverse/accname-computation';
 export * from './dom-traverse/get-attr-specs';
+export * from './dom-traverse/get-computed-aria-props';
 export * from './dom-traverse/get-computed-role';
+export * from './dom-traverse/get-content-model';
 export * from './dom-traverse/get-implicit-role';
 export * from './dom-traverse/get-permitted-roles';
 export * from './dom-traverse/get-spec';
 export * from './dom-traverse/has-required-owned-elements';
+export * from './dom-traverse/is-exposed';
+export * from './dom-traverse/may-be-focusable';
 export * from './specs/aria-specs';
 export * from './specs/content-model-category-to-tag-names';
+export * from './specs/get-aria';
 export * from './specs/get-role-spec';
 export * from './specs/get-spec-by-tag-name';
+export * from './specs/is-nothing-content-model';
+export * from './specs/is-palpable-elements';
+export * from './specs/is-void-element';
 export * from './specs/schema-to-spec';
 export * from './types';
 export * from './types/aria';
 export * from './types/attributes';
-export * from './types/permitted-structres';
+export * from './types/permitted-structures';
 export * from './utils/resolve-namespace';
+export * from './utils/validateAriaVersion';

package/lib/index.js

@@ -1,20 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./constant/aria-version"), exports);
 tslib_1.__exportStar(require("./dom-traverse/accname-computation"), exports);
 tslib_1.__exportStar(require("./dom-traverse/get-attr-specs"), exports);
+tslib_1.__exportStar(require("./dom-traverse/get-computed-aria-props"), exports);
 tslib_1.__exportStar(require("./dom-traverse/get-computed-role"), exports);
+tslib_1.__exportStar(require("./dom-traverse/get-content-model"), exports);
 tslib_1.__exportStar(require("./dom-traverse/get-implicit-role"), exports);
 tslib_1.__exportStar(require("./dom-traverse/get-permitted-roles"), exports);
 tslib_1.__exportStar(require("./dom-traverse/get-spec"), exports);
 tslib_1.__exportStar(require("./dom-traverse/has-required-owned-elements"), exports);
+tslib_1.__exportStar(require("./dom-traverse/is-exposed"), exports);
+tslib_1.__exportStar(require("./dom-traverse/may-be-focusable"), exports);
 tslib_1.__exportStar(require("./specs/aria-specs"), exports);
 tslib_1.__exportStar(require("./specs/content-model-category-to-tag-names"), exports);
+tslib_1.__exportStar(require("./specs/get-aria"), exports);
 tslib_1.__exportStar(require("./specs/get-role-spec"), exports);
 tslib_1.__exportStar(require("./specs/get-spec-by-tag-name"), exports);
+tslib_1.__exportStar(require("./specs/is-nothing-content-model"), exports);
+tslib_1.__exportStar(require("./specs/is-palpable-elements"), exports);
+tslib_1.__exportStar(require("./specs/is-void-element"), exports);
 tslib_1.__exportStar(require("./specs/schema-to-spec"), exports);
 tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./types/aria"), exports);
 tslib_1.__exportStar(require("./types/attributes"), exports);
-tslib_1.__exportStar(require("./types/permitted-structres"), exports);
+tslib_1.__exportStar(require("./types/permitted-structures"), exports);
 tslib_1.__exportStar(require("./utils/resolve-namespace"), exports);
+tslib_1.__exportStar(require("./utils/validateAriaVersion"), exports);

package/lib/specs/aria-specs.d.ts

@@ -1,6 +1,9 @@
 import type { ARIAVersion, MLMLSpec } from '../types';
-export declare function ariaSpecs(specs: Readonly<MLMLSpec>, version: ARIAVersion): {
-    roles: import("../types").ARIARoleInSchema[];
-    graphicsRoles: import("../types").ARIARoleInSchema[];
-    props: import("../types").ARIAProperty[];
+export declare function ariaSpecs(
+	specs: MLMLSpec,
+	version: ARIAVersion,
+): {
+	readonly roles: readonly import('../types').ARIARoleInSchema[];
+	readonly graphicsRoles: readonly import('../types').ARIARoleInSchema[];
+	readonly props: readonly import('../types').ARIAProperty[];
 };

package/lib/specs/content-model-category-to-tag-names.d.ts

@@ -1,3 +1,6 @@
 import type { MLMLSpec } from '../types';
-import type { Category } from '../types/permitted-structres';
-export declare function contentModelCategoryToTagNames(contentModel: Category, specs: MLMLSpec): ReadonlyArray<string>;
+import type { Category } from '../types/permitted-structures';
+export declare function contentModelCategoryToTagNames(
+	contentModel: Category,
+	def: MLMLSpec['def'],
+): ReadonlyArray<string>;

package/lib/specs/content-model-category-to-tag-names.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.contentModelCategoryToTagNames = void 0;
 const cache = new Map();
-function contentModelCategoryToTagNames(contentModel, specs) {
+function contentModelCategoryToTagNames(contentModel, def) {
     const cached = cache.get(contentModel);
     if (cached) {
         return cached;
     }
-    const tags = specs.def['#contentModels'][contentModel];
+    const tags = def['#contentModels'][contentModel];
     const sortedTag = Object.freeze(tags && Array.isArray(tags) ? tags.sort() : []);
     cache.set(contentModel, sortedTag);
     return sortedTag;

package/lib/specs/get-aria.d.ts

@@ -1,3 +1,10 @@
 import type { ARIAVersion, Matches, MLMLSpec } from '../types';
 import type { ARIA } from '../types/aria';
-export declare function getARIA(specs: Readonly<MLMLSpec>, localName: string, namespace: string | null, version: ARIAVersion, matches: Matches): Omit<ARIA, ARIAVersion | 'conditions'> | null;
+import type { ReadonlyDeep } from 'type-fest';
+export declare function getARIA(
+	specs: MLMLSpec,
+	localName: string,
+	namespace: string | null,
+	version: ARIAVersion,
+	matches: Matches,
+): Omit<ReadonlyDeep<ARIA>, ARIAVersion | 'conditions'> | null;

package/lib/specs/get-aria.js

@@ -14,13 +14,16 @@ function getARIA(specs, localName, namespace, version, matches) {
     if (!conditions) {
         return aria;
     }
-    const conds = Object.keys(conditions);
+    const conditionKeys = Object.keys(conditions);
     let { implicitRole, permittedRoles, implicitProperties, properties, namingProhibited } = aria;
-    for (const cond of conds) {
+    for (const cond of conditionKeys) {
         if (!matches(cond)) {
             continue;
         }
         const condARIA = conditions[cond];
+        if (!condARIA) {
+            continue;
+        }
         implicitRole = (_a = condARIA.implicitRole) !== null && _a !== void 0 ? _a : implicitRole;
         permittedRoles = (_b = condARIA.permittedRoles) !== null && _b !== void 0 ? _b : permittedRoles;
         implicitProperties = (_c = condARIA.implicitProperties) !== null && _c !== void 0 ? _c : implicitProperties;
@@ -43,14 +46,17 @@ function getVersionResolvedARIA(specs, localName, namespace, version) {
     if (aria !== undefined) {
         return aria;
     }
-    const spec = (_a = (0, get_spec_by_tag_name_1.getSpecByTagName)(specs, localName, namespace)) === null || _a === void 0 ? void 0 : _a.aria;
+    const spec = (_a = (0, get_spec_by_tag_name_1.getSpecByTagName)(specs.specs, localName, namespace)) === null || _a === void 0 ? void 0 : _a.aria;
     if (!spec) {
         cache.set(key, null);
         return null;
     }
     aria = (0, resolve_version_1.resolveVersion)(spec, version);
-    if (aria.permittedRoles) {
-        aria.permittedRoles = optimizePermittedRoles(aria.permittedRoles);
+    if (aria.permittedRoles !== false) {
+        aria = {
+            ...aria,
+            permittedRoles: optimizePermittedRoles(aria.permittedRoles),
+        };
     }
     cache.set(key, aria);
     return aria;

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

@@ -1,8 +1,12 @@
 import type { MLMLSpec, Attribute } from '../types';
 import type { NamespaceURI } from '@markuplint/ml-ast';
-export declare function getAttrSpecs(localName: string, namespace: NamespaceURI | null, schema: MLMLSpec): Attribute[] | null;
-declare type HasName = {
-    name: string;
+export declare function getAttrSpecs(
+	localName: string,
+	namespace: NamespaceURI | null,
+	schema: MLMLSpec,
+): readonly Attribute[] | null;
+type HasName = {
+	readonly name: string;
 };
 export declare function nameCompare(a: HasName | string, b: HasName | string): 1 | -1 | 0;
 export {};

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

@@ -8,7 +8,7 @@ function getAttrSpecs(localName, namespace, schema) {
     if (!schemaCache.has(schema)) {
         cacheMap.clear();
     }
-    const { localNameWithNS } = (0, resolve_namespace_1.resolveNamespace)(localName, namespace || undefined);
+    const { localNameWithNS } = (0, resolve_namespace_1.resolveNamespace)(localName, namespace !== null && namespace !== void 0 ? namespace : undefined);
     const cache = cacheMap.get(localNameWithNS);
     if (cache !== undefined) {
         return cache;
@@ -24,7 +24,7 @@ function getAttrSpecs(localName, namespace, schema) {
     for (const catName in elSpec.globalAttrs) {
         // @ts-ignore
         const catAttrs = elSpec.globalAttrs[catName];
-        if (!catAttrs) {
+        if (catAttrs === false) {
             continue;
         }
         if (typeof catAttrs === 'boolean') {
@@ -66,18 +66,6 @@ function getAttrSpecs(localName, namespace, schema) {
         const attr = attrs[name];
         return { name, type: 'Any', ...attr };
     });
-    for (const attr of attrList) {
-        if (!attr.type) {
-            throw new Error(`The type is empty in the ${attr.name} attribute of the ${localName} element,
-					'packages',
-					'@markuplint',
-					'html-spec',
-					'src',
-					'attributes',
-					nameWithNS.replace(':', '_') + '.json',
-				)})`);
-        }
-    }
     attrList.sort(nameCompare);
     cacheMap.set(localNameWithNS, attrList);
     return attrList;

package/lib/specs/get-implicit-role.d.ts

@@ -1,2 +1,8 @@
 import type { ARIAVersion, Matches, MLMLSpec } from '../types';
-export declare function getImplicitRole(specs: Readonly<MLMLSpec>, localName: string, namespace: string | null, version: ARIAVersion, matches: Matches): import("..").ImplicitRole;
+export declare function getImplicitRole(
+	specs: MLMLSpec,
+	localName: string,
+	namespace: string | null,
+	version: ARIAVersion,
+	matches: Matches,
+): import('..').ImplicitRole;

package/lib/specs/get-permitted-roles.d.ts

@@ -6,7 +6,13 @@ import type { ARIAVersion, Matches, MLMLSpec } from '../types';
  * - If `true`, this mean is "Any".
  * - If `false`, this mean is "No".
  */
-export declare function getPermittedRoles(specs: Readonly<MLMLSpec>, localName: string, namespace: string | null, version: ARIAVersion, matches: Matches): {
-    name: string;
-    deprecated?: boolean;
+export declare function getPermittedRoles(
+	specs: MLMLSpec,
+	localName: string,
+	namespace: string | null,
+	version: ARIAVersion,
+	matches: Matches,
+): readonly {
+	readonly name: string;
+	readonly deprecated?: boolean;
 }[];

package/lib/specs/get-permitted-roles.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPermittedRoles = void 0;
+const is_plain_object_1 = require("is-plain-object");
 const merge_array_1 = require("../utils/merge-array");
 const aria_specs_1 = require("./aria-specs");
 const get_aria_1 = require("./get-aria");
@@ -26,17 +27,7 @@ function getPermittedRoles(specs, localName, namespace, version, matches) {
             name: role.name,
         })));
     }
-    if (Array.isArray(permittedRoles)) {
-        permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, permittedRoles.map(role => {
-            if (typeof role === 'string') {
-                return {
-                    name: role,
-                };
-            }
-            return role;
-        }));
-    }
-    else if (!(typeof permittedRoles === 'boolean')) {
+    if (isAAMInfo(permittedRoles)) {
         if (permittedRoles['core-aam']) {
             permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, roles
                 .filter(role => !role.isAbstract)
@@ -52,10 +43,23 @@ function getPermittedRoles(specs, localName, namespace, version, matches) {
             })));
         }
     }
-    if (implicitRole) {
-        const implicitRoles = implicitRole === 'presentation' || implicitRole === 'none' ? ['none', 'presentation'] : [implicitRole];
-        return (0, merge_array_1.mergeArray)(implicitRoles.map(r => ({ name: r })), permittedRoleList);
+    else if (typeof permittedRoles !== 'boolean') {
+        permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, permittedRoles.map(role => {
+            if (typeof role === 'string') {
+                return {
+                    name: role,
+                };
+            }
+            return role;
+        }));
     }
-    return permittedRoleList;
+    if (implicitRole === false) {
+        return permittedRoleList;
+    }
+    const implicitRoles = implicitRole === 'presentation' || implicitRole === 'none' ? ['none', 'presentation'] : [implicitRole];
+    return (0, merge_array_1.mergeArray)(implicitRoles.map(r => ({ name: r })), permittedRoleList);
 }
 exports.getPermittedRoles = getPermittedRoles;
+function isAAMInfo(permittedRoles) {
+    return (0, is_plain_object_1.isPlainObject)(permittedRoles);
+}

package/lib/specs/get-role-spec.d.ts

@@ -1,5 +1,12 @@
 import type { ARIAVersion, ARIARoleInSchema, MLMLSpec, ARIARole } from '../types';
 import type { NamespaceURI } from '@markuplint/ml-ast';
-export declare function getRoleSpec(specs: Readonly<MLMLSpec>, roleName: string, namespace: NamespaceURI, version: ARIAVersion): (ARIARole & {
-    superClassRoles: ARIARoleInSchema[];
-}) | null;
+export declare function getRoleSpec(
+	specs: MLMLSpec,
+	roleName: string,
+	namespace: NamespaceURI,
+	version: ARIAVersion,
+):
+	| (ARIARole & {
+			superClassRoles: ARIARoleInSchema[];
+	  })
+	| null;

package/lib/specs/get-role-spec.js

@@ -38,9 +38,9 @@ function recursiveTraverseSuperClassRoles(specs, roleName, namespace, version) {
     return roles;
 }
 function getSuperClassRoles(specs, roleName, namespace, version) {
-    var _a;
+    var _a, _b;
     const role = getRoleByName(specs, roleName, namespace, version);
-    return (((_a = role === null || role === void 0 ? void 0 : role.generalization) === null || _a === void 0 ? void 0 : _a.map(roleName => getRoleByName(specs, roleName, namespace, version)).filter((role) => !!role)) || null);
+    return ((_b = (_a = role === null || role === void 0 ? void 0 : role.generalization) === null || _a === void 0 ? void 0 : _a.map(roleName => getRoleByName(specs, roleName, namespace, version)).filter((role) => !!role)) !== null && _b !== void 0 ? _b : null);
 }
 function getRoleByName(specs, roleName, namespace, version) {
     const { roles, graphicsRoles } = (0, aria_specs_1.ariaSpecs)(specs, version);

package/lib/specs/get-selectors-by-content-model-category.d.ts

@@ -1,3 +1,3 @@
 import type { MLMLSpec } from '../types';
-import type { Category } from '../types/permitted-structres';
-export declare function getSelectorsByContentModelCategory(specs: Readonly<MLMLSpec>, category: Category): ReadonlyArray<string>;
+import type { Category } from '../types/permitted-structures';
+export declare function getSelectorsByContentModelCategory(specs: MLMLSpec, category: Category): ReadonlyArray<string>;

package/lib/specs/get-selectors-by-content-model-category.js

@@ -3,6 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSelectorsByContentModelCategory = void 0;
 function getSelectorsByContentModelCategory(specs, category) {
     const selectors = specs.def['#contentModels'][category];
-    return selectors || [];
+    return selectors !== null && selectors !== void 0 ? selectors : [];
 }
 exports.getSelectorsByContentModelCategory = getSelectorsByContentModelCategory;

package/lib/specs/get-spec-by-tag-name.d.ts

@@ -1,2 +1,6 @@
-import type { ElementSpec, MLMLSpec } from '../types';
-export declare function getSpecByTagName(specs: Readonly<MLMLSpec>, localName: string, namespace: string | null): ElementSpec | null;
+import type { ElementSpec } from '../types';
+export declare function getSpecByTagName<K extends keyof ElementSpec = keyof ElementSpec>(
+	specs: readonly Pick<ElementSpec, 'name' | K>[],
+	localName: string,
+	namespace: string | null,
+): Pick<ElementSpec, 'name' | K> | null;