@ethlete/cli 3.0.0-next.26 → 3.0.0-next.28

package/src/lib/design/system/visible-change.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.visibleChangeSummaryOf = exports.visibleChangeVerdictOf = exports.mergedPartsOf = exports.sketchedPartsOf = exports.stateDiffOf = exports.deviationOf = void 0;
+const part_compare_1 = require("./part-compare");
+const DIFF_RED = 0xff0000ff;
+/** The pixels the app picture differs from the design picture in, counting those outside their shared area. */
+const deviationOf = (options) => {
+    const result = (0, part_compare_1.comparePngs)(options);
+    if (result.kind === 'ok')
+        return 0;
+    if (result.kind === 'diff')
+        return result.pixels;
+    const { data } = (0, part_compare_1.decodePng)(result.diff);
+    let pixels = 0;
+    for (let at = 0; at < data.length; at += 4)
+        if (data.readUInt32BE(at) === DIFF_RED)
+            pixels++;
+    return pixels;
+};
+exports.deviationOf = deviationOf;
+const stateDiffOf = (options) => {
+    const { base, head } = options;
+    const { state } = head;
+    if ('problem' in head)
+        return base && !('problem' in base)
+            ? { state, kind: 'broken', problem: head.problem }
+            : {
+                state,
+                kind: head.undrivable && base && 'problem' in base && base.undrivable ? 'undrivable' : 'unjudged',
+                problem: head.problem,
+            };
+    if (!base || 'problem' in base)
+        return { state, kind: 'new', head: (0, exports.deviationOf)({ design: head.design, app: head.app }) };
+    const change = (0, part_compare_1.comparePngs)({ design: base.app, app: head.app });
+    if (change.kind === 'ok')
+        return { state, kind: 'same' };
+    return {
+        state,
+        kind: 'differs',
+        base: (0, exports.deviationOf)({ design: head.design, app: base.app }),
+        head: (0, exports.deviationOf)({ design: head.design, app: head.app }),
+        diff: change.diff,
+    };
+};
+exports.stateDiffOf = stateDiffOf;
+/** The parts a picked sketch, or a sketch a merge deleted, targets. */
+const sketchedPartsOf = (evidence) => {
+    var _a;
+    const parts = new Set();
+    for (const { text, merged } of evidence) {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch (_b) {
+            continue;
+        }
+        if (!merged && ((_a = parsed.decision) === null || _a === void 0 ? void 0 : _a.kind) !== 'pick')
+            continue;
+        const targets = Array.isArray(parsed.targets) ? parsed.targets : [parsed.target];
+        for (const target of targets)
+            if (typeof target === 'string')
+                parts.add(target);
+    }
+    return parts;
+};
+exports.sketchedPartsOf = sketchedPartsOf;
+const mergedEntriesOf = (text) => {
+    try {
+        const parsed = JSON.parse(text !== null && text !== void 0 ? text : '{}');
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch (_a) {
+        return {};
+    }
+};
+const decisionOf = (entry) => entry && typeof entry === 'object' && !Array.isArray(entry)
+    ? JSON.stringify(Object.assign(Object.assign({}, entry), { hash: null }))
+    : null;
+/**
+ * The parts a sketch merge recorded in `merged.json` between the base and HEAD: a part first recorded there, or one
+ * whose recorded pick changed. A hash refresh alone is no merge.
+ */
+const mergedPartsOf = (options) => {
+    const base = mergedEntriesOf(options.base);
+    const head = mergedEntriesOf(options.head);
+    return new Set(Object.entries(head).flatMap(([part, entry]) => !(part in base) || (decisionOf(entry) !== null && decisionOf(entry) !== decisionOf(base[part])) ? [part] : []));
+};
+exports.mergedPartsOf = mergedPartsOf;
+/**
+ * A part passes when its app draws alike at base and HEAD, when a picked or merged sketch of it is in the range, or
+ * when every changed state is strictly closer to HEAD's design or, without a base picture, matches it. A state HEAD can no longer draw always fails, and so does any state the gate could not judge,
+ * but a state neither app has an element to force the design's interaction on: that is a problem of the part, listed as `undrivable`.
+ */
+const visibleChangeVerdictOf = (options) => {
+    const { part, states } = options.diff;
+    const changed = states.filter((state) => state.kind === 'differs' || state.kind === 'new' || state.kind === 'broken');
+    const unjudgedStates = states.filter((state) => state.kind === 'unjudged');
+    const unjudged = unjudgedStates.map((state) => state.state);
+    const reasons = [...new Set(unjudgedStates.map((state) => (state.kind === 'unjudged' ? state.problem : '')))];
+    const undrivableStates = states.filter((state) => state.kind === 'undrivable');
+    const undrivable = undrivableStates.map((state) => state.state);
+    const undrivableReasons = [
+        ...new Set(undrivableStates.map((state) => (state.kind === 'undrivable' ? state.problem : ''))),
+    ];
+    const verdict = (pass, why) => ({
+        part,
+        pass,
+        why,
+        changed: changed.map((state) => state.state),
+        unjudged,
+        reasons,
+        undrivable,
+        undrivableReasons,
+    });
+    if (changed.some((state) => state.kind === 'broken'))
+        return verdict(false, 'broken');
+    if (unjudged.length > 0)
+        return verdict(false, 'unjudged');
+    if (changed.length === 0)
+        return verdict(true, 'invisible');
+    if (options.sketched.has(part))
+        return verdict(true, 'sketched');
+    if (changed.every((state) => state.kind === 'new' && state.head === 0))
+        return verdict(true, 'matches');
+    if (changed.every((state) => (state.kind === 'differs' && state.head < state.base) || (state.kind === 'new' && state.head === 0)))
+        return verdict(true, 'closer');
+    return verdict(false, 'visible');
+};
+exports.visibleChangeVerdictOf = visibleChangeVerdictOf;
+/** The gate's last line; it names every unjudged state, so a pass that judged nothing never reads as a clean pass. */
+const visibleChangeSummaryOf = (options) => {
+    const { verdicts, range, seconds } = options;
+    const failed = options.problems + verdicts.filter((verdict) => !verdict.pass).length;
+    const listOf = (what, of) => {
+        const listed = verdicts.filter((verdict) => of(verdict).length > 0);
+        const count = listed.reduce((sum, verdict) => sum + of(verdict).length, 0);
+        return count === 0
+            ? ''
+            : ` - ${count} state(s) ${what}: ${listed.map((verdict) => `${verdict.part} (${of(verdict).join(', ')})`).join('; ')}`;
+    };
+    const list = listOf('unjudged', (verdict) => verdict.unjudged) +
+        listOf('undrivable, a problem of the part', (verdict) => verdict.undrivable);
+    return failed === 0
+        ? `No part looks different in ${range} without a sketch (${seconds} s)${list}.`
+        : `${failed} part(s) fail the visible-change gate in ${range}. Pick and merge a sketch of each, or move it closer to its design${list}.`;
+};
+exports.visibleChangeSummaryOf = visibleChangeSummaryOf;
+//# sourceMappingURL=visible-change.js.map

package/src/lib/design/system/visible-change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visible-change.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/visible-change.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/write-origin.d.ts

@@ -0,0 +1,12 @@
+/** Who wrote a decision file entry (a ready mark or a sketch pick): the actor, the command it ran, and its process id. */
+export type WriteOrigin = {
+    by: string;
+    cmd: string;
+    pid: number;
+};
+/** A command line for a committed record: an absolute path becomes relative to `cwd`, so no home directory lands in the repo. */
+export declare const portableCmdOf: (args: string[], cwd?: string) => string;
+/** The origin of a write by `by` from this process; `cmd` defaults to the command line it was started with. */
+export declare const originOf: (by: string, cmd?: string) => WriteOrigin;
+/** Whether `origin` names its actor; a decision write without one is refused. */
+export declare const hasActor: (origin: Partial<WriteOrigin> | undefined) => boolean;

package/src/lib/design/system/write-origin.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasActor = exports.originOf = exports.portableCmdOf = void 0;
+const node_path_1 = require("node:path");
+/** A command line for a committed record: an absolute path becomes relative to `cwd`, so no home directory lands in the repo. */
+const portableCmdOf = (args, cwd = process.cwd()) => args.map((arg) => ((0, node_path_1.isAbsolute)(arg) ? (0, node_path_1.relative)(cwd, arg) || '.' : arg)).join(' ');
+exports.portableCmdOf = portableCmdOf;
+/** The origin of a write by `by` from this process; `cmd` defaults to the command line it was started with. */
+const originOf = (by, cmd = (0, exports.portableCmdOf)(process.argv.slice(2))) => ({
+    by,
+    cmd,
+    pid: process.pid,
+});
+exports.originOf = originOf;
+/** Whether `origin` names its actor; a decision write without one is refused. */
+const hasActor = (origin) => typeof (origin === null || origin === void 0 ? void 0 : origin.by) === 'string' && origin.by.trim() !== '';
+exports.hasActor = hasActor;
+//# sourceMappingURL=write-origin.js.map

package/src/lib/design/system/write-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-origin.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/write-origin.ts"],"names":[],"mappings":";;;AAAA,yCAAiD;AAKjD,iIAAiI;AAC1H,MAAM,aAAa,GAAG,CAAC,IAAc,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,CACnE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAA,sBAAU,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,oBAAQ,EAAC,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AADtE,QAAA,aAAa,iBACyD;AAEnF,+GAA+G;AACxG,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,GAAG,GAAG,IAAA,qBAAa,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC;IAChG,EAAE;IACF,GAAG;IACH,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC,CAAC;AAJU,QAAA,QAAQ,YAIlB;AAEH,iFAAiF;AAC1E,MAAM,QAAQ,GAAG,CAAC,MAAwC,EAAE,EAAE,CACnE,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,EAAE,CAAA,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAD/C,QAAA,QAAQ,YACuC"}

package/src/lib/design/system-use.js

@@ -4,7 +4,7 @@ exports.stageProblemOf = exports.inventoryWarningOf = exports.systemWarningOf =
 const fs_1 = require("fs");
 const path_1 = require("path");
 const new_call_1 = require("./new-call");
-const paths_1 = require("./paths");
+const design_config_1 = require("./design-config");
 const STAGES_ON_THE_SYSTEM = new Set(['element', 'page', 'prototype']);
 const SPECIFIER = /(?:\bfrom\s*|\bimport\s*\(?\s*)['"]([^'"]+)['"]/g;
 /** Whether a variant of the call imports anything from its project's design system. */
@@ -12,8 +12,8 @@ const drawsFromSystem = (options) => {
     var _a;
     const { target, slug } = options;
     const project = (_a = slug.split('/')[0]) !== null && _a !== void 0 ? _a : '';
-    const system = (0, path_1.resolve)(target, paths_1.DESIGN_DIR, 'system', project);
-    const folder = (0, path_1.resolve)((0, paths_1.callsRootOf)(target), slug);
+    const system = (0, path_1.resolve)(target, design_config_1.DESIGN_DIR, 'system', project);
+    const folder = (0, path_1.resolve)((0, design_config_1.callsRootOf)(target), slug);
     if (!(0, fs_1.existsSync)(folder))
         return false;
     return (0, fs_1.readdirSync)(folder)
@@ -33,7 +33,7 @@ const systemWarningOf = (options) => {
     if (!stage || !STAGES_ON_THE_SYSTEM.has(stage) || (0, exports.drawsFromSystem)({ target, slug }))
         return null;
     return (`WARNING ${slug} is a ${stage} call but no variant imports from ` +
-        `${paths_1.DESIGN_DIR}/system/${slug.split('/')[0]}/ - it draws no design-system entry, so its parts ` +
+        `${design_config_1.DESIGN_DIR}/system/${slug.split('/')[0]}/ - it draws no design-system entry, so its parts ` +
         `may not match the system.`);
 };
 exports.systemWarningOf = systemWarningOf;

package/src/lib/design/system-use.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-use.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/system-use.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system-use.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/system-use.ts"],"names":[],"mappings":"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"}

package/src/lib/design/thumb.d.ts

@@ -1,6 +1,7 @@
 import { IncomingMessage, ServerResponse } from 'http';
 import { Chromium, chromiumOf } from './browser';
 import { DrawLedger } from './draw-ledger';
+import { ShotBoard } from './shot-board';
 export declare const THUMB_PATH = "/__design/thumb";
 /** The pixel width a thumbnail comes out at: twice the 180px tile Studio shows it in. */
 export declare const THUMB_PIXEL_WIDTH = 360;
@@ -24,27 +25,50 @@ export declare class ShotFailedError extends Error {
 }
 export declare class ShotTimeoutError extends Error {
 }
+/** A design-server URL that answered an error status, such as the 403 Vite sends for a file outside `server.fs.allow`. */
+export declare class FrameUnservedError extends Error {
+}
+/** Throws a `FrameUnservedError` naming the URL and status when the navigation to a design-server page answered 400 or above. */
+export declare const assertServed: (response: {
+    status(): number;
+} | null, url: string) => void;
 /** Rejects a drawing that was still waiting when every ask that wanted it was aborted. */
 export declare class DrawDroppedError extends Error {
 }
 type Page = Awaited<ReturnType<Awaited<ReturnType<Browser['newContext']>>['newPage']>>;
 /**
- * Opens a frame and waits until it drew its content or its error, then for its embedded frames. A frame that
- * never draws throws a `ShotTimeoutError` naming the URL.
+ * Opens a frame and waits until it drew its content or its error, then for its embedded frames. Each wait is
+ * `DRAW_TIMEOUT_MS` stretched by the machine load. A frame that draws nothing after one reload throws a
+ * `ShotTimeoutError` naming the URL.
  */
 export declare const openFrame: (page: Page, url: string) => Promise<void>;
 export declare const settled = "new Promise((done) => document.fonts.ready.then(() =>\n  requestAnimationFrame(() => requestAnimationFrame(() => done(true)))))";
-export declare const finished = "document.getAnimations()\n  .filter((animation) => animation.effect?.getComputedTiming().endTime !== Infinity)\n  .forEach((animation) => animation.finish())";
+/** Waits for `settled` on `page`, and throws a `WaitTimeoutError` naming the page after `DRAW_TIMEOUT_MS`. */
+export declare const awaitSettled: (page: Pick<Page, "evaluate" | "url">) => Promise<unknown>;
+/** Waits for the fonts of `page`, and throws a `WaitTimeoutError` naming the page after `DRAW_TIMEOUT_MS`. */
+export declare const awaitFonts: (page: Pick<Page, "evaluate" | "url">) => Promise<unknown>;
+/** Finishes the page's finite time-based animations; scroll-driven ones keep the progress their scroll position gives. */
+export declare const finished = "document.getAnimations()\n  .filter((animation) => animation.effect?.getComputedTiming().endTime !== Infinity)\n  .filter((animation) => typeof ScrollTimeline === 'undefined' || !(animation.timeline instanceof ScrollTimeline))\n  .forEach((animation) => animation.finish())";
+/**
+ * Cancels each running infinite animation, as a screenshot with disabled animations does in the app picture, so both
+ * pictures show its start frame; a paused one or one with a playback rate of 0 keeps its held frame.
+ */
+export declare const heldAnimations = "document.getAnimations()\n  .filter((animation) => animation.effect?.getComputedTiming().endTime === Infinity)\n  .filter((animation) => animation.playState === 'running' && animation.playbackRate !== 0)\n  .filter((animation) => typeof ScrollTimeline === 'undefined' || !(animation.timeline instanceof ScrollTimeline))\n  .forEach((animation) => animation.cancel())";
 export type DrawPriority = 'high' | 'low';
 /**
  * What one ask wants of a drawing. `view` is a number the asker raises with each view change; the
- * highest one seen is the shown view. `rank` places the ask in that view. `onWithdraw` gets the callback
+ * highest one seen is the shown view. `rank` places the ask in that view. `board` places it by the queue's shot
+ * board instead, where the board names its shot. `onWithdraw` gets the callback
  * that withdraws the ask, to call once the asker no longer waits, or at once if it already stopped.
  */
 export type DrawWant = {
     priority: DrawPriority;
     view?: number | null;
     rank?: 'active' | 'visible' | null;
+    board?: {
+        key: string;
+        boardView: number;
+    };
     onWithdraw?: (withdraw: () => void) => void;
 };
 export declare const DRAWS_AT_ONCE = 8;
@@ -55,10 +79,13 @@ export declare const DRAWS_AT_ONCE = 8;
  * A drawing every ask withdrew before it started is dropped. A failed launch is not kept, so the next ask
  * tries again.
  */
+/** `browser` with every context it opens closed when `signal` aborts, so a draw of an aborted run fails at once. */
+export declare const closingOnAbort: (browser: Browser, signal: AbortSignal) => Browser;
 export declare const createDrawQueue: (options: {
     target: string;
     chromiumOf?: typeof chromiumOf;
     ledger?: DrawLedger;
+    board?: Pick<ShotBoard, "laneOf">;
 }) => {
     run: <T>(draw: (browser: Browser) => Promise<T>, want?: DrawPriority | DrawWant) => Promise<T>;
     /** Adds an ask to a drawing `run` returned, so it runs in the best lane any of its asks wants, unless it already started. */
@@ -72,6 +99,12 @@ export declare const noteFailure: <T>(shot: Promise<T>, failed: (failure: {
     status: number;
     message: string;
 }) => void) => Promise<T>;
+export declare const SHOT_MAX_AGE_S = 3600;
+/**
+ * Answers with the PNG `shot` resolves to, tagged with its content hash; an ask whose `if-none-match` names that
+ * tag gets a 304. The asker keys the URL on the content it shows (Studio: session, epoch and revision), so the
+ * browser may keep a picture for `SHOT_MAX_AGE_S` and paint it again without asking.
+ */
 export declare const sendShot: (response: ServerResponse, shot: Promise<Buffer>) => undefined;
 export declare const send: (response: ServerResponse, { status, type, body }: Shot) => void;
 /** Whether a call may draw from a file under the calls root: its own, or one in a folder above it. */

package/src/lib/design/thumb.js

@@ -9,9 +9,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createThumbnailer = exports.callDrawsFrom = exports.send = exports.sendShot = exports.noteFailure = exports.createDrawQueue = exports.DRAWS_AT_ONCE = exports.finished = exports.settled = exports.openFrame = exports.DrawDroppedError = exports.ShotTimeoutError = exports.ShotFailedError = exports.ShotUnprocessableError = exports.ThumbMissingError = exports.ThumbUnavailableError = exports.DRAW_TIMEOUT_MS = exports.THUMB_PIXEL_WIDTH = exports.THUMB_PATH = void 0;
+exports.createThumbnailer = exports.callDrawsFrom = exports.send = exports.sendShot = exports.SHOT_MAX_AGE_S = exports.noteFailure = exports.createDrawQueue = exports.closingOnAbort = exports.DRAWS_AT_ONCE = exports.heldAnimations = exports.finished = exports.awaitFonts = exports.awaitSettled = exports.settled = exports.openFrame = exports.DrawDroppedError = exports.assertServed = exports.FrameUnservedError = exports.ShotTimeoutError = exports.ShotFailedError = exports.ShotUnprocessableError = exports.ThumbMissingError = exports.ThumbUnavailableError = exports.DRAW_TIMEOUT_MS = exports.THUMB_PIXEL_WIDTH = exports.THUMB_PATH = void 0;
+const rxjs_1 = require("rxjs");
+const crypto_1 = require("crypto");
 const path_1 = require("path");
 const browser_1 = require("./browser");
+const perf_hooks_1 = require("perf_hooks");
+const phase_timing_1 = require("./phase-timing");
+const run_abort_1 = require("./run-abort");
+const timings_1 = require("./timings");
+const wait_1 = require("./wait");
+const no_verdict_1 = require("./system/no-verdict");
 exports.THUMB_PATH = '/__design/thumb';
 /** The pixel width a thumbnail comes out at: twice the 180px tile Studio shows it in. */
 exports.THUMB_PIXEL_WIDTH = 360;
@@ -37,6 +45,19 @@ exports.ShotFailedError = ShotFailedError;
 class ShotTimeoutError extends Error {
 }
 exports.ShotTimeoutError = ShotTimeoutError;
+/** A design-server URL that answered an error status, such as the 403 Vite sends for a file outside `server.fs.allow`. */
+class FrameUnservedError extends Error {
+}
+exports.FrameUnservedError = FrameUnservedError;
+/** Throws a `FrameUnservedError` naming the URL and status when the navigation to a design-server page answered 400 or above. */
+const assertServed = (response, url) => {
+    var _a;
+    const status = (_a = response === null || response === void 0 ? void 0 : response.status()) !== null && _a !== void 0 ? _a : 0;
+    if (status >= 400) {
+        throw new FrameUnservedError(`design-explore: ${url} was not served (HTTP ${status}) - the design server refused or failed the page, so nothing on it can be measured`);
+    }
+};
+exports.assertServed = assertServed;
 /** Rejects a drawing that was still waiting when every ask that wanted it was aborted. */
 class DrawDroppedError extends Error {
 }
@@ -47,27 +68,30 @@ const frameWidthOf = (slug) => `(async (slug) => {
   return (await calls[slug]()).default.frameWidth ?? null;
 })(${JSON.stringify(slug)})`;
 /**
- * Opens a frame and waits until it drew its content or its error, then for its embedded frames. A frame that
- * never draws throws a `ShotTimeoutError` naming the URL.
+ * Opens a frame and waits until it drew its content or its error, then for its embedded frames. Each wait is
+ * `DRAW_TIMEOUT_MS` stretched by the machine load. A frame that draws nothing after one reload throws a
+ * `ShotTimeoutError` naming the URL.
  */
 const openFrame = (page, url) => __awaiter(void 0, void 0, void 0, function* () {
-    yield page.goto(url, { waitUntil: 'domcontentloaded' });
-    // Headless Chromium's pointer starts at 0,0 on a new page and draws a real :hover on whatever fills the
-    // frame's corner. A move before the first navigation does not stick.
-    yield page.mouse.move(-1, -1);
-    const never = (what) => new ShotTimeoutError(`design-explore: ${url} did not ${what} within ${exports.DRAW_TIMEOUT_MS} ms`);
-    yield page
-        .locator('#root > :not(style)')
-        .first()
-        .waitFor({ state: 'attached', timeout: exports.DRAW_TIMEOUT_MS })
-        .catch(() => __awaiter(void 0, void 0, void 0, function* () {
-        if ((yield page.locator('vite-error-overlay').count()) === 0)
-            throw never('draw its content');
-    }));
+    const timeout = (0, no_verdict_1.loadScaledMs)(exports.DRAW_TIMEOUT_MS);
+    const never = (what) => new ShotTimeoutError(`design-explore: ${url} did not ${what} within ${timeout} ms`);
+    const drawn = () => __awaiter(void 0, void 0, void 0, function* () {
+        (0, exports.assertServed)(yield page.goto(url, { waitUntil: 'domcontentloaded' }), url);
+        // Headless Chromium's pointer starts at 0,0 on a new page and draws a real :hover on whatever fills the
+        // frame's corner. A move before the first navigation does not stick.
+        yield page.mouse.move(-1, -1);
+        return page
+            .locator('#root > :not(style)')
+            .first()
+            .waitFor({ state: 'attached', timeout })
+            .then(() => true, () => __awaiter(void 0, void 0, void 0, function* () { return (yield page.locator('vite-error-overlay').count()) > 0; }));
+    });
+    if (!(yield drawn()) && !(yield drawn()))
+        throw never('draw its content');
     yield page
         .locator('iframe[data-et-embed]:not([data-et-embed-drawn])')
         .first()
-        .waitFor({ state: 'detached', timeout: exports.DRAW_TIMEOUT_MS })
+        .waitFor({ state: 'detached', timeout })
         .catch(() => {
         throw never('draw its embedded frames');
     });
@@ -75,9 +99,29 @@ const openFrame = (page, url) => __awaiter(void 0, void 0, void 0, function* ()
 exports.openFrame = openFrame;
 exports.settled = `new Promise((done) => document.fonts.ready.then(() =>
   requestAnimationFrame(() => requestAnimationFrame(() => done(true)))))`;
+/** Waits for `settled` on `page`, and throws a `WaitTimeoutError` naming the page after `DRAW_TIMEOUT_MS`. */
+const awaitSettled = (page) => (0, wait_1.withinLimit)(page.evaluate(exports.settled), {
+    ms: exports.DRAW_TIMEOUT_MS,
+    what: `the fonts and the first frames of ${page.url()}`,
+});
+exports.awaitSettled = awaitSettled;
+/** Waits for the fonts of `page`, and throws a `WaitTimeoutError` naming the page after `DRAW_TIMEOUT_MS`. */
+const awaitFonts = (page) => (0, wait_1.withinLimit)(page.evaluate('document.fonts.ready'), { ms: exports.DRAW_TIMEOUT_MS, what: `the fonts of ${page.url()}` });
+exports.awaitFonts = awaitFonts;
+/** Finishes the page's finite time-based animations; scroll-driven ones keep the progress their scroll position gives. */
 exports.finished = `document.getAnimations()
   .filter((animation) => animation.effect?.getComputedTiming().endTime !== Infinity)
+  .filter((animation) => typeof ScrollTimeline === 'undefined' || !(animation.timeline instanceof ScrollTimeline))
   .forEach((animation) => animation.finish())`;
+/**
+ * Cancels each running infinite animation, as a screenshot with disabled animations does in the app picture, so both
+ * pictures show its start frame; a paused one or one with a playback rate of 0 keeps its held frame.
+ */
+exports.heldAnimations = `document.getAnimations()
+  .filter((animation) => animation.effect?.getComputedTiming().endTime === Infinity)
+  .filter((animation) => animation.playState === 'running' && animation.playbackRate !== 0)
+  .filter((animation) => typeof ScrollTimeline === 'undefined' || !(animation.timeline instanceof ScrollTimeline))
+  .forEach((animation) => animation.cancel())`;
 // Partial raster redraws only the invalidated part of a tile, so the anti-aliased edge of a rounded clip over an
 // embedded frame depends on which frame painted first: two draws of the same page differed under load.
 const DRAW_BROWSER_ARGS = ['--disable-partial-raster'];
@@ -89,6 +133,29 @@ exports.DRAWS_AT_ONCE = 8;
  * A drawing every ask withdrew before it started is dropped. A failed launch is not kept, so the next ask
  * tries again.
  */
+/** `browser` with every context it opens closed when `signal` aborts, so a draw of an aborted run fails at once. */
+const closingOnAbort = (browser, signal) => new Proxy(browser, {
+    get: (target, key) => {
+        const value = Reflect.get(target, key, target);
+        if (key !== 'newContext' || typeof value !== 'function') {
+            return typeof value === 'function' ? value.bind(target) : value;
+        }
+        return (...args) => __awaiter(void 0, void 0, void 0, function* () {
+            if (signal.aborted)
+                throw new run_abort_1.RunAbortedError();
+            const context = yield target.newContext(...args);
+            const close = () => void context.close().catch(() => undefined);
+            if (signal.aborted)
+                close();
+            else {
+                const aborting = (0, rxjs_1.fromEvent)(signal, 'abort').pipe((0, rxjs_1.take)(1), (0, rxjs_1.tap)(close)).subscribe();
+                context.once('close', () => aborting.unsubscribe());
+            }
+            return context;
+        });
+    },
+});
+exports.closingOnAbort = closingOnAbort;
 const createDrawQueue = (options) => {
     var _a;
     const { target, ledger } = options;
@@ -103,7 +170,7 @@ const createDrawQueue = (options) => {
             if (!resolved) {
                 throw new ThumbUnavailableError('design-explore: no playwright or playwright-core resolves, so the server can not draw thumbnails');
             }
-            return resolved.chromium.launch({ args: DRAW_BROWSER_ARGS }).catch((error) => {
+            return (0, phase_timing_1.timedPhase)('browser-start', () => resolved.chromium.launch({ args: DRAW_BROWSER_ARGS })).catch((error) => {
                 throw new ThumbUnavailableError(`design-explore: the Chromium of ${resolved.from} did not start\n${error instanceof Error ? error.message : String(error)}`);
             });
         }));
@@ -111,8 +178,12 @@ const createDrawQueue = (options) => {
         return browser;
     };
     const laneOf = (want) => {
+        var _a;
         if (want.priority === 'high')
             return 0;
+        const shown = want.board && ((_a = options.board) === null || _a === void 0 ? void 0 : _a.laneOf(want.board));
+        if (shown)
+            return shown;
         if (typeof want.view === 'number' && want.view < shownView)
             return 4;
         return want.rank === 'active' ? 1 : want.rank === 'visible' ? 2 : 3;
@@ -162,6 +233,8 @@ const createDrawQueue = (options) => {
     return {
         run: (draw, want = 'high') => {
             const ticket = ledger === null || ledger === void 0 ? void 0 : ledger.ask();
+            const asked = perf_hooks_1.performance.now();
+            const signal = (0, run_abort_1.runSignal)();
             const entry = {
                 job: () => Promise.resolve(),
                 wants: new Set(),
@@ -170,8 +243,14 @@ const createDrawQueue = (options) => {
             const drawn = new Promise((resolve, reject) => {
                 entry.job = () => {
                     ticket === null || ticket === void 0 ? void 0 : ticket.start();
+                    (0, timings_1.recordDrawWait)(perf_hooks_1.performance.now() - asked);
+                    if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                        ticket === null || ticket === void 0 ? void 0 : ticket.end();
+                        reject(new run_abort_1.RunAbortedError());
+                        return Promise.resolve();
+                    }
                     return launch()
-                        .then(draw)
+                        .then((open) => draw(signal ? (0, exports.closingOnAbort)(open, signal) : open))
                         .then(resolve, reject)
                         .finally(() => ticket === null || ticket === void 0 ? void 0 : ticket.end());
                 };
@@ -216,7 +295,24 @@ const noteFailure = (shot, failed) => {
     return shot;
 };
 exports.noteFailure = noteFailure;
-const sendShot = (response, shot) => void shot.then((body) => (0, exports.send)(response, { status: 200, type: 'image/png', body }), (error) => {
+exports.SHOT_MAX_AGE_S = 3600;
+/**
+ * Answers with the PNG `shot` resolves to, tagged with its content hash; an ask whose `if-none-match` names that
+ * tag gets a 304. The asker keys the URL on the content it shows (Studio: session, epoch and revision), so the
+ * browser may keep a picture for `SHOT_MAX_AGE_S` and paint it again without asking.
+ */
+const sendShot = (response, shot) => void shot.then((body) => {
+    var _a;
+    const tag = `"${(0, crypto_1.createHash)('sha1').update(body).digest('base64url')}"`;
+    response.setHeader('etag', tag);
+    response.setHeader('cache-control', `private, max-age=${exports.SHOT_MAX_AGE_S}`);
+    if (((_a = response.req) === null || _a === void 0 ? void 0 : _a.headers['if-none-match']) === tag) {
+        response.statusCode = 304;
+        response.end();
+    }
+    else
+        (0, exports.send)(response, { status: 200, type: 'image/png', body });
+}, (error) => {
     const failure = failureOf(error);
     (0, exports.send)(response, error instanceof ShotFailedError
         ? { status: 500, type: 'image/png', body: error.png }
@@ -258,7 +354,7 @@ const createThumbnailer = (options) => {
                 deviceScaleFactor: exports.THUMB_PIXEL_WIDTH / width,
                 mobile: false,
             });
-            yield page.evaluate(exports.settled);
+            yield (0, exports.awaitSettled)(page);
             const { data } = yield cdp.send('Page.captureScreenshot', { format: 'png' });
             return Buffer.from(data, 'base64');
         }
@@ -268,6 +364,7 @@ const createThumbnailer = (options) => {
     });
     const shotOf = (slug, search) => {
         const cached = cache.get(search);
+        (0, timings_1.recordCache)(cached !== undefined);
         if (cached)
             return cached.shot;
         const shot = drawQueue.run((browser) => draw(browser, { slug, search }));