@markuplint/ml-core 5.2.0 → 5.4.0

package/lib/ml-dom/node/element.js

@@ -3,8 +3,8 @@ var _a;
 import { getSpecByTagName, resolveNamespace } from '@markuplint/ml-spec';
 import { pretenderNamespaceToURI } from '@markuplint/ml-config';
 import { getChildNamespace } from '@markuplint/parser-utils';
-import { matchSelector } from '@markuplint/selector';
-import { getAccname } from '../helper/accname.js';
+import { matchSelector, typeNameMatches } from '@markuplint/selector';
+import { getAccname, getAccnameVisits, getHostLanguageLabelSource, getReferencedTextAlternative, } from '../helper/accname.js';
 import { after, before, nextElementSibling, previousElementSibling, remove, replaceWith, } from '../manipulations/child-node-methods.js';
 import { MLAttr } from './attr.js';
 import { MLDomTokenList } from './dom-token-list.js';
@@ -12,7 +12,7 @@ import { MLElementCloseTag } from './element-close-tag.js';
 import { toNamedNodeMap } from './named-node-map.js';
 import { toHTMLCollection, toNodeList } from './node-list.js';
 import { MLParentNode } from './parent-node.js';
-import { UnexpectedCallError } from '@markuplint/shared';
+import { UnexpectedCallError, asciiLowerCase, vuePropKey } from '@markuplint/shared';
 const HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml';
 /**
  * Represents a DOM Element node wrapper in the markuplint DOM tree.
@@ -49,6 +49,140 @@ export class MLElement extends MLParentNode {
     get isForeignElement() {
         return this.#namespaceURI !== HTML_NAMESPACE;
     }
+    /**
+     * Whether two names would be one attribute on this element, for names that no attribute of the
+     * element stands behind (the names of a spec, of an option or of a rule value, where the
+     * attribute may be missing). It is {@link MLAttr.isNamedBy} without an attribute.
+     *
+     * The HTML syntax folds the ASCII case. A name that code sets through the DOM API is folded
+     * only on an element of the HTML namespace: on an SVG or MathML element it keeps its spelling,
+     * and a name with a capital letter is a prop of the framework. The props of a component are
+     * not folded, except that Vue camelizes them.
+     *
+     * With no attribute, whether the name is set through the DOM API is up to the parser alone: the
+     * attribute is not dynamic, so Svelte's name is read as the HTML parser reads it.
+     *
+     * @see https://dom.spec.whatwg.org/#dom-element-setattribute
+     * @see https://html.spec.whatwg.org/multipage/parsing.html#attribute-name-state
+     *
+     * @param a - A name
+     * @param b - The other name
+     * @returns `true` if both names are one attribute on this element
+     */
+    isSameAttrName(a, b) {
+        if (a === b) {
+            return true;
+        }
+        if (this.elementType === 'authored') {
+            return this.ownerMLDocument.componentNameVariants && vuePropKey(a) === vuePropKey(b);
+        }
+        if (this.ownerMLDocument.attrNameRoute === 'dom-api' && (this.isForeignElement || /[A-Z]/.test(a + b))) {
+            return false;
+        }
+        return asciiLowerCase(a) === asciiLowerCase(b);
+    }
+    /**
+     * Whether the `#custom` entry of a content model category (`:model(flow)` etc.) covers this element.
+     *
+     * Anything that is not a native HTML element counts, an authored component (`<Foo />`)
+     * as well as an autonomous custom element (`<x-foo>`). Keep it in step with `isTreatedAsCustom`
+     * of `permitted-contents` (`'pretended'` mode), which applies the same criterion to `#custom`;
+     * they are separate on purpose, as `isTreatedAsCustom` also serves the `'origin'` mode.
+     *
+     * Like {@link localName}, it follows the pretender, since a selector sees the element
+     * the component renders. A pretender target is created with `elementType: 'html'`, so it
+     * is a custom element when its own name has a hyphen. A target whose name is a component
+     * (`Tabs.Root`; the rule is the parser's, see {@link MLDocument.isComponentName}) is created as
+     * `'authored'` and counts like one written directly: the scanners of `pretenders.auto` end a chain at such a name when
+     * they cannot resolve it, and what that component renders is not known.
+     *
+     * Known limitation: the hyphen test is only the hyphen. A pretender target named after a reserved
+     * hyphenated name (`annotation-xml`, `font-face`, ...) counts as custom here, whereas the same
+     * element written directly does not. `isTreatedAsCustom` shares the limitation.
+     */
+    get isCustomElement() {
+        if (this.pretenderContext?.type === 'pretender') {
+            const { as } = this.pretenderContext;
+            return as.elementType === 'authored' || as.localName.includes('-');
+        }
+        return this.elementType !== 'html';
+    }
+    /**
+     * Whether the document tells the case of a tag name apart (see {@link MLDocument.tagNameCaseSensitive}).
+     * A type selector reads it, as {@link localName} alone cannot tell it: an element that HTML names
+     * case-insensitively (`<foobar>`) has a lowercase-folded pair of `localName` / `nodeName` in
+     * every document, but in JSX it is not `<FooBar>`.
+     *
+     * @implements `SelectorElement#tagNameCaseSensitive` of `@markuplint/selector`
+     */
+    get tagNameCaseSensitive() {
+        return this.ownerMLDocument.tagNameCaseSensitive;
+    }
+    /**
+     * What this element is for a type selector, in a document that resolves a component by any
+     * spelling of its name (Vue, see {@link MLDocument.componentNameVariants}); `undefined` in any other.
+     *
+     * - `component`: not an HTML element (`<FooBar>`, `<foo-bar>`), which {@link localName} names as written
+     * - `native`: an HTML element that the document takes for native (`<button>`, see {@link MLDocument.isNativeTag}:
+     *   the parser's rule, as Vue's `isNativeTag`, else the specification), the guard of {@link pretending}.
+     *   The element that a pretender stands for is judged by the specification alone
+     * - `unknown-html`: an HTML element that it does not (`<foobar>`; in Vue also `<marquee>`, which has a
+     *   specification but resolves to a component when one is imported)
+     *
+     * Like {@link localName}, it follows the pretender, since a selector sees the element the component
+     * renders. An element of the SVG or MathML namespace has none: it keeps the case of its name.
+     *
+     * @implements `SelectorElement#tagNameKind` of `@markuplint/selector`
+     */
+    get tagNameKind() {
+        const document = this.ownerMLDocument;
+        if (!document.componentNameVariants) {
+            return;
+        }
+        const target = this.pretenderContext?.type === 'pretender' ? this.pretenderContext.as : this;
+        if (target.isForeignElement) {
+            return;
+        }
+        if (target.elementType !== 'html') {
+            return 'component';
+        }
+        // A tag as written is the language's to resolve; the name a pretender gives (`as`) is the element itself
+        const isNative = target === this
+            ? document.isNativeTag(target.localName, target.namespaceURI)
+            : getSpecByTagName(document.specs.specs, target.localName, target.namespaceURI) != null;
+        return isNative ? 'native' : 'unknown-html';
+    }
+    /**
+     * Whether a name that a user writes for an element (the `tag` of a rule option, as against the
+     * type name of a selector, which {@link matches} takes) stands for this element, written as it is,
+     * in a document that resolves a component by any spelling of its name (Vue, see
+     * {@link MLDocument.componentNameVariants}): `FooBar` stands for `<foo-bar>` and `<fooBar>`.
+     *
+     * It is `false` in any other document, so that a caller that compares a name as it is can ask
+     * it as well without changing what it does there. It ignores the pretender: the name is the one
+     * the element is written with. To ask so, it hides the pretender of this element for the length of the
+     * call (as {@link matchMLSelector} does for its second try), so nothing in it may be async.
+     *
+     * @param name - The name as the user wrote it
+     * @returns Whether the name stands for this element
+     */
+    matchesTagNameVariant(name) {
+        if (!this.ownerMLDocument.componentNameVariants) {
+            return false;
+        }
+        const pretenderContext = this.pretenderContext;
+        if (pretenderContext?.type !== 'pretender') {
+            return this.tagNameKind !== undefined && typeNameMatches(name, this);
+        }
+        // The element as written, not as the pretender makes it: as `matchMLSelector` does for its second try
+        this.pretenderContext = null;
+        try {
+            return this.tagNameKind !== undefined && typeNameMatches(name, this);
+        }
+        finally {
+            this.pretenderContext = pretenderContext;
+        }
+    }
     /**
      * Whether this element was implicitly created (e.g., an omitted `<body>` tag in HTML).
      */
