@markuplint/ml-spec 3.0.0-alpha.5 → 3.0.0-alpha.6

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,12 +1,12 @@
 import type { ARIAVersion, MLMLSpec } from '../types';
-declare type ARIAProps = Record<string, ARIAProp>;
-declare type ARIAProp = {
-    name: string;
-    value: string | undefined;
-    required: boolean;
-    deprecated: boolean;
-    from: ARIAPropReferenceType;
+type ARIAProps = Record<string, ARIAProp>;
+type ARIAProp = {
+	name: string;
+	value: string | undefined;
+	required: boolean;
+	deprecated: boolean;
+	from: ARIAPropReferenceType;
 };
-declare type ARIAPropReferenceType = 'default' | 'html-attr' | 'aria-attr';
+type ARIAPropReferenceType = 'default' | 'html-attr' | 'aria-attr';
 export declare function getComputedAriaProps(specs: Readonly<MLMLSpec>, el: Element, version: ARIAVersion): ARIAProps;
 export {};

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/dom-traverse/is-exposed.js

@@ -2,40 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isExposed = void 0;
 const aria_specs_1 = require("../specs/aria-specs");
+const is_palpable_elements_1 = require("../specs/is-palpable-elements");
 const is_presentational_1 = require("../specs/is-presentational");
 const get_computed_role_1 = require("./get-computed-role");
-/**
- * Exposable content models and elements
- *
- * **WARNING**:
- * This implementation is through the author's interpretation.
- * Want a issue request.
- * https://github.com/markuplint/markuplint/issues/new
- *
- * @see exposableModels https://html.spec.whatwg.org/multipage/dom.html#content-models
- * @see exposableElementsThatAreNoBelongingAModel https://html.spec.whatwg.org/multipage/indices.html#elements-3
- */
-const exposableModels = ['#palpable', '#SVGRenderable'];
-const exposableElementsThatAreNoBelongingAModel = [
-    'body',
-    'dd',
-    'dt',
-    'figcaption',
-    'html',
-    'legend',
-    'li',
-    'optgroup',
-    'option',
-    'rp',
-    'rt',
-    'summary',
-    'tbody',
-    'td',
-    'tfoot',
-    'th',
-    'thead',
-    'tr',
-];
 /**
  * Detect including/excluding from the Accessibility Tree
  *
@@ -52,16 +21,7 @@ function isExposed(el, specs, version) {
     }
     // According to HTML and SVG Specs with **the author's interpretation**
     {
-        const exposableConditions = exposableModels
-            .map(model => {
-            var _a;
-            return ((_a = specs.def['#contentModels'][model]) === null || _a === void 0 ? void 0 : _a.join(',')) || '';
-        })
-            .concat(exposableElementsThatAreNoBelongingAModel.join(','));
-        const exposable = exposableConditions.some(condition => {
-            return el.matches(condition);
-        });
-        if (!exposable) {
+        if (!(0, is_palpable_elements_1.isPalpableElement)(el, specs, { extendsSvg: true, extendsExposableElements: true })) {
             return false;
         }
     }

package/lib/index.d.ts

@@ -13,6 +13,8 @@ export * from './specs/aria-specs';
 export * from './specs/content-model-category-to-tag-names';
 export * from './specs/get-role-spec';
 export * from './specs/get-spec-by-tag-name';
+export * from './specs/is-palpable-elements';
+export * from './specs/is-void-element';
 export * from './specs/schema-to-spec';
 export * from './types';
 export * from './types/aria';

package/lib/index.js

@@ -16,6 +16,8 @@ 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-role-spec"), exports);
 tslib_1.__exportStar(require("./specs/get-spec-by-tag-name"), exports);
+tslib_1.__exportStar(require("./specs/is-palpable-elements"), exports);
+tslib_1.__exportStar(require("./specs/is-void-element"), exports);
 tslib_1.__exportStar(require("./specs/schema-to-spec"), exports);
 tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./types/aria"), 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-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;
-declare type HasName = {
-    name: string;
+export declare function getAttrSpecs(
+	localName: string,
+	namespace: NamespaceURI | null,
+	schema: MLMLSpec,
+): Attribute[] | null;
+type HasName = {
+	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

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

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPalpableElement = void 0;
+/**
+ * Exposable content models and elements
+ *
+ * **WARNING**:
+ * This implementation is through the author's interpretation.
+ * Want a issue request.
+ * https://github.com/markuplint/markuplint/issues/new
+ *
+ * @see https://html.spec.whatwg.org/multipage/indices.html#elements-3
+ */
+const exposableElementsThatAreNoBelongingAModel = [
+    'body',
+    'dd',
+    'dt',
+    'figcaption',
+    'html',
+    'legend',
+    'li',
+    'optgroup',
+    'option',
+    'rp',
+    'rt',
+    'summary',
+    'tbody',
+    'td',
+    'tfoot',
+    'th',
+    'thead',
+    'tr',
+];
+function isPalpableElement(el, specs, options) {
+    var _a, _b;
+    const conditions = [((_a = specs.def['#contentModels']['#palpable']) === null || _a === void 0 ? void 0 : _a.join(',')) || ''];
+    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(',')) || '');
+    }
+    if (options === null || options === void 0 ? void 0 : options.extendsExposableElements /* default false */) {
+        conditions.push(exposableElementsThatAreNoBelongingAModel.join(','));
+    }
+    return conditions.some(condition => {
+        return el.matches(condition);
+    });
+}
+exports.isPalpableElement = isPalpableElement;

package/lib/specs/is-void-element.d.ts

@@ -0,0 +1 @@
+export declare function isVoidElement(el: Element): boolean;

package/lib/specs/is-void-element.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVoidElement = void 0;
+/**
+ * @see https://html.spec.whatwg.org/multipage/syntax.html#void-elements
+ */
+const voidElements = [
+    'area',
+    'base',
+    'br',
+    'col',
+    'embed',
+    'hr',
+    'img',
+    'input',
+    'link',
+    'meta',
+    'source',
+    'track',
+    'wbr',
+];
+function isVoidElement(el) {
+    return voidElements.includes(el.localName);
+}
+exports.isVoidElement = isVoidElement;

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[];
 };