@markuplint/ml-spec 3.3.0 → 3.4.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): import("../types").Attribute[] | null;
+export declare function getAttrSpecs(el: Element, schema: MLMLSpec): 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: Readonly<MLMLSpec>, el: Element, version: ARIAVersion): ARIAProps;

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

@@ -1,3 +1,6 @@
 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;
+export declare function getContentModel(
+	el: Element,
+	specs: Pick<ElementSpec, 'name' | 'contentModel'>[],
+): boolean | PermittedContentPattern[] | null;

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 getImplicitRoleName(
+	el: Element,
+	version: ARIAVersion,
+	specs: Readonly<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-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: Readonly<MLMLSpec>,
+): {
+	name: string;
+	deprecated?: boolean | undefined;
 }[];

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: Pick<ElementSpec, 'name' | K>[],
+): Pick<ElementSpec, 'name' | K> | null;

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

@@ -1,3 +1,8 @@
 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 isRequiredOwnedElement(
+	owned: ComputedRole,
+	query: string,
+	specs: MLMLSpec,
+	version: ARIAVersion,
+): boolean;

package/lib/index.d.ts

@@ -11,6 +11,7 @@ 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';

package/lib/index.js

@@ -14,6 +14,7 @@ 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);

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: Readonly<MLMLSpec>,
+	version: ARIAVersion,
+): {
+	roles: import('../types').ARIARoleInSchema[];
+	graphicsRoles: import('../types').ARIARoleInSchema[];
+	props: 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.d.ts

@@ -1,3 +1,9 @@
 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;
+export declare function getARIA(
+	specs: Readonly<MLMLSpec>,
+	localName: string,
+	namespace: string | null,
+	version: ARIAVersion,
+	matches: Matches,
+): Omit<ARIA, ARIAVersion | 'conditions'> | null;

package/lib/specs/get-aria.js

@@ -21,6 +21,9 @@ function getARIA(specs, localName, namespace, version, matches) {
             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;

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;
+export declare function getAttrSpecs(
+	localName: string,
+	namespace: NamespaceURI | null,
+	schema: MLMLSpec,
+): Attribute[] | null;
 type HasName = {
-    name: string;
+	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,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: Readonly<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: Readonly<MLMLSpec>,
+	localName: string,
+	namespace: string | null,
+	version: ARIAVersion,
+	matches: Matches,
+): {
+	name: string;
+	deprecated?: boolean;
 }[];

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: Readonly<MLMLSpec>,
+	roleName: string,
+	namespace: NamespaceURI,
+	version: ARIAVersion,
+):
+	| (ARIARole & {
+			superClassRoles: ARIARoleInSchema[];
+	  })
+	| null;

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

@@ -1,3 +1,6 @@
 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: Readonly<MLMLSpec>,
+	category: Category,
+): ReadonlyArray<string>;

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/is-palpable-elements.d.ts

@@ -1,5 +1,9 @@
 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: Readonly<MLMLSpec>,
+	options?: {
+		extendsSvg?: boolean;
+		extendsExposableElements?: boolean;
+	},
+): boolean;

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: ElementSpec[];
+	cites: import('../types').Cites;
+	def: import('../types').SpecDefs;
+	specs: ElementSpec[];
 };

package/lib/specs/schema-to-spec.js

@@ -66,10 +66,10 @@ function schemaToSpec(schemas) {
                     ...exSpec,
                     globalAttrs: {
                         ...elSpec.globalAttrs,
-                        ...exSpec.globalAttrs,
+                        ...exSpec === null || exSpec === void 0 ? void 0 : exSpec.globalAttrs,
                     },
-                    attributes: mergeAttrSpec(elSpec.attributes, exSpec.attributes),
-                    categories: (0, merge_array_1.mergeArray)(elSpec.categories, exSpec.categories),
+                    attributes: mergeAttrSpec(elSpec.attributes, exSpec === null || exSpec === void 0 ? void 0 : exSpec.attributes),
+                    categories: (0, merge_array_1.mergeArray)(elSpec.categories, exSpec === null || exSpec === void 0 ? void 0 : exSpec.categories),
                 });
             }
             result.specs = specs;

package/lib/types/aria.d.ts

@@ -10,127 +10,141 @@ export type ImplicitRole = false | string;
 /**
  * If `true`, this mean is "Any". If `false`, this mean is "No".
  */
-export type PermittedRoles = boolean | (string | {
-    name: string;
-    deprecated?: true;
-    [k: string]: unknown;
-})[] | {
-    'core-aam'?: true;
-    'graphics-aam'?: true;
-};
+export type PermittedRoles =
+	| boolean
+	| (
+			| string
+			| {
+					name: string;
+					deprecated?: true;
+					[k: string]: unknown;
+			  }
+	  )[]
+	| {
+			'core-aam'?: true;
+			'graphics-aam'?: true;
+	  };
 /**
  * If set false:
  * > No role or aria-* attributes
  */
