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

package/index.js

@@ -111,7 +111,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.97.0';
+const VERSION = '4.103.1';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -3957,6 +3957,22 @@ function getToolDefinitions() {
                 required: ['page_id']
             }
         },
+        {
+            name: 'set_page_template',
+            description: 'Set the WP page template for a post. Theme-agnostic solution for full-bleed ' +
+                'landing pages — use "elementor_canvas" to kill theme chrome on any modern WP/Elementor ' +
+                'site. Other slugs: "elementor_header_footer" (Elementor body + theme header/footer), ' +
+                '"default" (theme default), "100-width.php" (Avada full-width), ' +
+                '"blank-template.php" (Divi blank). Returns previous and new template slug.',
+            inputSchema: {
+                type: 'object',
+                required: ['post_id', 'template'],
+                properties: {
+                    post_id:  { type: 'integer', description: 'Post or page ID.' },
+                    template: { type: 'string',  description: 'Template slug, e.g. "elementor_canvas".' },
+                },
+            },
+        },
         // ── Class Registry ──
         {
             name: 'list_classes',
@@ -4011,12 +4027,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"].' },
@@ -4464,6 +4481,20 @@ async function handleToolCall(name, args) {
                 if (item.meta.post_placement_instructions) {
                     out += `    NOTE: ${item.meta.post_placement_instructions}\n`;
                 }
+                const dp = item.meta?.design_properties;
+                if (dp) {
+                    const tags = [
+                        dp.background,
+                        dp.columns ? `${dp.columns}-col` : null,
+                        dp.has_image ? 'has-image' : null,
+                        dp.has_cta ? `cta:${dp.has_cta}` : null,
+                        dp.theme,
+                        dp.tone,
+                    ].filter(Boolean);
+                    if (tags.length) out += `    Tags: ${tags.join(' | ')}\n`;
+                    if (dp.best_for) out += `    Best for: ${dp.best_for}\n`;
+                    if (dp.not_for)  out += `    Not for: ${dp.not_for}\n`;
+                }
             });
             out += '\n';
         });
@@ -7655,6 +7686,13 @@ async function handleToolCall(name, args) {
         return ok(`Front page set to "${r.front_page_title}" (ID: ${r.front_page_id})${r.blog_page_id ? `\nBlog page: ${r.blog_page_id}` : ''}`);
     }
 
+    case 'set_page_template': {
+        const r = await apiCall(`/pages/${args.post_id}/template`, 'POST', {
+            template: args.template,
+        });
+        return ok(`Page ${r.post_id} template: ${r.previous_template} → ${r.template}`);
+    }
+
     case 'list_class_snapshots': {
         const r = await apiCall('/class-snapshots');
         const snaps = r.snapshots || [];
@@ -7738,6 +7776,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 +7804,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.103.1",
   "description": "Vision Builder Control MCP server - design token-driven page builder tools for WordPress/Elementor websites",
   "type": "module",
   "main": "index.js",