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

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 Svelte component files.
+ *
+ * Parses a Svelte component using markuplint's Svelte parser, extracts the root
+ * element at depth=0, detects static attributes, slot/render usage, and the
+ * `<script>` 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,103 @@
+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 Svelte template contains slot usage.
+ *
+ * Supports:
+ * - Svelte 4: `<slot>` element (parsed as psblock `#ps:SlotElement`)
+ * - Svelte 5: `{@render children()}` (parsed as psblock `#ps:RenderTag`)
+ * - Standard `<slot>` elements
+ */
+function detectSlots(doc) {
+    return doc.nodeList.some(n => (n.type === 'starttag' && n.nodeName === 'slot') ||
+        (n.type === 'psblock' && (n.nodeName === '#ps:SlotElement' || n.nodeName === '#ps:RenderTag')));
+}
+/**
+ * Extracts the instance `<script>` block from a Svelte component source.
+ * Prefers the instance script over `<script context="module">`.
+ */
+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;
+}
+/**
+ * Component scanner for Svelte component files.
+ *
+ * Parses a Svelte component using markuplint's Svelte parser, extracts the root
+ * element at depth=0, detects static attributes, slot/render usage, and the
+ * `<script>` 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 = extractSvelteScript(sourceCode) ?? undefined;
+        return { ...info, hasSlots, scriptSource };
+    },
+    extractScriptSource(sourceCode) {
+        return extractSvelteScript(sourceCode);
+    },
+};

package/lib/parser.js

@@ -231,6 +231,7 @@ export class SvelteParser extends Parser {
             if (node.nodeName === '#text' && /^<script[\s>]/i.test(node.raw)) {
                 return this.visitPsBlock({
                     ...node,
+                    parentNode: node.parentNode ?? null,
                     nodeName: 'Script',
                     isFragment: false,
                 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/svelte-parser",
-	"version": "5.0.0-rc.0",
+	"version": "5.0.0-rc.1",
 	"description": "Svelte parser for markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -17,6 +17,10 @@
 		"./kit": {
 			"import": "./lib/sveltekit-parser.js",
 			"types": "./lib/sveltekit-parser.d.ts"
+		},
+		"./component-scanner": {
+			"import": "./lib/component-scanner.js",
+			"types": "./lib/component-scanner.d.ts"
 		}
 	},
 	"types": "lib/index.d.ts",
@@ -32,10 +36,10 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/html-parser": "5.0.0-rc.0",
-		"@markuplint/ml-ast": "5.0.0-rc.0",
-		"@markuplint/parser-utils": "5.0.0-rc.0",
-		"svelte": "5.53.10"
+		"@markuplint/html-parser": "5.0.0-rc.1",
+		"@markuplint/ml-ast": "5.0.0-rc.1",
+		"@markuplint/parser-utils": "5.0.0-rc.1",
+		"svelte": "5.55.0"
 	},
-	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
+	"gitHead": "0d6b4324d9a7d6b9e1ba57d4a57e45d36975cba9"
 }