-export type PermittedARIAProperties = false | {
-    global?: true;
-    /**
-     * Set true if the spec says "and any aria-* attributes applicable to the allowed roles."
-     */
-    role?: true | string | [string, ...string[]];
-    /**
-     * @minItems 1
-     */
-    only?: [
-        (string | {
-            name: string;
-            value?: string;
-        }),
-        ...(string | {
-            name: string;
-            value?: string;
-        })[]
-    ];
-    /**
-     * @minItems 1
-     */
-    without?: [
-        {
-            type: 'not-recommended' | 'should-not' | 'must-not';
-            name: string;
-            value?: string;
-            alt?: {
-                method: 'remove-attr' | 'set-attr';
-                target: string;
-            };
-        },
-        ...{
-            type: 'not-recommended' | 'should-not' | 'must-not';
-            name: string;
-            value?: string;
-            alt?: {
-                method: 'remove-attr' | 'set-attr';
-                target: string;
-            };
-        }[]
-    ];
-};
+export type PermittedARIAProperties =
+	| false
+	| {
+			global?: true;
+			/**
+			 * Set true if the spec says "and any aria-* attributes applicable to the allowed roles."
+			 */
+			role?: true | string | [string, ...string[]];
+			/**
+			 * @minItems 1
+			 */
+			only?: [
+				(
+					| string
+					| {
+							name: string;
+							value?: string;
+					  }
+				),
+				...(
+					| string
+					| {
+							name: string;
+							value?: string;
+					  }
+				)[],
+			];
+			/**
+			 * @minItems 1
+			 */
+			without?: [
+				{
+					type: 'not-recommended' | 'should-not' | 'must-not';
+					name: string;
+					value?: string;
+					alt?: {
+						method: 'remove-attr' | 'set-attr';
+						target: string;
+					};
+				},
+				...{
+					type: 'not-recommended' | 'should-not' | 'must-not';
+					name: string;
+					value?: string;
+					alt?: {
+						method: 'remove-attr' | 'set-attr';
+						target: string;
+					};
+				}[],
+			];
+	  };
 export interface AriaSchema {
-    _?: ARIA;
-    [k: string]: unknown;
+	_?: ARIA;
+	[k: string]: unknown;
 }
 export interface ARIA {
-    implicitRole: ImplicitRole;
-    permittedRoles: PermittedRoles;
-    namingProhibited?: true;
-    implicitProperties?: ImplicitProperties;
-    properties?: PermittedARIAProperties;
-    conditions?: {
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` ".+".
-         */
-        [k: string]: {
-            implicitRole?: ImplicitRole;
-            permittedRoles?: PermittedRoles;
-            namingProhibited?: true;
-            implicitProperties?: ImplicitProperties;
-            properties?: PermittedARIAProperties;
-        };
-    };
-    '1.2'?: {
-        implicitRole?: ImplicitRole;
-        permittedRoles?: PermittedRoles;
-        namingProhibited?: true;
-        implicitProperties?: ImplicitProperties;
-        properties?: PermittedARIAProperties;
-        conditions?: {
-            /**
-             * This interface was referenced by `undefined`'s JSON-Schema definition
-             * via the `patternProperty` ".+".
-             */
-            [k: string]: {
-                implicitRole?: ImplicitRole;
-                permittedRoles?: PermittedRoles;
-                namingProhibited?: true;
-                implicitProperties?: ImplicitProperties;
-                properties?: PermittedARIAProperties;
-            };
-        };
-    };
-    '1.1'?: {
-        implicitRole?: ImplicitRole;
-        permittedRoles?: PermittedRoles;
-        implicitProperties?: ImplicitProperties;
-        properties?: PermittedARIAProperties;
-        conditions?: {
-            /**
-             * This interface was referenced by `undefined`'s JSON-Schema definition
-             * via the `patternProperty` ".+".
-             */
-            [k: string]: {
-                implicitRole?: ImplicitRole;
-                permittedRoles?: PermittedRoles;
-                implicitProperties?: ImplicitProperties;
-                properties?: PermittedARIAProperties;
-            };
-        };
-    };
+	implicitRole: ImplicitRole;
+	permittedRoles: PermittedRoles;
+	namingProhibited?: true;
+	implicitProperties?: ImplicitProperties;
+	properties?: PermittedARIAProperties;
+	conditions?: {
+		/**
+		 * This interface was referenced by `undefined`'s JSON-Schema definition
+		 * via the `patternProperty` ".+".
+		 */
+		[k: string]: {
+			implicitRole?: ImplicitRole;
+			permittedRoles?: PermittedRoles;
+			namingProhibited?: true;
+			implicitProperties?: ImplicitProperties;
+			properties?: PermittedARIAProperties;
+		};
+	};
+	'1.2'?: {
+		implicitRole?: ImplicitRole;
+		permittedRoles?: PermittedRoles;
+		namingProhibited?: true;
+		implicitProperties?: ImplicitProperties;
+		properties?: PermittedARIAProperties;
+		conditions?: {
+			/**
+			 * This interface was referenced by `undefined`'s JSON-Schema definition
+			 * via the `patternProperty` ".+".
+			 */
+			[k: string]: {
+				implicitRole?: ImplicitRole;
+				permittedRoles?: PermittedRoles;
+				namingProhibited?: true;
+				implicitProperties?: ImplicitProperties;
+				properties?: PermittedARIAProperties;
+			};
+		};
+	};
+	'1.1'?: {
+		implicitRole?: ImplicitRole;
+		permittedRoles?: PermittedRoles;
+		implicitProperties?: ImplicitProperties;
+		properties?: PermittedARIAProperties;
+		conditions?: {
+			/**
+			 * This interface was referenced by `undefined`'s JSON-Schema definition
+			 * via the `patternProperty` ".+".
+			 */
+			[k: string]: {
+				implicitRole?: ImplicitRole;
+				permittedRoles?: PermittedRoles;
+				implicitProperties?: ImplicitProperties;
+				properties?: PermittedARIAProperties;
+			};
+		};
+	};
 }
 export interface ImplicitProperties {
-    /**
-     * This interface was referenced by `ImplicitProperties`'s JSON-Schema definition
-     * via the `patternProperty` "^aria-.+".
-     */
-    [k: string]: string;
+	/**
+	 * This interface was referenced by `ImplicitProperties`'s JSON-Schema definition
+	 * via the `patternProperty` "^aria-.+".
+	 */
+	[k: string]: string;
 }