@markuplint/parser-utils 5.0.0-rc.0 → 5.0.0-rc.1

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 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.1](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.0...v5.0.0-rc.1) (2026-03-27)
+
+**Note:** Version bump only for package @markuplint/parser-utils
+
 # [5.0.0-rc.0](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.3...v5.0.0-rc.0) (2026-03-12)
 
 **Note:** Version bump only for package @markuplint/parser-utils

package/lib/debugger.js

@@ -70,7 +70,7 @@ export function nodeTreeDebugView(nodeTree, idFilter = false) {
             return;
         }
         lines.push(`${i.toString().padStart(3, '0')}: [${filter(n.uuid)}] ${'  '.repeat(Math.max(n.depth, 0))}${n.type === 'endtag' ? '/' : ''}${n.nodeName}(${filter(n.uuid)})${n.type === 'starttag' && n.isGhost ? '[👻]' : ''}${n.type === 'starttag'
-            ? ` => ${n.pairNode ? `/${n.pairNode.nodeName}(${filter(n.pairNode.uuid)})` : '💀'}`
+            ? ` => ${n.pairNodeUuid ? `/${nodeTree.find(p => p.uuid === n.pairNodeUuid)?.nodeName ?? '?'}(${filter(n.pairNodeUuid)})` : '💀'}`
             : ''}`);
         if (n.type === 'starttag' || n.type === 'psblock') {
             for (const c of n.childNodes ?? []) {

package/lib/get-namespace.js

@@ -34,5 +34,5 @@ function getParentNamespace(parentNode) {
                     ? 'http://www.w3.org/1998/Math/MathML'
                     : 'http://www.w3.org/1999/xhtml';
     }
-    return getParentNamespace(parentNode.parentNode);
+    return getParentNamespace(parentNode.parentNode ?? null);
 }

package/lib/ignore-block.js

@@ -75,6 +75,7 @@ ignoreBlock, throwErrorWhenTagHasUnresolved = true) {
                 type: 'psblock',
                 depth: node.depth,
                 nodeName: `#ps:${tag.type}`,
+                parentNodeUuid: node.parentNode?.uuid ?? null,
                 parentNode: node.parentNode,
                 childNodes: [],
                 blockBehavior: null,
@@ -94,6 +95,7 @@ ignoreBlock, throwErrorWhenTagHasUnresolved = true) {
                     ...token,
                     nodeName: '#text',
                     type: 'text',
+                    parentNodeUuid: node.parentNode?.uuid ?? null,
                     parentNode: node.parentNode,
                     depth: node.depth,
                 };
@@ -106,6 +108,7 @@ ignoreBlock, throwErrorWhenTagHasUnresolved = true) {
                 type: 'psblock',
                 depth: node.depth,
                 nodeName: `#ps:${tag.type}`,
+                parentNodeUuid: node.parentNode?.uuid ?? null,
                 parentNode: node.parentNode,
                 childNodes: [],
                 blockBehavior: null,
@@ -120,6 +123,7 @@ ignoreBlock, throwErrorWhenTagHasUnresolved = true) {
                     ...token,
                     nodeName: '#text',
                     type: 'text',
+                    parentNodeUuid: node.parentNode?.uuid ?? null,
                     parentNode: node.parentNode,
                     depth: node.depth,
                 };

package/lib/parser-error.d.ts

@@ -1,43 +1,2 @@
-/**
- * Positional and contextual information associated with a parser error,
- * used to construct meaningful error messages with source locations.
- */
-export type ParserErrorInfo = {
-    readonly line?: number;
-    readonly col?: number;
-    readonly raw?: string;
-    readonly stack?: string;
-};
-/**
- * An error that occurs during parsing, carrying the source line, column,
- * and raw text where the error was encountered.
- */
-export declare class ParserError extends Error {
-    readonly col: number;
-    readonly line: number;
-    name: string;
-    readonly raw: string;
-    constructor(message: string, info: ParserErrorInfo);
-}
-/**
- * A parser error specific to a particular HTML element, including
- * the node name of the element that caused the error in the message.
- */
-export declare class TargetParserError extends ParserError {
-    name: string;
-    readonly nodeName: string | null;
-    constructor(message: string, info: ParserErrorInfo & {
-        readonly nodeName?: string | null;
-    });
-}
-/**
- * A parser error that occurs while reading a configuration file,
- * including the file path in the error message for easier debugging.
- */
-export declare class ConfigParserError extends ParserError {
-    readonly filePath: string;
-    name: string;
-    constructor(message: string, info: ParserErrorInfo & {
-        readonly filePath: string;
-    });
-}
+export { ConfigParserError, ParserError, TargetParserError } from '@markuplint/shared';
+export type { ParserErrorInfo } from '@markuplint/shared';

package/lib/parser-error.js

