@noleemits/vision-builder-control-mcp 4.97.0 → 4.98.0

package/index.js

@@ -111,7 +111,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.97.0';
+const VERSION = '4.98.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -4011,12 +4011,13 @@ function getToolDefinitions() {
         },
         {
             name: 'upsert_class',
-            description: 'Define or update a site CSS class — stores its metadata AND CSS body in the NVBC class registry. NVBC renders the CSS page-scoped (only on pages that use the class); it is NOT written to the Elementor Kit. The class appears in list_classes with source=[site] and in the editor Browse picker. Optional apply_to: attach the class to element IDs on specific pages in the same call. Call again with the same name to update (css is replaced). v4.76.0+. v4.92.0 adds scope (global vs page) and status (published vs draft). v4.97.0 adds specificity (auto|layout|utility) so layout/visual classes win against .elementor .e-con default styles instead of losing on specificity.',
+            description: 'Define or update a site CSS class — stores its metadata AND CSS body in the NVBC class registry. NVBC renders the CSS page-scoped (only on pages that use the class); it is NOT written to the Elementor Kit. The class appears in list_classes with source=[site] and in the editor Browse picker. Optional apply_to: attach the class to element IDs on specific pages in the same call. Call again with the same name to update (css/rules are replaced). v4.76.0+. v4.92.0 adds scope (global vs page) and status (published vs draft). v4.97.0 adds specificity (auto|layout|utility) so layout/visual classes win against .elementor .e-con default styles instead of losing on specificity. v4.98.0 adds rules — the recommended way to author classes that need pseudo-elements, hover states, or any multi-rule structure (keeps the plugin the owner of all class CSS instead of forcing the user to drop ad-hoc CSS into Elementor).',
             inputSchema: {
                 type: 'object',
                 properties: {
                     name:        { type: 'string', description: 'CSS class name without leading dot. Lowercase, hyphens and underscores only. e.g. "ef-font-display"' },
-                    css:         { type: 'string', description: 'CSS property declarations for the class body — no selector, no braces. e.g. "font-size: clamp(40px, 5vw, 72px); font-family: \'Cormorant Garamond\', serif;"' },
+                    css:         { type: 'string', description: 'Single-rule shorthand — CSS property declarations for the class body, no selector, no braces. Equivalent to rules["&"]. Use this only when the class is one bare rule; for anything with pseudo-elements, :hover/:focus/:active, or child selectors, use `rules` instead. e.g. "font-size: clamp(40px, 5vw, 72px); font-family: \'Cormorant Garamond\', serif;"' },
+                    rules:       { type: 'object', additionalProperties: { type: 'string' }, description: 'v4.98.0+. Map of selector templates to declaration bodies (no braces). `&` in the selector is replaced with the resolved class selector — so this is the way to express pseudo-elements, hover/focus states, attribute states, and child/descendant selectors WITHOUT dropping raw CSS into Elementor. The specificity heuristic runs per-rule on each body, so decorative rules with backgrounds get the `.elementor` wrap automatically. Example for a hero with a gold accent strip and radial glow: {"&": "position: relative; overflow: hidden;", "&::before": "content: \\\"\\\"; position: absolute; inset: 0 0 auto 0; height: 4px; background: var(--nvbc-color-accent);", "&::after": "content: \\\"\\\"; position: absolute; inset: 0; background: radial-gradient(circle at 30% 30%, rgba(255,200,100,0.18), transparent 60%); pointer-events: none;", "&:hover": "transform: translateY(-2px);"}. If both `css` and `rules` are supplied, `css` is merged in as rules["&"] unless rules already has an explicit "&" key. For @media / @supports / container queries, use `css` with full rule syntax — `rules` is selector-keyed only.' },
                     description: { type: 'string', description: 'Human-readable description shown in list_classes output.' },
                     category:    { type: 'string', enum: ['hero', 'cards', 'layout', 'grid', 'spacing', 'typography', 'decorative', 'utility'], description: 'Category for list_classes grouping. Default: "utility".' },
                     applies_to:  { type: 'array', items: { type: 'string' }, description: 'Element types this class applies to. Default: ["any"].' },
@@ -7738,6 +7739,10 @@ async function handleToolCall(name, args) {
             applies_to:  args.applies_to  || ['any'],
         };
         if (args.css) regBody.css = args.css;
+        // v4.98.0 — structured rules map (preferred for pseudo-elements, :hover, child selectors).
+        if (args.rules && typeof args.rules === 'object' && !Array.isArray(args.rules)) {
+            regBody.rules = args.rules;
+        }
         // v4.92.0 — scope + status + scope_page_ids.
         if (args.scope) regBody.scope = args.scope;
         if (args.status) regBody.status = args.status;
@@ -7762,8 +7767,13 @@ async function handleToolCall(name, args) {
         if (r.class?.status === 'draft') {
             msg += `Status: DRAFT. The class is hidden from list_classes + the editor picker until you flip it to published.\n`;
         }
-        if (args.css) {
-            msg += `CSS stored on the class — renders page-scoped (only on pages that use .${args.name}).\n`;
+        if (args.rules || args.css) {
+            const ruleCount = args.rules ? Object.keys(args.rules).length : 0;
+            if (ruleCount > 0) {
+                msg += `CSS compiled from ${ruleCount} rule(s) (${Object.keys(args.rules).join(', ')}) and stored on the class — renders page-scoped (only on pages that use .${args.name}).\n`;
+            } else {
+                msg += `CSS stored on the class — renders page-scoped (only on pages that use .${args.name}).\n`;
+            }
         }
 
         // 3. Attach to elements if apply_to provided

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noleemits/vision-builder-control-mcp",
-  "version": "4.97.0",
+  "version": "4.98.0",
   "description": "Vision Builder Control MCP server - design token-driven page builder tools for WordPress/Elementor websites",
   "type": "module",
   "main": "index.js",