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

package/ARCHITECTURE.ja.md

@@ -12,8 +12,10 @@ src/
 ├── parser.ts                   — Parser<Node> を拡張する AstroParser クラス
 ├── astro-parser.ts             — astro-eslint-parser ラッパーと型の再エクスポート
 ├── detect-block-behavior.ts    — .map()/.filter() のブロック動作検出
+├── component-scanner.ts        — pretenders 自動スキャン用コンポーネントスキャナー（サブパスエクスポート）
 ├── parser.spec.ts              — AstroParser 統合テスト
-└── astro-parser.spec.ts        — astro-eslint-parser ラッパーテスト
+├── astro-parser.spec.ts        — astro-eslint-parser ラッパーテスト
+└── component-scanner.spec.ts   — コンポーネントスキャナーのテスト
 ```
 
 ## アーキテクチャ図
@@ -31,10 +33,12 @@ flowchart TD
         astroParser["AstroParser\nextends Parser‹Node›"]
         astroParseFn["astroParse()\nastro-eslint-parser ラッパー"]
         detectBlock["detectBlockBehavior()\n.map()/.filter() 検出"]
+        compScanner["componentScanner\n(サブパス: ./component-scanner)"]
     end
 
     subgraph downstream ["下流"]
         mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+        pretenders["@markuplint/pretenders\n(自動スキャン)"]
     end
 
     mlAst -->|"AST 型"| astroParser
@@ -44,6 +48,8 @@ flowchart TD
     astroParseFn -->|"RootNode.children"| astroParser
     detectBlock -->|"blockBehavior"| astroParser
     astroParser -->|"MLASTDocument を生成"| mlCore
+    astroParser -->|"parse()"| compScanner
+    compScanner -->|"ComponentScanResult"| pretenders
 ```
 
 ## AstroParser クラス
@@ -185,11 +191,12 @@ astro-eslint-parser → @astrojs/compiler → Astro 構文サポート
 
 ## 主要ソースファイル
 
-| ファイル          | 用途                                                                                  |
-| ----------------- | ------------------------------------------------------------------------------------- |
-| `parser.ts`       | `AstroParser` クラス — 全オーバーライドメソッドと名前空間スコーピング                 |
-| `astro-parser.ts` | `astroParse()` ラッパー — `astro-eslint-parser` に委譲し、診断を `ParserError` に変換 |
-| `index.ts`        | 公開 API — シングルトン `parser` インスタンスを再エクスポート                         |
+| ファイル               | 用途                                                                                                          |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `parser.ts`            | `AstroParser` クラス — 全オーバーライドメソッドと名前空間スコーピング                                         |
+| `astro-parser.ts`      | `astroParse()` ラッパー — `astro-eslint-parser` に委譲し、診断を `ParserError` に変換                         |
+| `index.ts`             | 公開 API — シングルトン `parser` インスタンスを再エクスポート                                                 |
+| `component-scanner.ts` | `@markuplint/pretenders` 自動スキャン用コンポーネントスキャナー（サブパスエクスポート `./component-scanner`） |
 
 ## ドキュメントマップ
 

package/ARCHITECTURE.md

@@ -12,8 +12,10 @@ src/
 ├── parser.ts                   — AstroParser class extending Parser<Node>
 ├── astro-parser.ts             — astro-eslint-parser wrapper and type re-exports
 ├── detect-block-behavior.ts    — Detects .map()/.filter() for block behavior
+├── component-scanner.ts        — Component scanner for pretenders auto scan (subpath export)
 ├── parser.spec.ts              — AstroParser integration tests
-└── astro-parser.spec.ts        — astro-eslint-parser wrapper tests
+├── astro-parser.spec.ts        — astro-eslint-parser wrapper tests
+└── component-scanner.spec.ts   — Tests for component scanner
 ```
 
 ## Architecture Diagram
@@ -31,10 +33,12 @@ flowchart TD
         astroParser["AstroParser\nextends Parser‹Node›"]
         astroParseFn["astroParse()\nastro-eslint-parser wrapper"]
         detectBlock["detectBlockBehavior()\n.map()/.filter() detection"]
+        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"| astroParser
@@ -44,6 +48,8 @@ flowchart TD
     astroParseFn -->|"RootNode.children"| astroParser
     detectBlock -->|"blockBehavior"| astroParser
     astroParser -->|"produces MLASTDocument"| mlCore
+    astroParser -->|"parse()"| compScanner
+    compScanner -->|"ComponentScanResult"| pretenders
 ```
 
 ## AstroParser Class
@@ -185,11 +191,12 @@ astro-eslint-parser → @astrojs/compiler → Astro syntax support
 
 ## Key Source Files
 
