sbuilder-mcp 0.92.0 → 0.94.0

package/CHANGELOG.md

@@ -6,6 +6,31 @@ 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.94.0] - 2026-10-27
+
+### Added
+- `sb_bind` accepts `record.ref.<a>.<b>` and `record.money.ref.<a>.<b>` to bind a field of the record a reference names, reading the referenced collection's fields to check the target, and a text-dataset tile with `recordField: "ref.<a>.<b>"` derives its binding the way the platform does.
+- `sb_review` reports `href_params_invalid`, `href_params_unresolved` and `href_params_stranded` for link parameters (`hrefParams`) that are malformed, have no record to read from, or sit on a button without exactly one click action.
+- `sb_review` reports `record_favorite_invalid` for a favorites heart or tab that is wired wrongly, and `show_record_favorites` requires a `targetId`.
+- Buttons gain the `toggle_record_favorite` and `show_record_favorites` actions, and the element catalog gains the `tags` field type.
+
+### Changed
+- `hrefParams` is treated as an untranslated key, and `filterMatch: "all"` is valid on record sources.
+- The API catalog is synced with web_builder v1.0.174.
+
+## [0.93.0] - 2026-10-26
+
+### Added
+- `sb_bind` accepts `record.agg.<key>` and `record.money.agg.<key>`, and a text-dataset tile with `recordField: "agg.<key>"` derives its binding the way the platform does.
+- `sb_review` reports `record_aggregate_invalid` for `recordAggregates` that are malformed, which would publish an empty list, or that use `whenNone: "hide"` without an empty state.
+- `sb_review` reports `estimate_invalid` for a form-estimate that does not have exactly one record term, or whose term or rule points at a node of the wrong type.
+- The element catalog gains `form-estimate` and the base-only `recordAggregates` key.
+
+### Changed
+- `sb_review` accepts `agg.<key>` and `param.<name>` axes in `record_filter_invalid` when the target list defines them, rejects a param with more than one value, and accepts sort values of `agg.<key>_asc|desc`.
+- `sb_review` reports `record_field_unset` for a tile bound to `agg.<key>` that its list does not define.
+- The API catalog is synced with web_builder v1.0.173 and now covers 124 elements and 95 binding sources.
+
 ## [0.92.0] - 2026-10-26
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,31 @@ 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.94.0] - 2026-10-27
+
+### Added
+- `sb_bind` nhận `record.ref.<a>.<b>` và `record.money.ref.<a>.<b>` để bind field của record mà một reference trỏ tới, đọc field của collection được tham chiếu để kiểm tra đích, và tile text-dataset có `recordField: "ref.<a>.<b>"` suy ra binding giống nền tảng.
+- `sb_review` báo `href_params_invalid`, `href_params_unresolved` và `href_params_stranded` cho tham số liên kết (`hrefParams`) sai định dạng, không có record để đọc, hoặc nằm trên button không có đúng một hành động click.
+- `sb_review` báo `record_favorite_invalid` cho nút tim hoặc tab yêu thích nối sai, và `show_record_favorites` yêu cầu `targetId`.
+- Button thêm hai hành động `toggle_record_favorite` và `show_record_favorites`, và catalog element thêm loại field `tags`.
+
+### Changed
+- `hrefParams` được coi là khoá không dịch, và `filterMatch: "all"` hợp lệ trên nguồn record.
+- Catalog API được đồng bộ với web_builder v1.0.174.
+
+## [0.93.0] - 2026-10-26
+
+### Added
+- `sb_bind` nhận `record.agg.<key>` và `record.money.agg.<key>`, và tile text-dataset có `recordField: "agg.<key>"` suy ra binding giống nền tảng.
+- `sb_review` báo `record_aggregate_invalid` cho `recordAggregates` sai định dạng (làm danh sách publish rỗng) hoặc dùng `whenNone: "hide"` mà thiếu trạng thái rỗng.
+- `sb_review` báo `estimate_invalid` khi form-estimate không có đúng một term record, hoặc term/rule trỏ vào node sai loại.
+- Catalog element thêm `form-estimate` và khoá base-only `recordAggregates`.
+
+### Changed
+- `sb_review` chấp nhận axis `agg.<key>` và `param.<name>` trong `record_filter_invalid` khi danh sách đích có định nghĩa, từ chối param có nhiều hơn một giá trị, và chấp nhận giá trị sort `agg.<key>_asc|desc`.
+- `sb_review` báo `record_field_unset` cho tile bind `agg.<key>` mà danh sách của nó không định nghĩa.
+- Catalog API được đồng bộ với web_builder v1.0.173 và nay gồm 124 element và 95 nguồn binding.
+
 ## [0.92.0] - 2026-10-26
 
 ### Added

package/README.md

