viewgate-mcp 1.0.60 → 1.0.62

package/dist/index.js

@@ -148,10 +148,8 @@ function createMcpServer(apiKey, personalKey) {
             }
             else if (toolName === "generate_ui_components") {
                 guard.step = 2;
-            }
-            else if (toolName === "mark_ui_component_generated") {
-                // Allow finishing if it was started in this flow
-                resetGuard();
+                // Step 3 is now terminal, but we reset after success in the handler
+                guard.step = 3;
             }
             else {
                 throw new Error("TOOL_CALL_BLOCKED: tool not allowed in active flow");
@@ -165,8 +163,8 @@ function createMcpServer(apiKey, personalKey) {
             else if (toolName === "mark_annotations_as_live") {
                 if (guard.step !== 1)
                     throw new Error("TOOL_CALL_BLOCKED: unexpected step");
-                // Stop here and reset flow as per USER_REQUEST (MCP only reaches 'applied')
-                resetGuard();
+                // Reset moved to success handler
+                guard.step = 2;
             }
             else {
                 throw new Error("TOOL_CALL_BLOCKED: tool not allowed in active flow");
@@ -179,7 +177,7 @@ function createMcpServer(apiKey, personalKey) {
             else if (toolName === "mark_annotations_as_live") {
                 if (guard.step !== 1)
                     throw new Error("TOOL_CALL_BLOCKED: unexpected step");
-                resetGuard();
+                guard.step = 2;
             }
             else {
                 throw new Error("TOOL_CALL_BLOCKED: tool not allowed in active flow");
@@ -198,7 +196,8 @@ function createMcpServer(apiKey, personalKey) {
             else {
                 if (guard.step !== 1)
                     throw new Error("TOOL_CALL_BLOCKED: unexpected step");
-                resetGuard();
+                // Reset moved to success handler
+                guard.step = 2;
             }
         }
         else if (guard.flow === "sync") {
@@ -398,6 +397,7 @@ function createMcpServer(apiKey, personalKey) {
                         const errorBody = await response.text();
                         throw new Error(`Backend responded with ${response.status}: ${errorBody}`);
                     }
+                    resetGuard();
                     const data = (await response.json());
                     const styleHandler = data?.settings?.styleHandler || 'unknown';
                     const language = data?.settings?.language || 'en';
@@ -442,7 +442,7 @@ function createMcpServer(apiKey, personalKey) {
                         'css': `Use CSS custom properties for all colors. Read theme values like: const primary = theme?.primary || 'var(--vg-primary)'. Apply them inline or inject a <style> block using these variables. Never hardcode colors.`,
                         'sass': `Use CSS custom properties as values. Resolve theme at runtime: const primary = theme?.primary || 'var(--vg-primary)'. Apply via inline style or injected <style>.`,
                         'css-modules': `CSS Modules can use CSS vars. In JS: const primary = theme?.primary || 'var(--vg-primary)'. Pass primary as CSS var via style={{ '--component-primary': primary }} on the root element and reference it inside the .module.css.`,
-                        'tailwind': `Use Tailwind's arbitrary value syntax for theme colors: className={\`bg-[\${theme?.primary || 'var(--vg-primary)'}]\`}. For text and borders follow the same pattern. Never use fixed Tailwind color classes like text-blue-500.`,
+                        'tailwind': `Use Tailwind's standard 'primary' color class which is dynamically injected by the preview engine. Example: className="bg-primary hover:bg-primary-hover text-primary-foreground". If manually overriding, use: style={{ backgroundColor: theme?.primary || 'var(--vg-primary)' }}. NEVER use fixed classes like text-blue-500.`,
                         'css-in-js': `In styled-components template literals, read the theme prop: color: \${({ theme: t }) => t?.primary || 'var(--vg-primary)'}. Accept the full theme object via props and propagate it through styled-components ThemeProvider if needed.`,
                         'bootstrap': `Override Bootstrap CSS vars on the root element: style={{ '--bs-primary': theme?.primary || 'var(--vg-primary)' }}. Use btn-primary, text-primary etc. classes which will inherit the overridden variable.`,
                         'mui': `Use createTheme({ palette: { primary: { main: theme?.primary || 'var(--vg-primary)' } } }) inside the component and wrap with ThemeProvider. Accept the theme prop and recreate the MUI theme from it.`,
@@ -469,25 +469,27 @@ function createMcpServer(apiKey, personalKey) {
                                 instruction: `You MUST use ${styleLabel} for ALL styling. Do not mix or use any other styling approach. The component must be fully styled using this technology and be production-ready.`
                             },
                             themingTokens: {
-                                description: 'The component MUST accept an optional `theme` prop for color customization. This is the primary mechanism for users to apply their own brand colors via a JSON file in their project.',
+                                description: 'CRITICAL: The component MUST accept an optional `theme` prop. This is non-negotiable for production-ready components.',
                                 propInterface: {
-                                    primary: 'string — main brand/accent color (buttons, links, active states)',
-                                    primaryHover: 'string — hover state of primary, slightly darker',
-                                    primaryLight: 'string — light tint of primary for backgrounds (10% opacity)',
+                                    primary: 'string — main brand/accent color (buttons, active states)',
+                                    primaryHover: 'string — hover state of primary',
+                                    primaryLight: 'string — light tint of primary for backgrounds',
+                                    primaryForeground: 'string — contrasting text color for primary backgrounds (white/black)',
                                     surface: 'string — card/panel background color',
-                                    surfaceAlt: 'string — alternative surface for inputs/hover states',
+                                    surfaceAlt: 'string — alternative surface for inputs',
                                     border: 'string — border and divider color',
                                     text: 'string — primary text color',
                                     textMuted: 'string — secondary/muted text color',
-                                    radius: 'string — base border radius (e.g. "8px", "12px")',
+                                    radius: 'string — base border radius (e.g. "12px")',
                                 },
-                                fallbackMechanism: 'When theme prop is not provided, fall back to CSS custom properties: var(--vg-primary), var(--vg-surface), etc. This allows the ViewGate dashboard preview (which injects CSS vars) and custom ThemeProviders to work without explicit props.',
+                                fallbackMechanism: 'When theme prop is not provided, you MUST fall back to CSS custom properties: var(--vg-primary), var(--vg-surface), etc. This ensures the component is self-theming via global dashboard injection.',
                                 handlerSpecificInstruction: themingInstruction,
                                 criticalRules: [
-                                    'NEVER hardcode any color value (no #hex, no rgb(), no named colors like blue/red)',
-                                    'ALWAYS prefer theme prop values first, then var(--vg-*) CSS vars as fallback',
-                                    'The theme prop must be optional — component must work without it using CSS var fallbacks',
-                                    'Expose the theme prop explicitly in the component TypeScript/PropTypes interface',
+                                    'NEVER hardcode hex, rgb, or named colors. Use theme props or var(--vg-*) fallbacks.',
+                                    'MUST use Tailwind standard "primary" class (e.g. bg-primary, text-primary-foreground) as these are dynamically injected in the dashboard.',
+                                    'The theme prop MUST be optional and typed in the component interface.',
+                                    'Micro-animations MUST be implemented with Framer Motion (use whileHover, whileTap, etc.)',
+                                    'AESTHETIC PERFECTION: The generated component MUST be an EXACT visual match of the source design. Pay extreme attention to spacing, shadows, and subtle gradients.',
                                 ]
                             },
                             constraints: {
@@ -500,7 +502,9 @@ function createMcpServer(apiKey, personalKey) {
                                 mustBeProductionReady: true,
                                 mustUseFramerMotionForAnimations: true,
                                 themingIsMandatory: true,
-                                stylingHandlerIsStrict: true
+                                stylingHandlerIsStrict: true,
+                                mustBeAestheticallyIdentical: true,
+                                visualFidelityInstruction: "You MUST ensure 100% visual parity. The output component must be PREMIUM and indistinguishable from the provided Figma design in terms of layout, spacing, and styling tokens."
                             }
                         };
                         results.push({
@@ -527,6 +531,7 @@ function createMcpServer(apiKey, personalKey) {
                                 2) REGISTRAR LA PREVIEW usando 'mark_ui_component_generated'.
 
                                 REQUISITO TECNOLÓGICO OBLIGATORIO: Usar ${styleLabel} para TODOS los estilos.
+                                REQUISITO DE FIDELIDAD ESTÉTICA: El componente debe ser VISUALMENTE IDÉNTICO al original. Respeta cada píxel de espaciado, sombras y pesos de fuente.
                                 REQUISITO DE THEMING: DEBES respetar las themingTokens. NUNCA hardcodees colores (#hex, etc). Usa SIEMPRE la prop 'theme' o el fallback 'var(--vg-*)'.
                                 NOTA: Si styleHandler es '${styleHandler}', NO utilices otra tecnología distinta aunque los archivos originales (Figma HTML/CSS) digan lo contrario.`,
                                     results
@@ -709,6 +714,7 @@ Lang: ${rawData.preferredLanguage === 'es' ? 'ES' : 'EN'}
                     });
                     if (!response.ok)
                         throw new Error(`Backend responded with ${response.status}`);
+                    resetGuard();
                     const data = (await response.json());
                     return {
                         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
@@ -729,6 +735,9 @@ Lang: ${rawData.preferredLanguage === 'es' ? 'ES' : 'EN'}
                     });
                     if (!response.ok)
                         throw new Error(`Backend responded with ${response.status}`);
+                    if (args.results) {
+                        resetGuard();
+                    }
                     const data = (await response.json());
                     // Point: Version Storing
                     if (data.backlogVersion)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viewgate-mcp",
-  "version": "1.0.60",
+  "version": "1.0.62",
   "main": "dist/index.js",
   "bin": {
     "viewgate-mcp": "./dist/index.js"