deio-scroll 1.0.0

package/dist/browser/detectScrollMode.js

@@ -0,0 +1,61 @@
+const DOCUMENT_SCROLL_THRESHOLD_PX = 48;
+export async function detectScrollMode(page, requestedMode = "auto") {
+    if (requestedMode === "document" || requestedMode === "virtual") {
+        return requestedMode;
+    }
+    const signals = await page.evaluate((threshold) => {
+        const docMaxScroll = Math.max(0, document.documentElement.scrollHeight - window.innerHeight);
+        const bodyStyle = getComputedStyle(document.body);
+        const htmlStyle = getComputedStyle(document.documentElement);
+        const bodyScrollLocked = bodyStyle.overflowY === "hidden" || bodyStyle.overflow === "hidden";
+        const htmlScrollLocked = htmlStyle.overflowY === "hidden" || htmlStyle.overflow === "hidden";
+        const viewportLocked = Math.abs(document.documentElement.scrollHeight - window.innerHeight) <=
+            threshold &&
+            Math.abs((document.body?.scrollHeight ?? 0) - window.innerHeight) <=
+                threshold;
+        const fixedViewportShell = [...document.querySelectorAll("body *")].some((element) => {
+            const style = getComputedStyle(element);
+            const rect = element.getBoundingClientRect();
+            return ((style.position === "fixed" || style.position === "sticky") &&
+                rect.height >= window.innerHeight * 0.85 &&
+                rect.width >= window.innerWidth * 0.85);
+        });
+        const canvasHeavy = document.querySelectorAll("canvas").length >= 3;
+        const innerScrollContainers = [...document.querySelectorAll("*")].filter((element) => {
+            const style = getComputedStyle(element);
+            return ((style.overflowY === "auto" || style.overflowY === "scroll") &&
+                element.scrollHeight > element.clientHeight + threshold);
+        }).length;
+        return {
+            docMaxScroll,
+            viewportLocked,
+            bodyScrollLocked,
+            htmlScrollLocked,
+            fixedViewportShell,
+            canvasHeavy,
+            innerScrollContainers,
+        };
+    }, DOCUMENT_SCROLL_THRESHOLD_PX);
+    if (signals.docMaxScroll > DOCUMENT_SCROLL_THRESHOLD_PX) {
+        return "document";
+    }
+    const canNativeScroll = await page.evaluate(() => {
+        const before = window.scrollY;
+        window.scrollTo({ top: 100, left: 0, behavior: "instant" });
+        const after = window.scrollY;
+        window.scrollTo({ top: 0, left: 0, behavior: "instant" });
+        return after > before;
+    });
+    if (canNativeScroll) {
+        return "document";
+    }
+    const lowNativeScroll = signals.docMaxScroll <= DOCUMENT_SCROLL_THRESHOLD_PX;
+    const virtualSignals = [
+        lowNativeScroll && (signals.bodyScrollLocked || signals.htmlScrollLocked),
+        lowNativeScroll && signals.fixedViewportShell,
+        signals.canvasHeavy && lowNativeScroll,
+        signals.innerScrollContainers > 0 && lowNativeScroll,
+    ];
+    return virtualSignals.some(Boolean) ? "virtual" : "document";
+}
+//# sourceMappingURL=detectScrollMode.js.map

package/dist/browser/detectScrollMode.js.map

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

package/dist/browser/directionGuardrails.d.ts

@@ -0,0 +1,22 @@
+import type { MotionPlanAdjustment, MotionTarget, ResolvedMotionBeat, ScrollCurve } from "../types.js";
+export declare function normalizeResolvedBeats(options: {
+    beats: ResolvedMotionBeat[];
+    startHoldMs: number;
+    viewportHeight: number;
+    /** Converts position units to CSS/wheel pixels. Document scroll uses 1. */
+    positionScale?: number;
+    adjustments?: MotionPlanAdjustment[];
+}): {
+    beats: {
+        target: MotionTarget;
+        position: number;
+        transitionMs: number;
+        holdMs: number;
+        curve: ScrollCurve;
+        interaction?: import("../types.js").ComponentInteraction;
+        framing?: import("../types.js").ResolvedBeatFraming;
+    }[];
+    adjustments: MotionPlanAdjustment[];
+};
+export declare function peakCurveSlope(curve: ScrollCurve): number;
+//# sourceMappingURL=directionGuardrails.d.ts.map

