sbuilder-mcp 0.42.0 → 0.43.0

package/CHANGELOG.md

@@ -6,6 +6,18 @@ 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.43.0] - 2026-09-14
+
+### Added
+- The catalog's legal-value vocabulary (sb_traits_for's config_values / specials_values, and sb_set's out-of-vocabulary warning) grows from 3 to 57 entries.
+- spline-scene and the shared background-scene config keys on flex-section, flex-block and dataset-block now carry a full vocabulary: source/effect/gallery/speed/intensity/effectColors, including the 3D shader ids and built-in scene names read out of the runtime island.
+- filter-checkbox, filter-radio, filter-color, filter-tag, select and filter-slider now carry a vocabulary for filterSource (13 values) plus the derived filterValueMode, filterMatch, filterArity and filterBehavior keys; filter-slider is correctly limited to price alone, since a range control cannot express a sort.
+- Codegen now reads a fifth source directory, runtime/src, so a 3D vocabulary that only exists in the browser island is no longer invisible to the catalog; the dirty-checkout and unpublished-commit checks now cover it too.
+
+### Fixed
+- backgroundSceneSource's vocabulary no longer omits its "model" and "spline" values; the previous release read a guard-shaped Go switch as a complete vocabulary and published only two of the key's five legal values, which would have told an agent that setting a spline scene was invalid.
+- Codegen now tells a normalizing switch (which enumerates every legal value) apart from a guard switch (which only tests a subset and falls through for everything else), so a filter-shaped switch can no longer be read as a complete vocabulary.
+
 ## [0.42.0] - 2026-09-14
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,18 @@ 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.43.0] - 2026-09-14
+
+### Added
+- Bảng giá trị hợp lệ của catalog (config_values / specials_values của sb_traits_for, và cảnh báo giá trị nằm ngoài bảng của sb_set) tăng từ 3 lên 57 mục.
+- spline-scene và các config key nền cảnh 3D dùng chung trên flex-section, flex-block và dataset-block giờ có đầy đủ bảng giá trị: source/effect/gallery/speed/intensity/effectColors, bao gồm cả các id shader 3D và tên cảnh dựng sẵn đọc ra từ runtime island.
+- filter-checkbox, filter-radio, filter-color, filter-tag, select và filter-slider giờ có bảng giá trị cho filterSource (13 giá trị) cùng các key dẫn xuất filterValueMode, filterMatch, filterArity và filterBehavior; filter-slider được giới hạn đúng còn mỗi price, vì một control dạng khoảng không thể diễn đạt một phép sắp xếp.
+- Codegen giờ đọc thêm thư mục nguồn thứ năm, runtime/src, nhờ đó một bảng giá trị 3D chỉ tồn tại trong browser island không còn vô hình với catalog; các kiểm tra checkout-bẩn và commit-chưa-publish giờ cũng bao phủ thư mục này.
+
+### Fixed
+- Bảng giá trị của backgroundSceneSource không còn thiếu hai giá trị "model" và "spline"; bản phát hành trước đã đọc một switch Go dạng guard như thể một bảng giá trị đầy đủ và chỉ công bố hai trong năm giá trị hợp lệ của key này, khiến một agent tưởng rằng đặt cảnh spline là không hợp lệ.
+- Codegen giờ phân biệt được một switch chuẩn hóa (liệt kê đầy đủ mọi giá trị hợp lệ) với một switch dạng guard (chỉ kiểm tra một tập con rồi rơi qua nhánh mặc định cho mọi trường hợp còn lại), nhờ đó một switch dạng lọc không còn bị đọc nhầm thành một bảng giá trị đầy đủ.
+
 ## [0.42.0] - 2026-09-14
 
 ### Added

package/dist/catalog/elements.generated.js

