@markuplint/ml-spec 3.4.0 → 3.5.0

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) {

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

@@ -1,2 +1,2 @@
 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): ComputedRole;

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

@@ -9,7 +9,9 @@ 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 may_be_focusable_1 = require("./may-be-focusable");
-function getComputedRole(specs, el, version) {
+function getComputedRole(specs, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version) {
     var _a, _b, _c, _d;
     const implicitRole = (0, get_implicit_role_1.getImplicitRole)(specs, el, version);
     const explicitRole = (0, get_explicit_role_1.getExplicitRole)(specs, el, version);
@@ -116,7 +118,7 @@ function getComputedRole(specs, el, version) {
                 // 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,
@@ -151,7 +153,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 +163,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,6 +1,4 @@
 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,7 +3,9 @@ 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);

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

@@ -4,7 +4,9 @@ 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) {
     const roleValue = el.getAttribute('role');
     const roleNames = (roleValue === null || roleValue === void 0 ? void 0 : roleValue.toLowerCase().trim().split(/\s+/g)) || [];
     const permittedRoles = (0, get_permitted_roles_1.getPermittedRoles)(el, version, specs);
@@ -83,7 +85,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,7 +1,3 @@
 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,11 +1,5 @@
 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,7 +3,9 @@ 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;
     while (ancestor) {

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

@@ -1,9 +1,5 @@
 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,5 +1,2 @@
 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,8 +1,3 @@
 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

@@ -15,7 +15,9 @@ 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;
@@ -52,7 +54,9 @@ 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) {
     /**
      * The following elements are not exposed via the accessibility API and
      * user agents MUST NOT include them in the accessibility tree:
@@ -131,7 +135,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:
      */
@@ -178,7 +184,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;
@@ -186,7 +194,9 @@ function hasDisplayNodeOrVisibilityHidden(el) {
     // TODO: Improve accuracy
     return /display\s*:\s*none|visibility\s*:\s*hidden/gi.test(style);
 }
-function isExposedElement(el, specs) {
+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)) {
@@ -194,7 +204,9 @@ function isExposedElement(el, specs) {
     }
     return isNotMetaOrHiddenHTMLElement(el, specs);
 }
-function 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)) {

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

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

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

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

@@ -1,9 +1,4 @@
 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

@@ -53,7 +53,10 @@ function getVersionResolvedARIA(specs, localName, namespace, version) {
     }
     aria = (0, resolve_version_1.resolveVersion)(spec, version);
     if (aria.permittedRoles) {
-        aria.permittedRoles = optimizePermittedRoles(aria.permittedRoles);
+        aria = {
+            ...aria,
+            permittedRoles: optimizePermittedRoles(aria.permittedRoles),
+        };
     }
     cache.set(key, aria);
     return aria;

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

@@ -1,12 +1,8 @@
 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;
+export declare function getAttrSpecs(localName: string, namespace: NamespaceURI | null, schema: MLMLSpec): readonly Attribute[] | null;
 type HasName = {
-	name: string;
+    readonly name: string;
 };
 export declare function nameCompare(a: HasName | string, b: HasName | string): 1 | -1 | 0;
 export {};

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

@@ -1,8 +1,2 @@
 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,13 +6,7 @@ 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,6 +43,16 @@ function getPermittedRoles(specs, localName, namespace, version, matches) {
             })));
         }
     }
+    else if (typeof permittedRoles !== 'boolean') {
+        permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, permittedRoles.map(role => {
+            if (typeof role === 'string') {
+                return {
+                    name: role,
+                };
+            }
+            return role;
+        }));
+    }
     if (implicitRole) {
         const implicitRoles = implicitRole === 'presentation' || implicitRole === 'none' ? ['none', 'presentation'] : [implicitRole];
         return (0, merge_array_1.mergeArray)(implicitRoles.map(r => ({ name: r })), permittedRoleList);
@@ -59,3 +60,6 @@ function getPermittedRoles(specs, localName, namespace, version, matches) {
     return permittedRoleList;
 }
 exports.getPermittedRoles = getPermittedRoles;
+function isAAMInfo(permittedRoles) {
+    return (0, is_plain_object_1.isPlainObject)(permittedRoles);
+}

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

@@ -1,12 +1,5 @@
 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-selectors-by-content-model-category.d.ts

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

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

@@ -1,6 +1,2 @@
 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;
+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;

package/lib/specs/is-nothing-content-model.js

@@ -6,7 +6,9 @@ const is_void_element_1 = require("./is-void-element");
  * @see https://html.spec.whatwg.org/multipage/dom.html#the-nothing-content-model
  * @see https://html.spec.whatwg.org/multipage/indices.html#elements-3
  */
-function isNothingContentModel(el) {
+function isNothingContentModel(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
     return (0, is_void_element_1.isVoidElement)(el) || ['iframe', 'template'].includes(el.localName);
 }
 exports.isNothingContentModel = isNothingContentModel;

package/lib/specs/is-palpable-elements.d.ts

@@ -1,9 +1,5 @@
 import type { MLMLSpec } from '../types';
-export declare function isPalpableElement(
-	el: Element,
-	specs: Readonly<MLMLSpec>,
-	options?: {
-		extendsSvg?: boolean;
-		extendsExposableElements?: boolean;
-	},
-): boolean;
+export declare function isPalpableElement(el: Element, specs: MLMLSpec, options?: {
+    readonly extendsSvg?: boolean;
+    readonly extendsExposableElements?: boolean;
+}): boolean;