screenci 0.0.69 → 0.0.70

package/dist/docs/video-sources/product-pitch.screenci.js

@@ -0,0 +1,136 @@
+import { expect } from '@playwright/test';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { autoZoom, createNarration, createOverlays, hide, resetZoom, video, voices, zoomTo, } from 'screenci';
+// Before recording:
+//   1. Put the condensed, cursor-safe agent capture at assets/agent.mp4.
+//   2. Set SCREENCI_APP_STORAGE_STATE to a logged-in Playwright storage state.
+//   3. Override these defaults when the agent created a different remote video:
+//        SCREENCI_PITCH_PROJECT_NAME
+//        SCREENCI_PITCH_VIDEO_NAME
+//
+// This video deliberately starts a real one-off Studio render. Testing or
+// recording it therefore consumes one render. Keep agent.mp4 short enough that
+// the complete pitch remains below two minutes (roughly 20-25 seconds).
+const projectName = process.env.SCREENCI_PITCH_PROJECT_NAME ?? 'demo-saas';
+const videoName = process.env.SCREENCI_PITCH_VIDEO_NAME ?? 'Vertical invoice';
+const agentRecording = fileURLToPath(new URL('../assets/agent.mp4', import.meta.url));
+const overlays = createOverlays({
+    agentSession: {
+        path: '../assets/agent.mp4',
+        fullScreen: true,
+        // The launch narration explains this condensed recording, so mute any
+        // incidental screen-recorder audio in the source clip.
+        audio: 0,
+    },
+});
+const narration = createNarration({
+    voice: {
+        name: voices.Sophie,
+        style: 'Calm, direct developer presenting a real product workflow',
+    },
+    en: {
+        intro: 'This video shows how a coding agent and ScreenCI [pronounce: screen see eye] turn a product flow into a finished product video.',
+        agent: 'I asked the agent to create a narrated walkthrough for this sample SaaS application. This is the actual session, condensed.',
+        source: 'It reads the application, then writes and tests a Playwright-style video file in the repository.',
+        oneOff: 'The flow is already recorded, so I can render a one-off version without recording the application again.',
+        rendering: 'This is the real render job, combining the recording, narration, camera motion, and overlays.',
+        privacy: 'The application, source, session, and credentials stayed local. Only the recording and timing data were uploaded.',
+        delivery: 'The finished video is ready to review, download, or publish through a stable public URL.',
+        maintenance: 'Run the source locally or in CI. If the product flow changes, it fails visibly instead of leaving a stale walkthrough online.',
+        more: 'One recording can produce language versions with synchronized narration and subtitles, cloned voices, and React or HTML overlays.',
+        outro: 'That is ScreenCI [pronounce: screen see eye]: from a coding-agent prompt to a product video you can rerun whenever the product changes.',
+    },
+});
+video('ScreenCI product pitch', async ({ page }) => {
+    video.skip(!process.env.SCREENCI_APP_STORAGE_STATE, 'Requires SCREENCI_APP_STORAGE_STATE with a logged-in ScreenCI app session.');
+    video.skip(!existsSync(agentRecording), 'Add the condensed agent capture at screenci/assets/agent.mp4.');
+    // Start in Studio for the video produced during the captured agent session.
+    // Authentication and dashboard navigation are setup, so they are not shown.
+    await hide(async () => {
+        await page.goto('https://app.screenci.com/');
+        await page.waitForLoadState('networkidle');
+        const projects = page.getByTestId('projects-list');
+        await expect(projects).toBeVisible({ timeout: 30_000 });
+        await projects.getByRole('link', { name: projectName, exact: true }).click();
+        await page.getByRole('link', { name: videoName, exact: true }).click();
+        await expect(page.getByRole('heading', { name: /languages/i })).toBeVisible({ timeout: 30_000 });
+        await page.getByRole('link', { name: /open in studio/i }).click();
+        await expect(page.getByRole('heading', { name: /^studio$/i })).toBeVisible({
+            timeout: 30_000,
+        });
+    });
+    await narration.intro();
+    // agent.mp4 uses its natural duration. Keep it condensed to 20-25 seconds.
+    await narration.agent.start();
+    await overlays.agentSession();
+    await narration.agent.end();
+    await narration.source();
+    // This is an intentional real side effect: every run starts one new Studio
+    // render for the selected language.
+    await narration.oneOff.start();
+    await autoZoom(async () => {
+        await page.getByRole('button', { name: 'Create one-off version' }).click();
+        const dialog = page.getByRole('alertdialog');
+        await expect(dialog.getByRole('heading', { name: 'Create a one-off version' })).toBeVisible();
+        await dialog.getByRole('button', { name: 'Continue' }).click();
+        const renderButton = page.getByRole('button', {
+            name: /^Render one-off [A-Z-]+$/,
+        });
+        await expect(renderButton).toBeEnabled();
+        await renderButton.click();
+    });
+    await expect(page.getByText(/One-off render started for [A-Z-]+\./)).toBeVisible({ timeout: 30_000 });
+    await narration.oneOff.end();
+    await narration.rendering.start();
+    await page.getByRole('link', { name: /view render/i }).click();
+    await expect(page.getByRole('heading', { name: /^Studio render/ })).toBeVisible({ timeout: 30_000 });
+    await narration.rendering.end();
+    // Show the genuine progress UI, but cut the unpredictable cloud wait from
+    // the final timeline. A fast render may already be complete at this point.
+    await page.waitForTimeout(1_500);
+    await hide(async () => {
+        await expect(page.getByText('Rendering complete', { exact: true })).toBeVisible({ timeout: 10 * 60_000 });
+    });
+    await narration.privacy();
+    // Open the finished one-off version from the render-run page.
+    const finishedVersion = page
+        .getByRole('link')
+        .filter({ hasText: /View\s*→/ })
+        .first();
+    await expect(finishedVersion).toBeVisible();
+    await finishedVersion.click();
+    await expect(page.getByRole('heading', { name: /^v\d+$/ })).toBeVisible({
+        timeout: 30_000,
+    });
+    await expect(page.getByTestId('video-loading-overlay')).toBeHidden({
+        timeout: 30_000,
+    });
+    // Let the generated product video demonstrate itself without narration over
+    // it. Twelve seconds is enough to establish the output while keeping the
+    // complete pitch below two minutes.
+    const playButton = page.getByRole('button', { name: /^play$/i });
+    await expect(playButton).toBeVisible();
+    await playButton.click();
+    await page.waitForTimeout(12_000);
+    const pauseButton = page.getByRole('button', { name: /^pause$/i });
+    if (await pauseButton.isVisible()) {
+        await pauseButton.click();
+    }
+    await narration.delivery();
+    await zoomTo(page.getByRole('button', { name: 'Download Video' }));
+    await page.waitForTimeout(700);
+    await resetZoom();
+    await narration.maintenance();
+    // Return to the video overview so the language and delivery surfaces support
+    // the final feature summary visually.
+    await page.getByRole('link', { name: videoName, exact: true }).click();
+    await expect(page.getByRole('heading', { name: /languages/i })).toBeVisible({
+        timeout: 30_000,
+    });
+    await zoomTo(page.getByRole('heading', { name: /languages/i }));
+    await narration.more();
+    await resetZoom();
+    await narration.outro();
+});
+//# sourceMappingURL=product-pitch.screenci.js.map