-| File              | Purpose                                                                                            |
-| ----------------- | -------------------------------------------------------------------------------------------------- |
-| `parser.ts`       | `AstroParser` class — all override methods and namespace scoping                                   |
-| `astro-parser.ts` | `astroParse()` wrapper — delegates to `astro-eslint-parser`, converts diagnostics to `ParserError` |
-| `index.ts`        | Public API — re-exports the singleton `parser` instance                                            |
+| File                   | Purpose                                                                                            |
+| ---------------------- | -------------------------------------------------------------------------------------------------- |
+| `parser.ts`            | `AstroParser` class — all override methods and namespace scoping                                   |
+| `astro-parser.ts`      | `astroParse()` wrapper — delegates to `astro-eslint-parser`, converts diagnostics to `ParserError` |
+| `index.ts`             | Public API — re-exports the singleton `parser` instance                                            |
+| `component-scanner.ts` | Component scanner for `@markuplint/pretenders` auto scan (subpath export `./component-scanner`)    |
 
 ## Documentation Map
 

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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
+
+- **astro-parser:** add component-scanner subpath export for pretenders auto scan ([3d85bc5](https://github.com/markuplint/markuplint/commit/3d85bc5f5904c0157415de175227eedf89539cda))
+
+### 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/astro-parser

package/SKILL.md

@@ -19,6 +19,7 @@ modify namespace scoping, update expression handling, and manage astro-eslint-pa
 | `add-directive`              | Add a new Astro template directive                  |
 | `modify-namespace-scoping`   | Modify SVG/XHTML namespace scoping logic            |
 | `update-expression-handling` | Update expression splitting or MustacheTag handling |
+| `update-component-scanner`   | Update component-scanner for pretenders auto scan   |
 
 If omitted, defaults to `add-directive`.
 
@@ -100,6 +101,29 @@ Update expression splitting or MustacheTag handling. Follow recipe #3 in `docs/m
 2. Test with expressions containing nested HTML (e.g., `{list.map(item => <li>{item}</li>)}`)
 3. Test: `yarn test --scope @markuplint/astro-parser`
 
+## Task: update-component-scanner
+
+Update `src/component-scanner.ts` when Astro slot syntax or frontmatter handling changes.
+
+### When to update
+
+- New slot-like syntax is added to Astro
+- Frontmatter delimiter handling needs to change
+- The `extractComponentInfo` shared logic needs a fix (also update vue-parser and svelte-parser)
+
+### Step 1: Make the change
+
+1. Read `src/component-scanner.ts`
+2. Modify `detectSlots()` for new slot patterns, or `extractAstroFrontmatter()` for frontmatter 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/astro-parser`
+3. Test: `npx vitest run packages/@markuplint/astro-parser/src/component-scanner.spec.ts`
+4. Run pretenders integration tests: `npx vitest run packages/@markuplint/pretenders`
+
 ## Rules
 
 1. **Delegate tokenization to astro-eslint-parser** — never parse Astro syntax manually; always use `astroParse()`.

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 Astro component files.
+ *
+ * Parses an Astro component using markuplint's Astro parser, extracts the root
+ * element at depth=0, detects static attributes, slot usage, and the
+ * frontmatter 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,88 @@
+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 Astro template contains `<slot>` elements.
+ */
+function detectSlots(doc) {
+    return doc.nodeList.some(n => n.type === 'starttag' && n.nodeName === 'slot');
+}
+/**
+ * Extracts the frontmatter block (`---...---`) from an Astro component source.
+ */
+function extractAstroFrontmatter(source) {
+    const re = /^(?:\s*\n)?---\r?\n/;
+    const startMatch = re.exec(source);
+    if (!startMatch) {
+        return null;
+    }
+    const contentStart = startMatch[0].length;
+    const afterStart = source.slice(contentStart);
+    const endRe = /\r?\n---\r?\n/;
+    const endMatch = endRe.exec(afterStart);
+    if (!endMatch) {
+        return null;
+    }
+    return {
+        content: afterStart.slice(0, endMatch.index),
+        offset: contentStart,
+    };
+}
+/**
+ * Component scanner for Astro component files.
+ *
+ * Parses an Astro component using markuplint's Astro parser, extracts the root
+ * element at depth=0, detects static attributes, slot usage, and the
+ * frontmatter 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 = extractAstroFrontmatter(sourceCode) ?? undefined;
+        return { ...info, hasSlots, scriptSource };
+    },
+    extractScriptSource(sourceCode) {
+        return extractAstroFrontmatter(sourceCode);
+    },
+};

package/lib/parser.js

@@ -160,7 +160,7 @@ class AstroParser extends Parser {
         if (!startTagNode || startTagNode.type !== 'starttag') {
             throw new ParserError('Not found start tag', startTagNode ?? token);
         }
-        return super.visitElement(startTagNode, childNodes, {
+        return super.visitElement({ ...startTagNode, parentNode: startTagNode.parentNode ?? null }, childNodes, {
             // https://docs.astro.build/en/basics/astro-syntax/#fragments
             namelessFragment: true,
             createEndTagToken: () => {
@@ -171,7 +171,7 @@ class AstroParser extends Parser {
                 if (endTagNode?.type !== 'endtag') {
                     return null;
                 }
-                return endTagNode ?? null;
+                return { ...endTagNode, parentNode: endTagNode.parentNode ?? null };
             },
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/astro-parser",
-	"version": "5.0.0-rc.0",
+	"version": "5.0.0-rc.1",
 	"description": "astro 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,12 +28,12 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.0.0-rc.0",
-		"@markuplint/parser-utils": "5.0.0-rc.0",
-		"astro-eslint-parser": "1.3.0"
+		"@markuplint/ml-ast": "5.0.0-rc.1",
+		"@markuplint/parser-utils": "5.0.0-rc.1",
+		"astro-eslint-parser": "1.4.0"
 	},
 	"devDependencies": {
-		"@astrojs/compiler": "3.0.0"
+		"@astrojs/compiler": "3.0.1"
 	},
-	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
+	"gitHead": "0d6b4324d9a7d6b9e1ba57d4a57e45d36975cba9"
 }