@@ -1,47 +1,2 @@
-/**
- * An error that occurs during parsing, carrying the source line, column,
- * and raw text where the error was encountered.
- */
-export class ParserError extends Error {
-    col;
-    line;
-    name = 'ParserError';
-    raw;
-    constructor(message, info) {
-        super(message);
-        this.line = info.line ?? 1;
-        this.col = info.col ?? 0;
-        this.raw = info.raw ?? '';
-        this.stack = info.stack ?? this.stack;
-    }
-}
-/**
- * A parser error specific to a particular HTML element, including
- * the node name of the element that caused the error in the message.
- */
-export class TargetParserError extends ParserError {
-    name = 'TargetParserError';
-    nodeName;
-    constructor(message, info) {
-        const errMsg = info.nodeName
-            ? `The ${info.nodeName} is invalid element (${info.line}:${info.col}): ${message}`
-            : message;
-        super(errMsg, info);
-        this.nodeName = info.nodeName ?? null;
-    }
-}
-/**
- * A parser error that occurs while reading a configuration file,
- * including the file path in the error message for easier debugging.
- */
-export class ConfigParserError extends ParserError {
-    filePath;
-    name = 'ConfigParserError';
-    constructor(message, info) {
-        const pos = info.line != null && info.line != null ? `(${info.line}:${info.col})` : '';
-        const file = ` in ${info.filePath}${pos}`;
-        const errMsg = `${message}${file}`;
-        super(errMsg, info);
-        this.filePath = info.filePath;
-    }
-}
+// Re-export from @markuplint/shared — these classes are now defined there.
+export { ConfigParserError, ParserError, TargetParserError } from '@markuplint/shared';

package/lib/parser.js

@@ -196,6 +196,13 @@ export class Parser {
                 }
                 nodeList = [fmNode, ...newNodeList];
             }
+            timer.push('removeCircularRefs');
+            // Remove circular object references (parentNodeUuid/pairNodeUuid are already set)
+            for (const node of nodeList) {
+                const n = node;
+                delete n.parentNode;
+                delete n.pairNode;
+            }
             timer.log();
             domLog(nodeList);
             this.#reset();
@@ -381,6 +388,7 @@ export class Parser {
             ...this.createToken(token),
             type: 'doctype',
             nodeName: '#doctype',
+            parentNodeUuid: token.parentNode?.uuid ?? null,
         };
         return [node];
     }
@@ -401,6 +409,7 @@ export class Parser {
             type: 'comment',
             nodeName: '#comment',
             isBogus,
+            parentNodeUuid: token.parentNode?.uuid ?? null,
         };
         return [node];
     }
