@markuplint/ml-spec 3.5.0 → 3.6.0

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): readonly import("../types").Attribute[] | null;
+export declare function getAttrSpecs(el: Element, schema: MLMLSpec): readonly import('../types').Attribute[] | null;

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

@@ -1,11 +1,11 @@
 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: MLMLSpec, el: Element, version: ARIAVersion): ARIAProps;

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

@@ -90,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.js

@@ -12,7 +12,7 @@ const may_be_focusable_1 = require("./may-be-focusable");
 function getComputedRole(specs, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 el, version) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     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;
@@ -41,7 +41,7 @@ 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) {
         const nonPresentationalAncestor = (0, get_non_presentational_ancestor_1.getNonPresentationalAncestor)(el, specs, version);
         if (!nonPresentationalAncestor.role) {
             return {
@@ -50,7 +50,7 @@ el, version) {
                 errorType: 'NO_OWNER',
             };
         }
-        if (!((_b = computedRole.role) === null || _b === void 0 ? void 0 : _b.requiredContextRole.includes(nonPresentationalAncestor.role.name))) {
+        if (!((_a = computedRole.role) === null || _a === void 0 ? void 0 : _a.requiredContextRole.includes(nonPresentationalAncestor.role.name))) {
             return {
                 el,
                 role: null,
@@ -113,7 +113,7 @@ 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 && ((_b = nonPresentationalAncestor.role) === null || _b === void 0 ? void 0 : _b.requiredOwnedElements.length) > 0) {
             if (nonPresentationalAncestor.role.requiredOwnedElements.some(expected => {
                 // const ancestor = nonPresentationalAncestor.el;
                 // const ancestorImplicitRole = getImplicitRole(specs, ancestor, version);
@@ -139,7 +139,7 @@ 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 ((_c = props.find(p => p.name === attr.name)) === null || _c === void 0 ? void 0 : _c.isGlobal) {
             return {
                 ...implicitRole,
                 errorType: 'GLOBAL_PROP_MUST_NOT_BE_PRESENTATIONAL',

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

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

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

@@ -7,8 +7,9 @@ const get_permitted_roles_1 = require("./get-permitted-roles");
 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';

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: MLMLSpec, el: Element, version: ARIAVersion): ComputedRole;
-export declare function getImplicitRoleName(el: Element, version: ARIAVersion, specs: MLMLSpec): import("..").ImplicitRole;
+export declare function getImplicitRoleName(
+	el: Element,
+	version: ARIAVersion,
+	specs: MLMLSpec,
+): import('..').ImplicitRole;

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-spec.d.ts

@@ -1,2 +1,5 @@
 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;
+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/has-required-owned-elements.d.ts

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

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

@@ -25,7 +25,7 @@ el, specs, version) {
     // 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) {
+    if (!spec || spec.deprecated || spec.obsolete != null) {
         return true;
     }
     // According to HTML and SVG Specs with **the author's interpretation**
@@ -57,6 +57,7 @@ exports.isExposed = isExposed;
 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:
@@ -81,7 +82,7 @@ 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;
     }
     /**

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

@@ -1,6 +1,9 @@
 import type { ARIAVersion, MLMLSpec } from '../types';
-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[];
+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-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.js

@@ -52,7 +52,7 @@ function getVersionResolvedARIA(specs, localName, namespace, version) {
         return null;
     }
     aria = (0, resolve_version_1.resolveVersion)(spec, version);
-    if (aria.permittedRoles) {
+    if (aria.permittedRoles !== false) {
         aria = {
             ...aria,
             permittedRoles: optimizePermittedRoles(aria.permittedRoles),

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): readonly Attribute[] | null;
+export declare function getAttrSpecs(
+	localName: string,
+	namespace: NamespaceURI | null,
+	schema: MLMLSpec,
+): readonly Attribute[] | null;
 type HasName = {
-    readonly name: string;
+	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: 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.js

@@ -53,11 +53,11 @@ function getPermittedRoles(specs, localName, namespace, version, matches) {
             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);
+    if (implicitRole === false) {
+        return permittedRoleList;
     }
-    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) {

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: 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.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 } 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/get-spec-by-tag-name.js

@@ -4,12 +4,13 @@ exports.getSpecByTagName = void 0;
 const resolve_namespace_1 = require("../utils/resolve-namespace");
 const cache = new Map();
 function getSpecByTagName(specs, localName, namespace) {
-    const { localNameWithNS } = (0, resolve_namespace_1.resolveNamespace)(localName, namespace || undefined);
+    var _a;
+    const { localNameWithNS } = (0, resolve_namespace_1.resolveNamespace)(localName, namespace !== null && namespace !== void 0 ? namespace : undefined);
     let spec = cache.get(localNameWithNS);
     if (spec !== undefined) {
         return spec;
     }
-    spec = specs.find(spec => spec.name === localNameWithNS) || null;
+    spec = (_a = specs.find(spec => spec.name === localNameWithNS)) !== null && _a !== void 0 ? _a : null;
     cache.set(localNameWithNS, spec);
     return spec;
 }

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

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

package/lib/specs/is-palpable-elements.js

@@ -34,10 +34,10 @@ const exposableElementsThatAreNoBelongingAModel = [
 function isPalpableElement(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 el, specs, options) {
-    var _a, _b;
-    const conditions = [((_a = specs.def['#contentModels']['#palpable']) === null || _a === void 0 ? void 0 : _a.join(',')) || ''];
+    var _a, _b, _c, _d;
+    const conditions = [(_b = (_a = specs.def['#contentModels']['#palpable']) === null || _a === void 0 ? void 0 : _a.join(',')) !== null && _b !== void 0 ? _b : ''];
     if ((options === null || options === void 0 ? void 0 : options.extendsSvg) !== false /* default true */) {
-        conditions.push(((_b = specs.def['#contentModels']['#SVGRenderable']) === null || _b === void 0 ? void 0 : _b.join(',')) || '');
+        conditions.push((_d = (_c = specs.def['#contentModels']['#SVGRenderable']) === null || _c === void 0 ? void 0 : _c.join(',')) !== null && _d !== void 0 ? _d : '');
     }
     if (options === null || options === void 0 ? void 0 : options.extendsExposableElements /* default false */) {
         conditions.push(exposableElementsThatAreNoBelongingAModel.join(','));

package/lib/specs/resolve-version.d.ts

@@ -1,4 +1,7 @@
 import type { ARIAVersion } from '../types';
 import type { ARIA } from '../types/aria';
 import type { ReadonlyDeep } from 'type-fest';
-export declare function resolveVersion(aria: ReadonlyDeep<ARIA>, version: ARIAVersion): Omit<ReadonlyDeep<ARIA>, ARIAVersion>;
+export declare function resolveVersion(
+	aria: ReadonlyDeep<ARIA>,
+	version: ARIAVersion,
+): Omit<ReadonlyDeep<ARIA>, ARIAVersion>;

package/lib/specs/schema-to-spec.d.ts

@@ -7,7 +7,7 @@ import type { ElementSpec, ExtendedSpec, MLMLSpec } from '../types';
  * @param schemas `MLDocument.schemas`
  */
 export declare function schemaToSpec(schemas: readonly [MLMLSpec, ...ExtendedSpec[]]): {
-    cites: import("../types").Cites;
-    def: import("../types").SpecDefs;
-    specs: readonly ElementSpec[];
+	cites: import('../types').Cites;
+	def: import('../types').SpecDefs;
+	specs: readonly ElementSpec[];
 };