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

package/ARCHITECTURE.ja.md

@@ -148,7 +148,7 @@ ParserError (基底クラス)
 
 ## IDL 属性マッピング
 
-`searchIDLAttribute` は React スタイルの IDL 属性名と HTML コンテンツ属性名の双方向マッピングを提供します（例: `className` → `class`、`htmlFor` → `for`）。spec が `useIDLAttributeNames: true` を設定している場合に、`@markuplint/ml-core` の `MLAttr` コンストラクタから呼び出されます。
+`searchIDLAttribute` は React スタイルの IDL 属性名と HTML コンテンツ属性名の双方向マッピングを提供します（例: `className` → `class`、`htmlFor` → `for`）。spec が `acceptedAttrNames`（`'idl'` または `'both'`）を設定している場合に、`@markuplint/ml-core` の `MLAttr` コンストラクタから呼び出されます。
 
 ## 外部依存
 

package/ARCHITECTURE.md

@@ -174,7 +174,7 @@ Additionally, `debug.ts` provides `PerformanceTimer` for measuring parse phase d
 
 ## IDL Attribute Mapping
 
-`searchIDLAttribute` maps between React-style IDL attribute names and HTML content attribute names. It is called by `@markuplint/ml-core`'s `MLAttr` constructor when the spec sets `useIDLAttributeNames: true`. It maintains a comprehensive mapping table derived from React's `possibleStandardNames.js`, covering:
+`searchIDLAttribute` maps between React-style IDL attribute names and HTML content attribute names. It is called by `@markuplint/ml-core`'s `MLAttr` constructor when the spec sets `acceptedAttrNames` (either `'idl'` or `'both'`). It maintains a comprehensive mapping table derived from React's `possibleStandardNames.js`, covering:
 
 - HTML attributes (e.g., `className` -> `class`, `htmlFor` -> `for`, `tabIndex` -> `tabindex`)
 - SVG attributes (e.g., `strokeWidth` -> `stroke-width`, `clipPath` -> `clip-path`)

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-alpha.1](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.0...v5.0.0-alpha.1) (2026-02-22)
+
+### Bug Fixes
+
+- **parser-utils:** skip text trimming when text node is a descendant of the next node ([1bfcede](https://github.com/markuplint/markuplint/commit/1bfcedebbd115ea817df76a979b4e10a26d0a2b2))
+
 # [5.0.0-alpha.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v5.0.0-alpha.0) (2026-02-20)
 
 ### Bug Fixes

package/docs/parser-class.ja.md

@@ -173,7 +173,7 @@ afterFlattenNodes(
 1. **残留ノードの露出** — 既知のノード間の空白と無効なマークアップを発見する
 2. **孤立終了タグ → ボーガス** — 対応する開始タグがない終了タグを `invalid` ノードに変換する
 3. **テキストの結合** — 同じオフセットにある隣接する `#text` ノードをマージする
-4. **テキストのトリム** — 重複するテキストノードの境界をトリムする
+4. **テキストのトリム** — フラットリスト上で次のノードとソース範囲が重複するテキストノードをトリムする。テキストノードがツリー上で次のノードの子孫である場合はスキップする（Markdown 等の合成パーサーでは、子要素が親要素と同じソース範囲を共有することがあるため）
 
 ### ステップ 9: restoreNode()
 

package/docs/parser-class.md

@@ -173,7 +173,7 @@ Performs four cleanup passes:
 1. **Expose remnant nodes** — discovers whitespace and invalid markup between known nodes
 2. **Orphan end tags → bogus** — converts unmatched end tags to `invalid` nodes
 3. **Concatenate text** — merges adjacent `#text` nodes at the same offset
-4. **Trim text** — trims overlapping text node boundaries
+4. **Trim text** — trims text nodes whose source range overlaps with the next node in the flat list. Skips trimming when the text node is a tree-descendant of the next node, which can occur with synthetic parsers (e.g., Markdown) where child elements share the same source range as their parent
 
 ### Step 9: restoreNode()
 

package/lib/parser.js

@@ -1011,6 +1011,24 @@ export class Parser {
             col: getEndCol(token.raw, token.col),
         };
     }
+    /**
+     * Checks whether a node is a descendant of another node by walking up
+     * the parent chain.
+     *
+     * @param node - The node to test.
+     * @param potentialAncestor - The node that may be an ancestor.
+     * @returns `true` if `node` is a descendant of `potentialAncestor`.
+     */
+    #isDescendantOf(node, potentialAncestor) {
+        let current = 'parentNode' in node ? node.parentNode : null;
+        while (current) {
+            if (current === potentialAncestor) {
+                return true;
+            }
+            current = current.parentNode;
+        }
+        return false;
+    }
     #orphanEndTagToBogusMark(nodeList) {
         const newNodeList = [];
         for (let node of nodeList) {
@@ -1304,10 +1322,17 @@ export class Parser {
         this.#originalRawCode = originalRawCode ?? this.#originalRawCode;
     }
     /**
-     * Trim overlapping sections of text nodes for proper node separation
+     * Trims text nodes whose source range overlaps with the next node in
+     * the flat list. This prevents text content from bleeding into adjacent
+     * elements that occupy a later (or overlapping) source range.
+     *
+     * Skips trimming when the text node is a descendant of the next node
+     * in the tree hierarchy, because synthetic parsers (e.g., Markdown)
+     * can produce child elements that share the same source range as their
+     * parent and therefore appear before the parent in offset-sorted order.
      *
-     * @param nodeList
-     * @returns
+     * @param nodeList - The flat, offset-sorted node list to process.
+     * @returns A new node list with overlapping text nodes trimmed.
      */
     #trimText(nodeList) {
         const newNodeList = [];
@@ -1318,7 +1343,7 @@ export class Parser {
                 node.raw.length > 0) {
                 const prevNodeEndOffset = prevNode.offset + prevNode.raw.length;
                 const nodeStartOffset = node.offset;
-                if (prevNodeEndOffset > nodeStartOffset) {
+                if (prevNodeEndOffset > nodeStartOffset && !this.#isDescendantOf(prevNode, node)) {
                     const prevNodeRaw = prevNode.raw;
                     const prevNodeTrimmedRaw = prevNodeRaw.slice(0, nodeStartOffset - prevNode.offset);
                     this.updateRaw(prevNode, prevNodeTrimmedRaw);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/parser-utils",
-	"version": "5.0.0-alpha.0",
+	"version": "5.0.0-alpha.1",
 	"description": "Utility module for markuplint parser plugin",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -31,15 +31,15 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.0.0-alpha.0",
-		"@markuplint/ml-spec": "5.0.0-alpha.0",
-		"@markuplint/types": "5.0.0-alpha.0",
+		"@markuplint/ml-ast": "5.0.0-alpha.1",
+		"@markuplint/ml-spec": "5.0.0-alpha.1",
+		"@markuplint/types": "5.0.0-alpha.1",
 		"debug": "4.4.3",
-		"espree": "11.1.0",
+		"espree": "11.1.1",
 		"type-fest": "5.4.4"
 	},
 	"devDependencies": {
 		"@typescript-eslint/typescript-estree": "8.56.0"
 	},
-	"gitHead": "13dcfc84ec83d87360c720e253383b60767e1b56"
+	"gitHead": "78a295e73a097a1ce09c777c06fa21ab68136387"
 }