sbuilder-mcp 0.90.0 → 0.92.0

package/CHANGELOG.md

@@ -6,6 +6,29 @@ 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.92.0] - 2026-10-26
+
+### Added
+- `sb_bind` accepts `record.url` and, on a page of type `record`, reads the collection linked through page-links so `record.*` bindings work outside any list, refusing `record.url` while the collection has no detail page.
+- `sb_review` reports `record_option_invalid` for form-select, radio and checkbox controls with `optionSource: "record"` that lack a collection, use a label that is not an ID field, or have a parent that is not a record-sourced form-select.
+- Form controls accept `optionSource: "record"` to take their options from a collection, and form-select supports `specials.urlParam` prefill such as `?hotel=rec_…&room=rec_…`.
+
+### Changed
+- `sb_review` no longer reports `no_data_context` or `record_relation_orphan` for nodes outside a list on a record page.
+- `sb_set` no longer writes `optionSource`, `recordLabelField`, `recordParentField` or `recordParentNode` per breakpoint, because they are now base-only config keys.
+- The API catalog is synced with web_builder v1.0.172 and gains the `record` page type, served at `/records/<id>`.
+
+## [0.91.0] - 2026-10-23
+
+### Added
+- `sb_bind` accepts `record.money.<fid>` for number and integer Collections fields, showing the stored whole-unit value as money in the site's base currency (1850000 renders as 1.850.000 ₫).
+- `sb_review` reports `record_filter_invalid` for filter and sort controls aimed at a record list whose axis is not an ID field, whose target is not a collection record list or is a relation list, whose behaviour is not `filter`, or whose sort value is not `<fieldId>_asc|desc`.
+- Filter controls accept `filterSource: "record"` to filter and sort record lists through the `?f.record.<fld>~<list>=…&s.<list>=<fld>_desc&p.<list>=2` URL contract.
+
+### Changed
+- `sb_set` re-derives a text record tile's binding when `recordFormat`, `recordField` or `recordFieldType` changes, so choosing `recordFormat: "money"` switches it to `record.money.<fid>`.
+- The API catalog is synced with web_builder v1.0.171, and `recordFormat` is now a base-only config key.
+
 ## [0.90.0] - 2026-10-22
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,29 @@ 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.92.0] - 2026-10-26
+
+### Added
+- `sb_bind` nhận `record.url` và, trên trang loại `record`, đọc collection gắn qua page-links để bind `record.*` ngoài mọi danh sách, đồng thời từ chối `record.url` khi collection chưa có trang chi tiết.
+- `sb_review` báo `record_option_invalid` cho control form-select, radio và checkbox có `optionSource: "record"` thiếu collection, dùng nhãn không phải ID field, hoặc có cha không phải form-select lấy từ record.
+- Các control form nhận `optionSource: "record"` để lấy option từ collection, và form-select hỗ trợ điền sẵn qua `specials.urlParam` như `?hotel=rec_…&room=rec_…`.
+
+### Changed
+- `sb_review` không còn báo `no_data_context` hay `record_relation_orphan` cho node nằm ngoài danh sách trên trang record.
+- `sb_set` không còn ghi `optionSource`, `recordLabelField`, `recordParentField` hay `recordParentNode` theo breakpoint, vì chúng nay là khoá config base-only.
+- Catalog API được đồng bộ với web_builder v1.0.172 và thêm loại trang `record`, phục vụ tại `/records/<id>`.
+
+## [0.91.0] - 2026-10-23
+
+### Added
+- `sb_bind` nhận `record.money.<fid>` cho field number và integer của Collections, hiển thị giá trị đã lưu (đơn vị nguyên) thành tiền theo tiền tệ gốc của site (1850000 hiện là 1.850.000 ₫).
+- `sb_review` báo `record_filter_invalid` cho control lọc và sắp xếp nhắm vào danh sách record mà axis không phải ID field, target không phải danh sách record của collection hoặc là relation list, behaviour khác `filter`, hay giá trị sort không theo `<fieldId>_asc|desc`.
+- Các control lọc nhận `filterSource: "record"` để lọc và sắp xếp danh sách record qua hợp đồng URL `?f.record.<fld>~<list>=…&s.<list>=<fld>_desc&p.<list>=2`.
+
+### Changed
+- `sb_set` suy lại binding của tile text record khi `recordFormat`, `recordField` hoặc `recordFieldType` đổi, nên chọn `recordFormat: "money"` chuyển binding sang `record.money.<fid>`.
+- Catalog API được đồng bộ với web_builder v1.0.171, và `recordFormat` nay là khoá config base-only.
+
 ## [0.90.0] - 2026-10-22
 
 ### Added

