agent-screenplay 0.0.0-stage → 0.1.0

package/dist/cli.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { check, record, render } from "./core.js";
+import { guideText, schemaText } from "./guide.js";
+import { init } from "./init.js";
+import { login } from "./login.js";
+import { ScenarioError } from "./scenario/load.js";
+import { VERSION } from "./version.js";
+const program = new Command();
+program
+    .name("screenplay")
+    .description("Screen Studio-quality screen recordings for AI agents.")
+    .version(VERSION);
+const log = (msg) => process.stderr.write(`${msg}\n`);
+function fail(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`\n✗ ${msg}\n`);
+    if (process.env.SCREENPLAY_DEBUG && e instanceof Error && !(e instanceof ScenarioError))
+        process.stderr.write(`${e.stack}\n`);
+    process.exit(1);
+}
+program
+    .command("record")
+    .argument("<scenario>", "scenario JSON file")
+    .description("Film the scenario and edit the video (MP4 + storyboard).")
+    .option("--no-voice", "skip the voice-over even if the scenario enables it")
+    .option("--gif", "also write a GIF")
+    .option("--json", "print the result as JSON")
+    .action(async (file, o) => {
+    try {
+        const r = await record(file, { noVoice: !o.voice, gif: o.gif, log });
+        if (o.json)
+            console.log(JSON.stringify(r, null, 2));
+        else {
+            log(`\n✓ ${r.mp4} (${r.duration.toFixed(1)}s, ${r.steps} steps, edited in ${r.seconds.toFixed(0)}s)`);
+            log(`  storyboard: ${r.storyboard}`);
+            if (r.gif)
+                log(`  gif: ${r.gif}`);
+        }
+    }
+    catch (e) {
+        fail(e);
+    }
+});
+program
+    .command("render")
+    .argument("<scenario>", "scenario JSON file")
+    .description("Edit the last recording again without filming (style, zoom, captions, narration).")
+    .option("--no-voice", "skip the voice-over even if the scenario enables it")
+    .option("--gif", "also write a GIF")
+    .option("--json", "print the result as JSON")
+    .action(async (file, o) => {
+    try {
+        const r = await render(file, { noVoice: !o.voice, gif: o.gif, log });
+        if (o.json)
+            console.log(JSON.stringify(r, null, 2));
+        else
+            log(`\n✓ ${r.mp4} (${r.duration.toFixed(1)}s)\n  storyboard: ${r.storyboard}`);
+    }
+    catch (e) {
+        fail(e);
+    }
+});
+program
+    .command("style")
+    .argument("<scenario>", "scenario JSON file")
+    .description("Open the style editor in your browser: background, margin, corners and shadow, on a frame of the recording.")
+    .option("--port <port>", "port to listen on (default: any free port)")
+    .option("--no-open", "print the link instead of opening the browser")
+    .action(async (file, o) => {
+    try {
+        const { startStyleEditor } = await import("./editor/server.js");
+        await startStyleEditor(file, { port: o.port ? Number(o.port) : undefined, open: o.open, log });
+        log("Press Ctrl+C to stop.");
+    }
+    catch (e) {
+        fail(e);
+    }
+});
+program
+    .command("check")
+    .argument("<scenario>", "scenario JSON file")
+    .description("Play the scenario quickly without filming: every element exists and the flow completes.")
+    .option("--json", "print the report as JSON")
+    .action(async (file, o) => {
+    try {
+        const r = await check(file, { log: o.json ? undefined : log });
+        if (o.json)
+            console.log(JSON.stringify(r, null, 2));
+        else {
+            for (const s of r.steps) {
+                log(`${s.ok ? "✓" : "✗"} ${s.index + 1}. ${s.step}${s.error && s.error !== "not reached" ? `\n    ${s.error}` : ""}`);
+                if (s.candidates?.length)
+                    log(`    visible targets: ${s.candidates.slice(0, 15).join(", ")}`);
+            }
+            if (r.screenshot)
+                log(`\nScreenshot where it stopped: ${r.screenshot}`);
+            log(r.ok ? "\n✓ The scenario plays to the end." : "\n✗ The scenario stops before the end.");
+        }
+        if (!r.ok)
+            process.exit(2);
+    }
+    catch (e) {
+        fail(e);
+    }
+});
+program
+    .command("init")
+    .description("Set up Screenplay: download Chromium, add the MCP server to Claude Code, Codex and Cursor, install the guide.")
+    .option("--no-browser", "do not download Chromium")
+    .option("--no-mcp", "do not add the MCP server to agents")
+    .option("--no-skill", "do not install the guide as a skill")
+    .option("--dry-run", "show what would change")
+    .action(async (o) => {
+    try {
+        const r = await init({ browser: o.browser, mcp: o.mcp, skill: o.skill, dryRun: o.dryRun, log });
+        for (const d of r.done)
+            log(`✓ ${d}`);
+        for (const s of r.skipped)
+            log(`· ${s}`);
+        for (const w of r.warnings)
+            log(`! ${w}`);
+        log("\nReady. Ask your agent: \"Make a screen recording that shows how <feature> works.\"");
+    }
+    catch (e) {
+        fail(e);
+    }
+});
+program
+    .command("login")
+    .argument("<url>", "page to sign in on")
+    .option("-o, --out <file>", "where to save the session", ".screenplay/auth.json")
+    .description("Open a browser to sign in once; the session is saved for scenarios (auth.storageState).")
+    .action(async (url, o) => {
+    try {
+        const file = await login(url, o.out, log);
+        log(`✓ Session saved to ${file}. Use it with "auth": { "storageState": "${o.out}" }. Keep it out of git.`);
+    }
+    catch (e) {
+        fail(e);
+    }
+});
+program
+    .command("mcp")
+    .description("Run the MCP server on stdio (for agents).")
+    .action(async () => {
+    const { startMcpServer } = await import("./mcp/server.js");
+    await startMcpServer();
+});
+program
+    .command("guide")
+    .description("Print the guide to writing good scenarios.")
+    .action(() => {
+    process.stdout.write(guideText());
+});
+program
+    .command("schema")
+    .description("Print the JSON schema of scenarios.")
+    .action(() => {
+    process.stdout.write(schemaText());
+});
+program.parseAsync(process.argv).catch(fail);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,16 @@
+import { type CheckReport } from "./drivers/web.js";
+import { type RenderResult } from "./render/render.js";
+export interface RunOptions {
+    /** Force the voice-over off (true) regardless of the scenario. */
+    noVoice?: boolean;
+    gif?: boolean;
+    log?: (msg: string) => void;
+}
+export interface RecordResult extends RenderResult {
+    take: string;
+    steps: number;
+}
+export declare function record(file: string, opts?: RunOptions): Promise<RecordResult>;
+export declare function render(file: string, opts?: RunOptions): Promise<RenderResult>;
+export declare function check(file: string, opts?: RunOptions): Promise<CheckReport>;
+export declare function takeExists(file: string): boolean;

