@markuplint/ml-core 3.0.0-alpha.66 → 3.0.0-dev.176

package/README.md

@@ -1,13 +1,22 @@
 # @markuplint/ml-core
 
 [![npm version](https://badge.fury.io/js/%40markuplint%2Fml-core.svg)](https://www.npmjs.com/package/@markuplint/ml-core)
-[![Build Status](https://travis-ci.org/markuplint/markuplint.svg?branch=main)](https://travis-ci.org/markuplint/markuplint)
-[![Coverage Status](https://coveralls.io/repos/github/markuplint/markuplint/badge.svg?branch=main)](https://coveralls.io/github/markuplint/markuplint?branch=main)
+
+## Documentation
+
+- [API Document](https://markuplint.dev/api-docs)
 
 ## Install
 
-```sh
+[`markuplint`](https://www.npmjs.com/package/markuplint) package includes this package.
+
+<details>
+<summary>If you are installing purposely, how below:</summary>
+
+```shell
 $ npm install @markuplint/ml-core
 
 $ yarn add @markuplint/ml-core
 ```
+
+</details>

package/lib/configs.browser.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from '@markuplint/ml-config';
+export declare function getPreset(name: string): Promise<Config>;

package/lib/configs.browser.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPreset = void 0;
+async function getPreset(name) {
+    const res = await fetch(`@markuplint/config-presets/preset.${name}.json`).catch(() => new Error());
+    if (res instanceof Error) {
+        throw new ReferenceError(`Preset markuplint:${name} is not found`);
+    }
+    const json = await res.json();
+    return json;
+}
+exports.getPreset = getPreset;

package/lib/configs.js

@@ -25,7 +25,10 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPreset = void 0;
 async function getPreset(name) {
-    const json = await Promise.resolve().then(() => __importStar(require(`@markuplint/config-presets/${name}.json`)));
+    const json = await Promise.resolve(`${`@markuplint/config-presets/preset.${name}.json`}`).then(s => __importStar(require(s))).catch(() => new Error());
+    if (json instanceof Error) {
+        throw new ReferenceError(`Preset markuplint:${name} is not found`);
+    }
     return json.default;
 }
 exports.getPreset = getPreset;

package/lib/index.d.ts

@@ -1,5 +1,15 @@
 export { RuleInfo, RuleConfig, RuleConfigValue } from '@markuplint/ml-config';
-export { ariaSpecs, contentModelCategoryToTagNames, getAttrSpecs, getComputedRole, getImplicitRole, getPermittedRoles, getRoleSpec, getSpec, resolveNamespace, } from '@markuplint/ml-spec';
+export {
+	ariaSpecs,
+	contentModelCategoryToTagNames,
+	getAttrSpecs,
+	getComputedRole,
+	getImplicitRole,
+	getPermittedRoles,
+	getRoleSpec,
+	getSpec,
+	resolveNamespace,
+} from '@markuplint/ml-spec';
 export { default as Ruleset } from './ruleset';
 export { enableDebug } from './debug';
 export { getIndent } from './ml-dom/helper/getIndent';

package/lib/ml-core.d.ts

@@ -1,19 +1,30 @@
 import type { MLFabric } from './types';
-import type { RuleConfigValue, Violation } from '@markuplint/ml-config';
+import type { PlainData, RuleConfigValue, Violation } from '@markuplint/ml-config';
 import { ParserError } from '@markuplint/parser-utils';
 import { Document } from './ml-dom';
-export declare type MLCoreParams = {
-    sourceCode: string;
-    filename: string;
-    debug?: boolean;
+export type MLCoreParams = {
+	readonly sourceCode: string;
+	readonly filename: string;
+	readonly debug?: boolean;
 } & MLFabric;
 export declare class MLCore {
-    #private;
-    get document(): ParserError | Document<RuleConfigValue, unknown>;
-    constructor({ parser, sourceCode, ruleset, rules, locale, schemas, parserOptions, filename, debug }: MLCoreParams);
-    setCode(sourceCode: string): void;
-    update({ parser, ruleset, rules, locale, schemas, parserOptions }: Partial<MLFabric>): void;
-    verify(fix?: boolean): Promise<Violation[]>;
-    private _createDocument;
-    private _parse;
+	#private;
+	constructor({
+		parser,
+		sourceCode,
+		ruleset,
+		rules,
+		locale,
+		schemas,
+		parserOptions,
+		pretenders,
+		filename,
+		debug,
+	}: MLCoreParams);
+	get document(): ParserError | Document<RuleConfigValue, PlainData>;
+	setCode(sourceCode: string): void;
+	update({ parser, ruleset, rules, locale, schemas, parserOptions }: Partial<MLFabric>): void;
+	verify(fix?: boolean): Promise<Violation[]>;
+	private _createDocument;
+	private _parse;
 }

package/lib/ml-core.js

@@ -1,5 +1,5 @@
 "use strict";
-var _MLCore_ast, _MLCore_document, _MLCore_filename, _MLCore_ignoreFrontMatter, _MLCore_locale, _MLCore_parser, _MLCore_rules, _MLCore_ruleset, _MLCore_schemas, _MLCore_sourceCode;
+var _MLCore_ast, _MLCore_document, _MLCore_filename, _MLCore_locale, _MLCore_parser, _MLCore_parserOptions, _MLCore_pretenders, _MLCore_rules, _MLCore_ruleset, _MLCore_schemas, _MLCore_sourceCode;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MLCore = void 0;
 const tslib_1 = require("tslib");
@@ -8,14 +8,15 @@ const debug_1 = require("./debug");
 const ml_dom_1 = require("./ml-dom");
 const resultLog = debug_1.log.extend('result');
 class MLCore {
-    constructor({ parser, sourceCode, ruleset, rules, locale, schemas, parserOptions, filename, debug }) {
+    constructor({ parser, sourceCode, ruleset, rules, locale, schemas, parserOptions, pretenders, filename, debug, }) {
         var _a, _b, _c;
         _MLCore_ast.set(this, null);
         _MLCore_document.set(this, void 0);
         _MLCore_filename.set(this, void 0);
-        _MLCore_ignoreFrontMatter.set(this, void 0);
         _MLCore_locale.set(this, void 0);
         _MLCore_parser.set(this, void 0);
+        _MLCore_parserOptions.set(this, void 0);
+        _MLCore_pretenders.set(this, void 0);
         _MLCore_rules.set(this, void 0);
         _MLCore_ruleset.set(this, void 0);
         _MLCore_schemas.set(this, void 0);
@@ -25,7 +26,7 @@ class MLCore {
         }
         tslib_1.__classPrivateFieldSet(this, _MLCore_parser, parser, "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_sourceCode, sourceCode, "f");
-        tslib_1.__classPrivateFieldSet(this, _MLCore_ignoreFrontMatter, !!parserOptions.ignoreFrontMatter, "f");
+        tslib_1.__classPrivateFieldSet(this, _MLCore_parserOptions, parserOptions, "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_ruleset, {
             rules: (_a = ruleset.rules) !== null && _a !== void 0 ? _a : {},
             nodeRules: (_b = ruleset.nodeRules) !== null && _b !== void 0 ? _b : [],
@@ -34,7 +35,8 @@ class MLCore {
         tslib_1.__classPrivateFieldSet(this, _MLCore_locale, locale, "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_schemas, schemas, "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_filename, filename, "f");
-        tslib_1.__classPrivateFieldSet(this, _MLCore_rules, rules, "f");
+        tslib_1.__classPrivateFieldSet(this, _MLCore_rules, rules.slice(), "f");
+        tslib_1.__classPrivateFieldSet(this, _MLCore_pretenders, pretenders.slice(), "f");
         this._parse();
         this._createDocument();
     }
@@ -47,17 +49,19 @@ class MLCore {
         this._createDocument();
     }
     update({ parser, ruleset, rules, locale, schemas, parserOptions }) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         tslib_1.__classPrivateFieldSet(this, _MLCore_parser, parser !== null && parser !== void 0 ? parser : tslib_1.__classPrivateFieldGet(this, _MLCore_parser, "f"), "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_ruleset, {
             rules: (_a = ruleset === null || ruleset === void 0 ? void 0 : ruleset.rules) !== null && _a !== void 0 ? _a : tslib_1.__classPrivateFieldGet(this, _MLCore_ruleset, "f").rules,
             nodeRules: (_b = ruleset === null || ruleset === void 0 ? void 0 : ruleset.nodeRules) !== null && _b !== void 0 ? _b : tslib_1.__classPrivateFieldGet(this, _MLCore_ruleset, "f").nodeRules,
             childNodeRules: (_c = ruleset === null || ruleset === void 0 ? void 0 : ruleset.childNodeRules) !== null && _c !== void 0 ? _c : tslib_1.__classPrivateFieldGet(this, _MLCore_ruleset, "f").childNodeRules,
         }, "f");
-        tslib_1.__classPrivateFieldSet(this, _MLCore_rules, rules !== null && rules !== void 0 ? rules : tslib_1.__classPrivateFieldGet(this, _MLCore_rules, "f"), "f");
+        tslib_1.__classPrivateFieldSet(this, _MLCore_rules, (_d = rules === null || rules === void 0 ? void 0 : rules.slice()) !== null && _d !== void 0 ? _d : tslib_1.__classPrivateFieldGet(this, _MLCore_rules, "f"), "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_locale, locale !== null && locale !== void 0 ? locale : tslib_1.__classPrivateFieldGet(this, _MLCore_locale, "f"), "f");
         tslib_1.__classPrivateFieldSet(this, _MLCore_schemas, schemas !== null && schemas !== void 0 ? schemas : tslib_1.__classPrivateFieldGet(this, _MLCore_schemas, "f"), "f");
-        if (parserOptions && parserOptions.ignoreFrontMatter !== tslib_1.__classPrivateFieldGet(this, _MLCore_ignoreFrontMatter, "f")) {
+        if (parserOptions &&
+            (parserOptions.ignoreFrontMatter !== tslib_1.__classPrivateFieldGet(this, _MLCore_parserOptions, "f").ignoreFrontMatter ||
+                parserOptions.authoredElementName !== tslib_1.__classPrivateFieldGet(this, _MLCore_parserOptions, "f").authoredElementName)) {
             this._parse();
         }
         this._createDocument();
@@ -130,6 +134,8 @@ class MLCore {
             tslib_1.__classPrivateFieldSet(this, _MLCore_document, new ml_dom_1.Document(tslib_1.__classPrivateFieldGet(this, _MLCore_ast, "f"), tslib_1.__classPrivateFieldGet(this, _MLCore_ruleset, "f"), tslib_1.__classPrivateFieldGet(this, _MLCore_schemas, "f"), {
                 filename: tslib_1.__classPrivateFieldGet(this, _MLCore_filename, "f"),
                 endTag: tslib_1.__classPrivateFieldGet(this, _MLCore_parser, "f").endTag,
+                booleanish: tslib_1.__classPrivateFieldGet(this, _MLCore_parser, "f").booleanish,
+                pretenders: tslib_1.__classPrivateFieldGet(this, _MLCore_pretenders, "f"),
             }), "f");
         }
         catch (err) {
@@ -143,7 +149,7 @@ class MLCore {
     }
     _parse() {
         try {
-            tslib_1.__classPrivateFieldSet(this, _MLCore_ast, tslib_1.__classPrivateFieldGet(this, _MLCore_parser, "f").parse(tslib_1.__classPrivateFieldGet(this, _MLCore_sourceCode, "f"), 0, 0, 0, tslib_1.__classPrivateFieldGet(this, _MLCore_ignoreFrontMatter, "f")), "f");
+            tslib_1.__classPrivateFieldSet(this, _MLCore_ast, tslib_1.__classPrivateFieldGet(this, _MLCore_parser, "f").parse(tslib_1.__classPrivateFieldGet(this, _MLCore_sourceCode, "f"), tslib_1.__classPrivateFieldGet(this, _MLCore_parserOptions, "f")), "f");
         }
         catch (err) {
             (0, debug_1.log)('Caught the parse error: %O', err);
@@ -158,4 +164,4 @@ class MLCore {
     }
 }
 exports.MLCore = MLCore;
-_MLCore_ast = new WeakMap(), _MLCore_document = new WeakMap(), _MLCore_filename = new WeakMap(), _MLCore_ignoreFrontMatter = new WeakMap(), _MLCore_locale = new WeakMap(), _MLCore_parser = new WeakMap(), _MLCore_rules = new WeakMap(), _MLCore_ruleset = new WeakMap(), _MLCore_schemas = new WeakMap(), _MLCore_sourceCode = new WeakMap();
+_MLCore_ast = new WeakMap(), _MLCore_document = new WeakMap(), _MLCore_filename = new WeakMap(), _MLCore_locale = new WeakMap(), _MLCore_parser = new WeakMap(), _MLCore_parserOptions = new WeakMap(), _MLCore_pretenders = new WeakMap(), _MLCore_rules = new WeakMap(), _MLCore_ruleset = new WeakMap(), _MLCore_schemas = new WeakMap(), _MLCore_sourceCode = new WeakMap();

package/lib/ml-dom/helper/accname.d.ts

@@ -1,2 +1,3 @@
 import type { MLElement } from '../node/element';
-export declare function getAccname(el: MLElement<any, any>): string;
+import type { ARIAVersion } from '@markuplint/ml-spec';
+export declare function getAccname(el: MLElement<any, any>, version: ARIAVersion): string;

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

@@ -4,7 +4,40 @@ exports.getAccname = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
 const debug_1 = require("../../debug");
 const accnameLog = debug_1.log.extend('accname');
-function getAccname(el) {
+function getAccname(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version) {
+    let accname = safeGet(el);
+    if (accname) {
+        return accname;
+    }
+    accname = getAccnameFromPretender(el);
+    if (accname) {
+        return accname;
+    }
+    if (isHidden(el)) {
+        return '';
+    }
+    if (isFromContent(el, version)) {
+        return Array.from(el.childNodes)
+            .map(child => {
+            var _a;
+            if (child.is(child.ELEMENT_NODE)) {
+                return getAccname(child, version);
+            }
+            if (child.is(child.TEXT_NODE)) {
+                return (_a = child.textContent) !== null && _a !== void 0 ? _a : '';
+            }
+            return '';
+        })
+            .join('');
+    }
+    return '';
+}
+exports.getAccname = getAccname;
+function safeGet(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
     try {
         const name = (0, ml_spec_1.getAccname)(el);
         return name;
@@ -15,4 +48,31 @@ function getAccname(el) {
         return '';
     }
 }
-exports.getAccname = getAccname;
+function getAccnameFromPretender(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    var _a, _b;
+    if (((_a = el.pretenderContext) === null || _a === void 0 ? void 0 : _a.type) === 'pretender' && ((_b = el.pretenderContext.aria) === null || _b === void 0 ? void 0 : _b.name) != null) {
+        if (typeof el.pretenderContext.aria.name === 'boolean') {
+            return 'some-name(Pretender Options)';
+        }
+        const attrName = el.pretenderContext.aria.name.fromAttr;
+        const attrValue = el.getAttributePretended(attrName);
+        if (attrValue) {
+            return attrValue;
+        }
+    }
+    return '';
+}
+function isHidden(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el) {
+    return el.getAttribute('aria-hidden') === 'true' || el.hasAttribute('hidden');
+}
+function isFromContent(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, version) {
+    var _a;
+    const role = (0, ml_spec_1.getComputedRole)(el.ownerMLDocument.specs, el, version);
+    return !!((_a = role.role) === null || _a === void 0 ? void 0 : _a.accessibleNameFromContent);
+}

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

@@ -1,5 +1,9 @@
 import type { MLDocument } from '../node/document';
 import type { MappedNode } from '../node/types';
-import type { MLASTAbstructNode } from '@markuplint/ml-ast';
-import type { RuleConfigValue } from '@markuplint/ml-config';
-export declare function createNode<N extends MLASTAbstructNode, T extends RuleConfigValue, O = null>(astNode: N, document: MLDocument<T, O>): MappedNode<N, T, O>;
+import type { MLASTAbstractNode } from '@markuplint/ml-ast';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
+export declare function createNode<
+	N extends MLASTAbstractNode,
+	T extends RuleConfigValue,
+	O extends PlainData = undefined,
+>(astNode: N, document: MLDocument<T, O>): MappedNode<N, T, O>;

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

@@ -6,7 +6,9 @@ const comment_1 = require("../node/comment");
 const document_type_1 = require("../node/document-type");
 const element_1 = require("../node/element");
 const text_1 = require("../node/text");
-function createNode(astNode, document) {
+function createNode(astNode, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+document) {
     const _astNode = astNode;
     switch (_astNode.type) {
         case 'doctype': {
@@ -25,6 +27,6 @@ function createNode(astNode, document) {
             return new text_1.MLText(_astNode, document);
         }
     }
-    throw new TypeError(`Invalid AST node typs "${astNode.type}"`);
+    throw new TypeError(`Invalid AST node types "${astNode.type}"`);
 }
 exports.createNode = createNode;

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

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nodeListToDebugMaps = void 0;
-function nodeListToDebugMaps(nodeList, withAttr = false) {
+function nodeListToDebugMaps(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+nodeList, withAttr = false) {
     return nodeList
         .map(n => {
         const r = [];
@@ -12,9 +14,9 @@ function nodeListToDebugMaps(nodeList, withAttr = false) {
         r.push(tokenDebug(n));
         if (n.is(n.ELEMENT_NODE)) {
             r.push(`  namespaceURI: ${!!n.namespaceURI}`);
-            r.push(`  isInFragmentDocument: ${!!n.isInFragmentDocument}`);
+            r.push(`  elementType: ${n.elementType}`);
+            r.push(`  isInFragmentDocument: ${n.isInFragmentDocument()}`);
             r.push(`  isForeignElement: ${!!n.isForeignElement}`);
-            r.push(`  isCustomElement: ${!!n.isCustomElement}`);
             if (withAttr) {
                 r.push(...attributesToDebugMaps(n.attributes)
                     .flat()
@@ -26,7 +28,9 @@ function nodeListToDebugMaps(nodeList, withAttr = false) {
         .flat();
 }
 exports.nodeListToDebugMaps = nodeListToDebugMaps;
-function attributesToDebugMaps(attributes) {
+function attributesToDebugMaps(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+attributes) {
     return attributes
         .map(n => {
         const r = [
@@ -77,7 +81,8 @@ function attributesToDebugMaps(attributes) {
         .flat();
 }
 function tokenDebug(n, type = '') {
-    return `[${n.startLine}:${n.startCol}]>[${n.endLine}:${n.endCol}](${n.startOffset},${n.endOffset})${n.nodeName || n.potentialName || n.name || n.type || type}: ${visibleWhiteSpace(n.raw)}`;
+    var _a, _b, _c, _d;
+    return `[${n.startLine}:${n.startCol}]>[${n.endLine}:${n.endCol}](${n.startOffset},${n.endOffset})${(_d = (_c = (_b = (_a = n.nodeName) !== null && _a !== void 0 ? _a : n.potentialName) !== null && _b !== void 0 ? _b : n.name) !== null && _c !== void 0 ? _c : n.type) !== null && _d !== void 0 ? _d : type}: ${visibleWhiteSpace(n.raw)}`;
 }
 function visibleWhiteSpace(chars) {
     return chars.replace(/\n/g, '⏎').replace(/\t/g, '→').replace(/\s/g, '␣');

package/lib/ml-dom/helper/getIndent.d.ts

@@ -7,12 +7,12 @@ import type { MLText } from '../node/text';
  */
 export declare function getIndent(node: MLNode<any, any>): MLDOMIndentation | null;
 declare class MLDOMIndentation {
-    #private;
-    readonly line: number;
-    get raw(): string;
-    get type(): 'tab' | 'space' | 'mixed' | 'none';
-    get width(): number;
-    constructor(originTextNode: MLText<any, any>, raw: string, line: number, parentNode: MLNode<any, any>);
-    fix(raw: string): void;
+	#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;
+	fix(raw: string): void;
 }
 export {};

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

@@ -8,7 +8,9 @@ const tslib_1 = require("tslib");
  * @deprecated
  * @param node
  */
-function getIndent(node) {
+function getIndent(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+node) {
     const prevToken = node.prevToken;
     if (!prevToken) {
         return null;
@@ -51,7 +53,11 @@ function getIndent(node) {
 }
 exports.getIndent = getIndent;
 class MLDOMIndentation {
-    constructor(originTextNode, raw, line, parentNode) {
+    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) {
         _MLDOMIndentation_fixed.set(this, void 0);
         _MLDOMIndentation_node.set(this, void 0);
         _MLDOMIndentation_parent.set(this, void 0);
@@ -82,19 +88,19 @@ class MLDOMIndentation {
     fix(raw) {
         const current = tslib_1.__classPrivateFieldGet(this, _MLDOMIndentation_fixed, "f");
         tslib_1.__classPrivateFieldSet(this, _MLDOMIndentation_fixed, raw, "f");
-        if (tslib_1.__classPrivateFieldGet(this, _MLDOMIndentation_node, "f")) {
-            const node = tslib_1.__classPrivateFieldGet(this, _MLDOMIndentation_node, "f");
-            const line = node.startLine;
-            const lines = node.raw.split(/\r?\n/);
-            const index = this.line - line;
-            if (lines[index] != null) {
-                lines[index] = lines[index].replace(current, tslib_1.__classPrivateFieldGet(this, _MLDOMIndentation_fixed, "f"));
-            }
-            node.fix(lines.join('\n'));
+        const node = tslib_1.__classPrivateFieldGet(this, _MLDOMIndentation_node, "f");
+        const line = node.startLine;
+        const lines = node.raw.split(/\r?\n/);
+        const index = this.line - line;
+        if (lines[index] != null) {
+            lines[index] = lines[index].replace(current, tslib_1.__classPrivateFieldGet(this, _MLDOMIndentation_fixed, "f"));
         }
+        node.fix(lines.join('\n'));
     }
 }
 _MLDOMIndentation_fixed = new WeakMap(), _MLDOMIndentation_node = new WeakMap(), _MLDOMIndentation_parent = new WeakMap();
-function isFirstToken(node) {
+function isFirstToken(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+node) {
     return !node.prevToken;
 }

package/lib/ml-dom/helper/walkers.d.ts

@@ -1,6 +1,16 @@
 import type { MLNode } from '../node/node';
-import type { RuleConfigValue } from '@markuplint/ml-config';
-export declare type Walker<T extends RuleConfigValue, O = null, N = MLNode<T, O>> = (node: N) => void | Promise<void> | Promise<void>[];
-export declare type SyncWalker<T extends RuleConfigValue, O = null, N = MLNode<T, O>> = (node: N) => void;
-export declare function syncWalk<T extends RuleConfigValue, O = null>(nodeList: ReadonlyArray<MLNode<T, O>>, walker: SyncWalker<T, O>): void;
-export declare function sequentialWalker<T extends RuleConfigValue, O = null, N = MLNode<T, O>>(list: ReadonlyArray<N>, walker: Walker<T, O, N>): Promise<void>;
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
+export type Walker<T extends RuleConfigValue, O extends PlainData = undefined, N = MLNode<T, O>> = (
+	node: N,
+) => void | Promise<void> | Promise<void>[];
+export type SyncWalker<T extends RuleConfigValue, O extends PlainData = undefined, N = MLNode<T, O>> = (
+	node: N,
+) => void;
+export declare function syncWalk<T extends RuleConfigValue, O extends PlainData = undefined>(
+	nodeList: ReadonlyArray<MLNode<T, O>>,
+	walker: SyncWalker<T, O>,
+): void;
+export declare function sequentialWalker<T extends RuleConfigValue, O extends PlainData = undefined, N = MLNode<T, O>>(
+	list: ReadonlyArray<N>,
+	walker: Walker<T, O, N>,
+): Promise<void>;

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

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sequentialWalker = exports.syncWalk = void 0;
-function syncWalk(nodeList, walker) {
+function syncWalk(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+nodeList, walker) {
     for (const node of nodeList) {
         if (node.is(node.ELEMENT_NODE) || node.is(node.MARKUPLINT_PREPROCESSOR_BLOCK)) {
             syncWalk(Array.from(node.childNodes), walker);
@@ -25,21 +27,25 @@ function sequentialWalker(list, walker) {
         _reject = reject;
     });
     const loop = (index = 0) => {
-        if (index >= list.length) {
-            _resolve();
-            return;
-        }
-        const node = list[index];
-        if (!node) {
-            _resolve();
-            return;
-        }
-        const result = walker(node);
-        if (result instanceof Promise) {
-            result.then(() => loop(index + 1)).catch(_reject);
-        }
-        else {
-            loop(index + 1);
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            if (index >= list.length) {
+                _resolve();
+                return;
+            }
+            const node = list[index];
+            if (node == null) {
+                _resolve();
+                return;
+            }
+            const result = walker(node);
+            if (result instanceof Promise) {
+                result.then(() => loop(index + 1)).catch(_reject);
+                return;
+            }
+            else {
+                index = index + 1;
+            }
         }
     };
     loop();

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

@@ -5,4 +5,5 @@ export type { MLDocumentFragment as DocumentFragment } from './node/document-fra
 export type { MLDocumentType as DocumentType } from './node/document-type';
 export type { MLElement as Element } from './node/element';
 export type { MLText as Text } from './node/text';
+export type { MLChildNode as ChildNode } from './node/child-node';
 export { MLDocument as Document } from './node/document';

package/lib/ml-dom/manipulations/child-node-methods.d.ts

@@ -1,33 +1,46 @@
 import type { MLElement } from '../node/element';
 import type { MLNode } from '../node/node';
-import type { RuleConfigValue } from '@markuplint/ml-config';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-childnode-before%E2%91%A0
  */
-export declare function before<T extends RuleConfigValue, O = null>(node: MLNode<T, O>, ...additionalNodes: ReadonlyArray<MLNode<T, O> | string>): void;
+export declare function before<T extends RuleConfigValue, O extends PlainData = undefined>(
+	node: MLNode<T, O>,
+	...additionalNodes: ReadonlyArray<MLNode<T, O> | string>
+): void;
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-childnode-after%E2%91%A0
  */
-export declare function after<T extends RuleConfigValue, O = null>(node: MLNode<T, O>, ...additionalNodes: ReadonlyArray<MLNode<T, O> | string>): void;
+export declare function after<T extends RuleConfigValue, O extends PlainData = undefined>(
+	node: MLNode<T, O>,
+	...additionalNodes: ReadonlyArray<MLNode<T, O> | string>
+): void;
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-childnode-replacewith%E2%91%A0
  */
-export declare function replaceWith<T extends RuleConfigValue, O = null>(node: MLNode<T, O>, ...additionalNodes: ReadonlyArray<MLNode<T, O> | string>): void;
+export declare function replaceWith<T extends RuleConfigValue, O extends PlainData = undefined>(
+	node: MLNode<T, O>,
+	...additionalNodes: ReadonlyArray<MLNode<T, O> | string>
+): void;
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-childnode-remove%E2%91%A0
  */
-export declare function remove<T extends RuleConfigValue, O = null>(node: MLNode<T, O>): void;
+export declare function remove<T extends RuleConfigValue, O extends PlainData = undefined>(node: MLNode<T, O>): void;
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-nondocumenttypechildnode-previouselementsibling%E2%91%A0
  */
-export declare function previousElementSibling<T extends RuleConfigValue, O = null>(node: MLNode<T, O>): MLElement<T, O> | null;
+export declare function previousElementSibling<T extends RuleConfigValue, O extends PlainData = undefined>(
+	node: MLNode<T, O>,
+): MLElement<T, O> | null;
 /**
  *
  * @see https://dom.spec.whatwg.org/#ref-for-dom-nondocumenttypechildnode-nextelementsibling%E2%91%A0
  */
-export declare function nextElementSibling<T extends RuleConfigValue, O = null>(node: MLNode<T, O>): MLElement<T, O> | null;
+export declare function nextElementSibling<T extends RuleConfigValue, O extends PlainData = undefined>(
+	node: MLNode<T, O>,
+): MLElement<T, O> | null;