@markuplint/ml-spec 2.0.1 → 3.0.0-alpha.0

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

@@ -0,0 +1,5 @@
+import type { MLMLSpec } from '../types';
+export declare function ariaSpec(specs: Readonly<MLMLSpec>): {
+	roles: import('../types').ARIRRoleAttribute[];
+	ariaAttrs: import('../types').ARIAAttribute[];
+};

package/lib/specs/aria-spec.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ariaSpec = void 0;
+function ariaSpec(specs) {
+    const roles = specs.def['#roles'];
+    const ariaAttrs = specs.def['#ariaAttrs'];
+    return {
+        roles,
+        ariaAttrs,
+    };
+}
+exports.ariaSpec = ariaSpec;

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

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

package/lib/specs/aria-specs.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ariaSpecs = void 0;
+function ariaSpecs(specs, version) {
+    const aria = specs.def['#aria'];
+    return aria[version];
+}
+exports.ariaSpecs = ariaSpecs;

package/lib/specs/content-model-category-to-tag-names.d.ts

@@ -0,0 +1,3 @@
+import type { MLMLSpec } from '../types';
+import type { Category } from '../types/permitted-structres';
+export declare function contentModelCategoryToTagNames(contentModel: Category, specs: MLMLSpec): ReadonlyArray<string>;

package/lib/specs/content-model-category-to-tag-names.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contentModelCategoryToTagNames = void 0;
+const cache = new Map();
+function contentModelCategoryToTagNames(contentModel, specs) {
+    const cached = cache.get(contentModel);
+    if (cached) {
+        return cached;
+    }
+    const tags = specs.def['#contentModels'][contentModel];
+    const sortedTag = Object.freeze(tags && Array.isArray(tags) ? tags.sort() : []);
+    cache.set(contentModel, sortedTag);
+    return sortedTag;
+}
+exports.contentModelCategoryToTagNames = contentModelCategoryToTagNames;

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

@@ -0,0 +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;

package/lib/specs/get-aria.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getARIA = void 0;
+const get_spec_by_tag_name_1 = require("./get-spec-by-tag-name");
+const resolve_version_1 = require("./resolve-version");
+const cache = new Map();
+function getARIA(specs, localName, namespace, version, matches) {
+    var _a, _b, _c, _d, _e;
+    const aria = getVersionResolvedARIA(specs, localName, namespace, version);
+    if (!aria) {
+        return null;
+    }
+    const conditions = aria.conditions;
+    if (!conditions) {
+        return aria;
+    }
+    const conds = Object.keys(conditions);
+    let { implicitRole, permittedRoles, implicitProperties, properties, namingProhibited } = aria;
+    for (const cond of conds) {
+        if (!matches(cond)) {
+            continue;
+        }
+        const condARIA = conditions[cond];
+        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;
+        properties = (_d = condARIA.properties) !== null && _d !== void 0 ? _d : properties;
+        namingProhibited = (_e = condARIA.namingProhibited) !== null && _e !== void 0 ? _e : namingProhibited;
+    }
+    return {
+        implicitRole,
+        permittedRoles,
+        implicitProperties,
+        properties,
+        namingProhibited,
+    };
+}
+exports.getARIA = getARIA;
+function getVersionResolvedARIA(specs, localName, namespace, version) {
+    var _a;
+    const key = localName + namespace + version;
+    let aria = cache.get(key);
+    if (aria !== undefined) {
+        return aria;
+    }
+    const spec = (_a = (0, get_spec_by_tag_name_1.getSpecByTagName)(specs, localName, namespace)) === null || _a === void 0 ? void 0 : _a.aria;
+    if (!spec) {
+        cache.set(key, null);
+        return null;
+    }
+    aria = (0, resolve_version_1.resolveVersion)(spec, version);
+    if (aria.permittedRoles) {
+        aria.permittedRoles = optimizePermittedRoles(aria.permittedRoles);
+    }
+    cache.set(key, aria);
+    return aria;
+}
+function optimizePermittedRoles(permittedRoles) {
+    if (!Array.isArray(permittedRoles)) {
+        return permittedRoles;
+    }
+    const unique = new Set(permittedRoles);
+    // https://www.w3.org/TR/wai-aria-1.2/#note-regarding-the-aria-1-1-none-role
+    if (unique.has('presentation')) {
+        unique.add('none');
+    }
+    if (unique.has('none')) {
+        unique.add('presentation');
+    }
+    return Array.from(unique).sort();
+}

