sbuilder-mcp 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -6,6 +6,35 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] - 2026-09-07
+
+### Fixed
+- sb_live_join now accepts an API key (SB_TOKEN) to join the live-edit room, instead of refusing it and requiring a session; the platform now gates the socket on the key's delegated member permission and its own site, so a key-only install can join like every other tool.
+- sb_media_upload now accepts an API key, instead of refusing it and requiring a session; the platform's upload endpoint moved behind the same gate as sb_sites, and a 401 with a key present now reports that the key lacks the media permission or belongs to another site, rather than telling the caller to switch credentials.
+
+## [0.2.1] - 2026-09-07
+
+### Added
+- sb_add and sb_move now seed the same content the editor gives an element at drop time: satellite nodes such as an accordion's item skin or a tab's shared button, and seeded subtrees for a list's empty state and for dropdown, select and popover, which render as an empty box without them.
+- sb_page_open reports compose_warnings from the platform, including globalMissing, which means the server could not find a shared section's master and deleted the reference node from the document it handed back — saving from there makes the loss permanent.
+- sb_page_create reports slug_renamed when the requested slug was already taken; the platform silently stores a suffixed slug and answers success, so every link authored to the requested slug would otherwise be dead.
+- sb_publish reports not_published when a page has no saved draft, since the platform skips it and still answers success with whatever else did publish.
+- sb_review reports unlinked_form when a form element names no form, since it composes nothing and publishes as an empty box with no warning from the platform.
+- sb_review reports dead_menu_link when a menu has no entries or an entry has no href, since the renderer reads specials.menuItems and never menuId.
+- sb_review reports extra_repeater_child when a repeater element (such as list-dataset) carries more than one child, since only the first is ever rendered per record.
+
+### Changed
+- sb_add and sb_move now refuse adding or moving a second child into a repeater element, since only the first child renders; a reorder within the same parent is still allowed.
+- sb_duplicate now refuses duplicating into a repeater element for the same reason, and deep-copies satellite nodes (such as an accordion's skin) with the owner's pointer rewritten instead of aiming the copy at the original's satellite.
+- sb_duplicate strips the composition stamps (globalId, globalRef, globalKind, globalRev) from a duplicated node instead of copying them, since two nodes sharing one stamp is refused by the platform on the next save.
+- sb_publish now returns only the fields a caller acts on (pageId, slug, isHomepage) for each published page instead of the platform's full rendered document, html and css for every page the cascade touched.
+- sb_page_create's dry_run preview and live response now redact settings the same way sb_api_call does, since it is a free-form object a caller can pass a credential inside.
+- The internal tree walk used by sb_remove, sb_duplicate and save validation now follows satellite nodes (attached through config, not the child list) in addition to the child list, so removing or duplicating a node also handles its satellites correctly.
+- Save validation now refuses a document where a composition stamp (globalId, overlayId) sits on a node that is not a direct child of ROOT, or is duplicated across two nodes, since the platform refuses both later and reports it as an opaque error.
+
+### Fixed
+- Reordering a node within the same repeater parent no longer trips the new second-child guard.
+
 ## [0.2.0] - 2026-09-07
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,35 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] - 2026-09-07
+
+### Fixed
+- sb_live_join giờ chấp nhận API key (SB_TOKEN) để vào phòng live-edit, thay vì từ chối và bắt buộc dùng session; nền tảng giờ kiểm soát socket dựa trên quyền member được ủy quyền qua key và site của chính key đó, nên một cài đặt chỉ dùng key có thể tham gia như mọi tool khác.
+- sb_media_upload giờ chấp nhận API key, thay vì từ chối và bắt buộc dùng session; endpoint upload của nền tảng giờ nằm sau cùng một cổng chặn với sb_sites, và lỗi 401 khi có key giờ báo rằng key thiếu quyền media hoặc thuộc site khác, thay vì bảo caller đổi sang loại credential khác.
+
+## [0.2.1] - 2026-09-07
+
+### Added
+- sb_add và sb_move giờ seed đúng nội dung mà editor gán cho một element lúc kéo-thả: các node vệ tinh như skin của từng mục accordion hay nút dùng chung của tab, và các subtree được seed sẵn cho trạng thái rỗng của list cũng như cho dropdown, select và popover — vốn render thành hộp trống nếu thiếu chúng.
+- sb_page_open giờ báo cáo compose_warnings từ nền tảng, bao gồm globalMissing — nghĩa là server không tìm thấy bản gốc của một shared section và đã xóa node tham chiếu khỏi document trả về; lưu từ đây sẽ khiến việc mất đó thành vĩnh viễn.
+- sb_page_create giờ báo cáo slug_renamed khi slug yêu cầu đã bị chiếm; nền tảng âm thầm lưu một slug có hậu tố khác và trả về thành công, nên mọi link được gán theo slug yêu cầu ban đầu sẽ chết nếu không có cảnh báo này.
+- sb_publish giờ báo cáo not_published khi một trang chưa có draft đã lưu, vì nền tảng bỏ qua trang đó và vẫn trả về thành công kèm những trang khác đã publish được.
+- sb_review giờ báo cáo unlinked_form khi một form element không trỏ tới form nào, vì nó không compose được gì và publish thành một hộp trống mà nền tảng không hề cảnh báo.
+- sb_review giờ báo cáo dead_menu_link khi một menu không có entry nào hoặc một entry không có href, vì renderer chỉ đọc specials.menuItems chứ không đọc menuId.
+- sb_review giờ báo cáo extra_repeater_child khi một repeater element (như list-dataset) có nhiều hơn một child, vì chỉ child đầu tiên được render cho mỗi record.
+
+### Changed
+- sb_add và sb_move giờ từ chối thêm hoặc di chuyển child thứ hai vào một repeater element, vì chỉ child đầu tiên được render; việc sắp xếp lại thứ tự trong cùng một parent vẫn được cho phép.
+- sb_duplicate giờ cũng từ chối nhân bản vào một repeater element vì lý do tương tự, và deep-copy các node vệ tinh (như skin của accordion) kèm việc ghi lại con trỏ về đúng owner mới, thay vì để bản sao trỏ vào vệ tinh của bản gốc.
+- sb_duplicate giờ loại bỏ các stamp composition (globalId, globalRef, globalKind, globalRev) khỏi node được nhân bản thay vì sao chép nguyên trạng, vì hai node dùng chung một stamp sẽ bị nền tảng từ chối ở lần lưu kế tiếp.
+- sb_publish giờ chỉ trả về các trường mà caller thực sự dùng đến (pageId, slug, isHomepage) cho mỗi trang đã publish, thay vì toàn bộ document, html và css đã render của mọi trang mà cascade chạm tới.
+- Bản xem trước dry_run và phản hồi thật của sb_page_create giờ redact settings giống cách sb_api_call làm, vì đây là một object tự do mà caller có thể lỡ truyền credential vào.
+- Lượt duyệt cây nội bộ dùng bởi sb_remove, sb_duplicate và kiểm tra khi lưu giờ đi theo cả các node vệ tinh (gắn qua config, không qua child list) bên cạnh child list, nên việc xóa hoặc nhân bản một node giờ xử lý đúng cả các vệ tinh của nó.
+- Kiểm tra khi lưu giờ từ chối một document có stamp composition (globalId, overlayId) nằm trên node không phải con trực tiếp của ROOT, hoặc bị lặp trên hai node, vì nền tảng cũng từ chối cả hai trường hợp này nhưng báo lỗi mơ hồ ở bước sau.
+
+### Fixed
+- Sắp xếp lại một node trong cùng parent của repeater không còn bị chặn nhầm bởi guard child thứ hai mới thêm.
+
 ## [0.2.0] - 2026-09-07
 
 ### Added

