@markuplint/ml-spec 3.0.0-alpha.82 → 3.0.0-dev.176

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.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-nothing-content-model.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @see https://html.spec.whatwg.org/multipage/dom.html#the-nothing-content-model
+ * @see https://html.spec.whatwg.org/multipage/indices.html#elements-3
+ */
+export declare function isNothingContentModel(el: Element): boolean;

package/lib/specs/is-nothing-content-model.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNothingContentModel = void 0;
+const is_void_element_1 = require("./is-void-element");
+/**
+ * @see https://html.spec.whatwg.org/multipage/dom.html#the-nothing-content-model
+ * @see https://html.spec.whatwg.org/multipage/indices.html#elements-3
+ */
+function isNothingContentModel(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    return (0, is_void_element_1.isVoidElement)(el) || ['iframe', 'template'].includes(el.localName);
+}
+exports.isNothingContentModel = isNothingContentModel;

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

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

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

@@ -0,0 +1,49 @@
+"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(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, specs, options) {
+    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((_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(','));
+    }
+    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,27 @@
+"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(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    return voidElements.includes(el.localName);
+}
+exports.isVoidElement = isVoidElement;

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

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

package/lib/specs/resolve-version.js

@@ -7,7 +7,7 @@ function resolveVersion(aria, version) {
     const permittedRoles = (_d = (_c = aria[version]) === null || _c === void 0 ? void 0 : _c.permittedRoles) !== null && _d !== void 0 ? _d : aria.permittedRoles;
     const implicitProperties = (_f = (_e = aria[version]) === null || _e === void 0 ? void 0 : _e.implicitProperties) !== null && _f !== void 0 ? _f : aria.implicitProperties;
     const properties = (_h = (_g = aria[version]) === null || _g === void 0 ? void 0 : _g.properties) !== null && _h !== void 0 ? _h : aria.properties;
-    const namingProhibited = version === '1.2' ? (_k = (_j = aria[version]) === null || _j === void 0 ? void 0 : _j.namingProhibited) !== null && _k !== void 0 ? _k : aria.namingProhibited : aria.namingProhibited;
+    const namingProhibited = version === '1.1' ? aria.namingProhibited : (_k = (_j = aria[version]) === null || _j === void 0 ? void 0 : _j.namingProhibited) !== null && _k !== void 0 ? _k : aria.namingProhibited;
     const conditions = (_m = (_l = aria[version]) === null || _l === void 0 ? void 0 : _l.conditions) !== null && _m !== void 0 ? _m : aria.conditions;
     return {
         implicitRole,

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

@@ -2,12 +2,12 @@ import type { ElementSpec, ExtendedSpec, MLMLSpec } from '../types';
 /**
  * Merging HTML-spec schema and extended spec schemas
  *
- * Ex: `@markuplint/html-spec` + `{ specs: ["@markuplint/vue-spec"] }` in cofigure files.
+ * Ex: `@markuplint/html-spec` + `{ specs: { "\\.vue$": "@markuplint/vue-spec" } }` in configure files.
  *
  * @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: readonly ElementSpec[];
 };

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

@@ -5,12 +5,12 @@ const merge_array_1 = require("../utils/merge-array");
 /**
  * Merging HTML-spec schema and extended spec schemas
  *
- * Ex: `@markuplint/html-spec` + `{ specs: ["@markuplint/vue-spec"] }` in cofigure files.
+ * Ex: `@markuplint/html-spec` + `{ specs: { "\\.vue$": "@markuplint/vue-spec" } }` in configure files.
  *
  * @param schemas `MLDocument.schemas`
  */
 function schemaToSpec(schemas) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const [main, ...extendedSpecs] = schemas;
     const result = { ...main };
     for (const extendedSpec of extendedSpecs) {
@@ -18,37 +18,48 @@ function schemaToSpec(schemas) {
             result.cites = [...result.cites, ...extendedSpec.cites];
         }
         if (extendedSpec.def) {
+            const def = { ...result.def };
             if ((_a = extendedSpec.def['#globalAttrs']) === null || _a === void 0 ? void 0 : _a['#extends']) {
-                result.def['#globalAttrs']['#HTMLGlobalAttrs'] = {
-                    ...(((_b = result.def['#globalAttrs']) === null || _b === void 0 ? void 0 : _b['#HTMLGlobalAttrs']) || {}),
-                    ...(((_c = extendedSpec.def['#globalAttrs']) === null || _c === void 0 ? void 0 : _c['#extends']) || {}),
+                const gAttrs = { ...def['#globalAttrs'] };
+                gAttrs['#HTMLGlobalAttrs'] = {
+                    ...((_c = (_b = def['#globalAttrs']) === null || _b === void 0 ? void 0 : _b['#HTMLGlobalAttrs']) !== null && _c !== void 0 ? _c : {}),
+                    ...((_e = (_d = extendedSpec.def['#globalAttrs']) === null || _d === void 0 ? void 0 : _d['#extends']) !== null && _e !== void 0 ? _e : {}),
                 };
+                def['#globalAttrs'] = gAttrs;
             }
             if (extendedSpec.def['#aria']) {
-                result.def['#aria'] = {
+                def['#aria'] = {
                     '1.1': {
-                        roles: (0, merge_array_1.mergeArray)(result.def['#aria']['1.1'].roles, extendedSpec.def['#aria']['1.1'].roles),
-                        props: (0, merge_array_1.mergeArray)(result.def['#aria']['1.1'].props, extendedSpec.def['#aria']['1.1'].props),
-                        graphicsRoles: (0, merge_array_1.mergeArray)(result.def['#aria']['1.1'].graphicsRoles, extendedSpec.def['#aria']['1.1'].graphicsRoles),
+                        roles: (0, merge_array_1.mergeArray)(def['#aria']['1.1'].roles, extendedSpec.def['#aria']['1.1'].roles),
+                        props: (0, merge_array_1.mergeArray)(def['#aria']['1.1'].props, extendedSpec.def['#aria']['1.1'].props),
+                        graphicsRoles: (0, merge_array_1.mergeArray)(def['#aria']['1.1'].graphicsRoles, extendedSpec.def['#aria']['1.1'].graphicsRoles),
                     },
                     '1.2': {
-                        roles: (0, merge_array_1.mergeArray)(result.def['#aria']['1.2'].roles, extendedSpec.def['#aria']['1.2'].roles),
-                        props: (0, merge_array_1.mergeArray)(result.def['#aria']['1.2'].props, extendedSpec.def['#aria']['1.2'].props),
-                        graphicsRoles: (0, merge_array_1.mergeArray)(result.def['#aria']['1.2'].graphicsRoles, extendedSpec.def['#aria']['1.2'].graphicsRoles),
+                        roles: (0, merge_array_1.mergeArray)(def['#aria']['1.2'].roles, extendedSpec.def['#aria']['1.2'].roles),
+                        props: (0, merge_array_1.mergeArray)(def['#aria']['1.2'].props, extendedSpec.def['#aria']['1.2'].props),
+                        graphicsRoles: (0, merge_array_1.mergeArray)(def['#aria']['1.2'].graphicsRoles, extendedSpec.def['#aria']['1.2'].graphicsRoles),
+                    },
+                    '1.3': {
+                        roles: (0, merge_array_1.mergeArray)(def['#aria']['1.3'].roles, extendedSpec.def['#aria']['1.3'].roles),
+                        props: (0, merge_array_1.mergeArray)(def['#aria']['1.3'].props, extendedSpec.def['#aria']['1.3'].props),
+                        graphicsRoles: (0, merge_array_1.mergeArray)(def['#aria']['1.3'].graphicsRoles, extendedSpec.def['#aria']['1.3'].graphicsRoles),
                     },
                 };
             }
             if (extendedSpec.def['#contentModels']) {
+                const models = { ...def['#contentModels'] };
                 const keys = new Set([
-                    ...Object.keys(result.def['#contentModels']),
+                    ...Object.keys(def['#contentModels']),
                     ...Object.keys(extendedSpec.def['#contentModels']),
                 ]);
                 for (const modelName of keys) {
-                    const mainModel = result.def['#contentModels'][modelName];
+                    const mainModel = def['#contentModels'][modelName];
                     const exModel = extendedSpec.def['#contentModels'][modelName];
-                    result.def['#contentModels'][modelName] = [...(mainModel || []), ...(exModel || [])];
+                    models[modelName] = [...(mainModel !== null && mainModel !== void 0 ? mainModel : []), ...(exModel !== null && exModel !== void 0 ? exModel : [])];
                 }
+                def['#contentModels'] = models;
             }
+            result.def = def;
         }
         if (extendedSpec.specs) {
             const exSpecs = extendedSpec.specs.slice();
@@ -66,10 +77,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

@@ -6,125 +6,166 @@
 /**
  * If `false`, this mean is "No corresponding role".
  */
-export declare type ImplicitRole = false | string;
+export type ImplicitRole = false | string;
 /**
  * If `true`, this mean is "Any". If `false`, this mean is "No".
  */
-export declare 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;
+			  }
+	  )[]
+	| PermittedARIAAAMInfo;
 /**
  * If set false:
  * > No role or aria-* attributes
  */
-export declare 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[]];
-    only?: [
-        (string | {
-            name: string;
-            value?: string;
-        }),
-        ...(string | {
-            name: string;
-            value?: string;
-        })[]
-    ];
-    whithout?: [
-        {
-            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.3'?: {
+		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 PermittedARIAAAMInfo {
+	'core-aam'?: true;
+	'graphics-aam'?: true;
 }
 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;
 }