@markuplint/ml-spec 3.0.0-rc.4 → 3.0.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,6 +1,3 @@
 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,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 getImplicitRoleName(el: Element, version: ARIAVersion, specs: Readonly<MLMLSpec>): import("..").ImplicitRole;

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-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: Readonly<MLMLSpec>): {
+    name: string;
+    deprecated?: boolean | undefined;
 }[];

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

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

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

@@ -2,8 +2,10 @@
 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_palpable_elements_1 = require("../specs/is-palpable-elements");
 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
@@ -19,6 +21,12 @@ function isExposed(el, specs, version) {
     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) {
+        return true;
+    }
     // According to HTML and SVG Specs with **the author's interpretation**
     {
         if (!(0, is_palpable_elements_1.isPalpableElement)(el, specs, { extendsSvg: true, extendsExposableElements: true })) {

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: 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,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,3 @@
 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-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): 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,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: Readonly<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: Readonly<MLMLSpec>, localName: string, namespace: string | null, version: ARIAVersion, matches: Matches): {
+    name: string;
+    deprecated?: boolean;
 }[];

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: Readonly<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: Readonly<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-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: 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/types/aria.d.ts

@@ -10,141 +10,127 @@ 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;
 }