package/lib/specs/get-attr-specs.d.ts

@@ -0,0 +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;
+declare type HasName = {
+    name: string;
+};
+export declare function nameCompare(a: HasName | string, b: HasName | string): 0 | 1 | -1;
+export {};

package/lib/{get-attr-specs.js → specs/get-attr-specs.js}

@@ -1,20 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nameCompare = exports.getAttrSpecs = void 0;
+const resolve_namespace_1 = require("../utils/resolve-namespace");
 const cacheMap = new Map();
 const schemaCache = new WeakSet();
-function getAttrSpecs(nameWithNS, schema) {
+function getAttrSpecs(localName, namespace, schema) {
     if (!schemaCache.has(schema)) {
         cacheMap.clear();
     }
-    const cache = cacheMap.get(nameWithNS);
+    const { localNameWithNS } = (0, resolve_namespace_1.resolveNamespace)(localName, namespace || undefined);
+    const cache = cacheMap.get(localNameWithNS);
     if (cache !== undefined) {
         return cache;
     }
     schemaCache.add(schema);
-    const elSpec = schema.specs.find(spec => spec.name === nameWithNS);
+    const elSpec = schema.specs.find(spec => spec.name === localNameWithNS);
     if (!elSpec) {
-        cacheMap.set(nameWithNS, null);
+        cacheMap.set(localNameWithNS, null);
         return null;
     }
     const globalAttrs = schema.def['#globalAttrs'];
@@ -66,7 +68,7 @@ function getAttrSpecs(nameWithNS, schema) {
     });
     for (const attr of attrList) {
         if (!attr.type) {
-            throw new Error(`The type is empty in the ${attr.name} attribute of the ${nameWithNS} element,
+            throw new Error(`The type is empty in the ${attr.name} attribute of the ${localName} element,
 					'packages',
 					'@markuplint',
 					'html-spec',
@@ -77,7 +79,7 @@ function getAttrSpecs(nameWithNS, schema) {
         }
     }
     attrList.sort(nameCompare);
-    cacheMap.set(nameWithNS, attrList);
+    cacheMap.set(localNameWithNS, attrList);
     return attrList;
 }
 exports.getAttrSpecs = getAttrSpecs;

package/lib/specs/get-implicit-role.d.ts

@@ -0,0 +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;

package/lib/specs/get-implicit-role.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getImplicitRole = void 0;
+const get_aria_1 = require("./get-aria");
+function getImplicitRole(specs, localName, namespace, version, matches) {
+    const aria = (0, get_aria_1.getARIA)(specs, localName, namespace, version, matches);
+    if (!aria) {
+        return false;
+    }
+    return aria.implicitRole;
+}
+exports.getImplicitRole = getImplicitRole;

package/lib/specs/get-permitted-roles.d.ts

@@ -0,0 +1,12 @@
+import type { ARIAVersion, Matches, MLMLSpec } from '../types';
+/**
+ * Getting permitted ARIA roles.
+ *
+ * - If an array, it is role list.
+ * - 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;
+}[];

package/lib/specs/get-permitted-roles.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPermittedRoles = void 0;
+const merge_array_1 = require("../utils/merge-array");
+const aria_specs_1 = require("./aria-specs");
+const get_aria_1 = require("./get-aria");
+/**
+ * Getting permitted ARIA roles.
+ *
+ * - If an array, it is role list.
+ * - If `true`, this mean is "Any".
+ * - If `false`, this mean is "No".
+ */
+function getPermittedRoles(specs, localName, namespace, version, matches) {
+    const aria = (0, get_aria_1.getARIA)(specs, localName, namespace, version, matches);
+    if (!aria) {
+        return [];
+    }
+    const { implicitRole, permittedRoles } = aria;
+    const { roles, graphicsRoles } = (0, aria_specs_1.ariaSpecs)(specs, version);
+    let permittedRoleList = [];
+    if (permittedRoles === true) {
+        permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, roles
+            .filter(role => !role.isAbstract)
+            .map(role => ({
+            name: role.name,
+        })));
+    }
+    if (Array.isArray(permittedRoles)) {
+        permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, permittedRoles.map(role => {
+            if (typeof role === 'string') {
+                return {
+                    name: role,
+                };
+            }
+            return role;
+        }));
+    }
+    else if (!(typeof permittedRoles === 'boolean')) {
+        if (permittedRoles['core-aam']) {
+            permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, roles
+                .filter(role => !role.isAbstract)
+                .map(role => ({
+                name: role.name,
+            })));
+        }
+        if (permittedRoles['graphics-aam']) {
+            permittedRoleList = (0, merge_array_1.mergeArray)(permittedRoleList, graphicsRoles
+                .filter(role => !role.isAbstract)
+                .map(role => ({
+                name: role.name,
+            })));
+        }
+    }
+    if (implicitRole) {
+        const implicitRoles = implicitRole === 'presentation' || implicitRole === 'none' ? ['none', 'presentation'] : [implicitRole];
+        return (0, merge_array_1.mergeArray)(implicitRoles.map(r => ({ name: r })), permittedRoleList);
+    }
+    return permittedRoleList;
+}
+exports.getPermittedRoles = getPermittedRoles;

