@markuplint/vue-parser 5.0.0-dev.5 → 5.0.0-rc.1

package/ARCHITECTURE.ja.md

@@ -8,11 +8,13 @@
 
 ```
 src/
-├── index.ts                — parser を再エクスポート
-├── parser.ts               — Parser<ASTNode, State> を拡張する VueParser クラス
-├── index.spec.ts           — VueParser の統合テスト
+├── index.ts                    — parser を再エクスポート
+├── parser.ts                   — Parser<ASTNode, State> を拡張する VueParser クラス
+├── component-scanner.ts        — pretenders 自動スキャン用コンポーネントスキャナー（サブパスエクスポート）
+├── index.spec.ts               — VueParser の統合テスト
+├── component-scanner.spec.ts   — コンポーネントスキャナーのテスト
 └── vue-parser/
-    └── index.ts            — vue-eslint-parser ラッパー、ASTNode/ASTComment 型エクスポート
+    └── index.ts                — vue-eslint-parser ラッパー、ASTNode/ASTComment 型エクスポート
 ```
 
 ## アーキテクチャ図
@@ -28,10 +30,12 @@ flowchart TD
     subgraph pkg ["@markuplint/vue-parser"]
         vueParser["VueParser\nextends Parser‹ASTNode, State›"]
         vueParseFn["vueParse()\nvue-eslint-parser ラッパー"]
+        compScanner["componentScanner\n(サブパス: ./component-scanner)"]
     end
 
     subgraph downstream ["下流"]
         mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+        pretenders["@markuplint/pretenders\n(自動スキャン)"]
     end
 
     mlAst -->|"AST 型"| vueParser
@@ -40,6 +44,8 @@ flowchart TD
     vueParseFn -->|"ESLintProgram AST"| vueParser
 
     vueParser -->|"MLASTDocument を生成"| mlCore
+    vueParser -->|"parse()"| compScanner
+    compScanner -->|"ComponentScanResult"| pretenders
 ```
 
 ## VueParser クラス
@@ -249,12 +255,13 @@ Alpine.js では条件分岐とループに決まったパターン — `<templa
 
 ## 主要ソースファイル
 
-| ファイル                  | 用途                                                              |
-| ------------------------- | ----------------------------------------------------------------- |
-| `src/parser.ts`           | 全オーバーライドメソッドを持つ VueParser クラス                   |
-| `src/vue-parser/index.ts` | vue-eslint-parser ラッパーと型定義（ASTNode、ASTComment）         |
-| `src/index.ts`            | モジュールエントリーポイント、parser インスタンスを再エクスポート |
-| `src/index.spec.ts`       | パース、ディレクティブ、名前空間をカバーする統合テスト            |
+| ファイル                   | 用途                                                                                                          |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `src/parser.ts`            | 全オーバーライドメソッドを持つ VueParser クラス                                                               |
+| `src/vue-parser/index.ts`  | vue-eslint-parser ラッパーと型定義（ASTNode、ASTComment）                                                     |
+| `src/index.ts`             | モジュールエントリーポイント、parser インスタンスを再エクスポート                                             |
+| `src/index.spec.ts`        | パース、ディレクティブ、名前空間をカバーする統合テスト                                                        |
+| `src/component-scanner.ts` | `@markuplint/pretenders` 自動スキャン用コンポーネントスキャナー（サブパスエクスポート `./component-scanner`） |
 
 ## 外部依存
 
@@ -277,14 +284,18 @@ flowchart TD
 
     subgraph pkg ["@markuplint/vue-parser"]
         vueParser["VueParser"]
+        compScanner["componentScanner\n(./component-scanner)"]
     end
 
     subgraph downstream ["下流"]
         mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+        pretenders["@markuplint/pretenders\n(自動スキャン)"]
     end
 
     upstream -->|"型、パース"| vueParser
     vueParser -->|"MLASTDocument を生成"| mlCore
+    vueParser -->|"parse()"| compScanner
+    compScanner -->|"ComponentScanResult"| pretenders
 ```
 
 ### 上流
@@ -296,6 +307,7 @@ flowchart TD
 ### 下流
 
 - **`@markuplint/ml-core`** -- `VueParser` が生成する `MLASTDocument` を消費し、ルール評価のための MLDOM を構築
+- **`@markuplint/pretenders`** -- `./component-scanner` を動的インポートし、ルート要素・属性・スロット情報を抽出して自動スキャンに利用
 
 ## ドキュメントマップ
 

package/ARCHITECTURE.md

@@ -8,11 +8,13 @@
 
 ```
 src/
