tuffgal 0.2.0-alpha.3 → 0.2.0-alpha.4

package/dist/runner/interpolate.js.map

@@ -1 +1 @@
-{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/runner/interpolate.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,UAAkC;IAElC,yEAAyE;IACzE,8EAA8E;IAC9E,6EAA6E;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;QACnE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,mBAAmB,QAAQ,GAAG,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAU,EACV,UAAkC;IAElC,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAChE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACrB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;YACxC,CAAC,CAAC,IAAI,CAAC,QAAQ;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/runner/interpolate.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,UAAkC;IAElC,yEAAyE;IACzE,6EAA6E;IAC7E,6EAA6E;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;QACnE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,mBAAmB,QAAQ,GAAG,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAU,EACV,UAAkC;IAElC,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAChE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACrB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;YACxC,CAAC,CAAC,IAAI,CAAC,QAAQ;KAClB,CAAC;AACJ,CAAC"}

package/dist/runner/manifest.d.ts

@@ -1,7 +1,7 @@
 import type { ResolvedConfig } from '../config.ts';
 /**
  * Bump when the capture pipeline changes behaviour in a way that shifts pixels
- * for the same input UI — a new default screenshot option, a change to how the
+ * for the same input UI: a new default screenshot option, a change to how the
  * clock is frozen, a mask-application tweak, etc. A committed baseline set was
  * rendered under one `CAPTURE_SCHEMA`; a run under a higher value is a pixel-
  * affecting mismatch (see {@link PIXEL_AFFECTING_KEYS}) that prompts re-approve.
@@ -26,7 +26,7 @@ export interface ManifestBreakpoint {
  * to detect when the current capture environment has drifted from the one the
  * committed baselines were rendered under.
  *
- * `tuffgalVersion` and `playwrightVersion` are informational only — they are
+ * `tuffgalVersion` and `playwrightVersion` are informational only. They are
  * recorded for debugging but never contribute to a mismatch (a tuffgal patch
  * release or a Playwright bump that does not move the bundled browser leaves
  * pixels untouched). Every other field is pixel-affecting; see
@@ -54,7 +54,7 @@ export interface EnvironmentManifest {
  * shape, not the pixels); `tuffgalVersion`/`playwrightVersion` are excluded as
  * informational. `browser` is excluded because a browser-*name* change is
  * already implied by `browserVersion` (which carries the vendor+version string)
- * and the runner only launches chromium today — comparing the name would add a
+ * and the runner only launches chromium today. Comparing the name would add a
  * redundant key with no independent signal.
  */
 export declare const PIXEL_AFFECTING_KEYS: readonly ["captureSchema", "browserVersion", "platform", "captureMode", "breakpoints", "deviceScaleFactor", "frozenTime"];
@@ -62,17 +62,17 @@ export type PixelAffectingKey = (typeof PIXEL_AFFECTING_KEYS)[number];
 /**
  * Result of reading `<baselines>/manifest.json`. Three outcomes the caller must
  * distinguish, because they gate differently:
- *   - `ok` — a well-formed manifest was read; compare it against the run.
- *   - `missing` — no file on disk. The bootstrap case: the first `approve
+ *   - `ok`: a well-formed manifest was read; compare it against the run.
+ *   - `missing`: no file on disk. The bootstrap case: the first `approve
  *     --from` has not written a manifest yet, so `run --ci` treats it as "no
- *     expectation to violate" — `environment.expected: null`, no mismatch, no
+ *     expectation to violate": `environment.expected: null`, no mismatch, no
  *     exit 3. Never gate a project that has simply not been approved once.
- *   - `malformed` — a file exists but is not valid JSON or fails shape checks.
+ *   - `malformed`: a file exists but is not valid JSON or fails shape checks.
  *     A committed manifest that cannot be parsed is a real problem the run
  *     should surface, but crashing the whole comparison is too blunt. Treated
  *     as a mismatch-with-note: `expected: null`, `mismatch: true`, and
  *     `mismatchKeys: ['manifest']` so the report/comment can say "the committed
- *     manifest is unreadable — re-approve to rewrite it" without aborting.
+ *     manifest is unreadable. Re-approve to rewrite it" without aborting.
  */
 export type ManifestReadResult = {
     status: 'ok';
@@ -91,7 +91,7 @@ export declare const MANIFEST_FILENAME = "manifest.json";
  * Reads and shape-checks `<baselinesDir>/manifest.json`. Tolerant by design
  * (see {@link ManifestReadResult}): a missing file is the bootstrap case, a
  * malformed one is surfaced as a note rather than a crash. Shape validation is
- * intentionally shallow — enough to trust the field reads in {@link
+ * intentionally shallow, enough to trust the field reads in {@link
  * compareEnvironment}, not a full structural mirror.
  */
 export declare function readManifest(baselinesDir: string): Promise<ManifestReadResult>;
@@ -103,7 +103,7 @@ export declare function readManifest(baselinesDir: string): Promise<ManifestRead
  *
  * Exported so `approve --from` can run the same shape check against a candidate
  * artifact's `environment.actual` before promoting it into the committed
- * manifest — a well-formed-but-wrong-shaped environment block must fail closed,
+ * manifest. A well-formed-but-wrong-shaped environment block must fail closed,
  * not slip into `manifest.json` and silently defeat the drift gate.
  */
 export declare function validateManifestShape(value: unknown): string | undefined;
@@ -116,13 +116,13 @@ export interface EnvironmentComparison {
  * Compares a committed manifest read result against the environment captured
  * this run, returning which pixel-affecting keys diverged.
  *
- *   - `missing` — bootstrap: nothing to violate. `{ mismatch: false }`.
- *   - `malformed` — unreadable committed manifest: mismatch-with-note,
+ *   - `missing`: bootstrap: nothing to violate. `{ mismatch: false }`.
+ *   - `malformed`: unreadable committed manifest: mismatch-with-note,
  *     `mismatchKeys: ['manifest']` (see {@link MALFORMED_MANIFEST_KEY}).
- *   - `ok` — diff each {@link PIXEL_AFFECTING_KEYS}. `breakpoints` compares deep
+ *   - `ok`: diff each {@link PIXEL_AFFECTING_KEYS}. `breakpoints` compares deep
  *     and order-sensitively: the manifest records an ordered list, and a
  *     reorder (even at identical dimensions) is treated as a change worth a
- *     re-approve prompt rather than silently equal — order-sensitivity is the
+ *     re-approve prompt rather than silently equal. Order-sensitivity is the
  *     conservative pixel-safety choice. Informational keys
  *     (`tuffgalVersion`/`playwrightVersion`) are never compared.
  */
@@ -133,7 +133,7 @@ export interface CapturedBrowser {
     version: string;
 }
 /**
- * Builds the environment manifest describing THIS run — the "actual" side of
+ * Builds the environment manifest describing THIS run, the "actual" side of
  * the comparison and the block a later `approve --from` promotes into the
  * committed manifest. Everything except the live browser version is derived
  * from the resolved config and the host, so the caller only supplies the
@@ -142,7 +142,7 @@ export interface CapturedBrowser {
  * `deviceScaleFactor` is hardcoded `1`: the runner never sets `deviceScaleFactor`
  * on `browser.newContext` (see `runStory.ts`), so Playwright's default of `1`
  * applies. If a future wave makes the scale factor configurable, thread it here
- * and this constant must track it — the manifest's whole job is to notice a DSF
+ * and this constant must track it. The manifest's whole job is to notice a DSF
  * change, so a stale hardcode here would silently defeat that.
  */
 export declare function captureEnvironment(config: ResolvedConfig, browser: CapturedBrowser): EnvironmentManifest;

package/dist/runner/manifest.js

@@ -3,7 +3,7 @@ import { createRequire } from 'node:module';
 import { join } from 'node:path';
 /**
  * Bump when the capture pipeline changes behaviour in a way that shifts pixels
- * for the same input UI — a new default screenshot option, a change to how the
+ * for the same input UI: a new default screenshot option, a change to how the
  * clock is frozen, a mask-application tweak, etc. A committed baseline set was
  * rendered under one `CAPTURE_SCHEMA`; a run under a higher value is a pixel-
  * affecting mismatch (see {@link PIXEL_AFFECTING_KEYS}) that prompts re-approve.
@@ -22,7 +22,7 @@ export const SCHEMA_VERSION = 1;
  * shape, not the pixels); `tuffgalVersion`/`playwrightVersion` are excluded as
  * informational. `browser` is excluded because a browser-*name* change is
  * already implied by `browserVersion` (which carries the vendor+version string)
- * and the runner only launches chromium today — comparing the name would add a
+ * and the runner only launches chromium today. Comparing the name would add a
  * redundant key with no independent signal.
  */
 export const PIXEL_AFFECTING_KEYS = [
@@ -42,7 +42,7 @@ export const MANIFEST_FILENAME = 'manifest.json';
  * Reads and shape-checks `<baselinesDir>/manifest.json`. Tolerant by design
  * (see {@link ManifestReadResult}): a missing file is the bootstrap case, a
  * malformed one is surfaced as a note rather than a crash. Shape validation is
- * intentionally shallow — enough to trust the field reads in {@link
+ * intentionally shallow, enough to trust the field reads in {@link
  * compareEnvironment}, not a full structural mirror.
  */
 export async function readManifest(baselinesDir) {
@@ -75,7 +75,7 @@ export async function readManifest(baselinesDir) {
  *
  * Exported so `approve --from` can run the same shape check against a candidate
  * artifact's `environment.actual` before promoting it into the committed
- * manifest — a well-formed-but-wrong-shaped environment block must fail closed,
+ * manifest. A well-formed-but-wrong-shaped environment block must fail closed,
  * not slip into `manifest.json` and silently defeat the drift gate.
  */
 export function validateManifestShape(value) {
@@ -127,13 +127,13 @@ export function validateManifestShape(value) {
  * Compares a committed manifest read result against the environment captured
  * this run, returning which pixel-affecting keys diverged.
  *
- *   - `missing` — bootstrap: nothing to violate. `{ mismatch: false }`.
- *   - `malformed` — unreadable committed manifest: mismatch-with-note,
+ *   - `missing`: bootstrap: nothing to violate. `{ mismatch: false }`.
+ *   - `malformed`: unreadable committed manifest: mismatch-with-note,
  *     `mismatchKeys: ['manifest']` (see {@link MALFORMED_MANIFEST_KEY}).
- *   - `ok` — diff each {@link PIXEL_AFFECTING_KEYS}. `breakpoints` compares deep
+ *   - `ok`: diff each {@link PIXEL_AFFECTING_KEYS}. `breakpoints` compares deep
  *     and order-sensitively: the manifest records an ordered list, and a
  *     reorder (even at identical dimensions) is treated as a change worth a
- *     re-approve prompt rather than silently equal — order-sensitivity is the
+ *     re-approve prompt rather than silently equal. Order-sensitivity is the
  *     conservative pixel-safety choice. Informational keys
  *     (`tuffgalVersion`/`playwrightVersion`) are never compared.
  */
@@ -161,7 +161,7 @@ export function compareEnvironment(expected, actual) {
 }
 /**
  * Deep, order-sensitive equality of two breakpoint lists: same length, and each
- * position matches on `name`/`width`/`height`. Order-sensitive on purpose — see
+ * position matches on `name`/`width`/`height`. Order-sensitive on purpose. See
  * {@link compareEnvironment}.
  */
 function breakpointsEqual(a, b) {
@@ -178,7 +178,7 @@ function breakpointsEqual(a, b) {
 const requirePackage = createRequire(import.meta.url);
 /**
  * Reads tuffgal's own version from its `package.json`. Resolved relative to this
- * module so it works from both `src/` (dev/test) and the built `dist/` tree —
+ * module so it works from both `src/` (dev/test) and the built `dist/` tree.
  * `../../package.json` is the package root in both layouts. Informational only.
  */
 function readTuffgalVersion() {
@@ -195,7 +195,7 @@ function readPlaywrightVersion() {
     return pkg.version;
 }
 /**
- * Builds the environment manifest describing THIS run — the "actual" side of
+ * Builds the environment manifest describing THIS run, the "actual" side of
  * the comparison and the block a later `approve --from` promotes into the
  * committed manifest. Everything except the live browser version is derived
  * from the resolved config and the host, so the caller only supplies the
@@ -204,7 +204,7 @@ function readPlaywrightVersion() {
  * `deviceScaleFactor` is hardcoded `1`: the runner never sets `deviceScaleFactor`
  * on `browser.newContext` (see `runStory.ts`), so Playwright's default of `1`
  * applies. If a future wave makes the scale factor configurable, thread it here
- * and this constant must track it — the manifest's whole job is to notice a DSF
+ * and this constant must track it. The manifest's whole job is to notice a DSF
  * change, so a stale hardcode here would silently defeat that.
  */
 export function captureEnvironment(config, browser) {

package/dist/runner/mode.d.ts

@@ -26,13 +26,13 @@ export interface RunModeInputs {
  *   - `--ci` and `--local` are mutually exclusive; passing both throws.
  *   - An explicit flag always wins over the environment.
  *   - With no flag, default to `ci` when `CI` is truthy (non-empty and not an
- *     explicit negation — see {@link FALSY_CI}), else `local`.
+ *     explicit negation, see {@link FALSY_CI}), else `local`.
  */
 export declare function resolveRunMode(inputs: RunModeInputs): RunMode;
 /**
  * The baseline root a run compares against for the given mode: the committed
  * `paths.baselines` set in CI mode, the per-machine gitignored `paths.localCache`
- * in local mode. This is the single source of the mode→root mapping — both the
+ * in local mode. This is the single source of the mode→root mapping, both the
  * per-action comparison in `runAction` and the screen-coverage metric in `run`
  * select their root through here, so the two can never drift. Encodes the PRD
  * invariant that a local run never reads `paths.baselines`.

package/dist/runner/mode.js

@@ -1,8 +1,8 @@
 /**
  * Strings a CI system might export to explicitly opt OUT of CI behaviour. Most
  * CI providers (GitHub Actions, Travis, CircleCI, GitLab, …) set `CI=true`, but
- * the de-facto convention — as codified by the widely-used `ci-info`/`is-ci`
- * packages — is that any non-empty `CI` value counts as "in CI" unless it is one
+ * the de-facto convention (as codified by the widely-used `ci-info`/`is-ci`
+ * packages) is that any non-empty `CI` value counts as "in CI" unless it is one
  * of these explicit negations. We mirror that so a developer who exports
  * `CI=false` locally still gets local mode.
  */
@@ -13,7 +13,7 @@ const FALSY_CI = new Set(['', '0', 'false']);
  *   - `--ci` and `--local` are mutually exclusive; passing both throws.
  *   - An explicit flag always wins over the environment.
  *   - With no flag, default to `ci` when `CI` is truthy (non-empty and not an
- *     explicit negation — see {@link FALSY_CI}), else `local`.
+ *     explicit negation, see {@link FALSY_CI}), else `local`.
  */
 export function resolveRunMode(inputs) {
     if (inputs.ci && inputs.local) {
@@ -32,7 +32,7 @@ export function resolveRunMode(inputs) {
 /**
  * The baseline root a run compares against for the given mode: the committed
  * `paths.baselines` set in CI mode, the per-machine gitignored `paths.localCache`
- * in local mode. This is the single source of the mode→root mapping — both the
+ * in local mode. This is the single source of the mode→root mapping, both the
  * per-action comparison in `runAction` and the screen-coverage metric in `run`
  * select their root through here, so the two can never drift. Encodes the PRD
  * invariant that a local run never reads `paths.baselines`.

package/dist/runner/orphanScan.d.ts

@@ -34,16 +34,16 @@ export declare function shouldScanForOrphans(mode: RunMode, storyFilter: string
 /**
  * The distinct set of action names that ran at least one result this run. An
  * action directory under `paths.baselines` whose name is absent from this set
- * had no story compare against it — it is a candidate orphan. Derived from the
+ * had no story compare against it. It is a candidate orphan. Derived from the
  * flat `stories[].actions[]` walk so `skipped` entries (an earlier step failed)
  * still count the action as executed: the baseline was reachable this run, the
- * story simply broke before reaching it, which is a failure to surface — not a
+ * story simply broke before reaching it, which is a failure to surface, not a
  * baseline to retire.
  */
 export declare function executedActionNames(stories: RunResult['stories']): Set<string>;
 /**
  * Scans `baselinesDir` for orphaned committed baselines: action directories no
- * story executed this run. Detection only — the returned entries carry the
+ * story executed this run. Detection only. The returned entries carry the
  * absolute paths a later `approve --prune` deletes; this function never touches
  * the filesystem beyond reading directory listings.
  *

package/dist/runner/orphanScan.js

@@ -22,7 +22,7 @@ export const LEGACY_BREAKPOINT = 'legacy';
  * Non-action files that may sit at the baselines root and must never be treated
  * as orphan candidates. `manifest.json` (the environment manifest, wave 6) is
  * the known one; it is a file, not an action directory, so the readdir walk
- * already skips it by virtue of only descending into directories — this set is a
+ * already skips it by virtue of only descending into directories. This set is a
  * belt-and-suspenders guard for any future flat file a sibling wave drops here.
  */
 const NON_ACTION_ENTRIES = new Set(['manifest.json']);
@@ -44,10 +44,10 @@ export function shouldScanForOrphans(mode, storyFilter) {
 /**
  * The distinct set of action names that ran at least one result this run. An
  * action directory under `paths.baselines` whose name is absent from this set
- * had no story compare against it — it is a candidate orphan. Derived from the
+ * had no story compare against it. It is a candidate orphan. Derived from the
  * flat `stories[].actions[]` walk so `skipped` entries (an earlier step failed)
  * still count the action as executed: the baseline was reachable this run, the
- * story simply broke before reaching it, which is a failure to surface — not a
+ * story simply broke before reaching it, which is a failure to surface, not a
  * baseline to retire.
  */
 export function executedActionNames(stories) {
@@ -61,7 +61,7 @@ export function executedActionNames(stories) {
 }
 /**
  * Scans `baselinesDir` for orphaned committed baselines: action directories no
- * story executed this run. Detection only — the returned entries carry the
+ * story executed this run. Detection only. The returned entries carry the
  * absolute paths a later `approve --prune` deletes; this function never touches
  * the filesystem beyond reading directory listings.
  *
@@ -92,7 +92,7 @@ export async function scanOrphanedBaselines(baselinesDir, executed) {
         }));
     }
     catch {
-        // No baselines directory yet (a never-approved project) — nothing to orphan.
+        // No baselines directory yet (a never-approved project), nothing to orphan.
         return [];
     }
     const orphans = [];

package/dist/runner/orphanScan.js.map

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

package/dist/runner/resolveLocator.d.ts

@@ -2,14 +2,14 @@ import type { Locator, Page } from 'playwright';
 import type { Hint } from '../schema/action.ts';
 /**
  * Resolves a hint to a Playwright Locator using a precedence chain. The MVP
- * intentionally stays literal — no LLM fallback. When this throws,
+ * intentionally stays literal, no LLM fallback. When this throws,
  * `runAction` records `LocatorNotFound` and the parent story fails fast.
  *
  * Order:
- *  1. `role + text`  — strongest ARIA contract.
- *  2. `role` alone   — when no name is supplied.
- *  3. `selector`     — explicit escape hatch / cached resolution.
- *  4. `text` alone   — last resort because text-only locators are noisy.
+ *  1. `role + text`: strongest ARIA contract.
+ *  2. `role` alone: when no name is supplied.
+ *  3. `selector`: explicit escape hatch / cached resolution.
+ *  4. `text` alone: last resort because text-only locators are noisy.
  */
 export declare function resolveLocator(page: Page, hint: Hint): Locator;
 export declare class LocatorHintError extends Error {

package/dist/runner/resolveLocator.js

@@ -1,13 +1,13 @@
 /**
  * Resolves a hint to a Playwright Locator using a precedence chain. The MVP
- * intentionally stays literal — no LLM fallback. When this throws,
+ * intentionally stays literal, no LLM fallback. When this throws,
  * `runAction` records `LocatorNotFound` and the parent story fails fast.
  *
  * Order:
- *  1. `role + text`  — strongest ARIA contract.
- *  2. `role` alone   — when no name is supplied.
- *  3. `selector`     — explicit escape hatch / cached resolution.
- *  4. `text` alone   — last resort because text-only locators are noisy.
+ *  1. `role + text`: strongest ARIA contract.
+ *  2. `role` alone: when no name is supplied.
+ *  3. `selector`: explicit escape hatch / cached resolution.
+ *  4. `text` alone: last resort because text-only locators are noisy.
  */
 export function resolveLocator(page, hint) {
     if (hint.role && hint.text) {
@@ -22,7 +22,7 @@ export function resolveLocator(page, hint) {
     if (hint.text) {
         return page.getByText(hint.text, { exact: false });
     }
-    throw new LocatorHintError('hint has no role, selector, or text — cannot resolve');
+    throw new LocatorHintError('hint has no role, selector, or text; cannot resolve');
 }
 export class LocatorHintError extends Error {
     constructor(message) {

package/dist/runner/resolveLocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveLocator.js","sourceRoot":"","sources":["../../src/runner/resolveLocator.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,IAAU;IACnD,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,gBAAgB,CACxB,sDAAsD,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,KAAK,CAAW;IAClC,YAAY,IAAU,EAAE,KAAe;QACrC,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"resolveLocator.js","sourceRoot":"","sources":["../../src/runner/resolveLocator.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,IAAU;IACnD,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,gBAAgB,CACxB,qDAAqD,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,KAAK,CAAW;IAClC,YAAY,IAAU,EAAE,KAAe;QACrC,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/runner/run.d.ts

@@ -1,5 +1,7 @@
+import { type Browser } from 'playwright';
 import type { ResolvedConfig } from '../config.ts';
 import type { EnvironmentReport, RunResult, StoryResult, StoryStatus } from '../schema/result.ts';
+import { type ManagedDevServers } from './bridges/devServers.ts';
 import { type RunMode } from './mode.ts';
 import { type CapturedBrowser } from './manifest.ts';
 export interface RunCliOptions {
@@ -21,16 +23,49 @@ export interface RunCliOptions {
  * Loads every action and story from the configured paths, resets the
  * consumer-supplied test database, schedules stories according to their
  * needs/produces DAG, and drives execution across a fixed worker pool.
- * Returns the aggregate `RunResult` so the CLI can set the process exit
- * code.
+ * Returns the aggregate `RunResult` so the CLI can set the process exit code.
+ *
+ * Owns the run's shared lifecycle: it launches ONE browser (injectable via
+ * `launchBrowser` for tests) that every story reuses (each opening its own
+ * isolated context per breakpoint) and registers a SIGINT/SIGTERM handler that
+ * closes that browser and stops any `--manage-servers` dev-servers before
+ * exiting non-zero, so an interrupted run (Ctrl-C, CI cancel) orphans neither.
+ * Both the normal finally path and the signal handler tear down through the
+ * same idempotent {@link createRunTeardown}, so nothing double-closes.
+ */
+export declare function runAll(config: ResolvedConfig, options: RunCliOptions, launchBrowser?: () => Promise<Browser>): Promise<RunResult>;
+/** The run's teardownable handles: the shared browser and any managed servers. */
+interface RunHandles {
+    browser?: Pick<Browser, 'close'>;
+    managedServers?: ManagedDevServers;
+}
+/**
+ * Builds the run's single teardown: closes the shared browser and stops any
+ * managed dev-servers, exactly once. The `done` latch makes it idempotent so
+ * the normal finally path and a racing signal handler cannot double-close.
+ * Whichever calls first tears down, the other is a no-op. Reads the handles off
+ * the shared object at CALL time (not capture time), so a signal that arrives
+ * mid-setup still tears down whatever has been launched so far. `allSettled`
+ * closes both independently: a browser that throws on close must not prevent
+ * the dev-servers from being stopped.
+ */
+export declare function createRunTeardown(handles: RunHandles): () => Promise<void>;
+/**
+ * Wraps a {@link createRunTeardown} teardown in a SIGINT/SIGTERM handler: tear
+ * the run's handles down, then exit non-zero (an interrupted run is a failure,
+ * not a clean pass). `exit` is injected (defaulting to `process.exit`) so a
+ * test can drive the handler directly, asserting it closes the browser, stops
+ * the servers, and requests a non-zero exit, without raising a real signal in
+ * the test runner. Idempotent by construction: it delegates to the shared
+ * teardown, so a second signal cannot double-close.
  */
-export declare function runAll(config: ResolvedConfig, options: RunCliOptions): Promise<RunResult>;
+export declare function createSignalTeardownHandler(teardown: () => Promise<void>, exit?: (code: number) => void): () => void;
 /**
  * Copies the just-written `results.json` into `<report>/candidates/` so the
  * candidate tree is a self-contained approval artifact. `writeReport` has
  * already written `<report>/results.json`; this places a sibling copy under
  * candidates. The candidates dir may not exist yet (a run where every action
- * passed writes no candidate renders), so it is created first — an empty
+ * passed writes no candidate renders), so it is created first. An empty
  * `candidates/` carrying only `results.json` still correctly describes "nothing
  * to approve".
  */
@@ -40,21 +75,21 @@ export declare function copyResultsIntoCandidates(reportDir: string): Promise<vo
  * `paths.baselines` in CI mode, per-machine `paths.localCache` in local mode.
  * A thin, coverage-named alias over the shared {@link comparisonRootFor} so the
  * metric counts screens against the SAME set the run (via `runAction`) diffed
- * against — the mode→root mapping now lives once, in `mode.ts`. Preserved as a
+ * against. The mode→root mapping now lives once, in `mode.ts`. Preserved as a
  * named export because the coverage metric's PRD invariant (a local run never
  * reads `paths.baselines`) reads most clearly against a coverage-specific name.
  */
 export declare function coverageComparisonRoot(config: ResolvedConfig, mode: RunMode): string;
 /**
  * Builds the run's {@link EnvironmentReport}: the environment this run captured
- * under (`actual`), and — in CI mode — the committed `<baselines>/manifest.json`
+ * under (`actual`), and (in CI mode) the committed `<baselines>/manifest.json`
  * (`expected`) plus whether their pixel-affecting keys diverge.
  *
- * The live browser-version probe ({@link captureBrowserIdentity}) runs in CI
- * mode ONLY. Local mode never reads `paths.baselines`, so `expected` is always
- * `null` and `browserVersion` is never compared against anything — launching a
- * throwaway chromium just to stamp a value nothing reads is pure cost, so local
- * mode fills the browser identity with an empty sentinel and skips the probe.
+ * The live browser-version probe runs in CI mode ONLY. Local mode never reads
+ * `paths.baselines`, so `expected` is always `null` and `browserVersion` is
+ * never compared against anything. Reading a browser version just to stamp a
+ * value nothing reads is pure cost, so local mode fills the browser identity
+ * with an empty sentinel and skips the probe entirely.
  *
  * In CI mode a missing manifest is the bootstrap case (no expectation yet, no
  * mismatch); a malformed one surfaces as a mismatch note (see
@@ -62,16 +97,17 @@ export declare function coverageComparisonRoot(config: ResolvedConfig, mode: Run
  * it read cleanly, so a malformed file reports `null` here while still driving a
  * mismatch.
  *
- * `probe` is the live browser-identity reader, injected (defaulting to the real
- * {@link captureBrowserIdentity}) so a test can assert it is invoked in CI mode
- * and NEVER invoked in local mode without launching a real chromium.
+ * `probe` is the live browser-identity reader. `runAll` passes one that reads
+ * the run's SHARED browser handle (`browser.version()`), so no throwaway
+ * Chromium is launched just to stamp the version; a test injects its own probe
+ * to assert it is invoked in CI mode and NEVER invoked in local mode.
  */
-export declare function resolveEnvironmentReport(config: ResolvedConfig, mode: RunMode, probe?: () => Promise<CapturedBrowser>): Promise<EnvironmentReport>;
+export declare function resolveEnvironmentReport(config: ResolvedConfig, mode: RunMode, probe: () => Promise<CapturedBrowser>): Promise<EnvironmentReport>;
 /**
  * Rolls a set of story results into the outcome counts. `deleted` counts
  * orphaned baselines, which are a run-level detection (not a per-story outcome),
  * so it always seeds `0` here; `runAll` overwrites the run-total `deleted` from
- * the orphan scan. Per-breakpoint pass summaries keep `0`, which is correct —
+ * the orphan scan. Per-breakpoint pass summaries keep `0`, which is correct.
  * an orphan is not attributable to a single breakpoint pass.
  */
 export declare function summarise(results: StoryResult[]): RunResult['totals'];
@@ -85,13 +121,13 @@ export declare function formatResultLine(status: StoryStatus, actionCount: numbe
 /**
  * One Summary bullet for a breakpoint pass: `• <parts> on "<name>" breakpoint`,
  * where `<parts>` joins only the nonzero outcome categories in a fixed order
- * (passed, new, changed, failed) — e.g. `2 passed, 1 changed`. Falls back to
+ * (passed, new, changed, failed), e.g. `2 passed, 1 changed`. Falls back to
  * `0 passed` for the degenerate all-zero pass the run loop never actually
  * emits (it `continue`s past a pass with no participating stories).
  */
 export declare function formatSummaryBullet(name: string, counts: RunResult['totals']): string;
 /**
- * The breakpoint names that drove a merged story to its status — the modes the
+ * The breakpoint names that drove a merged story to its status, the modes the
  * reader actually needs to inspect. A `changed` story that drifted only at
  * `desktop` tags `[desktop]`, not the `mobile` pass that stayed clean. Returns
  * empty (no tag) when the story spans a single breakpoint, since there is
@@ -99,4 +135,5 @@ export declare function formatSummaryBullet(name: string, counts: RunResult['tot
  * tag, so this is derived, not separately tracked.
  */
 export declare function drivingBreakpoints(result: StoryResult): string[];
+export {};
 //# sourceMappingURL=run.d.ts.map

package/dist/runner/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,WAAW,EACZ,MAAM,qBAAqB,CAAC;AA8B7B,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAUD;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,CAAC,CA0KpB;AA4DD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,MAAM,CAER;AA6BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,EACb,KAAK,GAAE,MAAM,OAAO,CAAC,eAAe,CAA0B,GAC7D,OAAO,CAAC,iBAAiB,CAAC,CAe5B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CASrE;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAC1B,MAAM,CAQR;AAoBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAuBhE"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAqBjC,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,EACtB,aAAa,GAAE,MAAM,OAAO,CAAC,OAAO,CACY,GAC/C,OAAO,CAAC,SAAS,CAAC,CAkMpB;AAED,kFAAkF;AAClF,UAAU,UAAU;IAClB,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAU1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC7B,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAmC,GAC1D,MAAM,IAAI,CAIZ;AAoED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,MAAM,CAER;AAYD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAe5B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CASrE;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAC1B,MAAM,CAQR;AAoBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAuBhE"}