@deneb-ui/cli 2.0.11 → 2.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deneb-ui/cli",
-  "version": "2.0.11",
+  "version": "2.0.13",
   "description": "Official developer CLI for DENEB UI — Validating, scaffolding, testing, and packaging storefront templates. Created by Chamika Gayashan & Induranga Kawishwara.",
   "bin": {
     "deneb": "bin/index.js",

package/src/recipes/ecommerce-storefront.json

@@ -280,6 +280,11 @@
               "key": "contactHeading",
               "type": "text",
               "label": "Contact Column Heading"
+            },
+            {
+              "key": "instagramUrl",
+              "type": "text",
+              "label": "Instagram Profile URL"
             }
           ]
         }
@@ -589,6 +594,16 @@
           "type": "textarea",
           "label": "WhatsApp Section Description"
         },
+        {
+          "key": "whatsappCtaLabel",
+          "type": "text",
+          "label": "WhatsApp CTA Button Label"
+        },
+        {
+          "key": "whatsappCtaUrl",
+          "type": "text",
+          "label": "WhatsApp CTA Link URL"
+        },
         {
           "key": "categoryLabel1",
           "type": "text",
@@ -1019,7 +1034,8 @@
         "supportLink1": "Shipping & Returns",
         "supportLink2": "Size Guide",
         "supportLink3": "WhatsApp Orders",
-        "contactHeading": "Contact"
+        "contactHeading": "Contact",
+        "instagramUrl": "https://instagram.com"
       }
     },
     "home": {
@@ -1080,6 +1096,8 @@
       "whatsappLabel": "Easy Ordering",
       "whatsappTitle": "Order Directly via WhatsApp",
       "whatsappDesc": "Select your size, add to your bag, and send your order in one tap. Our team confirms availability within hours.",
+      "whatsappCtaLabel": "Start a Conversation",
+      "whatsappCtaUrl": "https://wa.me/94771234567?text=Hi%2C%20I'd%20like%20to%20order%3A%0A%0AI'm%20interested%20in%20VANTA%20footwear.%20Can%20you%20help%20me%20choose%20a%20pair%3F",
       "categoryLabel1": "Performance",
       "categoryLabel2": "Sneakers",
       "categoryLabel3": "Lifestyle",

package/src/recipes/vanta-shoes-store.json

@@ -1,8 +1,8 @@
 {
   "name": "vanta-shoes-store",
-  "label": "vanta-shoes-store",
-  "description": "Learned and saved recipe extracted from shoes_shop.",
-  "savedAt": "2026-09-08T15:46:21.569Z",
+  "label": "Vanta Shoes Storefront",
+  "description": "Calibrated Vanta shoes store recipe with WhatsApp CTA, Instagram social link, product grid, and hero slides.",
+  "savedAt": "2026-09-08T17:20:49.206Z",
   "signatures": {
     "keywords": [
       "vanta-shoes-store",
@@ -55,6 +55,40 @@
     "autoIndex": true,
     "defaultCardPrefix": "product"
   },
+  "actionRules": {
+    "splitActionAndLabel": true,
+    "whatsappKeywords": [
+      "whatsapp",
+      "wa.me",
+      "order via whatsapp",
+      "chat on whatsapp"
+    ],
+    "actionFieldMapping": {
+      "whatsapp": {
+        "urlField": "whatsappCtaUrl",
+        "labelField": "whatsappCtaLabel"
+      },
+      "order": {
+        "urlField": "orderCtaUrl",
+        "labelField": "orderCtaLabel"
+      },
+      "promo": {
+        "urlField": "promoCtaUrl",
+        "labelField": "promoCtaLabel"
+      }
+    }
+  },
+  "socialRules": {
+    "platforms": [
+      "instagram",
+      "facebook",
+      "twitter",
+      "tiktok",
+      "youtube",
+      "linkedin"
+    ],
+    "targetPath": "common.footer"
+  },
   "sections": [
     {
       "id": "common",
@@ -255,6 +289,11 @@
               "key": "contactHeading",
               "type": "text",
               "label": "Contact Column Heading"
+            },
+            {
+              "key": "instagramUrl",
+              "type": "text",
+              "label": "Instagram Profile URL"
             }
           ]
         }
@@ -564,6 +603,16 @@
           "type": "textarea",
           "label": "WhatsApp Section Description"
         },
+        {
+          "key": "whatsappCtaLabel",
+          "type": "text",
+          "label": "WhatsApp CTA Button Label"
+        },
+        {
+          "key": "whatsappCtaUrl",
+          "type": "text",
+          "label": "WhatsApp CTA Link URL"
+        },
         {
           "key": "categoryLabel1",
           "type": "text",
@@ -994,7 +1043,8 @@
         "supportLink1": "Shipping & Returns",
         "supportLink2": "Size Guide",
         "supportLink3": "WhatsApp Orders",
-        "contactHeading": "Contact"
+        "contactHeading": "Contact",
+        "instagramUrl": "https://instagram.com"
       }
     },
     "home": {
@@ -1055,6 +1105,8 @@
       "whatsappLabel": "Easy Ordering",
       "whatsappTitle": "Order Directly via WhatsApp",
       "whatsappDesc": "Select your size, add to your bag, and send your order in one tap. Our team confirms availability within hours.",
+      "whatsappCtaLabel": "Start a Conversation",
+      "whatsappCtaUrl": "https://wa.me/94771234567?text=Hi%2C%20I'd%20like%20to%20order%3A%0A%0AI'm%20interested%20in%20VANTA%20footwear.%20Can%20you%20help%20me%20choose%20a%20pair%3F",
       "categoryLabel1": "Performance",
       "categoryLabel2": "Sneakers",
       "categoryLabel3": "Lifestyle",

package/src/tools/recipe-engine.cjs

@@ -133,6 +133,19 @@ function saveRecipeFromProject(projectDir, recipeName = 'custom-storefront', opt
       autoIndex: true,
       defaultCardPrefix: 'product',
     },
+    actionRules: {
+      splitActionAndLabel: true,
+      whatsappKeywords: ['whatsapp', 'wa.me', 'order via whatsapp', 'chat on whatsapp'],
+      actionFieldMapping: {
+        whatsapp: { urlField: 'whatsappCtaUrl', labelField: 'whatsappCtaLabel' },
+        order: { urlField: 'orderCtaUrl', labelField: 'orderCtaLabel' },
+        promo: { urlField: 'promoCtaUrl', labelField: 'promoCtaLabel' },
+      },
+    },
+    socialRules: {
+      platforms: ['instagram', 'facebook', 'twitter', 'tiktok', 'youtube', 'linkedin'],
+      targetPath: 'common.footer',
+    },
     sections: manifest.editorSchema?.sections || [],
     defaults: siteData.content || {},
   };