-├── index.ts                — Re-exports parser
-├── parser.ts               — VueParser class extending Parser<ASTNode, State>
-├── index.spec.ts           — Integration tests for VueParser
+├── index.ts                    — Re-exports parser
+├── parser.ts                   — VueParser class extending Parser<ASTNode, State>
+├── component-scanner.ts        — Component scanner for pretenders auto scan (subpath export)
+├── index.spec.ts               — Integration tests for VueParser
+├── component-scanner.spec.ts   — Tests for component scanner
 └── vue-parser/
-    └── index.ts            — vue-eslint-parser wrapper, ASTNode/ASTComment type exports
+    └── index.ts                — vue-eslint-parser wrapper, ASTNode/ASTComment type exports
 ```
 
 ## Architecture Diagram
@@ -28,10 +30,12 @@ flowchart TD
     subgraph pkg ["@markuplint/vue-parser"]
         vueParser["VueParser\nextends Parser‹ASTNode, State›"]
         vueParseFn["vueParse()\nvue-eslint-parser wrapper"]
+        compScanner["componentScanner\n(subpath: ./component-scanner)"]
     end
 
     subgraph downstream ["Downstream"]
         mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+        pretenders["@markuplint/pretenders\n(auto scan)"]
     end
 
     mlAst -->|"AST types"| vueParser
@@ -40,6 +44,8 @@ flowchart TD
     vueParseFn -->|"ESLintProgram AST"| vueParser
 
     vueParser -->|"produces MLASTDocument"| mlCore
+    vueParser -->|"parse()"| compScanner
+    compScanner -->|"ComponentScanResult"| pretenders
 ```
 
 ## VueParser Class
