sbuilder-mcp 0.14.1 → 0.15.0

package/CHANGELOG.md

@@ -6,6 +6,24 @@ 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.15.0] - 2026-09-10
+
+### Added
+- sb_set now writes a config key that a page's `html.go` renderer reads only at base (13 keys, including the repeater data axis `datasetSource`, `kind`, `collectionId`, `collectionType`) to base instead of the current breakpoint, and reports the move as `base_only`, since a per-breakpoint write to one of these keys updated the editor canvas and silently vanished on publish.
+- sb_traits_for now returns `config_values` for the config keys whose platform renderer treats an unrecognized value as a silent alias rather than an error, listing the accepted values and aliases (`category` as a working spelling of `collection`, among them), since a repeater set to a plausible-sounding word like "bestseller" previously published and rendered the whole catalogue under the wrong heading with no error anywhere.
+- sb_set now warns once per config key/value pair when a write sets one of these config values to something the renderer does not recognize.
+- sb_node_read now returns a `preset` block naming the theme preset a node paints through, its resolved colors and other values with every var() chain flattened, and which keys the node has already overridden, closing nine element types (including icon, button, heading, text, image) whose default look now lives in a site theme preset rather than the node's own style, and which previously read back as no color at all on a page visibly painting one.
+- sb_set now warns once per theme preset when a plain style write is about to permanently detach a node from that preset, since the node's own value then outranks the preset on every future palette change.
+- sb_add now returns an `inert` note when a subtree includes a locale-switcher (which paints a fabricated locale chip and switches nothing below two configured site locales) or a breadcrumb (whose root "Home" label is authorable and defaults to English), since both elements render convincingly while wired to nothing, in a way neither sb_review nor sb_look can detect after the fact.
+- sb_page_create now seeds a store page type (product, category, search, blog, post, complete) with the same document the platform's editor gives a merchant — a product page arrives with its whole buy box, including the `add_to_cart` binding — instead of an empty page; pass `seed:false` for a blank page, and `locale`/`headline` to pick the completion page's thank-you line.
+- npm run codegen and npm run codegen:check now warn (without failing) when a route is annotated in the platform's server code but absent from swagger.json, naming the missing routes, since this gap does not get fixed by regenerating anything in this repo.
+
+### Fixed
+- The element and operation catalog is refreshed to the platform's `8e40bbab`: five relation-slot operations (curated-shelf create/update/delete and both picks endpoints) that were reachable but shared one annotation with the list endpoint are now separately documented, and the AI chat assistant's whole configuration surface (`GET /api/chat-providers`, `GET/PUT/DELETE /api/sites/{siteId}/chat-settings`) is documented for the first time; the catalog now covers 495 operations, 166 of 216 write operations with a request body shape.
+
+### Internal
+- The generated catalog gained a store-page-seed table (`storepages.generated.ts`) and a theme-preset table (`theme.generated.ts`), both produced by calling the platform's own seed and theme-preset builders rather than by copying their output, so the next platform change to either reaches this server's next codegen run automatically.
+
 ## [0.14.1] - 2026-09-09
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,24 @@ 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.15.0] - 2026-09-10
+
+### Added
+- sb_set giờ ghi một config key mà renderer `html.go` của trang chỉ đọc ở base (13 key, gồm cả trục dữ liệu của repeater `datasetSource`, `kind`, `collectionId`, `collectionType`) xuống base thay vì breakpoint hiện tại, và báo cáo việc chuyển này là `base_only`, vì trước đây ghi theo breakpoint lên một trong các key này chỉ cập nhật canvas của editor rồi âm thầm biến mất khi publish.
+- sb_traits_for giờ trả về `config_values` cho các config key mà renderer của nền tảng coi một giá trị không nhận diện được là một cách viết khác (alias) thay vì báo lỗi, liệt kê các giá trị hợp lệ và alias của chúng (`category` là một cách viết khác của `collection`, chẳng hạn), vì trước đây một repeater đặt giá trị nghe hợp lý như "bestseller" sẽ publish và render toàn bộ catalogue dưới một tiêu đề sai mà không báo lỗi ở đâu cả.
+- sb_set giờ cảnh báo một lần cho mỗi cặp config key/giá trị khi một lần ghi đặt một trong các giá trị config này thành thứ mà renderer không nhận diện được.
+- sb_node_read giờ trả về một khối `preset` nêu tên theme preset mà một node dùng để vẽ, các giá trị màu và thuộc tính khác của nó với mọi chuỗi var() đã được làm phẳng, cùng những key mà node đã override, khép lại khoảng trống ở chín loại element (gồm icon, button, heading, text, image) mà giao diện mặc định của chúng giờ nằm trong một theme preset của site chứ không phải trong style riêng của node, và trước đây đọc lại không thấy màu nào trên một trang rõ ràng đang tô màu đó.
+- sb_set giờ cảnh báo một lần cho mỗi theme preset khi một lần ghi style thuần sắp làm một node tách khỏi preset đó vĩnh viễn, vì giá trị riêng của node từ đó sẽ luôn thắng preset ở mọi lần đổi bảng màu sau này.
+- sb_add giờ trả về một ghi chú `inert` khi một subtree chứa locale-switcher (vẽ ra một chip ngôn ngữ giả và không chuyển đổi gì cả khi site có dưới hai locale được cấu hình) hoặc breadcrumb (nhãn "Home" ở gốc có thể chỉnh sửa và mặc định là tiếng Anh), vì cả hai element đều hiển thị thuyết phục trong khi không được nối với gì cả, theo cách mà cả sb_review lẫn sb_look đều không thể phát hiện sau khi đã thêm.
+- sb_page_create giờ gieo sẵn nội dung cho một loại trang store (product, category, search, blog, post, complete) bằng đúng document mà editor của nền tảng đưa cho merchant — một trang product sẽ có sẵn cả buy box, bao gồm cả binding `add_to_cart` — thay vì một trang trống; truyền `seed:false` để có trang trống, và `locale`/`headline` để chọn câu cảm ơn của trang hoàn tất đơn hàng.
+- npm run codegen và npm run codegen:check giờ cảnh báo (không làm fail) khi một route được annotate trong code server của nền tảng nhưng lại vắng mặt trong swagger.json, nêu tên các route còn thiếu, vì khoảng trống này không thể khắc phục bằng cách regenerate bất cứ thứ gì trong repo này.
+
+### Fixed
+- Catalog element và operation được làm mới theo đúng bản `8e40bbab` của nền tảng: năm relation-slot operation (tạo/sửa/xoá kệ hàng tuyển chọn và cả hai endpoint picks) trước đây có thể gọi được nhưng dùng chung một annotation với endpoint danh sách, giờ được ghi tài liệu riêng; và toàn bộ bề mặt cấu hình của trợ lý chat AI (`GET /api/chat-providers`, `GET/PUT/DELETE /api/sites/{siteId}/chat-settings`) lần đầu tiên được ghi tài liệu; catalog giờ bao phủ 495 operation, 166 trong số 216 write operation có shape body request.
+
+### Internal
+- Catalog được sinh ra giờ có thêm bảng seed trang store (`storepages.generated.ts`) và bảng theme preset (`theme.generated.ts`), cả hai được tạo ra bằng cách gọi trực tiếp các hàm dựng seed và theme preset của chính nền tảng thay vì sao chép kết quả của chúng, để lần platform thay đổi tiếp theo ở một trong hai chỗ đó tự động được phản ánh vào lần codegen kế tiếp của server này.
+
 ## [0.14.1] - 2026-09-09
 
 ### Added

