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

package/ARCHITECTURE.ja.md

@@ -21,7 +21,7 @@ src/
 ├── debugger.ts            — デバッグ・テスト用ユーティリティ
 ├── parser-error.ts        — ParserError, TargetParserError, ConfigParserError
 ├── sort-nodes.ts          — ノード位置ソート
-├── const.ts               — MASK_CHAR, SVG 要素リスト, defaultSpaces
+├── const.ts               — MASK_CHAR, SVG/MathML 要素リスト, defaultSpaces
 ├── get-location.ts        — 行/列/オフセット計算ユーティリティ
 └── decision.ts            — カスタム要素名判定
 ```
@@ -99,7 +99,7 @@ flowchart TD
 | `debugger.ts`            | テスト・デバッグユーティリティ             | `nodeListToDebugMaps`, `attributesToDebugMaps`, `nodeTreeDebugView`                                                                       |
 | `parser-error.ts`        | エラークラス                               | `ParserError`, `TargetParserError`, `ConfigParserError`                                                                                   |
 | `sort-nodes.ts`          | ノードの位置ソート                         | `sortNodes`                                                                                                                               |
-| `const.ts`               | 定数                                       | `MASK_CHAR`, `svgElementList`, `defaultSpaces`                                                                                            |
+| `const.ts`               | 定数                                       | `MASK_CHAR`, `svgElementList`, `mathmlElementList`, `defaultSpaces`                                                                       |
 | `get-location.ts`        | 位置計算                                   | `getPosition`, `getEndLine`, `getEndCol`, `getEndPosition`, `getOffsetsFromCode`                                                          |
 | `decision.ts`            | カスタム要素名判定                         | `isPotentialCustomElementName`, `isSVGElement`                                                                                            |
 
@@ -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

@@ -22,7 +22,7 @@ src/
 ├── debug.ts               — Performance timer and debug logging via `debug` package
 ├── parser-error.ts        — ParserError, TargetParserError, ConfigParserError
 ├── sort-nodes.ts          — Node position sorting
-├── const.ts               — MASK_CHAR, SVG element list, defaultSpaces
+├── const.ts               — MASK_CHAR, SVG/MathML element lists, defaultSpaces
 ├── get-location.ts        — Line/column/offset calculation utilities
 └── decision.ts            — Custom element name detection
 ```
@@ -59,7 +59,7 @@ flowchart TD
         parserError["parser-error.ts\nParserError hierarchy"]
         sortNodes["sort-nodes.ts\nsortNodes()"]
         getLoc["get-location.ts\ngetPosition(), getEndLine()"]
-        constMod["const.ts\nMASK_CHAR, svgElementList"]
+        constMod["const.ts\nMASK_CHAR, svgElementList,\nmathmlElementList"]
     end
 
     subgraph external ["External Dependencies"]
@@ -112,9 +112,9 @@ flowchart TD
 | `debug.ts`               | Performance timing and debug logging                                            | `PerformanceTimer`, `domLog`, `log`                                                                                                       |
 | `parser-error.ts`        | Error classes with positional information                                       | `ParserError`, `TargetParserError`, `ConfigParserError`                                                                                   |
 | `sort-nodes.ts`          | Node position sorting by offset                                                 | `sortNodes`                                                                                                                               |
-| `const.ts`               | Constants used across the package                                               | `MASK_CHAR`, `svgElementList`, `defaultSpaces`                                                                                            |
+| `const.ts`               | Constants used across the package                                               | `MASK_CHAR`, `svgElementList`, `mathmlElementList`, `defaultSpaces`                                                                       |
 | `get-location.ts`        | Line/column/offset position calculations                                        | `getPosition`, `getEndLine`, `getEndCol`, `getEndPosition`, `getOffsetsFromCode`                                                          |
-| `decision.ts`            | Custom element name detection and SVG element lookup                            | `isPotentialCustomElementName`, `isSVGElement`                                                                                            |
+| `decision.ts`            | Custom element name detection and SVG/MathML element lookup                     | `isPotentialCustomElementName`, `isSVGElement`                                                                                            |
 
 ## Parse Pipeline Overview
 
@@ -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,18 @@
 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.2](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.1...v5.0.0-alpha.2) (2026-02-23)
+
+### Features
+
+- **parser-utils:** add MathML namespace detection ([6c27e45](https://github.com/markuplint/markuplint/commit/6c27e45475104d744a8109e8e36698bd9dba4e8b))
+
+# [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/get-namespace.js

@@ -25,7 +25,7 @@ function getParentNamespace(parentNode) {
         return 'http://www.w3.org/1999/xhtml';
     }
     if ('namespace' in parentNode && parentNode.namespace) {
-        const ns = parentNode.namespace.toLowerCase().trim();
+        const ns = parentNode.namespace.trim();
         return ns === 'http://www.w3.org/1999/xhtml'
             ? 'http://www.w3.org/1999/xhtml'
             : ns === 'http://www.w3.org/2000/svg'

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.2",
 	"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.2",
+		"@markuplint/ml-spec": "5.0.0-alpha.2",
+		"@markuplint/types": "5.0.0-alpha.2",
 		"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": "31ccf1e81443ea3f93597d287595211f1823ddcf"
 }