@markuplint/ml-spec 3.9.0 → 3.11.0

package/lib/constant/aria-version.d.ts

@@ -1,2 +1,2 @@
-export declare const ariaVersions: readonly ['1.1', '1.2', '1.3'];
-export declare const ARIA_RECOMMENDED_VERSION: '1.2';
+export declare const ariaVersions: readonly ["1.1", "1.2", "1.3"];
+export declare const ARIA_RECOMMENDED_VERSION: "1.2";

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

@@ -1,7 +1,2 @@
 import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types';
-export declare function getComputedRole(
-	specs: MLMLSpec,
-	el: Element,
-	version: ARIAVersion,
-	assumeSingleNode?: boolean,
-): ComputedRole;
+export declare function getComputedRole(specs: MLMLSpec, el: Element, version: ARIAVersion, assumeSingleNode?: boolean): ComputedRole;

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getComputedRole = void 0;
 const aria_specs_1 = require("../specs/aria-specs");
 const is_presentational_1 = require("../specs/is-presentational");
+const accname_computation_1 = require("./accname-computation");
 const get_attr_specs_1 = require("./get-attr-specs");
 const get_explicit_role_1 = require("./get-explicit-role");
 const get_implicit_role_1 = require("./get-implicit-role");
@@ -13,7 +14,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, assumeSingleNode = false) {
-    var _a, _b;
+    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);
     const computedRole = explicitRole.role
@@ -83,6 +84,51 @@ el, version, assumeSingleNode = false) {
             };
         }
     }
+    /**
+     * SVG: Including Elements in the Accessibility Tree
+     *
+     * > Many SVG elements—although rendered to the screen—
+     * > do not have an intrinsic semantic meaning. Instead,
+     * > they represent components of the visual presentation of the document.
+     * > To simplify the accessible representation of the document,
+     * > these purely presentational elements should normally be omitted
+     * > from the accessibility tree, unless the author explicitly provides semantic content.
+     * >
+     * > However, any rendered SVG element may have semantic meaning.
+     * > Authors indicate the significance of the element
+     * > by including alternative text content or WAI-ARIA attributes.
+     * > This section defines the rules for including normally-omitted elements
+     * > in the accessibility tree.
+     * >
+     * > The following graphical and container elements
+     * > in the SVG namespace SHOULD NOT be included in the accessibility tree,
+     * > except as described in this section:
+     * >
+     * > - shape elements (circle, ellipse, line, path, polygon, polyline, rect)
+     * > - the use element
+     * > - the grouping (g) element
+     * > - the image element
+     * > - the mesh element
+     * > - text formatting elements (textPath, tspan)
+     * > - the foreignObject element
+     *
+     * @see https://www.w3.org/TR/svg-aam-1.0/#include_elements
+     */
+    if (
+    // It doesn't been specified a valid explicit role.
+    (explicitRole.role === null || explicitRole.errorType != null) &&
+        // It is an SVG element.
+        el.namespaceURI === 'http://www.w3.org/2000/svg') {
+        const accname = (0, accname_computation_1.getAccname)(el).trim() ||
+            ((_b = (_a = Array.from(el.children)
+                .find(child => ['title', 'desc'].includes(child.localName))) === null || _a === void 0 ? void 0 : _a.textContent) === null || _b === void 0 ? void 0 : _b.trim());
+        if (!accname) {
+            return {
+                el,
+                role: null,
+            };
+        }
+    }
     if (computedRole.role && !(0, is_presentational_1.isPresentational)(computedRole.role.name)) {
         return computedRole;
     }
@@ -138,7 +184,7 @@ el, version, assumeSingleNode = false) {
      */
     if (explicitRole.role) {
         const nonPresentationalAncestor = (0, get_non_presentational_ancestor_1.getNonPresentationalAncestor)(el, specs, version);
-        if (nonPresentationalAncestor.role && ((_a = nonPresentationalAncestor.role) === null || _a === void 0 ? void 0 : _a.requiredOwnedElements.length) > 0) {
+        if (nonPresentationalAncestor.role && ((_c = nonPresentationalAncestor.role) === null || _c === void 0 ? void 0 : _c.requiredOwnedElements.length) > 0) {
             if (nonPresentationalAncestor.role.requiredOwnedElements.some(expected => {
                 // const ancestor = nonPresentationalAncestor.el;
                 // const ancestorImplicitRole = getImplicitRole(specs, ancestor, version);
@@ -164,7 +210,7 @@ el, version, assumeSingleNode = false) {
      */
     const { props } = (0, aria_specs_1.ariaSpecs)(specs, version);
     for (const attr of Array.from(el.attributes)) {
-        if ((_b = props.find(p => p.name === attr.name)) === null || _b === void 0 ? void 0 : _b.isGlobal) {
+        if ((_d = props.find(p => p.name === attr.name)) === null || _d === void 0 ? void 0 : _d.isGlobal) {
             return {
                 ...implicitRole,
                 errorType: 'GLOBAL_PROP_MUST_NOT_BE_PRESENTATIONAL',

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

@@ -1,29 +1,4 @@
 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-implicit-role.d.ts

@@ -1,7 +1,3 @@
 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,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: MLMLSpec,
-): readonly {
-	readonly name: string;
-	readonly 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-spec.d.ts

@@ -1,5 +1,2 @@
 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,9 +1,3 @@
 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/matches-context-role.d.ts

@@ -1,7 +1,2 @@
 import type { ARIAVersion, MLMLSpec } from '../types';
-export declare function matchesContextRole(
-	conditions: readonly string[],
-	ownedEl: Element,
-	specs: MLMLSpec,
-	version: ARIAVersion,
-): boolean;
+export declare function matchesContextRole(conditions: readonly string[], ownedEl: Element, specs: MLMLSpec, version: ARIAVersion): boolean;

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

@@ -1,9 +1,6 @@
 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,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,10 +1,4 @@
 import type { ARIAVersion, Matches, MLMLSpec } from '../types';
 import type { ARIA } from '../types/aria';
 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;
+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-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,
-): 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-implicit-role.d.ts

@@ -1,8 +1,2 @@
 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.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: MLMLSpec,
-	localName: string,
-	namespace: string | null,
-	version: ARIAVersion,
-	matches: Matches,
-): readonly {
-	readonly name: string;
-	readonly 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-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: 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-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: 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/resolve-version.d.ts

@@ -1,7 +1,4 @@
 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[];
 };