package/dist/browser/directionGuardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directionGuardrails.d.ts","sourceRoot":"","sources":["../../src/browser/directionGuardrails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACtC;;;;;;;;;;;EAgFA;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,UAWhD"}

package/dist/browser/directionGuardrails.js

@@ -0,0 +1,99 @@
+import { resolveScrollCurve } from "./curves.js";
+import { applyScrollCurve } from "./scrollEasing.js";
+const SAFE_CURVE = { preset: "ease-in-out-cubic" };
+const MAX_VIEWPORTS_PER_SECOND = 1.5;
+export function normalizeResolvedBeats(options) {
+    const scale = options.positionScale ?? 1;
+    const mergeDistance = Math.max(100, options.viewportHeight * 0.12);
+    const adjustments = [...(options.adjustments ?? [])];
+    const merged = [];
+    options.beats.forEach((beat, sourceIndex) => {
+        const previous = merged.at(-1);
+        const distancePx = previous
+            ? Math.abs(beat.position - previous.position) * scale
+            : Number.POSITIVE_INFINITY;
+        // Nearby scroll positions can still represent separate UI controls (for
+        // example two tabs inside one fixed product mockup). Never collapse an
+        // authored interaction into another beat.
+        if (previous && distancePx <= mergeDistance && !previous.interaction && !beat.interaction) {
+            const preferIncoming = targetRank(beat.target) > targetRank(previous.target);
+            const requested = beat.target;
+            if (preferIncoming) {
+                previous.target = beat.target;
+                previous.position = beat.position;
+                previous.framing = beat.framing;
+            }
+            previous.holdMs = Math.max(previous.holdMs, beat.holdMs);
+            adjustments.push({
+                beatIndex: sourceIndex,
+                code: "merged-nearby-beat",
+                message: `Merged a target only ${Math.round(distancePx)}px from the previous beat`,
+                requested,
+                resolved: previous.target,
+            });
+            return;
+        }
+        merged.push({ ...beat, sourceIndex });
+    });
+    let previousPosition = 0;
+    let previousHoldMs = options.startHoldMs;
+    for (const beat of merged) {
+        const bezier = resolveScrollCurve(beat.curve);
+        const startSlope = applyScrollCurve(0.001, bezier) / 0.001;
+        const endSlope = (1 - applyScrollCurve(0.999, bezier)) / 0.001;
+        const startsFast = previousHoldMs > 0 && startSlope > 0.25;
+        const stopsFast = beat.holdMs > 0 && endSlope > 0.25;
+        if (startsFast || stopsFast) {
+            const requested = beat.curve.preset ?? "custom";
+            beat.curve = SAFE_CURVE;
+            adjustments.push({
+                beatIndex: beat.sourceIndex,
+                code: "replaced-boundary-curve",
+                message: "Replaced a curve that would start or stop abruptly at a hold",
+                requested,
+                resolved: SAFE_CURVE.preset,
+            });
+        }
+        const distancePx = Math.abs(beat.position - previousPosition) * scale;
+        const peakSlope = peakCurveSlope(beat.curve);
+        const maxVelocity = options.viewportHeight * MAX_VIEWPORTS_PER_SECOND;
+        const minimumDurationMs = Math.ceil(((distancePx * peakSlope) / Math.max(1, maxVelocity) * 1000) / 50) * 50;
+        if (minimumDurationMs > beat.transitionMs) {
+            const requested = beat.transitionMs;
+            beat.transitionMs = minimumDurationMs;
+            adjustments.push({
+                beatIndex: beat.sourceIndex,
+                code: "stretched-transition",
+                message: `Stretched the transition to stay below ${MAX_VIEWPORTS_PER_SECOND} viewport heights per second`,
+                requested,
+                resolved: beat.transitionMs,
+            });
+        }
+        previousPosition = beat.position;
+        previousHoldMs = beat.holdMs;
+    }
+    return {
+        beats: merged.map(({ sourceIndex: _sourceIndex, ...beat }) => beat),
+        adjustments,
+    };
+}
+export function peakCurveSlope(curve) {
+    const bezier = resolveScrollCurve(curve);
+    let previous = 0;
+    let peak = 0;
+    const sampleCount = 1000;
+    for (let index = 1; index <= sampleCount; index += 1) {
+        const value = applyScrollCurve(index / sampleCount, bezier);
+        peak = Math.max(peak, (value - previous) * sampleCount);
+        previous = value;
+    }
+    return peak;
+}
+function targetRank(target) {
+    if (target.type === "selector")
+        return 3;
+    if (target.type === "progress")
+        return 2;
+    return 1;
+}
+//# sourceMappingURL=directionGuardrails.js.map

