viewgate-wrapper 1.5.1 → 1.6.1

package/README.md

@@ -1,47 +1,79 @@
-# viewgate-wrapper
+# ViewGate Wrapper
 
-A React wrapper and Vite plugin for the ViewGate feedback system.
+A React wrapper and Vite plugin for the ViewGate feedback system. It allows clients to leave annotations directly on the UI and developers to apply those changes instantly via AI (MCP Server).
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install viewgate-wrapper
 ```
 
-## Usage
+## 🚀 Getting Started
 
-### 1. Configure the Vite Plugin
+### 1. Framework Setup (Required for Smart Source Mapping)
 
-In your `vite.config.ts`:
+To allow the AI to find the exact line of code to edit, you must configure ViewGate for your framework:
+
+#### ⚡ Vite
+Add the plugin to your `vite.config.ts`:
 
 ```typescript
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react';
 import { viewgatePlugin } from 'viewgate-wrapper';
 
 export default defineConfig({
   plugins: [
-    react(),
+    // ...
     viewgatePlugin()
   ]
 });
 ```
 
+#### 🌑 Next.js
+If you are using Next.js, you can add our custom loader to your `next.config.js` (Webpack-based):
+
+```javascript
+module.exports = {
+  webpack: (config) => {
+    config.module.rules.push({
+      test: /\.(tsx|jsx)$/,
+      use: [
+        {
+          loader: 'viewgate-wrapper/next-loader',
+        },
+      ],
+    });
+    return config;
+  },
+};
+```
+*Note: Full SWC support for Next.js is coming soon.*
+
 ### 2. Wrap your application
 
-In your main entry file (e.g., `main.tsx`):
+In your main entry file (e.g., `main.tsx` or `_app.tsx`):
 
 ```tsx
 import { ViewGate } from 'viewgate-wrapper';
 import 'viewgate-wrapper/dist/viewgate-wrapper.css';
 
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <ViewGate language="es" apiKey="YOUR_API_KEY">
+// ...
+  <ViewGate language="es" apiKey="YOUR_PROJECT_API_KEY">
     <App />
   </ViewGate>
-);
 ```
 
+### 3. Setup the MCP Server (For AI Integration)
+
+To allow an AI assistant (like Claude Desktop or Cursor) to apply the feedback changes automatically, you need to configure the MCP server in your local environment:
+
+```bash
+npx viewgate-wrapper setup
+```
+
+**Note:** After running the setup, remember to **refresh or restart** your MCP server in your IDE to load the new tools.
+
+
 ## License
 
 ISC
+

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

@@ -1 +1 @@
-{"version":3,"file":"ViewGateOverlay.d.ts","sourceRoot":"","sources":["../../src/components/ViewGateOverlay.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAGlE,OAAO,wBAAwB,CAAC;AA4FhC,eAAO,MAAM,eAAe,EAAE,EA4e7B,CAAC"}
+{"version":3,"file":"ViewGateOverlay.d.ts","sourceRoot":"","sources":["../../src/components/ViewGateOverlay.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAGlE,OAAO,wBAAwB,CAAC;AA+GhC,eAAO,MAAM,eAAe,EAAE,EA4e7B,CAAC"}

package/dist/components/ViewGateProvider.d.ts

@@ -64,6 +64,11 @@ export interface SemanticReference {
     componentPath?: string;
     signature?: string;
     source?: string;
+    attributes?: Record<string, string>;
+    metadata?: {
+        hint?: string;
+        closestSource?: string;
+    };
 }
 interface ViewGateContextType {
     addToast: (message: string, type: 'success' | 'error') => void;

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

@@ -1 +1 @@
-{"version":3,"file":"ViewGateProvider.d.ts","sourceRoot":"","sources":["../../src/components/ViewGateProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAuC,KAAK,SAAS,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAErF,OAAO,wBAAwB,CAAC;AAEhC,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDjB,CAAC;AAQF,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,mBAAmB;IACzB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;IAC/D,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,EAAE,OAAO,YAAY,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,WAAW,2BAIvB,CAAC;AAEF,UAAU,aAAa;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA8BtC,CAAC"}
+{"version":3,"file":"ViewGateProvider.d.ts","sourceRoot":"","sources":["../../src/components/ViewGateProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAuC,KAAK,SAAS,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAErF,OAAO,wBAAwB,CAAC;AAEhC,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDjB,CAAC;AAQF,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACL;AAED,UAAU,mBAAmB;IACzB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;IAC/D,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,EAAE,OAAO,YAAY,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,WAAW,2BAIvB,CAAC;AAEF,UAAU,aAAa;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA8BtC,CAAC"}