@parity/product-lab 0.1.1 → 0.1.2

package/entrypoints/mcp/README.md

@@ -202,3 +202,6 @@ the file. Neither live script is part of the unit suite.
 
 The reload test creates its ES-module lab in an OS temporary directory, linking this package's `node_modules`.
 Concurrent lint can no longer discover a generated lab under the repository's `tests/` without a TypeScript project.
+
+Design-resource hashes track the current topic text, including the distinction between passive frames-only
+capture and awaited video capture at feature boundaries.

package/entrypoints/panel/README.md

@@ -417,9 +417,10 @@ Every running actor's app tile has a compact, browser-like address bar in the co
   (`data-frame`), so a re-created frame never receives an old frame's address. The bar never shows a guessed location.
 
 Tests: `node --import tsx --test entrypoints/panel/tests/address-bar.test.ts` (served shell, headless Chromium,
-loopback fixture apps on ephemeral ports; a normal tab and the lab window via `openLabWindow`, including real
-`framenavigated` reports and the acting guard). Optional `ADDRESS_BAR_SCREENS=<directory>` writes review screenshots
-(unset: none).
+loopback fixture apps on ephemeral ports that count browser requests by `Sec-Fetch-Dest`, which Chromium sends
+to these loopback origins, ignoring a local port probe without that header;
+a normal tab and the lab window via `openLabWindow`, including real `framenavigated` reports and the acting guard).
+Optional `ADDRESS_BAR_SCREENS=<directory>` writes review screenshots (unset: none).
 
 ## Visible execution: `@product-lab/shell/visible`
 
@@ -1771,3 +1772,5 @@ Framing reuse (item82): the framing section above retains the original item66 be
 The drawer puts its existing tabs in a full-width row below the title and Close control. Tabs wrap at narrow widths, keeping Recordings reachable without replacing the live app frame. Watch controls the displayed app in a window opened through `openLabWindow`; the server can keep running in the background while that window remains visible.
 
 Opening a recording displays its captured screenshots over the mounted app, with Play/Pause and previous/next screenshot controls. The viewer labels its fixed1.5s image cadence and absence of video; it cannot recover typing or clicks between captures. Back to live restores the app and run controls. Active runs are checked before and after loading the recording, using the latest panel snapshot. The run audit remains available even with zero recorded steps, and incomplete audits explicitly explain that proof is missing.
+
+Recording captures of tiles and detached windows honor `CaptureOptions.loadComplete` before taking their image and report `loadComplete: true` when checked. Only video feature after-frame checks request this wait; normal captures retain their existing policy. Tests: `tests/window-frames.test.ts` and `tests/detached-identities.test.ts`.

package/entrypoints/panel/src/visible/detached-identities.js

@@ -195,6 +195,10 @@ export function detachedFrameCapture(tiles, detached, options = {}) {
             const timeoutMs = captureOptions?.timeoutMs ?? options.timeoutMs ?? DETACHED_CAPTURE_TIMEOUT_MS;
             if (signal?.aborted)
                 throw new Error(`${window.actor.name}'s detached window was not captured: the recorder stopped waiting`);
+            if (captureOptions?.loadComplete) {
+                await window.app.waitForFunction(() => document.readyState === "complete", undefined, { timeout: timeoutMs });
+                signal?.throwIfAborted();
+            }
             const started = Date.now();
             const unsettled = captureOptions?.settled?.selectors.length ? await settle(window.app, captureOptions.settled) : undefined;
             if (unsettled)
@@ -211,7 +215,7 @@ export function detachedFrameCapture(tiles, detached, options = {}) {
                     throw new Error(`${window.actor.name}'s detached window gave no frame within ${timeoutMs} ms`, { cause: error });
                 throw new Error(`${window.actor.name}'s detached window could not be captured: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
             }
-            return { status: "captured", mediaType: "image/png", bytes: new Uint8Array(bytes), ...settled };
+            return { status: "captured", mediaType: "image/png", bytes: new Uint8Array(bytes), ...settled, ...(captureOptions?.loadComplete ? { loadComplete: true } : {}) };
         },
     };
 }

package/entrypoints/panel/src/visible/window-frames.js

@@ -13,6 +13,19 @@ export function windowFrameCapture(page, frameSelector, media, videos, uiCalls)
         video: () => windowVideo(page, videos, { source: "lab-window", scope: "window" }),
         async capture(actorId, options) {
             const selector = frameSelector(actorId);
+            if (options?.loadComplete) {
+                const element = await page.locator(selector).elementHandle({ timeout: options.timeoutMs });
+                try {
+                    const app = await element?.contentFrame();
+                    if (!app)
+                        return { status: "unavailable", reason: "The displayed app has no current document" };
+                    await app.waitForLoadState("load", { timeout: options.timeoutMs });
+                }
+                finally {
+                    await element?.dispose();
+                }
+                options.signal?.throwIfAborted();
+            }
             const started = Date.now();
             const unsettled = options?.settled?.selectors.length ? await settle(page.frameLocator(selector), options.settled) : undefined;
             if (unsettled)
@@ -45,7 +58,7 @@ export function windowFrameCapture(page, frameSelector, media, videos, uiCalls)
                     const bytes = await cutInWorker(await shot, view.width, { rect: { x, y, width, height } });
                     const after = await page.evaluate(steadyFrameBox, { selector, settleMs: 0 });
                     if (!("moving" in after) && sameBox(after, box))
-                        return { status: "captured", mediaType: "image/png", bytes: new Uint8Array(bytes), ...settled };
+                        return { status: "captured", mediaType: "image/png", bytes: new Uint8Array(bytes), ...settled, ...(options?.loadComplete ? { loadComplete: true } : {}) };
                 }
                 finally {
                     if (!shot)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-lab",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Run and test Polkadot products against real local chains, hosts and browsers: the framework and the product-lab CLI.",
   "license": "Apache-2.0",