@markuplint/ml-core 3.3.0 → 3.4.0

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;
+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;
 }
-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 = null>(
+	nodes: ReadonlyArray<MLAttr<T, O>>,
+): MLNamedNodeMap<T, O>;

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

@@ -17,7 +17,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.**

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, 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>>;
+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>>;

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,7 +30,8 @@ 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;

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

@@ -3,9 +3,9 @@ import type { MappedNode } from './types';
 import type { MLASTAbstractNode } from '@markuplint/ml-ast';
 import type { 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;
+	#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;
 }
 /**
  * `NodeStore` Singleton