webcake-landing-mcp 1.6.1 → 1.6.2

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.6.2",
+    "d": "27/10/2026",
+    "type": "Fixed",
+    "en": "expand now syncs a field element's properties.field_default with its specials.field_name, turning it on for the editor's system columns…",
+    "vi": "expand nay đồng bộ properties.field_default của field element theo specials.field_name: bật cho các cột hệ thống của editor (phone_number,…"
+  },
   {
     "v": "1.6.1",
     "d": "21/10/2026",
@@ -33,12 +40,5 @@
     "type": "Fixed",
     "en": "The HTTP server now answers a request carrying an unknown mcp-session-id with 404 instead of 400, so clients re-initialize instead of staying stuck…",
     "vi": "HTTP server nay trả về 404 (thay vì 400) khi nhận request với mcp-session-id không xác định, giúp client tự re-initialize thay vì bị kẹt ở trạng…"
-  },
-  {
-    "v": "1.5.8",
-    "d": "13/10/2026",
-    "type": "Fixed",
-    "en": "The OAuth authorize endpoint now accepts http://localhost/127.0.0.1/[::1] redirect URIs on any port as long as the scheme, host, path, and query…",
-    "vi": "Endpoint OAuth authorize nay chấp nhận redirect URI http://localhost/127.0.0.1/[::1] ở bất kỳ port nào miễn là scheme, host, path, và query khớp với…"
   }
 ]

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

@@ -58,7 +58,7 @@ export const FORM = [
         summary: "Single-line input. specials.field_name is the submitted data column (REQUIRED & unique).",
         useWhen: "Name/email/phone fields. Set field_type to text/email/phone/number. Must be a DIRECT child of the form to submit.",
         keySpecials: {
-            field_name: "REQUIRED unique data key. Special names coerce the input type: 'phone_number'/'recheck_phone_number' → tel, 'email' → email. Phone pattern validation only applies when field_name=='phone_number' AND validate=true.",
+            field_name: "REQUIRED unique data key. Use the EXACT system names for standard columns — full_name, first_name, last_name, phone_number, recheck_phone_number, email, address, quantity, coupon, postal_code (never 'phone'/'name'/'sdt'/'ho_ten'): the editor locks those IDs and refuses them when typed, so a field saved as 'phone' can never be renamed to 'phone_number' there. Special names coerce the input type: 'phone_number'/'recheck_phone_number' → tel, 'email' → email. Phone pattern validation only applies when field_name=='phone_number' AND validate=true.",
             field_placeholder: "placeholder text.",
             field_type: "text | email | phone | number | postal_code | date. 'postal_code' enables postcode-detect helper and uses condition/pattern (country_default|limit_5|limit_6|custom). 'date' renders a date input.",
             required: "boolean.",
@@ -99,7 +99,7 @@ export const FORM = [
                 desktop: { styles: { top: 60, left: 20, width: 360, height: 40 } },
                 mobile: { styles: { top: 60, left: 20, width: 360, height: 40 } },
             },
-            specials: { field_name: "phone", field_placeholder: "Số điện thoại", field_type: "phone", required: true },
+            specials: { field_name: "phone_number", field_placeholder: "Số điện thoại", field_type: "phone", required: true },
         },
     },
     {
@@ -389,3 +389,37 @@ export const FORM = [
         },
     },
 ];
