@uicontract/parser-react 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,48 @@
+# @uicontract/parser-react
+
+React and Next.js parser for discovering interactive UI elements.
+
+## Install
+
+```bash
+npm install @uicontract/parser-react
+```
+
+## Usage
+
+```typescript
+import { ReactParser } from '@uicontract/parser-react';
+
+const parser = new ReactParser();
+
+// Detect whether a project uses React
+const isReact = await parser.detect('/path/to/my-app');
+
+// Discover all interactive elements
+const { elements, warnings, metadata } = await parser.discover('/path/to/my-app', {
+  include: ['src/**/*.{tsx,jsx}'],
+});
+
+console.log(`Found ${elements.length} elements in ${metadata.filesScanned} files`);
+// elements: RawElement[] ready for @uicontract/namer
+```
+
+## API
+
+- **`ReactParser`**: Implements the `Parser` interface from `@uicontract/core`.
+  - **`detect(dir)`**: Returns `true` if the directory contains a React project.
+  - **`discover(dir, options)`**: AST-parses `.tsx` and `.jsx` files using `@babel/parser` and `@babel/traverse`. Returns `{ elements, warnings, metadata }`.
+
+Discovered element types: `button`, `a` (link), `input`, `select`, `textarea`, `form`.
+
+Supported patterns: JSX, TSX, `forwardRef`, `memo`, HOCs, dynamic imports, conditional rendering, file-based routing (Next.js).
+
+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,37 @@
+/**
+ * Context extraction helpers for the React AST visitor.
+ * Each function extracts a specific piece of metadata from a JSX element's path.
+ */
+import type { NodePath } from '@babel/traverse';
+import * as t from '@babel/types';
+/**
+ * Walk up the path ancestry to find the name of the enclosing React component.
+ * Handles function declarations, arrow functions assigned to variables,
+ * React.memo(), React.forwardRef(), and HOC wrappers.
+ */
+export declare function extractComponentName(nodePath: NodePath): string | null;
+/**
+ * Infer a Next.js route from a file path.
+ * Files under an `app/` directory named `page.tsx` or `layout.tsx` map to routes.
+ * All other files return null.
+ */
+export declare function extractRoute(filePath: string, projectRoot: string): string | null;
+/**
+ * Extract the best human-readable label for a JSX interactive element.
+ * Priority: aria-label > children text > placeholder
+ */
+export declare function extractLabel(openingPath: NodePath<t.JSXOpeningElement>): string | null;
+/** Extract the event handler name from event props like onClick, onSubmit, etc. */
+export declare function extractHandler(openingPath: NodePath<t.JSXOpeningElement>): string | null;
+/** Collect all data-* attributes from a JSX opening element. */
+export declare function extractDataAttributes(openingPath: NodePath<t.JSXOpeningElement>): Record<string, string>;
+/**
+ * Returns true if the path is nested inside a ConditionalExpression (ternary)
+ * or a LogicalExpression with && or ||.
+ */
+export declare function isConditional(nodePath: NodePath): boolean;
+/**
+ * Returns true if the path is nested inside a .map() or similar array iteration call.
+ */
+export declare function isDynamic(nodePath: NodePath): boolean;
+//# 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;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAMlC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CA4DtE;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBjF;AAwDD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,MAAM,GAAG,IAAI,CAyBtF;AAMD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,MAAM,GAAG,IAAI,CAyBxF;AAMD,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxG;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAkBzD;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAgBrD"}

package/dist/context-extractor.js