package/README.md

@@ -89,7 +89,7 @@ make, because those mean "this person's account".
 | `sb_templates` | The store's saved section templates — designed sections to start from |
 | `sb_template_use` | Instantiate a template into a page |
 | `sb_page_list` | Every page on the site |
-| `sb_page_create` | Create a page; `type` is the route for checkout, product, category, post, course |
+| `sb_page_create` | Create a page — a store type arrives with the editor's own starting document; `type` is the route for checkout, product, category, post, course |
 | `sb_publish` | Compile the draft into the live page (cascades to shared globals) |
 | `sb_review` | Every defect a visitor would see, each with its fix, plus the five gaps between this store and a paid order |
 | `sb_media_list` | The site's media library |
@@ -102,8 +102,8 @@ make, because those mean "this person's account".
 | `sb_store` | Run a store flow that must happen in a fixed order — the four writes that make a working checkout, or any of the platform's 17 form templates (login, register, forgot, contact, subscribe …) with its own field document |
 | `sb_undo` | Put back what a PUT replaced — the platform has no page history or restore, so this is the only way back |
 
-Twenty-eight tools, **484 API operations** (158 of the 212 writes carrying a body shape read
-off the handler), 107 elements, 77 binding sources. `sb_api_find`
+Twenty-eight tools, **495 API operations** (166 of the 216 writes carrying a body shape read
+off the handler), 111 elements, 78 binding sources. `sb_api_find`
 is an index rather than a tool per endpoint, so the tool list stays short while everything
 the platform can do stays reachable — and operations added to the platform arrive with the
 next `npm run codegen`.