+/**
+ * The editor's SYSTEM form columns — the `default: true` fields of its "add
+ * field" panel (landing_page_backend assets/editor/main/panels/FormPanel.vue).
+ * The editor creates them with `properties.field_default = true`, which LOCKS
+ * the ID box (FieldTrait.vue `disabled`), and it refuses these names when typed
+ * (FieldTrait.vue `defaultFieldName` appends a random suffix). So a field must
+ * be BORN with the canonical name: a field saved as "phone" can never become
+ * "phone_number" in the editor, and only the canonical names get the editor's
+ * extra behaviour (phone validation, address autocomplete, quantity, coupon…).
+ */
+export const SYSTEM_FIELD_NAMES = new Set([
+    "full_name", "first_name", "last_name", "phone_number", "recheck_phone_number",
+    "email", "quantity", "coupon", "address", "postal_code", "country_select",
+    "verify_code", "access_key", "province_id/district_id/commune_id",
+]);
+/** Common hand-made spellings of a system column (slugged: lowercase, no accents, `_`). */
+const SYSTEM_FIELD_ALIASES = {
+    phone: "phone_number", phonenumber: "phone_number", phone_no: "phone_number", tel: "phone_number",
+    telephone: "phone_number", mobile: "phone_number", sdt: "phone_number", so_dt: "phone_number",
+    so_dien_thoai: "phone_number", sodienthoai: "phone_number", dien_thoai: "phone_number", dienthoai: "phone_number",
+    name: "full_name", fullname: "full_name", your_name: "full_name", customer_name: "full_name",
+    ho_ten: "full_name", hoten: "full_name", ho_va_ten: "full_name", ten: "full_name",
+    firstname: "first_name", lastname: "last_name",
+    mail: "email", e_mail: "email", email_address: "email",
+    dia_chi: "address", diachi: "address",
+    so_luong: "quantity", soluong: "quantity", qty: "quantity",
+    ma_giam_gia: "coupon", voucher: "coupon",
+};
+/** The system column a non-canonical field_name was clearly meant to be, else undefined. */
+export function systemFieldAlias(fieldName) {
+    const slug = fieldName.normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/đ/gi, "d")
+        .toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+    return SYSTEM_FIELD_ALIASES[slug];
+}

package/dist/domains/landing/index.js

@@ -2,6 +2,7 @@ import { CANVAS, EVENT_TRIGGERS, CLICK_ACTIONS, HOVER_ACTIONS, SUCCESS_ACTIONS,
 import { GENERATION_GUIDE } from "./guide.js";
 import { INSTRUCTIONS } from "./instructions.js";
 import { LIBRARY, ELEMENT_TYPES, CONTAINER_TYPES, FIELD_TYPES, createElement } from "./elements/index.js";
+import { SYSTEM_FIELD_NAMES } from "./elements/form.js";
 import { createPageSource } from "./page.js";
 import { canvasToPageSource } from "./canvas-to-source.js";
 import { validatePage, coercePage, pageSchema } from "./validate.js";
@@ -389,6 +390,32 @@ function normalizeSettings(source) {
     ws.desktop ??= CANVAS.desktopWidth;
     ws.mobile ??= CANVAS.mobileWidth;
 }
+// ---------------------------------------------------------------------------
+// form-field lock normalization: the editor locks a field's ID box when
+// `properties.field_default` is true (FieldTrait.vue `disabled`) and only ever
+// sets it on its SYSTEM columns (phone_number, full_name, email…). A model that
+// copies `field_default:true` onto a custom field ("message", "note") leaves
+// the user an ID they can NEVER change; a system column without it is editable
+// in a way the editor itself never allows. So the flag follows the name:
+// on for system names, off for everything else. Deterministic + idempotent,
+// so the expand(compact(x)) == expand(x) invariant holds.
+// ---------------------------------------------------------------------------
+/** Walk a tree node and sync properties.field_default with the field_name in-place (mutates). */
+function normalizeFormFields(node) {
+    if (!node || typeof node !== "object")
+        return;
+    const fn = node.specials?.field_name;
+    if (FIELD_TYPES.has(node.type) && typeof fn === "string" && node.properties && typeof node.properties === "object") {
+        if (SYSTEM_FIELD_NAMES.has(fn))
+            node.properties.field_default = true;
+        else
+            delete node.properties.field_default;
+    }
+    if (Array.isArray(node.children)) {
+        for (const child of node.children)
+            normalizeFormFields(child);
+    }
+}
 /** Apply all post-expand normalizations to every node in a page source. */
 function normalizeSource(source) {
     if (!source || typeof source !== "object")
@@ -405,6 +432,7 @@ function normalizeSource(source) {
                 // url() layer in the same value.
                 normalizeColors(node);
                 normalizeBackgrounds(node);
+                normalizeFormFields(node);
             }
         }
     }

package/dist/domains/landing/validate.js

@@ -9,6 +9,7 @@
 import { readFileSync } from "node:fs";
 import Ajv2020Module from "ajv/dist/2020.js";
 import { CONTAINER_TYPES, FIELD_TYPES } from "./elements/index.js";
