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

package/index.js

@@ -111,7 +111,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.96.0';
+const VERSION = '4.98.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -4011,18 +4011,20 @@ 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): a page-scoped class only appears in the editor picker on its target pages; a draft class is hidden from the picker entirely until you flip status to published.',
+            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"].' },
                     scope:       { type: 'string', enum: ['global', 'page'], description: 'v4.92.0+. "global" (default) = appears in the editor picker on every page. "page" = only appears in the picker on the pages listed in scope_page_ids (or derived from apply_to). Render is unaffected: if the class is on an element, its CSS still emits — scope only filters editor-picker visibility.' },
                     scope_page_ids: { type: 'array', items: { type: 'number' }, description: 'v4.92.0+. Required when scope=page (or supply apply_to with page_id entries and the server will derive these). WordPress page IDs the class belongs to.' },
                     status:      { type: 'string', enum: ['published', 'draft'], description: 'v4.92.0+. "published" (default) = appears in list_classes + editor picker. "draft" = hidden from both until promoted. Useful while iterating on a class.' },
+                    specificity: { type: 'string', enum: ['auto', 'layout', 'utility'], description: 'v4.97.0+. Controls how the class selector is emitted. "auto" (default) wraps as .elementor .{name} when the css body sets layout (display, grid-template-*, gap, padding) or visual (background, border, border-radius, box-shadow) properties — so the class beats .elementor .e-con instead of losing on specificity. "layout" forces the wrap. "utility" forces a bare .{name} for cases where you want the class overridable.' },
                     apply_to:    {
                         type: 'array',
                         description: 'Optional: attach this class to these elements in the same call. When scope=page and scope_page_ids is omitted, the page_ids here are used as scope_page_ids.',
@@ -7737,9 +7739,15 @@ 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;
+        // v4.97.0 — specificity hint for the emit pipeline.
+        if (args.specificity !== undefined) regBody.specificity = args.specificity;
         if (Array.isArray(args.scope_page_ids) && args.scope_page_ids.length) {
             regBody.scope_page_ids = args.scope_page_ids;
         }
@@ -7759,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.96.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",