viewgate-wrapper 1.11.13 → 1.11.14

package/README.md

@@ -11,39 +11,58 @@ npm install viewgate-wrapper
 
 ---
 
-## 🚀 Framework Configuration
+## 🚀 Precision Mapping (New)
 
-To enable **Smart Source Mapping** (allowing AI to pinpoint the exact file and line of code for a change), you must configure the plugin for your specific framework.
+ViewGate features a **Hybrid Precision Strategy** to ensure AI-driven code changes are 100% accurate.
 
-### ⚡ Vite
-Add the plugin to your `vite.config.ts`:
+### ⚡ Vite (Recommended)
+Add it to `vite.config.ts`. Injects stable `data-vg-id` attributes.
 
 ```typescript
 import { viewgatePlugin } from 'viewgate-wrapper';
 
 export default defineConfig({
   plugins: [
-    // ...
+    react(),
     viewgatePlugin()
   ]
 });
 ```
 
-### 🌑 Next.js
-Add the custom loader to your `next.config.js` (Webpack-based):
+### 📦 Webpack (Next.js, CRA, Custom)
+Add the loader to your `webpack.config.js` or `next.config.js`:
 
 ```javascript
+// next.config.js or webpack.config.js
 module.exports = {
   webpack: (config) => {
     config.module.rules.push({
       test: /\.(tsx|jsx)$/,
-      use: [{ loader: 'viewgate-wrapper/next-loader' }],
+      exclude: /node_modules/,
+      use: [{ loader: 'viewgate-wrapper/dist/plugin/webpack-loader' }],
     });
     return config;
   },
 };
 ```
-*Note: SWC support for Next.js 13+ is in development.*
+
+### 🍄 Babel (Universal)
+If you are using a custom Babel setup (e.g., with `@babel/preset-react`), add the plugin to your `.babelrc` or `babel.config.js`:
+
+```json
+{
+  "plugins": ["viewgate-wrapper/dist/plugin/babel-plugin-viewgate"]
+}
+```
+
+### ⚛️ Zero-Config React (Fiber Fallback)
+If you can't use a build-time plugin, ViewGate automatically uses **React Fiber Detection** in development.
+- **Precision**: High (Line/Column level).
+- **Setup**: None. Works out of the box by inspecting the React tree.
+- **Heuristics**: Uses **Semantic Fingerprinting** (Tag + ARIA + Roles + Hierarchy) as a safety net.
+
+> [!IMPORTANT]
+> To achieve "Surgical Precision", we recommend using a build-time plugin (Vite, Webpack, or Babel) whenever possible.
 
 ---
 

package/dist/cli.js

@@ -3,6 +3,7 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 import { fileURLToPath } from 'url';
+import { detectFramework, injectVitePlugin, injectNextPlugin } from './plugin/config-injectors.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 async function setup() {
@@ -44,6 +45,35 @@ async function setup() {
             console.log(`   ${configPath}`);
             console.log('   Puedes encontrar tu API_KEY en el Dashboard de ViewGate.');
         }
