sbuilder-mcp 0.92.0 → 0.93.0

package/CHANGELOG.md

@@ -6,6 +6,19 @@ 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.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,19 @@ 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.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/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": 5992,
+    "identifiers": 110190,
+    "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 = {
@@ -9846,6 +9846,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 +43066,7 @@ export const ELEMENTS = {
                 "recordFilterField": "",
                 "recordFilterValue": "",
                 "recordRelationField": "",
+                "recordAggregates": [],
                 "itemsPerRow": 4,
                 "collectionType": "all_products",
                 "collectionId": "all_products",
@@ -44025,6 +44174,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44067,6 +44217,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44117,6 +44268,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44169,6 +44321,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44211,6 +44364,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44399,6 +44553,7 @@ export const ELEMENTS = {
             "recordFilterField",
             "recordFilterValue",
             "recordRelationField",
+            "recordAggregates",
             "itemsPerRow",
             "listNavIcon",
             "listNavPosition",
@@ -44511,6 +44666,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 +45736,7 @@ export const BINDING_SOURCES = [
     "site.supportEmail",
     "site.supportPhone",
     "site.tiktok",
+    "site.timezone",
     "site.youtube"
 ];
 export const BOUND_SPECIALS = {
@@ -45771,6 +45928,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": {
@@ -50199,6 +50417,7 @@ export const BASE_ONLY_CONFIG = [
     "backgroundSceneModelUrl",
     "rowLimit",
     "optionSource",
+    "recordAggregates",
     "recordCollectionId",
     "recordField",
     "recordFieldType",

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": {

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": "e909f77a5b8c33c635657cc906e45b99f6d253d8",
+    "committedAt": "2026-10-26T17:18:35+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": 182,
     "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",
@@ -522,6 +528,7 @@ export const NEVER_TRANSLATED = [
     "showPercent",
     "showPhone",
     "showPlaceholder",
+    "siteTimezone",
     "source",
     "sourceCode",
     "sourceFlashSale",
@@ -1129,6 +1136,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 ' +

package/dist/domains/site/record.js

@@ -15,7 +15,61 @@ export const RECORD_FIELD_ID = /^fld_[0-9a-f]{16}$/;
  * `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|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})$/;
+/** 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 +89,9 @@ 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.
+    const ok = typeof fid === 'string' && (RECORD_FIELD_ID.test(fid) || (!html && recordAggKeyOf(fid) !== ''));
     // 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) => {
@@ -90,6 +145,9 @@ export function recordFieldProblem(source, scope) {
     }
     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);

package/dist/domains/site/review.js

@@ -7,7 +7,7 @@ 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 { isRecordSource, readRecordAggregates, recordAggKeyOf, recordAggregateParams, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES, } from './record.js';
 import { formFieldFindings } from './formdoc.js';
 import { deadNavigation, liveEventTable, PAYLOAD_NEEDS } from './navhref.js';
 import { unknownValueNote, unknownWriteNote, vocabularyFor, vocabularyForWrite } from './vocabulary.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({
@@ -747,7 +815,25 @@ opts = {}) {
             }
             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))) {
                     out.push({
                         code: 'record_field_unset',
                         nodeId: id,

package/package.json

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