@markuplint/pretenders 5.0.0-rc.0 → 5.0.0-rc.2

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 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.2](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.1...v5.0.0-rc.2) (2026-04-15)
+
+**Note:** Version bump only for package @markuplint/pretenders
+
+# [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/pretenders
+
 # [5.0.0-rc.0](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.3...v5.0.0-rc.0) (2026-03-12)
 
 ### Bug Fixes

package/README.md

@@ -93,7 +93,7 @@ The JSX scanner detects **slots** (children). If a component accepts `children`
 
 ### Template Scanner
 
-The template scanner uses markuplint's own framework parsers (Vue, Svelte, Astro) to extract the root element from component templates at depth=0. It also detects static attributes and slot/children usage.
+The template scanner delegates to each parser package's `component-scanner` subpath export (e.g., `@markuplint/vue-parser/component-scanner`). Each parser's component-scanner uses its own MLAST parser to extract the root element at depth=0, detect static attributes, slot/children usage, and extract script source blocks. This keeps framework-specific scanning logic co-located with the parser that understands the framework best.
 
 ```vue
 <template>
@@ -123,13 +123,13 @@ Slot detection covers:
 
 The import resolver analyzes `<script>` / frontmatter / ESM blocks in component files and extracts import bindings. This links template component usage to source file locations, enabling cross-file dependency resolution.
 
-Supported script block types:
+Script source extraction is delegated to each parser's component-scanner (Vue, Svelte, Astro), while MDX extraction is built-in. Supported script block types:
 
-- Vue `<script setup>` (all static imports are exposed as bindings)
+- Vue `<script setup>` (via `@markuplint/vue-parser/component-scanner`)
 - Vue Options API `<script>` (fallback when no `<script setup>`; only imports registered in `components: { ... }` are returned)
-- Svelte `<script>` (prefers instance script over module script)
-- Astro frontmatter (`---...---`)
-- MDX top-level ESM
+- Svelte `<script>` (via `@markuplint/svelte-parser/component-scanner`; prefers instance script over module script)
+- Astro frontmatter (via `@markuplint/astro-parser/component-scanner`)
+- MDX top-level ESM (built-in)
 
 Dynamic imports with string literal specifiers (`import('./path')`) are included in bindings with `type: 'dynamic'`. Template literal and variable specifiers are excluded.
 

package/lib/component-scanner.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @module component-scanner
+ *
+ * Type definitions for the Companion Module pattern.
+ * Each framework parser package provides its own `component-scanner` subpath
+ * implementing these interfaces. The pretenders package owns the types;
+ * parser packages import them for implementation.
+ */
+/**
+ * Result of scanning a single component file for its root element information.
+ */
+export interface ComponentScanResult {
+    /** The root element tag name, or `null` if the component is fragment-like */
+    readonly rootElement: string | null;
+    /** Static attributes on the root element */
+    readonly attrs: readonly ComponentScanAttr[];
+    /** Whether the component template contains slot usage (Vue `<slot>`, Svelte `{@render}`, etc.) */
+    readonly hasSlots: boolean;
+    /** Extracted script/ESM source block for import analysis */
+    readonly scriptSource?: ComponentScanScriptSource;
+    /** SVG namespace indicator (only set when root is in SVG namespace) */
+    readonly namespace?: 'svg';
+    /** Line number of the root element in the source */
+    readonly line?: number;
+    /** Column number of the root element in the source */
+    readonly col?: number;
+}
+/**
+ * A static attribute extracted from a component's root element.
+ */
+export interface ComponentScanAttr {
+    /** The attribute name */
+    readonly name: string;
+    /** The attribute value (omitted for boolean attributes) */
+    readonly value?: string;
+}
+/**
+ * A script/ESM source block extracted from a component file.
+ * Used by import-resolver to analyze component imports.
+ */
+export interface ComponentScanScriptSource {
+    /** The raw script content without delimiters */
+    readonly content: string;
+    /** The character offset of the content start within the original source */
+    readonly offset: number;
+}
+/**
+ * Interface for framework-specific component scanners.
+ * Implemented by each parser package's `component-scanner` subpath export.
+ */
+export interface ComponentScanner {
+    /**
+     * Scans a single component source file and extracts root element information.
+     *
+     * @param sourceCode - The full source text of the component file
+     * @returns The scan result, or `null` if scanning fails or the file has no root element
+     */
+    scanComponent(sourceCode: string): ComponentScanResult | null;
+    /**
+     * Extracts the script/ESM source block from a component file.
+     * Optional — only needed for frameworks that embed scripts (Vue, Svelte, Astro).
+     *
+     * @param sourceCode - The full source text of the component file
+     * @returns The extracted script block, or `null` if none found
+     */
+    extractScriptSource?(sourceCode: string): ComponentScanScriptSource | null;
+}

package/lib/component-scanner.js

@@ -0,0 +1,9 @@
+/**
+ * @module component-scanner
+ *
+ * Type definitions for the Companion Module pattern.
+ * Each framework parser package provides its own `component-scanner` subpath
+ * implementing these interfaces. The pretenders package owns the types;
+ * parser packages import them for implementation.
+ */
+export {};

package/lib/import-resolver/extract-script-source.d.ts

@@ -1,15 +1,17 @@
 /**
  * @module extract-script-source
  *
- * Framework-specific extractors that pull ESM source text from component files.
- * Each framework stores imports in different locations:
+ * Script source extractors for component files.
  *
- * | Framework | Source Block               | Extraction Method          |
- * |-----------|---------------------------|----------------------------|
- * | Vue       | `<script setup>` tag      | Regex on raw source        |
- * | Svelte    | `<script>` tag            | Regex on raw source        |
- * | Astro     | Frontmatter (`---...---`) | Regex on raw source        |
- * | MDX       | Top-level ESM             | Whole source (lexer-safe)  |
+ * Vue `<script setup>`, Svelte `<script>`, and Astro frontmatter extraction
+ * has been moved to each parser's `component-scanner` subpath export.
+ * This module retains only:
+ *
+ * | Function                         | Purpose                                              |
+ * |----------------------------------|------------------------------------------------------|
+ * | `extractVueScript`               | Vue Options API `<script>` block (non-setup)         |
+ * | `extractVueOptionsApiComponents` | Vue `components: { ... }` registration extraction    |
+ * | `extractMdxEsm`                  | MDX top-level ESM (no parser package for MDX)        |
  */
 /**
  * The result of extracting a script source block from a component file.
@@ -20,15 +22,6 @@ export interface ScriptSourceBlock {
     /** The offset (in characters) of the content start within the original source */
     readonly offset: number;
 }
-/**
- * Extracts the content of the `<script setup>` block from a Vue SFC source.
- * Handles optional `lang` attribute (e.g., `<script setup lang="ts">`).
- * Only matches `<script setup>` — regular `<script>` blocks are ignored.
- *
- * @param source - The full Vue SFC source text
- * @returns The extracted script block, or `null` if no `<script setup>` is found
- */
-export declare function extractVueScriptSetup(source: string): ScriptSourceBlock | null;
 /**
  * Extracts the content of a regular `<script>` block (NOT `<script setup>`) from a Vue SFC source.
  * Only matches `<script>` without the `setup` attribute.
@@ -46,22 +39,6 @@ export declare function extractVueScript(source: string): ScriptSourceBlock | nu
  * @returns An array of component local names referenced in the `components` registration
  */
 export declare function extractVueOptionsApiComponents(scriptContent: string): string[];
-/**
- * Extracts the content of the `<script>` block from a Svelte component source.
- * Prefers the instance `<script>` over `<script context="module">`.
- * Falls back to the module script if no instance script is found.
- *
- * @param source - The full Svelte component source text
- * @returns The extracted script block, or `null` if no `<script>` is found
- */
-export declare function extractSvelteScript(source: string): ScriptSourceBlock | null;
-/**
- * Extracts the content of the frontmatter block (`---...---`) from an Astro component source.
- *
- * @param source - The full Astro component source text
- * @returns The extracted frontmatter block, or `null` if no frontmatter is found
- */
-export declare function extractAstroFrontmatter(source: string): ScriptSourceBlock | null;
 /**
  * Extracts the top-level ESM block from an MDX file.
  * MDX files have standard ESM import/export statements at the top of the file,

package/lib/import-resolver/extract-script-source.js

@@ -1,44 +1,18 @@
 /**
  * @module extract-script-source
  *
- * Framework-specific extractors that pull ESM source text from component files.
- * Each framework stores imports in different locations:
+ * Script source extractors for component files.
  *
- * | Framework | Source Block               | Extraction Method          |
- * |-----------|---------------------------|----------------------------|
- * | Vue       | `<script setup>` tag      | Regex on raw source        |
- * | Svelte    | `<script>` tag            | Regex on raw source        |
- * | Astro     | Frontmatter (`---...---`) | Regex on raw source        |
- * | MDX       | Top-level ESM             | Whole source (lexer-safe)  |
- */
-/**
- * Extracts the content of the `<script setup>` block from a Vue SFC source.
- * Handles optional `lang` attribute (e.g., `<script setup lang="ts">`).
- * Only matches `<script setup>` — regular `<script>` blocks are ignored.
+ * Vue `<script setup>`, Svelte `<script>`, and Astro frontmatter extraction
+ * has been moved to each parser's `component-scanner` subpath export.
+ * This module retains only:
  *
- * @param source - The full Vue SFC source text
- * @returns The extracted script block, or `null` if no `<script setup>` is found
+ * | Function                         | Purpose                                              |
+ * |----------------------------------|------------------------------------------------------|
+ * | `extractVueScript`               | Vue Options API `<script>` block (non-setup)         |
+ * | `extractVueOptionsApiComponents` | Vue `components: { ... }` registration extraction    |
+ * | `extractMdxEsm`                  | MDX top-level ESM (no parser package for MDX)        |
  */
-export function extractVueScriptSetup(source) {
-    // Match <script setup> with optional attributes like lang="ts"
-    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,
-    };
-}
 /**
  * Extracts the content of a regular `<script>` block (NOT `<script setup>`) from a Vue SFC source.
  * Only matches `<script>` without the `setup` attribute.
@@ -108,64 +82,6 @@ export function extractVueOptionsApiComponents(scriptContent) {
     }
     return names;
 }
-/**
- * Extracts the content of the `<script>` block from a Svelte component source.
- * Prefers the instance `<script>` over `<script context="module">`.
- * Falls back to the module script if no instance script is found.
- *
- * @param source - The full Svelte component source text
- * @returns The extracted script block, or `null` if no `<script>` is found
- */
-export function extractSvelteScript(source) {
-    const re = /<script(?:\s[^>]*)?>/gi;
-    let match;
-    let moduleBlock = null;
-    while ((match = re.exec(source)) !== null) {
-        const startTag = match[0];
-        const isModule = /\bcontext\s*=\s*["']module["']/i.test(startTag);
-        const contentStart = match.index + startTag.length;
-        const endTagRe = /<\/script\s*>/i;
-        const remaining = source.slice(contentStart);
-        const endMatch = endTagRe.exec(remaining);
-        if (!endMatch) {
-            continue;
-        }
-        const block = {
-            content: remaining.slice(0, endMatch.index),
-            offset: contentStart,
-        };
-        if (!isModule) {
-            return block; // Prefer instance script
-        }
-        // Remember module script as fallback
-        moduleBlock ??= block;
-    }
-    return moduleBlock;
-}
-/**
- * Extracts the content of the frontmatter block (`---...---`) from an Astro component source.
- *
- * @param source - The full Astro component source text
- * @returns The extracted frontmatter block, or `null` if no frontmatter is found
- */
-export 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,
-    };
-}
 /**
  * Extracts the top-level ESM block from an MDX file.
  * MDX files have standard ESM import/export statements at the top of the file,

package/lib/import-resolver/index.d.ts

@@ -10,12 +10,11 @@
  *
  * ## Supported frameworks
  *
- * - Vue `<script setup>` (all static imports are exposed as bindings)
- * - Vue Options API `components` property (fallback when no `<script setup>`;
- *   only imports registered in `components: { ... }` are returned)
- * - Svelte `<script>` tags (prefers instance script over module script)
- * - Astro frontmatter (`---...---`)
- * - MDX top-level ESM
+ * - Vue `<script setup>` (via `@markuplint/vue-parser/component-scanner`)
+ * - Vue Options API `components` property (fallback; uses built-in regex extraction)
+ * - Svelte `<script>` tags (via `@markuplint/svelte-parser/component-scanner`)
+ * - Astro frontmatter (via `@markuplint/astro-parser/component-scanner`)
+ * - MDX top-level ESM (built-in extraction — no parser package)
  *
  * ## Dynamic imports
  *
@@ -29,43 +28,14 @@
  * `resolveBarrelExport` is a standalone utility (not called by `analyzeImports`)
  * that resolves a named import from a barrel directory (e.g., `'./components'`)
  * to its original source module. Only single-level re-exports are resolved.
- *
- * ### Usage example: resolving barrel imports
- *
- * ```ts
- * import { analyzeImports, resolveComponentImport, resolveBarrelExport } from '@markuplint/pretenders';
- *
- * const result = await analyzeImports('App.vue', source);
- * const binding = resolveComponentImport('Button', result.bindings);
- *
- * if (binding) {
- *   // Check if the import source is a barrel directory
- *   const originalSource = resolveBarrelExport(binding.source, binding.importedName, filePath);
- *   // originalSource: './Button.vue' (resolved from './components' barrel)
- * }
- * ```
- *
- * ## Excludes
- *
- * - `import.meta` references
- * - Dynamic imports with template literals or variable specifiers
- * - Multi-level barrel chains (only single-level re-exports are resolved)
- *
- * ## Future integration
- *
- * The current implementation uses regex-based source extraction.
- * When the CLI multi-framework dispatch (#3340) creates a unified parsing
- * pipeline, MLAST psblock-based extraction can be integrated by parsing
- * the file once and passing the document to both templateScanner and
- * import-resolver.
  */
 import type { ImportBinding, ImportAnalysisResult } from './types.js';
 export { resolveBarrelExport } from './resolve-barrel.js';
 export type { ImportBinding, ImportAnalysisResult } from './types.js';
 /**
  * Analyzes a component file's source text and extracts all static import bindings.
- * Automatically detects the framework type from the file extension and extracts
- * the appropriate source block (script setup, script, frontmatter, or top-level ESM).
+ * Automatically detects the framework type from the file extension and delegates
+ * script source extraction to the appropriate component scanner.
  *
  * @param filePath - The absolute or relative file path (used for framework detection)
  * @param source - The full source text of the component file

package/lib/import-resolver/index.js

@@ -10,12 +10,11 @@
  *
  * ## Supported frameworks
  *
- * - Vue `<script setup>` (all static imports are exposed as bindings)
- * - Vue Options API `components` property (fallback when no `<script setup>`;
- *   only imports registered in `components: { ... }` are returned)
- * - Svelte `<script>` tags (prefers instance script over module script)
- * - Astro frontmatter (`---...---`)
- * - MDX top-level ESM
+ * - Vue `<script setup>` (via `@markuplint/vue-parser/component-scanner`)
+ * - Vue Options API `components` property (fallback; uses built-in regex extraction)
+ * - Svelte `<script>` tags (via `@markuplint/svelte-parser/component-scanner`)
+ * - Astro frontmatter (via `@markuplint/astro-parser/component-scanner`)
+ * - MDX top-level ESM (built-in extraction — no parser package)
  *
  * ## Dynamic imports
  *
@@ -29,38 +28,10 @@
  * `resolveBarrelExport` is a standalone utility (not called by `analyzeImports`)
  * that resolves a named import from a barrel directory (e.g., `'./components'`)
  * to its original source module. Only single-level re-exports are resolved.
- *
- * ### Usage example: resolving barrel imports
- *
- * ```ts
- * import { analyzeImports, resolveComponentImport, resolveBarrelExport } from '@markuplint/pretenders';
- *
- * const result = await analyzeImports('App.vue', source);
- * const binding = resolveComponentImport('Button', result.bindings);
- *
- * if (binding) {
- *   // Check if the import source is a barrel directory
- *   const originalSource = resolveBarrelExport(binding.source, binding.importedName, filePath);
- *   // originalSource: './Button.vue' (resolved from './components' barrel)
- * }
- * ```
- *
- * ## Excludes
- *
- * - `import.meta` references
- * - Dynamic imports with template literals or variable specifiers
- * - Multi-level barrel chains (only single-level re-exports are resolved)
- *
- * ## Future integration
- *
- * The current implementation uses regex-based source extraction.
- * When the CLI multi-framework dispatch (#3340) creates a unified parsing
- * pipeline, MLAST psblock-based extraction can be integrated by parsing
- * the file once and passing the document to both templateScanner and
- * import-resolver.
  */
 import path from 'node:path';
-import { extractVueScriptSetup, extractVueScript, extractVueOptionsApiComponents, extractSvelteScript, extractAstroFrontmatter, extractMdxEsm, } from './extract-script-source.js';
+import { getScanner } from '../scanner-loader.js';
+import { extractVueScript, extractVueOptionsApiComponents, extractMdxEsm } from './extract-script-source.js';
 import { parseImports } from './parse-imports.js';
 export { resolveBarrelExport } from './resolve-barrel.js';
 const EXTENSION_MAP = {
@@ -71,16 +42,30 @@ const EXTENSION_MAP = {
 };
 /**
  * Determines the framework type from the file extension.
- * Local to import-resolver to include MDX without affecting templateScanner.
  */
 function getImportFrameworkType(filePath) {
     const ext = path.extname(filePath).toLowerCase();
     return EXTENSION_MAP[ext] ?? null;
 }
+/**
+ * Extracts the script source from a component file using the component scanner
+ * if available, or falls back to built-in extraction for MDX.
+ */
+async function extractScriptSource(filePath, source, framework) {
+    if (framework === 'mdx') {
+        return extractMdxEsm(source);
+    }
+    const ext = path.extname(filePath).toLowerCase();
+    const scanner = await getScanner(ext);
+    if (scanner?.extractScriptSource) {
+        return scanner.extractScriptSource(source);
+    }
+    return null;
+}
 /**
  * Analyzes a component file's source text and extracts all static import bindings.
- * Automatically detects the framework type from the file extension and extracts
- * the appropriate source block (script setup, script, frontmatter, or top-level ESM).
+ * Automatically detects the framework type from the file extension and delegates
+ * script source extraction to the appropriate component scanner.
  *
  * @param filePath - The absolute or relative file path (used for framework detection)
  * @param source - The full source text of the component file
@@ -92,30 +77,17 @@ export async function analyzeImports(filePath, source) {
     if (!framework) {
         return null;
     }
-    let scriptSource = null;
-    switch (framework) {
-        case 'vue': {
-            scriptSource = extractVueScriptSetup(source);
-            if (!scriptSource) {
-                // Fallback to Vue Options API: extract regular <script>, parse imports,
-                // then filter to only those registered in the `components` property.
-                return analyzeVueOptionsApi(source);
-            }
-            break;
-        }
-        case 'svelte': {
-            scriptSource = extractSvelteScript(source);
-            break;
-        }
-        case 'astro': {
-            scriptSource = extractAstroFrontmatter(source);
-            break;
-        }
-        case 'mdx': {
-            scriptSource = extractMdxEsm(source);
-            break;
+    // Vue Options API requires special handling: extract regular <script>,
+    // parse imports, then filter to only those registered in `components: { ... }`
+    if (framework === 'vue') {
+        const scriptSource = await extractScriptSource(filePath, source, framework);
+        if (!scriptSource) {
+            return analyzeVueOptionsApi(source);
         }
+        const bindings = await parseImports(scriptSource.content);
+        return { bindings };
     }
+    const scriptSource = await extractScriptSource(filePath, source, framework);
     if (!scriptSource) {
         return { bindings: [] };
     }
@@ -168,10 +140,6 @@ export function resolveComponentImport(componentName, bindings) {
 }
 /**
  * Converts a kebab-case string to PascalCase.
- * Used for Vue's component name resolution where `<my-button>` maps to `MyButton`.
- *
- * @param str - The kebab-case string
- * @returns The PascalCase equivalent
  */
 function kebabToPascalCase(str) {
     if (!str.includes('-')) {

package/lib/index.d.ts

@@ -32,3 +32,4 @@ export type { ScanOptions } from './scan.js';
 export { analyzeImports, resolveComponentImport, resolveBarrelExport } from './import-resolver/index.js';
 export type { ImportBinding, ImportAnalysisResult } from './import-resolver/types.js';
 export type * from './types.js';
+export type { ComponentScanner, ComponentScanResult, ComponentScanAttr, ComponentScanScriptSource, } from './component-scanner.js';

package/lib/pretender-director.d.ts

@@ -32,5 +32,5 @@ export declare class PretenderDirector {
      *
      * @returns A sorted array of resolved Pretender objects
      */
-    getPretenders(): import("packages/@markuplint/ml-config/lib/types.js").Pretender[];
+    getPretenders(): import("@markuplint/ml-config").Pretender[];
 }

package/lib/scan.d.ts

@@ -11,7 +11,7 @@ export interface ScanOptions {
  * runs both scanners in parallel, and merges + sorts the results.
  *
  * - `.js`, `.jsx`, `.ts`, `.tsx` → {@link jsxScanner}
- * - `.vue`, `.svelte`, `.astro` → {@link templateScanner}
+ * - `.vue`, `.svelte`, `.astro` → {@link templateScanner} (delegates to parser component-scanners)
  *
  * @param files - Absolute file paths to scan
  * @param options - Optional scan configuration

package/lib/scan.js

@@ -6,7 +6,7 @@ import { templateScanner } from './template/index.js';
  * runs both scanners in parallel, and merges + sorts the results.
  *
  * - `.js`, `.jsx`, `.ts`, `.tsx` → {@link jsxScanner}
- * - `.vue`, `.svelte`, `.astro` → {@link templateScanner}
+ * - `.vue`, `.svelte`, `.astro` → {@link templateScanner} (delegates to parser component-scanners)
  *
  * @param files - Absolute file paths to scan
  * @param options - Optional scan configuration

package/lib/scanner-loader.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentScanner } from './component-scanner.js';
+/**
+ * Dynamically imports the appropriate component scanner for the given file extension.
+ *
+ * @param ext - The file extension (e.g., `.vue`, `.svelte`, `.astro`)
+ * @returns The component scanner, or `null` if unavailable
+ */
+export declare function getScanner(ext: string): Promise<ComponentScanner | null>;

package/lib/scanner-loader.js

@@ -0,0 +1,56 @@
+/**
+ * Maps file extensions to their corresponding parser package's component-scanner subpath.
+ */
+const SCANNER_PACKAGES = {
+    '.vue': '@markuplint/vue-parser/component-scanner',
+    '.svelte': '@markuplint/svelte-parser/component-scanner',
+    '.astro': '@markuplint/astro-parser/component-scanner',
+};
+/**
+ * Cache of loaded component scanners.
+ */
+const scannerCache = new Map();
+/**
+ * Checks if an error is a Node.js ERR_MODULE_NOT_FOUND error.
+ *
+ * @param error - The caught error value
+ * @returns `true` if the error has code `ERR_MODULE_NOT_FOUND`
+ */
+function isModuleNotFoundError(error) {
+    return (error instanceof Error && 'code' in error && error.code === 'ERR_MODULE_NOT_FOUND');
+}
+/**
+ * Dynamically imports the appropriate component scanner for the given file extension.
+ *
+ * @param ext - The file extension (e.g., `.vue`, `.svelte`, `.astro`)
+ * @returns The component scanner, or `null` if unavailable
+ */
+export async function getScanner(ext) {
+    const cached = scannerCache.get(ext);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const pkg = SCANNER_PACKAGES[ext];
+    if (!pkg) {
+        scannerCache.set(ext, null);
+        return null;
+    }
+    try {
+        const mod = await import(pkg);
+        scannerCache.set(ext, mod.componentScanner);
+        return mod.componentScanner;
+    }
+    catch (error) {
+        if (isModuleNotFoundError(error)) {
+            const parserPkg = pkg.replace('/component-scanner', '');
+            // eslint-disable-next-line no-console
+            console.warn(`Parser package "${parserPkg}" is not installed. Skipping ${ext} files.`);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.warn(`Failed to load component scanner for ${ext}:`, error instanceof Error ? error.message : error);
+        }
+        scannerCache.set(ext, null);
+        return null;
+    }
+}

package/lib/template/index.d.ts

@@ -2,9 +2,9 @@ import type { PretenderScanTemplateOptions } from './types.js';
 /**
  * Template scanner for Vue, Svelte, and Astro component files.
  *
- * Parses component files using markuplint's existing framework parsers,
- * extracts root elements at depth=0, detects static attributes and slot usage,
- * and registers component-to-element mappings via PretenderDirector.
+ * Delegates to each parser package's component-scanner subpath export
+ * via dynamic import, keeping framework-specific scanning logic co-located
+ * with the parser that understands the framework best.
  *
  * @param files - Absolute file paths to scan (relative paths cause a `ReferenceError`)
  * @param options - Template scanner configuration (cwd, component names to ignore)

package/lib/template/index.js

@@ -1,17 +1,15 @@
+import fs from 'node:fs';
 import path from 'node:path';
 import { createScanner } from '../create-scanner.js';
 import { PretenderDirector } from '../pretender-director.js';
+import { getScanner } from '../scanner-loader.js';
 import { deriveName } from './derive-name.js';
-import { detectSlots } from './detect-slots.js';
-import { extractAttrs } from './extract-attrs.js';
-import { extractRoot } from './extract-root.js';
-import { parseComponent } from './parse-component.js';
 /**
  * Template scanner for Vue, Svelte, and Astro component files.
  *
- * Parses component files using markuplint's existing framework parsers,
- * extracts root elements at depth=0, detects static attributes and slot usage,
- * and registers component-to-element mappings via PretenderDirector.
+ * Delegates to each parser package's component-scanner subpath export
+ * via dynamic import, keeping framework-specific scanning logic co-located
+ * with the parser that understands the framework best.
  *
  * @param files - Absolute file paths to scan (relative paths cause a `ReferenceError`)
  * @param options - Template scanner configuration (cwd, component names to ignore)
@@ -26,26 +24,34 @@ export const templateScanner = createScanner(async (files, options) => {
         if (ignoreComponentNames.includes(componentName)) {
             continue;
         }
-        const doc = await parseComponent(filePath);
-        if (!doc) {
+        const ext = path.extname(filePath).toLowerCase();
+        const scanner = await getScanner(ext);
+        if (!scanner) {
             continue;
         }
-        const root = extractRoot(doc);
-        if (!root) {
+        let sourceCode;
+        try {
+            sourceCode = fs.readFileSync(filePath, 'utf8');
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.warn(`Failed to read component file: ${filePath}`, error instanceof Error ? error.message : error);
+            continue;
+        }
+        const scan = scanner.scanComponent(sourceCode);
+        if (!scan?.rootElement) {
             continue;
         }
-        const tagName = root.nodeName;
-        const attrs = extractAttrs(root);
-        const hasSlots = detectSlots(doc);
         const relFilePath = path.relative(cwd, filePath);
-        const identity = attrs.length > 0 || hasSlots
+        const attrs = scan.attrs.map(a => a.value === undefined ? { name: a.name } : { name: a.name, value: a.value });
+        const identity = attrs.length > 0 || scan.hasSlots
             ? {
-                element: tagName,
+                element: scan.rootElement,
                 ...(attrs.length > 0 ? { attrs } : {}),
-                slots: hasSlots ? true : null,
+                slots: scan.hasSlots ? true : null,
             }
-            : tagName;
-        director.add(componentName, identity, relFilePath, root.line, root.col, relFilePath);
+            : scan.rootElement;
+        director.add(componentName, identity, relFilePath, scan.line ?? 1, scan.col ?? 1, relFilePath);
     }
     return director.getPretenders();
 });

package/package.json

@@ -1,8 +1,12 @@
 {
 	"name": "@markuplint/pretenders",
-	"version": "5.0.0-rc.0",
+	"version": "5.0.0-rc.2",
 	"description": "It loads components and then creates the pretenders data from them.",
-	"repository": "git@github.com:markuplint/markuplint.git",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/markuplint/markuplint.git",
+		"directory": "packages/@markuplint/pretenders"
+	},
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
 	"engines": {
@@ -28,18 +32,18 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.0.0-rc.0",
-		"@markuplint/ml-config": "5.0.0-rc.0",
-		"@markuplint/parser-utils": "5.0.0-rc.0",
+		"@markuplint/ml-ast": "5.0.0-rc.2",
+		"@markuplint/ml-config": "5.0.0-rc.2",
+		"@markuplint/parser-utils": "5.0.0-rc.2",
 		"es-module-lexer": "2.0.0",
 		"glob": "13.0.6",
 		"meow": "14.1.0",
-		"typescript": "5.9.3"
+		"typescript": "6.0.2"
 	},
 	"optionalDependencies": {
-		"@markuplint/astro-parser": "5.0.0-rc.0",
-		"@markuplint/svelte-parser": "5.0.0-rc.0",
-		"@markuplint/vue-parser": "5.0.0-rc.0"
+		"@markuplint/astro-parser": "5.0.0-rc.2",
+		"@markuplint/svelte-parser": "5.0.0-rc.2",
+		"@markuplint/vue-parser": "5.0.0-rc.2"
 	},
-	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
+	"gitHead": "e43763858d9234c417053becc73dbd088c1e7ea6"
 }