sbuilder-mcp 0.38.0 → 0.38.2

package/CHANGELOG.md

@@ -6,6 +6,17 @@ 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.38.2] - 2026-09-11
+
+### Added
+- sb_traits_for's config_values for list-dataset now lists a sixth config.collectionType value, page_collection, which renders the collection the page itself resolves to (the one a /collections/{slug} URL names), so one collection template can serve every collection explicitly instead of relying on all_products to narrow itself.
+
+## [0.38.1] - 2026-09-11
+
+### Fixed
+- sb_look no longer photographs a reveal-on-scroll band (config.animation trigger:"view") as blank; every animation is now stopped before the shutter opens, since the lazy-image walk returns to the top of the page and would otherwise catch the band back at its opacity:0 starting keyframe.
+- sb_import and sb_import_site no longer drop a `<video>` element that carries a poster image and no explicit width/height, which previously measured as a zero-size box and was skipped like a genuinely hidden element.
+
 ## [0.38.0] - 2026-09-11
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,17 @@ 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.38.2] - 2026-09-11
+
+### Added
+- config_values của sb_traits_for dành cho list-dataset giờ liệt kê thêm giá trị thứ sáu của config.collectionType, page_collection, giá trị này render đúng collection mà trang tự phân giải tới (collection được đặt tên bởi một URL /collections/{slug}), nhờ đó một collection template có thể phục vụ mọi collection một cách tường minh thay vì dựa vào all_products tự thu hẹp phạm vi.
+
+## [0.38.1] - 2026-09-11
+
+### Fixed
+- sb_look không còn chụp một band hiệu ứng xuất hiện khi cuộn (config.animation trigger:"view") thành ảnh trống nữa; mọi animation giờ được dừng lại trước khi chụp, vì bước quét ảnh lazy-load quay về đầu trang và trước đây sẽ bắt band đó đứng yên ở keyframe khởi đầu opacity:0.
+- sb_import và sb_import_site không còn bỏ sót phần tử `<video>` có ảnh poster nhưng không khai báo width/height tường minh, trước đây phần tử này đo được kích thước bằng 0 nên bị bỏ qua như một phần tử thực sự ẩn.
+
 ## [0.38.0] - 2026-09-11
 
 ### Added

package/dist/catalog/elements.generated.js