package/lib/specs/get-role-spec.d.ts

@@ -0,0 +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;

package/lib/specs/get-role-spec.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoleSpec = void 0;
+const aria_specs_1 = require("./aria-specs");
+function getRoleSpec(specs, roleName, namespace, version) {
+    var _a, _b, _c, _d;
+    const role = getRoleByName(specs, roleName, namespace, version);
+    if (!role) {
+        return null;
+    }
+    const superClassRoles = recursiveTraverseSuperClassRoles(specs, roleName, namespace, version);
+    return {
+        name: role.name,
+        isAbstract: !!role.isAbstract,
+        requiredContextRole: (_a = role.requiredContextRole) !== null && _a !== void 0 ? _a : [],
+        requiredOwnedElements: (_b = role.requiredOwnedElements) !== null && _b !== void 0 ? _b : [],
+        accessibleNameRequired: !!role.accessibleNameRequired,
+        accessibleNameFromAuthor: !!role.accessibleNameFromAuthor,
+        accessibleNameFromContent: !!role.accessibleNameFromContent,
+        accessibleNameProhibited: !!role.accessibleNameProhibited,
+        childrenPresentational: !!role.childrenPresentational,
+        ownedProperties: (_c = role.ownedProperties) !== null && _c !== void 0 ? _c : [],
+        prohibitedProperties: (_d = role.prohibitedProperties) !== null && _d !== void 0 ? _d : [],
+        superClassRoles,
+    };
+}
+exports.getRoleSpec = getRoleSpec;
+function recursiveTraverseSuperClassRoles(specs, roleName, namespace, version) {
+    const roles = [];
+    const superClassRoles = getSuperClassRoles(specs, roleName, namespace, version);
+    if (superClassRoles) {
+        roles.push(...superClassRoles);
+        for (const superClassRole of superClassRoles) {
+            const ancestorRoles = recursiveTraverseSuperClassRoles(specs, superClassRole.name, namespace, version);
+            roles.push(...ancestorRoles);
+        }
+    }
+    return roles;
+}
+function getSuperClassRoles(specs, roleName, namespace, version) {
+    var _a;
+    const role = getRoleByName(specs, roleName, namespace, version);
+    return (((_a = role === null || role === void 0 ? void 0 : role.generalization) === null || _a === void 0 ? void 0 : _a.map(roleName => getRoleByName(specs, roleName, namespace, version)).filter((role) => !!role)) || null);
+}
+function getRoleByName(specs, roleName, namespace, version) {
+    const { roles, graphicsRoles } = (0, aria_specs_1.ariaSpecs)(specs, version);
+    let role = roles.find(r => r.name === roleName);
+    if (!role && namespace === 'http://www.w3.org/2000/svg') {
+        role = graphicsRoles.find(r => r.name === roleName);
+    }
+    return role;
+}

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

