@markuplint/ml-core 3.0.0-dev.24 → 3.0.0-dev.290

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

@@ -1,6 +1,6 @@
-import type { MLAttr } from './attr';
-import type { RuleConfigValue } from '@markuplint/ml-config';
-export declare class MLNamedNodeMap<T extends RuleConfigValue, O = null> extends Array<MLAttr<T, O>> implements NamedNodeMap {
+import type { MLAttr } from './attr.js';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
+export declare class MLNamedNodeMap<T extends RuleConfigValue, O extends PlainData = undefined> extends Array<MLAttr<T, O>> implements NamedNodeMap {
     getNamedItem(qualifiedName: string): MLAttr<T, O> | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -39,4 +39,4 @@ export declare class MLNamedNodeMap<T extends RuleConfigValue, O = null> extends
      */
     setNamedItemNS(attr: MLAttr<T, O>): MLAttr<T, O> | null;
 }
-export declare function toNamedNodeMap<T extends RuleConfigValue, O = null>(nodes: ReadonlyArray<MLAttr<T, O>>): MLNamedNodeMap<T, O>;
+export declare function toNamedNodeMap<T extends RuleConfigValue, O extends PlainData = undefined>(nodes: ReadonlyArray<MLAttr<T, O>>): MLNamedNodeMap<T, O>;

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

@@ -1,11 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toNamedNodeMap = exports.MLNamedNodeMap = void 0;
-const tslib_1 = require("tslib");
-const unexpected_call_error_1 = tslib_1.__importDefault(require("./unexpected-call-error"));
-class MLNamedNodeMap extends Array {
+import UnexpectedCallError from './unexpected-call-error.js';
+export class MLNamedNodeMap extends Array {
     getNamedItem(qualifiedName) {
-        return this.find(attr => attr.name === qualifiedName) || null;
+        return this.find(attr => attr.name === qualifiedName) ?? null;
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -14,10 +10,10 @@ class MLNamedNodeMap extends Array {
      * @implements DOM API: `NamedNodeMap`
      */
     getNamedItemNS(namespace, localName) {
-        throw new unexpected_call_error_1.default('Not supported "getNamedItemNS" method');
+        throw new UnexpectedCallError('Not supported "getNamedItemNS" method');
     }
     item(index) {
-        return this[index];
+        return this[index] ?? null;
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -26,7 +22,7 @@ class MLNamedNodeMap extends Array {
      * @implements DOM API: `NamedNodeMap`
      */
     removeNamedItem(qualifiedName) {
-        throw new unexpected_call_error_1.default('Not supported "removeNamedItem" method');
+        throw new UnexpectedCallError('Not supported "removeNamedItem" method');
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -35,7 +31,7 @@ class MLNamedNodeMap extends Array {
      * @implements DOM API: `NamedNodeMap`
      */
     removeNamedItemNS(namespace, localName) {
-        throw new unexpected_call_error_1.default('Not supported "removeNamedItemNS" method');
+        throw new UnexpectedCallError('Not supported "removeNamedItemNS" method');
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -43,8 +39,10 @@ class MLNamedNodeMap extends Array {
      * @unsupported
      * @implements DOM API: `NamedNodeMap`
      */
-    setNamedItem(attr) {
-        throw new unexpected_call_error_1.default('Not supported "setNamedItem" method');
+    setNamedItem(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    attr) {
+        throw new UnexpectedCallError('Not supported "setNamedItem" method');
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -52,13 +50,15 @@ class MLNamedNodeMap extends Array {
      * @unsupported
      * @implements DOM API: `NamedNodeMap`
      */
-    setNamedItemNS(attr) {
-        throw new unexpected_call_error_1.default('Not supported "setNamedItemNS" method');
+    setNamedItemNS(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    attr) {
+        throw new UnexpectedCallError('Not supported "setNamedItemNS" method');
     }
 }
-exports.MLNamedNodeMap = MLNamedNodeMap;
-function toNamedNodeMap(nodes) {
+export function toNamedNodeMap(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+nodes) {
     const namedNodeMap = new MLNamedNodeMap(...nodes);
     return namedNodeMap;
 }
-exports.toNamedNodeMap = toNamedNodeMap;

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

@@ -1,6 +1,6 @@
-import type { MLChildNode } from './child-node';
-import type { MLElement } from './element';
-import type { RuleConfigValue } from '@markuplint/ml-config';
-export declare function toNodeList<T extends RuleConfigValue, O, N extends MLChildNode<T, O>>(nodes: ReadonlyArray<N>): NodeListOf<N>;
-export declare function toHTMLCollection<T extends RuleConfigValue, O = null>(nodes: ReadonlyArray<MLElement<T, O>>): HTMLCollectionOf<MLElement<T, O>>;
-export declare function nodeListToHTMLCollection<T extends RuleConfigValue, O = null>(nodeList: NodeListOf<MLChildNode<T, O>>): HTMLCollectionOf<MLElement<T, O>>;
+import type { MLChildNode } from './child-node.js';
+import type { MLElement } from './element.js';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
+export declare function toNodeList<T extends RuleConfigValue, O extends PlainData, N extends MLChildNode<T, O>>(nodes: ReadonlyArray<N>): NodeListOf<N>;
+export declare function toHTMLCollection<T extends RuleConfigValue, O extends PlainData = undefined>(nodes: ReadonlyArray<MLElement<T, O>>): HTMLCollectionOf<MLElement<T, O>>;
+export declare function nodeListToHTMLCollection<T extends RuleConfigValue, O extends PlainData = undefined>(nodeList: NodeListOf<MLChildNode<T, O>>): HTMLCollectionOf<MLElement<T, O>>;

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

@@ -1,33 +1,46 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nodeListToHTMLCollection = exports.toHTMLCollection = exports.toNodeList = void 0;
 class MLNodeList extends Array {
     forEach(callbackfn, thisArg) {
-        return super.forEach.bind(this)((v, k) => callbackfn(v, k, thisArg !== null && thisArg !== void 0 ? thisArg : this));
+        return super.forEach.bind(this)((v, k) => callbackfn(v, k, thisArg ?? this));
     }
     item(index) {
-        return this[index];
+        const node = this[index];
+        if (!node) {
+            /**
+             * ⚠ TYPE CONTRADICTION
+             *
+             * It throws an error because it should return null but the `item` method of `NodeListOf` doesn't return null in the type definition of TypeScript.
+             *
+             * @see https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-844377136
+             *
+             * > item
+             * > Returns the index-th item in the collection. If index is greater than or equal to the number of nodes in the list, this returns null.
+             */
+            throw new ReferenceError('Invalid index');
+        }
+        return node;
     }
 }
-function toNodeList(nodes) {
+export function toNodeList(nodes) {
     const nodeList = new MLNodeList(...nodes);
     return nodeList;
 }
-exports.toNodeList = toNodeList;
 class MLHTMLCollection extends Array {
     item(index) {
-        return this[index];
+        return this[index] ?? null;
     }
     namedItem(name) {
-        return this.find(el => el.getAttribute('name') === name) || null;
+        return this.find(el => el.getAttribute('name') === name) ?? null;
     }
 }
-function toHTMLCollection(nodes) {
+export function toHTMLCollection(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+nodes) {
     const collection = new MLHTMLCollection(...nodes);
     return collection;
 }
-exports.toHTMLCollection = toHTMLCollection;
-function nodeListToHTMLCollection(nodeList) {
+export function nodeListToHTMLCollection(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+nodeList) {
     const collection = new MLHTMLCollection();
     nodeList.forEach(node => {
         if (node.is(node.ELEMENT_NODE)) {
@@ -36,4 +49,3 @@ function nodeListToHTMLCollection(nodeList) {
     });
     return collection;
 }
-exports.nodeListToHTMLCollection = nodeListToHTMLCollection;

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

@@ -1,11 +1,11 @@
-import type { MLNode } from './node';
-import type { MappedNode } from './types';
+import type { MLNode } from './node.js';
+import type { MappedNode } from './types.js';
 import type { MLASTAbstractNode } from '@markuplint/ml-ast';
-import type { RuleConfigValue } from '@markuplint/ml-config';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
 declare class NodeStore {
     #private;
-    getNode<N extends MLASTAbstractNode, T extends RuleConfigValue, O = null>(astNode: N): MappedNode<N, T, O>;
-    setNode<A extends MLASTAbstractNode, T extends RuleConfigValue, O = null>(astNode: A, node: MLNode<T, O, A>): void;
+    getNode<N extends MLASTAbstractNode, T extends RuleConfigValue, O extends PlainData = undefined>(astNode: N): MappedNode<N, T, O>;
+    setNode<A extends MLASTAbstractNode, T extends RuleConfigValue, O extends PlainData = undefined>(astNode: A, node: MLNode<T, O, A>): void;
 }
 /**
  * `NodeStore` Singleton

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

@@ -1,18 +1,23 @@
-"use strict";
 var _NodeStore_store;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nodeStore = void 0;
-const tslib_1 = require("tslib");
-const parser_utils_1 = require("@markuplint/parser-utils");
+import { __classPrivateFieldGet } from "tslib";
+import { TargetParserError } from '@markuplint/parser-utils';
+import { log } from '../../debug.js';
+const nodeStoreLog = log.extend('node-store');
+const nodeStoreError = nodeStoreLog.extend('error');
 class NodeStore {
     constructor() {
         _NodeStore_store.set(this, new Map());
     }
     getNode(astNode) {
         // console.log(`Get: ${astNode.uuid} -> ${astNode.raw.trim()}(${astNode.type})`);
-        const node = tslib_1.__classPrivateFieldGet(this, _NodeStore_store, "f").get(astNode.uuid);
+        const node = __classPrivateFieldGet(this, _NodeStore_store, "f").get(astNode.uuid);
         if (!node) {
-            throw new parser_utils_1.ParserError('Broke mapping nodes.', {
+            nodeStoreError('Ref ID: %s (%s: "%s")', astNode.uuid, astNode.nodeName, astNode.raw);
+            nodeStoreError('Map: %O', Array.from(__classPrivateFieldGet(this, _NodeStore_store, "f").entries()).map(([id, node]) => ({
+                id,
+                name: node.nodeName,
+            })));
+            throw new TargetParserError('Broke mapping nodes.', {
                 line: astNode.startLine,
                 col: astNode.startCol,
                 raw: astNode.raw,
@@ -21,12 +26,22 @@ class NodeStore {
         }
         return node;
     }
-    setNode(astNode, node) {
-        tslib_1.__classPrivateFieldGet(this, _NodeStore_store, "f").set(astNode.uuid, node);
+    setNode(astNode, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    node) {
+        if (node.is(node.DOCUMENT_NODE)) {
+            return;
+        }
+        if (!astNode.uuid) {
+            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.replace(/\n/g, '⏎').replace(/\t/g, '→'));
+        __classPrivateFieldGet(this, _NodeStore_store, "f").set(astNode.uuid, node);
     }
 }
 _NodeStore_store = new WeakMap();
 /**
  * `NodeStore` Singleton
  */
-exports.nodeStore = new NodeStore();
+export const nodeStore = new NodeStore();

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

@@ -1,14 +1,14 @@
-import type { RuleInfo } from '../..';
-import type { MLBlock } from './block';
-import type { MLChildNode } from './child-node';
-import type { MLDocument } from './document';
-import type { MLDocumentFragment } from './document-fragment';
-import type { MLElement } from './element';
-import type { MarkuplintPreprocessorBlockType, NodeType, NodeTypeOf } from './types';
+import type { MLBlock } from './block.js';
+import type { MLChildNode } from './child-node.js';
+import type { MLDocumentFragment } from './document-fragment.js';
+import type { MLDocument } from './document.js';
+import type { MLElement } from './element.js';
+import type { MarkuplintPreprocessorBlockType, NodeType, NodeTypeOf } from './types.js';
+import type { RuleInfo } from '../../index.js';
 import type { MLASTAbstractNode } from '@markuplint/ml-ast';
-import type { AnyRule, RuleConfigValue } from '@markuplint/ml-config';
-import { MLToken } from '../token/token';
-export declare abstract class MLNode<T extends RuleConfigValue, O = null, A extends MLASTAbstractNode = MLASTAbstractNode> extends MLToken<A> implements Node {
+import type { AnyRule, PlainData, RuleConfigValue } from '@markuplint/ml-config';
+import { MLToken } from '../token/token.js';
+export declare abstract class MLNode<T extends RuleConfigValue, O extends PlainData = undefined, A extends MLASTAbstractNode = MLASTAbstractNode> extends MLToken<A> implements Node {
     #private;
     /**
      * @implements DOM API: `Node`
@@ -136,7 +136,7 @@ export declare abstract class MLNode<T extends RuleConfigValue, O = null, A exte
      * @implements DOM API: `Node`
      * @see https://dom.spec.whatwg.org/#ref-for-dom-node-firstchild%E2%91%A0
      */
-    get firstChild(): MLChildNode<T, O>;
+    get firstChild(): MLChildNode<T, O> | null;
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
      *
@@ -152,7 +152,7 @@ export declare abstract class MLNode<T extends RuleConfigValue, O = null, A exte
      * @implements DOM API: `Node`
      * @see https://dom.spec.whatwg.org/#ref-for-dom-node-lastchild%E2%91%A0
      */
-    get lastChild(): MLChildNode<T, O>;
+    get lastChild(): MLChildNode<T, O> | null;
     /**
      * @implements `@markuplint/ml-core` API: `MLNode`
      */