package/README.vi.md

@@ -86,7 +86,7 @@ là "tài khoản của người này".
 | `sb_templates` | Section template đã lưu của cửa hàng — section thiết kế sẵn để bắt đầu |
 | `sb_template_use` | Thả một template vào trang |
 | `sb_page_list` | Mọi trang của site |
-| `sb_page_create` | Tạo một trang; `type` là đường đi cho checkout, product, category, post, course |
+| `sb_page_create` | Tạo một trang — trang cửa hàng sinh ra đã có sẵn tài liệu như trong editor; `type` là đường đi cho checkout, product, category, post, course |
 | `sb_publish` | Biên dịch bản nháp thành trang live (lan sang global dùng chung) |
 | `sb_review` | Mọi khiếm khuyết người xem sẽ thấy, kèm lệnh sửa từng cái, và năm khoảng trống chắn giữa cửa hàng với một đơn đã thanh toán |
 | `sb_media_list` | Thư viện ảnh của site |
@@ -99,8 +99,8 @@ là "tài khoản của người này".
 | `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — bốn lệnh ghi tạo nên trang thanh toán, hoặc gieo bất kỳ template nào trong 17 form của nền tảng (login, register, forgot, contact, subscribe …) kèm field document của nó |
 | `sb_undo` | Trả lại thứ mà một lệnh PUT đã ghi đè — nền tảng không có lịch sử trang hay restore, nên đây là đường về duy nhất |
 
-Hai mươi tám tool, **484 operation API** (158 trong 212 lệnh ghi có hình dạng body đọc thẳng
-từ handler), 107 element, 77 nguồn binding. `sb_api_find` là
+Hai mươi tám tool, **495 operation API** (166 trong 216 lệnh ghi có hình dạng body đọc thẳng
+từ handler), 111 element, 78 nguồn binding. `sb_api_find` là
 một chỉ mục chứ không phải mỗi endpoint một tool, nên danh sách tool vẫn ngắn trong khi mọi
 thứ nền tảng làm được vẫn với tới — và operation mới thêm bên nền tảng sẽ tự có sau lần
 `npm run codegen` kế tiếp.

package/dist/catalog/api.generated.js

@@ -1,7 +1,7 @@
 export const SWAGGER_SOURCE = {
-    "operations": 486,
-    "definitions": 102,
-    "bodyCarrying": 172,
+    "operations": 495,
+    "definitions": 104,
+    "bodyCarrying": 177,
     "bodyUndescribed": 63,
     "generatedFrom": "server/docs/swagger.json"
 };
@@ -1513,6 +1513,19 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "none"
     },
+    {
+        "id": "get:/api/chat-providers",
+        "method": "GET",
+        "path": "/api/chat-providers",
+        "tags": [
+            "chatbot"
+        ],
+        "summary": "List the AI providers this server can talk to",
+        "params": [],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "post:/api/course-uploads/{siteId}",
         "method": "POST",
@@ -3939,6 +3952,69 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/chat-settings",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/chat-settings",
+        "tags": [
+            "chatbot"
+        ],
+        "summary": "Get, save or clear a site's AI chat configuration",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}/chat-settings",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/chat-settings",
+        "tags": [
+            "chatbot"
+        ],
+        "summary": "Get, save or clear a site's AI chat configuration",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "delete:/api/sites/{siteId}/chat-settings",
+        "method": "DELETE",
+        "path": "/api/sites/{siteId}/chat-settings",
+        "tags": [
+            "chatbot"
+        ],
+        "summary": "Get, save or clear a site's AI chat configuration",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "post:/api/sites/{siteId}/clipboard/reconcile",
         "method": "POST",
@@ -10705,6 +10781,34 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "post:/api/sites/{siteId}/relation-slots",
+        "method": "POST",
+        "path": "/api/sites/{siteId}/relation-slots",
+        "tags": [
+            "relations"
+        ],
+        "summary": "Create a curated relation slot",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "slot",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "Slot"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_relations_rest.slotBody",
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/relation-slots/usage",
         "method": "GET",
@@ -10733,6 +10837,160 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "put:/api/sites/{siteId}/relation-slots/{id}",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/relation-slots/{id}",
+        "tags": [
+            "relations"
+        ],
+        "summary": "Update or delete one curated relation slot",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Slot ID"
+            },
+            {
+                "name": "slot",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "Slot"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_relations_rest.slotBody",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "delete:/api/sites/{siteId}/relation-slots/{id}",
+        "method": "DELETE",
+        "path": "/api/sites/{siteId}/relation-slots/{id}",
+        "tags": [
+            "relations"
+        ],
+        "summary": "Update or delete one curated relation slot",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Slot ID"
+            },
+            {
+                "name": "slot",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "Slot"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_relations_rest.slotBody",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "get:/api/sites/{siteId}/relation-slots/{id}/picks",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/relation-slots/{id}/picks",
+        "tags": [
+            "relations"
+        ],
+        "summary": "Read or replace one owner's picks in a curated slot",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Slot ID"
+            },
+            {
+                "name": "ownerId",
+                "in": "query",
+                "required": true,
+                "type": "string",
+                "description": "Product or article id whose picks these are"
+            },
+            {
+                "name": "picks",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "The WHOLE list, every time"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_relations_rest.picksBody",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}/relation-slots/{id}/picks",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/relation-slots/{id}/picks",
+        "tags": [
+            "relations"
+        ],
+        "summary": "Read or replace one owner's picks in a curated slot",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Slot ID"
+            },
+            {
+                "name": "ownerId",
+                "in": "query",
+                "required": true,
+                "type": "string",
+                "description": "Product or article id whose picks these are"
+            },
+            {
+                "name": "picks",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "The WHOLE list, every time"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_relations_rest.picksBody",
+        "credential": "siteScoped"
+    },
     {
         "id": "post:/api/sites/{siteId}/restore",
         "method": "POST",
@@ -17483,5 +17741,36 @@ export const API_DEFINITIONS = {
                 "$ref": "#/definitions/internal_publicapi.Webhook"
             }
         }
+    },
+    "internal_relations_rest.picksBody": {
+        "type": "object",
+        "properties": {
+            "itemIds": {
+                "type": "array",
+                "items": {
+                    "type": "string"
+                }
+            }
+        }
+    },
+    "internal_relations_rest.slotBody": {
+        "type": "object",
+        "properties": {
+            "itemType": {
+                "type": "string"
+            },
+            "key": {
+                "type": "string"
+            },
+            "name": {
+                "type": "string"
+            },
+            "ownerType": {
+                "type": "string"
+            },
+            "position": {
+                "type": "integer"
+            }
+        }
     }
 };

package/dist/catalog/element-search.js

@@ -1,4 +1,5 @@
 import { ELEMENTS, TRAIT_WRITES } from './elements.generated.js';
+import { vocabulariesForWrites } from '../domains/site/vocabulary.js';
 /** Eight to choose from; the hints for the chosen one come with sb_traits_for. */
 export const DEFAULT_CATALOG_LIMIT = 8;
 /**
@@ -94,6 +95,17 @@ export function traitsFor(type, control) {
         // which, unlike `style`, are NOT open — this is the machine-readable
         // answer to "what does this element store", and often the only one.
         defaults: el.defaults,
+        // WHAT THOSE KEYS ARE ALLOWED TO HOLD, for the few where guessing wrong is
+        // silent. Attached to the ELEMENT rather than to a control, because the keys
+        // that most need it are exactly the UNDECLARED ones: `collectionType` is in
+        // this element's defaults and in its control list, and no TRAIT_WRITES entry
+        // names it — so a per-control attachment reaches none of them, which is how
+        // the first version of this was wrong.
+        ...(() => {
+            const keys = new Set([...Object.keys(el.defaults?.config ?? {}), ...el.controls]);
+            const vocab = vocabulariesForWrites([...keys]);
+            return Object.keys(vocab).length ? { config_values: vocab } : {};
+        })(),
         isContainer: el.isContainer,
         isRootOnly: el.isRootOnly,
         childAllows: el.childAllows,

package/dist/catalog/elements.generated.js

@@ -12424,7 +12424,22 @@ export const ELEMENTS = {
             },
             "specials": {
                 "htmlTag": "p",
-                "icon": "ArrowRightSFill"
+                "icon": "ArrowRightSFill",
+                "source": "auto",
+                "showCurrent": true,
+                "homeLabel": "Home",
+                "crumbs": [
+                    {
+                        "id": "bc_home",
+                        "label": "Home",
+                        "href": "/"
+                    },
+                    {
+                        "id": "bc_current",
+                        "label": "Product detail",
+                        "href": ""
+                    }
+                ]
             },
             "style": {
                 "display": "inline-flex",
@@ -12449,6 +12464,18 @@ export const ELEMENTS = {
             {
                 "tab": "general",
                 "groups": [
+                    {
+                        "key": "breadcrumb",
+                        "label": "Breadcrumb",
+                        "controls": [
+                            "breadcrumb_source",
+                            "breadcrumb_items",
+                            "breadcrumb_home_label",
+                            "breadcrumb_show_current",
+                            "breadcrumb_max_items",
+                            "breadcrumb_current_color"
+                        ]
+                    },
                     {
                         "key": "size",
                         "label": "Size",
@@ -12541,6 +12568,12 @@ export const ELEMENTS = {
             }
         ],
         "controls": [
+            "breadcrumb_source",
+            "breadcrumb_items",
+            "breadcrumb_home_label",
+            "breadcrumb_show_current",
+            "breadcrumb_max_items",
+            "breadcrumb_current_color",
             "width_select",
             "size_bounds",
             "breadcrumb_icon",
@@ -35439,6 +35472,39 @@ export const TRAIT_WRITES = {
                 "type": "string"
             }
         ]
+    },
+    "breadcrumb_source": {
+        "key": "breadcrumb_source",
+        "label": "Trail",
+        "writes": [
+            {
+                "target": "specials",
+                "writeKey": "source",
+                "type": "string"
+            }
+        ]
+    },
+    "breadcrumb_home_label": {
+        "key": "breadcrumb_home_label",
+        "label": "Home label",
+        "writes": [
+            {
+                "target": "specials",
+                "writeKey": "homeLabel",
+                "type": "string"
+            }
+        ]
+    },
+    "breadcrumb_show_current": {
+        "key": "breadcrumb_show_current",
+        "label": "Last step",
+        "writes": [
+            {
+                "target": "specials",
+                "writeKey": "showCurrent",
+                "type": "boolean"
+            }
+        ]
     }
 };
 export const SATELLITE_RULES = {
@@ -36055,3 +36121,83 @@ export const HOVER_HOMES = {
         "home": "state"
     }
 };
+/**
+ * What a config key is ALLOWED to hold, and what an unrecognised value becomes.
+ *
+ * Every trait in the platform's registry declares schema type "string", so the
+ * vocabulary lives in the Vue picker — a place no agent can read. The guess
+ * fails SILENTLY: the platform's own test pins
+ * EffectiveCollectionType("bestseller") == "all_products", so a repeater set to
+ * a plausible word renders the whole catalogue under whatever heading is above
+ * it.
+ *
+ * Read from the GO normalizers, because those are what render. "aliases" are
+ * spellings that work but are not what the picker writes.
+ */
+export const CONFIG_VALUES = {
+    "collectionType": {
+        "values": [
+            "all_products",
+            "collection",
+            "featured",
+            "related",
+            "slot"
+        ],
+        "fallback": "all_products",
+        "aliases": {
+            "category": "collection"
+        },
+        "readBy": "EffectiveCollectionType"
+    },
+    "articleSourceType": {
+        "values": [
+            "category",
+            "slot"
+        ],
+        "fallback": "category",
+        "aliases": {},
+        "readBy": "EffectiveArticleSourceType"
+    },
+    "collectionListType": {
+        "values": [
+            "all_collections",
+            "custom_collections"
+        ],
+        "fallback": "all_collections",
+        "aliases": {},
+        "readBy": "EffectiveCollectionListType"
+    }
+};
+/**
+ * Config keys the PUBLISH path reads from base only — html.go indexes
+ * node.Config[key] with no responsive merge, and one HTML document serves all
+ * three widths. Written per breakpoint they update the editor canvas and vanish
+ * on publish, with no error anywhere.
+ *
+ * The platform's own migration ledger (schema/test/responsive-defaults.test.ts),
+ * read rather than copied: it may SHRINK as each key moves to a per-breakpoint
+ * CSS var, and a stale copy here would keep forcing a fixed key to base.
+ */
+export const BASE_ONLY_CONFIG = [
+    "iconSize",
+    "descriptionLines",
+    "layout",
+    "htmlTag",
+    "activeIndex",
+    "activeTab",
+    "openItems",
+    "kind",
+    "datasetSource",
+    "collectionId",
+    "collectionType",
+    "quantity",
+    "rowLimit"
+];
+/**
+ * "type:key" pairs that are responsive DESPITE the shared key name, so the rule
+ * above must not touch them. quantity-button:iconSize is compiled per
+ * breakpoint by the satellite CSS compiler as the --icon-size var.
+ */
+export const BASE_ONLY_EXCEPTIONS = [
+    "quantity-button:iconSize"
+];