@@ -119,7 +119,7 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_undo` | Undo / redo this session's writes — page and form edits and `sb_api_call` PUTs; a page is refused if someone else saved it since. The platform's versions and history (`sb_page_version`) outlive this process |
 
 Twenty-eight tools, **919 API operations** (344 of the 429 writes carrying a body shape read
-off the handler), 123 elements, 94 binding sources. `sb_api_find`
+off the handler), 124 elements, 95 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

@@ -116,7 +116,7 @@ nhét ngược lại vào mọi bản cài.
 | `sb_undo` | Hoàn tác / làm lại các thao tác ghi trong phiên — chỉnh sửa trang, form và PUT qua `sb_api_call`; trang bị từ chối nếu người khác đã lưu sau đó. Version và history của nền tảng (`sb_page_version`) sống lâu hơn process này |
 
 Hai mươi tám tool, **919 operation API** (344 trong 429 lệnh ghi có hình dạng body đọc thẳng
-từ handler), 123 element, 94 nguồn binding. `sb_api_find` là
+từ handler), 124 element, 95 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

@@ -29687,7 +29687,8 @@ export const API_DEFINITIONS = {
             "select",
             "integer",
             "reference",
-            "gallery"
+            "gallery",
+            "tags"
         ],
         "x-enum-varnames": [
             "TypeText",
@@ -29700,7 +29701,8 @@ export const API_DEFINITIONS = {
             "TypeSelect",
             "TypeInteger",
             "TypeReference",
-            "TypeGallery"
+            "TypeGallery",
+            "TypeTags"
         ]
     },
     "github_com_webbuilder_server_internal_collections.UpsertItem": {

package/dist/catalog/appscaffolds.generated.js

@@ -376,6 +376,7 @@ export const APP_SCAFFOLDS = {
                             "recordFilterField": "",
                             "recordFilterValue": "",
                             "recordRelationField": "",
+                            "recordAggregates": [],
                             "itemsPerRow": 4,
                             "collectionType": "all_products",
                             "collectionId": "all_products",

package/dist/catalog/deadkeys.generated.js

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

package/dist/catalog/elements.generated.js

@@ -1,5 +1,5 @@
 export const ELEMENT_SOURCE = {
-    "count": 123,
+    "count": 124,
     "docSchemaVersion": 2
 };
 export const ELEMENTS = {
@@ -833,7 +833,9 @@ export const ELEMENTS = {
                 "logout_customer",
                 "toggle_wishlist",
                 "quick_view",
-                "close_quick_view"
+                "close_quick_view",
+                "toggle_record_favorite",
+                "show_record_favorites"
             ]
         },
         "bindingEvents": {
@@ -9846,6 +9848,154 @@ export const ELEMENTS = {
             "account"
         ]
     },
+    "form-estimate": {
+        "type": "form-estimate",
+        "label": "Estimate",
+        "category": "form",
+        "isContainer": false,
+        "isRootOnly": false,
+        "locked": false,
+        "hideInLayer": false,
+        "childAllows": [],
+        "defaults": {
+            "specials": {
+                "name": "",
+                "label": "Tạm tính",
+                "placeholder": "Chọn phòng và ngày để xem giá dự kiến.",
+                "description": "Giá dự kiến, chưa phải giá giữ chỗ.",
+                "estimateTerms": [],
+                "estimateRules": []
+            },
+            "style": {
+                "width": "100%",
+                "height": "fit-content",
+                "fontSize": "14px",
+                "lineHeight": "150%",
+                "color": "#171717"
+            }
+        },
+        "inspector": [
+            {
+                "tab": "general",
+                "groups": [
+                    {
+                        "key": "content",
+                        "label": "Content",
+                        "controls": [
+                            "form_estimate_content"
+                        ]
+                    },
+                    {
+                        "key": "estimate",
+                        "label": "Estimate",
+                        "controls": [
+                            "form_estimate_terms"
+                        ]
+                    },
+                    {
+                        "key": "estimate_rules",
+                        "label": "Stay rules",
+                        "controls": [
+                            "form_estimate_rules"
+                        ]
+                    },
+                    {
+                        "key": "typography",
+                        "label": "Typography",
+                        "controls": [
+                            "text_color",
+                            "font_family",
+                            "font_size",
+                            "text_align",
+                            "line_height"
+                        ]
+                    },
+                    {
+                        "key": "size",
+                        "label": "Size",
+                        "controls": [
+                            "width_select",
+                            "height_select",
+                            "size_bounds"
+                        ]
+                    },
+                    {
+                        "key": "id_field",
+                        "label": "ID field",
+                        "controls": [
+                            "field_name"
+                        ]
+                    }
+                ]
+            },
+            {
+                "tab": "advanced",
+                "groups": [
+                    {
+                        "key": "spacing",
+                        "label": "Spacing",
+                        "controls": [
+                            "padding_margin"
+                        ]
+                    },
+                    {
+                        "key": "display",
+                        "label": "Display",
+                        "controls": [
+                            "display"
+                        ]
+                    },
+                    {
+                        "key": "class_css",
+                        "label": "Class",
+                        "controls": [
+                            "class_css"
+                        ]
+                    }
+                ]
+            }
+        ],
+        "controls": [
+            "form_estimate_content",
+            "form_estimate_terms",
+            "form_estimate_rules",
+            "text_color",
+            "font_family",
+            "font_size",
+            "text_align",
+            "line_height",
+            "width_select",
+            "height_select",
+            "size_bounds",
+            "field_name",
+            "padding_margin",
+            "display",
+            "class_css"
+        ],
+        "description": "A live booking summary inside a form: the price of the record chosen in a data-record select, multiplied by the nights between two date fields and by a number field (\"3.330.000 ₫ × 2 đêm × 2 phòng = 13.320.000 ₫\"), plus the stay rules that go with it — check-in not in the past, check-out after check-in, a maximum number of nights, and guests within the chosen room's capacity. The server recomputes the total from the published record on submit and stores it as an estimate.",
+        "useWhen": [
+            "A booking or quote request whose price is a record (a room type, a tour, a rental) times nights and/or a quantity.",
+            "The visitor should see what their choice costs before sending, and the stay dates need checking."
+        ],
+        "avoidWhen": [
+            "The form sells cart products — the order form and its bill already price those.",
+            "The price is not stored on a data record; there is nothing authoritative for the server to recompute from."
+        ],
+        "contentTips": [
+            "Point the price at a number column holding WHOLE currency units (1850000, not cents).",
+            "Set the guests and rooms fields to whole numbers with a range, and add a capacity rule so 3 guests cannot book 1 room for 2.",
+            "Keep the note: an estimate is not a held price."
+        ],
+        "semantics": [
+            "form",
+            "booking",
+            "estimate",
+            "total",
+            "price",
+            "summary",
+            "nights"
+        ]
+    },
     "form-segment": {
         "type": "form-segment",
         "label": "Segment",
@@ -42918,6 +43068,7 @@ export const ELEMENTS = {
                 "recordFilterField": "",
                 "recordFilterValue": "",
                 "recordRelationField": "",
+                "recordAggregates": [],
                 "itemsPerRow": 4,
                 "collectionType": "all_products",
                 "collectionId": "all_products",
@@ -44025,6 +44176,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44067,6 +44219,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44117,6 +44270,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44169,6 +44323,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44211,6 +44366,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44399,6 +44555,7 @@ export const ELEMENTS = {
             "recordFilterField",
             "recordFilterValue",
             "recordRelationField",
+            "recordAggregates",
             "itemsPerRow",
             "listNavIcon",
             "listNavPosition",
@@ -44511,6 +44668,7 @@ export const ELEMENTS = {
             "Collection lists: config.collectionListType \"page_collections\" renders THE SUB-COLLECTIONS OF THE COLLECTION THE PAGE IS (the one /collections/{slug} named), so a single collection template draws every collection's browse grid — off a collection template it shows every collection instead; \"all_collections\" renders every collection; \"custom_collections\" renders specials.collectionIds, in that order",
             "config.quantity caps how many records render and, under a loadingMode, is the PAGE SIZE; it is BASE-only — one value for every breakpoint, never per-breakpoint. A Data list (datasetSource \"record\") pages at most 50 records per page. config.itemsPerRow is the row size (grid columns / slide page size) and style.gap is the space between cards — both are per-breakpoint",
             "A Data list (datasetSource \"record\") nested inside another Data list's row can show ONLY the child records pointing at that row: set config.recordRelationField to the field id (fld_<16hex>) of a \"reference\" field in the nested list's own collection (e.g. RoomType.hotel inside a Hotels list). BASE-only. Such a list is never paged (loadingMode is ignored), its card may also bind the enclosing row's fields, and outside a record-list row it shows its empty state, never all records",
+            "A Data list can carry config.recordAggregates (BASE-only, ≤4): [{key, recordCollectionId (child collection), recordRelationField (child reference field → this collection), op \"min\"|\"max\"|\"count\", recordField (child number/integer field, \"\" for count), where: [{recordField, op:\"gte\", param, per?}], whenNone \"hide\"|\"show\"}]. Each row then binds record.agg.<key> / record.money.agg.<key> (e.g. a hotel's cheapest room that fits: min nightly price where capacity × rooms ≥ guests). Visitors send params as f.record.param.<name>=<int>, filter as f.record.agg.<key>=..3000000, sort as s.<node>=agg.<key>_asc. Not availability",
             "config.layout \"grid\" for a multi-row grid, \"slide\" for row-by-row carousel behaviour",
             "Navigation and pagination only matter when layout is \"slide\". The arrows exist while config.listNavIcon names an icon (clearing it turns them off); the dots exist while paginationItemWidth and paginationItemHeight are both above 0",
             "config.loadingMode is how a GRID list offers the REST of its feed once config.quantity rows are on screen: \"none\" (the default — those rows and nothing more), \"pagination\" (a numbered pager, each page its own URL), \"load_more\" (a button that appends the next page in place) or \"scroll_more\" (the same append, triggered by reaching the end). Set it whenever the listing is a real catalogue rather than a fixed shelf of featured rows",
@@ -45580,6 +45738,7 @@ export const BINDING_SOURCES = [
     "site.supportEmail",
     "site.supportPhone",
     "site.tiktok",
+    "site.timezone",
     "site.youtube"
 ];
 export const BOUND_SPECIALS = {
@@ -45771,6 +45930,67 @@ export const RECORD_BINDING_PROBES = [
             }
         ]
     },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "agg.startPrice",
+            "recordFieldType": "number"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.agg.startPrice",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "agg.startPrice",
+            "recordFieldType": "number",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.agg.startPrice",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "agg.startPrice",
+            "recordFieldType": "richtext"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "",
+                "field": "specials.boundHtml",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
     {
         "type": "text-dataset",
         "config": {
@@ -45832,6 +46052,67 @@ export const RECORD_BINDING_PROBES = [
             }
         ]
     },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "ref.fld_0123456789abcdef.fld_0123456789abcdef",
+            "recordFieldType": "text"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.ref.fld_0123456789abcdef.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "ref.fld_0123456789abcdef.fld_0123456789abcdef",
+            "recordFieldType": "integer",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.ref.fld_0123456789abcdef.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "ref.fld_0123456789abcdef.fld_0123456789abcdef",
+            "recordFieldType": "richtext"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "",
+                "field": "specials.boundHtml",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
     {
         "type": "collection-media",
         "config": {
@@ -48946,7 +49227,8 @@ export const WRITE_PRECONDITIONS = [
                     "tag",
                     "blog_category",
                     "blog_tag",
-                    "course_tag"
+                    "course_tag",
+                    "record"
                 ]
             },
             {
@@ -48959,7 +49241,7 @@ export const WRITE_PRECONDITIONS = [
                 ]
             }
         ],
-        "otherwise": "the filter combines ticked values with OR, as it always did. Both predicates IGNORE the mode outside these cases rather than honouring it — a product holds ONE brand, one price and one stock state, so \"match all\" on two ticked values could only return an empty shelf, and a stale URL degrades to the ordinary OR instead of to a blank page."
+        "otherwise": "the filter combines ticked values with OR, as it always did. Both predicates IGNORE the mode outside these cases rather than honouring it — a product holds ONE brand, one price and one stock state, so \"match all\" on two ticked values could only return an empty shelf, and a stale URL degrades to the ordinary OR instead of to a blank page. On a `record` source only a `tags` field honours it."
     }
 ];
 export const HOVER_HOMES = {
@@ -50199,6 +50481,7 @@ export const BASE_ONLY_CONFIG = [
     "backgroundSceneModelUrl",
     "rowLimit",
     "optionSource",
+    "recordAggregates",
     "recordCollectionId",
     "recordField",
     "recordFieldType",

package/dist/catalog/search.js

@@ -372,6 +372,11 @@ export function describeOperation(op) {
                 'product priceCents). reference = "rec_…" of a record in the field\'s refCollectionId, ' +
                 'same site; gallery = 1..30 image URLs; date = YYYY-MM-DD. A field\'s type and ' +
                 'refCollectionId cannot change after creation.',
+            tags: 'tags = a multi-select: options REQUIRED (1..100, unique, no comma); a value is a JSON array of ' +
+                'options or one comma-separated string, stored in options order; CSV cell ", "-joined. A page ' +
+                'prints it joined. Filter: filterSource "record", filterAxis = its fld_…, filterValues = its options; ' +
+                'f.record.<fid> matches ANY, fm.record.<fid>=all (specials.filterMatch "all") ALL — only a tags axis ' +
+                'honours all. type is immutable: migrate a text column to a NEW tags field and upsert.',
             revision: 'PUT a record with the rev you read: a different stored rev is 409 stale_record and ' +
                 'nothing is written — re-read and reapply, never retry blind. PUT always needs published.',
             import: 'records/upsert is the idempotent import: EVERY item needs an externalId (1..120, no ' +

package/dist/catalog/shapes.generated.js

@@ -4,7 +4,7 @@ export const SHAPE_SOURCE = {
     "fromHandlers": 334,
     "fromSwaggerOnly": 10,
     "withReadOnly": 29,
-    "structsRead": 3459
+    "structsRead": 3467
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{id}/ai-credits/purchase": {
@@ -1533,7 +1533,7 @@ export const REQUEST_SHAPES = {
             },
             {
                 "name": "type",
-                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\""
+                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\" | \"tags\""
             },
             {
                 "name": "required",
@@ -1580,7 +1580,7 @@ export const REQUEST_SHAPES = {
             },
             {
                 "name": "type",
-                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\""
+                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\" | \"tags\""
             },
             {
                 "name": "required",

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": "05168e6e00f55abbddc7895a29a15f030ca060fa",
-    "committedAt": "2026-10-26T09:25:34+07:00",
+    "commit": "db78bb5204d20a8f3dd9abf6d6a42fbfb7e58daf",
+    "committedAt": "2026-10-26T21:17:55+07:00",
     "dirty": false
 };

package/dist/catalog/storepages.generated.js

@@ -678,6 +678,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",
@@ -2967,6 +2968,7 @@ export const STORE_PAGE_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",
@@ -3688,6 +3690,7 @@ export const STORE_PAGE_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",
@@ -4418,6 +4421,7 @@ export const STORE_PAGE_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",

package/dist/catalog/translations.generated.js

@@ -1,9 +1,9 @@
 // GENERATED by scripts/gen-catalog.ts — do not edit by hand.
 // Source: <WB_REPO>/schema/src/elements/translatableFields.ts
 export const TRANSLATION_SOURCE = {
-    "elements": 67,
-    "pairs": 187,
-    "neverKeys": 180,
+    "elements": 68,
+    "pairs": 190,
+    "neverKeys": 183,
     "entityTypes": 12
 };
 /** Every entity type a translation record can name, including "node". */
@@ -274,6 +274,11 @@ export const TRANSLATABLE_SPECIALS = {
         "text",
         "linkText"
     ],
+    "form-estimate": [
+        "label",
+        "placeholder",
+        "description"
+    ],
     "form-step-button": [
         "text"
     ],
@@ -407,6 +412,7 @@ export const NEVER_TRANSLATED = [
     "displayType",
     "end",
     "endsAt",
+    "estimateRules",
     "field",
     "fileFormat",
     "fileLimit",
@@ -434,6 +440,7 @@ export const NEVER_TRANSLATED = [
     "hideWhenEmpty",
     "hoverHostDepth",
     "href",
+    "hrefParams",
     "htmlTag",
     "icon",
     "iconEnabled",
@@ -522,6 +529,7 @@ export const NEVER_TRANSLATED = [
     "showPercent",
     "showPhone",
     "showPlaceholder",
+    "siteTimezone",
     "source",
     "sourceCode",
     "sourceFlashSale",
@@ -1129,6 +1137,17 @@ export const TRANSLATABLE_FIELDS = {
             "key": "linkText"
         }
     ],
+    "form-estimate": [
+        {
+            "key": "label"
+        },
+        {
+            "key": "placeholder"
+        },
+        {
+            "key": "description"
+        }
+    ],
     "form-step-button": [
         {
             "key": "text"

package/dist/domains/site/findings.js

@@ -124,6 +124,13 @@ export const FIX = {
         '{ "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_aggregate_invalid: 'Fix config.recordAggregates on "<id>" (base): each { key, recordCollectionId (child), recordRelationField ' +
+        '(its reference to this list\'s collection), op min|max|count, recordField (child number/integer; "" for count), ' +
+        'where: [{ recordField, op: "gte", param, per? }], whenNone hide|show } — and keep the list\'s list-empty.',
+    estimate_invalid: 'Point its operands at THIS form\'s nodes: sb_set id "<id>", namespace specials, base, keys { "estimateTerms": ' +
+        '[{kind:"record", node:<record form-select>, field:<fld_ price>}, {kind:"nights", start:<date>, end:<date>, unit:"đêm"}, ' +
+        '{kind:"number", node:<form-number>, unit:"phòng"}], "estimateRules": [{kind:"dateRange", start, end, notPast:true}, ' +
+        '{kind:"maxNights", start, end, max:30}, {kind:"capacity", node, field:<fld_ capacity>, per:<rooms>, count:<guests>}] }.',
     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 ' +
@@ -135,6 +142,17 @@ export const FIX = {
         'namespace config, keys { "recordRelationField": "" }.',
     record_relation_no_empty: 'Give it an empty state: sb_add a "list-empty" into id "<id>" (it becomes config.emptyStateId), ' +
         'e.g. a short "Chưa có dữ liệu" line.',
+    href_params_invalid: 'Rewrite them: sb_set id "<id>", namespace specials, keys { "href": "/<same-site path>", "hrefParams": ' +
+        '[{ "name": "hotel", "source": "record.fld_…" }, { "name": "room", "source": "record.id" }] } — name ' +
+        '^[a-z][a-z0-9_]{0,23}$, unique, not lang/s/t/lesson; source record.id | record.url | record.fld_<16 hex>; ≤ 8. ' +
+        'Pass ids, never names, emails or phones — a query is visible in the address bar and logs.',
+    href_params_unresolved: 'Move it inside a record list\'s card (sb_move), use it on a record detail page, or drop them: sb_set id "<id>", ' +
+        'namespace specials, keys { "hrefParams": [] }.',
+    href_params_stranded: 'Give it ONE click action — open_page or go_to_url (sb_event) — and no purchase binding, or drop them: ' +
+        'sb_set id "<id>", namespace specials, keys { "hrefParams": [] }.',
+    record_favorite_invalid: 'A heart is a button inside a record list\'s card (or on a record page) with click toggle_record_favorite {}; a tab ' +
+        'is a button with show_record_favorites { "targetId": "<record list id, not a relation list>", "view": ' +
+        '"favorites" | "all", "showCount": true } (sb_event id "<id>"). Give the list a list-empty.',
     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 (a number/integer ' +

package/dist/domains/site/navhref.js

@@ -177,6 +177,11 @@ export const PAYLOAD_NEEDS = {
         why: 'publishes a PopupControl call with no target, which opens nothing',
         shape: '{ "id": "<the pop-up\'s overlay id, from sb_store popup>", "label": "<name>" }',
     },
+    show_record_favorites: {
+        key: 'targetId',
+        why: 'publishes a favorites tab aimed at no list, which narrows nothing',
+        shape: '{ "targetId": "<record list-dataset id>", "view": "favorites" | "all", "showCount": true }',
+    },
     scroll_to: {
         key: 'targetId',
         why: 'publishes a ScrollControl call with no target, which scrolls nowhere',

package/dist/domains/site/record.js

@@ -13,9 +13,117 @@ export const RECORD_FIELD_ID = /^fld_[0-9a-f]{16}$/;
  * 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).
+ * only when the row's collection has a published record detail page (recordContext.ts),
+ * or `record.ref.<refFid>.<fid>` / `record.money.ref.…` — a field of the record a
+ * `reference` field names, one hop, never rich (contract §7.8).
  */
-export const RECORD_SOURCE = /^record\.(?:id|url|(?:html\.|money\.)?fld_[0-9a-f]{16})$/;
+export const RECORD_SOURCE = /^record\.(?:id|url|(?:html\.|money\.)?fld_[0-9a-f]{16}|(?:money\.)?agg\.[a-z][a-zA-Z0-9_]{0,31}|(?:money\.)?ref\.fld_[0-9a-f]{16}\.fld_[0-9a-f]{16})$/;
+/** recordContext.ts parseRecordRefAxis — `ref.<referenceFid>.<targetFid>`, else null. */
+export function parseRecordRefAxis(axis) {
+    const m = /^ref\.(fld_[0-9a-f]{16})\.(fld_[0-9a-f]{16})$/.exec(axis);
+    return m ? { ref: m[1], field: m[2] } : null;
+}
+/** recordContext.ts RECORD_REF_TARGET_TYPES — what a `ref.<a>.<b>` tile may show. */
+export const RECORD_REF_TARGET_TYPES = new Set(['text', 'select', 'url', 'date', 'number', 'integer', 'boolean', 'tags']);
+/**
+ * RECORD LINK PARAMETERS (contract §7.6, schema/src/elements/hrefParams.ts).
+ * `specials.hrefParams: [{name, source}]` appends row values to a same-site
+ * `specials.href`; every malformed entry is DROPPED at render, never repaired.
+ */
+export const HREF_PARAM_NAME = /^[a-z][a-z0-9_]{0,23}$/;
+export const HREF_PARAM_SOURCE = /^record\.(?:id|url|fld_[0-9a-f]{16})$/;
+export const HREF_PARAM_RESERVED = new Set(['lang', 's', 't', 'lesson']);
+export const MAX_HREF_PARAMS = 8;
+/** hrefParams.ts isSameSitePath — the only hrefs params are appended to. */
+export function isSameSitePath(p) {
+    if (!p.startsWith('/') || p[1] === '/' || p[1] === '\\')
+        return false;
+    return ![...p].some((c) => c.charCodeAt(0) <= 0x20 || c.charCodeAt(0) === 0x7f || c === '\\');
+}
+/** Why entries of `hrefParams` would be dropped at render (hrefWithParams), in the renderer's own order. */
+export function hrefParamProblems(raw) {
+    if (raw === undefined || (Array.isArray(raw) && !raw.length))
+        return [];
+    if (!Array.isArray(raw))
+        return ['specials.hrefParams is not an array of { name, source }'];
+    const out = [];
+    if (raw.length > MAX_HREF_PARAMS)
+        out.push(`only the first ${MAX_HREF_PARAMS} entries are read — ${raw.length - MAX_HREF_PARAMS} more are ignored`);
+    const seen = new Set();
+    for (const item of raw.slice(0, MAX_HREF_PARAMS)) {
+        const { name, source } = (item ?? {});
+        if (typeof name !== 'string') {
+            out.push('an entry has no string name');
+            continue;
+        }
+        if (seen.has(name)) {
+            out.push(`"${name}" is named twice — only the first entry is read`);
+            continue;
+        }
+        seen.add(name);
+        if (!HREF_PARAM_NAME.test(name))
+            out.push(`name "${name}" is not ^[a-z][a-z0-9_]{0,23}$`);
+        else if (HREF_PARAM_RESERVED.has(name))
+            out.push(`name "${name}" is reserved (lang, s, t, lesson are read by the platform)`);
+        else if (typeof source !== 'string' || !HREF_PARAM_SOURCE.test(source))
+            out.push(`"${name}"'s source "${String(source)}" is not record.id, record.url or record.fld_<16 hex>`);
+    }
+    return out;
+}
+/** An aggregate key — recordAggregates.ts RECORD_AGG_KEY. A tile names it as `agg.<key>`. */
+export const RECORD_AGG_KEY = /^[a-z][a-zA-Z0-9_]{0,31}$/;
+const RECORD_PARAM_NAME = /^[a-z][a-z0-9_]{0,23}$/;
+const COLLECTION_ID = /^col_[0-9a-f]{16}$/;
+export const recordAggKeyOf = (axis) => {
+    const key = axis.startsWith('agg.') ? axis.slice(4) : '';
+    return RECORD_AGG_KEY.test(key) ? key : '';
+};
+/**
+ * `config.recordAggregates` read the way the platform does
+ * (recordAggregates.ts readRecordAggregates): [] for none, null when MALFORMED —
+ * the server then refuses the list and it publishes EMPTY.
+ */
+export function readRecordAggregates(raw) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (!Array.isArray(raw) || raw.length > 4)
+        return null;
+    const s = (v) => (typeof v === 'string' ? v : '');
+    const seen = new Set();
+    const out = [];
+    for (const a of raw) {
+        if (!a || typeof a !== 'object')
+            return null;
+        const op = s(a.op);
+        const field = s(a.recordField);
+        const whenNone = a.whenNone == null || a.whenNone === '' ? 'hide' : s(a.whenNone);
+        if (!RECORD_AGG_KEY.test(s(a.key)) ||
+            seen.has(s(a.key)) ||
+            !['min', 'max', 'count'].includes(op) ||
+            !COLLECTION_ID.test(s(a.recordCollectionId)) ||
+            !RECORD_FIELD_ID.test(s(a.recordRelationField)) ||
+            (op === 'count' ? field !== '' : !RECORD_FIELD_ID.test(field)) ||
+            !['hide', 'show'].includes(whenNone)) {
+            return null;
+        }
+        const where = a.where ?? [];
+        if (!Array.isArray(where) || where.length > 4)
+            return null;
+        const conds = [];
+        for (const c of where) {
+            const per = s(c?.per);
+            if (!c || !RECORD_FIELD_ID.test(s(c.recordField)) || c.op !== 'gte' || !RECORD_PARAM_NAME.test(s(c.param)) || (per !== '' && !RECORD_PARAM_NAME.test(per))) {
+                return null;
+            }
+            conds.push({ param: s(c.param), ...(per ? { per } : {}) });
+        }
+        seen.add(s(a.key));
+        out.push({ key: s(a.key), op, where: conds, whenNone });
+    }
+    return out;
+}
+/** The visitor params a list's aggregates read (`param.<name>` axes it accepts). */
+export const recordAggregateParams = (aggs) => new Set(aggs.flatMap((a) => a.where.flatMap((c) => (c.per ? [c.param, c.per] : [c.param]))));
 /** 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. */