@@ -419,6 +428,7 @@ export class Parser {
             ...this.createToken(token),
             type: 'text',
             nodeName: '#text',
+            parentNodeUuid: token.parentNode?.uuid ?? null,
         };
         if (options?.researchTags) {
             const nodes = this.parseCodeFragment(token);
@@ -457,7 +467,9 @@ export class Parser {
                 childNodes: [],
                 blockBehavior: null,
                 parentNode: token.parentNode,
+                parentNodeUuid: token.parentNode?.uuid ?? null,
                 pairNode: null,
+                pairNodeUuid: null,
                 tagCloseChar: '',
                 tagOpenChar: '',
                 isGhost: true,
@@ -504,6 +516,7 @@ export class Parser {
             nodeName: `#ps:${token.nodeName}`,
             childNodes: [],
             isBogus: false,
+            parentNodeUuid: token.parentNode?.uuid ?? null,
         };
         const siblings = this.visitChildren(childNodes, block);
         return [block, ...siblings];
@@ -664,6 +677,7 @@ export class Parser {
                     depth,
                     nodeName: '#text',
                     parentNode: null,
+                    parentNodeUuid: null,
                 };
                 nodes.push(textNode);
             }
@@ -853,7 +867,7 @@ export class Parser {
         const newChildNodes = [...parentNode.childNodes];
         for (const appendingChild of childNodes) {
             const currentIndex = parentNode.childNodes.findIndex(n => n.uuid === appendingChild.uuid);
-            Object.assign(appendingChild, { parentNode });
+            Object.assign(appendingChild, { parentNode, parentNodeUuid: parentNode.uuid });
             if (currentIndex === -1) {
                 newChildNodes.push(appendingChild);
                 continue;
@@ -921,9 +935,9 @@ export class Parser {
             raw: nodes.map(n => n.raw).join(''),
         };
         for (const node of nodes) {
-            this.#removeChild(node.parentNode, node);
+            this.#removeChild(node.parentNode ?? null, node);
         }
-        this.appendChild(textNode.parentNode, textNode);
+        this.appendChild(textNode.parentNode ?? null, textNode);
         return textNode;
     }
     #convertIntoInvalidNode(node) {
@@ -986,7 +1000,7 @@ export class Parser {
                 const prevEndOffset = sequentailPrevNode
                     ? sequentailPrevNode.offset + sequentailPrevNode.raw.length
                     : 0;
-                const remnantNodes = this.#createRemnantNode(prevEndOffset, node.offset, node.depth, node.parentNode, invalidNode, whitespace);
+                const remnantNodes = this.#createRemnantNode(prevEndOffset, node.offset, node.depth, node.parentNode ?? null, invalidNode, whitespace);
                 if (remnantNodes) {
                     newNodeList.push(...remnantNodes);
                 }
@@ -997,7 +1011,7 @@ export class Parser {
         if (!lastNode) {
             return newNodeList;
         }
-        const remnantNodes = this.#createRemnantNode(lastNode.offset + lastNode.raw.length, undefined, lastNode.depth, lastNode.parentNode, invalidNode, whitespace);
+        const remnantNodes = this.#createRemnantNode(lastNode.offset + lastNode.raw.length, undefined, lastNode.depth, lastNode.parentNode ?? null, invalidNode, whitespace);
         if (!remnantNodes) {
             return newNodeList;
         }
@@ -1020,12 +1034,12 @@ export class Parser {
      * @returns `true` if `node` is a descendant of `potentialAncestor`.
      */
     #isDescendantOf(node, potentialAncestor) {
-        let current = 'parentNode' in node ? node.parentNode : null;
+        let current = 'parentNode' in node ? (node.parentNode ?? null) : null;
         while (current) {
             if (current === potentialAncestor) {
                 return true;
             }
-            current = current.parentNode;
+            current = current.parentNode ?? null;
         }
         return false;
     }
@@ -1034,7 +1048,7 @@ export class Parser {
         for (let node of nodeList) {
             if (node.type === 'endtag') {
                 const endTagUUID = node.uuid;
-                const openTag = newNodeList.findLast((n) => n.type === 'starttag' && !n.isGhost ? n.pairNode?.uuid === endTagUUID : false);
+                const openTag = newNodeList.findLast((n) => n.type === 'starttag' && !n.isGhost ? n.pairNodeUuid === endTagUUID : false);
                 if (!openTag) {
                     node = this.#convertIntoInvalidNode(node);
                 }
@@ -1044,9 +1058,9 @@ export class Parser {
         return newNodeList;
     }
     #pairing(startTag, endTag) {
-        Object.assign(startTag, { pairNode: endTag });
-        Object.assign(endTag, { pairNode: startTag });
-        this.appendChild(startTag.parentNode, endTag);
+        Object.assign(startTag, { pairNode: endTag, pairNodeUuid: endTag.uuid });
+        Object.assign(endTag, { pairNode: startTag, pairNodeUuid: startTag.uuid });
+        this.appendChild(startTag.parentNode ?? null, endTag);
     }
     #parseEndTag(token, namelessFragment) {
         const parsed = this.#parseTag(token, true, false, namelessFragment);
@@ -1219,6 +1233,7 @@ export class Parser {
             depth,
             nodeName: isFragment ? '#jsx-fragment' : tagName,
             parentNode: null,
+            parentNodeUuid: null,
         };
         const tag = isOpenTag
             ? {
@@ -1232,6 +1247,7 @@ export class Parser {
                 attributes: attrs,
                 childNodes: [],
                 pairNode: null,
+                pairNodeUuid: null,
                 tagOpenChar: '<',
                 tagCloseChar: selfClosingSolidusChar + '>',
                 blockBehavior: null,
@@ -1243,6 +1259,7 @@ export class Parser {
                 ...commons,
                 type: 'endtag',
                 pairNode: {},
+                pairNodeUuid: null,
                 tagOpenChar: '</',
                 tagCloseChar: '>',
             };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/parser-utils",
-	"version": "5.0.0-rc.0",
+	"version": "5.0.0-rc.1",
 	"description": "Utility module for markuplint parser plugin",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -31,16 +31,16 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.0.0-rc.0",
-		"@markuplint/ml-spec": "5.0.0-rc.0",
-		"@markuplint/shared": "5.0.0-rc.0",
-		"@markuplint/types": "5.0.0-rc.0",
+		"@markuplint/ml-ast": "5.0.0-rc.1",
+		"@markuplint/ml-spec": "5.0.0-rc.1",
+		"@markuplint/shared": "5.0.0-rc.1",
+		"@markuplint/types": "5.0.0-rc.1",
 		"debug": "4.4.3",
 		"espree": "11.2.0",
-		"type-fest": "5.4.4"
+		"type-fest": "5.5.0"
 	},
 	"devDependencies": {
-		"@typescript-eslint/typescript-estree": "8.57.0"
+		"@typescript-eslint/typescript-estree": "8.57.2"
 	},
-	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
+	"gitHead": "0d6b4324d9a7d6b9e1ba57d4a57e45d36975cba9"
 }