package/dist/browser/directionGuardrails.js.map

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

package/dist/browser/goto.d.ts

@@ -0,0 +1,9 @@
+import type { Page } from 'playwright';
+export interface PageAccessSnapshot {
+    status?: number;
+    title: string;
+    bodyText: string;
+}
+export declare function gotoReachablePage(page: Page, url: string): Promise<void>;
+export declare function detectSiteProtectionBlock(snapshot: PageAccessSnapshot): boolean;
+//# sourceMappingURL=goto.d.ts.map

package/dist/browser/goto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goto.d.ts","sourceRoot":"","sources":["../../src/browser/goto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,YAAY,CAAA;AAIhD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAKD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,iBA+B9D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,kBAAkB,WAmBrE"}

package/dist/browser/goto.js

@@ -0,0 +1,62 @@
+import { assertAddressAllowed, assertSafeTargetUrl, installNetworkGuard, targetNetworkPolicyFromEnv } from './networkPolicy.js';
+import { waitForScrollReady } from './scrollReadiness.js';
+const SITE_PROTECTION_MESSAGE = 'Automation blocked by site protection. This website does not allow automated browser capture.';
+export async function gotoReachablePage(page, url) {
+    const policy = targetNetworkPolicyFromEnv();
+    await assertSafeTargetUrl(url, policy);
+    await installNetworkGuard(page, policy);
+    let response;
+    try {
+        response = await page.goto(url, { waitUntil: 'load', timeout: 30000 });
+    }
+    catch (loadError) {
+        try {
+            response = await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 15000 });
+        }
+        catch {
+            throw loadError;
+        }
+    }
+    await assertSafeTargetUrl(page.url(), policy);
+    const server = await response?.serverAddr().catch(() => null);
+    if (server?.ipAddress) {
+        assertAddressAllowed(server.ipAddress, new URL(page.url()).hostname, policy);
+    }
+    await assertPageAllowsAutomation(page, response?.status());
+    const readiness = await waitForScrollReady(page);
+    // Some challenge pages render a neutral shell first and replace it with the
+    // denial after their browser-verification script completes.
+    await assertPageAllowsAutomation(page, response?.status());
+    if (readiness.waited) {
+        console.log(readiness.timedOut
+            ? 'Scroll readiness remained locked; continuing with virtual-scroll detection.'
+            : 'Waited for a temporary scroll intro to release the document.');
+    }
+}
+export function detectSiteProtectionBlock(snapshot) {
+    if (snapshot.status === 401 || snapshot.status === 403)
+        return true;
+    const content = `${snapshot.title}\n${snapshot.bodyText}`
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase();
+    return (/\baccess denied\b/.test(content) ||
+        /\bfailed to verify (?:your )?browser\b/.test(content) ||
+        /\b(?:unable|could not) to verify (?:your )?browser\b/.test(content) ||
+        /\bbrowser verification (?:failed|required)\b/.test(content) ||
+        /\bverify (?:that )?you are human\b/.test(content) ||
+        /\bchecking (?:your )?browser\b/.test(content) ||
+        /\bsecurity checkpoint\b/.test(content) ||
+        /\bcaptcha (?:required|verification|challenge)\b/.test(content) ||
+        (/\bcode 21\b/.test(content) && /\b(?:browser|verify|security|challenge)\b/.test(content)));
+}
+async function assertPageAllowsAutomation(page, status) {
+    const snapshot = await page.evaluate(() => ({
+        title: document.title || '',
+        bodyText: (document.body?.innerText || '').slice(0, 8_000),
+    })).catch(() => ({ title: '', bodyText: '' }));
+    if (detectSiteProtectionBlock({ status, ...snapshot })) {
+        throw new Error(SITE_PROTECTION_MESSAGE);
+    }
+}
+//# sourceMappingURL=goto.js.map

package/dist/browser/goto.js.map

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

package/dist/browser/hydrate.d.ts

@@ -0,0 +1,8 @@
+import type { Page } from "playwright";
+export interface HydrateOptions {
+    fast?: boolean;
+    /** Wheel nudges help virtual-scroll sites; skip on document-scroll pages. */
+    useWheel?: boolean;
+}
+export declare function hydrateLazyContent(page: Page, viewportHeight: number, options?: HydrateOptions): Promise<void>;
+//# sourceMappingURL=hydrate.d.ts.map

package/dist/browser/hydrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/browser/hydrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAUvC,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA2BD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,cAAmB,iBAqE7B"}