@@ -35,8 +143,11 @@ export function recordTileBindings(type, config, rows) {
     if (!RECORD_TILES.has(type))
         return rows;
     const fid = config.recordField;
-    const ok = typeof fid === 'string' && RECORD_FIELD_ID.test(fid);
     const html = type === 'text-dataset' && config.recordFieldType === 'richtext';
+    // An aggregate (`agg.<key>`) is a number on the row — datasetBindings.ts recordSource.
+    // A referenced record's field (`ref.<a>.<b>`) — one hop, never rich.
+    const ok = typeof fid === 'string' &&
+        (RECORD_FIELD_ID.test(fid) || (!html && (recordAggKeyOf(fid) !== '' || parseRecordRefAxis(fid) !== null)));
     // 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) => {
@@ -84,15 +195,35 @@ export function recordScope(nodeAt, id) {
  * stringification is recordContext.ts: gallery emits nothing yet, richtext only
  * under `record.html.`, every other type only under `record.`.
  */
-export function recordFieldProblem(source, scope) {
+export function recordFieldProblem(source, scope, 
+/** The fields of each collection a scope `reference` field targets, by collection id (§7.8). */
+refFields = {}) {
     if (!scope.length) {
         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' || source === 'record.url')
         return undefined;
+    // An aggregate is checked against the list's recordAggregates (sb_review), not a field.
+    if (/^record\.(?:money\.)?agg\./.test(source))
+        return undefined;
     const html = source.startsWith('record.html.');
     const money = source.startsWith('record.money.');
     const fid = source.slice(html ? 12 : money ? 13 : 7);
+    const ref = parseRecordRefAxis(fid);
+    if (ref) {
+        const r = scope.flatMap((s) => s.fields).find((x) => x.id === ref.ref);
+        if (!r || r.type !== 'reference')
+            return `${ref.ref} is not a reference field of the collection(s) this row reads.`;
+        const target = r.refCollectionId ?? '';
+        const t = (refFields[target] ?? []).find((x) => x.id === ref.field);
+        if (!t)
+            return `${ref.field} is not a field of ${target || 'the referenced collection'} (what ${r.key} points at).`;
+        if (!RECORD_REF_TARGET_TYPES.has(t.type))
+            return `${ref.field} (${t.key}) is ${t.type} — a referenced field shows only ${[...RECORD_REF_TARGET_TYPES].join(', ')}.`;
+        if (money && !RECORD_MONEY_TYPES.has(t.type))
+            return `${ref.field} (${t.key}) is ${t.type} — record.money. formats only a number or integer field.`;
+        return undefined;
+    }
     const f = scope.flatMap((s) => s.fields).find((x) => x.id === fid);
     if (!f) {
         const avail = scope

package/dist/domains/site/review.js

@@ -7,9 +7,9 @@ import { SEED_COPY_VI, langOf } from './seedcopy.js';
 import { HOVER_STATE, hoverHome } from './hover.js';
 import { ELEMENTS, BINDING_SOURCES, BOUND_SPECIALS, FIRST_CHILD_ONLY, SATELLITE_RULES, ELEMENT_SEEDS } from '../../catalog/elements.generated.js';
 import { fill } from './findings.js';
-import { isRecordSource, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES } from './record.js';
+import { hrefParamProblems, isRecordSource, isSameSitePath, parseRecordRefAxis, readRecordAggregates, recordAggKeyOf, recordAggregateParams, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES, recordScope, } from './record.js';
 import { formFieldFindings } from './formdoc.js';
-import { deadNavigation, liveEventTable, PAYLOAD_NEEDS } from './navhref.js';
+import { deadNavigation, hasPurchaseBinding, liveEventTable, PAYLOAD_NEEDS, soleNavigationClick } from './navhref.js';
 import { unknownValueNote, unknownWriteNote, vocabularyFor, vocabularyForWrite } from './vocabulary.js';
 import { iconNote } from './icons.js';
 /**
@@ -705,6 +705,62 @@ opts = {}) {
                     });
                 }
             }
+            // AGGREGATES OVER A RELATION (web_builder #162, contract §7.5). A malformed
+            // definition makes the server refuse the WHOLE list — it publishes empty; a
+            // "hide" aggregate drops every row nothing fits, so the list needs its empty state.
+            if (type === 'list-dataset' && cfg.datasetSource === 'record' && cfg.recordAggregates !== undefined) {
+                const aggs = readRecordAggregates(cfg.recordAggregates);
+                const empty = d.nodes[String(cfg.emptyStateId ?? '')]?.data.type === 'list-empty';
+                if (aggs === null || (aggs.some((a) => a.whenNone === 'hide') && !empty)) {
+                    out.push({
+                        code: 'record_aggregate_invalid',
+                        nodeId: id,
+                        type,
+                        problem: aggs === null
+                            ? 'config.recordAggregates is malformed (a bad key, op, id, condition or more than 4) — the server refuses the list and it publishes EMPTY.'
+                            : 'An aggregate with whenNone "hide" drops every row nothing fits, and this list has no empty state — a visitor whose search fits nothing sees a blank band.',
+                        fix: fill('record_aggregate_invalid', { id }),
+                    });
+                }
+            }
+            // BOOKING ESTIMATE (web_builder #161, contract §7.4): its operands are NODE IDS of
+            // this form document. A wrong one leaves the line on its placeholder and the
+            // server stores no total — or skips a stay rule — with no error anywhere.
+            if (type === 'form-estimate') {
+                const sp = (n.specials ?? {});
+                const terms = Array.isArray(sp.estimateTerms) ? sp.estimateTerms : [];
+                const rules = Array.isArray(sp.estimateRules) ? sp.estimateRules : [];
+                const why = [];
+                const t = (x) => d.nodes[String(x ?? '')]?.data.type;
+                const cfgSrc = (x) => String((d.nodes[String(x ?? '')]?.config?.optionSource ?? '')).trim();
+                const isRecordSelect = (x) => t(x) === 'form-select' && cfgSrc(x) === 'record';
+                const isDate = (x) => t(x) === 'form-date' || t(x) === 'form-calendar';
+                if (terms.filter((x) => x.kind === 'record').length !== 1)
+                    why.push('it needs exactly ONE "record" term (the chosen room\'s price)');
+                for (const x of terms) {
+                    if (x.kind === 'record' && (!isRecordSelect(x.node) || !RECORD_FIELD_ID.test(String(x.field ?? ''))))
+                        why.push(`record term: node "${String(x.node ?? '')}" must be a record-sourced form-select and field a fld_ id`);
+                    if (x.kind === 'nights' && (!isDate(x.start) || !isDate(x.end)))
+                        why.push('nights term: start and end must be date fields of this form');
+                    if (x.kind === 'number' && t(x.node) !== 'form-number')
+                        why.push(`number term: "${String(x.node ?? '')}" is not a form-number`);
+                }
+                for (const r of rules) {
+                    if ((r.kind === 'dateRange' || r.kind === 'maxNights') && (!isDate(r.start) || !isDate(r.end)))
+                        why.push(`${String(r.kind)} rule: start and end must be date fields of this form`);
+                    if (r.kind === 'capacity' && (!isRecordSelect(r.node) || !RECORD_FIELD_ID.test(String(r.field ?? '')) || t(r.count) !== 'form-number' || (r.per && t(r.per) !== 'form-number')))
+                        why.push('capacity rule: node must be a record select, field a fld_ id, count (and per) form-number fields');
+                }
+                if (why.length) {
+                    out.push({
+                        code: 'estimate_invalid',
+                        nodeId: id,
+                        type,
+                        problem: `A booking estimate that shows no total or skips a stay rule: ${[...new Set(why)].join('; ')}.`,
+                        fix: fill('estimate_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.
             {
@@ -716,11 +772,23 @@ opts = {}) {
                 });
                 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`);
+                    const cfgOf = (t) => d.nodes[t].config ?? {};
+                    // web_builder #162: an axis may also be an aggregate (`agg.<key>`, a budget) or a
+                    // visitor param (`param.<name>`) — both must exist on EVERY targeted list.
+                    const axis = String(sp.filterAxis ?? '');
+                    const aggsOf = (t) => readRecordAggregates(cfgOf(t).recordAggregates) ?? [];
+                    if (axis.startsWith('agg.') || axis.startsWith('param.')) {
+                        const key = axis.startsWith('agg.') ? recordAggKeyOf(axis) : axis.slice(6);
+                        const has = (t) => axis.startsWith('agg.') ? aggsOf(t).some((a) => a.key === key) : recordAggregateParams(aggsOf(t)).has(key);
+                        if (!key || !recordTargets.length || !recordTargets.every(has))
+                            why.push(`filterAxis "${axis}" names no aggregate or param of its target list's config.recordAggregates`);
+                        if (axis.startsWith('param.') && sp.filterArity !== undefined && sp.filterArity !== 'single')
+                            why.push(`a param axis holds ONE value — filterArity "${String(sp.filterArity)}" lets a visitor tick two and empties the list`);
+                    }
+                    else if (!RECORD_FIELD_ID.test(axis))
+                        why.push(`filterAxis "${axis}" 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)
@@ -731,9 +799,9 @@ opts = {}) {
                 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));
+                        .filter((v) => !/^(?:fld_[0-9a-f]{16}|agg\.[a-z][a-zA-Z0-9_]{0,31})_(?: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`);
+                        why.push(`sort values ${bad.slice(0, 3).map((v) => `"${v}"`).join(', ')} are not "<fieldId>_asc|desc" or "agg.<key>_asc|desc" — a record list ignores product sort keys`);
                 }
                 if (why.length) {
                     out.push({
@@ -745,9 +813,86 @@ opts = {}) {
                     });
                 }
             }
+            // RECORD LINK PARAMETERS and VISITOR FAVORITES (web_builder v1.0.174, contract §7.6/§7.7).
+            // Both read the record of the row they sit in — or the page's, on a record page.
+            {
+                const sp = (n.specials ?? {});
+                const nodeAt = (x) => d.nodes[x];
+                let list = n.data.parent;
+                while (list && d.nodes[list] && d.nodes[list].data.type !== 'list-dataset')
+                    list = d.nodes[list].data.parent;
+                const hasRecord = recordScope(nodeAt, id).length > 0 || (opts.pageType === 'record' && !list);
+                const evs = n.events ?? [];
+                const binds = n.bindings ?? [];
+                const params = sp.hrefParams;
+                if (Array.isArray(params) ? params.length > 0 : params !== undefined) {
+                    const why = hrefParamProblems(params);
+                    // A bound path (record.url) is the platform's own same-site address.
+                    const boundHref = binds.some((b) => b?.field === 'specials.href');
+                    if (!boundHref && !isSameSitePath(String(sp.href ?? '')))
+                        why.push(`specials.href "${String(sp.href ?? '')}" is not a same-site path ("/…"), so no param is ever added`);
+                    if (why.length)
+                        out.push({ code: 'href_params_invalid', nodeId: id, type, problem: `Link parameters the renderer drops: ${why.join('; ')}.`, fix: fill('href_params_invalid', { id }) });
+                    if (!hasRecord)
+                        out.push({
+                            code: 'href_params_unresolved',
+                            nodeId: id,
+                            type,
+                            problem: 'specials.hrefParams on a node in no record-list row and not on a record page — no record supplies a value, so the link carries no params.',
+                            fix: fill('href_params_unresolved', { id }),
+                        });
+                    const purchase = hasPurchaseBinding(binds);
+                    if (purchase || (evs.some((e) => e?.name === 'click') && !soleNavigationClick(evs, false)))
+                        out.push({
+                            code: 'href_params_stranded',
+                            nodeId: id,
+                            type,
+                            problem: `specials.hrefParams are not applied: ${purchase ? 'the node is purchase-bound' : 'its click is not ONE Open page / Go to URL action'}, so the href never renders as the link.`,
+                            fix: fill('href_params_stranded', { id }),
+                        });
+                }
+                for (const ev of evs) {
+                    if (ev?.name !== 'click')
+                        continue;
+                    const why = [];
+                    if (ev.action === 'toggle_record_favorite' && !hasRecord)
+                        why.push('the heart sits in no record-list row and not on a record page, so it publishes nothing');
+                    if (ev.action === 'show_record_favorites') {
+                        const p = ev.payload ?? {};
+                        const t = String(p.targetId ?? '');
+                        const tc = d.nodes[t]?.config;
+                        if (t && (d.nodes[t]?.data.type !== 'list-dataset' || tc?.datasetSource !== 'record'))
+                            why.push(`targetId "${t}" is not a record list on this page`);
+                        else if (t && String(tc?.recordRelationField ?? ''))
+                            why.push(`targetId "${t}" is a relation list, which ignores favorites`);
+                        if (p.view !== 'favorites' && p.view !== 'all')
+                            why.push(`view "${String(p.view)}" is neither "favorites" nor "all"`);
+                    }
+                    if (why.length)
+                        out.push({ code: 'record_favorite_invalid', nodeId: id, type, problem: `Its "${String(ev.action)}" does nothing: ${why.join('; ')}.`, key: String(ev.action), fix: fill('record_favorite_invalid', { id }) });
+                }
+            }
             if (RECORD_TILES.has(type) && cfg.datasetSource === 'record') {
                 const fid = cfg.recordField;
-                if (typeof fid !== 'string' || !RECORD_FIELD_ID.test(fid)) {
+                const aggKey = typeof fid === 'string' ? recordAggKeyOf(fid) : '';
+                let aggOk = false;
+                if (aggKey) {
+                    let up = n.data.parent;
+                    while (up && d.nodes[up] && d.nodes[up].data.type !== 'list-dataset')
+                        up = d.nodes[up].data.parent;
+                    const lc = up ? d.nodes[up].config : undefined;
+                    aggOk = (readRecordAggregates(lc?.recordAggregates) ?? []).some((a) => a.key === aggKey);
+                }
+                if (aggKey && !aggOk) {
+                    out.push({
+                        code: 'record_field_unset',
+                        nodeId: id,
+                        type,
+                        problem: `config.recordField "${String(fid)}" names an aggregate its record list does not define in config.recordAggregates — it renders its placeholder on every row.`,
+                        fix: fill('record_field_unset', { id }),
+                    });
+                }
+                else if (!aggKey && (typeof fid !== 'string' || (!RECORD_FIELD_ID.test(fid) && !parseRecordRefAxis(fid)))) {
                     out.push({
                         code: 'record_field_unset',
                         nodeId: id,

package/dist/tools/live.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { text, images } from '../mcp/response.js';
 import { BINDING_SOURCES, ELEMENTS } from '../catalog/elements.generated.js';
 import { bindableFields } from '../domains/site/writecheck.js';
-import { isRecordSource, RECORD_HTML_SOURCE, RECORD_SOURCE, recordFieldProblem, recordScope, } from '../domains/site/record.js';
+import { isRecordSource, parseRecordRefAxis, RECORD_HTML_SOURCE, RECORD_SOURCE, recordFieldProblem, recordScope, } from '../domains/site/record.js';
 import { previewUrl } from '../vision/preview.js';
 import { uploadMedia } from '../transport/media.js';
 import { request } from '../transport/http.js';
@@ -69,7 +69,8 @@ export function bindNode(doc, id, source, field, action, guard) {
         if (!RECORD_SOURCE.test(source)) {
             throw new Error(`sbuilder: "${source}" names no record field. A record source is "record.fld_<16 hex>" ` +
                 '(or "record.html.fld_<16 hex>" for a richtext field) — the field ID from ' +
-                'GET …/collections/{id}/fields, never its key — or "record.id", the row\'s own record id; ' +
+                'GET …/collections/{id}/fields, never its key — or "record.id", the row\'s own record id, or ' +
+                '"record.ref.<reference fld_>.<target fld_>" (and its record.money.ref. form), a field of the record a reference names; ' +
                 'anything else binds nothing.');
         }
         // record.html.<fid> is HTML: in a text sink its tags print as text.
@@ -771,10 +772,27 @@ export function registerLiveTools(server, ctx, session) {
                     throw new Error(`sbuilder: could not read the fields to check "${source}" against: ${msg}`);
                 });
             }
+            // A REFERENCED record's field (contract §7.8): its target is a field of the
+            // reference's refCollectionId, so that collection's fields are read too.
+            const refFields = {};
+            const ref = parseRecordRefAxis(source.replace(/^record\.(?:money\.)?/, ''));
+            const target = ref && withFields?.flatMap((s) => s.fields).find((f) => f.id === ref.ref)?.refCollectionId;
+            if (target) {
+                try {
+                    const got = (await get(`/collections/${encodeURIComponent(target)}/fields`));
+                    refFields[target] = got.fields ?? [];
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    soft(guard, () => {
+                        throw new Error(`sbuilder: could not read ${target}'s fields to check "${source}" against: ${msg}`);
+                    });
+                }
+            }
             if (withFields) {
                 const fields = withFields;
                 soft(guard, () => {
-                    const why = recordFieldProblem(source, fields);
+                    const why = recordFieldProblem(source, fields, refFields);
                     if (why)
                         throw new Error(`sbuilder: ${why}`);
                 });

package/package.json

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