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

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

@@ -1,42 +1,47 @@
 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 {
-    getNamedItem(qualifiedName: string): MLAttr<T, O> | null;
-    /**
-     * **IT THROWS AN ERROR WHEN CALLING THIS.**
-     *
-     * @unsupported
-     * @implements DOM API: `NamedNodeMap`
-     */
-    getNamedItemNS(namespace: string | null, localName: string): Attr | null;
-    item(index: number): MLAttr<T, O> | null;
-    /**
-     * **IT THROWS AN ERROR WHEN CALLING THIS.**
-     *
-     * @unsupported
-     * @implements DOM API: `NamedNodeMap`
-     */
-    removeNamedItem(qualifiedName: string): MLAttr<T, O>;
-    /**
-     * **IT THROWS AN ERROR WHEN CALLING THIS.**
-     *
-     * @unsupported
-     * @implements DOM API: `NamedNodeMap`
-     */
-    removeNamedItemNS(namespace: string | null, localName: string): MLAttr<T, O>;
-    /**
-     * **IT THROWS AN ERROR WHEN CALLING THIS.**
-     *
-     * @unsupported
-     * @implements DOM API: `NamedNodeMap`
-     */
-    setNamedItem(attr: MLAttr<T, O>): MLAttr<T, O> | null;
-    /**
-     * **IT THROWS AN ERROR WHEN CALLING THIS.**
-     *
-     * @unsupported
-     * @implements DOM API: `NamedNodeMap`
-     */
-    setNamedItemNS(attr: MLAttr<T, O>): MLAttr<T, O> | null;
+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.**
+	 *
+	 * @unsupported
+	 * @implements DOM API: `NamedNodeMap`
+	 */
+	getNamedItemNS(namespace: string | null, localName: string): Attr | null;
+	item(index: number): MLAttr<T, O> | null;
+	/**
+	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
+	 *
+	 * @unsupported
+	 * @implements DOM API: `NamedNodeMap`
+	 */
+	removeNamedItem(qualifiedName: string): MLAttr<T, O>;
+	/**
+	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
+	 *
+	 * @unsupported
+	 * @implements DOM API: `NamedNodeMap`
+	 */
+	removeNamedItemNS(namespace: string | null, localName: string): MLAttr<T, O>;
+	/**
+	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
+	 *
+	 * @unsupported
+	 * @implements DOM API: `NamedNodeMap`
+	 */
+	setNamedItem(attr: MLAttr<T, O>): MLAttr<T, O> | null;
+	/**
+	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
+	 *
+	 * @unsupported
+	 * @implements DOM API: `NamedNodeMap`
+	 */
+	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

@@ -5,7 +5,8 @@ const tslib_1 = require("tslib");
 const unexpected_call_error_1 = tslib_1.__importDefault(require("./unexpected-call-error"));
 class MLNamedNodeMap extends Array {
     getNamedItem(qualifiedName) {
-        return this.find(attr => attr.name === qualifiedName) || null;
+        var _a;
+        return (_a = this.find(attr => attr.name === qualifiedName)) !== null && _a !== void 0 ? _a : null;
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -17,7 +18,8 @@ class MLNamedNodeMap extends Array {
         throw new unexpected_call_error_1.default('Not supported "getNamedItemNS" method');
     }
     item(index) {
-        return this[index];
+        var _a;
+        return (_a = this[index]) !== null && _a !== void 0 ? _a : null;
     }
     /**
      * **IT THROWS AN ERROR WHEN CALLING THIS.**
@@ -43,7 +45,9 @@ class MLNamedNodeMap extends Array {
      * @unsupported
      * @implements DOM API: `NamedNodeMap`
      */
-    setNamedItem(attr) {
+    setNamedItem(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    attr) {
         throw new unexpected_call_error_1.default('Not supported "setNamedItem" method');
     }
     /**
@@ -52,12 +56,16 @@ class MLNamedNodeMap extends Array {
      * @unsupported
      * @implements DOM API: `NamedNodeMap`
      */
-    setNamedItemNS(attr) {
+    setNamedItemNS(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    attr) {
         throw new unexpected_call_error_1.default('Not supported "setNamedItemNS" method');
     }
 }
 exports.MLNamedNodeMap = MLNamedNodeMap;
-function toNamedNodeMap(nodes) {
+function toNamedNodeMap(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+nodes) {
     const namedNodeMap = new MLNamedNodeMap(...nodes);
     return namedNodeMap;
 }

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

@@ -1,6 +1,12 @@
 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 extends Object | null, 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 { 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

@@ -6,7 +6,21 @@ class MLNodeList extends Array {
         return super.forEach.bind(this)((v, k) => callbackfn(v, k, thisArg !== null && thisArg !== void 0 ? 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) {
@@ -16,18 +30,24 @@ function toNodeList(nodes) {
 exports.toNodeList = toNodeList;
 class MLHTMLCollection extends Array {
     item(index) {
-        return this[index];
+        var _a;
+        return (_a = this[index]) !== null && _a !== void 0 ? _a : null;
     }
     namedItem(name) {
-        return this.find(el => el.getAttribute('name') === name) || null;
+        var _a;
+        return (_a = this.find(el => el.getAttribute('name') === name)) !== null && _a !== void 0 ? _a : null;
     }
 }
-function toHTMLCollection(nodes) {
+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) {
+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)) {

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

@@ -1,11 +1,16 @@
 import type { MLNode } from './node';
 import type { MappedNode } from './types';
-import type { MLASTAbstructNode } from '@markuplint/ml-ast';
-import type { RuleConfigValue } from '@markuplint/ml-config';
+import type { MLASTAbstractNode } from '@markuplint/ml-ast';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
 declare class NodeStore {
-    #private;
-    getNode<N extends MLASTAbstructNode, T extends RuleConfigValue, O = null>(astNode: N): MappedNode<N, T, O>;
-    setNode<A extends MLASTAbstructNode, T extends RuleConfigValue, O = null>(astNode: A, node: MLNode<T, O, A>): void;
+	#private;
+	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

@@ -4,6 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.nodeStore = void 0;
 const tslib_1 = require("tslib");
 const parser_utils_1 = require("@markuplint/parser-utils");
+const debug_1 = require("../../debug");
+const nodeStoreLog = debug_1.log.extend('node-store');
+const nodeStoreError = nodeStoreLog.extend('error');
 class NodeStore {
     constructor() {
         _NodeStore_store.set(this, new Map());
@@ -12,6 +15,11 @@ class NodeStore {
         // console.log(`Get: ${astNode.uuid} -> ${astNode.raw.trim()}(${astNode.type})`);
         const node = tslib_1.__classPrivateFieldGet(this, _NodeStore_store, "f").get(astNode.uuid);
         if (!node) {
+            nodeStoreError('Ref ID: %s (%s: "%s")', astNode.uuid, astNode.nodeName, astNode.raw);
+            nodeStoreError('Map: %O', Array.from(tslib_1.__classPrivateFieldGet(this, _NodeStore_store, "f").entries()).map(([id, node]) => ({
+                id,
+                name: node.nodeName,
+            })));
             throw new parser_utils_1.ParserError('Broke mapping nodes.', {
                 line: astNode.startLine,
                 col: astNode.startCol,
@@ -21,7 +29,17 @@ class NodeStore {
         }
         return node;
     }
-    setNode(astNode, 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, '→'));
         tslib_1.__classPrivateFieldGet(this, _NodeStore_store, "f").set(astNode.uuid, node);
     }
 }