@uicontract/parser-vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UIC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @uicontract/parser-vue
+
+Vue and Nuxt parser for discovering interactive UI elements.
+
+## Install
+
+```bash
+npm install @uicontract/parser-vue
+```
+
+## Usage
+
+```typescript
+import { VueParser } from '@uicontract/parser-vue';
+
+const parser = new VueParser();
+
+// Detect whether a project uses Vue
+const isVue = await parser.detect('/path/to/my-app');
+
+// Discover all interactive elements
+const { elements, warnings, metadata } = await parser.discover('/path/to/my-app', {
+  include: ['src/**/*.vue'],
+});
+
+console.log(`Found ${elements.length} elements in ${metadata.filesScanned} files`);
+// elements: RawElement[] ready for @uicontract/namer
+```
+
+## API
+
+- **`VueParser`**: Implements the `Parser` interface from `@uicontract/core`.
+  - **`detect(dir)`**: Returns `true` if the directory contains a Vue 3 or Nuxt project.
+  - **`discover(dir, options)`**: Parses `.vue` Single File Component templates using `@vue/compiler-dom`. Returns `{ elements, warnings, metadata }`.
+
+Discovered element types: `button`, `a` (link), `input`, `select`, `textarea`, `form`.
+
+Targets Vue 3 and Nuxt projects. Unexpected syntax produces a `warning` entry rather than throwing, so partial results are always returned.
+
+## Part of UIC
+
+This package is part of [UIC (UI Contracts)](https://github.com/sherifkozman/uicontract) — making web app UIs machine-readable.
+
+## License
+
+[MIT](../../LICENSE)

package/dist/context-extractor.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Context extraction helpers for Vue SFC template AST.
+ * Extracts component names, routes, labels, handlers, data attributes,
+ * and conditional/dynamic flags from Vue template elements.
+ */
+/** Vue compiler-dom node prop with type 6 = attribute, type 7 = directive */
+interface VueAttributeNode {
+    type: 6;
+    name: string;
+    value?: {
+        content: string;
+    } | undefined;
+}
+interface VueDirectiveNode {
+    type: 7;
+    name: string;
+    arg?: {
+        content: string;
+    } | null;
+    exp?: {
+        content: string;
+    } | null;
+}
+type VuePropNode = VueAttributeNode | VueDirectiveNode;
+/** Vue compiler-dom element node (type 1) */
+interface VueElementNode {
+    type: 1;
+    tag: string;
+    props: VuePropNode[];
+    children: VueChildNode[];
+    loc: {
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+}
+/** Vue compiler-dom text node (type 2) */
+interface VueTextNode {
+    type: 2;
+    content: string;
+}
+/** Vue compiler-dom interpolation node (type 5) */
+interface VueInterpolationNode {
+    type: 5;
+    content: {
+        content: string;
+    };
+}
+type VueChildNode = VueElementNode | VueTextNode | VueInterpolationNode | {
+    type: number;
+};
+/**
+ * Extract a component name from the file path.
+ * Vue components are named by their filename: `MyComponent.vue` -> `MyComponent`.
+ */
+export declare function extractComponentName(filePath: string): string | null;
+/**
+ * Infer a Nuxt route from a file path.
+ * Files under a `pages/` directory map to routes:
+ * - `pages/index.vue` -> `/`
+ * - `pages/about.vue` -> `/about`
+ * - `pages/users/[id].vue` -> `/users/[id]`
+ */
+export declare function extractRoute(filePath: string, projectRoot: string): string | null;
+/**
+ * Extract the best human-readable label for a Vue template element.
+ * Priority: aria-label > text content children > placeholder
+ */
+export declare function extractLabel(node: VueElementNode): string | null;
+/**
+ * Extract the event handler name from Vue directives.
+ * @click="handleClick" → "handleClick"
+ * v-on:submit="handleSubmit" → "handleSubmit"
+ */
+export declare function extractHandler(node: VueElementNode): string | null;
+/**
+ * Collect all data-* attributes from a Vue element.
+ */
+export declare function extractDataAttributes(node: VueElementNode): Record<string, string>;
+/**
+ * Check if a node or any of its ancestors has v-if, v-else-if, v-else, or v-show.
+ */
+export declare function isConditional(node: VueElementNode, ancestors: VueElementNode[]): boolean;
+/**
+ * Check if any ancestor has a v-for directive.
+ */
+export declare function isDynamic(ancestors: VueElementNode[]): boolean;
+/**
+ * Check if a Vue element node has any event handler directives (@click, v-on:*, etc.)
+ */
+export declare function hasEventDirective(node: VueElementNode): boolean;
+export {};
+//# sourceMappingURL=context-extractor.d.ts.map

package/dist/context-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-extractor.d.ts","sourceRoot":"","sources":["../src/context-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,6EAA6E;AAC7E,UAAU,gBAAgB;IACxB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACzC;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClC;AAED,KAAK,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEvD,6CAA6C;AAC7C,UAAU,cAAc;IACtB,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,GAAG,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACzF;AAED,0CAA0C;AAC1C,UAAU,WAAW;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,UAAU,oBAAoB;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,KAAK,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,oBAAoB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAM3F;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpE;AAMD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjF;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CA+BhE;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAiClE;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUlF;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAcxF;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAO9D;AAeD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAW/D"}

package/dist/context-extractor.js

@@ -0,0 +1,192 @@
+/**
+ * Context extraction helpers for Vue SFC template AST.
+ * Extracts component names, routes, labels, handlers, data attributes,
+ * and conditional/dynamic flags from Vue template elements.
+ */
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// Component name
+// ---------------------------------------------------------------------------
+/**
+ * Extract a component name from the file path.
+ * Vue components are named by their filename: `MyComponent.vue` -> `MyComponent`.
+ */
+export function extractComponentName(filePath) {
+    const base = path.basename(filePath, '.vue');
+    return base || null;
+}
+// ---------------------------------------------------------------------------
+// Route extraction (Nuxt pages/ convention)
+// ---------------------------------------------------------------------------
+/**
+ * Infer a Nuxt route from a file path.
+ * Files under a `pages/` directory map to routes:
+ * - `pages/index.vue` -> `/`
+ * - `pages/about.vue` -> `/about`
+ * - `pages/users/[id].vue` -> `/users/[id]`
+ */
+export function extractRoute(filePath, projectRoot) {
+    const rel = path.relative(projectRoot, filePath).replace(/\\/g, '/');
+    const pagesIndex = rel.indexOf('pages/');
+    if (pagesIndex === -1)
+        return null;
+    const afterPages = rel.slice(pagesIndex + 'pages/'.length);
+    const withoutExt = afterPages.replace(/\.vue$/, '');
+    // index -> /
+    if (withoutExt === 'index') {
+        return '/';
+    }
+    // Remove trailing /index
+    const route = withoutExt.replace(/\/index$/, '');
+    return '/' + route;
+}
+// ---------------------------------------------------------------------------
+// Label extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the best human-readable label for a Vue template element.
+ * Priority: aria-label > text content children > placeholder
+ */
+export function extractLabel(node) {
+    // 1. aria-label attribute
+    for (const prop of node.props) {
+        if (prop.type === 6 && prop.name === 'aria-label' && prop.value) {
+            return prop.value.content;
+        }
+    }
+    // 2. Children text content
+    const textParts = [];
+    for (const child of node.children) {
+        if (child.type === 2) {
+            // TextNode
+            const trimmed = child.content.trim();
+            if (trimmed)
+                textParts.push(trimmed);
+        }
+        else if (child.type === 5) {
+            // InterpolationNode {{ expr }} — skip dynamic content
+        }
+    }
+    if (textParts.length > 0) {
+        return textParts.join(' ');
+    }
+    // 3. placeholder attribute
+    for (const prop of node.props) {
+        if (prop.type === 6 && prop.name === 'placeholder' && prop.value) {
+            return prop.value.content;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Handler extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the event handler name from Vue directives.
+ * @click="handleClick" → "handleClick"
+ * v-on:submit="handleSubmit" → "handleSubmit"
+ */
+export function extractHandler(node) {
+    const eventNames = ['click', 'submit', 'change', 'input', 'focus', 'blur', 'keydown', 'keyup', 'keypress'];
+    for (const prop of node.props) {
+        if (prop.type !== 7 || prop.name !== 'on')
+            continue;
+        const arg = prop.arg;
+        if (!arg || !eventNames.includes(arg.content))
+            continue;
+        const exp = prop.exp;
+        if (!exp)
+            continue;
+        const content = exp.content.trim();
+        // Simple identifier: handleClick
+        if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(content)) {
+            return content;
+        }
+        // Member expression: obj.method — extract last part
+        const dotMatch = /\.([a-zA-Z_$][a-zA-Z0-9_$]*)$/.exec(content);
+        if (dotMatch?.[1]) {
+            return dotMatch[1];
+        }
+        // Call expression: handleClick() — extract function name
+        const callMatch = /^([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\(/.exec(content);
+        if (callMatch?.[1]) {
+            return callMatch[1];
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Data attribute extraction
+// ---------------------------------------------------------------------------
+/**
+ * Collect all data-* attributes from a Vue element.
+ */
+export function extractDataAttributes(node) {
+    const result = {};
+    for (const prop of node.props) {
+        if (prop.type === 6 && prop.name.startsWith('data-')) {
+            result[prop.name] = prop.value?.content ?? '';
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Conditional detection
+// ---------------------------------------------------------------------------
+/**
+ * Check if a node or any of its ancestors has v-if, v-else-if, v-else, or v-show.
+ */
+export function isConditional(node, ancestors) {
+    // Check current node
+    if (hasDirective(node, ['if', 'else-if', 'else', 'show'])) {
+        return true;
+    }
+    // Check ancestors
+    for (const ancestor of ancestors) {
+        if (hasDirective(ancestor, ['if', 'else-if', 'else', 'show'])) {
+            return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Dynamic detection
+// ---------------------------------------------------------------------------
+/**
+ * Check if any ancestor has a v-for directive.
+ */
+export function isDynamic(ancestors) {
+    for (const ancestor of ancestors) {
+        if (hasDirective(ancestor, ['for'])) {
+            return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function hasDirective(node, names) {
+    for (const prop of node.props) {
+        if (prop.type === 7 && names.includes(prop.name)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a Vue element node has any event handler directives (@click, v-on:*, etc.)
+ */
+export function hasEventDirective(node) {
+    const eventNames = ['click', 'submit', 'change', 'input', 'focus', 'blur', 'keydown', 'keyup', 'keypress'];
+    for (const prop of node.props) {
+        if (prop.type === 7 && prop.name === 'on') {
+            const arg = prop.arg;
+            if (arg && eventNames.includes(arg.content)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=context-extractor.js.map

package/dist/context-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-extractor.js","sourceRoot":"","sources":["../src/context-extractor.ts"],"names":[],"mappings":"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"}

package/dist/file-discovery.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File discovery for Vue SFC files.
+ */
+import type { ParserOptions } from '@uicontract/core';
+/**
+ * Recursively discover .vue files in a directory.
+ */
+export declare function discoverFiles(dir: string, options: ParserOptions): Promise<string[]>;
+//# sourceMappingURL=file-discovery.d.ts.map

package/dist/file-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-discovery.d.ts","sourceRoot":"","sources":["../src/file-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAetD;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB"}

package/dist/file-discovery.js

@@ -0,0 +1,77 @@
+/**
+ * File discovery for Vue SFC files.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const DEFAULT_INCLUDE = ['**/*.vue'];
+const DEFAULT_EXCLUDE = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.nuxt/**',
+    '**/.output/**',
+    '**/coverage/**',
+    '**/__tests__/**',
+    '**/*.test.vue',
+    '**/*.spec.vue',
+];
+/**
+ * Recursively discover .vue files in a directory.
+ */
+export async function discoverFiles(dir, options) {
+    const includePatterns = options.include ?? DEFAULT_INCLUDE;
+    const excludePatterns = options.exclude ?? DEFAULT_EXCLUDE;
+    const maxDepth = options.maxDepth ?? 10;
+    const files = [];
+    await walkDir(dir, dir, files, includePatterns, excludePatterns, 0, maxDepth);
+    return files.sort();
+}
+async function walkDir(baseDir, currentDir, results, _include, _exclude, depth, maxDepth) {
+    if (depth > maxDepth)
+        return;
+    let entries;
+    try {
+        entries = await fs.readdir(currentDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
+        // Check excludes
+        if (isExcluded(relPath, entry.name, _exclude))
+            continue;
+        if (entry.isDirectory()) {
+            await walkDir(baseDir, fullPath, results, _include, _exclude, depth + 1, maxDepth);
+        }
+        else if (entry.isFile() && entry.name.endsWith('.vue')) {
+            results.push(fullPath);
+        }
+    }
+}
+function isExcluded(relPath, name, excludePatterns) {
+    for (const pattern of excludePatterns) {
+        // Simple pattern matching for common cases
+        if (pattern === '**/node_modules/**' && relPath.includes('node_modules'))
+            return true;
+        if (pattern === '**/dist/**' && relPath.includes('dist/'))
+            return true;
+        if (pattern === '**/build/**' && relPath.includes('build/'))
+            return true;
+        if (pattern === '**/.nuxt/**' && relPath.includes('.nuxt'))
+            return true;
+        if (pattern === '**/.output/**' && relPath.includes('.output'))
+            return true;
+        if (pattern === '**/coverage/**' && relPath.includes('coverage/'))
+            return true;
+        if (pattern === '**/__tests__/**' && relPath.includes('__tests__/'))
+            return true;
+        if (pattern === '**/*.test.vue' && name.endsWith('.test.vue'))
+            return true;
+        if (pattern === '**/*.spec.vue' && name.endsWith('.spec.vue'))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=file-discovery.js.map

package/dist/file-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-discovery.js","sourceRoot":"","sources":["../src/file-discovery.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @uicontract/parser-vue — Vue/Nuxt parser for UIC.
+ * Implements the Parser interface from @uicontract/core.
+ */
+import type { Parser, DiscoveryResult, ParserOptions } from '@uicontract/core';
+export declare const VERSION = "0.0.0";
+/** The Vue/Nuxt parser implementation. */
+export declare class VueParser implements Parser {
+    readonly framework = "vue";
+    detect(dir: string): Promise<boolean>;
+    discover(dir: string, options: ParserOptions): Promise<DiscoveryResult>;
+}
+export declare const vueParser: VueParser;
+export { discoverFiles } from './file-discovery.js';
+export { parseVueFile } from './sfc-visitor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAA6B,MAAM,kBAAkB,CAAC;AAI1G,eAAO,MAAM,OAAO,UAAU,CAAC;AAkC/B,0CAA0C;AAC1C,qBAAa,SAAU,YAAW,MAAM;IACtC,QAAQ,CAAC,SAAS,SAAS;IAErB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;CAiC9E;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * @uicontract/parser-vue — Vue/Nuxt parser for UIC.
+ * Implements the Parser interface from @uicontract/core.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { discoverFiles } from './file-discovery.js';
+import { parseVueFile } from './sfc-visitor.js';
+export const VERSION = '0.0.0';
+/** Detect whether a directory likely contains a Vue project. */
+async function detectVue(dir) {
+    // Check for package.json with vue or nuxt dependency
+    try {
+        const pkgPath = path.join(dir, 'package.json');
+        const raw = await fs.readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        const deps = {
+            ...(typeof pkg['dependencies'] === 'object' && pkg['dependencies'] !== null
+                ? pkg['dependencies']
+                : {}),
+            ...(typeof pkg['devDependencies'] === 'object' && pkg['devDependencies'] !== null
+                ? pkg['devDependencies']
+                : {}),
+            ...(typeof pkg['peerDependencies'] === 'object' && pkg['peerDependencies'] !== null
+                ? pkg['peerDependencies']
+                : {}),
+        };
+        if ('vue' in deps || 'nuxt' in deps)
+            return true;
+    }
+    catch {
+        // No package.json or unreadable — fall through to file check
+    }
+    // Fallback: any .vue file present
+    try {
+        const files = await discoverFiles(dir, { maxDepth: 3 });
+        return files.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** The Vue/Nuxt parser implementation. */
+export class VueParser {
+    framework = 'vue';
+    async detect(dir) {
+        return detectVue(dir);
+    }
+    async discover(dir, options) {
+        const startTime = Date.now();
+        const warnings = [];
+        const elements = [];
+        let filesSkipped = 0;
+        const files = await discoverFiles(dir, options);
+        for (const file of files) {
+            try {
+                const source = await fs.readFile(file, 'utf-8');
+                const fileElements = parseVueFile(source, file, dir);
+                elements.push(...fileElements);
+            }
+            catch (error) {
+                filesSkipped++;
+                warnings.push({
+                    code: 'PARSE_ERROR',
+                    message: `Failed to parse: ${error instanceof Error ? error.message : String(error)}`,
+                    filePath: path.relative(dir, file),
+                });
+            }
+        }
+        return {
+            elements,
+            warnings,
+            metadata: {
+                filesScanned: files.length,
+                filesSkipped,
+                scanDurationMs: Date.now() - startTime,
+            },
+        };
+    }
+}
+export const vueParser = new VueParser();
+// Re-export internal modules for consumers that need direct access
+export { discoverFiles } from './file-discovery.js';
+export { parseVueFile } from './sfc-visitor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/sfc-visitor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SFC template visitor that discovers interactive elements in Vue templates.
+ * Uses @vue/compiler-dom to parse the <template> block of .vue files.
+ */
+import type { RawElement } from '@uicontract/core';
+/**
+ * Parse a Vue SFC file and return discovered interactive elements.
+ */
+export declare function parseVueFile(source: string, absoluteFilePath: string, projectRoot: string): RawElement[];
+//# sourceMappingURL=sfc-visitor.d.ts.map

package/dist/sfc-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfc-visitor.d.ts","sourceRoot":"","sources":["../src/sfc-visitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AAoG3E;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,UAAU,EAAE,CA8Bd"}

package/dist/sfc-visitor.js

@@ -0,0 +1,115 @@
+/**
+ * SFC template visitor that discovers interactive elements in Vue templates.
+ * Uses @vue/compiler-dom to parse the <template> block of .vue files.
+ */
+import { parse as compilerParse } from '@vue/compiler-dom';
+import { extractComponentName, extractRoute, extractLabel, extractHandler, extractDataAttributes, isConditional, isDynamic, hasEventDirective, } from './context-extractor.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Interactive HTML element tag names that are always captured. */
+const ALWAYS_INTERACTIVE = new Set([
+    'button',
+    'input',
+    'select',
+    'textarea',
+    'a',
+    'form',
+]);
+/** Elements that are interactive only when they have event handlers. */
+const GENERIC_INTERACTIVE = new Set(['div', 'span', 'img', 'label']);
+/** All valid InteractiveElementType values. */
+const VALID_ELEMENT_TYPES = new Set([
+    'button', 'input', 'select', 'textarea', 'a', 'form',
+    'div', 'span', 'img', 'label',
+]);
+// ---------------------------------------------------------------------------
+// Template extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the template content and its line offset from a .vue SFC file.
+ * Returns null if no <template> block is found.
+ */
+function extractTemplate(source) {
+    const openTagPattern = /<template[^>]*>/;
+    const closeTag = '</template>';
+    const openMatch = openTagPattern.exec(source);
+    if (!openMatch)
+        return null;
+    const contentStart = openMatch.index + openMatch[0].length;
+    const closeIndex = source.lastIndexOf(closeTag);
+    if (closeIndex === -1 || closeIndex <= contentStart)
+        return null;
+    const content = source.slice(contentStart, closeIndex);
+    // Count newlines before the template content to calculate line offset
+    const lineOffset = source.slice(0, contentStart).split('\n').length - 1;
+    return { content, lineOffset };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a Vue SFC file and return discovered interactive elements.
+ */
+export function parseVueFile(source, absoluteFilePath, projectRoot) {
+    const template = extractTemplate(source);
+    if (!template)
+        return [];
+    let ast;
+    try {
+        ast = compilerParse(template.content);
+    }
+    catch {
+        return [];
+    }
+    const elements = [];
+    const componentName = extractComponentName(absoluteFilePath);
+    const route = extractRoute(absoluteFilePath, projectRoot);
+    const relFilePath = absoluteFilePath
+        .replace(/\\/g, '/')
+        .replace(projectRoot.replace(/\\/g, '/').replace(/\/?$/, '/'), '');
+    walkNode(ast, elements, relFilePath, componentName, route, template.lineOffset, []);
+    return elements;
+}
+// ---------------------------------------------------------------------------
+// AST walking
+// ---------------------------------------------------------------------------
+function walkNode(node, elements, filePath, componentName, route, lineOffset, ancestors) {
+    const children = node.children;
+    if (!children)
+        return;
+    for (const child of children) {
+        if (child.type === 1) {
+            // NodeTypes.ELEMENT
+            const elementNode = child;
+            processElement(elementNode, elements, filePath, componentName, route, lineOffset, ancestors);
+            walkNode(child, elements, filePath, componentName, route, lineOffset, [...ancestors, elementNode]);
+        }
+    }
+}
+function processElement(node, elements, filePath, componentName, route, lineOffset, ancestors) {
+    const tag = node.tag;
+    const isAlwaysInteractive = ALWAYS_INTERACTIVE.has(tag);
+    const isGenericWithHandler = GENERIC_INTERACTIVE.has(tag) && hasEventDirective(node);
+    if (!isAlwaysInteractive && !isGenericWithHandler)
+        return;
+    if (!VALID_ELEMENT_TYPES.has(tag))
+        return;
+    const elementType = tag;
+    const line = node.loc.start.line + lineOffset;
+    const column = node.loc.start.column;
+    elements.push({
+        type: elementType,
+        filePath,
+        line,
+        column,
+        componentName,
+        route,
+        label: extractLabel(node),
+        handler: extractHandler(node),
+        attributes: extractDataAttributes(node),
+        conditional: isConditional(node, ancestors),
+        dynamic: isDynamic(ancestors),
+    });
+}
+//# sourceMappingURL=sfc-visitor.js.map

package/dist/sfc-visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfc-visitor.js","sourceRoot":"","sources":["../src/sfc-visitor.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@uicontract/parser-vue",
+  "version": "0.1.0",
+  "description": "Vue and Nuxt parser for discovering interactive UI elements",
+  "type": "module",
+  "license": "MIT",
+  "author": "UIC Contributors",
+  "homepage": "https://github.com/sherifkozman/uicontract/tree/main/packages/parser-vue",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sherifkozman/uicontract.git",
+    "directory": "packages/parser-vue"
+  },
+  "bugs": {
+    "url": "https://github.com/sherifkozman/uicontract/issues"
+  },
+  "keywords": [
+    "uic",
+    "ui-contracts",
+    "parser",
+    "vue",
+    "nuxt",
+    "ast"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@vue/compiler-dom": "^3.5.0",
+    "@uicontract/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}