package/dist/browser/hydrate.js

@@ -0,0 +1,73 @@
+const DEFAULT_SCROLL_SETTLE_MS = 350;
+const DEFAULT_MAX_SCROLL_PASSES = 1;
+const DEFAULT_MAX_SCROLL_STEPS = 24;
+const FAST_SCROLL_SETTLE_MS = 180;
+const FAST_MAX_SCROLL_PASSES = 1;
+const FAST_MAX_SCROLL_STEPS = 10;
+async function documentHeight(page) {
+    return page.evaluate(() => Math.max(document.documentElement.scrollHeight, document.body?.scrollHeight ?? 0, window.innerHeight));
+}
+async function waitForStableDocumentHeight(page, settleMs, fast) {
+    const checks = fast ? 2 : 4;
+    let last = await documentHeight(page);
+    for (let index = 0; index < checks; index += 1) {
+        await page.waitForTimeout(fast ? 150 : 350);
+        const next = await documentHeight(page);
+        if (Math.abs(next - last) < 8)
+            return;
+        last = next;
+    }
+}
+export async function hydrateLazyContent(page, viewportHeight, options = {}) {
+    const fast = options.fast ?? false;
+    const useWheel = options.useWheel ?? true;
+    const scrollSettleMs = fast
+        ? FAST_SCROLL_SETTLE_MS
+        : DEFAULT_SCROLL_SETTLE_MS;
+    const maxPasses = fast ? FAST_MAX_SCROLL_PASSES : DEFAULT_MAX_SCROLL_PASSES;
+    const maxSteps = fast ? FAST_MAX_SCROLL_STEPS : DEFAULT_MAX_SCROLL_STEPS;
+    const networkIdleTimeout = fast ? 1200 : 3000;
+    await page
+        .waitForLoadState("networkidle", { timeout: networkIdleTimeout })
+        .catch(() => undefined);
+    await page.evaluate(() => window.scrollTo({ top: 0, left: 0, behavior: "instant" }));
+    await page.waitForTimeout(fast ? 120 : 300);
+    let previousHeight = await documentHeight(page);
+    for (let pass = 0; pass < maxPasses; pass += 1) {
+        let y = 0;
+        for (let step = 0; step < maxSteps; step += 1) {
+            const height = await documentHeight(page);
+            const maxY = Math.max(0, height - viewportHeight);
+            y = Math.min(maxY, step === 0 ? 0 : y + Math.floor(viewportHeight * (fast ? 0.9 : 0.78)));
+            await page.evaluate((nextY) => window.scrollTo({ top: nextY, left: 0, behavior: "instant" }), y);
+            if (useWheel) {
+                await page.mouse
+                    .wheel(0, Math.floor(viewportHeight * (fast ? 0.3 : 0.18)))
+                    .catch(() => undefined);
+            }
+            await page.waitForTimeout(scrollSettleMs);
+            if (y >= maxY)
+                break;
+        }
+        await page.evaluate(() => window.scrollTo({
+            top: document.documentElement.scrollHeight,
+            left: 0,
+            behavior: "instant",
+        }));
+        await page.waitForTimeout(scrollSettleMs);
+        const nextHeight = await documentHeight(page);
+        if (Math.abs(nextHeight - previousHeight) < 8)
+            break;
+        previousHeight = nextHeight;
+    }
+    await page.evaluate(() => window.scrollTo({
+        top: document.documentElement.scrollHeight,
+        left: 0,
+        behavior: "instant",
+    }));
+    await page.waitForTimeout(fast ? 200 : 700);
+    await page.evaluate(() => window.scrollTo({ top: 0, left: 0, behavior: "instant" }));
+    await page.waitForTimeout(fast ? 200 : 700);
+    await waitForStableDocumentHeight(page, scrollSettleMs, fast);
+}
+//# sourceMappingURL=hydrate.js.map

package/dist/browser/hydrate.js.map

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

package/dist/browser/mediaClock.d.ts

@@ -0,0 +1,9 @@
+import type { Page } from "playwright";
+/**
+ * Screenshot capture can be substantially slower than its output frame rate.
+ * Native videos otherwise advance at wall-clock speed and appear fast-forwarded
+ * in the encoded sequence. This controller keeps them on the output timeline.
+ */
+export declare function installMediaClock(page: Page): Promise<void>;
+export declare function createMediaClockSync(page: Page, fps: number): Promise<(frameNumber: number) => Promise<void>>;
+//# sourceMappingURL=mediaClock.d.ts.map

