webcake-landing-mcp 1.0.23 → 1.0.25

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.0.25",
+    "d": "07/06/2026",
+    "type": "Changed",
+    "en": "currency has moved from options.currency to settings.currency in the page source model; new_page_skeleton now emits it in the correct location,…",
+    "vi": "currency đã được chuyển từ options.currency sang settings.currency trong mô hình nguồn trang; new_page_skeleton giờ xuất đúng vị trí,…"
+  },
+  {
+    "v": "1.0.24",
+    "d": "07/06/2026",
+    "type": "Changed",
+    "en": "The numbered installation steps on the GET / guide page now display a faint vertical connector line between step numbers, giving the list a clear…",
+    "vi": "Các bước cài đặt được đánh số trên trang hướng dẫn GET / nay hiển thị đường kết nối dọc mờ giữa các số thứ tự, tạo giao diện stepper rõ ràng."
+  },
   {
     "v": "1.0.23",
     "d": "07/06/2026",
@@ -26,19 +40,5 @@
     "type": "Changed",
     "en": "get_generation_guide now includes a Layout Archetypes block that maps seven page types (sales/COD, lead-gen/service, event/invitation, app/SaaS…",
     "vi": "get_generation_guide now includes a Layout Archetypes block that maps seven page types (sales/COD, lead-gen/service, event/invitation, app/SaaS…"
-  },
-  {
-    "v": "1.0.19",
-    "d": "07/06/2026",
-    "type": "Changed",
-    "en": "get_generation_guide now includes a Section Playbook block that lists a common section menu for lead-gen and COD sales pages (header, hero,…",
-    "vi": "get_generation_guide nay có thêm khối \"Section Playbook\" liệt kê bộ section thường dùng cho trang thu lead và bán hàng COD (header, hero, tính…"
-  },
-  {
-    "v": "1.0.18",
-    "d": "07/06/2026",
-    "type": "Changed",
-    "en": "new_element for list-product now seeds a default styles.colorBtn (rgba(246,4,87,1)) so generated product-list button labels have a visible accent…",
-    "vi": "new_element cho list-product nay gán sẵn styles.colorBtn mặc định (rgba(246,4,87,1)) để nhãn nút của danh sách sản phẩm có màu nhấn nhìn thấy được…"
   }
 ]

package/dist/domains/landing/elements/form.js