package/dist/docs/video-sources/product-pitch.screenci.js.map

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

package/dist/docs/video-sources/public-urls.screenci.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-urls.screenci.d.ts.map

package/dist/docs/video-sources/public-urls.screenci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-urls.screenci.d.ts","sourceRoot":"","sources":["../../../docs/video-sources/public-urls.screenci.ts"],"names":[],"mappings":""}

package/dist/docs/video-sources/public-urls.screenci.js

@@ -0,0 +1,34 @@
+import { autoZoom, createNarration, hide, resetZoom, video, voices, } from 'screenci';
+// Source of record for the "Public URLs and embeds" docs video. It walks the
+// public-delivery explainer page: the stable base URL, the per-language
+// outputs, and a live embed that switches languages. Recorded against the
+// deployed demo so it runs without app authentication.
+const narration = createNarration({
+    voice: { name: voices.Sophie, style: 'Calm product guide' },
+    en: {
+        intro: 'Turn on public delivery and your video gets a stable URL on the CDN.',
+        langs: 'Each language has its own video, thumbnail, and subtitle URL.',
+        embed: 'Drop it into any site. It always resolves to the latest approved render.',
+    },
+});
+video('Public URLs and embeds', async ({ page }) => {
+    await hide(async () => {
+        await page.goto('https://demo.screenci.com/pitch/embed.html');
+        await page.waitForLoadState('networkidle');
+    });
+    await narration.intro();
+    await narration.langs.start();
+    await autoZoom(async () => {
+        await page.locator('.urls').scrollIntoViewIfNeeded();
+    });
+    await narration.langs.end();
+    await resetZoom();
+    await narration.embed.start();
+    await autoZoom(async () => {
+        await page.getByRole('button', { name: 'ES' }).click();
+        await page.getByRole('button', { name: 'EN' }).click();
+    });
+    await narration.embed.end();
+    await resetZoom();
+});
+//# sourceMappingURL=public-urls.screenci.js.map