package/dist/browser/mediaClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaClock.d.ts","sourceRoot":"","sources":["../../src/browser/mediaClock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEjE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,yBAGrC,MAAM,oBAelC"}

package/dist/browser/mediaClock.js

@@ -0,0 +1,86 @@
+import { performance } from "node:perf_hooks";
+const MEDIA_CLOCK_KEY = "__websiterecorderMediaClock";
+/**
+ * Screenshot capture can be substantially slower than its output frame rate.
+ * Native videos otherwise advance at wall-clock speed and appear fast-forwarded
+ * in the encoded sequence. This controller keeps them on the output timeline.
+ */
+export async function installMediaClock(page) {
+    // Use source text rather than a serialized TypeScript callback. tsx/esbuild
+    // annotates nested functions with a global __name helper that is not present
+    // in a page's isolated init-script world.
+    await page.addInitScript({ content: `(() => {
+    const key = ${JSON.stringify(MEDIA_CLOCK_KEY)};
+    const state = {
+      active: false,
+      rate: 0.08,
+      videos: new Set(),
+      register(video) {
+        this.videos.add(video);
+        video.muted = true;
+        setPlaybackRate(video, this.rate);
+        if (!this.active) video.pause();
+      },
+      sync(rate) {
+        this.active = true;
+        this.rate = rate;
+        document.querySelectorAll("video").forEach((video) => this.register(video));
+        for (const video of this.videos) {
+          if (!video.isConnected) continue;
+          video.muted = true;
+          setPlaybackRate(video, rate);
+          video.play().catch(() => undefined);
+        }
+        for (const animation of document.getAnimations()) {
+          if (animation.timeline && animation.timeline !== document.timeline) continue;
+          try {
+            animation.playbackRate = rate;
+          } catch {
+            try {
+              animation.updatePlaybackRate(rate);
+            } catch {
+              // Scroll-timeline or page-owned animations can reject control.
+            }
+          }
+        }
+      },
+    };
+
+    // Chromium's supported range varies by media implementation. Keep the
+    // controller from failing the whole capture when a page rejects a rate.
+    function setPlaybackRate(video, rate) {
+      try {
+        video.playbackRate = Math.max(0.0625, Math.min(16, rate));
+      } catch {
+        try {
+          video.playbackRate = 0.25;
+        } catch {
+          // Leave the site's default rate in place rather than failing capture.
+        }
+      }
+    }
+
+    Object.defineProperty(window, key, { value: state, configurable: true });
+    document.addEventListener("play", (event) => {
+      const video = event.target;
+      if (video instanceof HTMLVideoElement) state.register(video);
+    }, true);
+    document.addEventListener("DOMContentLoaded", () => {
+      document.querySelectorAll("video").forEach((video) => state.register(video));
+    }, { once: true });
+  })()` });
+}
+export async function createMediaClockSync(page, fps) {
+    const startedAt = performance.now();
+    return async (frameNumber) => {
+        const outputSeconds = frameNumber / fps;
+        const wallSeconds = Math.max(0.001, (performance.now() - startedAt) / 1000);
+        // A little floor avoids stalling media on very slow, high-resolution captures.
+        const rate = Math.min(1, Math.max(0.0625, outputSeconds / wallSeconds || 0.08));
+        await page.evaluate(({ key, rate: nextRate }) => {
+            const state = window[key];
+            state?.sync?.(nextRate);
+        }, { key: MEDIA_CLOCK_KEY, rate });
+    };
+}
+//# sourceMappingURL=mediaClock.js.map

package/dist/browser/mediaClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaClock.js","sourceRoot":"","sources":["../../src/browser/mediaClock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IAChD,4EAA4E;IAC5E,6EAA6E;IAC7E,0CAA0C;IAC1C,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE;kBACpB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0D1C,EAAE,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAU,EAAE,GAAW;IAChE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEpC,OAAO,KAAK,EAAE,WAAmB,EAAE,EAAE;QACnC,MAAM,aAAa,GAAG,WAAW,GAAG,GAAG,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5E,+EAA+E;QAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC;QAChF,MAAM,IAAI,CAAC,QAAQ,CACjB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC1B,MAAM,KAAK,GAAI,MAEZ,CAAC,GAAG,CAAC,CAAC;YACT,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC,EACD,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,CAC/B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/browser/motion.d.ts

