@markuplint/ml-core 5.0.0-rc.0 → 5.0.0-rc.2

package/ARCHITECTURE.ja.md

@@ -31,8 +31,7 @@ src/
 │   │   ├── element-close-tag.ts      — MLElementCloseTag
 │   │   ├── rule-mapper.ts            — RuleMapper（ルールセット → ノードマッピング）
 │   │   ├── types.ts                  — ノード型定数、AccessibilityProperties
-│   │   ├── node-list.ts              — NodeList/HTMLCollection ユーティリティ
-│   │   └── unexpected-call-error.ts  — 未サポート DOM メソッドのエラー
+│   │   └── node-list.ts              — NodeList/HTMLCollection ユーティリティ
 │   ├── token/
 │   │   └── token.ts                  — MLToken（位置情報付き基底トークン）
 │   ├── helper/

package/ARCHITECTURE.md

@@ -31,8 +31,7 @@ src/
 │   │   ├── element-close-tag.ts      — MLElementCloseTag
 │   │   ├── rule-mapper.ts            — RuleMapper (ruleset → node mapping)
 │   │   ├── types.ts                  — Node type constants, AccessibilityProperties
-│   │   ├── node-list.ts              — NodeList/HTMLCollection utilities
-│   │   └── unexpected-call-error.ts  — Error for unsupported DOM methods
+│   │   └── node-list.ts              — NodeList/HTMLCollection utilities
 │   ├── token/
 │   │   └── token.ts                  — MLToken (base positional token)
 │   ├── helper/

package/CHANGELOG.md