package/dist/docs/video-sources/public-urls.screenci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-urls.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/public-urls.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,IAAI,EACJ,SAAS,EACT,KAAK,EACL,MAAM,GACP,MAAM,UAAU,CAAA;AAEjB,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,uDAAuD;AACvD,MAAM,SAAS,GAAG,eAAe,CAAC;IAChC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE;IAC3D,EAAE,EAAE;QACF,KAAK,EACH,sEAAsE;QACxE,KAAK,EAAE,+DAA+D;QACtE,KAAK,EACH,0EAA0E;KAC7E;CACF,CAAC,CAAA;AAEF,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACjD,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;QAC7D,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;IACvB,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IAC7B,MAAM,QAAQ,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,sBAAsB,EAAE,CAAA;IACtD,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAC3B,MAAM,SAAS,EAAE,CAAA;IAEjB,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IAC7B,MAAM,QAAQ,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;QACtD,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IACxD,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAC3B,MAAM,SAAS,EAAE,CAAA;AACnB,CAAC,CAAC,CAAA"}

package/dist/docs/video-sources/studio.screenci.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=studio.screenci.d.ts.map

package/dist/docs/video-sources/studio.screenci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.screenci.d.ts","sourceRoot":"","sources":["../../../docs/video-sources/studio.screenci.ts"],"names":[],"mappings":""}

package/dist/docs/video-sources/{studio.video.js → studio.screenci.js}

@@ -54,4 +54,4 @@ video('Studio web editing', async ({ page }) => {
     await page.waitForTimeout(900);
     await resetZoom();
 });
-//# sourceMappingURL=studio.video.js.map
+//# sourceMappingURL=studio.screenci.js.map

package/dist/docs/video-sources/studio.screenci.js.map

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

package/dist/docs/videos.d.ts