@@ -0,0 +1,21 @@
+import type { BezierControlPoints } from "./curves.js";
+export interface TimelineBeat {
+    position: number;
+    transitionMs: number;
+    holdMs: number;
+    bezier: BezierControlPoints;
+}
+export interface MotionSample {
+    position: number;
+    phase: "transition" | "hold";
+    beatIndex: number;
+    phaseProgress?: number;
+}
+export declare function buildMotionTimeline(options: {
+    fps: number;
+    startPosition?: number;
+    startHoldMs?: number;
+    beats: TimelineBeat[];
+}): MotionSample[];
+export declare function framesForDuration(durationMs: number, fps: number): number;
+//# sourceMappingURL=motion.d.ts.map

package/dist/browser/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/browser/motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB,GAAG,YAAY,EAAE,CAwCjB;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAEhE"}

package/dist/browser/motion.js

@@ -0,0 +1,42 @@
+import { applyScrollCurve } from "./scrollEasing.js";
+export function buildMotionTimeline(options) {
+    const fps = Math.max(1, options.fps);
+    const samples = [];
+    let position = options.startPosition ?? 0;
+    const startHoldFrames = framesForDuration(options.startHoldMs ?? 0, fps);
+    for (let frame = 0; frame < startHoldFrames; frame += 1) {
+        samples.push({ position, phase: "hold", beatIndex: -1, phaseProgress: startHoldFrames <= 1 ? 1 : frame / (startHoldFrames - 1) });
+    }
+    options.beats.forEach((beat, beatIndex) => {
+        const start = position;
+        const transitionFrames = Math.max(1, framesForDuration(beat.transitionMs, fps));
+        for (let frame = 1; frame <= transitionFrames; frame += 1) {
+            const progress = frame / transitionFrames;
+            const eased = applyScrollCurve(progress, beat.bezier);
+            samples.push({
+                position: start + (beat.position - start) * eased,
+                phase: "transition",
+                beatIndex,
+                phaseProgress: progress,
+            });
+        }
+        position = beat.position;
+        const holdFrames = framesForDuration(beat.holdMs, fps);
+        for (let frame = 0; frame < holdFrames; frame += 1) {
+            samples.push({
+                position,
+                phase: "hold",
+                beatIndex,
+                phaseProgress: holdFrames <= 1 ? 1 : frame / (holdFrames - 1),
+            });
+        }
+    });
+    if (samples.length === 0) {
+        samples.push({ position, phase: "hold", beatIndex: -1, phaseProgress: 1 });
+    }
+    return samples;
+}
+export function framesForDuration(durationMs, fps) {
+    return Math.max(0, Math.round((Math.max(0, durationMs) / 1000) * fps));
+}
+//# sourceMappingURL=motion.js.map

package/dist/browser/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.js","sourceRoot":"","sources":["../../src/browser/motion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAgBrD,MAAM,UAAU,mBAAmB,CAAC,OAKnC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;IAE1C,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACzE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,eAAe,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,eAAe,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACpI,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC;QACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;QAChF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,gBAAgB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,KAAK,GAAG,gBAAgB,CAAC;YAC1C,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,KAAK;gBACjD,KAAK,EAAE,YAAY;gBACnB,SAAS;gBACT,aAAa,EAAE,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAEzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACvD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ;gBACR,KAAK,EAAE,MAAM;gBACb,SAAS;gBACT,aAAa,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,GAAW;IAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/browser/networkPolicy.d.ts

@@ -0,0 +1,11 @@
+import type { Page } from "playwright";
+export interface TargetNetworkPolicy {
+    allowLocalhost: boolean;
+    allowPrivateNetworks: boolean;
+}
+export declare function targetNetworkPolicyFromEnv(): TargetNetworkPolicy;
+export declare function installNetworkGuard(page: Page, policy?: TargetNetworkPolicy): Promise<void>;
+export declare function assertSafeTargetUrl(value: string, policy?: TargetNetworkPolicy): Promise<URL>;
+export declare function assertAddressAllowed(address: string, hostname: string, policy: TargetNetworkPolicy): void;
+export declare function addressCategory(address: string): "public" | "loopback" | "private";
+//# sourceMappingURL=networkPolicy.d.ts.map

package/dist/browser/networkPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkPolicy.d.ts","sourceRoot":"","sources":["../../src/browser/networkPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAS,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAKD,wBAAgB,0BAA0B,IAAI,mBAAmB,CAMhE;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,MAAM,sBAA+B,iBAYtC;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,sBAA+B,gBAiBtC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,QAa5B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CA0BlF"}