@@ -249,12 +255,13 @@ The current Vue parser handles these directives at the attribute level only (`is
 
 ## Key Source Files
 
-| File                      | Purpose                                                              |
-| ------------------------- | -------------------------------------------------------------------- |
-| `src/parser.ts`           | VueParser class with all override methods                            |
-| `src/vue-parser/index.ts` | vue-eslint-parser wrapper and type definitions (ASTNode, ASTComment) |
-| `src/index.ts`            | Module entry point, re-exports parser instance                       |
-| `src/index.spec.ts`       | Integration tests covering parsing, directives, namespaces           |
+| File                       | Purpose                                                                                         |
+| -------------------------- | ----------------------------------------------------------------------------------------------- |
+| `src/parser.ts`            | VueParser class with all override methods                                                       |
+| `src/vue-parser/index.ts`  | vue-eslint-parser wrapper and type definitions (ASTNode, ASTComment)                            |
+| `src/index.ts`             | Module entry point, re-exports parser instance                                                  |
+| `src/index.spec.ts`        | Integration tests covering parsing, directives, namespaces                                      |
+| `src/component-scanner.ts` | Component scanner for `@markuplint/pretenders` auto scan (subpath export `./component-scanner`) |
 
 ## External Dependencies
 
@@ -277,14 +284,18 @@ flowchart TD
 
     subgraph pkg ["@markuplint/vue-parser"]
         vueParser["VueParser"]
+        compScanner["componentScanner\n(./component-scanner)"]
     end
 
     subgraph downstream ["Downstream"]
         mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+        pretenders["@markuplint/pretenders\n(auto scan)"]
     end
 
     upstream -->|"types, parsing"| vueParser
     vueParser -->|"produces MLASTDocument"| mlCore
+    vueParser -->|"parse()"| compScanner
+    compScanner -->|"ComponentScanResult"| pretenders
 ```
 
 ### Upstream
@@ -296,6 +307,7 @@ flowchart TD
 ### Downstream
 
 - **`@markuplint/ml-core`** -- Consumes the `MLASTDocument` produced by `VueParser` and constructs the MLDOM for rule evaluation
+- **`@markuplint/pretenders`** -- Dynamically imports `./component-scanner` to extract root element, attributes, and slot information for auto scan
 
 ## Documentation Map
 

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 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)
+
+- feat!: adapt framework parsers to UUID-based node references ([6d543b8](https://github.com/markuplint/markuplint/commit/6d543b8c11506fe113d0ceeae3526f552f4ee26d))
+
+### Features
+
+- **vue-parser:** add component-scanner subpath export for pretenders auto scan ([ac8e0f5](https://github.com/markuplint/markuplint/commit/ac8e0f52be19cc0714593e26066f2f8cef9c96cd))
+
+### BREAKING CHANGES
+
+- Parser output no longer contains parentNode/pairNode
+  object references. Use parentNodeUuid/pairNodeUuid string fields instead.
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
+# [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/vue-parser
+
 # [5.0.0-alpha.3](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.2...v5.0.0-alpha.3) (2026-02-26)
 
 **Note:** Version bump only for package @markuplint/vue-parser

package/SKILL.md

@@ -20,6 +20,7 @@ detection, update vue-eslint-parser version support, and fix comment injection.
 | `modify-element-type-detection` | Update detectElementType() matchers                           |
 | `update-vue-version-support`    | Handle vue-eslint-parser API changes                          |
 | `fix-comment-injection`         | Fix template comment injection in flattenNodes()              |
+| `update-component-scanner`      | Update component-scanner for pretenders auto scan             |
 
 If omitted, defaults to `add-directive`.
 
@@ -127,6 +128,29 @@ Fix template comment injection in `flattenNodes()`. Follow recipe #4 in `docs/ma
 2. Test with Vue templates containing HTML comments (`<!-- -->`), bogus comments (`<!...>`), and mixed content
 3. Test: `yarn test --scope @markuplint/vue-parser`
 
+## Task: update-component-scanner
+
+Update `src/component-scanner.ts` when Vue slot syntax or script block handling changes.
+
+### When to update
+
+- New slot-like syntax is added to Vue (e.g., a new built-in component that acts as a slot)
+- `<script setup>` extraction logic needs to change (e.g., new script attributes)
+- The `extractComponentInfo` shared logic needs a fix (also update svelte-parser and astro-parser)
+
+### Step 1: Make the change
+
+1. Read `src/component-scanner.ts`
+2. Modify `detectSlots()` for new slot patterns, or `extractVueScriptSetup()` for script changes
+3. If modifying `extractComponentInfo()`, apply the same change to all three parsers (vue, svelte, astro)
+
+### Step 2: Verify
+
+1. Update tests in `src/component-scanner.spec.ts`
+2. Build: `yarn build --scope @markuplint/vue-parser`
+3. Test: `npx vitest run packages/@markuplint/vue-parser/src/component-scanner.spec.ts`
+4. Run pretenders integration tests: `npx vitest run packages/@markuplint/pretenders`
+
 ## Rules
 
 1. **Use vue-eslint-parser** for all template parsing — never parse Vue templates manually.

package/lib/component-scanner.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Result of scanning a single component file for its root element information.
+ */
+export interface ComponentScanResult {
+    readonly rootElement: string | null;
+    readonly attrs: readonly ComponentScanAttr[];
+    readonly hasSlots: boolean;
+    readonly scriptSource?: ComponentScanScriptSource;
+    readonly namespace?: 'svg';
+    readonly line?: number;
+    readonly col?: number;
+}
+/**
+ * A static attribute extracted from a component's root element.
+ */
+export interface ComponentScanAttr {
+    readonly name: string;
+    readonly value?: string;
+}
+/**
+ * A script/ESM source block extracted from a component file.
+ */
+export interface ComponentScanScriptSource {
+    readonly content: string;
+    readonly offset: number;
+}
+/**
+ * Component scanner for Vue SFC files.
+ *
+ * Parses a Vue component using markuplint's Vue parser, extracts the root
+ * element at depth=0, detects static attributes, slot usage, and the
+ * `<script setup>` block for import analysis.
+ */
+export declare const componentScanner: {
+    scanComponent(sourceCode: string): ComponentScanResult | null;
+    extractScriptSource(sourceCode: string): ComponentScanScriptSource | null;
+};

package/lib/component-scanner.js

@@ -0,0 +1,89 @@
+import { parser } from './parser.js';
+/**
+ * Extracts root element information from a parsed MLAST document.
+ */
+function extractComponentInfo(doc) {
+    const root = doc.nodeList.find((n) => n.type === 'starttag' && n.depth === 0 && !n.isFragment);
+    if (!root) {
+        return null;
+    }
+    const attrs = [];
+    for (const attr of root.attributes) {
+        if (attr.type !== 'attr') {
+            continue;
+        }
+        const value = attr.value.raw;
+        if (value === '') {
+            attrs.push({ name: attr.nodeName });
+        }
+        else {
+            attrs.push({ name: attr.nodeName, value });
+        }
+    }
+    return {
+        rootElement: root.nodeName,
+        attrs,
+        namespace: root.namespace === 'http://www.w3.org/2000/svg' ? 'svg' : undefined,
+        line: root.line,
+        col: root.col,
+    };
+}
+/**
+ * Detects whether the parsed Vue template contains `<slot>` elements.
+ */
+function detectSlots(doc) {
+    return doc.nodeList.some(n => n.type === 'starttag' && n.nodeName === 'slot');
+}
+/**
+ * Extracts the `<script setup>` block from a Vue SFC source.
+ */
+function extractVueScriptSetup(source) {
+    const re = /<script\s[^>]*?\bsetup\b[^>]*>/i;
+    const match = re.exec(source);
+    if (!match) {
+        return null;
+    }
+    const startTag = match[0];
+    const contentStart = match.index + startTag.length;
+    const endTagRe = /<\/script\s*>/i;
+    const remaining = source.slice(contentStart);
+    const endMatch = endTagRe.exec(remaining);
+    if (!endMatch) {
+        return null;
+    }
+    return {
+        content: remaining.slice(0, endMatch.index),
+        offset: contentStart,
+    };
+}
+/**
+ * Component scanner for Vue SFC files.
+ *
+ * Parses a Vue component using markuplint's Vue parser, extracts the root
+ * element at depth=0, detects static attributes, slot usage, and the
+ * `<script setup>` block for import analysis.
+ */
+export const componentScanner = {
+    scanComponent(sourceCode) {
+        let doc;
+        try {
+            doc = parser.parse(sourceCode);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError || (error instanceof Error && error.constructor.name === 'ParserError')) {
+                return null;
+            }
+            throw error;
+        }
+        const info = extractComponentInfo(doc);
+        if (!info) {
+            return null;
+        }
+        const hasSlots = detectSlots(doc);
+        const scriptSource = extractVueScriptSetup(sourceCode) ?? undefined;
+        return { ...info, hasSlots, scriptSource };
+    },
+    extractScriptSource(sourceCode) {
+        return extractVueScriptSetup(sourceCode);
+    },
+};

package/lib/parser.js

@@ -114,7 +114,7 @@ class VueParser extends Parser {
                 const comment = this.visitComment({
                     ...token,
                     depth: node.depth,
-                    parentNode: node.parentNode,
+                    parentNode: node.parentNode ?? null,
                 }, {
                     isBogus: betweenComment.type === 'HTMLBogusComment',
                 })[0];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/vue-parser",
-	"version": "5.0.0-dev.5+e96392f56",
+	"version": "5.0.0-rc.1",
 	"description": "Vue parser for markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -13,6 +13,10 @@
 		".": {
 			"import": "./lib/index.js",
 			"types": "./lib/index.d.ts"
+		},
+		"./component-scanner": {
+			"import": "./lib/component-scanner.js",
+			"types": "./lib/component-scanner.d.ts"
 		}
 	},
 	"publishConfig": {
@@ -24,10 +28,10 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/html-parser": "5.0.0-dev.5+e96392f56",
-		"@markuplint/ml-ast": "5.0.0-dev.5+e96392f56",
-		"@markuplint/parser-utils": "5.0.0-dev.5+e96392f56",
+		"@markuplint/html-parser": "5.0.0-rc.1",
+		"@markuplint/ml-ast": "5.0.0-rc.1",
+		"@markuplint/parser-utils": "5.0.0-rc.1",
 		"vue-eslint-parser": "10.4.0"
 	},
-	"gitHead": "e96392f56e4bc8165ba59622b41c822703a96372"
+	"gitHead": "0d6b4324d9a7d6b9e1ba57d4a57e45d36975cba9"
 }