@@ -1,31 +1,52 @@
-export type PublishedDocVideo = {
-    publicId: string;
+/**
+ * A doc media embed is either a recorded `video` (the default) or a still
+ * `screenshot`. Both are produced by the same `.screenci.ts` source recorded in
+ * CI and published to the public delivery CDN; only the embed differs (a player
+ * vs an `<img>`).
+ */
+export type DocMediaKind = 'video' | 'screenshot';
+type DocMediaCommon = {
     sourcePath: string;
     showSource?: boolean;
+    /** Defaults to `'video'`. */
+    kind?: DocMediaKind;
+    /** Alt text for `kind: 'screenshot'` embeds. */
+    alt?: string;
 };
-export type UnpublishedDocVideo = {
-    sourcePath: string;
-    showSource?: boolean;
+export type PublishedDocVideo = DocMediaCommon & {
+    publicId: string;
 };
+export type UnpublishedDocVideo = DocMediaCommon;
 export type DocVideo = PublishedDocVideo | UnpublishedDocVideo;
 export declare const docsVideoRegistry: {
     readonly 'docs/installation': {
         readonly publicId: "kh7ccy03njvxjm0daef5g50zv587hrbd";
-        readonly sourcePath: "screenci/docs/video-sources/installation.video.ts";
+        readonly sourcePath: "screenci/docs/video-sources/installation.screenci.ts";
         readonly showSource: false;
     };
     readonly 'docs/reference/cli': {
         readonly publicId: "kh778mvzqw1t504wts9wqyaa2187dfc0";
-        readonly sourcePath: "screenci/docs/video-sources/cli.video.ts";
+        readonly sourcePath: "screenci/docs/video-sources/cli.screenci.ts";
+    };
+    readonly 'docs/guides/public-urls-and-embeds': {
+        readonly publicId: "kh7aj5s49s6wgfb86jgd0zht59890f17";
+        readonly sourcePath: "screenci/docs/video-sources/public-urls.screenci.ts";
+        readonly showSource: false;
+    };
+    readonly 'docs/guides/studio': {
+        readonly sourcePath: "screenci/docs/video-sources/studio.screenci.ts";
+        readonly showSource: false;
+    };
+    readonly 'docs/guides/assets-and-overlays': {
+        readonly sourcePath: "screenci/docs/video-sources/locator-highlight-animated.screenci.ts";
+    };
+    readonly 'docs/guides/screenshots': {
+        readonly kind: "screenshot";
+        readonly alt: "A marketing-site link highlighted by a pink ring with margin around it, framed as a branded still";
+        readonly sourcePath: "screenci/docs/video-sources/locator-highlight-still.screenci.ts";
     };
 };
-export declare function getDocVideo(slug: string): {
-    readonly publicId: "kh7ccy03njvxjm0daef5g50zv587hrbd";
-    readonly sourcePath: "screenci/docs/video-sources/installation.video.ts";
-    readonly showSource: false;
-} | {
-    readonly publicId: "kh778mvzqw1t504wts9wqyaa2187dfc0";
-    readonly sourcePath: "screenci/docs/video-sources/cli.video.ts";
-};
+export declare function getDocVideo(slug: string): DocVideo | null;
 export declare function hasPublicId(video: DocVideo): video is PublishedDocVideo;
+export {};
 //# sourceMappingURL=videos.d.ts.map

package/dist/docs/videos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videos.d.ts","sourceRoot":"","sources":["../../docs/videos.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,mBAAmB,CAAA;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUe,CAAA;AAE7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;;;;;;;EAEvC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,IAAI,iBAAiB,CAEvE"}
+{"version":3,"file":"videos.d.ts","sourceRoot":"","sources":["../../docs/videos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAA;AAEjD,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG;IAC/C,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAEhD,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,mBAAmB,CAAA;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCe,CAAA;AAE7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,IAAI,iBAAiB,CAEvE"}

package/dist/docs/videos.js

@@ -1,12 +1,37 @@
 export const docsVideoRegistry = {
     'docs/installation': {
         publicId: 'kh7ccy03njvxjm0daef5g50zv587hrbd',
-        sourcePath: 'screenci/docs/video-sources/installation.video.ts',
+        sourcePath: 'screenci/docs/video-sources/installation.screenci.ts',
         showSource: false,
     },
     'docs/reference/cli': {
         publicId: 'kh778mvzqw1t504wts9wqyaa2187dfc0',
-        sourcePath: 'screenci/docs/video-sources/cli.video.ts',
+        sourcePath: 'screenci/docs/video-sources/cli.screenci.ts',
+    },
+    // Recorded locally via apps/demo-saas/videos/pitch-embed.screenci.ts, then
+    // published with `screenci make-public`.
+    'docs/guides/public-urls-and-embeds': {
+        publicId: 'kh7aj5s49s6wgfb86jgd0zht59890f17',
+        sourcePath: 'screenci/docs/video-sources/public-urls.screenci.ts',
+        showSource: false,
+    },
+    // Add a publicId after publishing. The Studio video needs a logged-in app
+    // session (SCREENCI_APP_STORAGE_STATE) to record against app.screenci.com.
+    'docs/guides/studio': {
+        sourcePath: 'screenci/docs/video-sources/studio.screenci.ts',
+        showSource: false,
+    },
+    // The animated locator-highlight overlay in the Overlays guide. Add a
+    // publicId after publishing the source.
+    'docs/guides/assets-and-overlays': {
+        sourcePath: 'screenci/docs/video-sources/locator-highlight-animated.screenci.ts',
+    },
+    // The locator-highlight still in the Screenshots guide. Published as a
+    // screenshot recording; add a publicId after publishing the source.
+    'docs/guides/screenshots': {
+        kind: 'screenshot',
+        alt: 'A marketing-site link highlighted by a pink ring with margin around it, framed as a branded still',
+        sourcePath: 'screenci/docs/video-sources/locator-highlight-still.screenci.ts',
     },
 };
 export function getDocVideo(slug) {

package/dist/docs/videos.js.map

@@ -1 +1 @@
-{"version":3,"file":"videos.js","sourceRoot":"","sources":["../../docs/videos.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB,EAAE;QACnB,QAAQ,EAAE,kCAAkC;QAC5C,UAAU,EAAE,mDAAmD;QAC/D,UAAU,EAAE,KAAK;KAClB;IACD,oBAAoB,EAAE;QACpB,QAAQ,EAAE,kCAAkC;QAC5C,UAAU,EAAE,0CAA0C;KACvD;CAC0C,CAAA;AAE7C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,iBAAiB,CAAC,IAAsC,CAAC,IAAI,IAAI,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,OAAO,UAAU,IAAI,KAAK,CAAA;AAC5B,CAAC"}
+{"version":3,"file":"videos.js","sourceRoot":"","sources":["../../docs/videos.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB,EAAE;QACnB,QAAQ,EAAE,kCAAkC;QAC5C,UAAU,EAAE,sDAAsD;QAClE,UAAU,EAAE,KAAK;KAClB;IACD,oBAAoB,EAAE;QACpB,QAAQ,EAAE,kCAAkC;QAC5C,UAAU,EAAE,6CAA6C;KAC1D;IACD,2EAA2E;IAC3E,yCAAyC;IACzC,oCAAoC,EAAE;QACpC,QAAQ,EAAE,kCAAkC;QAC5C,UAAU,EAAE,qDAAqD;QACjE,UAAU,EAAE,KAAK;KAClB;IACD,0EAA0E;IAC1E,2EAA2E;IAC3E,oBAAoB,EAAE;QACpB,UAAU,EAAE,gDAAgD;QAC5D,UAAU,EAAE,KAAK;KAClB;IACD,sEAAsE;IACtE,wCAAwC;IACxC,iCAAiC,EAAE;QACjC,UAAU,EACR,oEAAoE;KACvE;IACD,uEAAuE;IACvE,oEAAoE;IACpE,yBAAyB,EAAE;QACzB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,mGAAmG;QACxG,UAAU,EACR,iEAAiE;KACpE;CAC0C,CAAA;AAE7C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,iBAAiB,CAAC,IAAsC,CAAC,IAAI,IAAI,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,OAAO,UAAU,IAAI,KAAK,CAAA;AAC5B,CAAC"}

package/dist/e2e/screenshot.e2e.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=screenshot.e2e.d.ts.map

package/dist/e2e/screenshot.e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.e2e.d.ts","sourceRoot":"","sources":["../../e2e/screenshot.e2e.ts"],"names":[],"mappings":""}

package/dist/e2e/screenshot.e2e.js

@@ -0,0 +1,73 @@
+import { test, expect } from '@playwright/test';
+import { resolveCrop } from '../src/crop.js';
+import { buildScreenCIContextOptions } from '../src/contextOptions.js';
+test.describe('resolveCrop', () => {
+    test('resolves a pixel rect for a locator', async ({ page }) => {
+        await page.setViewportSize({ width: 1000, height: 800 });
+        await page.setContent('<div id="card" style="position:absolute;left:100px;top:80px;width:300px;height:200px;background:#333"></div>');
+        const recorded = await resolveCrop(page.locator('#card'), page);
+        expect(recorded.source).toBe('locator');
+        expect(recorded.box.x).toBeCloseTo(100, 3);
+        expect(recorded.box.y).toBeCloseTo(80, 3);
+        expect(recorded.box.width).toBeCloseTo(300, 3);
+        expect(recorded.box.height).toBeCloseTo(200, 3);
+        expect(recorded.padding).toEqual({ top: 0, right: 0, bottom: 0, left: 0 });
+    });
+    test('resolves an explicit pixel region', async ({ page }) => {
+        await page.setViewportSize({ width: 1000, height: 800 });
+        const recorded = await resolveCrop({ x: 100, y: 160, width: 800, height: 480 }, page);
+        expect(recorded.source).toBe('region');
+        expect(recorded.box.x).toBeCloseTo(100, 3);
+        expect(recorded.box.y).toBeCloseTo(160, 3);
+        expect(recorded.box.width).toBeCloseTo(800, 3);
+        expect(recorded.box.height).toBeCloseTo(480, 3);
+    });
+    test('keeps a locator box locked and records padding separately', async ({ page, }) => {
+        await page.setViewportSize({ width: 1000, height: 1000 });
+        await page.setContent('<div id="card" style="position:absolute;left:400px;top:400px;width:200px;height:200px"></div>');
+        const recorded = await resolveCrop(page.locator('#card'), page, {
+            padding: 20,
+        });
+        // The element box is unchanged; the renderer applies the padding later.
+        expect(recorded.box.x).toBeCloseTo(400, 3);
+        expect(recorded.box.y).toBeCloseTo(400, 3);
+        expect(recorded.box.width).toBeCloseTo(200, 3);
+        expect(recorded.box.height).toBeCloseTo(200, 3);
+        expect(recorded.padding).toEqual({
+            top: 20,
+            right: 20,
+            bottom: 20,
+            left: 20,
+        });
+    });
+    test('rejects a negative region', async ({ page }) => {
+        await page.setViewportSize({ width: 1000, height: 800 });
+        await expect(resolveCrop({ x: -1, y: 0, width: 500, height: 500 }, page)).rejects.toThrow(/crop/);
+    });
+});
+test.describe('context option forwarding', () => {
+    test('forwards colorScheme: dark to the created context', async ({ browser, }) => {
+        const context = await browser.newContext(buildScreenCIContextOptions({
+            dimensions: { width: 800, height: 600 },
+            forwarded: { colorScheme: 'dark' },
+            applyLocaleDefault: false,
+        }));
+        const page = await context.newPage();
+        const prefersDark = await page.evaluate(() => window.matchMedia('(prefers-color-scheme: dark)').matches);
+        expect(prefersDark).toBe(true);
+        await context.close();
+    });
+    test('captures at the requested deviceScaleFactor', async ({ browser }) => {
+        const context = await browser.newContext(buildScreenCIContextOptions({
+            dimensions: { width: 400, height: 300 },
+            forwarded: {},
+            applyLocaleDefault: false,
+            deviceScaleFactor: 2,
+        }));
+        const page = await context.newPage();
+        const dpr = await page.evaluate(() => window.devicePixelRatio);
+        expect(dpr).toBe(2);
+        await context.close();
+    });
+});
+//# sourceMappingURL=screenshot.e2e.js.map

package/dist/e2e/screenshot.e2e.js.map

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

package/dist/index.d.ts

@@ -1,12 +1,14 @@
-export type { AspectRatio, FPS, Quality, RecordUploadPolicy, RecordOptions, RenderOptions, ScreenCIConfig, ExtendedScreenCIConfig, AutoZoomOptions, Easing, VideoEncoderPreset, } from './src/types.js';
+export type { AspectRatio, FPS, Quality, RecordUploadPolicy, RecordOptions, RenderOptions, ScreenshotOutputFormat, ScreenshotRenderOptions, ScreenCIConfig, ExtendedScreenCIConfig, AutoZoomOptions, Easing, VideoEncoderPreset, } from './src/types.js';
 export { voices, modelTypes } from './src/voices.js';
 export type { VoiceKey, ModelVoiceKey, ElevenLabsVoiceKey, CustomVoiceRef, ModelType, } from './src/voices.js';
 export { defineConfig } from './src/config.js';
 export { video } from './src/video.js';
+export { screenshot } from './src/screenshot.js';
+export type { CropTarget, CropRegion, CropOptions, ScreenshotCrop, ScreenshotCropRecord, ResolvedCropPadding, } from './src/crop.js';
 export type { ScreenCIPage, ScreenCILocator } from './src/types.js';
 export { createNarration, createStudioNarration } from './src/cue.js';
 export type { NarrationCue, Cues, TopLevelVoiceConfig } from './src/cue.js';
-export { STUDIO_RENDER_OPTIONS, isStudioRenderOptions } from './src/studio.js';
+export { isStudioRenderOptions } from './src/studio.js';
 export type { StudioRenderOptionsSentinel } from './src/studio.js';
 export { hide } from './src/hide.js';
 export { speed } from './src/speed.js';
@@ -14,7 +16,9 @@ export { time } from './src/time.js';
 export { autoZoom } from './src/autoZoom.js';
 export { zoomTo, resetZoom } from './src/manualZoom.js';
 export { createOverlays, createStudioOverlays, setOverlayCss, MAX_AUDIO_LEVEL, } from './src/asset.js';
-export type { OverlayController, OverlayConfig, OverlayInput, Overlays, ReactElementLike, OverlayPlacement, } from './src/asset.js';
+export type { OverlayController, OverlayConfig, OverlayConfigFactory, OverlayInput, OverlayInputOrFactory, Overlays, OverlayControllerFor, ReactElementLike, OverlayPlacement, } from './src/asset.js';
+export { overlayRect } from './src/overlayRect.js';
+export type { OverlayRect, OverlayRectOptions } from './src/overlayRect.js';
 export { createAudio, createStudioAudio } from './src/audio.js';
 export type { AudioController, AudioConfig, AudioInput, AudioTracks, } from './src/audio.js';
 export type { ZoomTarget, ZoomTargetPoint } from './src/manualZoom.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,GAAG,EACH,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,MAAM,EACN,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC9E,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC/D,YAAY,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,GAAG,EACH,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,MAAM,EACN,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC/D,YAAY,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -4,13 +4,15 @@ export { voices, modelTypes } from './src/voices.js';
 export { defineConfig } from './src/config.js';
 // Re-export video fixture and narration cue
 export { video } from './src/video.js';
+export { screenshot } from './src/screenshot.js';
 export { createNarration, createStudioNarration } from './src/cue.js';
-export { STUDIO_RENDER_OPTIONS, isStudioRenderOptions } from './src/studio.js';
+export { isStudioRenderOptions } from './src/studio.js';
 export { hide } from './src/hide.js';
 export { speed } from './src/speed.js';
 export { time } from './src/time.js';
 export { autoZoom } from './src/autoZoom.js';
 export { zoomTo, resetZoom } from './src/manualZoom.js';
 export { createOverlays, createStudioOverlays, setOverlayCss, MAX_AUDIO_LEVEL, } from './src/asset.js';
+export { overlayRect } from './src/overlayRect.js';
 export { createAudio, createStudioAudio } from './src/audio.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAeA,mBAAmB;AACnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AASpD,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,4CAA4C;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEtC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AASvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAiBA,mBAAmB;AACnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AASpD,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,4CAA4C;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAUhD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAYvB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}