@@ -32993,7 +32993,7 @@ export const ELEMENTS = {
             "Always add exactly one dataset-block child as the repeated item template; every row clones that exact structure and styling",
             "The dataset-block template — and every dataset node inside it — must carry the SAME config.datasetSource as this repeater. Each node reads its OWN key, so a collection list whose card omits it leaves that card on the product default: it binds product.url, no product context reaches a collection row, and the card publishes with no link, so clicking it does nothing",
             "config.datasetSource picks the ENTITY: \"product\" for a product list, \"category\" for a collection list. It is what derives the node's binding target (product::product_list / category::collection_list)",
-            "Product lists: config.collectionType \"all_products\" renders the whole catalog, \"collection\" renders the one named by config.collectionId, \"related\" renders the PAGE PRODUCT's neighbours — the products sharing one of its collections, minus itself",
+            "Product lists: config.collectionType \"page_collection\" renders THE COLLECTION THE PAGE IS (the one /collections/{slug} named) so a single collection template serves every collection, \"all_products\" renders the whole catalog and narrows to the page collection on a collection template, \"collection\" renders the one named by config.collectionId, \"related\" renders the PAGE PRODUCT's neighbours — the products sharing one of its collections, minus itself",
             "Use \"related\" for a cross-sell shelf on a product page (\"Sản phẩm liên quan\" / \"You may also like\"). It reads no collectionId — its axis is whatever collections the page product is filed under — and it renders nothing on a page that names no product, so pair it with an emptyStateId if the section must never be blank",
             "Collection lists: config.collectionListType \"all_collections\" renders every collection; \"custom_collections\" renders specials.collectionIds, in that order",
             "config.quantity caps how many records render; config.itemsPerRow is the row size (grid columns / slide page size) and style.gap is the space between cards — both are per-breakpoint",
@@ -36284,6 +36284,7 @@ export const CONFIG_VALUES = {
             "all_products",
             "collection",
             "featured",
+            "page_collection",
             "related",
             "slot"
         ],

package/dist/vision/capture.js

@@ -22,7 +22,24 @@ function capturePage(limits) {
         if (cs.display === 'none' || cs.visibility === 'hidden' || cs.opacity === '0')
             return false;
         const r = el.getBoundingClientRect();
-        return r.width > 0 && r.height > 0;
+        if (r.width > 0 && r.height > 0)
+            return true;
+        // A ZERO BOX MEANS "HIDDEN" ONLY FOR AN ELEMENT THAT SIZES ITSELF FROM ITS
+        // CONTENT. A `<video>` sizes itself from its MEDIA, and a `poster` is what
+        // it measures before any media loads — so a video whose poster has not
+        // resolved measures 0×0 while being perfectly present, and Chrome only
+        // falls back to 300×150 once that load has actually failed.
+        //
+        // MEASURED: `<video src poster>` with no explicit width/height was dropped
+        // with nothing but a `hidden` count, while the identical element carrying
+        // `width`/`height` — or carrying NO poster — came through. So the one video
+        // most worth importing, the one with a still frame on it, was the one that
+        // disappeared, and only on the pages slow enough for the race to be lost.
+        //
+        // Narrow on purpose: a `<video>` alone, and only when it names something to
+        // play or to show. An empty `<video></video>` is a genuinely empty box and
+        // goes on being skipped.
+        return el.tagName === 'VIDEO' && !!(el.getAttribute('src') || el.getAttribute('poster'));
     };
     const clean = (s) => (s ?? '').replace(/\s+/g, ' ').trim();
     // ABSOLUTE where it can be, RAW where it cannot. `new URL(rel, base)` throws

package/dist/vision/shoot.js

@@ -250,6 +250,42 @@ async function settleLazyImages(page) {
         .waitForFunction(() => [...document.querySelectorAll('img')].every((i) => i.complete === true), undefined, { timeout: 3_000 })
         .catch(() => { });
 }
+/**
+ * SETTLE EVERY ENTRANCE ANIMATION, or photograph a band that is not there.
+ *
+ * A still picture wants the page a visitor ends up looking at, and the settled
+ * state of every entrance animation is "visible". Two ways a correct page
+ * photographs BLANK without this, both of them new since the platform shipped
+ * 46 effects and a scroll trigger, and both silent:
+ *
+ *   - `trigger: "view"` compiles to `animation-timeline: view()`, whose progress
+ *     is a function of where the element sits in the scrollport. The walk above
+ *     scrolls and then RETURNS TO THE TOP, so every revealed section is back at
+ *     its `from` keyframe — `opacity: 0` — at the moment the shutter opens.
+ *     MEASURED: a four-band page photographed with the third band entirely
+ *     empty, the other three correct.
+ *   - `fill: both` applies the `from` keyframe during a `delay`, so a section
+ *     with a delay long enough to outlast the settle photographs blank too.
+ *
+ * The honest reading of either picture is "this band is broken", which sends
+ * the caller to fix a page that works — the same failure the lazy-image walk
+ * above exists to prevent, arriving by a different route that the walk cannot
+ * fix because the walk's own return to the top is what causes it.
+ *
+ * `animation: none` rather than forcing the timeline to `auto`: that one
+ * RESTARTS the animation against the document timeline and the shot catches it
+ * mid-flight (measured at opacity 0.317). Removing the animation drops the
+ * element to its own declared style, which for every entrance effect here is
+ * exactly the end state — measured back at opacity 1, with the band's text on
+ * screen.
+ *
+ * Best-effort: a page that refuses a stylesheet is still worth photographing.
+ */
+async function settleAnimations(page) {
+    await page
+        .addStyleTag({ content: '*,*::before,*::after{animation:none !important}' })
+        .catch(() => { });
+}
 async function shootOne(page, url, width, format, opts) {
     // LOAD, then a BOUNDED settle — never `networkidle` alone.
     //
@@ -287,6 +323,7 @@ async function shootOne(page, url, width, format, opts) {
     }
     await settleDom(page);
     await settleLazyImages(page);
+    await settleAnimations(page);
     // A RENDERED page carries its node ids as the HTML `id` attribute — not as
     // `data-node-id`, which is the editor CANVAS's hook and never reaches the
     // renderer. Selecting the canvas attribute here returned an empty box list

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.38.0",
+  "version": "0.38.2",
   "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",
@@ -28,6 +28,7 @@
     "start": "node dist/index.js",
     "smoke": "node dist/smoke.js",
     "test": "vitest run",
+    "test:browser": "SB_BROWSER_TEST=1 vitest run",
     "codegen": "tsx scripts/gen-catalog.ts",
     "prepublishOnly": "npm run build && npm run smoke",
     "release": "node scripts/release.mjs",