@@ -0,0 +1,3 @@
+import type { MLMLSpec } from '../types';
+import type { Category } from '../types/permitted-structres';
+export declare function getSelectorsByContentModelCategory(specs: Readonly<MLMLSpec>, category: Category): ReadonlyArray<string>;

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSelectorsByContentModelCategory = void 0;
+function getSelectorsByContentModelCategory(specs, category) {
+    const selectors = specs.def['#contentModels'][category];
+    return selectors || [];
+}
+exports.getSelectorsByContentModelCategory = getSelectorsByContentModelCategory;

package/lib/specs/get-spec-by-tag-name.d.ts

@@ -0,0 +1,2 @@
+import type { ElementSpec, MLMLSpec } from '../types';
+export declare function getSpecByTagName(specs: Readonly<MLMLSpec>, localName: string, namespace: string | null): ElementSpec | null;

package/lib/specs/get-spec-by-tag-name.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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);
+    let spec = cache.get(localNameWithNS);
+    if (spec !== undefined) {
+        return spec;
+    }
+    spec = specs.specs.find(spec => spec.name === localNameWithNS) || null;
+    cache.set(localNameWithNS, spec);
+    return spec;
+}
+exports.getSpecByTagName = getSpecByTagName;

package/lib/{get-spec.d.ts → specs/get-spec.d.ts}