@@ -276,6 +276,7 @@ export const FORM = [
             field_type: "'postal_code' | absent — 'postal_code' switches validation from phone OTP to a postal-code regex.",
             condition: "'limit_5' | 'limit_6' | 'custom' — postal-code regex selector (active when field_type='postal_code').",
             pattern: "string regex — custom postal-code pattern when condition='custom'.",
+            message_otp_wrong: "string — custom error message shown when the entered OTP is wrong (read by the form on submit-error). Optional.",
         },
         seed: (el) => {
             seedPosition(el);
@@ -296,12 +297,14 @@ export const FORM = [
     },
     {
         type: "group-select-item", category: "form", container: false, field: true, defaultName: "Group Select Item",
-        summary: "One attribute (or the quantity) inside group-select. Options are NOT static — they are populated from the product catalog (window.sync.products) at runtime based on attrName + the parent's sprod.",
+        summary: "One attribute (or the quantity) inside group-select. Attribute items populate options from the product catalog (window.sync.products) at runtime based on attrName + the parent's sprod; the quantity item carries a STATIC options array.",
         useWhen: "Child of group-select only.",
         keySpecials: {
             field_name: "REQUIRED unique data key (becomes 'quantity' when field_quantity=true).",
+            field_placeholder: "string — the item's visible label/placeholder (the editor seeds 'AttrName' for attribute items, 'Quantity' for the quantity item).",
             field_quantity: "boolean — when true this item is the quantity selector (value goes to parent._setQuantity), not a product attribute. Only one item per group.",
             attrName: "string — the product attribute name this item maps to (e.g. 'Color','Size'); numeric strings ('1','2') index product_attributes for custom products; 'sprod-name'/'sprod-sku' show the product name/SKU.",
+            options: "array [{id,name,value}] — STATIC option list used by the quantity item (field_quantity=true), e.g. 1..4; attribute items leave this empty and populate from the catalog at runtime.",
             default_value: "string — pre-selected option value, or 'default-none'/empty for no default.",
             required: "boolean — require selection when the item and its parent group are visible.",
         },

package/dist/domains/landing/guide.js

@@ -8,12 +8,13 @@ export const GENERATION_GUIDE = `You are generating the JSON source of a Webcake
 
 OUTPUT (top-level page source — matches the real editor shape)
 - Return ONE JSON object:
-  { "page": [<section>...], "popup": [<popup>...], "settings": {...},
-    "options": { "currency":"VND", "mobileOnly":false, "versionID":null }, "cartConfigs": {} }
+  { "page": [<section>...], "popup": [<popup>...], "dynamic_pages": [], "settings": {...},
+    "options": { "mobileOnly":false, "versionID":null }, "cartConfigs": { "isActive":false }, "svariations": [] }
+- "dynamic_pages" (dataset-bound sections) and "svariations" (product/variation data) stay [] for a static page — keep them when editing so commerce data isn't dropped. currency lives in settings.currency, NOT options.
 - "page" is an array of SECTIONS stacked vertically (index 0 = top). Each item MUST be type "section" (or "dynamic_page").
 - "popup" is a SEPARATE top-level array of popup elements — do NOT nest popups inside "page". A button opens one via a click event { action:"open_popup", target:"<popup id>" }.
 - All other elements (text, image, button, form…) live inside a section's "children".
-- "settings" carries SEO + page config: title, description, keywords, favicon, fontGeneral, width_section {desktop:960,mobile:420}, country, fb_tracking_code, tiktok_script, extra_css, extra_script (call new_page_skeleton for a ready default).
+- "settings" carries SEO + page config: title, description, keywords, robots, canonical, favicon, fontGeneral, width_section {desktop:960,mobile:420}, country, currency, fb_tracking_code, tiktok_script, extra_css, extra_script, bhet (head code), bbet (body-end code) (call new_page_skeleton for a ready default).
 
 ELEMENT NODE (every element)
 { "id": "<unique ~8-char [A-Za-z0-9_]>", "type": "<type>",

package/dist/domains/landing/instructions.js

@@ -14,7 +14,7 @@ RULES (follow for every request):
 - Organizations: call list_organizations and ask which to use; default to the is_default org. Endpoints are owner-scoped (only the account's own pages).
 
 MODEL (essentials):
-- Top-level: { page:[sections], popup:[popups], settings:{}, options:{currency,mobileOnly,versionID}, cartConfigs:{} }. Popups are a SEPARATE top-level array, NOT inside page.
+- Top-level: { page:[sections], popup:[popups], dynamic_pages:[], settings:{}, options:{mobileOnly,versionID}, cartConfigs:{isActive:false}, svariations:[] }. Popups are a SEPARATE top-level array, NOT inside page; currency lives in settings.currency (not options). Leave dynamic_pages/svariations as [] for a static page, but keep them on edit round-trips.
 - Element: { id, type, properties, responsive:{desktop,mobile:{config,styles}}, specials, children, runtime, events }. Absolute canvas: children carry numeric top/left/width/height (px) per breakpoint (canvas width desktop=960, mobile=420); sections own a height.
 - CENTERING (the #1 layout defect — do the math, don't eyeball): to center a box compute left = round((canvas - width)/2) — 960 desktop, 420 mobile. textAlign:center only centers text inside the box, not the box itself. For a row of N items, center the whole row block (startLeft = round((canvas - (N*item + (N-1)*gap))/2)). Keep 0 ≤ left and left+width ≤ canvas on each breakpoint.
 - STICKY HEADER: a sticky/fixed header (config.sticky) OVERLAYS the page — it does NOT push sections below it down. Offset the first section's top content DOWN by the header height (~60–72px) so nothing hides behind it, and do NOT duplicate the shop name in both the header and the top of the hero. A non-sticky header stacks normally and needs no offset.

package/dist/domains/landing/page-schema.json

@@ -24,10 +24,9 @@
     },
     "options": {
       "type": "object",
-      "description": "Editor options.",
+      "description": "Editor options: { mobileOnly, versionID }. NOTE: currency lives in settings.currency, not here.",
       "additionalProperties": true,
       "properties": {
-        "currency": { "type": "string", "examples": ["VND", "USD"] },
         "mobileOnly": { "type": "boolean", "description": "true = page only renders the mobile breakpoint." },
         "versionID": { "type": ["string", "null"] }
       }
@@ -51,6 +50,11 @@
           "properties": { "desktop": { "type": "number" }, "mobile": { "type": "number" } }
         },
         "country": { "type": "string", "description": "Dialing/locale code, e.g. \"84\"." },
+        "currency": { "type": "string", "description": "Page currency (the editor's canonical home for currency).", "examples": ["VND", "USD"] },
+        "robots": { "type": "string", "description": "SEO robots meta directive." },
+        "canonical": { "type": "string", "description": "SEO canonical URL." },
+        "bhet": { "type": "string", "description": "Custom code injected at the end of <head>." },
+        "bbet": { "type": "string", "description": "Custom code injected before </body>." },
         "fb_tracking_code": { "type": "string", "description": "Facebook pixel id." },
         "tiktok_script": { "type": "string" },
         "global_track_ids": { "type": "array" },

package/dist/domains/landing/page.js

@@ -1,19 +1,27 @@
-/** Default page-level settings (subset of the ~40 real keys; covers the essentials). */
+/** Default page-level settings (subset of the ~44 real keys; covers the essentials). */
 export function defaultSettings(overrides = {}) {
     return {
         title: "",
         description: "",
         keywords: "",
+        robots: "",
+        canonical: "",
         favicon: "",
         thumbnail: "",
         fontGeneral: "'Roboto', sans-serif",
         width_section: { desktop: 960, mobile: 420 },
         country: "84",
+        // currency lives in settings (the editor's canonical home), NOT in options.
+        currency: "VND",
         fb_tracking_code: "",
         tiktok_script: "",
         global_track_ids: [],
+        global_tracks: {}, // the editor always re-writes this to {} on save.
         extra_css: "",
         extra_script: "",
+        bhet: "", // custom code injected at the end of <head>.
+        bbet: "", // custom code injected before </body>.
+        global_compress_image: { enable: true, option: 300, keep_solution: false },
         auto_save_draft: true,
         auto_save_info_user: false,
         send_info_to_thank_page: true,
@@ -22,14 +30,19 @@ export function defaultSettings(overrides = {}) {
 }
 /**
  * Build a complete, empty top-level page source matching the real editor shape:
- * { page, popup, settings, options, cartConfigs }. Fill `page` with sections.
+ * { page, popup, dynamic_pages, settings, options, cartConfigs, svariations }.
+ * Fill `page` with sections. `dynamic_pages`/`svariations` stay empty for static,
+ * non-commerce pages but are emitted so edit round-trips don't drop them, and
+ * `options` carries only { mobileOnly, versionID } (currency lives in settings).
  */
 export function createPageSource(opts = {}) {
     return {
         page: [],
         popup: [],
+        dynamic_pages: [],
         settings: defaultSettings(opts.settings ?? {}),
-        options: { currency: "VND", mobileOnly: opts.mobileOnly ?? false, versionID: null },
-        cartConfigs: {},
+        options: { mobileOnly: opts.mobileOnly ?? false, versionID: null },
+        cartConfigs: { isActive: false },
+        svariations: [],
     };
 }

package/dist/domains/landing/vocab.js

@@ -2,7 +2,7 @@
  * Landing-page vocabulary: the fixed canvas, the event triggers, and the
  * per-trigger action maps. "Extra:" notes list the action-specific event-object
  * fields the render_v4 dispatcher reads beyond { id, type, action, target }.
- * Derived from assets/render_v4/src/event/index.js.
+ * Derived from assets/render_v4/event/index.js.
  */
 export const CANVAS = { desktopWidth: 960, mobileWidth: 420, defaultSectionHeight: 800 };
 export const EVENT_TRIGGERS = ["click", "hover", "success", "error", "unset", "delay"];

package/dist/web-guide.js

@@ -524,18 +524,24 @@ export function guideHtml(origin, lang = "vi") {
   .method{margin-bottom:16px;padding:24px}
   .method>.tag{margin-bottom:4px}
   .msub{color:var(--mut);font-size:.92rem;margin:.5rem 0 1.2rem}
-  .steps{list-style:none;margin:0;padding:0;display:grid;gap:16px}
-  .steps li{display:flex;gap:14px}
+  .steps{list-style:none;margin:0;padding:0;display:grid;gap:18px;position:relative}
+  .steps li{display:flex;gap:14px;align-items:flex-start;position:relative}
+  /* Faint connector between step numbers → reads as an intentional stepper */
+  .steps li:not(:last-child)::after{content:"";position:absolute;left:13px;top:30px;bottom:-18px;width:2px;background:var(--line)}
   .steps .n{flex:0 0 auto;width:28px;height:28px;border-radius:50%;color:var(--ic-fg);
     background:rgba(29,185,84,.12);border:1px solid var(--line);
     font:800 .85rem/1 system-ui;display:flex;align-items:center;justify-content:center}
   .steps .body{flex:1;min-width:0;font-size:.95rem}
   .steps .body pre{margin-top:9px}
-  .steps .body .btn{margin-top:10px}
+  /* A button inside a step drops to its own left-aligned line (inline-flex would
+     sit beside the text and be shoved off-baseline by the top margin). */
+  .steps .body .btn{display:flex;width:fit-content;margin-top:10px}
   code.inl{background:rgba(29,185,84,.13);color:var(--g7);padding:1px 6px;border-radius:6px;font-size:.85em;font-weight:600;
     overflow-wrap:anywhere;word-break:break-word}
   .note{font-size:.86rem;color:var(--mut);margin-top:10px}
   .note + pre,.note + .codewrap{margin-top:9px}
+  .tip{margin-top:16px;background:rgba(29,185,84,.06);border:1px solid var(--line);border-radius:12px;padding:13px 15px}
+  .tip .note{margin:0}
   details{padding:2px 18px;margin-bottom:11px}
   details summary{cursor:pointer;font-weight:600;padding:15px 0;list-style:none;display:flex;align-items:center;gap:10px}
   details summary::-webkit-details-marker{display:none}
@@ -584,6 +590,7 @@ export function guideHtml(origin, lang = "vi") {
     .lead{font-size:1.05rem}
     .method{padding:18px 15px}
     .card{padding:18px}
+    .tip{padding:11px 12px}
     .cl-wrap{padding:18px 16px 10px}
     .langsw{padding:6px 10px}
     .uses li,.feat li{padding:14px}
@@ -666,8 +673,7 @@ export function guideHtml(origin, lang = "vi") {
     <ol class="steps">
       ${steps(t.m1Steps.map(fill))}
     </ol>
-    <p class="note">${t.m1Note}</p>
-    <pre>${INSTALL_ALL_CMD}</pre>
+    <div class="tip"><p class="note">${t.m1Note}</p><pre>${INSTALL_ALL_CMD}</pre></div>
   </div>
 
   <div class="glass card method reveal">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-landing-mcp",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "MCP server exposing Webcake landing-page element schemas + AI usage hints, and persisting LLM-generated page sources to a Webcake backend.",
   "type": "module",
   "bin": {