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

package/index.js

@@ -111,7 +111,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.96.0';
+const VERSION = '4.97.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -4011,7 +4011,7 @@ 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 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.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -4023,6 +4023,7 @@ function getToolDefinitions() {
                     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.',
@@ -7740,6 +7741,8 @@ async function handleToolCall(name, args) {
         // 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;
         }

package/package.json

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