screencast-axi 0.1.0

package/dist/src/director.js

@@ -0,0 +1,415 @@
+/** Default ceiling on the post-navigation settle wait. */
+export const DEFAULT_SETTLE_MS = 2500;
+const EASE = (t) => (t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2);
+/**
+ * The scenario-facing API. Every method is written so the resulting video is
+ * *watchable*: the pointer travels rather than teleports, clicks are preceded
+ * by a beat, and typing is per-character.
+ *
+ * Raw Playwright is still available via `director.page` for anything the
+ * helpers do not cover - but prefer adding a helper here over reaching past it,
+ * so all clips share one visual language.
+ */
+export class Director {
+    page;
+    opts;
+    contextCreatedAt;
+    pointer = { x: 0, y: 0 };
+    /** ms since the context was created, at the moment the clip proper began. */
+    clipStartedAt = null;
+    /** Indices passed to {@link step}, in the order the take showed them. */
+    shown = [];
+    /**
+     * Milliseconds spent in pauses this class controls.
+     *
+     * A take is `fixed + pace x scalable`: the app's own waits - navigation, a
+     * network round trip, an animation - do not get slower because the recorder
+     * does. Tracking the scalable half is what lets `--duration` solve for a
+     * pace exactly rather than assuming the whole clip scales.
+     */
+    pausedMs = 0;
+    /**
+     * Everything the scenario did, in order.
+     *
+     * A scenario is arbitrary code driving a real browser, often a signed-in
+     * one, so "what will this actually do" is a fair question to want answered
+     * before trusting it. Watching a headed run answers it once; this answers it
+     * in a form that can be read, diffed and kept.
+     */
+    actions = [];
+    constructor(page, opts, contextCreatedAt) {
+        this.page = page;
+        this.opts = opts;
+        this.contextCreatedAt = contextCreatedAt;
+    }
+    /** Seconds of dead air at the head of the raw video, for the encoder to trim. */
+    get trimStartSeconds() {
+        if (this.clipStartedAt === null)
+            return 0;
+        return Math.max(0, (this.clipStartedAt - this.contextCreatedAt) / 1000);
+    }
+    /** Marks the end of setup. Everything before this is trimmed off the clip. */
+    markClipStart() {
+        this.clipStartedAt = Date.now();
+    }
+    scaled(ms) {
+        return Math.max(0, Math.round(ms * this.opts.pace));
+    }
+    /** Pace-scaled pause. Every wait this class owns goes through here. */
+    async pause(ms) {
+        const scaled = this.scaled(ms);
+        this.pausedMs += scaled;
+        await this.page.waitForTimeout(scaled);
+    }
+    /** How much of the take so far was pause this class controls, in ms. */
+    get scaledPauseMs() {
+        return this.pausedMs;
+    }
+    /** Everything the scenario did, in order. */
+    get performed() {
+        return this.actions;
+    }
+    record(kind, target, detail) {
+        this.actions.push({
+            atMs: Date.now() - this.contextCreatedAt,
+            kind,
+            ...(target !== undefined ? { target: describeTarget(target) } : {}),
+            ...(detail !== undefined ? { detail } : {}),
+        });
+    }
+    /** A deliberate pause so the viewer can read what just happened. */
+    async beat(ms = 700) {
+        await this.pause(ms);
+    }
+    async goto(path) {
+        const url = path.startsWith("http") ? path : new URL(path, this.opts.baseUrl).toString();
+        this.record("goto", url);
+        await this.page.goto(url, { waitUntil: "domcontentloaded" });
+        // Bounded on purpose: see `settleMs`. A page that has not gone quiet in a
+        // couple of seconds is not going to, and every extra second is recorded.
+        await this.page
+            .waitForLoadState("networkidle", { timeout: this.opts.settleMs ?? DEFAULT_SETTLE_MS })
+            .catch(() => undefined);
+    }
+    /** Which script lines this take put on screen, in order. */
+    get shownSteps() {
+        return this.shown;
+    }
+    /**
+     * Puts line `index` of the scenario's `steps` on screen.
+     *
+     * Scenarios narrate through this rather than through {@link caption} so the
+     * text has one home: the same array becomes the burnt-in caption, the
+     * manifest's step list and the text the landing page renders beside the clip.
+     * `record.ts` checks afterwards that the take used every line exactly once,
+     * in order, which is what stops the written workflow from drifting away from
+     * the recorded one.
+     */
+    async step(index, holdMs = 0) {
+        const line = this.opts.steps?.[index];
+        if (line === undefined) {
+            throw new Error(`step(${index}): the scenario declares ${this.opts.steps?.length ?? 0} step(s)`);
+        }
+        this.shown.push(index);
+        this.record("step", undefined, line);
+        await this.caption(line, holdMs);
+    }
+    /** Shows a caption at the bottom of the frame. Pass `null` to clear it. */
+    async caption(text, holdMs = 0) {
+        await this.page.evaluate((t) => {
+            const api = window
+                .__screencast;
+            api?.caption(t);
+        }, text);
+        if (holdMs)
+            await this.beat(holdMs);
+    }
+    locator(target) {
+        if (typeof target === "string")
+            return this.page.locator(target).first();
+        if ("x" in target)
+            throw new Error("locator() needs a selector, not a point");
+        return target;
+    }
+    /** Whether this target is a field whose value should never be logged. */
+    async isSecret(target) {
+        if (typeof target === "object" && "x" in target)
+            return false;
+        try {
+            const type = await this.locator(target).getAttribute("type");
+            if (type?.toLowerCase() === "password")
+                return true;
+        }
+        catch {
+            // Not resolvable as an element - fall through to the name check, which
+            // is the only signal left.
+        }
+        const described = typeof target === "string" ? target : String(target);
+        return /pass(word|wd)?|secret|token|otp|\bpin\b/i.test(described);
+    }
+    async pointOf(target) {
+        if (typeof target === "object" && "x" in target)
+            return target;
+        const locator = this.locator(target);
+        await locator.waitFor({ state: "visible" });
+        await locator.scrollIntoViewIfNeeded();
+        const box = await locator.boundingBox();
+        if (!box)
+            throw new Error(`Target has no bounding box: ${String(target)}`);
+        return { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+    }
+    /** Glides the pointer to `target` along an eased path. */
+    async moveTo(target, { steps = 26 } = {}) {
+        const to = await this.pointOf(target);
+        await this.glide(to, steps);
+    }
+    async glide(to, steps) {
+        const from = this.pointer;
+        const first = from.x === 0 && from.y === 0;
+        const count = first ? 1 : Math.max(1, steps);
+        for (let i = 1; i <= count; i++) {
+            const t = EASE(i / count);
+            await this.page.mouse.move(from.x + (to.x - from.x) * t, from.y + (to.y - from.y) * t);
+            if (!first)
+                await this.pause(12);
+        }
+        this.pointer = to;
+    }
+    /** Move, settle, then click - the pause is what makes the click legible. */
+    async click(target, { settleMs = 260 } = {}) {
+        this.record("click", target);
+        await this.performClick(target, settleMs);
+    }
+    /**
+     * The click itself, without logging it.
+     *
+     * `type` focuses its field by clicking it, which is one action from the
+     * scenario's point of view. Logging the inner click too would put a
+     * phantom step in the record of what the take did.
+     */
+    async performClick(target, settleMs) {
+        await this.moveTo(target);
+        await this.beat(settleMs);
+        await this.page.mouse.down();
+        await this.pause(70);
+        await this.page.mouse.up();
+        await this.beat(320);
+    }
+    async doubleClick(target) {
+        this.record("doubleClick", target);
+        await this.moveTo(target);
+        await this.beat(220);
+        await this.page.mouse.dblclick(this.pointer.x, this.pointer.y);
+        await this.beat(320);
+    }
+    /**
+     * Clicks the field, then types character by character. `clear` selects the
+     * existing value first, so typing replaces it instead of appending - what a
+     * person does to a field that already holds a default.
+     */
+    async type(target, text, { delay = 55, clear = false } = {}) {
+        // The action log exists to be read by someone deciding whether a scenario
+        // is safe to run, so it must not be the thing that leaks a credential into
+        // a terminal, a CI log or a screenshot of one. A password field records
+        // its length and nothing else.
+        this.record("type", target, (await this.isSecret(target)) ? maskOf(text) : text);
+        await this.performClick(target, 180);
+        if (clear) {
+            await this.page.keyboard.press("ControlOrMeta+A");
+            await this.beat(160);
+        }
+        const perChar = this.scaled(delay);
+        this.pausedMs += perChar * text.length;
+        await this.page.keyboard.type(text, { delay: perChar });
+        await this.beat(300);
+    }
+    async press(key) {
+        this.record("press", undefined, key);
+        await this.page.keyboard.press(key);
+        await this.beat(400);
+    }
+    /**
+     * Press-move-release drag. Deliberately slow and eased: this is the shot the
+     * whole harness exists for (reordering a tree row, moving a kanban card), and
+     * a fast drag reads as a teleport once it is re-encoded at 30fps.
+     */
+    async drag(from, to, { steps = 34, liftMs = 320, dropMs = 420, } = {}) {
+        this.record("drag", from, `to ${describeTarget(to)}`);
+        await this.moveTo(from);
+        await this.beat(260);
+        await this.page.mouse.down();
+        await this.beat(liftMs);
+        const target = await this.pointOf(to);
+        const start = { ...this.pointer };
+        for (let i = 1; i <= steps; i++) {
+            const t = EASE(i / steps);
+            await this.page.mouse.move(start.x + (target.x - start.x) * t, start.y + (target.y - start.y) * t, { steps: 2 });
+            await this.pause(16);
+        }
+        this.pointer = target;
+        await this.beat(dropMs);
+        await this.page.mouse.up();
+        await this.beat(600);
+    }
+    /**
+     * Drag for the parts of the product that move things with the HTML5
+     * drag-and-drop API (`draggable` + `dragstart`/`dragover`/`drop`) rather than
+     * with raw pointer events: the process-mapper components palette, the kanban
+     * board.
+     *
+     * Chromium does not synthesise those events from `mouse.down`/`move`/`up`, so
+     * {@link drag} silently does nothing there. This dispatches the protocol
+     * itself - one `DataTransfer` shared by every event of the gesture, which is
+     * what carries the payload the source sets in `dragstart` to the drop
+     * handler - while still moving the real pointer, so the overlay cursor shows
+     * a hand carrying the thing across the screen.
+     *
+     * The mouse button is deliberately *not* pressed. A real `mouse.down` on a
+     * `draggable` element makes Chromium open its own native drag session, which
+     * then swallows every following `mousemove` - the overlay pointer freezes at
+     * the source and the clip shows a thing teleporting. Without the press the
+     * pointer travels normally, and `setDragging` puts a ghost chip under it so
+     * the gesture still reads as carrying something.
+     */
+    async dragHtml5(from, to, { steps = 30, liftMs = 340, dropMs = 460, } = {}) {
+        this.record("drag", from, `to ${describeTarget(to)} (html5)`);
+        const source = this.locator(from);
+        await this.moveTo(from);
+        await this.beat(260);
+        await source.evaluate((el, at) => {
+            const dt = new DataTransfer();
+            window.__screencastDnd = { dt, source: el, over: null };
+            el.dispatchEvent(new DragEvent("dragstart", {
+                bubbles: true,
+                cancelable: true,
+                composed: true,
+                clientX: at.x,
+                clientY: at.y,
+                dataTransfer: dt,
+            }));
+        }, this.pointer);
+        await this.setDragging(true);
+        await this.beat(liftMs);
+        const target = await this.pointOf(to);
+        const start = { ...this.pointer };
+        for (let i = 1; i <= steps; i++) {
+            const t = EASE(i / steps);
+            const at = { x: start.x + (target.x - start.x) * t, y: start.y + (target.y - start.y) * t };
+            await this.page.mouse.move(at.x, at.y, { steps: 2 });
+            await this.dndEvent("dragover", at);
+            await this.pause(16);
+        }
+        this.pointer = target;
+        await this.beat(dropMs);
+        await this.dndEvent("drop", target);
+        await this.setDragging(false);
+        await this.beat(600);
+    }
+    async setDragging(dragging) {
+        await this.page.evaluate((on) => {
+            const api = window
+                .__screencast;
+            api?.setDragging(on);
+        }, dragging);
+    }
+    /**
+     * Dispatches one drag event at `at`, on whatever is under that point.
+     *
+     * `dragenter`/`dragleave` are kept in step with the element under the pointer
+     * because a drop zone that only arms itself on `dragenter` would otherwise
+     * never accept the drop. `drop` also ends the gesture with `dragend` on the
+     * source, which is where a well-behaved source cleans up its drag state.
+     */
+    async dndEvent(type, at) {
+        await this.page.evaluate((arg) => {
+            const state = window.__screencastDnd;
+            if (!state)
+                throw new Error("dragHtml5: no drag in progress");
+            const el = document.elementFromPoint(arg.x, arg.y);
+            if (!el)
+                return;
+            const init = {
+                bubbles: true,
+                cancelable: true,
+                composed: true,
+                clientX: arg.x,
+                clientY: arg.y,
+                dataTransfer: state.dt,
+            };
+            if (el !== state.over) {
+                if (state.over)
+                    state.over.dispatchEvent(new DragEvent("dragleave", init));
+                el.dispatchEvent(new DragEvent("dragenter", init));
+                state.over = el;
+            }
+            el.dispatchEvent(new DragEvent(arg.type, init));
+            if (arg.type === "drop") {
+                state.source.dispatchEvent(new DragEvent("dragend", init));
+                window.__screencastDnd = null;
+            }
+        }, { x: at.x, y: at.y, type });
+    }
+    /** Smooth wheel scroll, in the page or in whatever is under the pointer. */
+    async scrollBy(deltaY, { steps = 24 } = {}) {
+        this.record("scroll", undefined, `${Math.round(deltaY)}px`);
+        const per = deltaY / steps;
+        for (let i = 0; i < steps; i++) {
+            await this.page.mouse.wheel(0, per);
+            await this.pause(16);
+        }
+        await this.beat(400);
+    }
+    async waitFor(target) {
+        this.record("waitFor", target);
+        await this.locator(target).waitFor({ state: "visible" });
+    }
+    /**
+     * A multi-page walkthrough: go somewhere, narrate it, let it breathe, move on.
+     *
+     * This is the shape most requests actually have ("a walkthrough of the five
+     * main pages"), and writing it by hand is fifty lines of goto/caption/scroll
+     * whose only real content is the paths. Going through one helper also keeps
+     * the rhythm identical between stops, which is most of what makes a tour
+     * watchable rather than a run of jump cuts.
+     *
+     * Every pause here is pace-scaled like any other, so `--duration` re-cuts a
+     * tour without the scenario changing.
+     */
+    async tour(stops, { dwellMs = 1400 } = {}) {
+        for (const stop of stops) {
+            await this.goto(stop.path);
+            if (stop.waitFor)
+                await this.waitFor(stop.waitFor);
+            if (stop.step !== undefined)
+                await this.step(stop.step);
+            else if (stop.caption)
+                await this.caption(stop.caption);
+            await this.beat(stop.dwellMs ?? dwellMs);
+            if (stop.scroll) {
+                // A value of 1 or less is a share of the viewport, which reads the
+                // same on a phone and a desktop; anything larger is pixels.
+                const viewport = this.page.viewportSize();
+                const amount = stop.scroll <= 1 && viewport ? Math.round(viewport.height * stop.scroll) : stop.scroll;
+                await this.scrollBy(amount);
+                await this.beat(stop.dwellMs ?? dwellMs);
+            }
+        }
+    }
+}
+/** What a secret value looks like in the log: its shape, never its content. */
+function maskOf(text) {
+    return `${"\u2022".repeat(Math.min(8, text.length))} (${text.length} chars)`;
+}
+/** A target as a short readable string, for the action log. */
+function describeTarget(target) {
+    if (typeof target === "string")
+        return target;
+    if ("x" in target)
+        return `(${Math.round(target.x)}, ${Math.round(target.y)})`;
+    // Playwright locators stringify to something like `locator('.foo')`.
+    return String(target)
+        .replace(/^locator\(/, "")
+        .replace(/\)$/, "")
+        .replace(/^['"]|['"]$/g, "");
+}
+//# sourceMappingURL=director.js.map

package/dist/src/director.js.map

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

package/dist/src/duration.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Turning "around 30 seconds" into a pace.
+ *
+ * Every deliberate pause in a take is multiplied by `pace`, so a clip's length
+ * is roughly linear in it. Roughly, not exactly: Playwright's own waits - a
+ * navigation, a network round trip, an animation settling - are not scaled,
+ * because slowing the recorder down does not slow the app down. So the
+ * resolved pace is measured rather than assumed, and what actually came out is
+ * reported next to what was asked for.
+ */
+export declare const MIN_PACE = 0.4;
+export declare const MAX_PACE = 2.5;
+/** Parses `30s`, `1m30s`, `45`, `2m`. Returns milliseconds. */
+export declare function parseDuration(input: string): number;
+export interface PaceSolution {
+    readonly pace: number;
+    readonly clamped: boolean;
+    /** What a pace-1 take measured, in ms. */
+    readonly naturalMs: number;
+    readonly targetMs: number;
+    /** Human note when the target could not be met. */
+    readonly warning?: string;
+}
+/**
+ * The pace that should land a take near `targetMs`, given a measured run.
+ *
+ * Clamped, because there is a point past which a clip stops being watchable:
+ * below 0.4 the pointer teleports and typed text is a blur, above 2.5 it is
+ * slower than anyone will sit through. Hitting a clamp is reported rather than
+ * silently obeyed - the honest answer is "this scenario has too much in it for
+ * 30 seconds", not a clip nobody can follow.
+ */
+export declare function solvePace(naturalMs: number, targetMs: number, scaledPauseMs?: number): PaceSolution;

package/dist/src/duration.js

@@ -0,0 +1,68 @@
+import { ScreencastError } from "./errors.js";
+/**
+ * Turning "around 30 seconds" into a pace.
+ *
+ * Every deliberate pause in a take is multiplied by `pace`, so a clip's length
+ * is roughly linear in it. Roughly, not exactly: Playwright's own waits - a
+ * navigation, a network round trip, an animation settling - are not scaled,
+ * because slowing the recorder down does not slow the app down. So the
+ * resolved pace is measured rather than assumed, and what actually came out is
+ * reported next to what was asked for.
+ */
+export const MIN_PACE = 0.4;
+export const MAX_PACE = 2.5;
+/** Parses `30s`, `1m30s`, `45`, `2m`. Returns milliseconds. */
+export function parseDuration(input) {
+    const text = input.trim().toLowerCase();
+    const clock = /^(\d+)m(?:in)?(?:\s*(\d+)s?)?$/.exec(text);
+    if (clock) {
+        return (Number(clock[1]) * 60 + Number(clock[2] ?? 0)) * 1000;
+    }
+    const seconds = /^(\d+(?:\.\d+)?)s(?:ec)?$/.exec(text);
+    if (seconds)
+        return Math.round(Number(seconds[1]) * 1000);
+    const bare = /^(\d+(?:\.\d+)?)$/.exec(text);
+    if (bare)
+        return Math.round(Number(bare[1]) * 1000);
+    throw new ScreencastError(`Cannot read a duration from \`${input}\``, "VALIDATION_ERROR", [
+        "Use seconds (`30s`), minutes and seconds (`1m30s`), or a bare number of seconds (`30`)",
+    ]);
+}
+/**
+ * The pace that should land a take near `targetMs`, given a measured run.
+ *
+ * Clamped, because there is a point past which a clip stops being watchable:
+ * below 0.4 the pointer teleports and typed text is a blur, above 2.5 it is
+ * slower than anyone will sit through. Hitting a clamp is reported rather than
+ * silently obeyed - the honest answer is "this scenario has too much in it for
+ * 30 seconds", not a clip nobody can follow.
+ */
+export function solvePace(naturalMs, targetMs, scaledPauseMs = naturalMs) {
+    if (naturalMs <= 0 || scaledPauseMs <= 0) {
+        return { pace: 1, clamped: false, naturalMs, targetMs };
+    }
+    // A take is `fixed + pace x scalable`, measured at pace 1. Solving with the
+    // real split lands close; assuming the whole clip scales undershoots by
+    // whatever the app itself spent loading, which on a real site is seconds.
+    const fixedMs = Math.max(0, naturalMs - scaledPauseMs);
+    const ideal = (targetMs - fixedMs) / scaledPauseMs;
+    const pace = Math.min(MAX_PACE, Math.max(MIN_PACE, ideal));
+    const clamped = Math.abs(pace - ideal) > 1e-9;
+    if (!clamped) {
+        return { pace: Number(pace.toFixed(3)), clamped, naturalMs, targetMs };
+    }
+    const reachableMs = Math.round(fixedMs + scaledPauseMs * pace);
+    return {
+        pace: Number(pace.toFixed(3)),
+        clamped,
+        naturalMs,
+        targetMs,
+        warning: `target ${(targetMs / 1000).toFixed(0)}s needs pace ${ideal.toFixed(2)}, ` +
+            `which is outside the watchable range - clamped to ${pace} for about ` +
+            `${(reachableMs / 1000).toFixed(0)}s. ` +
+            (ideal < MIN_PACE
+                ? "Drop a step or a tour stop to make it shorter."
+                : "Add a beat or another stop to fill the time."),
+    };
+}
+//# sourceMappingURL=duration.js.map

package/dist/src/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAC5B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAE5B,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAExC,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE1D,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEpD,MAAM,IAAI,eAAe,CAAC,iCAAiC,KAAK,IAAI,EAAE,kBAAkB,EAAE;QACxF,wFAAwF;KACzF,CAAC,CAAC;AACL,CAAC;AAYD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,SAAiB,EACjB,QAAgB,EAChB,aAAa,GAAG,SAAS;IAEzB,IAAI,SAAS,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,aAAa,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC,CAAC;IAC/D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO;QACP,SAAS;QACT,QAAQ;QACR,OAAO,EACL,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC1E,qDAAqD,IAAI,aAAa;YACtE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YACvC,CAAC,KAAK,GAAG,QAAQ;gBACf,CAAC,CAAC,gDAAgD;gBAClD,CAAC,CAAC,8CAA8C,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/src/encode.d.ts

@@ -0,0 +1,67 @@
+import { type PosterEncoder, type Toolchain } from "./toolchain.js";
+export interface EncodeSettings {
+    /** Output width in px; height follows the source aspect ratio. */
+    readonly width: number;
+    /** Frame rate of the mp4 and webm deliverables. */
+    readonly fps: number;
+    readonly mp4: {
+        readonly crf: number;
+        readonly preset: string;
+        readonly profile: string;
+    };
+    readonly webm: {
+        readonly crf: number;
+    };
+    readonly poster: {
+        readonly quality: number;
+    };
+    /**
+     * Looping images, for the places a `<video>` does not render: a README, an
+     * npm page, an email. Both are opt-in and both are far heavier than the mp4
+     * - measured on a real 16.7s screencast at 800px/15fps, the mp4 was 182 KB,
+     * animated WebP 944 KB and GIF 2,034 KB.
+     *
+     * Prefer WebP: same content, roughly half the bytes, and full colour rather
+     * than a 256-entry palette. GIF is the fallback for somewhere that will not
+     * render WebP.
+     */
+    readonly gif: boolean;
+    readonly animatedWebp: boolean;
+    readonly gifWidth: number;
+    readonly gifFps: number;
+    /** Quality for the animated WebP, 0-100. */
+    readonly animatedWebpQuality: number;
+}
+export declare const DEFAULT_ENCODE_SETTINGS: EncodeSettings;
+export interface EncodeOptions extends EncodeSettings {
+    /** Raw Playwright capture (VP8 webm). */
+    readonly input: string;
+    /** Directory the deliverables are written to. */
+    readonly outDir: string;
+    /** File stem, e.g. `task-create`. */
+    readonly id: string;
+    /** Seconds to cut off the head: setup, navigation, first paint. */
+    readonly trimStart: number;
+    /** Pre-detected toolchain, so a batch does not re-probe per clip. */
+    readonly toolchain?: Toolchain;
+}
+export interface EncodeResult {
+    readonly mp4: string;
+    readonly webm: string;
+    readonly poster: string;
+    readonly gif?: string;
+    readonly animatedWebp?: string;
+    /** Byte size per deliverable, keyed by file name. */
+    readonly sizes: Readonly<Record<string, number>>;
+    /** Which poster path was taken, for the CLI to report. */
+    readonly posterEncoder: PosterEncoder;
+}
+/**
+ * Turns the raw Playwright capture into web deliverables.
+ *
+ * - mp4  (h264, yuv420p, faststart) - the one a page plays.
+ * - webm (vp9) - smaller, served first via `<source>`.
+ * - poster - the frame shown before the video decodes, so nothing pops in.
+ * - gif  - optional, opt-in.
+ */
+export declare function encode(opts: EncodeOptions): Promise<EncodeResult>;