@@ -0,0 +1,259 @@
+/**
+ * Context extraction helpers for the React AST visitor.
+ * Each function extracts a specific piece of metadata from a JSX element's path.
+ */
+import * as path from 'node:path';
+import * as t from '@babel/types';
+// ---------------------------------------------------------------------------
+// Component name
+// ---------------------------------------------------------------------------
+/**
+ * Walk up the path ancestry to find the name of the enclosing React component.
+ * Handles function declarations, arrow functions assigned to variables,
+ * React.memo(), React.forwardRef(), and HOC wrappers.
+ */
+export function extractComponentName(nodePath) {
+    let current = nodePath.parentPath;
+    while (current) {
+        const node = current.node;
+        // Named function declaration: `function MyComponent() { ... }`
+        if (t.isFunctionDeclaration(node) && node.id) {
+            return node.id.name;
+        }
+        // Arrow function or function expression assigned to variable:
+        // `const MyComponent = () => ...`
+        if ((t.isArrowFunctionExpression(node) || t.isFunctionExpression(node)) &&
+            t.isVariableDeclarator(current.parent) &&
+            t.isIdentifier(current.parent.id)) {
+            return current.parent.id.name;
+        }
+        // Named function expression inside call (React.memo, React.forwardRef, HOC):
+        // `React.memo(function MyComponent() { ... })`
+        if (t.isFunctionExpression(node) && node.id) {
+            return node.id.name;
+        }
+        // Arrow/function inside a call expression (HOC wrapper, memo, forwardRef):
+        // `const Foo = withAuth(() => <div>...</div>)`
+        // `const Bar = React.memo(() => <div>...</div>)`
+        if ((t.isArrowFunctionExpression(node) || t.isFunctionExpression(node)) &&
+            t.isCallExpression(current.parent)) {
+            const callPath = current.parentPath;
+            if (callPath && t.isVariableDeclarator(callPath.parent) && t.isIdentifier(callPath.parent.id)) {
+                return callPath.parent.id.name;
+            }
+            // Nested calls: `React.memo(React.forwardRef(() => ...))`
+            if (callPath?.parentPath && t.isCallExpression(callPath.parentPath.node)) {
+                const outerCallPath = callPath.parentPath;
+                if (outerCallPath && t.isVariableDeclarator(outerCallPath.parent) && t.isIdentifier(outerCallPath.parent.id)) {
+                    return outerCallPath.parent.id.name;
+                }
+            }
+        }
+        // Class component: `class MyComponent extends React.Component { ... }`
+        if (t.isClassDeclaration(node) && node.id) {
+            return node.id.name;
+        }
+        if (t.isClassExpression(node) && node.id) {
+            return node.id.name;
+        }
+        current = current.parentPath;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Route extraction (Next.js App Router)
+// ---------------------------------------------------------------------------
+/**
+ * Infer a Next.js route from a file path.
+ * Files under an `app/` directory named `page.tsx` or `layout.tsx` map to routes.
+ * All other files return null.
+ */
+export function extractRoute(filePath, projectRoot) {
+    const rel = path.relative(projectRoot, filePath).replace(/\\/g, '/');
+    // Look for the app/ directory segment
+    const appIndex = rel.indexOf('app/');
+    if (appIndex === -1)
+        return null;
+    const afterApp = rel.slice(appIndex + 'app/'.length);
+    const fileName = path.basename(afterApp);
+    if (fileName !== 'page.tsx' && fileName !== 'page.jsx' && fileName !== 'layout.tsx' && fileName !== 'layout.jsx') {
+        return null;
+    }
+    const dirPart = path.dirname(afterApp).replace(/\\/g, '/');
+    if (dirPart === '.') {
+        return '/';
+    }
+    return '/' + dirPart;
+}
+// ---------------------------------------------------------------------------
+// Label extraction
+// ---------------------------------------------------------------------------
+/** Try to extract a string value from a JSXAttribute's value node. */
+function jsxAttrStringValue(attr) {
+    if (t.isStringLiteral(attr.value)) {
+        return attr.value.value;
+    }
+    if (t.isJSXExpressionContainer(attr.value)) {
+        const expr = attr.value.expression;
+        if (t.isStringLiteral(expr)) {
+            return expr.value;
+        }
+        if (t.isTemplateLiteral(expr) && expr.quasis.length === 1) {
+            const quasi = expr.quasis[0];
+            return quasi?.value.cooked ?? quasi?.value.raw ?? null;
+        }
+    }
+    return null;
+}
+/** Get the string name of a JSX attribute. */
+function attrName(attr) {
+    if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name)) {
+        return attr.name.name;
+    }
+    return null;
+}
+/** Find an attribute by name in a JSX opening element. */
+function findAttr(node, name) {
+    for (const attr of node.attributes) {
+        if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === name) {
+            return attr;
+        }
+    }
+    return undefined;
+}
+/** Extract visible text from JSX children (shallow — only literals). */
+function childrenText(jsxElement) {
+    const texts = [];
+    for (const child of jsxElement.children) {
+        if (t.isJSXText(child)) {
+            const trimmed = child.value.trim();
+            if (trimmed)
+                texts.push(trimmed);
+        }
+        else if (t.isJSXExpressionContainer(child) && t.isStringLiteral(child.expression)) {
+            texts.push(child.expression.value);
+        }
+    }
+    return texts.length > 0 ? texts.join(' ') : null;
+}
+/**
+ * Extract the best human-readable label for a JSX interactive element.
+ * Priority: aria-label > children text > placeholder
+ */
+export function extractLabel(openingPath) {
+    const node = openingPath.node;
+    // 1. aria-label
+    const ariaLabel = findAttr(node, 'aria-label');
+    if (ariaLabel) {
+        const val = jsxAttrStringValue(ariaLabel);
+        if (val)
+            return val;
+    }
+    // 2. children text — need access to the parent JSXElement
+    const parent = openingPath.parent;
+    if (t.isJSXElement(parent)) {
+        const text = childrenText(parent);
+        if (text)
+            return text;
+    }
+    // 3. placeholder
+    const placeholder = findAttr(node, 'placeholder');
+    if (placeholder) {
+        const val = jsxAttrStringValue(placeholder);
+        if (val)
+            return val;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Handler extraction
+// ---------------------------------------------------------------------------
+/** Extract the event handler name from event props like onClick, onSubmit, etc. */
+export function extractHandler(openingPath) {
+    const eventProps = ['onClick', 'onSubmit', 'onChange', 'onInput', 'onFocus', 'onBlur', 'onKeyDown', 'onKeyUp', 'onKeyPress'];
+    for (const attr of openingPath.node.attributes) {
+        if (!t.isJSXAttribute(attr))
+            continue;
+        const name = attrName(attr);
+        if (!name || !eventProps.includes(name))
+            continue;
+        if (!t.isJSXExpressionContainer(attr.value))
+            continue;
+        const expr = attr.value.expression;
+        // onClick={handleFoo}
+        if (t.isIdentifier(expr)) {
+            return expr.name;
+        }
+        // onClick={this.handleFoo}
+        if (t.isMemberExpression(expr) && t.isIdentifier(expr.property)) {
+            return expr.property.name;
+        }
+        // Inline arrow / complex expression → null
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Data attribute extraction
+// ---------------------------------------------------------------------------
+/** Collect all data-* attributes from a JSX opening element. */
+export function extractDataAttributes(openingPath) {
+    const result = {};
+    for (const attr of openingPath.node.attributes) {
+        if (!t.isJSXAttribute(attr))
+            continue;
+        const name = attrName(attr);
+        if (!name || !name.startsWith('data-'))
+            continue;
+        const val = jsxAttrStringValue(attr);
+        result[name] = val ?? '';
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Conditional / Dynamic detection
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the path is nested inside a ConditionalExpression (ternary)
+ * or a LogicalExpression with && or ||.
+ */
+export function isConditional(nodePath) {
+    let current = nodePath.parentPath;
+    while (current) {
+        if (t.isConditionalExpression(current.node))
+            return true;
+        if (t.isLogicalExpression(current.node) && (current.node.operator === '&&' || current.node.operator === '||')) {
+            return true;
+        }
+        // Stop at function boundaries
+        if (t.isFunctionDeclaration(current.node) ||
+            t.isFunctionExpression(current.node) ||
+            t.isArrowFunctionExpression(current.node)) {
+            break;
+        }
+        current = current.parentPath;
+    }
+    return false;
+}
+const DYNAMIC_CALLEES = new Set(['map', 'flatMap', 'reduce', 'filter', 'forEach', 'find', 'findIndex']);
+/**
+ * Returns true if the path is nested inside a .map() or similar array iteration call.
+ */
+export function isDynamic(nodePath) {
+    let current = nodePath.parentPath;
+    while (current) {
+        if (t.isCallExpression(current.node)) {
+            const callee = current.node.callee;
+            if (t.isMemberExpression(callee) && t.isIdentifier(callee.property)) {
+                if (DYNAMIC_CALLEES.has(callee.property.name))
+                    return true;
+            }
+        }
+        // Stop at function boundaries (but not arrow functions passed as callbacks)
+        if (t.isFunctionDeclaration(current.node)) {
+            break;
+        }
+        current = current.parentPath;
+    }
+    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/element-visitor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AST visitor that discovers interactive JSX elements in a parsed file.
+ */
+import type { RawElement } from '@uicontract/core';
+/** Parse a React/JSX/TS source file and return discovered interactive elements. */
+export declare function parseFile(source: string, absoluteFilePath: string, projectRoot: string): RawElement[];
+//# sourceMappingURL=element-visitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"element-visitor.d.ts","sourceRoot":"","sources":["../src/element-visitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AA+D3E,mFAAmF;AACnF,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,UAAU,EAAE,CAiEd"}

package/dist/element-visitor.js

@@ -0,0 +1,112 @@
+/**
+ * AST visitor that discovers interactive JSX elements in a parsed file.
+ */
+import { parse } from '@babel/parser';
+import _traverse from '@babel/traverse';
+import * as t from '@babel/types';
+import { extractComponentName, extractRoute, extractLabel, extractHandler, extractDataAttributes, isConditional, isDynamic, } from './context-extractor.js';
+// @babel/traverse ships as CJS; handle default import for ESM interop
+const traverse = (_traverse.default ?? _traverse);
+/** Interactive HTML element tag names that are always captured. */
+const ALWAYS_INTERACTIVE = new Set([
+    'button',
+    'input',
+    'select',
+    'textarea',
+    'a',
+    'form',
+]);
+/** JSX event handler prop names that make any element interactive. */
+const EVENT_HANDLER_PROPS = new Set([
+    'onClick',
+    'onSubmit',
+    'onChange',
+    'onInput',
+    'onFocus',
+    'onBlur',
+    'onKeyDown',
+    'onKeyUp',
+    'onKeyPress',
+]);
+/** Elements that can appear in InteractiveElementType but aren't always interactive. */
+const GENERIC_INTERACTIVE_TYPES = 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',
+]);
+function toInteractiveType(tagName) {
+    if (VALID_ELEMENT_TYPES.has(tagName)) {
+        return tagName;
+    }
+    return null;
+}
+/** Check whether a JSX opening element has any event handler props. */
+function hasEventHandlerProp(node) {
+    for (const attr of node.attributes) {
+        if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name)) {
+            if (EVENT_HANDLER_PROPS.has(attr.name.name))
+                return true;
+        }
+    }
+    return false;
+}
+/** Parse a React/JSX/TS source file and return discovered interactive elements. */
+export function parseFile(source, absoluteFilePath, projectRoot) {
+    const ast = parse(source, {
+        sourceType: 'module',
+        plugins: [
+            'typescript',
+            'jsx',
+            'decorators-legacy',
+            'classProperties',
+            'optionalChaining',
+            'nullishCoalescingOperator',
+        ],
+    });
+    const elements = [];
+    traverse(ast, {
+        JSXOpeningElement(nodePath) {
+            const nameNode = nodePath.node.name;
+            // Only handle plain HTML elements (lowercase tag names)
+            if (!t.isJSXIdentifier(nameNode))
+                return;
+            const tagName = nameNode.name;
+            const isAlwaysInteractive = ALWAYS_INTERACTIVE.has(tagName);
+            const isGenericWithHandler = GENERIC_INTERACTIVE_TYPES.has(tagName) && hasEventHandlerProp(nodePath.node);
+            if (!isAlwaysInteractive && !isGenericWithHandler)
+                return;
+            const elementType = toInteractiveType(tagName);
+            if (!elementType)
+                return;
+            const loc = nodePath.node.loc;
+            const line = loc?.start.line ?? 0;
+            const column = (loc?.start.column ?? 0) + 1; // convert 0-based to 1-based
+            const componentName = extractComponentName(nodePath);
+            const route = extractRoute(absoluteFilePath, projectRoot);
+            const label = extractLabel(nodePath);
+            const handler = extractHandler(nodePath);
+            const attributes = extractDataAttributes(nodePath);
+            const conditional = isConditional(nodePath);
+            const dynamic = isDynamic(nodePath);
+            const relFilePath = absoluteFilePath
+                .replace(/\\/g, '/')
+                .replace(projectRoot.replace(/\\/g, '/').replace(/\/?$/, '/'), '');
+            elements.push({
+                type: elementType,
+                filePath: relFilePath,
+                line,
+                column,
+                componentName,
+                route,
+                label,
+                handler,
+                attributes,
+                conditional,
+                dynamic,
+            });
+        },
+    });
+    return elements;
+}
+//# sourceMappingURL=element-visitor.js.map

package/dist/element-visitor.js.map

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

package/dist/file-discovery.d.ts

@@ -0,0 +1,11 @@
+/**
+ * File discovery for React/JSX projects.
+ * Finds .tsx/.jsx/.ts/.js files respecting include/exclude patterns and maxDepth.
+ */
+import type { ParserOptions } from '@uicontract/core';
+/**
+ * Discovers React/JSX source files in the given directory.
+ * Returns absolute paths.
+ */
+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;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA4FtD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ1F"}

package/dist/file-discovery.js

@@ -0,0 +1,102 @@
+/**
+ * File discovery for React/JSX projects.
+ * Finds .tsx/.jsx/.ts/.js files respecting include/exclude patterns and maxDepth.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const DEFAULT_INCLUDE = ['**/*.tsx', '**/*.jsx'];
+const DEFAULT_EXCLUDE = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.next/**',
+    '**/build/**',
+    '**/.cache/**',
+    '**/coverage/**',
+];
+const DEFAULT_MAX_DEPTH = 20;
+/**
+ * Converts a glob pattern segment to a RegExp source string.
+ * Supports `**`, `*`, `?`, and literal characters.
+ */
+function globToRegex(glob) {
+    let pattern = '^';
+    let i = 0;
+    while (i < glob.length) {
+        const char = glob[i];
+        if (char === '*' && glob[i + 1] === '*') {
+            // ** matches any number of path segments including none
+            pattern += '(?:.+/)?';
+            i += 2;
+            // skip trailing slash if present
+            if (glob[i] === '/')
+                i++;
+        }
+        else if (char === '*') {
+            // * matches any character except /
+            pattern += '[^/]*';
+            i++;
+        }
+        else if (char === '?') {
+            pattern += '[^/]';
+            i++;
+        }
+        else if ('.+^${}()|[]\\'.includes(char ?? '')) {
+            pattern += '\\' + char;
+            i++;
+        }
+        else {
+            pattern += char;
+            i++;
+        }
+    }
+    pattern += '$';
+    return new RegExp(pattern);
+}
+function matchesAny(relPath, patterns) {
+    const normalized = relPath.replace(/\\/g, '/');
+    return patterns.some((glob) => {
+        const regex = globToRegex(glob);
+        return regex.test(normalized);
+    });
+}
+/**
+ * Recursively walks a directory and collects files that match include patterns
+ * and don't match exclude patterns, up to maxDepth levels deep.
+ */
+async function walkDir(dir, rootDir, include, exclude, maxDepth, currentDepth, results) {
+    if (currentDepth > maxDepth)
+        return;
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        // Unreadable directory — skip silently
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(rootDir, fullPath).replace(/\\/g, '/');
+        if (matchesAny(relPath, exclude))
+            continue;
+        if (entry.isDirectory()) {
+            await walkDir(fullPath, rootDir, include, exclude, maxDepth, currentDepth + 1, results);
+        }
+        else if (entry.isFile() && matchesAny(relPath, include)) {
+            results.push(fullPath);
+        }
+    }
+}
+/**
+ * Discovers React/JSX source files in the given directory.
+ * Returns absolute paths.
+ */
+export async function discoverFiles(dir, options) {
+    const include = options.include ?? DEFAULT_INCLUDE;
+    const exclude = options.exclude ?? DEFAULT_EXCLUDE;
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const results = [];
+    await walkDir(dir, dir, include, exclude, maxDepth, 0, results);
+    return results;
+}
+//# 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-react — React/JSX 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 React/Next.js parser implementation. */
+export declare class ReactParser implements Parser {
+    readonly framework = "react";
+    detect(dir: string): Promise<boolean>;
+    discover(dir: string, options: ParserOptions): Promise<DiscoveryResult>;
+}
+export declare const reactParser: ReactParser;
+export { discoverFiles } from './file-discovery.js';
+export { parseFile } from './element-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;AA4B/B,+CAA+C;AAC/C,qBAAa,WAAY,YAAW,MAAM;IACxC,QAAQ,CAAC,SAAS,WAAW;IAEvB,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,WAAW,aAAoB,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,79 @@
+/**
+ * @uicontract/parser-react — React/JSX 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 { parseFile } from './element-visitor.js';
+export const VERSION = '0.0.0';
+/** Detect whether a directory likely contains a React project. */
+async function detectReact(dir) {
+    // Check for package.json with react 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 ('react' in deps)
+            return true;
+    }
+    catch {
+        // No package.json or unreadable — fall through to file check
+    }
+    // Fallback: any .tsx or .jsx file present
+    try {
+        const files = await discoverFiles(dir, { include: ['**/*.tsx', '**/*.jsx'], maxDepth: 3 });
+        return files.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** The React/Next.js parser implementation. */
+export class ReactParser {
+    framework = 'react';
+    async detect(dir) {
+        return detectReact(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 = parseFile(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 reactParser = new ReactParser();
+// Re-export internal modules for consumers that need direct access
+export { discoverFiles } from './file-discovery.js';
+export { parseFile } from './element-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/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@uicontract/parser-react",
+  "version": "0.1.0",
+  "description": "React and Next.js parser for discovering interactive UI elements",
+  "type": "module",
+  "license": "MIT",
+  "author": "UIC Contributors",
+  "homepage": "https://github.com/sherifkozman/uicontract/tree/main/packages/parser-react",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sherifkozman/uicontract.git",
+    "directory": "packages/parser-react"
+  },
+  "bugs": {
+    "url": "https://github.com/sherifkozman/uicontract/issues"
+  },
+  "keywords": [
+    "uic",
+    "ui-contracts",
+    "parser",
+    "react",
+    "nextjs",
+    "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": {
+    "@babel/parser": "^7.29.0",
+    "@babel/traverse": "^7.29.0",
+    "@babel/types": "^7.29.0",
+    "@uicontract/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/babel__traverse": "^7.28.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}