package/dist/catalog/elements.generated.js

@@ -32969,3 +32969,572 @@ export const TRAIT_WRITES = {
         ]
     }
 };
+export const SATELLITE_RULES = {
+    "tab": [
+        {
+            "type": "tab-item",
+            "configKey": "tabItemId"
+        }
+    ],
+    "accordion": [
+        {
+            "type": "accordion-item",
+            "configKey": "accordionItemId"
+        }
+    ],
+    "menu": [
+        {
+            "type": "menu-item",
+            "configKey": "menuItemId"
+        },
+        {
+            "type": "menu-dropdown",
+            "configKey": "menuDropdownId"
+        }
+    ],
+    "cart-order": [
+        {
+            "type": "list-empty",
+            "configKey": "emptyStateId",
+            "seed": {
+                "type": "list-empty",
+                "children": [
+                    {
+                        "type": "icon",
+                        "style": {
+                            "color": "#d4d4d4"
+                        },
+                        "config": {
+                            "iconSize": 32
+                        },
+                        "specials": {
+                            "name": "ShoppingCartLine"
+                        }
+                    },
+                    {
+                        "type": "heading",
+                        "style": {
+                            "width": "auto",
+                            "fontSize": "20px",
+                            "fontWeight": "600",
+                            "color": "#171717",
+                            "textAlign": "center"
+                        },
+                        "specials": {
+                            "htmlTag": "h3",
+                            "text": "Your cart is empty"
+                        }
+                    },
+                    {
+                        "type": "text",
+                        "style": {
+                            "width": "auto",
+                            "fontSize": "14px",
+                            "color": "#737373",
+                            "textAlign": "center"
+                        },
+                        "specials": {
+                            "text": "Add something you like and it will show up here."
+                        }
+                    }
+                ]
+            }
+        }
+    ],
+    "quantity-dataset": [
+        {
+            "type": "quantity-button",
+            "configKey": "quantityButtonId"
+        },
+        {
+            "type": "quantity-input",
+            "configKey": "quantityInputId"
+        }
+    ],
+    "product-variants": [
+        {
+            "type": "product-variant-label",
+            "configKey": "variantLabelId"
+        },
+        {
+            "type": "product-variant-option",
+            "configKey": "variantOptionId"
+        }
+    ],
+    "dataset-block": [
+        {
+            "type": "list-empty",
+            "configKey": "emptyStateId",
+            "seed": {
+                "type": "list-empty",
+                "children": [
+                    {
+                        "type": "icon",
+                        "style": {
+                            "color": "#d4d4d4"
+                        },
+                        "config": {
+                            "iconSize": 32
+                        },
+                        "specials": {
+                            "name": "ShoppingBag3Line"
+                        }
+                    },
+                    {
+                        "type": "heading",
+                        "style": {
+                            "width": "auto",
+                            "fontSize": "20px",
+                            "fontWeight": "600",
+                            "color": "#171717",
+                            "textAlign": "center"
+                        },
+                        "specials": {
+                            "htmlTag": "h3",
+                            "text": "This item is unavailable"
+                        }
+                    },
+                    {
+                        "type": "text",
+                        "style": {
+                            "width": "auto",
+                            "fontSize": "14px",
+                            "color": "#737373",
+                            "textAlign": "center"
+                        },
+                        "specials": {
+                            "text": "It may have been removed. Have a look at the rest of the shop."
+                        }
+                    }
+                ]
+            }
+        }
+    ],
+    "list-dataset": [
+        {
+            "type": "list-empty",
+            "configKey": "emptyStateId",
+            "seedBySource": {
+                "product": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "ShoppingBag3Line"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "No products yet"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "New arrivals will show up here. Check back soon."
+                            }
+                        }
+                    ]
+                },
+                "category": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "ArchiveLine"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "No collections yet"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "Collections you create will show up here."
+                            }
+                        }
+                    ]
+                },
+                "article": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "FileListLine"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "No posts yet"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "New stories will show up here. Check back soon."
+                            }
+                        }
+                    ]
+                },
+                "blogCategory": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "InboxLine"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "No topics yet"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "Topics you create will show up here."
+                            }
+                        }
+                    ]
+                },
+                "course": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "GraduationCapLine"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "No courses yet"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "Courses you publish will show up here."
+                            }
+                        }
+                    ]
+                },
+                "cart": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "ShoppingCartLine"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "Your cart is empty"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "Add something you like and it will show up here."
+                            }
+                        }
+                    ]
+                },
+                "item": {
+                    "type": "list-empty",
+                    "children": [
+                        {
+                            "type": "icon",
+                            "style": {
+                                "color": "#d4d4d4"
+                            },
+                            "config": {
+                                "iconSize": 32
+                            },
+                            "specials": {
+                                "name": "ShoppingBag3Line"
+                            }
+                        },
+                        {
+                            "type": "heading",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "20px",
+                                "fontWeight": "600",
+                                "color": "#171717",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "htmlTag": "h3",
+                                "text": "This item is unavailable"
+                            }
+                        },
+                        {
+                            "type": "text",
+                            "style": {
+                                "width": "auto",
+                                "fontSize": "14px",
+                                "color": "#737373",
+                                "textAlign": "center"
+                            },
+                            "specials": {
+                                "text": "It may have been removed. Have a look at the rest of the shop."
+                            }
+                        }
+                    ]
+                }
+            }
+        },
+        {
+            "type": "list-loading",
+            "configKey": "loadingStateId",
+            "optional": true
+        }
+    ]
+};
+export const ELEMENT_SEEDS = {
+    "dropdown": [
+        {
+            "type": "dropdown-trigger",
+            "children": [
+                {
+                    "type": "text",
+                    "style": {
+                        "width": "fit-content"
+                    },
+                    "specials": {
+                        "text": "Dropdown"
+                    }
+                },
+                {
+                    "type": "icon",
+                    "config": {
+                        "iconSize": 16
+                    },
+                    "specials": {
+                        "name": "ArrowDownSLine"
+                    }
+                }
+            ]
+        },
+        {
+            "type": "dropdown-panel",
+            "children": [
+                {
+                    "type": "text",
+                    "style": {
+                        "padding": "6px 8px"
+                    },
+                    "specials": {
+                        "text": "Option 1"
+                    }
+                },
+                {
+                    "type": "text",
+                    "style": {
+                        "padding": "6px 8px"
+                    },
+                    "specials": {
+                        "text": "Option 2"
+                    }
+                },
+                {
+                    "type": "text",
+                    "style": {
+                        "padding": "6px 8px"
+                    },
+                    "specials": {
+                        "text": "Option 3"
+                    }
+                }
+            ]
+        }
+    ],
+    "select": [
+        {
+            "type": "dropdown-trigger"
+        },
+        {
+            "type": "dropdown-panel"
+        }
+    ],
+    "popover": [
+        {
+            "type": "dropdown-trigger",
+            "children": [
+                {
+                    "type": "text",
+                    "style": {
+                        "width": "fit-content"
+                    },
+                    "specials": {
+                        "text": "Popover"
+                    }
+                }
+            ]
+        },
+        {
+            "type": "dropdown-panel",
+            "style": {
+                "padding": "12px 16px",
+                "gap": "6px",
+                "minWidth": "240px",
+                "maxWidth": "320px"
+            },
+            "children": [
+                {
+                    "type": "heading",
+                    "style": {
+                        "fontSize": "15px"
+                    },
+                    "specials": {
+                        "htmlTag": "h4",
+                        "text": "Tiêu đề"
+                    }
+                },
+                {
+                    "type": "text",
+                    "specials": {
+                        "text": "Một câu giải thích ngắn về thứ khách vừa bấm vào."
+                    }
+                }
+            ]
+        }
+    ]
+};
+export const FIRST_CHILD_ONLY = [
+    "list-dataset"
+];