@@ -3,6 +3,40 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-rc.2](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.1...v5.0.0-rc.2) (2026-04-15)
+
+### Bug Fixes
+
+- **ml-core:** propagate base rule disable to virtual rules in nodeRules/childNodeRules ([06fa269](https://github.com/markuplint/markuplint/commit/06fa2695d43671adc1ebcadf1304aca44fd10919)), closes [#3578](https://github.com/markuplint/markuplint/issues/3578)
+
+- build!: remove ESLint and replace with oxlint ([1e0a337](https://github.com/markuplint/markuplint/commit/1e0a337707f76b903b16beeeb8c4d4fc0d8fc9e4))
+- feat(ml-core)!: remove deprecated getIndent function ([7ab1a2d](https://github.com/markuplint/markuplint/commit/7ab1a2dae8f36002f4e5f3108a400bb9095db319))
+
+### Features
+
+- **ml-core:** propagate option overrides to virtual rules in nodeRules/childNodeRules ([9cb9521](https://github.com/markuplint/markuplint/commit/9cb9521fc1303c132f547ffd1e8c82b3b9099bef))
+
+### BREAKING CHANGES
+
+- ESLint is no longer used. Use oxlint instead.
+- getIndent() has been removed from the public API.
+
+# [5.0.0-rc.1](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.0...v5.0.0-rc.1) (2026-03-27)
+
+### Bug Fixes
+
+- add isFatalError guard to MLEngine.exec and fix accname Deno crash ([c4b20de](https://github.com/markuplint/markuplint/commit/c4b20de128b2cfee582b3588e5004cb90065825b))
+- **ml-core:** add DOM stubs for TS 6 lib.dom.d.ts updates ([837a2ba](https://github.com/markuplint/markuplint/commit/837a2bad5afe967d4d309b91d056b46fc91c7512))
+
+- feat(ml-core)!: resolve node references via UUID instead of object refs ([e9b6f4e](https://github.com/markuplint/markuplint/commit/e9b6f4e68bda2f60c9fa69699bf251b51874a4ac))
+
+### BREAKING CHANGES
+
+- MLDOM now resolves parent and pair nodes via UUID
+  strings from the AST instead of direct object references.
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
 # [5.0.0-rc.0](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.3...v5.0.0-rc.0) (2026-03-12)
 
 ### Bug Fixes

package/docs/ml-dom/helpers.ja.md

@@ -18,7 +18,7 @@ AST ノード型を対応する MLDOM コンストラクタにディスパッチ
 | `'invalid'`（`kind: 'starttag'`） | `MLElement`（`x-invalid`、`elementType: 'web-component'` として） | `1`        |
 | `'invalid'`（その他の kind）      | `MLText`                                                          | `3`        |
 
-**注:** `'endtag'` は `createNode()` を通過しません -- ドキュメントのコンストラクション中にスキップされます。`MLElement` は `pairNode` 参照から内部的に `MLElementCloseTag` を作成します。`MLASTAttr` は `MLElement` によって処理され、要素の `attributes` 配列から `MLAttr` インスタンスを作成します。
+**注:** `'endtag'` は `createNode()` を通過しません -- ドキュメントのコンストラクション中にスキップされます。`MLElement` は `pairNodeUuid` を解決して内部的に `MLElementCloseTag` を作成します。`MLASTAttr` は `MLElement` によって処理され、要素の `attributes` 配列から `MLAttr` インスタンスを作成します。
 
 ### ウォーカー
 

package/docs/ml-dom/helpers.md

@@ -18,7 +18,7 @@ Factory function that dispatches AST node types to their corresponding MLDOM con
 | `'invalid'` (`kind: 'starttag'`) | `MLElement` (as `x-invalid`, `elementType: 'web-component'`) | `1`        |
 | `'invalid'` (other kind)         | `MLText`                                                     | `3`        |
 
-**Note:** `'endtag'` is not passed through `createNode()` -- it is skipped during document construction. `MLElement` creates `MLElementCloseTag` internally from its `pairNode` reference. `MLASTAttr` is handled by `MLElement` which creates `MLAttr` instances from the element's `attributes` array.
+**Note:** `'endtag'` is not passed through `createNode()` -- it is skipped during document construction. `MLElement` creates `MLElementCloseTag` internally by resolving its `pairNodeUuid`. `MLASTAttr` is handled by `MLElement` which creates `MLAttr` instances from the element's `attributes` array.
 
 ### Walkers
 

package/lib/index.d.ts

@@ -5,7 +5,6 @@ export { enableDebug } from './debug.js';
 export { computeCursorOffset } from './cursor-offset.js';
 export { applyFixes } from './fix-applier.js';
 export type { FixResult } from './fix-applier.js';
-export { getIndent } from './ml-dom/helper/get-indent.js';
 export * from './convert-ruleset.js';
 export * from './ml-core.js';
 export * from './ml-dom/index.js';

package/lib/index.js

@@ -3,7 +3,6 @@ export { Ruleset } from './ruleset/index.js';
 export { enableDebug } from './debug.js';
 export { computeCursorOffset } from './cursor-offset.js';
 export { applyFixes } from './fix-applier.js';
-export { getIndent } from './ml-dom/helper/get-indent.js';
 export * from './convert-ruleset.js';
 export * from './ml-core.js';
 export * from './ml-dom/index.js';

package/lib/ml-core.js

@@ -67,6 +67,8 @@ export class MLCore {
             rules: resolvedRules,
             nodeRules: nodeRuleResult.transformedNodeRules,
             childNodeRules: childNodeRuleResult.transformedNodeRules,
+            baseRuleToVirtualNames: buildBaseRuleToVirtualNames(namedRulesResult.virtualRules),
+            mappingErrors: [],
         };
         this.#disabledNamespaces = extractDisabledNamespaces(resolvedRules);
         this.#configErrors.push(...namedRulesResult.errors, ...nodeRuleResult.errors, ...childNodeRuleResult.errors);
@@ -100,7 +102,7 @@ export class MLCore {
         this.#locale = locale ?? this.#locale;
         this.#schemas = schemas ?? this.#schemas;
         this.#configErrors = [...(configErrors ?? [])];
-        const baseRules = rules?.slice() ?? this.#rules.filter(r => !r.baseRuleId);
+        const baseRules = rules ? [...rules] : this.#rules.filter(r => !r.baseRuleId);
         // Use pre-expansion originals as fallback when ruleset is not provided
         const incomingNodeRules = ruleset?.nodeRules ?? this.#originalNodeRules;
         const incomingChildNodeRules = ruleset?.childNodeRules ?? this.#originalChildNodeRules;
@@ -123,6 +125,8 @@ export class MLCore {
             rules: resolvedRules,
             nodeRules: nodeRuleResult.transformedNodeRules,
             childNodeRules: childNodeRuleResult.transformedNodeRules,
+            baseRuleToVirtualNames: buildBaseRuleToVirtualNames(namedRulesResult.virtualRules),
+            mappingErrors: [],
         };
         this.#disabledNamespaces = extractDisabledNamespaces(resolvedRules);
         this.#configErrors.push(...namedRulesResult.errors, ...nodeRuleResult.errors, ...childNodeRuleResult.errors);
@@ -243,6 +247,9 @@ export class MLCore {
                 tagNameCaseSensitive: this.#parser.tagNameCaseSensitive,
                 pretenders: this.#pretenders,
             });
+            // Collect errors from rule mapping (e.g., invalid wildcard usage)
+            this.#configErrors.push(...this.#ruleset.mappingErrors);
+            this.#ruleset.mappingErrors.length = 0;
         }
         catch (error) {
             if (error instanceof ParserError) {
@@ -426,6 +433,29 @@ function extractDisabledNamespaces(rules) {
         .filter(([key, value]) => key.endsWith('/*') && value === false)
         .map(([key]) => key.slice(0, -1)); // "a11y/*" → "a11y/"
 }
+/**
+ * Builds a mapping from base rule names to virtual rule names.
+ * Used by nodeRules/childNodeRules to propagate settings (especially `false`)
+ * to virtual rules created by NamedRuleGroups.
+ */
+function buildBaseRuleToVirtualNames(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+virtualRules) {
+    const map = new Map();
+    for (const vRule of virtualRules) {
+        if (!vRule.baseRuleId) {
+            continue;
+        }
+        const list = map.get(vRule.baseRuleId);
+        if (list) {
+            list.push(vRule.name);
+        }
+        else {
+            map.set(vRule.baseRuleId, [vRule.name]);
+        }
+    }
+    return map;
+}
 /**
  * Collects all `FixData` from violations that have a fix callback result.
  *

package/lib/ml-dom/helper/accname.js

@@ -14,20 +14,18 @@ export function getAccname(
 el, version) {
     // AccName computation involves DOM traversal, role resolution, and label
     // lookup via querySelector. These may fail on unexpected DOM states (e.g.,
-    // detached nodes, malformed attributes) or incomplete spec data.
+    // detached nodes, malformed attributes), incomplete spec data, or runtime
+    // environment differences (e.g., Deno lacking certain DOM APIs).
     // A single element's failure must not abort the entire linting process,
-    // so we catch operational errors and return an empty name (= "unnamed").
-    // Programmer errors (TypeError, ReferenceError) are rethrown to avoid
-    // masking implementation bugs.
+    // so we catch all errors and return an empty name (= "unnamed").
+    // This is an intentional exception to the Tier 1 re-throw policy — see
+    // docs/architectures/ERROR-HANDLING.md § "accname computation errors".
     try {
         const resolver = createMLCoreResolver(el, version);
         const result = computeAccessibleName(el, resolver);
         return result.name;
     }
     catch (error) {
-        if (error instanceof TypeError || error instanceof ReferenceError) {
-            throw error;
-        }
         accnameLog('Raw: %s', el.raw);
         accnameLog('Error: %O', error);
         return '';

package/lib/ml-dom/helper/create-node.js

@@ -34,7 +34,7 @@ document) {
                         attributes: [],
                         childNodes: [],
                         blockBehavior: null,
-                        pairNode: null,
+                        pairNodeUuid: null,
                         tagOpenChar: '',
                         tagCloseChar: '',
                         isGhost: false,

package/lib/ml-dom/manipulations/child-node-methods.js

@@ -1,4 +1,4 @@
-import { UnexpectedCallError } from '../node/unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-childnode-before%E2%91%A0

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

@@ -3,7 +3,7 @@ import { searchIDLAttribute } from '@markuplint/parser-utils';
 import { MLToken } from '../token/token.js';
 import { MLDomTokenList } from './dom-token-list.js';
 import { MLNode } from './node.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 /**
  * Represents a DOM Attr (attribute) node wrapper in the markuplint DOM tree.
  * Wraps an AST attribute token and provides access to the attribute's name, value,

package/lib/ml-dom/node/character-data.js

@@ -1,6 +1,6 @@
 import { after, before, nextElementSibling, previousElementSibling, remove, replaceWith, } from '../manipulations/child-node-methods.js';
 import { MLNode } from './node.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 export class MLCharacterData extends MLNode {
     /**
      * @implements DOM API: `CharacterData`

package/lib/ml-dom/node/document-fragment.js

@@ -1,5 +1,5 @@
 import { MLParentNode } from './parent-node.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 /**
  * Represents a DOM DocumentFragment node wrapper in the markuplint DOM tree.
  * Used for JSX fragments and similar constructs where a set of nodes

package/lib/ml-dom/node/document.d.ts

@@ -10,7 +10,7 @@ import type { Ruleset } from '../../ruleset/index.js';
 import type { MLSchema } from '../../types.js';
 import type { Walker } from '../helper/walkers.js';
 import type { MLToken } from '../token/token.js';
-import type { EndTagType, MLASTDocument } from '@markuplint/ml-ast';
+import type { EndTagType, MLASTDocument, MLASTNodeTreeItem } from '@markuplint/ml-ast';
 import type { PlainData, Pretender, RuleCommonSettings, RuleConfigValue } from '@markuplint/ml-config';
 import type { ARIAVersion, MLMLSpec } from '@markuplint/ml-spec';
 import { MLParentNode } from './parent-node.js';
@@ -93,6 +93,13 @@ export declare class MLDocument<T extends RuleConfigValue, O extends PlainData =
         readonly tagNameCaseSensitive?: boolean;
         readonly pretenders?: readonly Pretender[];
     });
+    /**
+     * Looks up an AST node by its UUID from the parsed document's node list.
+     *
+     * @param uuid - The UUID of the AST node to find
+     * @returns The AST node, or `undefined` if not found
+     */
+    getAstNodeByUuid(uuid: string): MLASTNodeTreeItem | undefined;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -107,6 +114,14 @@ export declare class MLDocument<T extends RuleConfigValue, O extends PlainData =
      * @implements DOM API: `Document`
      */
     get activeElement(): Element | null;
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Document`
+     */
+    get activeViewTransition(): ViewTransition | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -204,6 +219,14 @@ export declare class MLDocument<T extends RuleConfigValue, O extends PlainData =
      * @implements DOM API: `Document`
      */
     get currentScript(): HTMLOrSVGScriptElement | null;
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Document`
+     */
+    get customElementRegistry(): CustomElementRegistry | null;
     /**
      * Window object for calling the `getComputedStyle` and the `getPropertyValue` that
      * are needed by **Accessible Name and Description Computation**.
@@ -519,6 +542,14 @@ export declare class MLDocument<T extends RuleConfigValue, O extends PlainData =
      * @implements DOM API: `Document`
      */
     get onclose(): ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Document`
+     */
+    get oncommand(): ((this: GlobalEventHandlers, ev: Event) => any) | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *

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

@@ -9,7 +9,7 @@ import { sequentialWalker, syncWalk } from '../helper/walkers.js';
 import { nodeListToHTMLCollection } from './node-list.js';
 import { MLParentNode } from './parent-node.js';
 import { RuleMapper } from './rule-mapper.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 const log = coreLog.extend('ml-dom');
 const docLog = log.extend('document');
 const ruleLog = docLog.extend('rule');
@@ -51,6 +51,7 @@ export class MLDocument extends MLParentNode {
     /**
      * The file path of the source document, if available.
      */
+    #astNodeMap;
     #filename;
     /**
      * Whether this document represents a fragment rather than a complete document.
@@ -98,6 +99,8 @@ export class MLDocument extends MLParentNode {
         this.#filename = options?.filename;
         this.tagNameCaseSensitive = options?.tagNameCaseSensitive ?? false;
         this.ruleCommonSettings = ruleCommonSettings;
+        // Build UUID → AST node map for cross-reference lookups (e.g., pairNodeUuid)
+        this.#astNodeMap = new Map(ast.nodeList.map(n => [n.uuid, n]));
         // console.log(ast.nodeList.map((n, i) => `${i}: ${n.uuid} "${n.raw.trim()}"(${n.type})`));
         this.nodeList = Object.freeze(ast.nodeList
             .map(astNode => {
@@ -120,6 +123,15 @@ export class MLDocument extends MLParentNode {
             throw error;
         }
     }
+    /**
+     * Looks up an AST node by its UUID from the parsed document's node list.
+     *
+     * @param uuid - The UUID of the AST node to find
+     * @returns The AST node, or `undefined` if not found
+     */
+    getAstNodeByUuid(uuid) {
+        return this.#astNodeMap.get(uuid);
+    }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -138,6 +150,16 @@ export class MLDocument extends MLParentNode {
     get activeElement() {
         throw new UnexpectedCallError('Not supported "activeElement" property');
     }
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Document`
+     */
+    get activeViewTransition() {
+        throw new UnexpectedCallError('Not supported "activeViewTransition" property');
+    }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -261,6 +283,16 @@ export class MLDocument extends MLParentNode {
     get currentScript() {
         throw new UnexpectedCallError('Not supported "currentScript" property');
     }
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Document`
+     */
+    get customElementRegistry() {
+        throw new UnexpectedCallError('Not supported "customElementRegistry" property');
+    }
     /**
      * Window object for calling the `getComputedStyle` and the `getPropertyValue` that
      * are needed by **Accessible Name and Description Computation**.
@@ -677,6 +709,16 @@ export class MLDocument extends MLParentNode {
     get onclose() {
         throw new UnexpectedCallError('Not supported "onclose" property');
     }
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Document`
+     */
+    get oncommand() {
+        throw new UnexpectedCallError('Not supported "oncommand" property');
+    }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -2357,6 +2399,24 @@ export class MLDocument extends MLParentNode {
                     if (rule == null) {
                         continue;
                     }
+                    // Namespace wildcard (e.g., "a11y/*": false)
+                    if (ruleName.endsWith('/*')) {
+                        if (rule !== false) {
+                            ruleset.mappingErrors.push(new Error(`Namespace wildcard "${ruleName}" only accepts false; use a specific rule name for options`));
+                            continue;
+                        }
+                        const nsPrefix = ruleName.slice(0, -1); // "a11y/*" → "a11y/"
+                        for (const key of Object.keys(ruleset.rules)) {
+                            if (key.startsWith(nsPrefix)) {
+                                ruleMapper.set(node, key, {
+                                    from: 'nodeRules',
+                                    specificity: matches.specificity,
+                                    rule: false,
+                                });
+                            }
+                        }
+                        continue;
+                    }
                     const convertedRule = exchangeValueOnRule(rule, matches.data ?? {});
                     if (convertedRule === undefined) {
                         continue;
@@ -2369,6 +2429,19 @@ export class MLDocument extends MLParentNode {
                         specificity: matches.specificity,
                         rule: mergedRule,
                     });
+                    // Propagate to virtual rules that wrap this base rule
+                    const virtualNames = ruleset.baseRuleToVirtualNames.get(ruleName);
+                    if (virtualNames) {
+                        for (const vName of virtualNames) {
+                            const vGlobalRule = ruleset.rules[vName];
+                            const vMergedRule = vGlobalRule == null ? convertedRule : mergeRule(vGlobalRule, convertedRule);
+                            ruleMapper.set(node, vName, {
+                                from: 'nodeRules',
+                                specificity: matches.specificity,
+                                rule: vMergedRule,
+                            });
+                        }
+                    }
                 }
             }
             // overwrite rule to child node
@@ -2400,6 +2473,26 @@ export class MLDocument extends MLParentNode {
                         if (rule == null) {
                             continue;
                         }
+                        // Namespace wildcard (e.g., "a11y/*": false)
+                        if (ruleName.endsWith('/*')) {
+                            if (rule !== false) {
+                                ruleset.mappingErrors.push(new Error(`Namespace wildcard "${ruleName}" only accepts false; use a specific rule name for options`));
+                                continue;
+                            }
+                            const nsPrefix = ruleName.slice(0, -1); // "a11y/*" → "a11y/"
+                            for (const key of Object.keys(ruleset.rules)) {
+                                if (key.startsWith(nsPrefix)) {
+                                    for (const descendant of targetDescendants) {
+                                        ruleMapper.set(descendant, key, {
+                                            from: 'childNodeRules',
+                                            specificity: matches.specificity,
+                                            rule: false,
+                                        });
+                                    }
+                                }
+                            }
+                            continue;
+                        }
                         const convertedRule = exchangeValueOnRule(rule, matches.data ?? {});
                         if (convertedRule === undefined) {
                             continue;
@@ -2414,6 +2507,21 @@ export class MLDocument extends MLParentNode {
                                 rule: mergedRule,
                             });
                         }
+                        // Propagate to virtual rules that wrap this base rule
+                        const virtualNames = ruleset.baseRuleToVirtualNames.get(ruleName);
+                        if (virtualNames) {
+                            for (const vName of virtualNames) {
+                                const vGlobalRule = ruleset.rules[vName];
+                                const vMergedRule = vGlobalRule == null ? convertedRule : mergeRule(vGlobalRule, convertedRule);
+                                for (const descendant of targetDescendants) {
+                                    ruleMapper.set(descendant, vName, {
+                                        from: 'childNodeRules',
+                                        specificity: matches.specificity,
+                                        rule: vMergedRule,
+                                    });
+                                }
+                            }
+                        }
                     }
                 }
             }

package/lib/ml-dom/node/dom-token-list.js

@@ -1,5 +1,5 @@
 import { getPosition } from '@markuplint/parser-utils/location';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 export class MLDomTokenList extends Array {
     #origin;
     /**

package/lib/ml-dom/node/element.d.ts

@@ -185,7 +185,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaControlsElements(): readonly MLElement<T, O>[];
+    get ariaControlsElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -201,7 +201,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaDescribedByElements(): readonly MLElement<T, O>[];
+    get ariaDescribedByElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -217,7 +217,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaDetailsElements(): readonly MLElement<T, O>[];
+    get ariaDetailsElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -233,7 +233,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaErrorMessageElements(): readonly MLElement<T, O>[];
+    get ariaErrorMessageElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -249,7 +249,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaFlowToElements(): readonly MLElement<T, O>[];
+    get ariaFlowToElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -297,7 +297,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaLabelledByElements(): readonly MLElement<T, O>[];
+    get ariaLabelledByElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -353,7 +353,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get ariaOwnsElements(): readonly MLElement<T, O>[];
+    get ariaOwnsElements(): readonly MLElement<T, O>[] | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -600,6 +600,14 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @implements DOM API: `Element`
      */
     get currentCSSZoom(): number;
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Element`
+     */
+    get customElementRegistry(): CustomElementRegistry | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -739,7 +747,7 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @unsupported
      * @implements DOM API: `Element`
      */
-    get nonce(): string | undefined;
+    get nonce(): string;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -908,6 +916,14 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @implements DOM API: `Element`
      */
     get onclose(): ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Element`
+     */
+    get oncommand(): ((this: GlobalEventHandlers, ev: Event) => any) | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -2065,7 +2081,10 @@ export declare class MLElement<T extends RuleConfigValue, O extends PlainData =
      * @implements DOM API: `Element`
      * @see https://dom.spec.whatwg.org/#ref-for-dom-element-matches%E2%91%A0
      */
-    matches(selector: string, scope?: MLParentNode<T, O>): boolean;
+    matches<K extends keyof HTMLElementTagNameMap>(selectors: K): this is HTMLElementTagNameMap[K];
+    matches<K extends keyof SVGElementTagNameMap>(selectors: K): this is SVGElementTagNameMap[K];
+    matches<K extends keyof MathMLElementTagNameMap>(selectors: K): this is MathMLElementTagNameMap[K];
+    matches(selectors: string, scope?: MLParentNode<T, O>): boolean;
     /**
      * Matches this element against a CSS selector or regex selector pattern,
      * returning detailed match results. When the element is a pretender,

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

@@ -9,7 +9,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 './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 const HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml';
 /**
  * Represents a DOM Element node wrapper in the markuplint DOM tree.
@@ -116,7 +116,10 @@ export class MLElement extends MLParentNode {
     document) {
         super(astNode, document, astNode.isFragment);
         this.#attributes = astNode.attributes.map(attr => new MLAttr(attr, this));
-        this.closeTag = astNode.pairNode ? new MLElementCloseTag(astNode.pairNode, document, this) : null;
+        const pairAstNode = astNode.pairNodeUuid
+            ? document.getAstNodeByUuid(astNode.pairNodeUuid)
+            : null;
+        this.closeTag = pairAstNode ? new MLElementCloseTag(pairAstNode, document, this) : null;
         const ns = resolveNamespace(astNode.nodeName, astNode.namespace);
         this.namespaceURI = astNode.namespace;
         this.elementType = astNode.elementType;
@@ -808,6 +811,16 @@ export class MLElement extends MLParentNode {
     get currentCSSZoom() {
         throw new UnexpectedCallError('Not supported "currentCSSZoom" property');
     }
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Element`
+     */
+    get customElementRegistry() {
+        throw new UnexpectedCallError('Not supported "customElementRegistry" property');
+    }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -1209,6 +1222,16 @@ export class MLElement extends MLParentNode {
     get onclose() {
         throw new UnexpectedCallError('Not supported "onclose" property');
     }
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @deprecated
+     * @unsupported
+     * @implements DOM API: `Element`
+     */
+    get oncommand() {
+        throw new UnexpectedCallError('Not supported "oncommand" property');
+    }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -2783,10 +2806,6 @@ export class MLElement extends MLParentNode {
         }
         return true;
     }
-    /**
-     * @implements DOM API: `Element`
-     * @see https://dom.spec.whatwg.org/#ref-for-dom-element-matches%E2%91%A0
-     */
     matches(selector, 
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     scope) {

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

@@ -1,4 +1,4 @@
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 export class MLNamedNodeMap extends Array {
     getNamedItem(qualifiedName) {
         return this.find(attr => attr.name === qualifiedName) ?? null;

package/lib/ml-dom/node/node-store.d.ts

@@ -5,6 +5,7 @@ import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
 declare class NodeStore {
     #private;
     getNode<N extends MLASTNode, T extends RuleConfigValue, O extends PlainData = undefined>(astNode: N): MappedNode<N, T, O>;
+    getNodeByUuid<T extends RuleConfigValue, O extends PlainData = undefined>(uuid: string): MLNode<T, O, any>;
     setNode<A extends MLASTNode, T extends RuleConfigValue, O extends PlainData = undefined>(astNode: A, node: MLNode<T, O, A>): void;
 }
 /**

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

@@ -22,6 +22,16 @@ class NodeStore {
         }
         return node;
     }
+    getNodeByUuid(uuid) {
+        const node = this.#store.get(uuid);
+        if (!node) {
+            nodeStoreError('Ref UUID: %s', uuid);
+            throw new TargetParserError('Broke mapping nodes.', {
+                raw: `uuid:${uuid}`,
+            });
+        }
+        return node;
+    }
     setNode(astNode, 
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     node) {

package/lib/ml-dom/node/node.d.ts

@@ -441,6 +441,13 @@ export declare abstract class MLNode<T extends RuleConfigValue, O extends PlainD
      * @see https://dom.spec.whatwg.org/#dom-node-insertbefore
      */
     insertBefore<T extends Node>(node: T, child: Node | null): T;
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @unsupported
+     * @implements DOM API: `Node`
+     */
+    moveBefore(node: Node, child: Node | null): Node;
     /**
      * @implements `@markuplint/ml-core` API: `MLNode`
      */

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

@@ -1,9 +1,8 @@
-import { branchesToPatterns } from '@markuplint/shared';
+import { branchesToPatterns, UnexpectedCallError } from '@markuplint/shared';
 import { MLToken } from '../token/token.js';
 import { isChildNode } from './child-node.js';
 import { toNodeList } from './node-list.js';
 import { nodeStore } from './node-store.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
 /**
  * Abstract base class for all markuplint DOM node wrappers.
  * Extends `MLToken` with DOM `Node` interface compliance, tree traversal,
@@ -481,10 +480,10 @@ export class MLNode extends MLToken {
         if (this._astToken.type === 'attr' || this._astToken.type === 'spread') {
             return null;
         }
-        if (!this._astToken.parentNode) {
+        if (!this._astToken.parentNodeUuid) {
             return this.ownerMLDocument;
         }
-        return nodeStore.getNode(this._astToken.parentNode);
+        return nodeStore.getNodeByUuid(this._astToken.parentNodeUuid);
     }
     /**
      * Return the text content.
@@ -753,6 +752,19 @@ export class MLNode extends MLToken {
     child) {
         throw new UnexpectedCallError('Not supported "insertBefore" method');
     }
+    /**
+     * **IT THROWS AN ERROR WHEN CALLING THIS.**
+     *
+     * @unsupported
+     * @implements DOM API: `Node`
+     */
+    moveBefore(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    node, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    child) {
+        throw new UnexpectedCallError('Not supported "moveBefore" method');
+    }
     /**
      * @implements `@markuplint/ml-core` API: `MLNode`
      */

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

@@ -2,7 +2,7 @@ import { syncWalk } from '../helper/walkers.js';
 import { getChildren } from '../manipulations/get-children.js';
 import { toNodeList } from './node-list.js';
 import { MLNode } from './node.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 /**
  *
  * @see https://dom.spec.whatwg.org/#interface-parentnode

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

@@ -1,5 +1,5 @@
 import { MLCharacterData } from './character-data.js';
-import { UnexpectedCallError } from './unexpected-call-error.js';
+import { UnexpectedCallError } from '@markuplint/shared';
 /**
  * Raw text elements
  *

package/lib/ruleset/index.d.ts

@@ -4,14 +4,26 @@ import type { ChildNodeRule, Config, NodeRule, Rules } from '@markuplint/ml-conf
  * rule overrides extracted from a markuplint {@link Config}.
  */
 export declare class Ruleset {
+    /**
+     * Maps base rule names to their virtual rule names created by NamedRuleGroups.
+     * For example, if `a11y/wai-aria` wraps `wai-aria`, this maps `"wai-aria"` → `["a11y/wai-aria"]`.
+     * Used by nodeRules/childNodeRules to propagate settings to virtual rules.
+     */
+    readonly baseRuleToVirtualNames: ReadonlyMap<string, readonly string[]>;
     /** Rule overrides that apply to child nodes matching specific selectors */
     readonly childNodeRules: readonly ChildNodeRule[];
+    /**
+     * Errors collected during rule mapping (e.g., invalid wildcard usage).
+     * Consumed by MLCore and reported as config-error violations.
+     */
+    readonly mappingErrors: Error[];
     /** Rule overrides that apply to nodes matching specific selectors */
     readonly nodeRules: readonly NodeRule[];
     /** The global rule definitions */
     readonly rules: Rules;
     /**
      * @param config - The markuplint configuration to extract rules from
+     * @param baseRuleToVirtualNames - Mapping from base rule names to virtual rule names
      */
-    constructor(config: Config);
+    constructor(config: Config, baseRuleToVirtualNames?: ReadonlyMap<string, readonly string[]>);
 }

package/lib/ruleset/index.js

@@ -3,18 +3,31 @@
  * rule overrides extracted from a markuplint {@link Config}.
  */
 export class Ruleset {
+    /**
+     * Maps base rule names to their virtual rule names created by NamedRuleGroups.
+     * For example, if `a11y/wai-aria` wraps `wai-aria`, this maps `"wai-aria"` → `["a11y/wai-aria"]`.
+     * Used by nodeRules/childNodeRules to propagate settings to virtual rules.
+     */
+    baseRuleToVirtualNames;
     /** Rule overrides that apply to child nodes matching specific selectors */
     childNodeRules;
+    /**
+     * Errors collected during rule mapping (e.g., invalid wildcard usage).
+     * Consumed by MLCore and reported as config-error violations.
+     */
+    mappingErrors = [];
     /** Rule overrides that apply to nodes matching specific selectors */
     nodeRules;
     /** The global rule definitions */
     rules;
     /**
      * @param config - The markuplint configuration to extract rules from
+     * @param baseRuleToVirtualNames - Mapping from base rule names to virtual rule names
      */
-    constructor(config) {
+    constructor(config, baseRuleToVirtualNames) {
         this.rules = config.rules ?? {};
         this.nodeRules = config.nodeRules ?? [];
         this.childNodeRules = config.childNodeRules ?? [];
+        this.baseRuleToVirtualNames = baseRuleToVirtualNames ?? new Map();
     }
 }

package/package.json

@@ -1,8 +1,12 @@
 {
 	"name": "@markuplint/ml-core",
-	"version": "5.0.0-rc.0",
+	"version": "5.0.0-rc.2",
 	"description": "The core module of markuplint",
-	"repository": "git@github.com:markuplint/markuplint.git",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/markuplint/markuplint.git",
+		"directory": "packages/@markuplint/ml-core"
+	},
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
 	"engines": {
@@ -30,20 +34,20 @@
 		"./lib/configs.js": "./lib/configs.browser.js"
 	},
 	"dependencies": {
-		"@markuplint/config-presets": "5.0.0-rc.0",
-		"@markuplint/html-parser": "5.0.0-rc.0",
-		"@markuplint/html-spec": "5.0.0-rc.0",
-		"@markuplint/i18n": "5.0.0-rc.0",
-		"@markuplint/ml-ast": "5.0.0-rc.0",
-		"@markuplint/ml-config": "5.0.0-rc.0",
-		"@markuplint/ml-spec": "5.0.0-rc.0",
-		"@markuplint/parser-utils": "5.0.0-rc.0",
-		"@markuplint/selector": "5.0.0-rc.0",
-		"@markuplint/shared": "5.0.0-rc.0",
-		"@types/debug": "4.1.12",
+		"@markuplint/config-presets": "5.0.0-rc.2",
+		"@markuplint/html-parser": "5.0.0-rc.2",
+		"@markuplint/html-spec": "5.0.0-rc.2",
+		"@markuplint/i18n": "5.0.0-rc.2",
+		"@markuplint/ml-ast": "5.0.0-rc.2",
+		"@markuplint/ml-config": "5.0.0-rc.2",
+		"@markuplint/ml-spec": "5.0.0-rc.2",
+		"@markuplint/parser-utils": "5.0.0-rc.2",
+		"@markuplint/selector": "5.0.0-rc.2",
+		"@markuplint/shared": "5.0.0-rc.2",
+		"@types/debug": "4.1.13",
 		"debug": "4.4.3",
 		"is-plain-object": "5.0.0",
-		"type-fest": "5.4.4"
+		"type-fest": "5.5.0"
 	},
-	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
+	"gitHead": "e43763858d9234c417053becc73dbd088c1e7ea6"
 }

package/lib/ml-dom/helper/get-indent.d.ts

@@ -1,20 +0,0 @@
-import type { MLNode } from '../node/node.js';
-import type { MLText } from '../node/text.js';
-/**
- * Computes the indentation preceding the given node by analyzing
- * the whitespace in adjacent text nodes.
- *
- * @deprecated
- * @param node - The node whose indentation to determine
- * @returns An indentation object describing the whitespace, or null if no indentation is found
- */
-export declare function getIndent(node: MLNode<any, any>): MLDOMIndentation | null;
-declare class MLDOMIndentation {
-    #private;
-    readonly line: number;
-    constructor(originTextNode: MLText<any, any>, raw: string, line: number, parentNode: MLNode<any, any>);
-    get raw(): string;
-    get type(): 'tab' | 'space' | 'mixed' | 'none';
-    get width(): number;
-}
-export {};

package/lib/ml-dom/helper/get-indent.js

@@ -1,90 +0,0 @@
-/**
- * Computes the indentation preceding the given node by analyzing
- * the whitespace in adjacent text nodes.
- *
- * @deprecated
- * @param node - The node whose indentation to determine
- * @returns An indentation object describing the whitespace, or null if no indentation is found
- */
-export function getIndent(
-// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
-node) {
-    const prevToken = node.prevToken;
-    if (!prevToken) {
-        return null;
-    }
-    if (node.is(node.TEXT_NODE)) {
-        if (node.isRawTextElementContent()) {
-            return null;
-        }
-        const matched = node.raw.match(/^([\t\v\f\r \u00A0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF]*\n\s*)\S+/);
-        if (matched) {
-            const spaces = matched[1];
-            if (spaces) {
-                const spaceLines = spaces.split(/\r?\n/);
-                const line = spaceLines.length + node.startLine - 1;
-                const lastSpace = spaceLines.pop();
-                if (lastSpace != null) {
-                    return new MLDOMIndentation(node, lastSpace, line, node);
-                }
-            }
-        }
-        return null;
-    }
-    if (!prevToken.is(node.TEXT_NODE)) {
-        return null;
-    }
-    // One or more newlines and zero or more spaces or tabs.
-    // Or, If textNode is first token and that is filled spaces, tabs and newlines only.
-    const matched = isFirstToken(prevToken)
-        ? prevToken.raw.match(/^(?:[\t ]*\r?\n)*([\t ]*)$/)
-        : prevToken.raw.match(/\r?\n([\t ]*)$/);
-    if (matched) {
-        // Spaces will include empty string.
-        const spaces = matched[1];
-        if (spaces != null) {
-            return new MLDOMIndentation(prevToken, spaces, node.startLine, node);
-        }
-    }
-    return null;
-}
-class MLDOMIndentation {
-    #raw;
-    line;
-    #node;
-    #parent;
-    constructor(
-    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
-    originTextNode, raw, line, 
-    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
-    parentNode) {
-        this.line = line;
-        this.#node = originTextNode;
-        this.#parent = parentNode;
-        this.#raw = raw;
-    }
-    get raw() {
-        if (!this.#parent.is(this.#parent.TEXT_NODE) && this.line !== this.#node.endLine) {
-            return '';
-        }
-        return this.#raw;
-    }
-    get type() {
-        if (!this.#parent.is(this.#parent.TEXT_NODE) && this.line !== this.#node.endLine) {
-            return 'none';
-        }
-        const raw = this.#raw;
-        return raw === '' ? 'none' : /^\t+$/.test(raw) ? 'tab' : /^[^\t]+$/.test(raw) ? 'space' : 'mixed';
-    }
-    get width() {
-        if (!this.#parent.is(this.#parent.TEXT_NODE) && this.line !== this.#node.endLine) {
-            return 0;
-        }
-        return this.#raw.length;
-    }
-}
-function isFirstToken(
-// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
-node) {
-    return !node.prevToken;
-}

package/lib/ml-dom/node/unexpected-call-error.d.ts

@@ -1,2 +0,0 @@
-export declare class UnexpectedCallError extends Error {
-}

package/lib/ml-dom/node/unexpected-call-error.js

@@ -1,2 +0,0 @@
-export class UnexpectedCallError extends Error {
-}