package/dist/catalog/appscaffolds.generated.js

@@ -53,6 +53,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "title",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -98,6 +99,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "summary",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -143,6 +145,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "price",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -238,6 +241,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "description",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -571,6 +575,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "title",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -616,6 +621,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "price",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,

package/dist/catalog/checkout.generated.js

@@ -361,7 +361,11 @@ export const CHECKOUT_FORM_DOCUMENT = {
                 "width": "100%"
             },
             "config": {
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": "",
+                "recordParentField": "",
+                "recordParentNode": ""
             },
             "specials": {
                 "name": "shipping_method",
@@ -372,7 +376,8 @@ export const CHECKOUT_FORM_DOCUMENT = {
                 "mapTo": "order.shippingMethod",
                 "options": [],
                 "defaultValue": "",
-                "placeholder": "Chọn phương thức vận chuyển"
+                "placeholder": "Chọn phương thức vận chuyển",
+                "urlParam": ""
             },
             "responsive": {},
             "events": [],
@@ -466,7 +471,9 @@ export const CHECKOUT_FORM_DOCUMENT = {
             },
             "config": {
                 "columns": 1,
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": ""
             },
             "specials": {
                 "name": "xuat_hoa_don_vat",
@@ -2271,7 +2278,11 @@ export const FORM_TEMPLATES = {
                         "width": "100%"
                     },
                     "config": {
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": "",
+                        "recordParentField": "",
+                        "recordParentNode": ""
                     },
                     "specials": {
                         "name": "shipping_method",
@@ -2282,7 +2293,8 @@ export const FORM_TEMPLATES = {
                         "mapTo": "order.shippingMethod",
                         "options": [],
                         "defaultValue": "",
-                        "placeholder": "Chọn phương thức vận chuyển"
+                        "placeholder": "Chọn phương thức vận chuyển",
+                        "urlParam": ""
                     },
                     "responsive": {},
                     "events": [],
@@ -2376,7 +2388,9 @@ export const FORM_TEMPLATES = {
                     },
                     "config": {
                         "columns": 1,
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": ""
                     },
                     "specials": {
                         "name": "xuat_hoa_don_vat",
@@ -4199,7 +4213,11 @@ export const FORM_TEMPLATES = {
                         "width": "100%"
                     },
                     "config": {
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": "",
+                        "recordParentField": "",
+                        "recordParentNode": ""
                     },
                     "specials": {
                         "name": "loai_phong",
@@ -4214,7 +4232,8 @@ export const FORM_TEMPLATES = {
                             "Phòng gia đình"
                         ],
                         "defaultValue": "",
-                        "placeholder": "Chọn loại phòng"
+                        "placeholder": "Chọn loại phòng",
+                        "urlParam": ""
                     },
                     "responsive": {},
                     "events": [],
@@ -4422,7 +4441,9 @@ export const FORM_TEMPLATES = {
                     },
                     "config": {
                         "columns": 1,
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": ""
                     },
                     "specials": {
                         "name": "muc_do_hai_long",

package/dist/catalog/deadkeys.generated.js

@@ -1,7 +1,7 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 5932,
-    "identifiers": 109368,
-    "seededKeys": 453,
+    "files": 5966,
+    "identifiers": 109792,
+    "seededKeys": 457,
     "dead": 0
 };
 /**

package/dist/catalog/elements.generated.js

@@ -8304,13 +8304,18 @@ export const ELEMENTS = {
                     "Tùy chọn 3"
                 ],
                 "defaultValue": "",
-                "placeholder": "Chọn một mục"
+                "placeholder": "Chọn một mục",
+                "urlParam": ""
             },
             "style": {
                 "width": "100%"
             },
             "config": {
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": "",
+                "recordParentField": "",
+                "recordParentNode": ""
             }
         },
         "inspector": [
@@ -8476,7 +8481,9 @@ export const ELEMENTS = {
             },
             "config": {
                 "columns": 1,
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": ""
             },
             "style": {
                 "width": "100%"
@@ -8967,7 +8974,9 @@ export const ELEMENTS = {
             },
             "config": {
                 "columns": 1,
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": ""
             },
             "style": {
                 "width": "100%"
@@ -36144,6 +36153,7 @@ export const ELEMENTS = {
                 "kind": "title",
                 "recordField": "",
                 "recordFieldType": "",
+                "recordFormat": "",
                 "textValue": "",
                 "descriptionDisplayType": "Full",
                 "descriptionLines": 3,
@@ -37197,6 +37207,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37221,6 +37232,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37245,6 +37257,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37268,6 +37281,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37284,7 +37298,8 @@ export const ELEMENTS = {
                         "key": "record",
                         "label": "Data",
                         "controls": [
-                            "record_field"
+                            "record_field",
+                            "record_format"
                         ]
                     },
                     {
@@ -37404,6 +37419,7 @@ export const ELEMENTS = {
             "datasetSource",
             "recordField",
             "recordFieldType",
+            "recordFormat",
             "textValue",
             "descriptionDisplayType",
             "descriptionLines",
@@ -37417,6 +37433,7 @@ export const ELEMENTS = {
             "collection",
             "article",
             "record_field",
+            "record_format",
             "description_display",
             "width_select",
             "height_select",
@@ -37457,7 +37474,8 @@ export const ELEMENTS = {
             "Set config.kind to \"title\", \"vendor\", or \"description\"",
             "For a description, set config.descriptionDisplayType to \"Compact\" and config.descriptionLines to clamp it; enable specials.moreButtonEnabled for the toggle",
             "Customise config.moreText / config.lessText and config.icon (the chevron) for the toggle",
-            "Style per state (default / hover / active) via the state switcher"
+            "Style per state (default / hover / active) via the state switcher",
+            "In a record list on a number/integer field, set config.recordFormat to \"money\" to print it in the site currency (record.money.<fieldId>)"
         ],
         "semantics": [
             "product",
@@ -45690,6 +45708,69 @@ export const RECORD_BINDING_PROBES = [
             }
         ]
     },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "fld_0123456789abcdef",
+            "recordFieldType": "integer",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "fld_0123456789abcdef",
+            "recordFieldType": "number",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "fld_0123456789abcdef",
+            "recordFieldType": "text",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
     {
         "type": "text-dataset",
         "config": {
@@ -49276,6 +49357,7 @@ export const ELEMENT_VALUES = {
                 "category",
                 "manual",
                 "product",
+                "record",
                 "tag"
             ],
             "readBy": "OPTION_SOURCES (schema/src/elements/formOptionSource.ts)"
@@ -49291,6 +49373,7 @@ export const ELEMENT_VALUES = {
                 "category",
                 "manual",
                 "product",
+                "record",
                 "tag"
             ],
             "readBy": "OPTION_SOURCES (schema/src/elements/formOptionSource.ts)"
@@ -49317,6 +49400,7 @@ export const ELEMENT_VALUES = {
                 "category",
                 "manual",
                 "product",
+                "record",
                 "tag"
             ],
             "readBy": "OPTION_SOURCES (schema/src/elements/formOptionSource.ts)"
@@ -49547,6 +49631,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49618,6 +49703,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49689,6 +49775,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49760,6 +49847,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49831,6 +49919,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -50091,6 +50180,7 @@ export const BASE_ONLY_CONFIG = [
     "openItems",
     "kind",
     "datasetSource",
+    "recordFormat",
     "collectionId",
     "collectionType",
     "quantity",
@@ -50108,11 +50198,15 @@ export const BASE_ONLY_CONFIG = [
     "backgroundSceneUrl",
     "backgroundSceneModelUrl",
     "rowLimit",
+    "optionSource",
     "recordCollectionId",
     "recordField",
     "recordFieldType",
     "recordFilterField",
     "recordFilterValue",
+    "recordLabelField",
+    "recordParentField",
+    "recordParentNode",
     "recordRelationField",
     "recordSortDesc",
     "recordSortField"

package/dist/catalog/overlays.generated.js

@@ -363,6 +363,7 @@ export const OVERLAY_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -1354,6 +1355,7 @@ export const OVERLAY_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -1769,6 +1771,7 @@ export const OVERLAY_SEEDS = {
                     "kind": "description",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2409,6 +2412,7 @@ export const CART_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -3245,6 +3249,7 @@ export const CART_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,

package/dist/catalog/shapes.generated.js

@@ -4,7 +4,7 @@ export const SHAPE_SOURCE = {
     "fromHandlers": 334,
     "fromSwaggerOnly": 10,
     "withReadOnly": 29,
-    "structsRead": 3453
+    "structsRead": 3459
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{id}/ai-credits/purchase": {

package/dist/catalog/source.generated.js

@@ -1,7 +1,7 @@
 // GENERATED by scripts/gen-catalog.ts — do not edit by hand.
 // The platform commit every other generated file here describes.
 export const PLATFORM_SOURCE = {
-    "commit": "872f5f0185153ba1509017738dd56f6d91c5b2ff",
-    "committedAt": "2026-10-22T17:57:52+07:00",
+    "commit": "05168e6e00f55abbddc7895a29a15f030ca060fa",
+    "committedAt": "2026-10-26T09:25:34+07:00",
     "dirty": false
 };

package/dist/catalog/storepages.generated.js

@@ -881,6 +881,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article title",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -926,6 +927,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "kind": "summary",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article summary",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -971,6 +973,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "kind": "date",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "2026-08-13",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -1621,6 +1624,11 @@ export const PAGE_TYPES = [
         "ownSlug": false,
         "routePattern": "/brands/{slug}"
     },
+    {
+        "type": "record",
+        "group": "store",
+        "ownSlug": false
+    },
     {
         "type": "search",
         "group": "main",
@@ -2057,6 +2065,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2472,6 +2481,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "description",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2899,6 +2909,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -3334,6 +3345,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4054,6 +4066,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4347,6 +4360,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4607,6 +4621,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article title",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4652,6 +4667,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "summary",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article summary",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4697,6 +4713,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "date",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "2026-08-13",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4967,6 +4984,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -5012,6 +5030,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "date",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -5057,6 +5076,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "description",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,

package/dist/domains/site/builder.js

@@ -512,9 +512,9 @@ export function baseOnlyKeys(doc, id, keys, opts) {
  * binding is worse.
  */
 function rebindPatch(doc, id, keys) {
-    // `recordField` / `recordFieldType` are a record tile's field axis
-    // (datasetBindings.ts:517-530) — the editor's `setRecordField` heals on both.
-    const touchesAxis = ['kind', 'datasetSource', 'recordField', 'recordFieldType'].some((k) => k in keys);
+    // `recordField` / `recordFieldType` / `recordFormat` are a record tile's field
+    // axis (datasetBindings.ts recordSource) — `setRecordField` / `setRecordFormat` heal on them.
+    const touchesAxis = ['kind', 'datasetSource', 'recordField', 'recordFieldType', 'recordFormat'].some((k) => k in keys);
     if (!touchesAxis)
         return null;
     const node = doc.node(id);

package/dist/domains/site/findings.js

@@ -120,6 +120,14 @@ export const FIX = {
         'datasetSource is "record" — one card template, rows edited as data. Logic the platform has ' +
         'no native control for yet (visitor filters, computed totals) may stay in code, reading ' +
         'GET /_wb/collections/{slug}/records instead of its own copy.',
+    record_option_invalid: 'Point it at a collection and its label column: sb_set id "<id>", namespace config, keys ' +
+        '{ "optionSource": "record", "recordCollectionId": "col_…", "recordLabelField": "fld_…" } (base). A dependent ' +
+        'select adds "recordParentNode": "<parent form-select id>" and "recordParentField": "<reference fld_… of this ' +
+        'collection pointing at the parent\'s>". Values are record ids; prefill with specials.urlParam.',
+    record_filter_invalid: 'Aim it at ONE collection\'s record list(s) and a field: sb_set id "<id>", namespace specials, keys ' +
+        '{ "filterSource": "record", "filterAxis": "fld_…", "filterTargets": ["<list id>"], "filterBehavior": "filter" } — ' +
+        'axis types text/select/reference/url/date/boolean/integer/number. A sort select takes filterValues ' +
+        '[{ "value": "fld_…_asc" | "fld_…_desc", "label": "…" }].',
     record_relation_unset: 'Link it to its parent row: sb_set id "<id>", namespace config, keys { "recordRelationField": "fld_…" } — ' +
         'the ID of a "reference" field in THIS list\'s collection that targets the enclosing list\'s collection ' +
         '(GET /api/sites/{siteId}/collections/{id}/fields, refCollectionId).',
@@ -129,8 +137,8 @@ export const FIX = {
         'e.g. a short "Chưa có dữ liệu" line.',
     record_field_unset: 'Name the field by its ID: sb_set id "<id>", namespace config, keys { "recordField": "fld_…", ' +
         '"recordFieldType": "<the field\'s type>" } — ids and types are on GET /api/sites/{siteId}/collections/{id}/fields. ' +
-        'A text-dataset shows text/richtext/number/integer/boolean/date/select/url/reference (integer prints ' +
-        'unformatted, 3330000); a collection-media shows image. A gallery field binds nothing yet.',
+        'A text-dataset shows text/richtext/number/integer/boolean/date/select/url/reference (a number/integer ' +
+        'prints as money with "recordFormat": "money"); a collection-media shows image. A gallery field binds nothing yet.',
     unread_value: 'Write a value the renderer reads: sb_traits_for "<type>" lists them; sb_set id "<id>" ' +
         'with one, at the same breakpoint it is stored at.',
     unknown_icon: 'Write a real icon name: sb_set id "<id>", namespace <ns>, keys { "<key>": "<name>" } — the ' +

package/dist/domains/site/record.js

@@ -10,10 +10,14 @@
 /** `collections.NewID("fld")` — schema/src/elements/recordContext.ts:33. Anything else binds nothing. */
 export const RECORD_FIELD_ID = /^fld_[0-9a-f]{16}$/;
 /**
- * A `record.*` source a context can supply: `record.<fid>`, `record.html.<fid>`, or
- * `record.id` — the row's own record id (recordContext.ts, web_builder 986c96a96).
+ * A `record.*` source a context can supply: `record.<fid>`, `record.html.<fid>`,
+ * `record.money.<fid>` (a number/integer field formatted in the site's currency),
+ * `record.id` — the row's own record id — or `record.url` — `/records/<id>`, emitted
+ * only when the row's collection has a published record detail page (recordContext.ts).
  */
-export const RECORD_SOURCE = /^record\.(?:id|(?:html\.)?fld_[0-9a-f]{16})$/;
+export const RECORD_SOURCE = /^record\.(?:id|url|(?:html\.|money\.)?fld_[0-9a-f]{16})$/;
+/** The field types `record.money.<fid>` formats — recordContext.ts RECORD_MONEY_FIELD_TYPES. */
+export const RECORD_MONEY_TYPES = new Set(['number', 'integer']);
 /** The only record source `specials.boundHtml` admits — schema/src/rawSinkBindings.ts:102. */
 export const RECORD_HTML_SOURCE = /^record\.html\.fld_[0-9a-f]{16}$/;
 /** The tile elements whose binding the record field drives (editor/src/element/recordList.ts TILE_FIELD_TYPES). */
@@ -33,6 +37,8 @@ export function recordTileBindings(type, config, rows) {
     const fid = config.recordField;
     const ok = typeof fid === 'string' && RECORD_FIELD_ID.test(fid);
     const html = type === 'text-dataset' && config.recordFieldType === 'richtext';
+    // datasetBindings.ts isRecordMoney: a stale recordFormat on any other type is ignored.
+    const money = type === 'text-dataset' && config.recordFormat === 'money' && RECORD_MONEY_TYPES.has(String(config.recordFieldType));
     return rows.map((row) => {
         const b = row;
         if (b.id === 'bind-image')
@@ -40,7 +46,7 @@ export function recordTileBindings(type, config, rows) {
         if (b.id === 'bind-text') {
             return {
                 ...b,
-                source: ok ? `record.${html ? 'html.' : ''}${fid}` : '',
+                source: ok ? `record.${html ? 'html.' : money ? 'money.' : ''}${fid}` : '',
                 field: html ? 'specials.boundHtml' : 'specials.boundText',
             };
         }
@@ -80,12 +86,13 @@ export function recordScope(nodeAt, id) {
  */
 export function recordFieldProblem(source, scope) {
     if (!scope.length) {
-        return `"${source}" sits in no record-list row — only a list-dataset with datasetSource "record" (or a relation list inside one) supplies a record, so it would render its placeholder.`;
+        return `"${source}" sits in no record-list row and this is no record detail page — only a list-dataset with datasetSource "record" (or a relation list inside one), or a page of type "record" attached to a collection, supplies a record, so it would render its placeholder.`;
     }
-    if (source === 'record.id')
+    if (source === 'record.id' || source === 'record.url')
         return undefined;
     const html = source.startsWith('record.html.');
-    const fid = source.slice(html ? 12 : 7);
+    const money = source.startsWith('record.money.');
+    const fid = source.slice(html ? 12 : money ? 13 : 7);
     const f = scope.flatMap((s) => s.fields).find((x) => x.id === fid);
     if (!f) {
         const avail = scope
@@ -95,6 +102,8 @@ export function recordFieldProblem(source, scope) {
     }
     if (f.type === 'gallery')
         return `${fid} (${f.key}) is a gallery field, which the renderers do not bind yet — it emits nothing.`;
+    if (money && !RECORD_MONEY_TYPES.has(f.type))
+        return `${fid} (${f.key}) is ${f.type} — record.money. formats only a number or integer field.`;
     if (html && f.type !== 'richtext')
         return `${fid} (${f.key}) is ${f.type}, not richtext — bind it as "record.${fid}".`;
     if (!html && f.type === 'richtext')

package/dist/domains/site/review.js

@@ -636,6 +636,9 @@ opts = {}) {
                 const parentCfg = up && d.nodes[up] ? d.nodes[up].config : undefined;
                 const nested = parentCfg?.datasetSource === 'record';
                 const rel = String(cfg.recordRelationField ?? '');
+                // A record detail page (web_builder #160) is the parent of a relation list
+                // placed on it outside any list.
+                const pageParent = opts.pageType === 'record' && !up;
                 if (nested && !rel) {
                     out.push({
                         code: 'record_relation_unset',
@@ -647,7 +650,7 @@ opts = {}) {
                         fix: fill('record_relation_unset', { id }),
                     });
                 }
-                else if (rel && (!nested || !RECORD_FIELD_ID.test(rel))) {
+                else if (rel && ((!nested && !pageParent) || !RECORD_FIELD_ID.test(rel))) {
                     out.push({
                         code: 'record_relation_orphan',
                         nodeId: id,
@@ -670,6 +673,78 @@ opts = {}) {
                     });
                 }
             }
+            // FORM OPTIONS FROM A COLLECTION (web_builder #159, contract §7.2). Every miss renders
+            // a choice field with only its placeholder (no authored fallback), or a room list that
+            // never narrows — and the server refuses any other answer as not_an_option.
+            if (['form-select', 'form-radio', 'form-checkbox'].includes(type) && String(cfg.optionSource ?? '').trim() === 'record') {
+                const why = [];
+                if (!String(cfg.recordCollectionId ?? '').trim())
+                    why.push('config.recordCollectionId names no collection');
+                if (!RECORD_FIELD_ID.test(String(cfg.recordLabelField ?? '')))
+                    why.push('config.recordLabelField is not a field ID');
+                const pNode = String(cfg.recordParentNode ?? '');
+                const pField = String(cfg.recordParentField ?? '');
+                if (pNode || pField) {
+                    const pc = d.nodes[pNode]?.config;
+                    if (type !== 'form-select')
+                        why.push('only a form-select narrows by a parent field');
+                    else if (!pNode || !pField)
+                        why.push('recordParentNode and recordParentField go together');
+                    else if (d.nodes[pNode]?.data.type !== 'form-select' || String(pc?.optionSource ?? '').trim() !== 'record')
+                        why.push(`recordParentNode "${pNode}" is not a record-sourced form-select`);
+                    else if (!RECORD_FIELD_ID.test(pField))
+                        why.push(`recordParentField "${pField}" is not a field ID`);
+                }
+                if (why.length) {
+                    out.push({
+                        code: 'record_option_invalid',
+                        nodeId: id,
+                        type,
+                        problem: `A choice field listing records that shows no options or never narrows: ${why.join('; ')}.`,
+                        fix: fill('record_option_invalid', { id }),
+                    });
+                }
+            }
+            // RECORD FILTERS (web_builder PR #157, contract §7.1): a filter/sort control aimed at a
+            // record list. Every miss below renders a control that empties the list or narrows nothing.
+            {
+                const sp = (n.specials ?? {});
+                const targets = Array.isArray(sp.filterTargets) ? sp.filterTargets.map(String) : [];
+                const recordTargets = targets.filter((t) => {
+                    const c = d.nodes[t]?.config;
+                    return d.nodes[t]?.data.type === 'list-dataset' && c?.datasetSource === 'record';
+                });
+                const why = [];
+                if (sp.filterSource === 'record') {
+                    if (!RECORD_FIELD_ID.test(String(sp.filterAxis ?? '')))
+                        why.push(`filterAxis "${String(sp.filterAxis ?? '')}" is not a field ID`);
+                    if (targets.length && recordTargets.length !== targets.length)
+                        why.push('a filterTargets entry is not a record list');
+                    const cfgOf = (t) => d.nodes[t].config ?? {};
+                    if (recordTargets.some((t) => String(cfgOf(t).recordRelationField ?? '')))
+                        why.push('it targets a relation list');
+                    if (new Set(recordTargets.map((t) => String(cfgOf(t).recordCollectionId ?? ''))).size > 1)
+                        why.push('its targets read different collections');
+                    if (sp.filterBehavior !== undefined && sp.filterBehavior !== 'filter')
+                        why.push(`filterBehavior "${String(sp.filterBehavior)}" — a record filter only narrows ("filter")`);
+                }
+                if (sp.filterSource === 'sort' && recordTargets.length) {
+                    const bad = (Array.isArray(sp.filterValues) ? sp.filterValues : [])
+                        .map((v) => String(v?.value ?? ''))
+                        .filter((v) => !/^fld_[0-9a-f]{16}_(?:asc|desc)$/.test(v));
+                    if (bad.length)
+                        why.push(`sort values ${bad.slice(0, 3).map((v) => `"${v}"`).join(', ')} are not "<fieldId>_asc|desc" — a record list ignores product sort keys`);
+                }
+                if (why.length) {
+                    out.push({
+                        code: 'record_filter_invalid',
+                        nodeId: id,
+                        type,
+                        problem: `A record ${sp.filterSource === 'sort' ? 'sort' : 'filter'} control that narrows nothing or empties its list: ${why.join('; ')}.`,
+                        fix: fill('record_filter_invalid', { id }),
+                    });
+                }
+            }
             if (RECORD_TILES.has(type) && cfg.datasetSource === 'record') {
                 const fid = cfg.recordField;
                 if (typeof fid !== 'string' || !RECORD_FIELD_ID.test(fid)) {
@@ -690,7 +765,8 @@ opts = {}) {
                 while (list && d.nodes[list] && d.nodes[list].data.type !== 'list-dataset')
                     list = d.nodes[list].data.parent;
                 const lcfg = list && d.nodes[list] ? d.nodes[list].config : undefined;
-                if (lcfg?.datasetSource !== 'record') {
+                // On a record detail page the PAGE supplies the record outside any list.
+                if (lcfg?.datasetSource !== 'record' && !(opts.pageType === 'record' && !list)) {
                     out.push({
                         code: 'no_data_context',
                         nodeId: id,

package/dist/tools/live.js

@@ -745,21 +745,23 @@ export function registerLiveTools(server, ctx, session) {
         // `force` gets past it, recorded under `forced`.
         if (RECORD_SOURCE.test(source)) {
             const scope = recordScope((x) => (d.has(x) ? d.node(x) : undefined), id);
-            // Resolved only when there is something to read: an empty scope is refused below
-            // without a fetch, and must not fail on a missing SB_SITE first.
-            const site = scope.length ? siteFor(ctx, session.page()?.siteId) : '';
+            const open = session.page();
+            const site = siteFor(ctx, open?.siteId);
+            const get = async (path) => request({ base: ctx.base, method: 'GET', path: `/api/sites/${encodeURIComponent(site)}${path}`, token: siteToken(ctx), fetchImpl: ctx.fetchImpl });
             let withFields;
             try {
+                // A RECORD DETAIL PAGE (web_builder #160) supplies its record outside any list:
+                // the collections attached to it are the scope.
+                if (!scope.length && open) {
+                    const links = (await get(`/page-links?pageId=${encodeURIComponent(open.pageId)}&linkType=recordCollection`));
+                    for (const l of links.links ?? [])
+                        if (l.linkId)
+                            scope.push(l.linkId);
+                }
                 withFields = await Promise.all(scope.map(async (cid) => {
                     if (!cid)
                         return { collectionId: '(none set)', fields: [] };
-                    const got = (await request({
-                        base: ctx.base,
-                        method: 'GET',
-                        path: `/api/sites/${encodeURIComponent(site)}/collections/${encodeURIComponent(cid)}/fields`,
-                        token: siteToken(ctx),
-                        fetchImpl: ctx.fetchImpl,
-                    }));
+                    const got = (await get(`/collections/${encodeURIComponent(cid)}/fields`));
                     return { collectionId: cid, fields: got.fields ?? [] };
                 }));
             }
@@ -776,6 +778,26 @@ export function registerLiveTools(server, ctx, session) {
                     if (why)
                         throw new Error(`sbuilder: ${why}`);
                 });
+                // record.url resolves only for a collection with an attached record page.
+                const cid = scope[0];
+                if (source === 'record.url' && cid) {
+                    let attached = true;
+                    try {
+                        await get(`/page-links/recordCollection/${encodeURIComponent(cid)}`);
+                    }
+                    catch (e) {
+                        if (e.status !== 404)
+                            throw e;
+                        attached = false;
+                    }
+                    soft(guard, () => {
+                        if (!attached) {
+                            throw new Error(`sbuilder: collection ${cid} has no record detail page, so record.url is never emitted and the link ` +
+                                'stays a plain button. Create a page of type "record", attach it with PUT ' +
+                                `/api/sites/{siteId}/page-links/recordCollection/${cid} {pageId}, and publish it.`);
+                        }
+                    });
+                }
             }
         }
         const forced = guard.forced.length ? { forced: guard.forced } : {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.90.0",
+  "version": "0.92.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",