+import { systemFieldAlias } from "./elements/form.js";
 import { ANIMATABLE_TYPES, ANIMATION_NAMES } from "./vocab.js";
 import { estTextHeightPx, measureTextBlock } from "./text-metrics.js";
 import { isColorKey, isUnparseableByEditor } from "./color.js";
@@ -316,6 +317,12 @@ export function validatePage(input) {
             if (!fn || typeof fn !== "string" || fn.trim() === "") {
                 warnings.push(`${path} (${type}): form input should have a unique specials.field_name.`);
             }
+            else {
+                const canonical = systemFieldAlias(fn);
+                if (canonical && canonical !== fn) {
+                    warnings.push(`${path} (${type}): field_name "${fn}" should be the system column "${canonical}" — the Webcake editor reserves system names (typing "${canonical}" there gets a random suffix), so the user can NEVER rename this field to "${canonical}" later, and only "${canonical}" gets the editor's built-in behaviour. Rename it now (also update any {{${fn}}} placeholder). On an EXISTING page this changes the submitted data column — ask the user first.`);
+                }
+            }
             // `field_placeholder` is the ONLY placeholder key the renderer reads. A stray
             // `placeholder` renders blank; a select with no field_placeholder crashes the
             // published renderer (unescapeHTML(undefined)).

package/dist/smoke.js

@@ -187,6 +187,36 @@ console.log("== expand: relocates misplaced responsive.<bp>.animation into confi
     const kept = landingDomain.expand(both).page[0].children[0].responsive.desktop;
     check("explicit config.animation wins over the stray key", kept.config.animation.name === "zoomIn" && kept.animation === undefined, kept.config);
 }
+console.log("== form fields: field_default follows the system field_name; alias names warn ==");
+{
+    // The editor locks a field's ID when properties.field_default is true and
+    // refuses system names when typed — so the lock must match the name, and a
+    // hand-made "phone" must be flagged before it is saved un-renameable.
+    const mk = (fields) => ({
+        page: [{ id: "s1", type: "section", responsive: { desktop: { styles: { height: 400 } }, mobile: { styles: { height: 400 } } },
+                children: [{ id: "f1", type: "form",
+                        responsive: { desktop: { styles: { top: 10, left: 10, width: 400, height: 300 } }, mobile: { styles: { top: 10, left: 10, width: 400, height: 300 } } },
+                        children: fields.map((f, i) => ({ id: `i${i}`, type: f.type ?? "input", properties: f.properties,
+                            responsive: { desktop: { styles: { top: i * 50, left: 0, width: 300, height: 40 } }, mobile: { styles: { top: i * 50, left: 0, width: 300, height: 40 } } },
+                            specials: { field_name: f.name, field_placeholder: "x" } })) }] }],
+        popup: [], settings: {},
+    });
+    const ex = landingDomain.expand(mk([
+        { name: "phone_number" },
+        { name: "message", properties: { field_default: true } },
+        { name: "phone" },
+    ]));
+    const kids = ex.page[0].children[0].children;
+    check("system field gets field_default:true", kids[0].properties.field_default === true, kids[0].properties);
+    check("custom field never locked", kids[1].properties.field_default === undefined, kids[1].properties);
+    check("field_default normalization idempotent", JSON.stringify(landingDomain.expand(ex)) === JSON.stringify(ex));
+    const w = validatePage(ex).warnings;
+    check("alias 'phone' warns → phone_number", w.some((m) => m.includes('"phone"') && m.includes('"phone_number"')), w);
+    check("canonical/custom names don't warn", !w.some((m) => m.includes('"message" should') || m.includes('"phone_number" should')), w);
+    const vi = landingDomain.expand(mk([{ name: "Số điện thoại" }, { name: "Họ tên" }]));
+    const wv = validatePage(vi).warnings;
+    check("Vietnamese aliases warn", wv.some((m) => m.includes('"phone_number"')) && wv.some((m) => m.includes('"full_name"')), wv);
+}
 console.log("== validate: accepts JSON string input ==");
 const r3 = validatePage(JSON.stringify(good));
 check("string input parsed & valid", r3.valid, r3.errors);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-landing-mcp",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "MCP server exposing Webcake landing-page element schemas + AI usage hints, and persisting LLM-generated page sources to a Webcake backend.",
   "mcpName": "io.github.vuluu2k/webcake-landing-mcp",
   "type": "module",