package/dist/core.js

@@ -0,0 +1,73 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadScenario } from "./scenario/load.js";
+import { runWeb } from "./drivers/web.js";
+import { readingTime } from "./drivers/pace.js";
+import { readTake, writeTake } from "./take.js";
+import { captureInputs } from "./scenario/fingerprint.js";
+import { renderTake } from "./render/render.js";
+import { synthesizeAll } from "./voice/cartesia.js";
+async function narration(loaded, opts) {
+    const voice = loaded.scenario.voice;
+    if (!voice?.enabled || opts.noVoice)
+        return new Map();
+    const texts = new Map();
+    loaded.scenario.steps.forEach((s, i) => {
+        const say = s.say;
+        if (say)
+            texts.set(i, say);
+    });
+    if (texts.size === 0)
+        return new Map();
+    opts.log?.(`Generating narration for ${texts.size} step(s)`);
+    return synthesizeAll(texts, voice, path.join(loaded.workDir, "cache", "voice"));
+}
+/** How long each step must last so its narration or caption can be heard or read. */
+function minDurations(loaded, audio) {
+    const captions = loaded.scenario.style?.captions ?? true;
+    return loaded.scenario.steps.map((s, i) => {
+        const a = audio.get(i);
+        if (a)
+            return a.duration + 0.35;
+        const say = s.say;
+        return say && captions ? readingTime(say) : 0;
+    });
+}
+export async function record(file, opts = {}) {
+    const loaded = loadScenario(file);
+    const audio = await narration(loaded, opts);
+    let take;
+    if (loaded.scenario.url) {
+        const res = await runWeb(loaded, { mode: "record", minDurations: minDurations(loaded, audio), log: opts.log });
+        take = res.take;
+    }
+    else {
+        const { runDesktop } = await import("./drivers/desktop.js");
+        take = await runDesktop(loaded, { mode: "record", minDurations: minDurations(loaded, audio), log: opts.log });
+    }
+    take.inputs = captureInputs(loaded.scenario);
+    const takeFile = writeTake(loaded.takeDir, take);
+    opts.log?.("Editing the video");
+    const result = await renderTake(loaded, take, { audio, gif: opts.gif, log: opts.log });
+    return { ...result, take: takeFile, steps: take.steps.length };
+}
+export async function render(file, opts = {}) {
+    const loaded = loadScenario(file);
+    const take = readTake(loaded.takeDir);
+    const audio = await narration(loaded, opts);
+    return renderTake(loaded, take, { audio, gif: opts.gif, log: opts.log });
+}
+export async function check(file, opts = {}) {
+    const loaded = loadScenario(file);
+    if (loaded.scenario.url) {
+        const res = await runWeb(loaded, { mode: "check", log: opts.log });
+        return res.check;
+    }
+    const { checkDesktop } = await import("./drivers/desktop.js");
+    return checkDesktop(loaded, { log: opts.log });
+}
+export function takeExists(file) {
+    const loaded = loadScenario(file, { env: false });
+    return fs.existsSync(path.join(loaded.takeDir, "take.json"));
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/direct/plan.d.ts

@@ -0,0 +1,100 @@
+import type { Scenario } from "../scenario/schema.js";
+import type { Box, Point, Take, TakeStep } from "../take.js";
+/**
+ * The edit of a take: how output time maps to recording time, where the
+ * camera looks, where the cursor is, and which overlays show when.
+ * Pure data, computed once, then drawn frame by frame by the compositor.
+ */
+export type Piece = {
+    kind: "capture";
+    o0: number;
+    o1: number;
+    s0: number;
+    s1: number;
+} | {
+    kind: "card";
+    o0: number;
+    o1: number;
+    step: TakeStep;
+    card: CardContent;
+};
+export interface CardContent {
+    kind: "title" | "end";
+    title: string;
+    subtitle?: string;
+}
+export interface Camera {
+    z: number;
+    cx: number;
+    cy: number;
+}
+export interface Caption {
+    o0: number;
+    o1: number;
+    text: string;
+}
+export interface Annotation {
+    kind: "callout" | "highlight";
+    o0: number;
+    o1: number;
+    box: Box;
+    text?: string;
+}
+export interface VoiceClip {
+    file: string;
+    at: number;
+    duration: number;
+}
+export interface Plan {
+    fps: number;
+    duration: number;
+    frameCount: number;
+    pieces: Piece[];
+    /** Camera state for each output frame. */
+    cameras: Camera[];
+    captions: Caption[];
+    annotations: Annotation[];
+    /** Output times of clicks. */
+    clicks: number[];
+    voice: VoiceClip[];
+    /** Output time span of each step. */
+    stepTimes: Array<{
+        o0: number;
+        o1: number;
+        oAction?: number;
+    }>;
+    movements: Movement[];
+    typing: Array<[number, number]>;
+    width: number;
+    height: number;
+}
+export interface Movement {
+    s0: number;
+    s1: number;
+    from: Point;
+    to: Point;
+    /** Side of the arc (+1/-1). */
+    bend: number;
+}
+export interface PlanOptions {
+    fps: number;
+    audio: Map<number, {
+        file: string;
+        duration: number;
+    }>;
+    autoZoom: boolean;
+    maxZoom: number;
+    captions: boolean;
+}
+export declare const OVERLAY_DELAY = 0.55;
+export declare function planTake(take: Take, scenario: Scenario, opts: PlanOptions): Plan;
+/** Zoom that frames a box with comfortable context. */
+export declare function autoZoom(box: Box, W: number, H: number, maxZoom: number): number;
+/** Where the cursor is at recording time s (minimum-jerk motion along a gentle arc). */
+export declare function cursorAt(movements: Movement[], start: Point, s: number): Point;
+/** Locate output time o: the piece, and the recording time when it is a capture. */
+export declare function locate(plan: Plan, o: number): {
+    piece: Piece;
+    index: number;
+    s?: number;
+};

package/dist/direct/plan.js

@@ -0,0 +1,274 @@
+import { cardDuration } from "../drivers/pace.js";
+const WAIT_KEEP = 0.9; // seconds of a wait shown at normal speed
+const WAIT_RATE = 8; // the rest of the wait plays this many times faster
+const WAIT_MAX = 2.4; // a wait never lasts longer than this in the video
+export const OVERLAY_DELAY = 0.55; // callouts and highlights appear after the camera framed them
+export function planTake(take, scenario, opts) {
+    const steps = take.steps;
+    const pieces = [];
+    let op = 0; // output pointer
+    let sp = 0; // source pointer
+    const emitCapture = (sEnd) => {
+        if (sEnd <= sp + 1e-6)
+            return;
+        const waits = mergeSpans(steps.flatMap((s) => s.waits)).filter(([a, b]) => b > sp && a < sEnd);
+        let cur = sp;
+        for (const [a0, b0] of waits) {
+            const a = Math.max(a0, cur);
+            const b = Math.min(b0, sEnd);
+            if (a > cur) {
+                pieces.push({ kind: "capture", o0: op, o1: op + (a - cur), s0: cur, s1: a });
+                op += a - cur;
+            }
+            if (b > a) {
+                const len = b - a;
+                const out = len <= WAIT_KEEP ? len : Math.min(WAIT_MAX, WAIT_KEEP + (len - WAIT_KEEP) / WAIT_RATE);
+                pieces.push({ kind: "capture", o0: op, o1: op + out, s0: a, s1: b });
+                op += out;
+            }
+            cur = Math.max(cur, b);
+        }
+        if (sEnd > cur) {
+            pieces.push({ kind: "capture", o0: op, o1: op + (sEnd - cur), s0: cur, s1: sEnd });
+            op += sEnd - cur;
+        }
+        sp = sEnd;
+    };
+    const srcToOut = (s) => {
+        for (const p of pieces) {
+            if (p.kind === "capture" && s >= p.s0 - 1e-9 && s <= p.s1 + 1e-9) {
+                if (p.s1 === p.s0)
+                    return p.o0;
+                return p.o0 + ((s - p.s0) / (p.s1 - p.s0)) * (p.o1 - p.o0);
+            }
+        }
+        return op;
+    };
+    const stepTimes = [];
+    const voice = [];
+    for (const st of steps) {
+        const audio = opts.audio.get(st.index);
+        if (st.card) {
+            // An opening card starts the video: drop the still lead-in recorded before it.
+            if (pieces.length === 0)
+                sp = st.start;
+            emitCapture(st.start);
+            // Card text and length come from the scenario as it is now: they can change without filming again.
+            const sc = scenario.steps[st.index];
+            const title = (st.card.kind === "title" ? sc.title : sc.end) ?? st.card.title;
+            const base = sc.duration ?? cardDuration(title, sc.subtitle);
+            const dur = Math.max(base, audio ? audio.duration + 0.6 : 0);
+            pieces.push({ kind: "card", o0: op, o1: op + dur, step: st, card: { kind: st.card.kind, title, subtitle: sc.subtitle } });
+            stepTimes[st.index] = { o0: op, o1: op + dur };
+            if (audio)
+                voice.push({ file: audio.file, at: op + 0.25, duration: audio.duration });
+            op += dur;
+            continue;
+        }
+        emitCapture(st.start);
+        const o0 = op;
+        emitCapture(st.end);
+        // Narration longer than the step: hold the last image until it ends.
+        if (audio && op - o0 < audio.duration + 0.35) {
+            const extra = audio.duration + 0.35 - (op - o0);
+            pieces.push({ kind: "capture", o0: op, o1: op + extra, s0: st.end, s1: st.end });
+            op += extra;
+        }
+        stepTimes[st.index] = { o0, o1: op, oAction: st.actionAt !== undefined ? srcToOut(st.actionAt) : undefined };
+        if (audio)
+            voice.push({ file: audio.file, at: o0 + 0.05, duration: audio.duration });
+    }
+    emitCapture(take.duration);
+    const duration = op;
+    const frameCount = Math.max(1, Math.ceil(duration * opts.fps));
+    // ---- cursor movements (recording time) ---------------------------------
+    const movements = [];
+    let prev = take.cursorStart;
+    let bend = 1;
+    for (const st of steps) {
+        if (!st.point)
+            continue;
+        const s0 = st.travelStart ?? st.actionAt ?? st.start;
+        const s1 = st.actionAt ?? s0 + 0.5;
+        if (Math.hypot(st.point.x - prev.x, st.point.y - prev.y) > 2) {
+            movements.push({ s0, s1: Math.max(s1, s0 + 0.05), from: prev, to: st.point, bend });
+            bend = -bend;
+        }
+        prev = st.point;
+    }
+    const clicks = steps
+        .filter((s) => s.actionAt !== undefined && (s.kind === "click" || s.kind === "select" || (s.kind === "type" && s.point)))
+        .map((s) => srcToOut(s.actionAt));
+    const typing = steps
+        .filter((s) => s.kind === "type" && s.actionAt !== undefined && s.actionEnd !== undefined)
+        .map((s) => [srcToOut(s.actionAt), srcToOut(s.actionEnd)]);
+    // ---- overlays -----------------------------------------------------------
+    const captions = [];
+    const annotations = [];
+    for (const st of steps) {
+        const sc = scenario.steps[st.index];
+        const t = stepTimes[st.index];
+        if (!t)
+            continue;
+        if (opts.captions && sc.say && !st.card) {
+            const audio = opts.audio.get(st.index);
+            captions.push({ o0: t.o0 + 0.05, o1: Math.max(t.o1, t.o0 + (audio?.duration ?? 0) + 0.2), text: sc.say });
+        }
+        if ((st.kind === "callout" || st.kind === "highlight") && st.box) {
+            // Appear once the camera has had time to frame the element.
+            annotations.push({ kind: st.kind, o0: Math.min(t.o0 + OVERLAY_DELAY, t.o1 - 0.5), o1: t.o1, box: st.box, text: sc.text });
+        }
+    }
+    // ---- camera -------------------------------------------------------------
+    const W = take.width;
+    const H = take.height;
+    const shots = buildShots(take, scenario, stepTimes, srcToOut, opts);
+    const cameras = simulateCamera(shots, frameCount, opts.fps, W, H);
+    return {
+        fps: opts.fps,
+        duration,
+        frameCount,
+        pieces,
+        cameras,
+        captions,
+        annotations,
+        clicks,
+        voice,
+        stepTimes,
+        movements,
+        typing,
+        width: W,
+        height: H,
+    };
+}
+function buildShots(take, scenario, stepTimes, srcToOut, opts) {
+    const W = take.width;
+    const H = take.height;
+    const shots = [];
+    for (const st of take.steps) {
+        if (!st.box || st.card)
+            continue;
+        const sc = scenario.steps[st.index];
+        if (sc.zoom === false)
+            continue;
+        const forced = typeof sc.zoom === "number" ? sc.zoom : undefined;
+        const isOverlay = st.kind === "callout" || st.kind === "highlight" || st.kind === "zoomTo";
+        if (forced === undefined && !opts.autoZoom && st.kind !== "zoomTo")
+            continue;
+        // Typing happens at the start of a field: frame that part rather than a very wide input.
+        const box = st.kind === "type" && st.typed !== undefined && st.box.width > W / 3
+            ? { ...st.box, width: Math.min(st.box.width, Math.max(260, st.typed.length * 7.5 + 60)) }
+            : st.box;
+        let z = forced ?? autoZoom(box, W, H, isOverlay ? Math.min(opts.maxZoom, 1.6) : opts.maxZoom);
+        if (st.kind === "zoomTo" && forced === undefined)
+            z = autoZoom(box, W, H, opts.maxZoom);
+        if (z <= 1.02)
+            continue;
+        const t = stepTimes[st.index];
+        const begin = isOverlay ? t.o0 - 0.1 : srcToOut(st.travelStart ?? st.actionAt ?? st.start) - 0.12;
+        let end = t.o1;
+        if (st.navigated && st.actionAt !== undefined)
+            end = Math.min(end, srcToOut(st.actionAt) + 0.45);
+        shots.push({ o0: Math.max(0, begin), o1: end, z, cx: box.x + box.width / 2, cy: box.y + box.height / 2 });
+    }
+    // Stay zoomed between close shots instead of bouncing out and back in.
+    for (let i = 0; i + 1 < shots.length; i++) {
+        if (shots[i + 1].o0 - shots[i].o1 < 1.3)
+            shots[i].o1 = shots[i + 1].o0;
+    }
+    return shots;
+}
+/** Zoom that frames a box with comfortable context. */
+export function autoZoom(box, W, H, maxZoom) {
+    const wantW = Math.max(box.width * 2.4, W / maxZoom);
+    const wantH = Math.max(box.height * 3.2, H / maxZoom);
+    return clampNum(Math.min(W / wantW, H / wantH), 1, maxZoom);
+}
+/** Critically damped spring on log(zoom) and the center: smooth starts, no overshoot. */
+function simulateCamera(shots, frameCount, fps, W, H) {
+    const omega = 5.2;
+    const sub = 4;
+    const dt = 1 / fps / sub;
+    let lz = 0, vz = 0, cx = W / 2, vx = 0, cy = H / 2, vy = 0;
+    const out = [];
+    let si = 0;
+    for (let f = 0; f < frameCount; f++) {
+        const o = f / fps;
+        while (si < shots.length && shots[si].o1 < o)
+            si++;
+        const shot = si < shots.length && shots[si].o0 <= o ? shots[si] : undefined;
+        const tz = shot ? Math.log(shot.z) : 0;
+        const z = Math.exp(tz);
+        const tx = shot ? clampCenter(shot.cx, W, z) : W / 2;
+        const ty = shot ? clampCenter(shot.cy, H, z) : H / 2;
+        for (let k = 0; k < sub; k++) {
+            vz += (omega * omega * (tz - lz) - 2 * omega * vz) * dt;
+            lz += vz * dt;
+            vx += (omega * omega * (tx - cx) - 2 * omega * vx) * dt;
+            cx += vx * dt;
+            vy += (omega * omega * (ty - cy) - 2 * omega * vy) * dt;
+            cy += vy * dt;
+        }
+        const zz = Math.max(1, Math.exp(lz));
+        out.push({ z: zz, cx: clampCenter(cx, W, zz), cy: clampCenter(cy, H, zz) });
+    }
+    return out;
+}
+function clampCenter(c, size, z) {
+    const half = size / (2 * z);
+    return clampNum(c, half, size - half);
+}
+function clampNum(v, lo, hi) {
+    return Math.min(hi, Math.max(lo, v));
+}
+function mergeSpans(spans) {
+    const sorted = spans.filter(([a, b]) => b > a).sort((x, y) => x[0] - y[0]);
+    const out = [];
+    for (const [a, b] of sorted) {
+        const last = out[out.length - 1];
+        if (last && a <= last[1])
+            last[1] = Math.max(last[1], b);
+        else
+            out.push([a, b]);
+    }
+    return out;
+}
+/** Where the cursor is at recording time s (minimum-jerk motion along a gentle arc). */
+export function cursorAt(movements, start, s) {
+    let pos = start;
+    for (const m of movements) {
+        if (s < m.s0)
+            break;
+        if (s >= m.s1) {
+            pos = m.to;
+            continue;
+        }
+        const u = (s - m.s0) / (m.s1 - m.s0);
+        const e = u * u * u * (10 - 15 * u + 6 * u * u);
+        const dx = m.to.x - m.from.x;
+        const dy = m.to.y - m.from.y;
+        const len = Math.hypot(dx, dy) || 1;
+        const arc = Math.min(80, len * 0.12) * m.bend;
+        const ctrl = { x: (m.from.x + m.to.x) / 2 - (dy / len) * arc, y: (m.from.y + m.to.y) / 2 + (dx / len) * arc };
+        const a = 1 - e;
+        return {
+            x: a * a * m.from.x + 2 * a * e * ctrl.x + e * e * m.to.x,
+            y: a * a * m.from.y + 2 * a * e * ctrl.y + e * e * m.to.y,
+        };
+    }
+    return pos;
+}
+/** Locate output time o: the piece, and the recording time when it is a capture. */
+export function locate(plan, o) {
+    const { pieces } = plan;
+    let i = pieces.findIndex((p) => o >= p.o0 && o < p.o1);
+    if (i < 0)
+        i = pieces.length - 1;
+    const piece = pieces[i];
+    if (piece.kind === "capture") {
+        const u = piece.o1 > piece.o0 ? (o - piece.o0) / (piece.o1 - piece.o0) : 0;
+        return { piece, index: i, s: piece.s0 + Math.min(1, Math.max(0, u)) * (piece.s1 - piece.s0) };
+    }
+    return { piece, index: i };
+}
+//# sourceMappingURL=plan.js.map