@juxtapose/core 0.9.0 → 0.11.0

package/dist/capture/idle.js

@@ -0,0 +1,558 @@
+// Event-driven settle: wait as long as the page still has work, not a fixed
+// quiet window.
+//
+// Replaces the 150 ms DOM-quiet window (capped at 500 ms) that ran on every
+// story. Measured in the settle spike (raw CDP replica of this pipeline, 5
+// runs per story, chrome-headless-shell 151.0.7922.34): byte-identical to the
+// quiet window on 29/29 example stories (Storybook 15, Ladle 14), stable 5/5,
+// settle p50 168 -> 39 ms (Storybook) and 162 -> 34 ms (Ladle). On adversarial
+// pages it captures the final state of setTimeout(300) and (800) and of a
+// fetch resolving after 200 ms, all of which the quiet window captured
+// mid-update (0/5), and it does not hang on a lazy image below the fold,
+// where the old uncapped image wait in `drain` never returned.
+//
+// Shipped, through the CLI (2026-10-13, Apple M5 Pro, 15 cores, load average
+// 15-18, median of 5, interleaved with main): `jux run --all` on the
+// Storybook example 1339 -> 653 ms (story p50 203 -> 75 ms), Ladle 1127 ->
+// 603 ms (208 -> 80 ms); a warm `jux snap` of one story 356 -> 209 ms. Every
+// default and variant capture (Storybook 18, Ladle 16) byte-identical to
+// baselines approved by the quiet-window build, fresh launch and daemon.
+//
+// Two halves. An init script, installed before any page script runs, counts
+// the page's own pending work: short timers, animation frames, posted
+// messages, DOM mutations, loading fonts and loading in-viewport images. CDP
+// Network events count in-flight requests, which the page cannot see for
+// itself (a fetch started before any wrapper could be installed, a <link>
+// stylesheet, an image the parser started). Idle is both at zero, re-checked
+// once more after a round trip because renderer and browser events are not
+// ordered against each other.
+//
+// Never throws: a wait that hits its cap is reported, and the page is captured
+// as it is. A slow story must produce a reviewable result, not abort a run.
+import { SendTimeoutError } from '../browser/cdp.js';
+import { matchPattern } from './settle-options.js';
+/**
+ * Runs before any page script (Page.addScriptToEvaluateOnNewDocument), so the
+ * wrappers are in place before a framework captures the natives. A library
+ * that re-patches them later (zone.js, Sentry) is still tracked as long as it
+ * calls through, which they do.
+ *
+ * String timer handlers pass straight through, untracked: wrapping them would
+ * need eval, which a page's CSP may forbid.
+ */
+const IDLE_INIT = `(function () {
+  if (window.__juxIdle) return;
+  var W = window;
+  var S = { timers: new Map(), rafs: new Set(), sent: 0, delivered: 0, workers: new Map(), mut: 0, ready: false };
+  var oST = W.setTimeout, oCT = W.clearTimeout, oSI = W.setInterval, oCI = W.clearInterval;
+  var oRAF = W.requestAnimationFrame, oCAF = W.cancelAnimationFrame, oPM = W.postMessage;
+  var PP = MessagePort.prototype, oPPM = PP.postMessage, oAEL = PP.addEventListener, oREL = PP.removeEventListener;
+
+  // Task hop on a private channel, created before MessagePort is patched so
+  // its own messages are never counted as the page's.
+  var hop = (function () { var ch = new MessageChannel(); var q = [];
+    ch.port1.onmessage = function () { var f = q.shift(); if (f) f(); };
+    return function (f) { q.push(f); oPPM.call(ch.port2, 0); }; })();
+
+  // Polls and clocks: a paced timer (delay >= 16 ms, a frame) re-armed from
+  // the same call site after an earlier one there fired counts only if the
+  // DOM changed since that fire. A poll that changes nothing (same function,
+  // fresh closure or arrow) stops counting after its first period; a chain
+  // that reveals something each step (retry with backoff, a typewriter, a
+  // staged reveal) is waited out. The site is the whole stack minus this
+  // wrapper, not the top frame, so a shared sleep() helper is a different site
+  // per caller. Mutations are flushed with takeRecords() so a re-arm sees the
+  // changes its own callback just made.
+  //
+  // Measured in the review's prototype (round 2): closure, arrow and
+  // same-function 200 ms polls settle in 440-453 ms unflagged (they pinned the
+  // 1500 ms cap before); a 3-step 100 ms self-chain, sleep() chains,
+  // timer-1200-chain, timeout-chain and the timeout-50/120/300/800 pages all
+  // capture their final state 3/3. A clock that repaints every tick still
+  // counts and hits the cap, flagged: it needs a mask either way. Faster
+  // re-arms (setTimeout(step, 0) chunked work) are never keyed and always count.
+  var PACED_MS = 16, sites = new Map(), MO = null;
+  var flushMut = function () { if (MO) S.mut += MO.takeRecords().length; };
+  W.setTimeout = function (fn, delay) {
+    if (typeof fn !== 'function') return oST.apply(W, arguments);
+    var args = Array.prototype.slice.call(arguments, 2); var d = Math.max(0, Number(delay) || 0); var id;
+    var key = null, counted = true;
+    if (d >= PACED_MS) {
+      key = (new Error().stack || '').split('\\n').slice(2).join('\\n');
+      var site = sites.get(key);
+      if (site && site.fired) { flushMut(); counted = S.mut !== site.mutAtFire; }
+    }
+    var cb = function () { S.timers.delete(id);
+      if (key !== null) { flushMut(); sites.set(key, { fired: true, mutAtFire: S.mut }); }
+      return fn.apply(W, args); };
+    id = oST.call(W, cb, d);
+    if (key !== null && !sites.has(key)) sites.set(key, { fired: false });
+    if (counted) S.timers.set(id, d);
+    return id;
+  };
+  W.clearTimeout = function (id) { S.timers.delete(id); return oCT.call(W, id); };
+  // An interval counts until its first tick only: it must not block forever.
+  W.setInterval = function (fn, delay) {
+    if (typeof fn !== 'function') return oSI.apply(W, arguments);
+    var args = Array.prototype.slice.call(arguments, 2); var d = Math.max(0, Number(delay) || 0); var id; var first = true;
+    var cb = function () { if (first) { first = false; S.timers.delete(id); } return fn.apply(W, args); };
+    id = oSI.call(W, cb, d); S.timers.set(id, d); return id;
+  };
+  W.clearInterval = function (id) { S.timers.delete(id); return oCI.call(W, id); };
+  // rAF re-armed from inside a rAF callback is an animation loop; stop counting
+  // after 3 generations or a canvas animation pins the wait at the cap
+  // (measured: a perpetual rAF loop settles in 35-40 ms with this).
+  var rafGen = 0;
+  W.requestAnimationFrame = function (fn) {
+    var gen = rafGen;
+    var id = oRAF.call(W, function (t) { S.rafs.delete(id); rafGen = gen + 1; try { return fn(t); } finally { rafGen = 0; } });
+    if (gen < 3) S.rafs.add(id); return id;
+  };
+  W.cancelAnimationFrame = function (id) { S.rafs.delete(id); return oCAF.call(W, id); };
+  // Posted messages (React's scheduler uses a MessageChannel): count sends
+  // and deliveries, each event once however many listeners see it. Pending
+  // is the difference; the waiter treats it as stale only when deliveries
+  // stop moving (a port nobody listens to), never while they continue (the
+  // review measured 40 x 5 ms of scheduler slices captured mid-render when
+  // a steady 1-in-flight count was read as stale).
+  var seen = new WeakSet();
+  var deliver = function (e) { if (e && typeof e === 'object') { if (seen.has(e)) return; seen.add(e); }
+    if (S.delivered < S.sent) S.delivered++; };
+  W.postMessage = function () { S.sent++; return oPM.apply(W, arguments); };
+  W.addEventListener('message', deliver, true);
+  var wrapped = new WeakMap();
+  var wrap = function (fn) { if (typeof fn !== 'function') return fn; var w = wrapped.get(fn);
+    if (!w) { w = function (e) { deliver(e); return fn.call(this, e); }; wrapped.set(fn, w); } return w; };
+  PP.postMessage = function () { S.sent++; return oPPM.apply(this, arguments); };
+  PP.addEventListener = function (type, fn, opt) { return oAEL.call(this, type, type === 'message' ? wrap(fn) : fn, opt); };
+  PP.removeEventListener = function (type, fn, opt) {
+    return oREL.call(this, type, type === 'message' && typeof fn === 'function' ? (wrapped.get(fn) || fn) : fn, opt); };
+  var onmsg = Object.getOwnPropertyDescriptor(PP, 'onmessage');
+  Object.defineProperty(PP, 'onmessage', { configurable: true,
+    get: function () { return onmsg.get.call(this); }, set: function (fn) { return onmsg.set.call(this, wrap(fn)); } });
+
+  // A dedicated Worker runs where this script can't see; its script request
+  // never completes on the page's session either. What is countable is the
+  // conversation: a message posted to the worker is pending until a message
+  // comes back, within the timer horizon of the post; and a new worker gets a
+  // 300 ms startup grace for unsolicited work, ended by its first message,
+  // error or terminate(). A silent worker (comlink-style, answering only when
+  // asked) cost ~1040 ms per capture when the whole horizon applied
+  // (review round 2); with the grace it costs at most 300 ms, and the 80 ms and
+  // 120 ms startup probes (worker-80, worker-delay) still capture their
+  // answer. Reflect.construct keeps "class X extends Worker" working.
+  var OW = W.Worker, wid = 0, STARTUP_MS = 300;
+  if (typeof OW === 'function') {
+    var JW = function Worker(url, opts) {
+      var w = Reflect.construct(OW, Array.prototype.slice.call(arguments), new.target || OW);
+      var id = ++wid; var rec = { t: performance.now(), src: String(url), started: true, posted: 0, replies: 0, lastPost: 0 };
+      rec.id = id; S.workers.set(id, rec); recs.set(w, rec);
+      w.addEventListener('message', function () { rec.started = false; if (rec.replies < rec.posted) rec.replies++; });
+      w.addEventListener('error', function () { rec.started = false; rec.replies = rec.posted; });
+      return w;
+    };
+    // On the prototype, not the instance, so a subclass's own overrides win.
+    var recs = new WeakMap(), WP = OW.prototype, oWPM = WP.postMessage, oWT = WP.terminate;
+    WP.postMessage = function () { var r = recs.get(this); if (r) { r.posted++; r.lastPost = performance.now(); } return oWPM.apply(this, arguments); };
+    WP.terminate = function () { var r = recs.get(this); if (r) S.workers.delete(r.id); return oWT.apply(this, arguments); };
+    JW.prototype = WP;
+    Object.setPrototypeOf(JW, OW);
+    W.Worker = JW;
+  }
+
+  MO = new MutationObserver(function (list) { S.mut += list.length; });
+  MO.observe(document, { childList: true, subtree: true, attributes: true, characterData: true });
+
+  // The page's half of settle.ready. Always defined under jux, so a page can
+  // call it unconditionally (window.__juxtapose?.ready() outside jux).
+  W.__juxtapose = { ready: function () { S.ready = true; } };
+
+  var pendingImages = function () {
+    var vh = W.innerHeight, vw = W.innerWidth, out = [];
+    Array.prototype.forEach.call(document.images, function (img) {
+      if (img.complete) return;
+      // A lazy image outside the viewport, or not rendered at all
+      // (display: none), never loads; waiting for it is what hung the old drain.
+      if (img.loading === 'lazy') { if (img.getClientRects().length === 0) return;
+        var r = img.getBoundingClientRect(); if (r.bottom < 0 || r.top > vh || r.right < 0 || r.left > vw) return; }
+      out.push(img.currentSrc || img.src || '(no src)');
+    });
+    return out;
+  };
+  var snapshot = function (horizon) {
+    var timers = 0; S.timers.forEach(function (d) { if (d <= horizon) timers++; });
+    var now = performance.now(), workers = [];
+    S.workers.forEach(function (w) {
+      if ((w.started && now - w.t <= STARTUP_MS) || (w.replies < w.posted && now - w.lastPost <= horizon)) workers.push(w.src); });
+    var imgs = pendingImages();
+    return { timers: timers, rafs: S.rafs.size, msgs: S.sent - S.delivered, delivered: S.delivered, mut: S.mut,
+      fonts: document.fonts.status, images: imgs.length, imageSrcs: imgs.slice(0, 3),
+      workers: workers.length, workerSrcs: workers.slice(0, 3), ready: S.ready };
+  };
+  // untracked: rerasterLayers (settle.ts) runs its own style toggles through
+  // this, so the mutation counter never sees them and a capture does not take
+  // the recheck path for jux's own writes. Page mutations queued before fn are
+  // counted first; fn's own records are dropped.
+  W.__juxIdle = { snapshot: snapshot, reset: function () { S.ready = false; },
+    untracked: function (fn) { flushMut(); var m = S.mut; try { return fn(); } finally { if (MO) MO.takeRecords(); S.mut = m; } } };
+
+  // Resolves 'idle' when two consecutive task hops each see no pending work
+  // and no mutation since the previous hop, or 'cap' at capMs.
+  W.__juxIdleWait = function (capMs, horizon, needReady) {
+    return new Promise(function (resolve) {
+      var t0 = performance.now(); var lastMut = -1; var lastDelivered = -1; var quiet = 0; var stale = 0; var done = false; var changing = false;
+      var finish = function (status, s) { if (done) return; done = true; oCT.call(W, capTimer);
+        s = s || snapshot(horizon); s.changing = changing;
+        resolve({ status: status, waitedMs: performance.now() - t0, snap: s }); };
+      var capTimer = oST.call(W, function () { finish('cap'); }, capMs);
+      var check = function () {
+        if (done) return;
+        var s = snapshot(horizon);
+        if (s.msgs > 0 && s.delivered === lastDelivered) stale++; else stale = 0; lastDelivered = s.delivered;
+        var msgsOk = s.msgs === 0 || stale >= 3;
+        var noWork = s.timers === 0 && s.rafs === 0 && msgsOk && s.workers === 0 && s.fonts !== 'loading' && s.images === 0 && (!needReady || s.ready);
+        changing = s.mut !== lastMut && lastMut !== -1;
+        var isQuiet = noWork && s.mut === lastMut;
+        lastMut = s.mut;
+        quiet = isQuiet ? quiet + 1 : 0;
+        if (quiet >= 2) return finish('idle', s);
+        if (noWork) hop(check);                                        // a mutation just happened: look again next task
+        else if (s.rafs > 0) oRAF.call(W, function () { hop(check); }); // sleep to the frame edge
+        else oST.call(W, check, 4);                                    // timer/font/image/worker/ready pending: poll cheaply
+      };
+      // First check after a frame: style and layout must run once before
+      // fonts and in-viewport images start loading.
+      oRAF.call(W, function () { hop(check); });
+    });
+  };
+})();`;
+/** Completed requests kept per document for `require`; past this a page is
+ *  a firehose and the oldest are dropped. */
+const MAX_DONE = 5000;
+/** In-flight and completed requests on one page, from CDP Network events. */
+export class NetworkTracker {
+    inflight = new Map();
+    done = [];
+    listeners = new Set();
+    /** In flight when the current story started on a warm switch: the last
+     *  story's, never this one's. */
+    excluded = new Set();
+    /** The committed main document's loader. */
+    mainLoader;
+    constructor(page, mainFrameId) {
+        page.on('Network.requestWillBeSent', (p) => {
+            // A dedicated Worker's script request has no loader and never gets
+            // loadingFinished on this session (review: every capture of a page
+            // with `new Worker('/w.js')` pinned at the cap). The init script counts
+            // the worker's conversation instead.
+            if (p.loaderId === '')
+                return;
+            this.inflight.set(p.requestId, {
+                url: p.request.url,
+                ...(p.type !== undefined ? { type: p.type } : {}),
+                // Every frame's request, not only the main frame's: a child frame's
+                // request (an iframe's analytics XHR) never gets loadingFailed when
+                // the document navigates away, and without a loader it escaped the
+                // sweep below and pinned every later story at the cap.
+                ...(p.frameId === mainFrameId
+                    ? { mainLoader: p.loaderId }
+                    : this.mainLoader !== undefined
+                        ? { mainLoader: this.mainLoader }
+                        : {}),
+            });
+        });
+        // The new main document commits. Its predecessor's requests, including
+        // ones it started between the navigation's start and this commit, never
+        // get loadingFailed (spike: a long poll pinned the next page at the cap;
+        // review: a 2 ms poller flagged the following static page 4 of 6
+        // times), and its completions must not satisfy this one's `require`.
+        // On the commit, not on the Document request: a navigation that never
+        // commits (a 204, a download) must leave the live document's requests
+        // counted (review round 2). A request is kept by its loader, not dropped
+        // on arrival, because Network events and the commit come from different
+        // processes and a new document's first fetch can be reported before it.
+        page.on('Page.frameNavigated', ({ frame }) => {
+            if (frame.parentId !== undefined || frame.id !== mainFrameId)
+                return;
+            this.mainLoader = frame.loaderId;
+            for (const [id, r] of this.inflight)
+                if (r.mainLoader !== undefined && r.mainLoader !== frame.loaderId) {
+                    this.inflight.delete(id);
+                    this.excluded.delete(id);
+                }
+            this.done = [];
+            this.excluded.clear();
+            for (const l of [...this.listeners])
+                l();
+        });
+        const finish = (p) => {
+            const r = this.inflight.get(p.requestId);
+            if (!r)
+                return;
+            this.inflight.delete(p.requestId);
+            this.excluded.delete(p.requestId);
+            this.done.push(r);
+            if (this.done.length > MAX_DONE)
+                this.done.splice(0, this.done.length - MAX_DONE);
+            for (const l of [...this.listeners])
+                l();
+        };
+        page.on('Network.loadingFinished', finish);
+        page.on('Network.loadingFailed', finish);
+    }
+    /** A warm switch renders a new story in the same document: the last
+     *  story's completions must not satisfy `require`, and its requests still
+     *  in flight (a long poll) must not pin this one at the cap. */
+    reset() {
+        this.done = [];
+        this.excluded = new Set(this.inflight.keys());
+    }
+    /** In-flight requests the wait counts: required, or not ignored. */
+    counted(s) {
+        return [...this.inflight.entries()]
+            .filter(([id, r]) => !this.excluded.has(id) &&
+            // Another main-frame loader: the previous document's, or a
+            // navigation that has not committed (or never will).
+            (r.mainLoader === undefined ||
+                this.mainLoader === undefined ||
+                r.mainLoader === this.mainLoader))
+            .map(([, r]) => r)
+            .filter((r) => s.require.some((p) => matchPattern(p, r.url, r.type)) ||
+            !s.ignore.some((p) => matchPattern(p, r.url, r.type)));
+    }
+    /** `require` patterns no completed request has matched yet. */
+    missing(s) {
+        return s.require
+            .filter((p) => !this.done.some((r) => matchPattern(p, r.url, r.type)))
+            .map((p) => p.source);
+    }
+    busy(s) {
+        return this.counted(s).length > 0 || this.missing(s).length > 0;
+    }
+    /** Resolves when the wait no longer counts anything, or after `ms`. */
+    async settled(s, ms) {
+        if (!this.busy(s))
+            return;
+        await new Promise((resolve) => {
+            const done = () => {
+                clearTimeout(timer);
+                this.listeners.delete(check);
+                resolve();
+            };
+            const check = () => {
+                if (!this.busy(s))
+                    done();
+            };
+            const timer = setTimeout(done, Math.max(0, ms));
+            this.listeners.add(check);
+        });
+    }
+}
+const installed = new WeakMap();
+/**
+ * Install the init script and the request tracker, once per page, before
+ * its first navigation: the script applies to every later document on the
+ * page. Network.enable is already part of page init.
+ */
+export function installIdleDetector(page) {
+    let p = installed.get(page);
+    if (!p) {
+        p = (async () => {
+            await page
+                .send('Page.addScriptToEvaluateOnNewDocument', { source: IDLE_INIT })
+                .catch(() => { });
+            if (!page.on)
+                return { net: null };
+            const tree = await page.send('Page.getFrameTree').catch(() => undefined);
+            const mainFrameId = tree?.frameTree?.frame?.id;
+            return {
+                net: new NetworkTracker(page, mainFrameId),
+            };
+        })();
+        installed.set(page, p);
+    }
+    return p;
+}
+/** Before a story renders: forget the last story's completions, and on a
+ *  warm switch (same document) its ready() call. */
+export async function resetIdle(page, idle, warm) {
+    idle.net?.reset();
+    if (warm)
+        await page.evaluate('window.__juxIdle && window.__juxIdle.reset()').catch(() => { });
+}
+const now = () => performance.now();
+const isSnapshot = (v) => typeof v === 'object' && v !== null && typeof v.mut === 'number';
+/**
+ * Wait until the page reports no pending work and no counted request is in
+ * flight, or `capMs` passes. Never throws.
+ */
+export async function waitForIdle(page, idle, s, capMs = s.timeoutMs) {
+    const t0 = now();
+    let snap;
+    const timeout = () => ({
+        status: 'timeout',
+        waitedMs: now() - t0,
+        ...(snap ? { snap } : {}),
+        pending: describePending(snap, idle.net, s),
+    });
+    for (;;) {
+        const remaining = capMs - (now() - t0);
+        if (remaining <= 0)
+            return timeout();
+        let r;
+        try {
+            r = await page.evaluate(`window.__juxIdleWait ? window.__juxIdleWait(${Math.ceil(remaining)}, ${s.horizonMs}, ${s.ready}) : Promise.resolve({ status: 'noinit' })`, undefined, 
+            // The in-page cap fires first; this only matters if the page is wedged.
+            { timeout: Math.ceil(remaining) + 2000 });
+        }
+        catch (err) {
+            // A wedged page (a synchronous loop) would only wedge a second evaluate
+            // too: worst case cap + 2 s + 2 s (review round 2). Skip straight to the
+            // capture; a navigation mid-wait gets the fallback wait.
+            if (err instanceof SendTimeoutError)
+                return {
+                    status: 'fallback',
+                    waitedMs: now() - t0,
+                    pending: [
+                        'the page stopped answering during the wait; captured without waiting',
+                    ],
+                };
+            return fallback(page, t0, capMs, 'the page navigated during the wait');
+        }
+        const status = typeof r === 'object' && r !== null
+            ? r.status
+            : undefined;
+        const got = r?.snap;
+        if (isSnapshot(got))
+            snap = got;
+        if (status === 'cap')
+            return timeout();
+        if (status !== 'idle')
+            return fallback(page, t0, capMs, 'the idle detector was not installed in this page');
+        const net = idle.net;
+        if (!net)
+            return { status: 'idle', waitedMs: now() - t0, ...(snap ? { snap } : {}) };
+        if (net.busy(s)) {
+            await net.settled(s, capMs - (now() - t0));
+            continue;
+        }
+        // One more round trip, so the Network event for a request the page
+        // started just before it reported idle has arrived.
+        await page.evaluate('1').catch(() => { });
+        if (net.busy(s)) {
+            await net.settled(s, capMs - (now() - t0));
+            continue;
+        }
+        return { status: 'idle', waitedMs: now() - t0, ...(snap ? { snap } : {}) };
+    }
+}
+/**
+ * When the detector can't run, wait the way the quiet window did: fonts,
+ * eager images and 100 ms without a DOM change, all inside what is left of the
+ * cap. Flagged `settle-fallback`, so the weaker wait is never silent.
+ */
+async function fallback(page, t0, capMs, why) {
+    const remaining = Math.max(0, Math.ceil(capMs - (now() - t0)));
+    await page
+        .evaluate(`new Promise(function (resolve) {
+        var cap = setTimeout(resolve, ${remaining});
+        Promise.resolve(document.fonts && document.fonts.ready).then(function () {
+          return Promise.all(Array.prototype.filter.call(document.images, function (i) { return !i.complete && i.loading !== 'lazy'; })
+            .map(function (i) { return new Promise(function (r) { i.addEventListener('load', r, { once: true }); i.addEventListener('error', r, { once: true }); }); }));
+        }).then(function () {
+          var t; var fin = function () { o.disconnect(); clearTimeout(cap); resolve(); };
+          var o = new MutationObserver(function () { clearTimeout(t); t = setTimeout(fin, 100); });
+          o.observe(document, { childList: true, subtree: true, attributes: true, characterData: true });
+          t = setTimeout(fin, 100);
+        });
+      })`, undefined, { timeout: remaining + 2000 })
+        .catch(() => { });
+    return {
+        status: 'fallback',
+        waitedMs: now() - t0,
+        pending: [`${why}; waited for fonts, images and a quiet DOM only`],
+    };
+}
+/** After the paint barrier: did the DOM, fonts, images or network move? */
+export async function movedSincePaint(page, idle, before, s) {
+    if (!before)
+        return false;
+    const after = await page
+        .evaluate(`window.__juxIdle ? window.__juxIdle.snapshot(${s.horizonMs}) : null`)
+        .catch(() => null);
+    if (!isSnapshot(after))
+        return false;
+    // Timers and messages too: a callback inside the barrier can schedule work
+    // without touching the DOM yet.
+    return (after.mut !== before.mut ||
+        after.timers > 0 ||
+        after.msgs > 0 ||
+        after.workers > 0 ||
+        after.fonts === 'loading' ||
+        after.images > 0 ||
+        idle.net?.busy(s) === true);
+}
+const MAX_REQUEST_LINES = 5;
+/** A request URL as a person would name it: the path and query for http(s),
+ *  else the URL, either one trimmed. */
+function displayUrl(url) {
+    let out = url;
+    try {
+        const u = new URL(url);
+        if (u.protocol === 'http:' || u.protocol === 'https:')
+            out = u.pathname + u.search;
+    }
+    catch {
+        // not a URL; show it as is
+    }
+    return out.length > 100 ? `${out.slice(0, 99)}…` : out;
+}
+const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/**
+ * What was still pending at the cap, one line per kind, so an agent reading
+ * the result can respond: ignore a request, require one, raise the cap, or
+ * mask what keeps changing. Never empty.
+ */
+export function describePending(snap, net, s) {
+    const out = [];
+    if (net) {
+        const groups = new Map();
+        for (const r of net.counted(s)) {
+            const key = `${displayUrl(r.url)}\0${r.type ?? 'Other'}`;
+            groups.set(key, (groups.get(key) ?? 0) + 1);
+        }
+        const lines = [...groups.entries()]
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([key, n]) => {
+            const [url, type] = key.split('\0');
+            return `${plural(n, 'request')} to ${url} in flight (${type})`;
+        });
+        out.push(...lines.slice(0, MAX_REQUEST_LINES));
+        if (lines.length > MAX_REQUEST_LINES)
+            out.push(`${lines.length - MAX_REQUEST_LINES} more requests in flight`);
+        for (const p of net.missing(s))
+            out.push(`no request matching required pattern '${p}' has completed`);
+    }
+    if (snap) {
+        if (s.ready && !snap.ready)
+            out.push('window.__juxtapose.ready() was not called');
+        if (snap.timers > 0)
+            out.push(`${plural(snap.timers, 'timer')} due within ${s.horizonMs} ms`);
+        if (snap.rafs > 0)
+            out.push(`${plural(snap.rafs, 'animation frame callback')} pending`);
+        if (snap.msgs > 0)
+            out.push(`${plural(snap.msgs, 'posted message')} undelivered`);
+        if (snap.workers > 0)
+            out.push(`${plural(snap.workers, 'worker')} not answered yet: ${snap.workerSrcs.map(displayUrl).join(', ')}`);
+        if (snap.fonts === 'loading')
+            out.push('web fonts still loading');
+        if (snap.images > 0)
+            out.push(`${plural(snap.images, 'image')} still loading: ${snap.imageSrcs.map(displayUrl).join(', ')}`);
+        if (out.length === 0 && snap.changing)
+            out.push('the DOM kept changing');
+    }
+    if (out.length === 0)
+        out.push(`the page did not settle within ${s.timeoutMs} ms`);
+    return out;
+}
+//# sourceMappingURL=idle.js.map

package/dist/capture/idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../src/capture/idle.ts"],"names":[],"mappings":"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"}

package/dist/capture/network-policy.d.ts

@@ -0,0 +1,21 @@
+import type { Page } from '../browser/page.js';
+export type ExternalNetwork = 'allow' | 'block';
+export interface NetworkLayer {
+    network?: {
+        external?: ExternalNetwork;
+    };
+}
+/** Validate a `network` value where it is declared; `where` names the place to edit. */
+export declare function checkNetwork(raw: unknown, where: string): {
+    external?: ExternalNetwork;
+} | undefined;
+/** call > story > project, default 'allow'. */
+export declare function resolveExternal(project: NetworkLayer | undefined, story: NetworkLayer | undefined, call: NetworkLayer | undefined): ExternalNetwork;
+/** Whether `url` is a remote request to a different origin than `origin`. */
+export declare function isExternal(url: string, origin: string): boolean;
+/**
+ * Make the page's request policy match `mode` for the origin of `baseUrl`.
+ * Called before every navigation; a page keeps its policy until the next call,
+ * so a pooled page never carries one capture's block into the next.
+ */
+export declare function applyNetworkPolicy(page: Page, mode: ExternalNetwork, baseUrl: string): Promise<void>;