@@ -36876,19 +36876,6 @@ export const CONFIG_VALUES = {
  * the key.
  */
 export const ELEMENT_VALUES = {
-    "*": {
-        "backgroundSceneSource": {
-            "target": "config",
-            "writeKey": "backgroundSceneSource",
-            "values": [
-                "",
-                "effect",
-                "gallery"
-            ],
-            "fallback": "",
-            "readBy": "nodes/helpers.go:bgSceneColorRule"
-        }
-    },
     "media-dataset": {
         "mediaImageRatio": {
             "target": "config",
@@ -36981,6 +36968,426 @@ export const ELEMENT_VALUES = {
             "readBy": "nodes/tab/html.go:position"
         }
     },
+    "spline-scene": {
+        "source": {
+            "target": "specials",
+            "writeKey": "source",
+            "values": [
+                "effect",
+                "gallery",
+                "model",
+                "spline"
+            ],
+            "readBy": "SCENE_SOURCES (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "effect": {
+            "target": "config",
+            "writeKey": "effect",
+            "values": [
+                "aurora",
+                "gradient-mesh",
+                "particles",
+                "waves"
+            ],
+            "readBy": "EFFECT_IDS (runtime/src/services/effect-shaders.ts)"
+        },
+        "sceneGallery": {
+            "target": "specials",
+            "writeKey": "sceneGallery",
+            "values": [
+                "card",
+                "geometry",
+                "gift",
+                "podium",
+                "sphere",
+                "torus"
+            ],
+            "readBy": "GALLERY_CATALOGUE (runtime/src/services/gallery-scenes.ts)"
+        },
+        "speed": {
+            "target": "config",
+            "writeKey": "speed",
+            "values": [
+                "fast",
+                "normal",
+                "slow"
+            ],
+            "readBy": "SCENE_SPEEDS (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "intensity": {
+            "target": "config",
+            "writeKey": "intensity",
+            "values": [
+                "normal",
+                "soft",
+                "strong"
+            ],
+            "readBy": "SCENE_INTENSITIES (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "effectColors": {
+            "target": "config",
+            "writeKey": "effectColors",
+            "values": [
+                "custom",
+                "theme"
+            ],
+            "readBy": "COLOR_MODES (editor/src/components/inspector/ScenePaletteRows.vue)"
+        }
+    },
+    "*": {
+        "backgroundSceneSource": {
+            "target": "config",
+            "writeKey": "backgroundSceneSource",
+            "values": [
+                "",
+                "effect",
+                "gallery",
+                "model",
+                "spline"
+            ],
+            "readBy": "BACKGROUND_SCENE_SOURCES (schema/src/elements/backgroundScene.ts)"
+        },
+        "backgroundSceneEffect": {
+            "target": "config",
+            "writeKey": "backgroundSceneEffect",
+            "values": [
+                "aurora",
+                "gradient-mesh",
+                "particles",
+                "waves"
+            ],
+            "readBy": "EFFECT_IDS (runtime/src/services/effect-shaders.ts)"
+        },
+        "backgroundSceneGallery": {
+            "target": "config",
+            "writeKey": "backgroundSceneGallery",
+            "values": [
+                "card",
+                "geometry",
+                "gift",
+                "podium",
+                "sphere",
+                "torus"
+            ],
+            "readBy": "GALLERY_CATALOGUE (runtime/src/services/gallery-scenes.ts)"
+        },
+        "backgroundSceneSpeed": {
+            "target": "config",
+            "writeKey": "backgroundSceneSpeed",
+            "values": [
+                "fast",
+                "normal",
+                "slow"
+            ],
+            "readBy": "SCENE_SPEEDS (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "backgroundSceneIntensity": {
+            "target": "config",
+            "writeKey": "backgroundSceneIntensity",
+            "values": [
+                "normal",
+                "soft",
+                "strong"
+            ],
+            "readBy": "SCENE_INTENSITIES (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "backgroundSceneColors": {
+            "target": "config",
+            "writeKey": "backgroundSceneColors",
+            "values": [
+                "custom",
+                "theme"
+            ],
+            "readBy": "COLOR_MODES (editor/src/components/inspector/ScenePaletteRows.vue)"
+        }
+    },
+    "filter-checkbox": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "filter-radio": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "filter-color": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "filter-tag": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "select": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        },
+        "dropdown_align": {
+            "target": "config",
+            "writeKey": "panelAlign",
+            "values": [
+                "left",
+                "center",
+                "right"
+            ],
+            "readBy": "dropdown_align (editor picker)"
+        }
+    },
+    "filter-slider": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "price"
+            ],
+            "readBy": "FILTER_SOURCES valueMode:\"range\" (schema/src/filters/sources.ts)"
+        }
+    },
     "cart-total": {
         "cart_total_part": {
             "target": "specials",
@@ -37125,18 +37532,6 @@ export const ELEMENT_VALUES = {
             "readBy": "anchored_placement (editor picker)"
         }
     },
-    "select": {
-        "dropdown_align": {
-            "target": "config",
-            "writeKey": "panelAlign",
-            "values": [
-                "left",
-                "center",
-                "right"
-            ],
-            "readBy": "dropdown_align (editor picker)"
-        }
-    },
     "search-keywords": {
         "keyword_action": {
             "target": "specials",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",