webcake-storefront-mcp 1.21.0 → 1.23.0

package/dist/builder/attributes.js

@@ -98,6 +98,30 @@ const FIELD = {
     required: "Field is required (boolean).",
     validate: "Enable validation (boolean).",
 };
+// Common runtime.config keys shared by EVERY input-like field (mined from 34 templates).
+// Spread into each field's `config` so they're documented everywhere.
+const FIELD_CONFIG = {
+    backgroundInput: "Input background colour.",
+    placeholderColor: "Placeholder text colour.",
+    labelColor: "Label colour.",
+    labelMarginBottom: "Gap below the label (px).",
+    textPadding: "Inner padding of the input (px).",
+    optionBorderColor: "Input border colour.",
+    optionBorderWidth: "Input border width (e.g. '1px').",
+    optionBorderStyle: "Input border style (solid|dashed|none).",
+    optionBorderRadius: "Input corner radius.",
+};
+// Filter-widget specials shared by category-page filters that drive a product grid
+// (checkbox-group, color-group, radio-group, two-point-range, tags, dropdown). These wire a
+// sidebar control to a grid-product so picking an option re-queries the products.
+const FILTER_SPECIALS = {
+    filter_elements: "Ids of the grid-product(s) this filter controls, e.g. ['GRID-PRODUCT-xxx'].",
+    sync_tab: "What to filter by: attribute | brand | category | price | tag.",
+    count: "How many options to show.",
+    options: "Filter options [{id,name,...}] (auto-built when syncing).",
+    is_auto_child_categories: "Auto-include child categories (boolean).",
+    use_button_filter: "Apply only when an Apply button is clicked (boolean).",
+};
 export const ELEMENT_ATTRS = {
     // ── content ──
     text: {
@@ -151,7 +175,7 @@ export const ELEMENT_ATTRS = {
     },
     container: { specials: { tabIndex: "Tab order.", custom_class: "CSS class.", custom_css: "Raw CSS." }, config: { maxWidth: "Max width.", maxWidthUnit: "Max-width unit.", fixedPosition: "Sticky/fixed positioning.", animation: "Entrance animation." }, events: "click, hover — clickable groups are common.", notes: "Generic grid box; nest children with their own grid." },
     row: { events: "none", notes: "Simple horizontal wrapper." },
-    tabs: { specials: { activeTab: "Default active tab index." }, events: "none", notes: "Tabbed container." },
+    tabs: { specials: { activeTab: "Default active tab index.", tabs: "Tab definitions [{id,name}].", navMode: "How tabs switch: toggle | …", showNav: "Show the tab nav (boolean).", showBullet: "Show bullets (boolean).", showDivider: "Show a divider (boolean)." }, config: { navPosition: "top|left|right|bottom.", alignNav: "Nav alignment.", nav_display_style: "Nav style." }, events: "tab — fires when the active tab changes.", notes: "Tabbed container; each tab maps to a tab item the content reacts to (e.g. account panels, product detail/description/reviews)." },
     collapse: { events: "none", notes: "Accordion container (collapse-item children)." },
     "collapse-item": { events: "none", notes: "One accordion panel." },
     "custom-layout": { events: "none", notes: "Free-form layout container." },
@@ -166,43 +190,53 @@ export const ELEMENT_ATTRS = {
     // ── form ──
     form: {
         specials: {
-            type: "Form behaviour — one of: form_login | form_signup | form_order | form_discount | subscribe | order_tracking | form_booking | form_search_agency | question_form.",
+            type: "Form behaviour — one of: form_login | form_signup | form_order | form_discount | subscribe | order_tracking | form_booking | form_search_agency | question_form | customer_data | reset_password | forgot_password.",
             submit_success: "Action after a successful submit (e.g. show a message / redirect).",
             message: "Success message text.",
             show_message: "Show a success message after submit (boolean).",
             show_message_time: "How long the success message stays (seconds).",
+            multiForms: "Ids of inner sub-forms this form owns (order forms split fields across an inner form).",
+            formParent: "On an inner sub-form: the id of the owning outer form.",
+            tabIndex: "Bind the form to a tab item (TAB-ITEM-…) in a tabbed account panel.",
+            autoGetInfoCustomer: "Pre-fill from the logged-in customer (boolean).",
+            partner_id: "Partner/agency id (booking/search-agency forms).",
+            time_otp: "OTP resend countdown (seconds).",
         },
-        config: { backgroundInput: "Input background.", labelColor: "Label colour.", placeholderColor: "Placeholder colour.", textPadding: "Input padding (px).", labelMarginBottom: "Gap below label (px).", borderColor: "Input border colour (e.g. #dbe0e6).", borderRadius: "Input corner radius (e.g. 8px)." },
+        config: { ...FIELD_CONFIG, borderColor: "Input border colour (e.g. #dbe0e6).", borderRadius: "Input corner radius (e.g. 8px).", labelPadding: "Label padding.", strokeColor: "Text stroke colour.", textColor: "Form text colour." },
         events: "success — fire follow-up actions after a successful submit (a form_order commonly does open_page→Thank-you page). eventName defaults to 'success' on a form.",
         notes: "Wrap input fields as children; put a submit-button inside. specials.type selects what the form does on submit. Real order forms split fields across an inner form via specials.multiForms:[innerFormId] (inner form sets specials.formParent). A form_order uses dedicated field types: input(full_name), phone-number, email, detect-address, address (×3 province/district/ward), text-area(note).",
     },
-    input: { specials: { ...FIELD, type: "Input type (default text)." }, config: { textPadding: "Padding.", backgroundInput: "Background." }, events: "none" },
-    email: { specials: { ...FIELD, validate_email: "Email regex." }, events: "none", notes: "field_name usually 'email'." },
-    "phone-number": { specials: { ...FIELD }, events: "none", notes: "field_name usually 'phone_number'." },
-    "retype-phone-number": { specials: { ...FIELD }, events: "none" },
-    password: { specials: { ...FIELD, field_type: "password.", validate_password: "Password regex." }, events: "none", notes: "field_name 'password'." },
-    "retype-password": { specials: { ...FIELD, validate_password: "Password regex." }, events: "none" },
-    "current-password": { specials: { ...FIELD, validate_password: "Password regex." }, events: "none" },
-    "text-area": { specials: { ...FIELD }, events: "none", notes: "Multi-line; field_name often 'note'." },
-    select: { specials: { ...FIELD, options: "Choices [{id,name}] (or {type,name,image,active}).", defaultValue: "Selected option id." }, config: { arrowColor: "Dropdown arrow colour.", optionBorderColor: "Option border." }, events: "none" },
-    "group-select": { specials: { ...FIELD, options: "Choices [{id,name}]." }, events: "none" },
-    checkbox: { specials: { field_name: FIELD.field_name, label: FIELD.label, show_label: FIELD.show_label, required: FIELD.required }, events: "none" },
-    "checkbox-group": { specials: { ...FIELD, options: "Choices [{id,name}]." }, config: { gap: "Item spacing.", column: "Columns." }, events: "none" },
+    input: { specials: { ...FIELD, type: "Input type (default text).", is_manually_added: "Field was added by hand vs auto (boolean)." }, config: { ...FIELD_CONFIG }, events: "none" },
+    email: { specials: { ...FIELD, validate_email: "Email regex." }, config: { ...FIELD_CONFIG }, events: "none", notes: "field_name usually 'email'." },
+    "phone-number": { specials: { ...FIELD }, config: { ...FIELD_CONFIG }, events: "none", notes: "field_name usually 'phone_number'." },
+    "retype-phone-number": { specials: { ...FIELD }, config: { ...FIELD_CONFIG }, events: "none" },
+    password: { specials: { ...FIELD, field_type: "password.", validate_p: "Password regex (e.g. ^[a-zA-Z0-9]{6,}$).", validate_password: "Password regex (alt key).", showHidePassword: "Show the eye toggle (boolean)." }, config: { ...FIELD_CONFIG }, events: "none", notes: "field_name 'password'." },
+    "retype-password": { specials: { ...FIELD, field_type: "retype-password.", showHidePassword: "Show the eye toggle (boolean)." }, config: { ...FIELD_CONFIG }, events: "none" },
+    "current-password": { specials: { ...FIELD, field_type: "current-password.", showHidePassword: "Show the eye toggle (boolean)." }, config: { ...FIELD_CONFIG }, events: "none" },
+    "text-area": { specials: { ...FIELD }, config: { ...FIELD_CONFIG }, events: "none", notes: "Multi-line; field_name often 'note'." },
+    select: { specials: { ...FIELD, options: "Choices [{id,name}] (or {type,name,image,active}).", defaultValue: "Selected option id.", isRetrieve: "Pre-fill from saved data (boolean).", isHideImage: "Hide option images (boolean)." }, config: { ...FIELD_CONFIG, arrowColor: "Dropdown arrow colour.", strokeColor: "Text stroke.", textColor: "Option text colour." }, events: "none" },
+    "group-select": { specials: { ...FIELD, options: "Choices [{id,name}]." }, config: { ...FIELD_CONFIG }, events: "none" },
+    checkbox: { specials: { field_name: FIELD.field_name, label: FIELD.label, show_label: FIELD.show_label, required: FIELD.required, options: "Choices [{id,name,connects?}].", defaultValue: "Default checked id ('none').", icon_color: "Check colour.", isRetrieve: "Pre-fill from saved data (boolean)." }, config: { ...FIELD_CONFIG, strokeColor: "Text stroke." }, events: "none" },
+    "checkbox-group": { specials: { ...FIELD, ...FILTER_SPECIALS, icon_color: "Check colour.", is_attribute_by_category: "Build options from the category's attributes (boolean)." }, config: { ...FIELD_CONFIG, borderRadiusInput: "Checkbox corner radius.", radioButtonSize: "Checkbox size (px).", spaceButtonText: "Gap between box and label.", strokeColor: "Text stroke.", textColor: "Label colour." }, events: "none", notes: "Doubles as a category-page FILTER: set filter_elements + sync_tab ('brand'/'attribute') to drive a grid-product." },
     "checkbox-item": { specials: { label: "Option text." }, events: "none" },
-    radio: { specials: { field_name: FIELD.field_name, label: FIELD.label, show_label: FIELD.show_label, required: FIELD.required }, events: "none" },
-    "radio-group": { specials: { ...FIELD, options: "Choices [{id,name,events?,connects?}]." }, config: { gap: "Item spacing.", column: "Columns." }, events: "none" },
-    address: { specials: { field_name: "province_id/district_id/commune_id.", label: FIELD.label, placeholder: FIELD.placeholder, show_label: FIELD.show_label, country: "Country code (e.g. 84).", required_province: "Require province.", required_districts: "Require district.", required_commune: "Require commune." }, events: "none" },
-    "detect-address": { specials: { ...FIELD, field_type: "detect_address." }, events: "none" },
-    "postal-code": { specials: { ...FIELD }, events: "none" },
-    country: { specials: { ...FIELD }, events: "none" },
-    "input-file": { specials: { ...FIELD, isTransferImage: "Transfer as image (boolean)." }, events: "none" },
-    "input-number": { specials: { ...FIELD }, events: "none" },
-    "input-date": { specials: { ...FIELD, type: "date | time." }, events: "none" },
-    "input-search": { specials: { field_name: "search.", label: FIELD.label, placeholder: FIELD.placeholder }, events: "none" },
-    "otp-input": { specials: { ...FIELD, isOpenModalOtp: "Open OTP modal (boolean)." }, events: "none" },
-    "rating-input": { specials: { field_name: FIELD.field_name, label: FIELD.label, show_label: FIELD.show_label }, events: "none" },
-    identity: { specials: { ...FIELD }, events: "none", notes: "Email-or-phone login field; field_name 'identity'." },
-    switch: { events: "none", notes: "Toggle; style width/height." },
+    radio: { specials: { field_name: FIELD.field_name, label: FIELD.label, show_label: FIELD.show_label, required: FIELD.required, options: "Choices [{id,name}].", defaultValue: "Default selected id.", icon_color: "Dot colour." }, config: { ...FIELD_CONFIG, sizeInput: "Radio size (px).", strokeColor: "Text stroke.", textColor: "Label colour." }, events: "none" },
+    "radio-group": { specials: { ...FIELD, ...FILTER_SPECIALS }, config: { ...FIELD_CONFIG, radioButtonSize: "Radio size (px).", spaceButtonText: "Gap between dot and label.", strokeColor: "Text stroke." }, events: "none", notes: "Can act as a FILTER (filter_elements + sync_tab)." },
+    address: { specials: { field_name: "province_id/district_id/commune_id.", label: FIELD.label, show_label: FIELD.show_label, useNewAddress: "Use the newer province/district/commune picker (boolean).", isColumn: "Stack the three selects in a column (boolean).", provinceName: "Province placeholder.", districtName: "District placeholder.", communeName: "Commune placeholder.", default_province: "Default province id ('none').", country: "Country code (e.g. 84).", required_province: "Require province.", required_districts: "Require district.", required_commune: "Require commune." }, config: { ...FIELD_CONFIG }, events: "none", notes: "Renders 3 linked selects (province→district→commune). A form_order usually has 3 address elements." },
+    "detect-address": { specials: { ...FIELD, field_type: "detect_address." }, config: { ...FIELD_CONFIG }, events: "none", notes: "Free-text address that auto-detects province/district." },
+    "postal-code": { specials: { ...FIELD, postal_code: "Regex (e.g. [0-9]{6}).", numberCharacter: "Expected length (e.g. '4_character')." }, config: { ...FIELD_CONFIG }, events: "none" },
+    country: { specials: { ...FIELD, countries: "Country list [{country_code,country_name}].", defaultValue: "Default country code (e.g. 'VN')." }, config: { ...FIELD_CONFIG }, events: "none" },
+    "input-file": { specials: { ...FIELD, isTransferImage: "Transfer as image (boolean)." }, config: { ...FIELD_CONFIG }, events: "none", notes: "Upload box — usually a dashed optionBorderStyle." },
+    "input-number": { specials: { ...FIELD }, config: { ...FIELD_CONFIG }, events: "none" },
+    "input-date": { specials: { ...FIELD, type: "date | time.", field_connect_pos: "Map to a POS customer field (e.g. customer_birthday)." }, config: { ...FIELD_CONFIG }, events: "none" },
+    "input-search": { specials: { field_name: "search.", label: FIELD.label, placeholder: FIELD.placeholder, showIcon: "Show the search icon (boolean).", searchIcon: "Search icon SVG.", showModalSearch: "Open results in a modal (boolean).", default_search_page: "Where Enter searches ('category_page').", isSearchInCategoryPage: "Search within the current category (boolean).", isSearchInBlogPage: "Search blog too (boolean).", view_keep_keywords: "Keep recent keywords ('category')." }, config: { inputBackground: "Input bg.", inputBorderColor: "Border colour.", inputBorderRadius: "Corner radius.", inputBorderWidth: "Border width.", placeholderColor: "Placeholder colour.", iconColor: "Icon colour.", iconAlign: "left|right.", iconSize: "Icon size (px).", textAlign: "Text alignment." }, events: "onenter — fires a search on Enter.", notes: "Storefront search box; pair with search-droppable for live results." },
+    "otp-input": { specials: { ...FIELD, isOpenModalOtp: "Open OTP modal (boolean).", time_otp: "Resend countdown (seconds)." }, config: { ...FIELD_CONFIG }, events: "none" },
+    "rating-input": { specials: { field_name: FIELD.field_name, label: FIELD.label, show_label: FIELD.show_label, auto_hide_without_star: "Hide when no rating (boolean).", activeStarIcon: "Filled-star SVG.", inactiveStarIcon: "Empty-star SVG." }, config: { activeStarColor: "Filled star colour.", inactiveStarColor: "Empty star colour." }, events: "none", notes: "Star rating input (review form)." },
+    identity: { specials: { ...FIELD }, config: { ...FIELD_CONFIG }, events: "none", notes: "Email-or-phone login field; field_name 'identity'." },
+    "search-form": { specials: { ...FIELD, field_type: "search." }, config: { ...FIELD_CONFIG }, events: "none", notes: "A search field inside a form." },
+    "search-droppable": { config: { use_overlay: "Dim the page behind the results (boolean).", droppable_position: "Where results open (custom|...)." }, events: "none", notes: "Live search-results dropdown paired with an input-search." },
+    "two-point-range": { specials: { filter: "What it filters (e.g. 'filter_price').", min: "Range minimum.", max: "Range maximum.", display_type: "Handle style (round|...).", use_button_filter: "Apply only on a button (boolean)." }, config: { dotColor: "Handle colour.", dotSize: "Handle size (px).", progressColor: "Active track colour.", progressBgColor: "Inactive track colour.", progressSize: "Track thickness (px).", textColor: "Min/max label colour." }, events: "none", notes: "A price (or numeric) RANGE filter for the category page — set filter + filter_elements to drive a grid-product." },
+    "color-group": { specials: { ...FILTER_SPECIALS, options: "Swatches [{color, filter:{attrName,...}}].", sync_tab: "attribute (colour variations)." }, config: { colorWidth: "Swatch width.", colorHeight: "Swatch height.", colorGap: "Gap between swatches.", colorBorderRadius: "Swatch radius.", colorBorderColor: "Swatch border.", colorBorderColorActive: "Selected swatch border.", textPosition: "Label position.", hiddenText: "Hide the label (boolean)." }, events: "none", notes: "Colour-swatch FILTER (category page) — filter_elements + sync_tab:'attribute' drive a grid-product." },
+    switch: { specials: { defaultValue: "Default on/off (boolean)." }, config: { backgroundSlider: "Track colour.", colorRound: "Knob colour.", colorSlider: "Active track colour." }, events: "none", notes: "Toggle; style width/height." },
     // ── commerce ──
     "grid-product": {
         specials: { displayStyle: "default | only_image | border.", original_price_position: "left | right.", products_per_load: "Products fetched per page/scroll (real range 8–36).", category_id: "Source products from a specific category id (else current category).", show_original_price: "Show the compare-at price (boolean).", show_discount_on_price: "Show a discount badge on the price (boolean).", show_quick_view: "Show a quick-view button on hover (boolean).", show_product_name: "Show the product name (boolean).", show_product_price: "Show the price (boolean).", show_rating: "Show the star rating (boolean).", load_rating: "Fetch ratings for the cards (boolean).", show_ribbon: "Show a ribbon/badge (boolean).", load_brand: "Fetch + show the brand (boolean).", load_category: "Fetch + show the category (boolean).", show_categories: "Show category labels (boolean).", on_hover: "Card hover effect: zoom | swap (swap to 2nd image).", randomDisplay: "Randomise product order (boolean).", typeLinkCategory: "Related-products source: similar_product | products_viewed.", plugins: "Extra card plugins [{name,type,icon}] (e.g. attribute templates, extra info)." },
@@ -253,16 +287,16 @@ export const ELEMENT_ATTRS = {
     "favorite-icon": { events: "click — toggle favourite." },
     "bonus-items": { specials: { typeBonus: "combo_product | other." }, events: "none" },
     // ── navigation ──
-    menu: { specials: { type: "horizontal | vertical | hamburger | anchor.", sync: "Auto-sync items with site pages (boolean).", fullField: "Stretch items to fill the menu width (boolean)." }, config: { showArrow: "Show the dropdown caret on items with a submenu (boolean).", textColor: "Item text colour (often a theme var like var(--color_20)).", colorHover: "Item hover colour.", "--padX": "Horizontal padding inside each item (CSS var, e.g. 15px)." }, events: "none", notes: "Holds menu-item children. Real templates colour items via theme vars (var(--color_20))." },
-    "menu-item": { specials: { name: "Link label.", isCustom: "Custom link (boolean).", linkType: "page | category | blog_category | brand | product_tag | custom.", linkPage: "Target page id (linkType=page).", pageId: "Target page id (mirror of linkPage, set both).", linkCategory: "Linked category id.", categoryId: "Category id.", syncSubmenu: "Auto-build submenu (boolean)." }, events: "navigation lives in SPECIALS here, NOT events — set linkType + the matching id.", notes: "For a page link set linkType='page' + linkPage + pageId + name. (Generic text/container/button elements navigate via events:[{action:'open_page',open_page_id}] instead.)" },
-    "menu-anchor-item": { specials: { name: "Label.", isCustom: "Custom.", linkType: "Link kind.", categoryId: "Category id." }, events: "click — scrolls to an anchor." },
-    submenu: { events: "none", notes: "Dropdown under a menu-item." },
-    "menu-droppable": { events: "none" },
-    "member-bar": { events: "none", notes: "Logged-in member bar (account links)." },
-    "member-dropdown": { events: "none" },
-    dropdown: { events: "click/hover — toggles dropdown-content." },
-    "dropdown-content": { events: "none" },
-    "language-menu": { events: "none", notes: "Language switcher." },
+    menu: { specials: { type: "horizontal | vertical | hamburger | collapse | grid | anchor.", sync: "Auto-sync items with site pages (boolean).", fullField: "Stretch items to fill the menu width (boolean).", shapeType: "'Icon' to render a hamburger/icon trigger instead of text.", url: "Icon image url (icon-style menu).", isPostList: "Build items from blog posts (boolean).", tabIndex: "Bind to a tab item." }, config: { showArrow: "Show the dropdown caret on items with a submenu (boolean).", textColor: "Item text colour (often a theme var like var(--color_20)).", colorHover: "Item hover colour.", activeColor: "Active item colour.", "--padX": "Horizontal padding inside each item (CSS var, e.g. 15px).", mask: "Icon SVG mask (icon-style menu).", arrowColor: "Caret colour.", arrowSize: "Caret size (px).", backgroundHover: "Item hover background.", borderColorHover: "Item hover border colour.", borderRadiusHover: "Item hover radius.", fontWeightHover: "Item hover font weight.", activeLink: "Active-item style object (e.g. {fontWeight:'bold'}).", maxHeight: "Max dropdown height (px)." }, events: "none", notes: "Holds menu-item children. Real headers carry TWO menus (a horizontal desktop menu + a hamburger/collapse mobile menu). Colour items via theme vars (var(--color_20))." },
+    "menu-item": { specials: { name: "Link label.", isCustom: "Custom link (boolean).", isSync: "Auto-synced from site pages (boolean).", linkType: "page | category | blog_category | brand | product_tag | custom.", linkPage: "Target page id (linkType=page).", pageId: "Target page id (mirror of linkPage, set both).", linkCategory: "Linked product category id.", linkCategoryTarget: "Open target for the category (_self/_blank).", linkBlogCategory: "Linked blog category id.", link: "Custom href (linkType=custom).", categoryId: "Category id.", syncSubmenu: "Auto-build submenu (boolean).", type: "vertical for a stacked submenu item." }, config: { strokeColor: "Text stroke colour." }, events: "navigation lives in SPECIALS here, NOT events — set linkType + the matching id.", notes: "For a page link set linkType='page' + linkPage + pageId + name. Category → linkType='category' + linkCategory. Custom url → linkType='custom' + link + isCustom. (Generic text/container/button navigate via events:[{action:'open_page',open_page_id}].)" },
+    "menu-anchor-item": { specials: { name: "Label.", isCustom: "Custom.", linkType: "Link kind.", anchor: "Target anchor id on the page.", categoryId: "Category id." }, events: "click — scrolls to an anchor." },
+    submenu: { specials: { syncSubmenu: "Auto-build from child pages/categories (boolean).", type: "vertical | horizontal.", effect: "Open animation (fade-in|…).", timeAnim: "Animation duration (s)." }, events: "none", notes: "Dropdown panel under a menu-item." },
+    "menu-droppable": { specials: { effect: "Open animation (light-speed|fade-in|…).", timeAnim: "Animation duration (s)." }, config: { isUseInitMaxHeight: "Animate from a max-height (boolean)." }, events: "none", notes: "Mega-menu panel under a menu-item (holds a nested menu + content)." },
+    "member-bar": { specials: { showView: "Which state to show: not_logged | logged.", layoutShow: "avatar | text | …", textLogin: "Login label.", textSignup: "Signup label.", textLogout: "Logout label.", textBeforeLogin: "Text shown before login.", login_icon: "Login icon SVG.", signup_icon: "Signup icon SVG.", login_popup: "Popup id opened for login.", register_popup: "Popup id opened for signup.", show_signup: "Show the signup option (boolean).", event_type: "What clicking does (open_page|open_popup).", open_when_logged: "Logged-in behaviour (collapse|…).", arrowShape: "Dropdown arrow shape." }, config: { avatarSize: "Avatar size (px).", colorIcon: "Icon colour.", memberColorHover: "Hover colour.", bgDropdown: "Dropdown background.", justifyBar: "Bar alignment." }, events: "click — login/logout/open account.", notes: "Account bar: shows login/signup when logged out, avatar+menu when logged in. member-dropdown is its dropdown panel." },
+    "member-dropdown": { specials: { dropdown_position: "left | right." }, events: "none", notes: "The account dropdown under a member-bar." },
+    dropdown: { specials: { placeholder: "Closed-state label (e.g. 'Thứ tự mặc định').", options: "Choices [{id,name}].", count: "How many options.", is_default_select: "Pre-select the first (boolean).", filter_elements: "Grid-product id(s) this sort/filter controls.", sync_tab: "What it syncs from (category|…).", redirect_type: "Navigate on select (none|page).", redirect_id: "Target id when redirecting.", arrowIcon: "Arrow SVG.", use_button_filter: "Apply only on a button (boolean)." }, config: { arrowColor: "Arrow colour.", arrowSize: "Arrow size (px).", strokeColor: "Text stroke.", textColor: "Text colour." }, events: "click/hover — toggles dropdown-content. Commonly a product SORT control on the category page (set filter_elements).", notes: "Product sort/filter dropdown, or a generic toggle for dropdown-content." },
+    "dropdown-content": { events: "none", notes: "The panel a dropdown toggles." },
+    "language-menu": { specials: { show_flag: "Show country flags (boolean).", type: "dropdown | inline." }, config: { display: "full | abbreviated.", flagSize: "Flag size (px).", color: "Text colour.", colorHover: "Hover colour.", backgroundDropdown: "Dropdown background.", colorSelected: "Selected language colour.", dropdown_icon_size: "Caret size (px)." }, events: "none", notes: "Language switcher (multilingual sites)." },
     // ── blog ──
     "post-list": { events: "none", notes: "Lists blog articles. Create blog category + articles first." },
     "slider-post": { config: { slideItems: "Visible posts.", slideWidth: "Card width." }, events: "none" },
@@ -270,6 +304,18 @@ export const ELEMENT_ATTRS = {
     "slider-blog": { specials: { showBlogs: "Categories to show." }, config: { columns: "Visible posts." }, events: "none" },
     "post-overlay": { specials: { type: "regular | custom." }, events: "none", notes: "Post card overlay (post page)." },
     "blog-overlay": { specials: { type: "regular | custom." }, events: "none" },
+    // ── filters / widgets / states (mined from 34 templates) ──
+    tags: { specials: { ...FILTER_SPECIALS, activeMode: "How active tags render.", selectionMode: "single | multiple.", tabIndex: "Bind to a tab." }, config: { tags_layout: "Tag layout style." }, events: "click — filters the linked grid-product.", notes: "Tag/attribute chips that FILTER a product grid (category page) — set filter_elements + sync_tab:'tag'." },
+    "auto-number": { specials: { startNumber: "Start value.", endNumber: "End value.", jumpNumber: "Increment step.", duration: "Count-up duration (s)." }, config: { strokeColor: "Text stroke.", textColor: "Number colour." }, events: "none", notes: "Animated count-up stat (e.g. '10,000+ customers')." },
+    agency: { specials: { datagrid_id: "Linked data grid id.", googleTarget: "Google-map target." }, config: { hoverColor: "Hover colour.", activeColor: "Active colour." }, events: "none", bindings: ["agency::name", "agency::phone_number", "agency::address", "agency::time"], notes: "Store-locator / branch list (repeater over agency::*)." },
+    "user-point-log": { specials: { itemGap: "Row gap.", noteColor: "Note colour.", datetimeColor: "Date colour." }, events: "none", notes: "Loyalty reward-point history (member page)." },
+    "empty-product-layout": { events: "none", notes: "Empty-state shown inside a grid-product when no products match." },
+    "cart-items-empty": { events: "none", notes: "Empty-state shown inside cart-items when the cart is empty." },
+    "cart-droppable": { events: "none", notes: "Mini-cart drawer/panel (header). Open via open_cart / open_popup." },
+    "lesson-sidebar": { specials: { submit_status: "Lesson completion state." }, config: { backgroundModule: "Module background.", iconSize: "Icon size (px)." }, events: "none", notes: "Course lesson navigation sidebar (course app)." },
+    "lesson-items": { events: "none", notes: "Lessons list inside a module (course app)." },
+    "next-lesson-droppable": { events: "none", notes: "Next-lesson panel (course app)." },
+    "list-lesson-droppable": { events: "none", notes: "Lessons droppable list (course app)." },
 };
 const describe = (type, key, where) => {
     const curated = ELEMENT_ATTRS[type] || {};

package/dist/builder/bindings.js

@@ -26,7 +26,12 @@ export const BINDING_DATASETS = {
             "product::product_categories", "product::brand_name", "product::product_tag",
             "product::product_remain_quantity", "product::total_sold_web", "product::rating_point",
             "product::rating_count", "product::variation_sku", "product::product_wholesale_price",
-            "product::discount_price_from_original_price", "product::preorder_text", "product::product_note",
+            "product::discount_price_from_original_price", "product::discount_price_to_original_price",
+            "product::preorder_text", "product::product_note",
+            // course / LMS products (use_store + course app):
+            "product::total_course", "product::total_course_learning", "product::course_member_quantity",
+            "product::course_total_time", "product::course_video_quantity", "product::lesson_name",
+            "product::lesson_description", "product::video_lesson",
         ],
     },
     "product-overlay": {
@@ -46,7 +51,9 @@ export const BINDING_DATASETS = {
             "cart_item::cart_item_original_price", "cart_item::cart_item_subtotal", "cart_item::cart_item_total_price",
             "cart_item::cart_item_total_quantity", "cart_item::cart_item_prod_attr", "cart_item::sku",
             "cart_item::cart_total_price", "cart_item::cart_total_tax", "cart_item::cart_shipping_fee",
-            "cart_item::cart_promotion_discount", "cart_item::subtotal_before_discount", "cart_item::product_note",
+            "cart_item::cart_surcharge_fee", "cart_item::cart_promotion_discount", "cart_item::discount_percent",
+            "cart_item::discount_reward_point", "cart_item::total_price_all_promotions",
+            "cart_item::subtotal_before_discount", "cart_item::product_note",
         ],
     },
     order: {
@@ -58,6 +65,7 @@ export const BINDING_DATASETS = {
             "order::order_payment_method", "order::shipping_fee", "order::subtotal", "order::total_price",
             "order::total_tax", "order::code_order", "order::order_status", "order::payment_status",
             "order::order_quantity", "order::order_date", "order::order_coupon", "order::order_promotion_discount",
+            "order::order_promotion_coupon",
         ],
     },
     order_item: {
@@ -97,6 +105,7 @@ export const BINDING_DATASETS = {
             "customer::profile_avatar", "customer::profile_name", "customer::phone_number", "customer::email",
             "customer::gender", "customer::birthday", "customer::order_count", "customer::purchased_amount",
             "customer::pos_reward_point", "customer::pos_reward_point_level", "customer::pos_level_discount",
+            "customer::succeed_order_count",
         ],
     },
     customer_address: {
@@ -146,6 +155,46 @@ export const BINDING_DATASETS = {
         summary: "Page / site info.",
         fields: ["general_info::page_name", "general_info::site_name", "general_info::menu_title"],
     },
+    agency: {
+        name: "agency",
+        page_type: "any",
+        repeater_parents: ["agency"],
+        summary: "A store / branch in a store-locator (agency) list.",
+        fields: ["agency::name", "agency::phone_number", "agency::address", "agency::time"],
+    },
+    blog: {
+        name: "blog",
+        page_type: "blog",
+        summary: "The current blog CATEGORY (heading on a blog list page) — distinct from `post`.",
+        fields: ["blog::category_name", "blog::category_description"],
+    },
+    search_result: {
+        name: "search_result",
+        page_type: "store",
+        summary: "Search-results context (the query + matched products) on a search page.",
+        fields: ["search_result::search_name", "search_result::products"],
+    },
+};
+// Binding META keys beyond {id,name,target} — these are HOW a source field combines into the
+// element (mined from 34 real templates). makeBinding preserves any of them verbatim, e.g.
+// new_element('text-dataset',{ bindings:[{ target:'product::product_name', name_style:'sku',
+// number_of_line_title:1 }] }). Listed so the AI knows the real combine-keys (no invented keys).
+export const BINDING_META_KEYS = {
+    name_style: "Render style of a name/value: 'sku' | 'variation-sku' (show the SKU/variation form).",
+    attr_id: "Bind a SPECIFIC product attribute by id (ATTR-xxxx) — used with attr::attr_name / attr::attr_value.",
+    target_attr: "For cart_item::cart_item_prod_attr — pick one attribute by name (e.g. 'Màu sắc').",
+    value_attr: "Companion to target_attr — which part to show ('value').",
+    prefix_content: "Text prepended before the value (e.g. '-' or a label).",
+    separator: "Separator string when the field is a list.",
+    value: "A SECOND source for a COMPUTED display, e.g. cart_item::cart_total_price with value:'form::coupon_price' subtracts the coupon. Combine two datasets in one node.",
+    order: "Index into a multi-value field (pick the Nth).",
+    order_value: "Which sub-value of an ordered field to show (e.g. 'description').",
+    number_of_line_title: "Clamp the text to N lines.",
+    showText: "Show the field label/text alongside the value (boolean).",
+    max_item_show: "Max items to render for a list-valued field.",
+    bind_image_by_category_id: "For images: resolve from a category instead of the product.",
+    auto_hide_without_star: "Hide the node when there's no rating (boolean).",
+    show_video_demo: "Show the product video demo (boolean).",
 };
 // Build fast lookups.
 const ALL_TARGETS = new Set();
@@ -241,8 +290,9 @@ export function validateBindings(node) {
 /** Catalog for the list_bindings discovery tool. */
 export function describeBindingsCatalog() {
     return {
-        note: "Dataset elements (text-dataset/image-dataset/…) and children of a repeater (grid-product, cart-items, post-list…) carry bindings:[{ id, name, target }]. Build via new_element opts.bindings (ids auto-minted) — e.g. new_element('text-dataset',{ bindings:[{ target:'product::product_price', show_tax:true }] }). A target only resolves on a page whose type enables its dataset (store→use_store, member→use_member, blog→use_blog) — build_page handles the flag.",
-        page_type_required: { store: ["product", "product-overlay", "cart_item", "order", "order_item", "category", "bonus_item", "promotion_item", "attr"], member: ["customer", "customer_address"], blog: ["post"], any: ["form", "general_info"] },
+        note: "Dataset elements (text-dataset/image-dataset/…) and children of a repeater (grid-product, cart-items, post-list…) carry bindings:[{ id, name, target, ...meta }]. Build via new_element opts.bindings (ids auto-minted) — e.g. new_element('text-dataset',{ bindings:[{ target:'product::product_price', show_tax:true }] }). A target only resolves on a page whose type enables its dataset (store→use_store, member→use_member, blog→use_blog) — build_page handles the flag. The optional meta keys (name_style, prefix_content, value, attr_id, …) control HOW the value renders/combines — see meta_keys.",
+        meta_keys: BINDING_META_KEYS,
+        page_type_required: { store: ["product", "product-overlay", "cart_item", "order", "order_item", "category", "bonus_item", "promotion_item", "attr", "search_result"], member: ["customer", "customer_address"], blog: ["post", "blog"], any: ["form", "general_info", "agency"] },
         repeater_context: REPEATER_CONTEXT,
         datasets: Object.values(BINDING_DATASETS).map((ds) => ({
             name: ds.name,

package/dist/builder/events.js

@@ -26,22 +26,22 @@ export const EVENT_TRIGGERS = [
 const TRIGGER_NAMES = new Set(EVENT_TRIGGERS.map((t) => t.name));
 export const EVENT_ACTIONS = [
     // navigation
-    { action: "open_page", trigger: "click", category: "navigation", summary: "Go to a page in this site.", required: ["open_page_id"], optional: ["scrollTarget", "scroll_to_id", "scroll_to_element_id", "scrollMore", "no_follow", "active_color"] },
+    { action: "open_page", trigger: "click", category: "navigation", summary: "Go to a page in this site.", required: ["open_page_id"], optional: ["scrollTarget", "scroll_to_id", "scroll_to_element_id", "scrollMore", "no_follow", "active_color", "popup_id", "popup_overlay", "close_all_other_popup", "open_category_id", "open_blog_category_id", "open_menu_id", "activeNotify"] },
     { action: "open_link", trigger: "click", category: "navigation", summary: "Open an external URL.", required: ["link_target"], optional: ["link_target_url", "no_follow"] },
     { action: "open_category", trigger: "click", category: "navigation", summary: "Open a product category page.", required: ["open_category_id"], optional: ["no_follow"] },
     { action: "open_blog_category", trigger: "click", category: "navigation", summary: "Open a blog category page.", required: ["open_blog_category_id"], optional: ["no_follow"] },
     { action: "scroll_to", trigger: "click", category: "navigation", summary: "Smooth-scroll to a section/element on this page.", required: ["scroll_to_id"], optional: ["scroll_to_element_id", "scrollMore", "scrollTarget"], target_in_page: ["scroll_to_id", "scroll_to_element_id"] },
     { action: "direction_login", trigger: "click", category: "navigation", summary: "Redirect by login state: open_page_id if logged in, target_direction_id if not.", required: ["open_page_id"], optional: ["target_direction_id"] },
     // ui control
-    { action: "toggle", trigger: "click", category: "ui", summary: "Show/hide another element on this page.", required: ["toggle_id"], optional: ["toggle_status", "only_mode"], target_in_page: ["toggle_id"] },
-    { action: "open_popup", trigger: "click", category: "ui", summary: "Open a popup.", required: ["popup_id"], optional: ["popup_overlay", "close_all_other_popup"] },
+    { action: "toggle", trigger: "click", category: "ui", summary: "Show/hide another element on this page (the most common interaction — accordions, drawers, filters).", required: ["toggle_id"], optional: ["toggle_status", "only_mode"], target_in_page: ["toggle_id"] },
+    { action: "open_popup", trigger: "click", category: "ui", summary: "Open a popup (use mouseenter for a hover mini-cart/submenu).", required: ["popup_id"], optional: ["popup_overlay", "close_all_other_popup", "open_page_id", "only_mode", "toggle_id", "open_category_id", "scroll_to_id"] },
     { action: "close_popup", trigger: "click", category: "ui", summary: "Close a popup.", required: ["popup_id"], optional: ["popup_overlay", "close_all_other_popup"] },
     { action: "open_menu", trigger: "click", category: "ui", summary: "Open a dropdown/submenu.", required: ["open_menu_id"], target_in_page: ["open_menu_id"] },
     { action: "close_menu", trigger: "click", category: "ui", summary: "Close a menu.", optional: ["close_menu_id"] },
     { action: "change_tab", trigger: "click", category: "ui", summary: "Switch a swiper/tabs to a given tab.", required: ["change_tab_id"], optional: ["move_to", "tab_index", "tab_color"], target_in_page: ["change_tab_id"] },
     { action: "load_more", trigger: "click", category: "ui", summary: "Load more items in a list.", optional: ["load_more_id"], target_in_page: ["load_more_id"] },
     // cart / commerce
-    { action: "add_to_cart", trigger: "click", category: "cart", summary: "Add the current product to the cart.", optional: ["open_page", "auto_add_bonus", "activeNotify", "productNoteElId"] },
+    { action: "add_to_cart", trigger: "click", category: "cart", summary: "Add the current product to the cart.", optional: ["open_page", "open_page_id", "open_popup_id", "open_target", "open_category_id", "auto_add_bonus", "activeNotify", "productNoteElId"] },
     { action: "buy_now", trigger: "click", category: "cart", summary: "Add to cart and go straight to checkout.", optional: ["open_page", "auto_add_bonus", "activeNotify"] },
     { action: "add_to_cart_form", trigger: "success", category: "cart", summary: "Add to cart from a form submit (product form).", optional: ["open_page"] },
     { action: "open_cart", trigger: "click", category: "cart", summary: "Open the cart sidebar/drawer." },
@@ -66,10 +66,32 @@ export const EVENT_ACTIONS = [
     { action: "send_whatsapp_mess", trigger: "click", category: "contact", summary: "Open WhatsApp chat.", optional: ["whatsapp_phone_number"] },
     { action: "sharing", trigger: "click", category: "contact", summary: "Share to a social network.", optional: ["shareTarget", "shareLink", "shareLinkCustom"] },
     // hover styles (eventName must be "hover")
-    { action: "scale", trigger: "hover", category: "hover", summary: "Scale the element on hover.", optional: ["el_target_id"] },
-    { action: "change_background", trigger: "hover", category: "hover", summary: "Change background colour on hover." },
-    { action: "change_text_color", trigger: "hover", category: "hover", summary: "Change text colour on hover." },
-    { action: "change_border_color", trigger: "hover", category: "hover", summary: "Change border colour on hover." },
+    { action: "scale", trigger: "hover", category: "hover", summary: "Scale the element on hover.", optional: ["el_target_id", "scale_value"] },
+    { action: "change_background", trigger: "hover", category: "hover", summary: "Change background colour on hover.", optional: ["change_background", "apply_element", "cursor", "el_target_id"] },
+    { action: "change_text_color", trigger: "hover", category: "hover", summary: "Change text colour on hover.", optional: ["change_text_color", "apply_element", "cursor", "el_target_id"] },
+    { action: "change_border_color", trigger: "hover", category: "hover", summary: "Change border colour on hover.", optional: ["change_border_color", "apply_element", "cursor", "el_target_id"] },
+    { action: "transform_y", trigger: "hover", category: "hover", summary: "Shift the element vertically on hover (lift effect).", optional: ["transform_y", "apply_element"] },
+    { action: "transform_x", trigger: "hover", category: "hover", summary: "Shift the element horizontally on hover.", optional: ["transform_x", "apply_element"] },
+    { action: "cursor", trigger: "hover", category: "hover", summary: "Change the cursor on hover.", optional: ["cursor"] },
+    // commerce / cart interactions (mined from 34 real templates)
+    { action: "open_quick_view", trigger: "click", category: "cart", summary: "Open a product quick-view popup from a product card.", optional: ["popup_id", "activeNotify", "active_color"] },
+    { action: "open_product_page", trigger: "click", category: "navigation", summary: "Open the product detail page for this card's product." },
+    { action: "open_preview_product_gallery", trigger: "click", category: "media", summary: "Open the product image in a gallery preview.", optional: ["open_preview_product_gallery_id", "target"] },
+    { action: "close_cart_item", trigger: "click", category: "cart", summary: "Remove this line item from the cart." },
+    { action: "edit_cart_item", trigger: "click", category: "cart", summary: "Edit this cart line item (qty / variation)." },
+    { action: "change_column_grid_prd", trigger: "click", category: "ui", summary: "Switch the product grid's column count.", optional: ["columnNumber", "target_id"], target_in_page: ["target_id"] },
+    { action: "add_wishlist_product", trigger: "click", category: "cart", summary: "Add the product to the wishlist.", optional: ["activeNotify"] },
+    { action: "wishlist_remove_item", trigger: "click", category: "cart", summary: "Remove an item from the wishlist.", optional: ["target_custom_links"] },
+    { action: "use_reward_point", trigger: "click", category: "cart", summary: "Apply loyalty reward points to the order.", optional: ["reward_point", "target"] },
+    { action: "copy_promotion", trigger: "click", category: "cart", summary: "Copy a promotion/coupon code to the clipboard.", optional: ["has_text", "is_hidden", "text_change"] },
+    // search + menu + account interactions
+    { action: "search", trigger: "click", category: "navigation", summary: "Run a storefront product search.", optional: ["open_page_id", "open_category_id"] },
+    { action: "close_search", trigger: "click", category: "ui", summary: "Close the search box/droppable.", optional: ["close_search_id"], target_in_page: ["close_search_id"] },
+    { action: "toggle_group", trigger: "click", category: "ui", summary: "Toggle a group of elements together (e.g. a mobile menu / filter group).", optional: ["actions", "data", "data_more", "show"] },
+    { action: "back_to_menu_parent", trigger: "click", category: "ui", summary: "Go back up one level in a multi-level mobile menu." },
+    { action: "lightbox", trigger: "click", category: "media", summary: "Open an image in a lightbox.", optional: ["lightboxLink"] },
+    { action: "set_address_default", trigger: "click", category: "account", summary: "Mark a saved address as the default." },
+    { action: "change_avatar", trigger: "click", category: "account", summary: "Change the member avatar." },
 ];
 const ACTION_BY_NAME = {};
 for (const a of EVENT_ACTIONS)

package/dist/builder/guide.js

@@ -131,6 +131,33 @@ key — only bp1..bp4.)
   \`text-dataset\` with \`product::product_name\` resolves to that cell's product (no extra
   wiring). Same for cart-items→cart_item, order-items→order_item, post-list→post,
   grid-category→category. A target only resolves on a page of the matching \`type\` (below).
+- BINDING COMBINE-KEYS (how a field renders/combines — mined from real templates; pass them
+  alongside \`target\`): \`name_style:"sku"|"variation-sku"\`, \`prefix_content:"-"\` (prepend),
+  \`number_of_line_title:1\` (clamp lines), \`attr_id:"ATTR-…"\` (bind ONE attribute), and
+  \`value:"form::coupon_price"\` — a SECOND source so one node shows a COMPUTED value (e.g.
+  \`cart_item::cart_total_price\` with \`value:"form::coupon_price"\` = total minus coupon). Call
+  \`list_bindings\` → meta_keys for the full list.
+
+## Composition recipes (how real templates assemble components)
+Repeaters fall into two kinds (surveyed across 34 templates):
+- SELF-RENDERING (just add badges): \`grid-product\` / \`slider-product\` / \`post-list\` render the
+  card themselves — their children are only \`product-overlay\` (sale/discount badge) or, for a
+  fully custom card, a \`custom-layout\` wrapping dataset cells. \`post-list\`→\`post-overlay\` children.
+- HAND-COMPOSED from per-item dataset cells (build the row yourself):
+  - \`cart-items\` row = \`image-dataset[cart_item::cart_item_image]\`, \`text-dataset[cart_item::cart_item_name]\`,
+    \`text-dataset[cart_item::cart_item_price]\`, \`quantity-input\`, \`text-dataset[cart_item::cart_item_total_price]\`,
+    a \`container\` for name+\`cart_item::cart_item_prod_attr\`, \`line\` (config.columns sets the row template).
+  - \`order-items\` row = \`image-dataset[order_item::product_image]\` + \`text-dataset\` for
+    \`order_item::product_name\` / \`product_attrs\` / \`product_quantity\` / \`items_sum_up_price\`.
+  - \`layout-dataset\` / \`customer-address\` = a generic repeater: \`text-dataset[customer_address::full_name|phone_number|address|pdc|is_default]\` + a "Set default" button.
+  - \`promotions\` = \`text-dataset[promotion_item::code|description|end_date]\` + a copy button (\`copy_promotion\`).
+The bare \`cart-items\`/\`order-items\` (no children) self-render a DEFAULT row — fine for a quick build; compose cells only when you want a custom layout.
+HEADER patterns: real headers carry TWO menus (a horizontal desktop \`menu\` + a hamburger/collapse mobile \`menu\`), the logo (image/text), \`cart-icon\`, often \`input-search\`/\`search-droppable\`, \`member-bar\` (login/signup ↔ avatar+account), and \`language-menu\`. BREADCRUMB is common — keep it on category/product pages (often its own slim section, or next to a \`text-dataset\` page title).
+CATEGORY-PAGE FILTERS: a category page sidebar FILTERS the product grid. The filter widgets —
+\`checkbox-group\` / \`color-group\` / \`tags\` / \`two-point-range\` (price) / \`radio-group\` / a sort
+\`dropdown\` — each carry \`specials.filter_elements:["GRID-PRODUCT-id"]\` (the grid they drive) +
+\`specials.sync_tab\` ("attribute" | "brand" | "category" | "price" | "tag") so picking an option
+re-queries that grid-product. So a real category page = breadcrumb + [filter sidebar | grid-product].
 
 ## Events (clicks, navigation, cart, popups)
 Interactive nodes (button, text, image, container, rectangle, icons) carry an \`events\`

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.23.0",
+    "d": "25/06/2026",
+    "type": "Added",
+    "en": "get_build_guide now includes a category-page filter recipe explaining how sidebar filter widgets (checkbox-group, color-group, tags,…",
+    "vi": "get_build_guide nay bổ sung công thức filter trang danh mục, giải thích cách các widget lọc trong sidebar (checkbox-group, color-group, tags,…"
+  },
+  {
+    "v": "1.22.0",
+    "d": "25/06/2026",
+    "type": "Added",
+    "en": "list_bindings now returns a meta_keys map documenting binding combine-keys mined from 34 production templates — name_style, attr_id, prefix_content,…",
+    "vi": "list_bindings nay trả về map meta_keys tài liệu hóa các combine-key liên kết dữ liệu được khai thác từ 34 template production — name_style, attr_id,…"
+  },
   {
     "v": "1.21.0",
     "d": "25/06/2026",
@@ -26,19 +40,5 @@
     "type": "Added",
     "en": "New scaffold_global_sections tool generates a fully-designed global Header and Footer in one call — logo, nav links, cart icon, CTA button, and a…",
     "vi": "Tool mới scaffold_global_sections tạo Header và Footer toàn cục đã thiết kế sẵn trong một lần gọi — logo, liên kết điều hướng, icon giỏ hàng, nút…"
-  },
-  {
-    "v": "1.18.1",
-    "d": "25/06/2026",
-    "type": "Changed",
-    "en": "get_build_guide now includes three new sections: \"Build the WHOLE storefront\" with per-page recipes for enriching category, product detail, cart,…",
-    "vi": "get_build_guide nay bổ sung ba mục mới: \"Build the WHOLE storefront\" — công thức từng trang để nâng cấp danh mục, trang chi tiết sản phẩm, giỏ hàng,…"
-  },
-  {
-    "v": "1.18.0",
-    "d": "25/06/2026",
-    "type": "Added",
-    "en": "New get_intake_guide tool returns a step-by-step questionnaire and recommended build flow (create_site → products → build_page → global sections →…",
-    "vi": "Tool mới get_intake_guide trả về bảng câu hỏi từng bước và quy trình build được khuyến nghị (create_site → sản phẩm → build_page → global sections →…"
   }
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "MCP server for the WebCake/StoreCake storefront builder — page CRUD, page authoring, products, orders, and more",
   "mcpName": "io.github.vuluu2k/webcake-storefront-mcp",
   "license": "MIT",