@@ -93,6 +227,21 @@ export class MLElement extends MLParentNode {
      * @see {@link getAccessibleName} — the public method that reads/writes this cache
      */
     #accessibleNameCache = new Map();
+    /**
+     * Memoizes {@link getAccessibleNameVisits}, keyed by `${version}:${asReferenced}`.
+     * Safe for the same reason as {@link #accessibleNameCache}.
+     */
+    #accessibleNameVisitsCache = new Map();
+    /**
+     * Memoizes {@link getHostLanguageLabelSource}. Safe for the same reason as
+     * {@link #accessibleNameCache}.
+     */
+    #hostLanguageLabelSourceCache = new Map();
+    /**
+     * Memoizes {@link getReferencedTextAlternative}. Safe for the same reason as
+     * {@link #accessibleNameCache}.
+     */
+    #referencedTextAlternativeCache = new Map();
     #normalizedAttrs = new Map();
     #normalizedString = null;
     ontouchcancel;
@@ -700,28 +849,21 @@ export class MLElement extends MLParentNode {
         throw new UnexpectedCallError('Not supported "attributeStyleMap" property');
     }
     /**
+     * Every attribute written on the tag, the second of two spellings of one name too: unlike a DOM
+     * element, which keeps one of them, a rule checks each attribute that the author wrote, and
+     * `no-duplicate-attr` reports the second. Which of them the DOM keeps is what {@link getAttribute}
+     * returns.
+     *
      * @implements DOM API: `Element`
      * @see https://dom.spec.whatwg.org/#dom-element-attributes
      */
     get attributes() {
         const origin = this.pretenderContext?.type === 'pretender' ? this.pretenderContext.as.#attributes : this.#attributes;
-        if (this.#normalizedAttrs.has(origin)) {
-            return this.#normalizedAttrs.get(origin);
-        }
-        const names = new Set();
-        const attrs = [];
-        for (const attr of origin) {
-            if (names.has(attr.name)) {
-                /**
-                 * Skips a duplicated attribute
-                 *
-                 *@see https://html.spec.whatwg.org/#parse-error-duplicate-attribute
-                 */
-                continue;
-            }
-            attrs.push(attr);
+        const cached = this.#normalizedAttrs.get(origin);
+        if (cached) {
+            return cached;
         }
-        const map = toNamedNodeMap(attrs);
+        const map = toNamedNodeMap(origin);
         this.#normalizedAttrs.set(origin, map);
         return map;
     }
@@ -2462,6 +2604,68 @@ export class MLElement extends MLParentNode {
         this.#accessibleNameCache.set(version, name);
         return name;
     }
+    /**
+     * Returns the elements that the computation of this element's text
+     * alternative reaches, with how it reaches each, memoized per ARIA version
+     * and mode like {@link getAccessibleName}.
+     *
+     * A descendant missing from the map takes no part in the text alternative:
+     * the computation ends before it (a hidden element, a name given before
+     * content, a component that does not render its children). When the
+     * computation fails, the map is empty.
+     *
+     * @implements `@markuplint/ml-core` API: `MLElement`
+     * @param version - The ARIA specification version to use for computation
+     * @param asReferenced - Computes it as a node referenced by `aria-labelledby`
+     *   or `aria-describedby` instead of as this element's accessible name
+     * @returns The reached elements and their visits
+     */
+    getAccessibleNameVisits(version, asReferenced = false) {
+        const key = `${version}:${asReferenced}`;
+        const cached = this.#accessibleNameVisitsCache.get(key);
+        if (cached != null) {
+            return cached;
+        }
+        const visits = getAccnameVisits(this, version, asReferenced);
+        this.#accessibleNameVisitsCache.set(key, visits);
+        return visits;
+    }
+    /**
+     * Returns the text alternative of this element as a node referenced by
+     * `aria-labelledby` or `aria-describedby` (AccName Step 2B, LabelledBy
+     * Traversal), memoized per ARIA version like {@link getAccessibleName}.
+     *
+     * @implements `@markuplint/ml-core` API: `MLElement`
+     * @param version - The ARIA specification version to use for computation
+     * @returns The text alternative (may be empty)
+     */
+    getReferencedTextAlternative(version) {
+        const cached = this.#referencedTextAlternativeCache.get(version);
+        if (cached != null) {
+            return cached;
+        }
+        const text = getReferencedTextAlternative(this, version);
+        this.#referencedTextAlternativeCache.set(version, text);
+        return text;
+    }
+    /**
+     * Returns the source of this element's host language text alternative
+     * (AccName Step 2E), such as `'alt'` or `'svg-title'`, whether or not an
+     * explicit `none` or `presentation` role keeps it out of the name.
+     * Memoized per ARIA version like {@link getAccessibleName}.
+     *
+     * @implements `@markuplint/ml-core` API: `MLElement`
+     * @param version - The ARIA specification version to use for computation
+     * @returns The source, or `null` if the element has no host language text alternative
+     */
+    getHostLanguageLabelSource(version) {
+        if (this.#hostLanguageLabelSourceCache.has(version)) {
+            return this.#hostLanguageLabelSourceCache.get(version) ?? null;
+        }
+        const source = getHostLanguageLabelSource(this, version);
+        this.#hostLanguageLabelSourceCache.set(version, source);
+        return source;
+    }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -2475,16 +2679,31 @@ export class MLElement extends MLParentNode {
         throw new UnexpectedCallError('Not supported "getAnimations" method');
     }
     /**
+     * Whether `attrName` is the name of an attribute of this element is what {@link MLAttr.isNamedBy}
+     * says: `ROLE` is `role` on a `<div>` and, in JSX, is not on an `<svg>`. `hasAttribute`,
+     * `getAttributeToken`, `getAttributePretended`, a pretender's `fromAttr` and `getNamedItem` ask the same.
+     *
      * @implements DOM API: `Element`
      * @see https://dom.spec.whatwg.org/#ref-for-dom-element-getattribute%E2%91%A0
      */
     getAttribute(attrName) {
+        let first = null;
+        let lastSetByCode = null;
         for (const attr of this.attributes) {
-            if (attr.name.toLowerCase() === attrName.toLowerCase()) {
-                return attr.value;
+            if (!attr.isNamedBy(attrName)) {
+                continue;
+            }
+            first ??= attr;
+            // A directive, and an attribute that may be written twice (`class` and `:class`), are not
+            // two spellings of one name: the first is the one that is asked for
+            if (attr.isSetThroughDOMAPI && !attr.isDirective && !attr.isDuplicatable) {
+                lastSetByCode = attr;
             }
         }
-        return null;
+        // Of two attributes of one name, the HTML parser keeps the first and drops the second, while code
+        // that sets them one after another (`setAttribute`) lets the second overwrite the first.
+        // @see https://html.spec.whatwg.org/#parse-error-duplicate-attribute
+        return (lastSetByCode ?? first)?.value ?? null;
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -2529,12 +2748,12 @@ export class MLElement extends MLParentNode {
      * the original component element, not on the virtual pretender element.
      *
      * @implements `@markuplint/ml-core` API: `MLElement`
-     * @param attrName - The attribute name to look up (case-insensitive)
+     * @param attrName - The attribute name to look up (see {@link MLAttr.isNamedBy} for how its case is compared)
      * @returns The attribute value, or null if the attribute is not found
      */
     getAttributePretended(attrName) {
         for (const attr of this.#attributes) {
-            if (attr.name.toLowerCase() === attrName.toLowerCase()) {
+            if (attr.isNamedBy(attrName)) {
                 return attr.value;
             }
         }
@@ -2545,14 +2764,13 @@ export class MLElement extends MLParentNode {
      * Unlike `getAttribute`, this returns the full `MLAttr` token objects.
      *
      * @implements `@markuplint/ml-core` API: `MLElement`
-     * @param attrName - The attribute name to look up (case-insensitive)
+     * @param attrName - The attribute name to look up (see {@link MLAttr.isNamedBy} for how its case is compared)
      * @returns An array of matching attribute tokens
      */
     getAttributeToken(attrName) {
         const attrs = [];
-        attrName = attrName.toLowerCase();
         for (const attr of this.getAttributeTokens()) {
-            if (attr.name === attrName) {
+            if (attr.isNamedBy(attrName)) {
                 attrs.push(attr);
             }
         }
@@ -2960,7 +3178,8 @@ export class MLElement extends MLParentNode {
     }
     /**
      * The namespace of an element named `name` rendered where this element is, for the
-     * element this element pretends to be.
+     * element this element pretends to be. `null` for what is not an element, a
+     * component.
      *
      * Where this element is has the namespace of this element, so the element gets the
      * namespace an element written there gets. For a component, it is taken from the
@@ -2990,13 +3209,16 @@ export class MLElement extends MLParentNode {
         // mask spec-driven rules — deprecation, ARIA role restrictions, browser support —
         // keyed on the original tag. See issue #3740.
         //
+        // What is recognised is what the document says (`MLDocument#isNativeTag`): the specification, unless
+        // the parser has a rule of its own. Vue's rule does not hold `<marquee>`, which Vue resolves to a
+        // component when one is imported, so there it is pretender-eligible. See issue #4351.
+        //
         // Names that the HTML parser cannot distinguish from typos (PascalCase JSX-like
         // usage in plain HTML such as `<SimpleButton>`) get `elementType === 'html'`
         // from the parser but have no spec entry; those remain pretender-eligible
         // (this is what `pretenders.scan` relies on). The legacy "no inline `as=` on
         // HTML elements" guard is preserved further down for that case.
-        if (this.elementType === 'html' &&
-            getSpecByTagName(this.ownerMLDocument.specs.specs, this.localName, this.namespaceURI) != null) {
+        if (this.elementType === 'html' && this.ownerMLDocument.isNativeTag(this.localName, this.namespaceURI)) {
             return;
         }
         const pretenderConfig = pretenders?.find(option => this.matches(option.selector));
@@ -3028,16 +3250,19 @@ export class MLElement extends MLParentNode {
             aria = pretenderElement.aria;
         }
         const slots = typeof pretenderElement === 'string' ? undefined : pretenderElement.slots;
+        // A component is given no name for the namespace, as `#resolveNamespace` does:
+        // `getChildNamespace` compares names in lowercase, so `Svg` would enter SVG.
+        const isComponent = this.ownerMLDocument.isComponentName(nodeName);
         const namespace = typeof pretenderElement !== 'string' && pretenderElement.namespace
             ? pretenderNamespaceToURI(pretenderElement.namespace)
-            : this.#getNamespaceInPlace(nodeName, renderedParent);
+            : this.#getNamespaceInPlace(isComponent ? null : nodeName, renderedParent);
         const as = new _a({
             ...this._astToken,
             uuid: this.uuid + '_pretender',
             raw: `<${nodeName}>`,
             nodeName,
             namespace,
-            elementType: 'html',
+            elementType: isComponent ? 'authored' : 'html',
             attributes,
         }, this.ownerMLDocument);
         // When slots is null, the component does not accept children (void-like).
@@ -3081,8 +3306,13 @@ export class MLElement extends MLParentNode {
                 _value = value;
             }
             else if (value != null && 'fromAttr' in value) {
-                const fromAttr = value.fromAttr.toLowerCase();
-                const origin = this.#attributes.find(attr => attr.name.toLowerCase() === fromAttr);
+                // The attribute of the usage site that the prop is. Vue gives a prop the attribute by the camelCase
+                // of its name (`my-label` and `myLabel` are the prop `myLabel`, and `mylabel` is another),
+                // and the prop declared as `'my-label'` is the same one, so both sides are read so. Elsewhere
+                // the attribute is read as the DOM or the framework reads it (`isNamedBy`).
+                const { fromAttr } = value;
+                const isVue = this.ownerMLDocument.componentNameVariants;
+                const origin = this.#attributes.find(attr => isVue ? vuePropKey(attr.name) === vuePropKey(fromAttr) : attr.isNamedBy(fromAttr));
                 if (!origin && value.omitIfMissing) {
                     return [];
                 }
@@ -3157,6 +3387,14 @@ export class MLElement extends MLParentNode {
         if (spec.attrs) {
             attributes.push(...this.#createPretenderAttrs(spec.attrs, uuid));
         }
+        const isComponent = this.ownerMLDocument.isComponentName(spec.element);
+        let elementType = 'html';
+        if (isComponent) {
+            elementType = 'authored';
+        }
+        else if (spec.element.includes('-')) {
+            elementType = 'web-component';
+        }
         const virtual = new _a({
             ...this._astToken,
             uuid,
@@ -3164,8 +3402,8 @@ export class MLElement extends MLParentNode {
             nodeName: spec.element,
             namespace: spec.namespace
                 ? pretenderNamespaceToURI(spec.namespace)
-                : renderedIn.#getChildNamespace(spec.element),
-            elementType: spec.element.includes('-') ? 'web-component' : 'html',
+                : renderedIn.#getChildNamespace(isComponent ? null : spec.element),
+            elementType,
             attributes,
             childNodes: [],
             pairNodeUuid: null,

package/lib/ml-dom/node/named-node-map.js

@@ -1,7 +1,7 @@
 import { UnexpectedCallError } from '@markuplint/shared';
 export class MLNamedNodeMap extends Array {
     getNamedItem(qualifiedName) {
-        return this.find(attr => attr.name === qualifiedName) ?? null;
+        return this.find(attr => attr.isNamedBy(qualifiedName)) ?? null;
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**

package/lib/ml-dom/node/node-store.js

@@ -46,11 +46,13 @@ export class NodeStore {
     setNode(astNode, 
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     node) {
-        if (!astNode.uuid) {
+        if (!astNode.uuid && nodeStoreError.enabled) {
             nodeStoreError('UUID is invalid: %s (%s: "%s")', astNode.uuid, astNode.nodeName, astNode.raw);
             nodeStoreError('Invalid node: %O', node);
         }
-        nodeStoreLog('Mapped: %s (%s: "%s")', astNode.uuid, astNode.nodeName, astNode.raw.replaceAll('\n', '⏎').replaceAll('\t', '→'));
+        if (nodeStoreLog.enabled) {
+            nodeStoreLog('Mapped: %s (%s: "%s")', astNode.uuid, astNode.nodeName, astNode.raw.replaceAll('\n', '⏎').replaceAll('\t', '→'));
+        }
         this.#store.set(astNode.uuid, node);
     }
 }

package/lib/ml-dom/node/rule-mapper.js

@@ -20,38 +20,53 @@ export class RuleMapper {
         this.#nodeList = Object.freeze([document, ...document.nodeList]);
     }
     apply() {
-        ruleMapperLog('ruleTree:');
+        if (ruleMapperLog.enabled) {
+            ruleMapperLog('ruleTree:');
+        }
+        const nodeEnabled = ruleMapperNodeLog.enabled;
+        const nodeRuleEnabled = ruleMapperNodeRuleLog.enabled;
         for (const node of this.#nodeList) {
             const rules = this.#ruleMap.get(node.uuid);
             if (!rules) {
                 continue;
             }
-            ruleMapperNodeLog('<%s>', node.nodeName);
+            if (nodeEnabled) {
+                ruleMapperNodeLog('<%s>', node.nodeName);
+            }
             for (const ruleName of Object.keys(rules)) {
                 const rule = rules[ruleName];
                 if (!rule) {
                     continue;
                 }
                 node.rules[ruleName] = rule.rule;
-                ruleMapperNodeRuleLog('[from: %s(%s)] %s: %o', rule.from, rule.specificity, ruleName, rule.rule);
+                if (nodeRuleEnabled) {
+                    ruleMapperNodeRuleLog('[from: %s(%s)] %s: %o', rule.from, rule.specificity, ruleName, rule.rule);
+                }
             }
         }
     }
     set(
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     node, ruleName, rule) {
+        const enabled = ruleMapperLog.enabled;
         const rules = this.#ruleMap.get(node.uuid) ?? {};
         const currentRule = rules[ruleName];
         if (currentRule) {
             const order = compareSpecificity(currentRule.specificity, rule.specificity);
             if (order === 1) {
-                ruleMapperLog("Don't set %o ([%s] vs [%s])", rule, currentRule.specificity, rule.specificity);
+                if (enabled) {
+                    ruleMapperLog("Don't set %o ([%s] vs [%s])", rule, currentRule.specificity, rule.specificity);
+                }
                 return;
             }
-            ruleMapperLog('Unset %o from %s', currentRule, node);
+            if (enabled) {
+                ruleMapperLog('Unset %o from %s', currentRule, node);
+            }
         }
         rules[ruleName] = rule;
         this.#ruleMap.set(node.uuid, rules);
-        ruleMapperLog('Set to %s from %s (%o): %O', node.nodeName, rule.from, rule.specificity, rule.rule);
+        if (enabled) {
+            ruleMapperLog('Set to %s from %s (%o): %O', node.nodeName, rule.from, rule.specificity, rule.rule);
+        }
     }
 }

package/lib/test/index.js

@@ -13,13 +13,22 @@ import { MLDocument } from '../ml-dom/node/document.js';
  * @returns A parsed MLDocument instance
  */
 export function createTestDocument(sourceCode, options) {
-    const ast = options?.parser
-        ? 'parser' in options.parser
-            ? options.parser.parser.parse(sourceCode, options.config?.parserOptions)
-            : options.parser.parse(sourceCode, options.config?.parserOptions)
-        : parser.parse(sourceCode, options?.config?.parserOptions);
+    const usedParser = options?.parser ? ('parser' in options.parser ? options.parser.parser : options.parser) : parser;
+    const ast = usedParser.parse(sourceCode, options?.config?.parserOptions);
     const ruleset = convertRuleset(options?.config);
-    const document = new MLDocument(ast, ruleset, [options?.specs ?? spec, {}], { ariaVersion: ARIA_RECOMMENDED_VERSION }, options?.pretenders ? { pretenders: options.pretenders } : undefined);
+    const document = new MLDocument(ast, ruleset, [options?.specs ?? spec, {}], { ariaVersion: ARIA_RECOMMENDED_VERSION }, {
+        // The settings of the language are what the parser says, as `MLCore` hands them to the document
+        endTag: usedParser.endTag,
+        booleanish: usedParser.booleanish,
+        tagNameCaseSensitive: usedParser.tagNameCaseSensitive,
+        componentNameVariants: usedParser.componentNameVariants,
+        isComponentName: usedParser.isComponentName?.bind(usedParser),
+        // Only a parser with a list of its own (Vue) has it, as against `isComponentName` that the base class has
+        isNativeTag: 'isNativeTag' in usedParser ? usedParser.isNativeTag?.bind(usedParser) : undefined,
+        attrNameCaseSensitive: usedParser.attrNameCaseSensitive,
+        attrNameRoute: usedParser.attrNameRoute,
+        ...(options?.pretenders ? { pretenders: options.pretenders } : {}),
+    });
     return document;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/ml-core",
-	"version": "5.2.0",
+	"version": "5.4.0",
 	"description": "The core module of markuplint",
 	"repository": {
 		"type": "git",
@@ -15,8 +15,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"types": "./lib/index.d.ts",
+			"default": "./lib/index.js"
 		}
 	},
 	"publishConfig": {
@@ -34,20 +34,20 @@
 		"./lib/configs.js": "./lib/configs.browser.js"
 	},
 	"dependencies": {
-		"@markuplint/config-presets": "5.2.0",
-		"@markuplint/html-parser": "5.2.0",
-		"@markuplint/html-spec": "5.2.0",
-		"@markuplint/i18n": "5.1.1",
-		"@markuplint/ml-ast": "5.1.1",
-		"@markuplint/ml-config": "5.2.0",
-		"@markuplint/ml-spec": "5.2.0",
-		"@markuplint/parser-utils": "5.2.0",
-		"@markuplint/selector": "5.2.0",
-		"@markuplint/shared": "5.2.0",
+		"@markuplint/config-presets": "5.4.0",
+		"@markuplint/html-parser": "5.4.0",
+		"@markuplint/html-spec": "5.4.0",
+		"@markuplint/i18n": "5.3.0",
+		"@markuplint/ml-ast": "5.3.0",
+		"@markuplint/ml-config": "5.4.0",
+		"@markuplint/ml-spec": "5.4.0",
+		"@markuplint/parser-utils": "5.4.0",
+		"@markuplint/selector": "5.4.0",
+		"@markuplint/shared": "5.4.0",
 		"@types/debug": "^4.1.13",
 		"debug": "^4.4.3",
 		"is-plain-object": "^5.1.0",
 		"type-fest": "^5.10.0"
 	},
-	"gitHead": "d8b2feab77c9c862513615bea6b80d2817431878"
+	"gitHead": "647f6fb5d5743f060678599c97e9c84b58970747"
 }