fast-replay 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { Command } from 'commander';
+import { list, PartialRecordingError, record, run, STOP_HOTKEY } from '../api.js';
+import { IRValidationError } from '../ir/schema.js';
+import { age, bold, cyan, dim, green, ms, red, table, truncate, yellow } from './format.js';
+import { VERSION } from '../version.js';
+const program = new Command();
+program
+    .name('repro')
+    .description('Record a bug once, verify the fix in seconds.')
+    // Read from the manifest so a build can never misreport which one it is.
+    .version(VERSION);
+program
+    .command('record')
+    .argument('<name>', 'name for this repro')
+    .requiredOption('-u, --url <baseUrl>', 'base URL of your dev server, e.g. http://localhost:3000')
+    .option('-p, --path <startPath>', 'path to start recording at', '/')
+    .option('--viewport <WxH>', 'browser viewport', '1440x900')
+    .option('--storage-state <file>', 'seed cookies/localStorage/IndexedDB from a Playwright state file')
+    .option('--profile <dir>', 'record against a persistent Chromium profile (reuses a login)')
+    .description('launch an instrumented browser and record a bug reproduction')
+    .action(async (name, opts) => {
+    const viewport = parseViewport(opts.viewport);
+    const { repro, irPath, stopReason } = await record({
+        name,
+        baseUrl: opts.url,
+        startPath: opts.path,
+        viewport,
+        storageStatePath: opts.storageState ?? null,
+        profileDir: opts.profile ?? null,
+        onReady: () => {
+            console.log(`${green('●')} ${bold('Recording')} ${cyan(name)} on ${opts.url}${opts.path}`);
+            console.log(dim(`  Reproduce the bug, then press ${STOP_HOTKEY} — or just close the browser.`));
+            console.log('');
+        },
+    });
+    if (!repro.steps.length) {
+        console.log(yellow('No actions captured — nothing was written.'));
+        console.log(dim('  If you did interact, check that the app loaded before you started.'));
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`${green('✓')} Captured ${bold(String(repro.steps.length))} steps ${dim(`(stopped: ${stopReason})`)}`);
+    console.log(`  ${dim('→')} ${path.relative(process.cwd(), irPath)}`);
+    const { invariants, observedAtRecord } = repro.assertion;
+    if (!invariants.noConsoleErrors || !invariants.noFailedRequests) {
+        console.log('');
+        console.log(yellow('  The bug was observed while recording:'));
+        for (const e of observedAtRecord?.consoleErrors ?? []) {
+            console.log(dim(`    console  ${truncate(e, 100)}`));
+        }
+        for (const f of observedAtRecord?.failedRequests ?? []) {
+            console.log(dim(`    network  ${f.method} ${f.urlPattern} -> ${f.status ?? 'aborted'}`));
+        }
+        console.log(dim('    Those invariants are off so the repro passes its own replay; the evidence is'));
+        console.log(dim('    kept under assertion.observedAtRecord.'));
+    }
+});
+program
+    .command('run')
+    .argument('<name>', 'name of the repro to replay')
+    .option('--headed', 'watch the replay in a visible browser', false)
+    .option('--expect-fixed', 'pass when the bug no longer happens — use while fixing', false)
+    .option('-u, --url <baseUrl>', 'override the recorded base URL')
+    .option('--profile <dir>', 'replay against a persistent Chromium profile (reuses a login)')
+    .option('--setup <command>', 'shell command to reset state before replaying')
+    .option('--timeout-scale <n>', 'multiply every recorded wait; raise on slow machines', '1')
+    .option('--resolve-timeout <ms>', 'budget for the first selector candidate; raise it for slow-booting SPAs', '800')
+    .description('replay a repro at machine speed and assert the recorded outcome')
+    .action(async (name, opts) => {
+    const first = Number(opts.resolveTimeout);
+    if (!Number.isFinite(first) || first <= 0) {
+        throw new Error(`Invalid --resolve-timeout "${opts.resolveTimeout}". Expected milliseconds.`);
+    }
+    const result = await run({
+        name,
+        headed: opts.headed,
+        baseUrl: opts.url,
+        expectFixed: opts.expectFixed,
+        profileDir: opts.profile ?? null,
+        setupCommand: opts.setup ?? null,
+        timeoutScale: Number(opts.timeoutScale) || 1,
+        // Fallbacks stay cheap probes: half the primary budget.
+        resolveTimeouts: { first, subsequent: Math.max(200, Math.round(first / 2)) },
+    });
+    result.passed ? reportPass(result) : reportFail(result);
+    process.exitCode = result.passed ? 0 : 1;
+});
+program
+    .command('list')
+    .description('list recorded repros with their last result and age')
+    .action(async () => {
+    const repros = await list();
+    if (!repros.length) {
+        console.log(dim('No repros yet. Record one with:  repro record <name> --url http://localhost:3000'));
+        return;
+    }
+    const rows = [
+        [bold('NAME'), bold('STEPS'), bold('LAST RUN'), bold('AGE')],
+        ...repros.map((r) => {
+            if (r.error)
+                return [cyan(r.name), dim('—'), red('invalid IR'), age(r.createdAt)];
+            const last = r.lastResult;
+            const status = !last
+                ? dim('never run')
+                : last.status === 'pass'
+                    ? green(`pass ${dim(`(${ms(last.durationMs)}, ${age(last.at)} ago)`)}`)
+                    : red(`fail ${dim(`at ${last.failedStepId ?? '?'}, ${age(last.at)} ago`)}`);
+            return [cyan(r.name), String(r.steps ?? '—'), status, age(r.createdAt)];
+        }),
+    ];
+    console.log(table(rows));
+});
+function reportPass(result) {
+    const rows = [
+        [bold('STEP'), bold('ACTION'), bold('ACT'), bold('WAIT'), bold('TOTAL'), bold('WHAT')],
+        ...result.timings.map((t) => [
+            t.id,
+            t.action,
+            ms(t.actMs),
+            ms(t.waitMs),
+            ms(t.totalMs),
+            t.candidateIndex > 0
+                ? `${truncate(t.semantic, 52)} ${yellow(`(fallback selector #${t.candidateIndex})`)}`
+                : dim(truncate(t.semantic, 52)),
+        ]),
+    ];
+    console.log(table(rows));
+    for (const note of result.notes)
+        console.log(dim(`  note  ${note}`));
+    console.log('');
+    const verdict = result.expectFixed
+        ? `${green('✓ FIXED')} ${dim('— the flow completed and the bug did not happen')}`
+        : `${green('✓ PASS')}  ${dim('— the recorded outcome still occurs')}`;
+    console.log(`${verdict}  ${bold(result.name)} ${dim(`(${result.timings.length} steps in ${ms(result.durationMs)})`)}`);
+}
+function reportFail(result) {
+    const f = result.failure;
+    // An infrastructure failure says nothing about the bug. Reporting it as
+    // "NOT FIXED" sends people chasing a bug they have already fixed.
+    const infra = f?.kind === 'infrastructure';
+    const label = infra ? '✗ COULD NOT VERIFY' : result.expectFixed ? '✗ NOT FIXED' : '✗ FAIL';
+    console.log(`${red(label)}  ${bold(result.name)} ${dim(`after ${ms(result.durationMs)}`)}`);
+    if (!f)
+        return;
+    if (infra) {
+        console.log(dim('  The replay could not drive the app, so this is not a verdict on the bug.'));
+        console.log(dim('  Fix the step below, or raise --resolve-timeout / --timeout-scale.'));
+    }
+    console.log('');
+    console.log(`  ${bold('Step')}      ${f.stepId} ${dim(`(step ${f.stepIndex + 1} of ${result.totalSteps})`)}`);
+    console.log(`  ${bold('Target')}    ${f.semantic}`);
+    console.log(`  ${bold('Expected')}  ${f.expected}`);
+    console.log(`  ${bold('Observed')}  ${f.observed}`);
+    if (f.artifacts) {
+        console.log('');
+        console.log(`  ${bold('Artifacts')} ${dim(path.relative(process.cwd(), f.artifacts.dir))}`);
+        for (const [label, file] of [
+            ['screenshot', f.artifacts.screenshot],
+            ['console', f.artifacts.consoleLog],
+            ['network', f.artifacts.networkLog],
+        ]) {
+            if (file)
+                console.log(dim(`    ${label.padEnd(11)}${path.relative(process.cwd(), file)}`));
+        }
+    }
+}
+function parseViewport(value) {
+    const match = /^(\d+)x(\d+)$/.exec(value.trim());
+    if (!match)
+        throw new Error(`Invalid --viewport "${value}". Expected WxH, e.g. 1440x900.`);
+    return { width: Number(match[1]), height: Number(match[2]) };
+}
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (err) {
+        if (err instanceof PartialRecordingError) {
+            // The steps captured before the failure are on disk and worth having.
+            console.error(`${yellow('!')} ${err.message}`);
+            console.error(dim(`  Inspect it, trim the last step, and re-run — or re-record.`));
+            process.exitCode = 1;
+            return;
+        }
+        if (err instanceof IRValidationError) {
+            // Schema errors are the user's to fix by hand — show every issue at once.
+            console.error(red('✗ Invalid repro file'));
+            console.error(err.message);
+        }
+        else {
+            console.error(`${red('✗')} ${err.message}`);
+        }
+        process.exitCode = 1;
+    }
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/compiler/compile.d.ts

@@ -0,0 +1,18 @@
+import { type Assertion, type Repro, type Step } from '../ir/schema.js';
+import type { RecordingTrace } from '../recorder/types.js';
+import { type WaitRules } from './waits.js';
+export interface CompileOptions {
+    name: string;
+    storageStatePath: string | null;
+    createdAt?: string;
+    waitRules?: WaitRules;
+}
+export declare function compile(trace: RecordingTrace, options: CompileOptions): Repro;
+/**
+ * Phase 0's assertion is whatever the recording ended in. Because a repro
+ * captures the BUG, an invariant that the recording itself violated is not a
+ * usable check — it would make a fresh repro fail its own replay. Those get
+ * switched off here, and the violation is preserved under `observedAtRecord`
+ * so `--expect-fixed` can later assert the bug is gone.
+ */
+export declare function deriveAssertion(steps: Step[], trace: RecordingTrace): Assertion;

package/dist/compiler/compile.js

@@ -0,0 +1,226 @@
+import { IR_VERSION, } from '../ir/schema.js';
+import { isAmbientConsoleError, isIncidentalRequest } from '../noise.js';
+import { isSameOrigin, normalizeUrlPattern } from './normalize.js';
+import { buildWaitAfter, DEFAULT_WAIT_RULES } from './waits.js';
+/** A click and a dblclick on the same element this close together are one gesture. */
+const DBLCLICK_MERGE_MS = 600;
+/** A navigation this soon after an action is that action's consequence, not a step. */
+const NAV_ATTRIBUTION_MS = 1_000;
+/**
+ * Drop the two clicks that the browser necessarily fires before a dblclick.
+ * Replaying click-click-dblclick would triple-fire the handler.
+ */
+function mergeDoubleClicks(actions) {
+    const out = [];
+    for (const action of actions) {
+        if (action.action === 'dblclick') {
+            const key = action.target?.candidates[0];
+            while (out.length) {
+                const prev = out[out.length - 1];
+                if (!prev)
+                    break;
+                const sameTarget = prev.target?.candidates[0] === key;
+                if (prev.action === 'click' && sameTarget && action.t - prev.t <= DBLCLICK_MERGE_MS) {
+                    out.pop();
+                    continue;
+                }
+                break;
+            }
+        }
+        out.push(action);
+    }
+    return out;
+}
+/**
+ * Navigations become steps only when nothing the user did explains them —
+ * a typed URL or a back button. A navigation caused by clicking a link is the
+ * click's reaction, and replaying both would double-navigate.
+ */
+function interleaveNavigations(actions, trace) {
+    const merged = actions.map((a) => ({ ...a }));
+    for (const nav of trace.navigations) {
+        const caused = actions.some((a) => nav.t - a.t >= 0 && nav.t - a.t <= NAV_ATTRIBUTION_MS);
+        if (caused)
+            continue;
+        merged.push({
+            kind: 'action',
+            action: 'goto',
+            value: nav.url,
+            target: null,
+            t: nav.t,
+            author: 'human',
+            syntheticUrl: nav.url,
+        });
+    }
+    return merged.sort((a, b) => a.t - b.t);
+}
+/** Collapse runs of scrolls on the same target down to the final position. */
+function collapseScrolls(actions) {
+    const out = [];
+    for (const action of actions) {
+        const prev = out[out.length - 1];
+        if (prev &&
+            action.action === 'scroll' &&
+            prev.action === 'scroll' &&
+            prev.target?.candidates[0] === action.target?.candidates[0]) {
+            out[out.length - 1] = action;
+            continue;
+        }
+        out.push(action);
+    }
+    return out;
+}
+export function compile(trace, options) {
+    const rules = options.waitRules ?? DEFAULT_WAIT_RULES;
+    const merged = collapseScrolls(interleaveNavigations(mergeDoubleClicks(trace.actions), trace));
+    const traceEnd = trace.endedAt || Date.now();
+    const steps = merged.map((action, index) => {
+        const next = merged[index + 1];
+        const windowEnd = next ? next.t : traceEnd;
+        const step = {
+            id: `s${index + 1}`,
+            action: action.action,
+            value: action.value,
+            waitAfter: buildWaitAfter({
+                actionAt: action.t,
+                windowEnd,
+                network: trace.network,
+                dom: trace.dom,
+                baseUrl: trace.baseUrl,
+            }, rules),
+            author: action.author,
+        };
+        if (action.target) {
+            step.target = { candidates: action.target.candidates, semantic: action.target.semantic };
+        }
+        return step;
+    });
+    dropRerenderChurn(steps);
+    return {
+        version: IR_VERSION,
+        name: options.name,
+        createdAt: options.createdAt ?? new Date().toISOString(),
+        baseUrl: trace.baseUrl,
+        startPath: trace.startPath,
+        viewport: trace.viewport,
+        storageStatePath: options.storageStatePath,
+        steps,
+        assertion: deriveAssertion(steps, trace),
+    };
+}
+/** An error is the flow's evidence only if it landed in some action's wake. */
+const REACTION_WINDOW_MS = 3_000;
+/**
+ * Separate the app's noise from the bug's evidence.
+ *
+ * Splitting on "before the first action" was not stable: whether a boot error
+ * landed in one bucket or the other depended on how quickly the recording
+ * started clicking, so the same app and the same flow classified the same two
+ * errors differently from run to run — and a recording that happened to start
+ * fast treated boot chatter as the bug's signature.
+ *
+ * Causation is the stable question. Background noise fires whenever it fires;
+ * evidence of a bug fires in the wake of an action. Anything outside every
+ * action's reaction window is the app talking to itself, whenever it happened.
+ *
+ * The per-repro `ambient` list therefore holds only THIS app's own chatter.
+ * Noise common to every app is handled by the shared filter and never recorded
+ * here, so it cannot disable an otherwise dependable invariant.
+ */
+function splitConsole(trace) {
+    const signature = [];
+    const ambient = [];
+    for (const entry of trace.console) {
+        // Noise every app produces is filtered identically on both sides, so it
+        // needs no per-repro baseline and must not weaken the invariant.
+        if (isAmbientConsoleError(entry.text))
+            continue;
+        // With no actions there is no causation to reason about, and nothing to
+        // disprove attribution — so the error stands as evidence.
+        if (!trace.actions.length) {
+            signature.push(entry.text);
+            continue;
+        }
+        const inWake = trace.actions.some((a) => entry.t >= a.t && entry.t <= a.t + REACTION_WINDOW_MS);
+        (inWake ? signature : ambient).push(entry.text);
+    }
+    const ambientSet = new Set(ambient);
+    return {
+        // An error that also fires unprompted is noise even when it recurs after an
+        // action, so ambient always wins the tie.
+        signature: Array.from(new Set(signature)).filter((t) => !ambientSet.has(t)),
+        ambient: Array.from(ambientSet),
+    };
+}
+/**
+ * A selector that vanishes on one step and returns on the next is a component
+ * re-mounting, not a state change. Replay sees the element present throughout
+ * and can satisfy neither half, so both are dropped.
+ */
+function dropRerenderChurn(steps) {
+    for (let i = 0; i < steps.length - 1; i++) {
+        const a = steps[i];
+        const b = steps[i + 1];
+        if (!a || !b)
+            continue;
+        const gone = new Set(a.waitAfter.domGone ?? []);
+        const churned = (b.waitAfter.domAppeared ?? []).filter((s) => gone.has(s));
+        if (!churned.length)
+            continue;
+        a.waitAfter.domGone = (a.waitAfter.domGone ?? []).filter((s) => !churned.includes(s));
+        b.waitAfter.domAppeared = (b.waitAfter.domAppeared ?? []).filter((s) => !churned.includes(s));
+        if (!a.waitAfter.domGone.length)
+            delete a.waitAfter.domGone;
+        if (!b.waitAfter.domAppeared.length)
+            delete b.waitAfter.domAppeared;
+    }
+}
+/**
+ * Phase 0's assertion is whatever the recording ended in. Because a repro
+ * captures the BUG, an invariant that the recording itself violated is not a
+ * usable check — it would make a fresh repro fail its own replay. Those get
+ * switched off here, and the violation is preserved under `observedAtRecord`
+ * so `--expect-fixed` can later assert the bug is gone.
+ */
+export function deriveAssertion(steps, trace) {
+    const last = steps[steps.length - 1];
+    const finalState = {};
+    if (last) {
+        if (last.waitAfter.domAppeared?.length)
+            finalState.domAppeared = last.waitAfter.domAppeared;
+        if (last.waitAfter.domGone?.length)
+            finalState.domGone = last.waitAfter.domGone;
+        if (last.waitAfter.network?.length)
+            finalState.network = last.waitAfter.network;
+    }
+    const { signature: consoleErrors, ambient: ambientConsoleErrors } = splitConsole(trace);
+    // Third-party failures are not this app's bug and must not disable the check.
+    const failedRequests = trace.network
+        .filter((n) => n.failed && isSameOrigin(n.url, trace.baseUrl) && !isIncidentalRequest(n.url))
+        .map((n) => ({
+        urlPattern: normalizeUrlPattern(n.url, trace.baseUrl),
+        method: n.method,
+        status: n.status,
+    }));
+    const dedupedFailures = Array.from(new Map(failedRequests.map((f) => [`${f.method} ${f.urlPattern} ${f.status}`, f])).values());
+    return {
+        mode: 'expect-bug',
+        finalState,
+        invariants: {
+            // Absence during one recording is not evidence of a clean app. An error
+            // that fires intermittently at boot would be absent here and present on
+            // the next run, silently flipping this invariant from run to run and
+            // failing a healthy replay. If the app logs anything at all while
+            // booting, the check is not dependable and expectedWhenFixed carries the
+            // assertion instead.
+            noConsoleErrors: consoleErrors.length === 0 && ambientConsoleErrors.length === 0,
+            noFailedRequests: dedupedFailures.length === 0,
+        },
+        observedAtRecord: {
+            consoleErrors,
+            ambientConsoleErrors,
+            failedRequests: dedupedFailures,
+        },
+    };
+}
+//# sourceMappingURL=compile.js.map

package/dist/compiler/compile.js.map

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

package/dist/compiler/normalize.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Reduce a URL to a stable pattern. Same-origin URLs become an origin-relative
+ * path so a repro survives a different dev-server port; cross-origin URLs keep
+ * their origin so third-party traffic stays distinguishable.
+ *
+ * The query string is dropped: it is dominated by cache-busters and is almost
+ * never what identifies an endpoint.
+ */
+export declare function normalizeUrlPattern(url: string, baseUrl: string): string;
+export declare function isSameOrigin(url: string, baseUrl: string): boolean;
+/**
+ * Does a live URL satisfy a recorded pattern? Compared after normalization so
+ * generated ids line up, and also as a glob so a hand-edited IR can widen a
+ * pattern with `*` and have it behave the way a reader would expect.
+ */
+export declare function matchesUrlPattern(url: string, pattern: string, baseUrl: string): boolean;

package/dist/compiler/normalize.js

@@ -0,0 +1,75 @@
+/**
+ * Path segments that are volatile between runs. Recording `/api/sensors/4` and
+ * replaying against `/api/sensors/9` must still match, so identifiers collapse
+ * to `*` on both sides.
+ */
+const VOLATILE_SEGMENT = [
+    /^\d+$/, // numeric id
+    /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, // uuid
+    /^[0-9a-f]{12,}$/i, // hex blob
+    /^[A-Za-z0-9_-]{16,}$/, // opaque token / nanoid
+];
+function normalizeSegment(seg) {
+    if (!seg)
+        return seg;
+    return VOLATILE_SEGMENT.some((re) => re.test(seg)) ? '*' : seg;
+}
+/**
+ * Reduce a URL to a stable pattern. Same-origin URLs become an origin-relative
+ * path so a repro survives a different dev-server port; cross-origin URLs keep
+ * their origin so third-party traffic stays distinguishable.
+ *
+ * The query string is dropped: it is dominated by cache-busters and is almost
+ * never what identifies an endpoint.
+ */
+export function normalizeUrlPattern(url, baseUrl) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return url;
+    }
+    const path = parsed.pathname.split('/').map(normalizeSegment).join('/') || '/';
+    let sameOrigin = false;
+    try {
+        sameOrigin = parsed.origin === new URL(baseUrl).origin;
+    }
+    catch {
+        sameOrigin = false;
+    }
+    return sameOrigin ? path : `${parsed.origin}${path}`;
+}
+export function isSameOrigin(url, baseUrl) {
+    try {
+        return new URL(url).origin === new URL(baseUrl).origin;
+    }
+    catch {
+        return false;
+    }
+}
+function globToRegExp(pattern) {
+    const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\\\*/g, '[^/]+');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Does a live URL satisfy a recorded pattern? Compared after normalization so
+ * generated ids line up, and also as a glob so a hand-edited IR can widen a
+ * pattern with `*` and have it behave the way a reader would expect.
+ */
+export function matchesUrlPattern(url, pattern, baseUrl) {
+    const normalized = normalizeUrlPattern(url, baseUrl);
+    if (normalized === pattern)
+        return true;
+    let rawPath = url;
+    try {
+        const parsed = new URL(url);
+        rawPath = isSameOrigin(url, baseUrl) ? parsed.pathname : `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        /* keep the raw string */
+    }
+    const re = globToRegExp(pattern);
+    return re.test(normalized) || re.test(rawPath);
+}
+//# sourceMappingURL=normalize.js.map

package/dist/compiler/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/compiler/normalize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,gBAAgB,GAAG;IACvB,OAAO,EAAE,aAAa;IACtB,iEAAiE,EAAE,OAAO;IAC1E,kBAAkB,EAAE,WAAW;IAC/B,sBAAsB,EAAE,wBAAwB;CACjD,CAAC;AAEF,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACjE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,OAAe;IAC9D,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAE/E,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAe;IACvD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzF,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,OAAe,EAAE,OAAe;IAC7E,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAExC,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/compiler/waits.d.ts

@@ -0,0 +1,31 @@
+import type { WaitAfter } from '../ir/schema.js';
+import type { RawDomEvent, RawNetworkEvent } from '../recorder/types.js';
+export interface WaitRules {
+    /** A request counts as triggered by the action only if it started this soon after it. */
+    triggerWindowMs: number;
+    /** How long after an action DOM changes are still considered its reaction. */
+    domWindowMs: number;
+    /** Applied when the action produced no observable reaction at all. */
+    emptyTimeoutMs: number;
+    minTimeoutMs: number;
+    maxTimeoutMs: number;
+    /** Multiple of the observed settle time used as the replay ceiling. */
+    timeoutSlack: number;
+    maxSelectors: number;
+}
+export declare const DEFAULT_WAIT_RULES: WaitRules;
+export interface ReactionWindow {
+    actionAt: number;
+    windowEnd: number;
+    network: RawNetworkEvent[];
+    dom: RawDomEvent[];
+    baseUrl: string;
+}
+/**
+ * Turn one action's observed reaction into the wait the replayer will perform.
+ *
+ * The whole point is that replay waits on *signals*, never on sleeps: if the
+ * recording saw a DELETE settle and a row vanish, replay waits for exactly
+ * that, and proceeds the instant it happens.
+ */
+export declare function buildWaitAfter(window: ReactionWindow, rules?: WaitRules): WaitAfter;