@@ -1,4 +1,4 @@
-import type { ElementSpec, ExtendedSpec, MLMLSpec } from './types';
+import type { ElementSpec, ExtendedSpec, MLMLSpec } from '../types';
 /**
  * Merging HTML-spec schema and extended spec schemas
  *
@@ -7,7 +7,7 @@ import type { ElementSpec, ExtendedSpec, MLMLSpec } from './types';
  * @param schemas `MLDocument.schemas`
  */
 export declare function getSpec(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/{get-spec.js → specs/get-spec.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSpec = void 0;
-const utils_1 = require("./utils");
+const utils_1 = require("../utils");
 /**
  * Merging HTML-spec schema and extended spec schemas
  *

package/lib/specs/html-spec.d.ts

@@ -0,0 +1,6 @@
+import type { ElementSpec, MLMLSpec } from '../types';
+export declare function htmlSpec(
+	specs: Readonly<MLMLSpec>,
+	localName: string,
+	namespace: string | null,
+): ElementSpec | null;

package/lib/specs/html-spec.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.htmlSpec = void 0;
+const resolve_namespace_1 = require("../utils/resolve-namespace");
+const cache = new Map();
+function htmlSpec(specs, localName, namespace) {
+    const { localNameWithNS } = (0, resolve_namespace_1.resolveNamespace)(localName, namespace || undefined);
+    let spec = cache.get(localNameWithNS);
+    if (spec !== undefined) {
+        return spec;
+    }
+    spec = specs.specs.find(spec => spec.name === localNameWithNS) || null;
+    cache.set(localNameWithNS, spec);
+    return spec;
+}
+exports.htmlSpec = htmlSpec;

package/lib/specs/is-presentational.d.ts

@@ -0,0 +1 @@
+export declare function isPresentational(roleName?: string): boolean;

package/lib/specs/is-presentational.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPresentational = void 0;
+function isPresentational(roleName) {
+    if (!roleName) {
+        return false;
+    }
+    return ['presentation', 'none'].includes(roleName);
+}
+exports.isPresentational = isPresentational;

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

@@ -0,0 +1,9 @@
+import type { NamespaceURI } from '@markuplint/ml-ast';
+declare type NamespacedElementName = {
+	localNameWithNS: string;
+	localName: string;
+	namespace: 'html' | 'svg' | 'mml';
+	namespaceURI: NamespaceURI;
+};
+export declare function resolveNamespace(localName: string, namespaceURI?: string): NamespacedElementName;
+export {};

package/lib/specs/resolve-namespace.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNamespace = void 0;
+const utils_1 = require("../utils");
+const cache = new Map();
+function resolveNamespace(localName, namespaceURI = 'http://www.w3.org/1999/xhtml') {
+    const cached = cache.get(localName + namespaceURI);
+    if (cached) {
+        return cached;
+    }
+    const name = localName.split(':')[1] || localName;
+    const ns = (0, utils_1.getNS)(namespaceURI || null);
+    const result = {
+        localNameWithNS: `${ns === 'html' ? '' : `${ns}:`}${name}`,
+        localName: name,
+        namespace: ns,
+        namespaceURI: [
+            'http://www.w3.org/1999/xhtml',
+            'http://www.w3.org/2000/svg',
+            'http://www.w3.org/1998/Math/MathML',
+        ].find(ns => namespaceURI) || 'http://www.w3.org/1999/xhtml',
+    };
+    cache.set(localName + namespaceURI, result);
+    return result;
+}
+exports.resolveNamespace = resolveNamespace;

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

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

package/lib/specs/resolve-version.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVersion = void 0;
+function resolveVersion(aria, version) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const implicitRole = (_b = (_a = aria[version]) === null || _a === void 0 ? void 0 : _a.implicitRole) !== null && _b !== void 0 ? _b : aria.implicitRole;
+    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 conditions = (_m = (_l = aria[version]) === null || _l === void 0 ? void 0 : _l.conditions) !== null && _m !== void 0 ? _m : aria.conditions;
+    return {
+        implicitRole,
+        permittedRoles,
+        implicitProperties,
+        properties,
+        namingProhibited,
+        conditions,
+    };
+}
+exports.resolveVersion = resolveVersion;

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

@@ -0,0 +1,13 @@
+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.
+ *
+ * @param schemas `MLDocument.schemas`
+ */
+export declare function schemaToSpec(schemas: readonly [MLMLSpec, ...ExtendedSpec[]]): {
+    cites: import("../types").Cites;
+    def: import("../types").SpecDefs;
+    specs: ElementSpec[];
+};

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaToSpec = void 0;
+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.
+ *
+ * @param schemas `MLDocument.schemas`
+ */
+function schemaToSpec(schemas) {
+    var _a, _b, _c;
+    const [main, ...extendedSpecs] = schemas;
+    const result = { ...main };
+    for (const extendedSpec of extendedSpecs) {
+        if (extendedSpec.cites) {
+            result.cites = [...result.cites, ...extendedSpec.cites];
+        }
+        if (extendedSpec.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']) || {}),
+                };
+            }
+            if (extendedSpec.def['#aria']) {
+                result.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),
+                    },
+                    '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),
+                    },
+                };
+            }
+            if (extendedSpec.def['#contentModels']) {
+                const keys = new Set([
+                    ...Object.keys(result.def['#contentModels']),
+                    ...Object.keys(extendedSpec.def['#contentModels']),
+                ]);
+                for (const modelName of keys) {
+                    const mainModel = result.def['#contentModels'][modelName];
+                    const exModel = extendedSpec.def['#contentModels'][modelName];
+                    result.def['#contentModels'][modelName] = [...(mainModel || []), ...(exModel || [])];
+                }
+            }
+        }
+        if (extendedSpec.specs) {
+            const exSpecs = extendedSpec.specs.slice();
+            const specs = [];
+            for (const elSpec of result.specs) {
+                const tagName = elSpec.name.toLowerCase();
+                const index = exSpecs.findIndex(spec => spec.name.toLowerCase() === tagName);
+                if (index === -1) {
+                    specs.push(elSpec);
+                    continue;
+                }
+                const exSpec = exSpecs.splice(index, 1)[0];
+                specs.push({
+                    ...elSpec,
+                    ...exSpec,
+                    globalAttrs: {
+                        ...elSpec.globalAttrs,
+                        ...exSpec.globalAttrs,
+                    },
+                    attributes: mergeAttrSpec(elSpec.attributes, exSpec.attributes),
+                    categories: (0, merge_array_1.mergeArray)(elSpec.categories, exSpec.categories),
+                });
+            }
+            result.specs = specs;
+        }
+    }
+    return result;
+}
+exports.schemaToSpec = schemaToSpec;
+function mergeAttrSpec(std, ex = {}) {
+    const result = {};
+    const keys = Array.from(new Set([...Object.keys(std), ...Object.keys(ex)]));
+    for (const key of keys) {
+        const _std = std[key];
+        const _ex = ex[key];
+        result[key] = {
+            ..._std,
+            ..._ex,
+        };
+    }
+    return result;
+}