@rn-ave/core 0.1.0

package/dist/context/formatter.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatForAgent = formatForAgent;
+exports.formatCompact = formatCompact;
+exports.formatForTerminal = formatForTerminal;
+const source_1 = require("../fiber/source");
+/**
+ * Formats extracted context as markdown for AI agents
+ */
+function formatForAgent(context) {
+    const lines = [];
+    lines.push(`## Selected Component: ${context.componentName}`);
+    lines.push('');
+    // File location
+    if (context.source) {
+        lines.push(`### File`);
+        lines.push(`\`${(0, source_1.formatSourceLocation)(context.source)}\``);
+        lines.push('');
+    }
+    // Component hierarchy
+    if (context.componentHierarchy.length > 0) {
+        lines.push(`### Component Hierarchy`);
+        lines.push('```');
+        context.componentHierarchy.forEach((name, i) => {
+            const indent = '  '.repeat(i);
+            lines.push(`${indent}<${name}>`);
+        });
+        lines.push('```');
+        lines.push('');
+    }
+    // Props
+    if (Object.keys(context.props).length > 0) {
+        lines.push(`### Props`);
+        lines.push('```json');
+        lines.push(JSON.stringify(context.props, null, 2));
+        lines.push('```');
+        lines.push('');
+    }
+    // JSX Preview
+    lines.push(`### JSX Preview`);
+    lines.push('```jsx');
+    lines.push(context.jsxPreview);
+    lines.push('```');
+    lines.push('');
+    lines.push('---');
+    lines.push(`*Captured at ${new Date(context.timestamp).toLocaleTimeString()}*`);
+    return lines.join('\n');
+}
+/**
+ * Formats context as compact single-line (for clipboard)
+ */
+function formatCompact(context) {
+    const parts = [];
+    parts.push(context.componentName);
+    if (context.source) {
+        parts.push(`at ${(0, source_1.formatSourceLocation)(context.source)}`);
+    }
+    if (context.componentHierarchy.length > 1) {
+        parts.push(`in ${context.componentHierarchy[context.componentHierarchy.length - 1]}`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Formats context for terminal/console output
+ */
+function formatForTerminal(context) {
+    const lines = [];
+    const divider = '─'.repeat(50);
+    lines.push('');
+    lines.push(`┌${divider}┐`);
+    lines.push(`│ 🔍 RN-AVE: ${context.componentName.padEnd(32)} │`);
+    lines.push(`├${divider}┤`);
+    if (context.source) {
+        lines.push(`│ 📁 ${(0, source_1.formatSourceLocation)(context.source).padEnd(45)} │`);
+    }
+    if (context.componentHierarchy.length > 0) {
+        const hierarchy = context.componentHierarchy.slice(0, 5).join(' → ');
+        lines.push(`│ 🏗️  ${hierarchy.substring(0, 44).padEnd(44)} │`);
+    }
+    if (Object.keys(context.props).length > 0) {
+        lines.push(`├${divider}┤`);
+        lines.push(`│ Props:${' '.repeat(42)} │`);
+        const propsStr = JSON.stringify(context.props, null, 2);
+        propsStr.split('\n').slice(0, 6).forEach(line => {
+            const trimmed = line.substring(0, 46);
+            lines.push(`│   ${trimmed.padEnd(46)} │`);
+        });
+        if (propsStr.split('\n').length > 6) {
+            lines.push(`│   ...${' '.repeat(43)} │`);
+        }
+    }
+    lines.push(`└${divider}┘`);
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/devMenu.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Dev Menu Integration for React Native and Expo
+ * Adds "Toggle Inspector" to the development menu
+ *
+ * Works with:
+ * - React Native CLI: Shake or Cmd+D (iOS) / Cmd+M (Android)
+ * - Expo Dev Client: Shake or three-finger long press
+ * - Expo Go: Shake gesture
+ */
+/**
+ * Register the inspector toggle in the dev menu
+ * Call this once when the Inspector component mounts
+ */
+export declare function registerDevMenuToggle(onToggle: () => void): void;
+/**
+ * Update the toggle callback (when component re-renders)
+ */
+export declare function updateDevMenuCallback(onToggle: () => void): void;
+/**
+ * Check if dev menu is available
+ */
+export declare function isDevMenuAvailable(): boolean;
+/**
+ * Instructions for opening dev menu on different platforms
+ */
+export declare function getDevMenuInstructions(): string;

package/dist/devMenu.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Dev Menu Integration for React Native and Expo
+ * Adds "Toggle Inspector" to the development menu
+ *
+ * Works with:
+ * - React Native CLI: Shake or Cmd+D (iOS) / Cmd+M (Android)
+ * - Expo Dev Client: Shake or three-finger long press
+ * - Expo Go: Shake gesture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDevMenuToggle = registerDevMenuToggle;
+exports.updateDevMenuCallback = updateDevMenuCallback;
+exports.isDevMenuAvailable = isDevMenuAvailable;
+exports.getDevMenuInstructions = getDevMenuInstructions;
+const react_native_1 = require("react-native");
+let isRegistered = false;
+let toggleCallback = null;
+/**
+ * Register the inspector toggle in the dev menu
+ * Call this once when the Inspector component mounts
+ */
+function registerDevMenuToggle(onToggle) {
+    if (typeof __DEV__ === 'undefined' || !__DEV__)
+        return;
+    toggleCallback = onToggle;
+    if (isRegistered)
+        return;
+    isRegistered = true;
+    registerWithDevSettings(onToggle);
+}
+/**
+ * Update the toggle callback (when component re-renders)
+ */
+function updateDevMenuCallback(onToggle) {
+    toggleCallback = onToggle;
+}
+/**
+ * Register with React Native's DevSettings
+ */
+function registerWithDevSettings(onToggle) {
+    try {
+        if (react_native_1.DevSettings && typeof react_native_1.DevSettings.addMenuItem === 'function') {
+            react_native_1.DevSettings.addMenuItem('Toggle Dev Inspector', () => {
+                toggleCallback?.();
+            });
+        }
+    }
+    catch {
+        // DevSettings not available (might be production build)
+    }
+}
+/**
+ * Check if dev menu is available
+ */
+function isDevMenuAvailable() {
+    if (typeof __DEV__ === 'undefined' || !__DEV__)
+        return false;
+    try {
+        if (react_native_1.DevSettings && typeof react_native_1.DevSettings.addMenuItem === 'function') {
+            return true;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return false;
+}
+/**
+ * Instructions for opening dev menu on different platforms
+ */
+function getDevMenuInstructions() {
+    if (react_native_1.Platform.OS === 'ios') {
+        return 'Shake device or press Cmd+D to open dev menu, then tap "Toggle Dev Inspector"';
+    }
+    else if (react_native_1.Platform.OS === 'android') {
+        return 'Shake device or press Cmd+M to open dev menu, then tap "Toggle Dev Inspector"';
+    }
+    return 'Shake device to open dev menu, then tap "Toggle Dev Inspector"';
+}

package/dist/editor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Editor launching utilities
+ * Only Cursor is supported.
+ */
+import type { SourceLocation } from './types';
+export interface LaunchEditorOptions {
+    /** Source code information */
+    source: SourceLocation;
+    /** Editor name - only 'cursor' is supported */
+    editor?: string;
+    /** Dev server URL (for Metro-based launching) */
+    devServerUrl?: string;
+}
+/**
+ * Main function to launch Cursor editor
+ * Tries multiple methods:
+ * 1. URL scheme (deep linking)
+ * 2. Metro inspector endpoint
+ */
+export declare function launchEditor(options: LaunchEditorOptions): Promise<boolean>;

package/dist/editor.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Editor launching utilities
+ * Only Cursor is supported.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchEditor = launchEditor;
+const react_native_1 = require("react-native");
+/**
+ * Default dev server URL based on platform
+ */
+function getDefaultDevServerUrl() {
+    if (react_native_1.Platform.OS === 'android') {
+        return 'http://10.0.2.2:8081';
+    }
+    return 'http://localhost:8081';
+}
+/**
+ * Build query string for editor endpoint
+ */
+function buildEditorQueryString(source) {
+    const params = new URLSearchParams();
+    params.set('file', source.file);
+    if (source.line) {
+        params.set('line', String(source.line));
+    }
+    if (source.column) {
+        params.set('column', String(source.column));
+    }
+    params.set('editor', 'cursor');
+    return params.toString();
+}
+/**
+ * Launch editor via standard inspector endpoint
+ */
+async function launchEditorViaInspector(options) {
+    const { source, devServerUrl } = options;
+    const baseUrl = devServerUrl || getDefaultDevServerUrl();
+    const queryString = buildEditorQueryString(source);
+    const url = `${baseUrl}/__inspect-open-in-editor?${queryString}`;
+    try {
+        const response = await fetch(url, { method: 'GET' });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Try to launch Cursor via URL scheme (deep linking)
+ */
+async function launchEditorViaUrlScheme(source) {
+    const { file, line, column } = source;
+    const url = `cursor://file${file}:${line}:${column || 1}`;
+    try {
+        const canOpen = await react_native_1.Linking.canOpenURL(url);
+        if (canOpen) {
+            await react_native_1.Linking.openURL(url);
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Main function to launch Cursor editor
+ * Tries multiple methods:
+ * 1. URL scheme (deep linking)
+ * 2. Metro inspector endpoint
+ */
+async function launchEditor(options) {
+    const { source } = options;
+    console.log('\n🚀 [rn-ave] launchEditor called');
+    console.log('  source:', source);
+    // Try URL scheme first
+    console.log('  Trying URL scheme...');
+    const urlSuccess = await launchEditorViaUrlScheme(source);
+    console.log('  URL scheme result:', urlSuccess);
+    if (urlSuccess) {
+        return true;
+    }
+    // Try Metro inspector endpoint
+    console.log('  Trying Metro inspector endpoint...');
+    const inspectorSuccess = await launchEditorViaInspector(options);
+    console.log('  Inspector endpoint result:', inspectorSuccess);
+    if (inspectorSuccess) {
+        return true;
+    }
+    console.log('  All methods failed');
+    return false;
+}

package/dist/fiber/hook.d.ts

@@ -0,0 +1,18 @@
+import type { FiberRoot, RNDevToolsHook } from '../types';
+/**
+ * Installs the DevTools hook to capture React fiber tree
+ * Must be called BEFORE React Native initializes
+ */
+export declare function installHook(): RNDevToolsHook;
+/**
+ * Gets the current fiber root (usually there's only one in RN)
+ */
+export declare function getFiberRoot(): FiberRoot | null;
+/**
+ * Debug function to log hook state
+ */
+export declare function debugHookState(): void;
+/**
+ * Checks if the hook has been installed
+ */
+export declare function isHookInstalled(): boolean;

package/dist/fiber/hook.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installHook = installHook;
+exports.getFiberRoot = getFiberRoot;
+exports.debugHookState = debugHookState;
+exports.isHookInstalled = isHookInstalled;
+// Storage for fiber roots
+const fiberRoots = new Map();
+let hookInstalled = false;
+/**
+ * Wraps an existing DevTools hook to capture fiber roots
+ */
+function wrapExistingHook(existingHook) {
+    const originalOnCommit = existingHook.onCommitFiberRoot;
+    existingHook.onCommitFiberRoot = function (rendererID, root) {
+        fiberRoots.set(rendererID, root);
+        if (originalOnCommit) {
+            originalOnCommit.call(this, rendererID, root);
+        }
+    };
+    return existingHook;
+}
+/**
+ * Installs the DevTools hook to capture React fiber tree
+ * Must be called BEFORE React Native initializes
+ */
+function installHook() {
+    if (hookInstalled) {
+        return globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+    }
+    // Check if hook already exists
+    if (globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__) {
+        hookInstalled = true;
+        return wrapExistingHook(globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__);
+    }
+    // Create our own hook
+    const hook = {
+        renderers: new Map(),
+        inject(renderer) {
+            const id = this.renderers.size + 1;
+            this.renderers.set(id, renderer);
+            return id;
+        },
+        onCommitFiberRoot(rendererID, root) {
+            fiberRoots.set(rendererID, root);
+        },
+        onCommitFiberUnmount(_rendererID, _fiber) {
+            // Cleanup references if needed
+        },
+        getFiberRoots(rendererID) {
+            const root = fiberRoots.get(rendererID);
+            return root ? new Set([root]) : new Set();
+        }
+    };
+    globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__ = hook;
+    hookInstalled = true;
+    return hook;
+}
+/**
+ * Gets the current fiber root (usually there's only one in RN)
+ */
+function getFiberRoot() {
+    // Try to get from stored roots
+    for (const root of fiberRoots.values()) {
+        if (root && root.current) {
+            return root;
+        }
+    }
+    // Try to get from DevTools hook
+    const hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+    if (hook?.getFiberRoots) {
+        for (const rendererID of hook.renderers.keys()) {
+            const roots = hook.getFiberRoots(rendererID);
+            for (const root of roots) {
+                if (root && root.current) {
+                    return root;
+                }
+            }
+        }
+    }
+    // Last resort: try to find fiber from any stored root
+    if (hook?.renderers) {
+        for (const [id] of hook.renderers) {
+            const roots = fiberRoots.get(id);
+            if (roots && roots.current) {
+                return roots;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Debug function to log hook state
+ */
+function debugHookState() {
+    // Debug logging disabled
+}
+/**
+ * Checks if the hook has been installed
+ */
+function isHookInstalled() {
+    return hookInstalled;
+}

package/dist/fiber/source.d.ts

@@ -0,0 +1,21 @@
+import type { Fiber, SourceLocation } from '../types';
+/**
+ * Extracts source location from a fiber node (non-recursive)
+ */
+export declare function getSourceLocation(fiber: Fiber): SourceLocation | null;
+/**
+ * Recursive version of getSourceLocation that follows _debugOwner
+ */
+export declare function getSourceLocationRecursive(fiber: Fiber): SourceLocation | null;
+/**
+ * Checks if a fiber's source location is from node_modules
+ */
+export declare function isFromNodeModules(fiber: Fiber): boolean;
+/**
+ * Formats source location as a readable string
+ */
+export declare function formatSourceLocation(source: SourceLocation | null): string;
+/**
+ * Gets relative path from absolute path (simple version)
+ */
+export declare function getRelativePath(absolutePath: string, rootDir?: string): string;

package/dist/fiber/source.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSourceLocation = getSourceLocation;
+exports.getSourceLocationRecursive = getSourceLocationRecursive;
+exports.isFromNodeModules = isFromNodeModules;
+exports.formatSourceLocation = formatSourceLocation;
+exports.getRelativePath = getRelativePath;
+/**
+ * Extracts source location from a fiber node (non-recursive)
+ */
+function getSourceLocation(fiber) {
+    // Strategy 1: Try custom prop from our Babel plugin (PRIMARY)
+    const rnAveMeta = fiber.memoizedProps?.__rnAve;
+    if (rnAveMeta && rnAveMeta.file) {
+        console.log('  [source] Found via __rnAve prop:', rnAveMeta.file);
+        return {
+            file: rnAveMeta.file,
+            line: rnAveMeta.line,
+            column: rnAveMeta.column,
+        };
+    }
+    // Strategy 2: Try __rnInspect (legacy or standard RN metadata - FALLBACK)
+    const rnInspect = fiber.memoizedProps?.__rnInspect;
+    if (rnInspect) {
+        if (rnInspect.fileName) {
+            console.log('  [source] Found via __rnInspect (fileName):', rnInspect.fileName);
+            return {
+                file: rnInspect.fileName,
+                line: rnInspect.lineNumber,
+                column: rnInspect.columnNumber,
+            };
+        }
+        if (rnInspect.file) {
+            console.log('  [source] Found via __rnInspect (file):', rnInspect.file);
+            return {
+                file: rnInspect.file,
+                line: rnInspect.line,
+                column: rnInspect.column,
+            };
+        }
+    }
+    // Strategy 3: Try _debugSource (React development mode)
+    if (fiber._debugSource) {
+        console.log('  [source] Found via _debugSource:', fiber._debugSource.fileName);
+        return {
+            file: fiber._debugSource.fileName,
+            line: fiber._debugSource.lineNumber,
+            column: fiber._debugSource.columnNumber,
+        };
+    }
+    return null;
+}
+/**
+ * Recursive version of getSourceLocation that follows _debugOwner
+ */
+function getSourceLocationRecursive(fiber) {
+    const localSource = getSourceLocation(fiber);
+    if (localSource)
+        return localSource;
+    if (fiber._debugOwner) {
+        return getSourceLocationRecursive(fiber._debugOwner);
+    }
+    return null;
+}
+/**
+ * Checks if a fiber's source location is from node_modules
+ */
+function isFromNodeModules(fiber) {
+    const source = getSourceLocation(fiber);
+    if (!source?.file)
+        return false;
+    return source.file.includes('node_modules');
+}
+/**
+ * Formats source location as a readable string
+ */
+function formatSourceLocation(source) {
+    if (!source)
+        return 'Unknown location';
+    const column = source.column ? `:${source.column}` : '';
+    return `${source.file}:${source.line}${column}`;
+}
+/**
+ * Gets relative path from absolute path (simple version)
+ */
+function getRelativePath(absolutePath, rootDir) {
+    if (!rootDir)
+        return absolutePath;
+    // Simple relative path calculation
+    if (absolutePath.startsWith(rootDir)) {
+        return absolutePath.slice(rootDir.length + 1);
+    }
+    return absolutePath;
+}

package/dist/fiber/traversal.d.ts

@@ -0,0 +1,27 @@
+import type { Fiber, FiberRoot, ComponentInfo } from '../types';
+/**
+ * Finds a fiber node by its native tag
+ */
+export declare function findFiberByNativeTag(nativeTag: number, fiberRoot: FiberRoot): Fiber | null;
+/**
+ * Gets the display name of a component from its fiber
+ */
+export declare function getDisplayName(fiber: Fiber): string;
+/**
+ * Gets the component hierarchy from a fiber node up to the root
+ */
+export declare function getComponentHierarchy(fiber: Fiber): ComponentInfo[];
+/**
+ * Gets all props from a fiber, excluding internal ones
+ */
+export declare function getCleanProps(fiber: Fiber): Record<string, any>;
+/**
+ * Finds the nearest composite component ancestor
+ * @param fiber - The starting fiber node
+ * @param skipNodeModules - If true, skips components from node_modules and returns the nearest user-code component
+ */
+export declare function findNearestComposite(fiber: Fiber, skipNodeModules?: boolean): Fiber | null;
+/**
+ * Collects all host component fibers (View, Text, etc.) from the tree
+ */
+export declare function collectAllHostFibers(fiberRoot: FiberRoot): Fiber[];