bricks-builder-mcp 3.12.0 → 3.12.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "bricks-builder-mcp",
-  "version": "3.12.0",
+  "version": "3.12.3",
   "description": "Serveur MCP pour piloter Bricks Builder (WordPress) depuis Claude/Codex — édition de pages, gestion d'éléments, audit technique, audit design visuel, upload optimisé WebP. Communauté Discord : https://discord.gg/rX22zHRzH",
   "homepage": "https://discord.gg/rX22zHRzH",
   "main": "server.js",

package/server.js

@@ -570,7 +570,7 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
       
       {
         name: "update_element",
-        description: "Modifie UN SEUL élément sans recharger/renvoyer toute la page. Ultra économe en tokens. Utilise pour changer une couleur, un texte, etc. Permet aussi de renommer l'élément dans la structure Bricks via le paramètre `label`.",
+        description: "Modifie UN SEUL élément sans recharger/renvoyer toute la page. Ultra économe en tokens. Utilise pour changer une couleur, un texte, etc. Permet aussi de renommer l'élément dans la structure Bricks via le paramètre `label`. Si un élément `code` exécutable est modifié, la réponse indique qu'une signature manuelle Bricks est requise.",
         inputSchema: {
           type: "object",
           properties: {
@@ -597,7 +597,7 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
       
       {
         name: "add_element",
-        description: "Ajoute UN SEUL nouvel élément à la page. Utilise pour ajouter un bouton, un paragraphe, etc.",
+        description: "Ajoute UN SEUL nouvel élément à la page. Utilise pour ajouter un bouton, un paragraphe, etc. Si `element.parent` pointe vers un élément existant, le parent.children est synchronisé automatiquement.",
         inputSchema: {
           type: "object",
           properties: {
@@ -620,7 +620,7 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
       
       {
         name: "batch_add",
-        description: "Ajoute PLUSIEURS éléments en UNE SEULE fois. Utilise pour créer une section complète (5-10 éléments). Plus efficace que add_element en boucle.",
+        description: "Ajoute PLUSIEURS éléments en UNE SEULE fois. Utilise pour créer une section complète (5-10 éléments). Synchronise automatiquement les parent.children des éléments ajoutés. Plus efficace que add_element en boucle.",
         inputSchema: {
           type: "object",
           properties: {
@@ -830,7 +830,7 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "get_element_schema",
-        description: "Découvre les éléments Bricks disponibles et leurs contrôles natifs depuis le registre runtime Bricks. Sans `element`, retourne le catalogue compact. Avec `element` (ex: button, image, form), retourne les contrôles/settings de cet élément + les settings hérités communs si includeInherited=true.",
+        description: "Découvre les éléments Bricks disponibles et leurs contrôles natifs. Sans `element`, retourne le catalogue compact. Avec `element` (ex: button, image, form), retourne les contrôles/settings runtime si disponibles, sinon tente le schema officiel Bricks Academy en fallback + les settings hérités communs si includeInherited=true.",
         inputSchema: {
           type: "object",
           properties: {
@@ -1066,13 +1066,16 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "set_page_custom_code",
-        description: "Définit du CSS et/ou JS spécifique à une page (Page Settings → Custom Code). Utile pour des animations, des polices spécifiques à cette page seulement, etc.",
+        description: "Définit du CSS et/ou JS spécifique à une page (Page Settings → Custom Code). Utiliser les emplacements Bricks natifs : customScriptsHeader, customScriptsBodyHeader, customScriptsBodyFooter. `customScripts` reste un alias legacy vers body footer.",
         inputSchema: {
           type: "object",
           properties: {
-            pageId:        { type: "number", description: "ID de la page" },
-            customCss:     { type: "string", description: "CSS de la page (sera injecté dans <head> uniquement sur cette page)" },
-            customScripts: { type: "string", description: "Scripts/HTML de la page (injectés dans <head>)" },
+            pageId:                  { type: "number", description: "ID de la page" },
+            customCss:               { type: "string", description: "CSS de la page (injecté uniquement sur cette page)" },
+            customScriptsHeader:     { type: "string", description: "HTML/scripts injectés dans <head> uniquement sur cette page" },
+            customScriptsBodyHeader: { type: "string", description: "HTML/scripts injectés juste après <body> uniquement sur cette page" },
+            customScriptsBodyFooter: { type: "string", description: "HTML/scripts injectés avant </body> uniquement sur cette page" },
+            customScripts:           { type: "string", description: "Alias legacy : écrit dans customScriptsBodyFooter" },
           },
           required: ["pageId"],
         },
@@ -1848,6 +1851,9 @@ mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await callWordPressAPI("/set-page-custom-code", "POST", {
           pageId: args.pageId,
           customCss: args.customCss,
+          customScriptsHeader: args.customScriptsHeader,
+          customScriptsBodyHeader: args.customScriptsBodyHeader,
+          customScriptsBodyFooter: args.customScriptsBodyFooter,
           customScripts: args.customScripts,
         });
         break;
@@ -2081,17 +2087,26 @@ mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
               const allBrxe = Array.from(el.querySelectorAll('[id^="brxe-"], [class*="brxe-"]'));
               const emptyContainers = [];
               const MIN_AREA = 2500;
+              const MEDIA_TAGS = new Set(['IMG', 'PICTURE', 'SVG', 'VIDEO', 'IFRAME', 'CANVAS', 'AUDIO', 'OBJECT', 'EMBED']);
+              const INTERACTIVE_TAGS = new Set(['A', 'BUTTON', 'INPUT', 'SELECT', 'TEXTAREA']);
               allBrxe.forEach(b => {
+                // Bricks 2.3 peut rendre l'élément Image directement en <img class="brxe-image">.
+                // Dans ce cas l'élément EST le média, pas un wrapper vide.
+                if (MEDIA_TAGS.has(b.tagName) || INTERACTIVE_TAGS.has(b.tagName)) return;
                 const brect = b.getBoundingClientRect();
                 if (brect.width < 50 || brect.height < 50) return;
                 const area = brect.width * brect.height;
                 if (area < MIN_AREA) return;
                 const hasText = (b.textContent || '').trim().length > 0;
-                const hasMedia = b.querySelector('img, picture, svg, video, iframe') !== null;
+                const hasMedia = b.querySelector('img, picture, svg, video, iframe, canvas, audio, object, embed') !== null;
                 const hasInteractive = b.querySelector('a, button, input, select, textarea') !== null;
                 const bcs = getComputedStyle(b);
                 const hasBgImg = bcs.backgroundImage && bcs.backgroundImage !== 'none';
-                if (!hasText && !hasMedia && !hasInteractive && !hasBgImg) {
+                const hasChildBgImg = !hasBgImg && Array.from(b.children).some(c => {
+                  const ccs = getComputedStyle(c);
+                  return ccs.backgroundImage && ccs.backgroundImage !== 'none';
+                });
+                if (!hasText && !hasMedia && !hasInteractive && !hasBgImg && !hasChildBgImg) {
                   emptyContainers.push({
                     id: b.id || '',
                     classes: Array.from(b.classList).filter(c => c.startsWith('brxe-')),