+        // 4. Framework Detection and Plugin Auto-Config
+        console.log('\n🔍 Detecting framework for High-Precision Mapping...');
+        const cwd = process.cwd();
+        const result = detectFramework(cwd);
+        if (result.framework === 'vite' && result.configPath) {
+            console.log(`✨ Vite detected! Attempting to apply viewgatePlugin to: ${path.basename(result.configPath)}`);
+            if (injectVitePlugin(result.configPath)) {
+                console.log('✅ viewgatePlugin applied successfully!');
+            }
+            else {
+                console.log('⚠️  Could not auto-apply plugin. Please follow manual setup in README.');
+            }
+        }
+        else if (result.framework === 'next' && result.configPath) {
+            console.log(`✨ Next.js detected! Attempting to apply webpack loader to: ${path.basename(result.configPath)}`);
+            if (injectNextPlugin(result.configPath)) {
+                console.log('✅ next-loader applied successfully!');
+            }
+            else {
+                console.log('⚠️  Could not auto-apply plugin. Please follow manual setup in README.');
+            }
+        }
+        else if (result.framework !== 'unknown') {
+            console.log(`✨ ${result.framework.toUpperCase()} detected!`);
+            console.log(`👉 Please follow the manual setup for ${result.framework} in the README to enable High-Precision mapping.`);
+        }
+        else {
+            console.log('❓ Could not determine framework. High-Precision mapping might require manual setup.');
+        }
     }
     catch (error) {
         console.error(`❌ Error updating configuration: ${error.message}`);

package/dist/components/ViewGateOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewGateOverlay.d.ts","sourceRoot":"","sources":["../../src/components/ViewGateOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAwBnF,OAAO,wBAAwB,CAAC;AAo0BhC,eAAO,MAAM,eAAe,EAAE,EAkvE7B,CAAC"}
+{"version":3,"file":"ViewGateOverlay.d.ts","sourceRoot":"","sources":["../../src/components/ViewGateOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAwBnF,OAAO,wBAAwB,CAAC;AA21BhC,eAAO,MAAM,eAAe,EAAE,EAkvE7B,CAAC"}

package/dist/components/ViewGateProvider.d.ts

@@ -135,9 +135,15 @@ export interface SemanticReference {
     parentContext: string;
     componentPath?: string;
     vgPath?: string;
+    vgId?: string | undefined;
     signature?: string;
     source?: string;
     attributes?: Record<string, string>;
+    confidence?: {
+        vgId: number;
+        fiber: number;
+        fingerprint: number;
+    } | undefined;
     normalizedOffset?: {
         x: number;
         y: number;
@@ -161,6 +167,7 @@ export interface SemanticReference {
             text: string;
             role?: string | undefined;
             type?: string | undefined;
+            location?: string | undefined;
         } | undefined;
         siblings?: Array<{
             tag: string;

package/dist/components/ViewGateProvider.d.ts.map

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

package/dist/plugin/babel-plugin-viewgate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Babel plugin to inject source mapping attributes.
+ * Since we want to keep logic at the source level consistent,
+ * this plugin uses the same transformSourcePaths logic.
+ */
+export default function babelPluginViewGate(): {
+    name: string;
+    visitor: {
+        Program(path: any, state: any): void;
+    };
+};
+//# sourceMappingURL=babel-plugin-viewgate.d.ts.map

package/dist/plugin/babel-plugin-viewgate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"babel-plugin-viewgate.d.ts","sourceRoot":"","sources":["../../src/plugin/babel-plugin-viewgate.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB;;;sBAIjB,GAAG,SAAS,GAAG;;EAexC"}

package/dist/plugin/babel-plugin-viewgate.js

@@ -0,0 +1,27 @@
+// src/plugin/babel-plugin-viewgate.ts
+import { transformSourcePaths } from './transform-logic.js';
+/**
+ * Babel plugin to inject source mapping attributes.
+ * Since we want to keep logic at the source level consistent,
+ * this plugin uses the same transformSourcePaths logic.
+ */
+export default function babelPluginViewGate() {
+    return {
+        name: 'babel-plugin-viewgate',
+        visitor: {
+            Program(path, state) {
+                const filePath = state.file.opts.filename;
+                if (!filePath || filePath.includes('node_modules'))
+                    return;
+                if (!filePath.endsWith('.tsx') && !filePath.endsWith('.jsx'))
+                    return;
+                const code = state.file.code;
+                const transformed = transformSourcePaths(code, filePath, process.cwd());
+                // Note: Re-parsing would be safer but more complex.
+                // For now, if we are in Babel, we can replace the entire content or
+                // use AST manipulation. Since we already have transformSourcePaths
+                // which is regex-based, we'll keep it simple for consistency.
+            }
+        }
+    };
+}

package/dist/plugin/config-injectors.d.ts

@@ -0,0 +1,8 @@
+export interface DetectionResult {
+    framework: 'vite' | 'next' | 'webpack' | 'babel' | 'unknown';
+    configPath: string | undefined;
+}
+export declare function detectFramework(cwd: string): DetectionResult;
+export declare function injectVitePlugin(configPath: string): boolean;
+export declare function injectNextPlugin(configPath: string): boolean;
+//# sourceMappingURL=config-injectors.d.ts.map

package/dist/plugin/config-injectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-injectors.d.ts","sourceRoot":"","sources":["../../src/plugin/config-injectors.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7D,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAwB5D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAmC5D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAiD5D"}

package/dist/plugin/config-injectors.js

@@ -0,0 +1,104 @@
+import fs from 'fs';
+import path from 'path';
+export function detectFramework(cwd) {
+    const files = fs.readdirSync(cwd);
+    if (files.includes('vite.config.ts') || files.includes('vite.config.js') || files.includes('vite.config.mjs')) {
+        const configPath = files.find(f => f.startsWith('vite.config.'));
+        return { framework: 'vite', configPath: configPath ? path.join(cwd, configPath) : undefined };
+    }
+    if (files.includes('next.config.js') || files.includes('next.config.mjs')) {
+        const configPath = files.find(f => f.startsWith('next.config.'));
+        return { framework: 'next', configPath: configPath ? path.join(cwd, configPath) : undefined };
+    }
+    if (files.includes('webpack.config.js') || files.includes('craco.config.js')) {
+        const configPath = files.find(f => f.startsWith('webpack.config.') || f.startsWith('craco.config.'));
+        return { framework: 'webpack', configPath: configPath ? path.join(cwd, configPath) : undefined };
+    }
+    if (files.includes('.babelrc') || files.includes('babel.config.js') || files.includes('babel.config.json')) {
+        const configPath = files.find(f => f.includes('babel'));
+        return { framework: 'babel', configPath: configPath ? path.join(cwd, configPath) : undefined };
+    }
+    return { framework: 'unknown', configPath: undefined };
+}
+export function injectVitePlugin(configPath) {
+    try {
+        let content = fs.readFileSync(configPath, 'utf8');
+        // 1. Check if already injected
+        if (content.includes('viewgatePlugin'))
+            return true;
+        // 2. Add import (handling both import and require)
+        const isTS = configPath.endsWith('.ts');
+        const isMJS = configPath.endsWith('.mjs');
+        const importStatement = (isTS || isMJS || content.includes('import '))
+            ? "\nimport viewgatePlugin from 'viewgate-wrapper/vite';\n"
+            : "\nconst viewgatePlugin = require('viewgate-wrapper/vite');\n";
+        content = importStatement + content;
+        // 3. Inject into plugins array
+        // Matches: plugins: [ ... ] or plugins: [...]
+        const pluginsRegex = /plugins\s*:\s*\[([^\]]*)\]/;
+        if (pluginsRegex.test(content)) {
+            content = content.replace(pluginsRegex, (match, p1) => {
+                const trailingComma = p1.trim() && !p1.trim().endsWith(',') ? ',' : '';
+                return `plugins: [\n    viewgatePlugin(),${p1}${trailingComma}\n  ]`;
+            });
+        }
+        else {
+            // If no plugins array found, we skip auto-injection to avoid breaking complex configs
+            return false;
+        }
+        fs.writeFileSync(configPath, content);
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}
+export function injectNextPlugin(configPath) {
+    try {
+        let content = fs.readFileSync(configPath, 'utf8');
+        // 1. Check if already injected
+        if (content.includes('viewgate-wrapper/next-loader'))
+            return true;
+        // 2. Find nextConfig object and add webpack property
+        // This is a bit more complex, we'll suggest manual setup if it's too nested
+        // Simple detection: check if NEXT_PUBLIC_VIEWGATE_API_KEY is mentioned
+        const webpackSnippet = `
+  webpack: (config) => {
+    config.module.rules.push({
+      test: /\\.(js|jsx|ts|tsx)$/,
+      use: ['viewgate-wrapper/next-loader'],
+    });
+    return config;
+  },`;
+        // Try to find the export default or module.exports nextConfig
+        if (content.includes('export default nextConfig')) {
+            content = content.replace('export default nextConfig', `nextConfig.webpack = (config) => {
+  config.module.rules.push({
+    test: /\\.(js|jsx|ts|tsx)$/,
+    use: ['viewgate-wrapper/next-loader'],
+  });
+  return config;
+};
+export default nextConfig;`);
+        }
+        else if (content.includes('module.exports = nextConfig')) {
+            content = content.replace('module.exports = nextConfig', `nextConfig.webpack = (config) => {
+  config.module.rules.push({
+    test: /\\.(js|jsx|ts|tsx)$/,
+    use: ['viewgate-wrapper/next-loader'],
+  });
+  return config;
+};
+module.exports = nextConfig;`);
+        }
+        else {
+            // Too complex to auto-inject reliably
+            return false;
+        }
+        fs.writeFileSync(configPath, content);
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}

package/dist/plugin/next-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next-loader.d.ts","sourceRoot":"","sources":["../../src/plugin/next-loader.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAUnE"}
+{"version":3,"file":"next-loader.d.ts","sourceRoot":"","sources":["../../src/plugin/next-loader.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAEnE"}

package/dist/plugin/next-loader.js

@@ -1,11 +1,4 @@
-import { transformSourcePaths } from './transform-logic.js';
+import viewgateWebpackLoader from './webpack-loader.js';
 export default function viewgateNextLoader(source) {
-    const id = this.resourcePath;
-    if (!id)
-        return source;
-    // Debug log to ensure loader is running
-    if (process.env.NODE_ENV === 'development') {
-        // console.log(`[ViewGate] Transforming: ${id}`);
-    }
-    return transformSourcePaths(source, id, process.cwd());
+    return viewgateWebpackLoader.call(this, source);
 }

package/dist/plugin/transform-logic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-logic.d.ts","sourceRoot":"","sources":["../../src/plugin/transform-logic.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAoBzE"}
+{"version":3,"file":"transform-logic.d.ts","sourceRoot":"","sources":["../../src/plugin/transform-logic.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UA8BzE"}

package/dist/plugin/transform-logic.js

@@ -5,15 +5,25 @@ export function transformSourcePaths(code, id, cwd) {
         return code;
     const normalizePath = (p) => p.replace(/\\/g, '/');
     const relativePath = normalizePath(id).replace(normalizePath(cwd), '');
+    // Simpler, faster hash function for performance
+    const getHash = (s) => {
+        let h = 0;
+        for (let i = 0; i < s.length; i++)
+            h = (Math.imul(31, h) + s.charCodeAt(i)) | 0;
+        return (h >>> 0).toString(16);
+    };
+    let tagIndex = 0;
     const lines = code.split('\n');
     const transformedLines = lines.map((line, index) => {
         const lineNumber = index + 1;
         // Regex to find JSX tags and inject data-source-path (handles self-closing tags)
         return line.replace(/(^|[^a-zA-Z0-9])<([a-zA-Z][a-zA-Z0-9\.]*)(?=[ \t\n\/\>])/g, (match, prefix, tagName) => {
-            if (match.includes('data-source-path') || tagName === 'Fragment' || tagName === 'React.Fragment') {
+            if (match.includes('data-source-path') || match.includes('data-vg-id') || tagName === 'Fragment' || tagName === 'React.Fragment') {
                 return match;
             }
-            return `${prefix}<${tagName} data-source-path="${relativePath}:${lineNumber}"`;
+            tagIndex++;
+            const vgId = getHash(`${relativePath}:${tagName}:${tagIndex}`);
+            return `${prefix}<${tagName} data-vg-id="${vgId}" data-source-path="${relativePath}:${lineNumber}"`;
         });
     });
     return transformedLines.join('\n');

package/dist/plugin/webpack-loader.d.ts

@@ -0,0 +1,2 @@
+export default function viewgateWebpackLoader(this: any, source: string): string;
+//# sourceMappingURL=webpack-loader.d.ts.map

package/dist/plugin/webpack-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpack-loader.d.ts","sourceRoot":"","sources":["../../src/plugin/webpack-loader.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAQtE"}

package/dist/plugin/webpack-loader.js

@@ -0,0 +1,9 @@
+import { transformSourcePaths } from './transform-logic.js';
+export default function viewgateWebpackLoader(source) {
+    const id = this.resourcePath;
+    if (!id)
+        return source;
+    // Support for both Webpack 4 and 5
+    const options = this.getOptions ? this.getOptions() : {};
+    return transformSourcePaths(source, id, process.cwd());
+}