package/src/tools/template-converter.cjs

@@ -406,7 +406,94 @@ function transformFileContent(filePath, pageKey, extractedData, backupDir, proje
     return `<span data-preview-field-path="${pageKey}.${fieldKey}"${attrs}>{siteData?.content?.${pageKey}?.${fieldKey} || ${JSON.stringify(trimmed)}}</span>`;
   });
 
-  // 9. Anchor Links: <a> (sensitive attribute handler)
+  // 9. Adaptive Action-Link Splitter & Social Media Handler (100% Fivora Contract Safe)
+  // 9a. WhatsApp & Direct Communication Links
+  const waRegex = /<a(\s+[^>]*?)href="([^"]*(?:wa\.me|whatsapp)[^"]*)"([^>]*)>([\s\S]*?)<\/a>/gi;
+  code = code.replace(waRegex, (match, preHref = '', href, postHref = '', innerContent) => {
+    if (preHref.includes('data-preview-field-path') || postHref.includes('data-preview-field-path')) {
+      return match;
+    }
+    const urlKey = 'whatsappCtaUrl';
+    const labelKey = 'whatsappCtaLabel';
+    extractedData[urlKey] = href;
+
+    // Extract text from innerContent
+    const textMatch = innerContent.match(/>([^<>{}]+)</) || [null, innerContent.replace(/<[^>]+>/g, '').trim()];
+    const text = (textMatch[1] || 'Order via WhatsApp').trim();
+    extractedData[labelKey] = text;
+
+    elementCount += 2;
+    fileModified = true;
+
+    // Wrap inner label cleanly in span if not already wrapped
+    let updatedInner = innerContent;
+    if (/<span(\s+[^>]*)?>([^<>{}]+)<\/span>/i.test(innerContent)) {
+      updatedInner = innerContent.replace(
+        /<span(\s+[^>]*)?>([^<>{}]+)<\/span>/i,
+        `<span data-preview-field-path="${pageKey}.${labelKey}"$1>{siteData?.content?.${pageKey}?.${labelKey} || ${JSON.stringify(text)}}</span>`
+      );
+    } else if (text && innerContent.includes(text)) {
+      updatedInner = innerContent.replace(
+        text,
+        `<span data-preview-field-path="${pageKey}.${labelKey}">{siteData?.content?.${pageKey}?.${labelKey} || ${JSON.stringify(text)}}</span>`
+      );
+    }
+
+    return `<a${preHref}href={siteData?.content?.${pageKey}?.${urlKey} || ${JSON.stringify(href)}} data-preview-field-path="${pageKey}.${urlKey}"${postHref}>${updatedInner}</a>`;
+  });
+
+  // 9b. Social Media Icon Links (Instagram, Facebook, TikTok, Twitter/X, YouTube, LinkedIn)
+  const socialRegex = /<a(\s+[^>]*?)href="([^"]*(?:instagram|facebook|tiktok|twitter|youtube|linkedin)\.com[^"]*)"([^>]*)>([\s\S]*?)<\/a>/gi;
+  code = code.replace(socialRegex, (match, preHref = '', href, postHref = '', innerContent) => {
+    if (preHref.includes('data-preview-field-path') || postHref.includes('data-preview-field-path')) {
+      return match;
+    }
+    const platMatch = href.match(/(instagram|facebook|tiktok|twitter|youtube|linkedin)\.com/i);
+    const platform = platMatch ? platMatch[1].toLowerCase() : 'social';
+    const fieldKey = `${platform}Url`;
+
+    extractedData[fieldKey] = href;
+    elementCount++;
+    fileModified = true;
+
+    return `<a${preHref}href={siteData?.content?.common?.footer?.${fieldKey} || siteData?.content?.${pageKey}?.${fieldKey} || ${JSON.stringify(href)}} data-preview-field-path="common.footer.${fieldKey}"${postHref}>${innerContent}</a>`;
+  });
+
+  // 9c. Button / CTA Action Links with Text (Split URL on <a> and Label on <span>)
+  const btnLinkRegex = /<a(\s+[^>]*?class(?:Name)?="[^"]*(?:btn|button|cta|action|rounded|bg-)[^"]*"[^>]*?)href="([^"]+)"([^>]*)>([\s\S]*?)<\/a>/gi;
+  code = code.replace(btnLinkRegex, (match, preHref = '', href, postHref = '', innerContent) => {
+    if (preHref.includes('data-preview-field-path') || postHref.includes('data-preview-field-path') || href.startsWith('#') || href.includes('javascript:')) {
+      return match;
+    }
+    const textOnly = innerContent.replace(/<[^>]+>/g, '').trim();
+    if (!textOnly || textOnly.length < 2) return match;
+
+    const rawUrlKey = toFieldKey(textOnly, 'ctaUrl', elementCount + 1);
+    const urlKey = getUniqueKey(rawUrlKey);
+    const labelKey = urlKey.replace(/Url$/, 'Label') || getUniqueKey('ctaLabel');
+
+    extractedData[urlKey] = href;
+    extractedData[labelKey] = textOnly;
+    elementCount += 2;
+    fileModified = true;
+
+    let updatedInner = innerContent;
+    if (/<span(\s+[^>]*)?>([^<>{}]+)<\/span>/i.test(innerContent)) {
+      updatedInner = innerContent.replace(
+        /<span(\s+[^>]*)?>([^<>{}]+)<\/span>/i,
+        `<span data-preview-field-path="${pageKey}.${labelKey}"$1>{siteData?.content?.${pageKey}?.${labelKey} || ${JSON.stringify(textOnly)}}</span>`
+      );
+    } else {
+      updatedInner = innerContent.replace(
+        textOnly,
+        `<span data-preview-field-path="${pageKey}.${labelKey}">{siteData?.content?.${pageKey}?.${labelKey} || ${JSON.stringify(textOnly)}}</span>`
+      );
+    }
+
+    return `<a${preHref}href={siteData?.content?.${pageKey}?.${urlKey} || ${JSON.stringify(href)}} data-preview-field-path="${pageKey}.${urlKey}"${postHref}>${updatedInner}</a>`;
+  });
+
+  // 9d. Standard Anchor Links with Plain Text
   const linkRegex = /<a(\s+[^>]*)?>([^<>{}]+)<\/a>/g;
   code = code.replace(linkRegex, (match, attrs = '', text) => {
     const trimmed = text.trim().replace(/\s+/g, ' ');
@@ -651,16 +738,32 @@ function generateTemplateData(projectDir, projectName, detectedPages, extractedB
   // If active recipe has defined sections, seed them
   if (activeRecipe && Array.isArray(activeRecipe.sections)) {
     for (const sec of activeRecipe.sections) {
-      if (sec.id === 'common') continue;
+      if (sec.id === 'common') {
+        const commonSec = editorSections.find((s) => s.id === 'common');
+        if (commonSec && Array.isArray(sec.fields)) {
+          for (const rf of sec.fields) {
+            if (!commonSec.fields.some((f) => f.key === rf.key)) {
+              commonSec.fields.push(rf);
+            }
+          }
+        }
+        continue;
+      }
       editorSections.push(sec);
     }
   }
 
-  // Seed recipe defaults if available
+  // Seed recipe defaults if available with deep merge for common/footer
   if (activeRecipe && activeRecipe.defaults) {
     for (const [secKey, secVal] of Object.entries(activeRecipe.defaults)) {
-      if (!content[secKey]) content[secKey] = {};
-      Object.assign(content[secKey], secVal);
+      if (!content[secKey]) {
+        content[secKey] = JSON.parse(JSON.stringify(secVal));
+      } else if (typeof secVal === 'object' && !Array.isArray(secVal)) {
+        content[secKey] = { ...secVal, ...content[secKey] };
+        if (secVal.footer && content[secKey].footer) {
+          content[secKey].footer = { ...secVal.footer, ...content[secKey].footer };
+        }
+      }
     }
   }