screenci 0.0.69 → 0.0.71

package/dist/docs/manifest.d.ts

@@ -21,26 +21,26 @@ export declare const docsManifest: readonly [{
     readonly title: "Agent Integration";
     readonly description: "The recommended path: point a coding agent at the integration brief so it scaffolds ScreenCI, authors a video for your flow, and records it.";
     readonly prev: "docs";
-    readonly next: "docs/installation";
+    readonly next: "docs/manual-setup";
 }, {
-    readonly source: "installation.mdx";
-    readonly slug: "docs/installation";
+    readonly source: "manual-setup.mdx";
+    readonly slug: "docs/manual-setup";
     readonly section: "Getting Started";
     readonly order: 3;
     readonly navLabel: "Manual setup & first video";
     readonly title: "Manual Setup & First Video";
     readonly description: "Wire ScreenCI up by hand: initialize a project, run the starter video locally, and record your first final video.";
     readonly prev: "docs/agent-integration";
-    readonly next: "docs/write-video-scripts";
+    readonly next: "docs/video-script-basics";
 }, {
-    readonly source: "write-video-scripts.md";
-    readonly slug: "docs/write-video-scripts";
+    readonly source: "video-script-basics.md";
+    readonly slug: "docs/video-script-basics";
     readonly section: "Getting Started";
     readonly order: 4;
     readonly navLabel: "Video script basics";
     readonly title: "Video Script Basics";
-    readonly description: "Author .video.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.";
-    readonly prev: "docs/installation";
+    readonly description: "Author .screenci.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.";
+    readonly prev: "docs/manual-setup";
     readonly next: "docs/ci-setup";
 }, {
     readonly source: "ci-setup.md";
@@ -50,7 +50,7 @@ export declare const docsManifest: readonly [{
     readonly navLabel: "CI setup";
     readonly title: "CI Setup";
     readonly description: "Understand the generated GitHub Actions workflow, required secrets, and how to keep CI recordings deterministic.";
-    readonly prev: "docs/write-video-scripts";
+    readonly prev: "docs/video-script-basics";
     readonly next: "docs/guides/page-instrumentation";
 }, {
     readonly source: "page-instrumentation.md";
@@ -81,32 +81,42 @@ export declare const docsManifest: readonly [{
     readonly title: "Camera and Zooming";
     readonly description: "Choose between autoZoom and manual framing, and use camera direction to guide attention without making the video frantic.";
     readonly prev: "docs/guides/narration-and-localization";
-    readonly next: "docs/guides/assets-and-overlays";
+    readonly next: "docs/guides/overlays";
 }, {
-    readonly source: "assets-and-overlays.md";
-    readonly slug: "docs/guides/assets-and-overlays";
+    readonly source: "overlays.md";
+    readonly slug: "docs/guides/overlays";
     readonly section: "Guides";
     readonly order: 4;
     readonly navLabel: "Overlays";
     readonly title: "Overlays";
     readonly description: "Add intro clips, corner logos, transitions, and timed overlays to ScreenCI recordings from files, HTML, or React.";
     readonly prev: "docs/guides/camera-and-zooming";
+    readonly next: "docs/guides/screenshots";
+}, {
+    readonly source: "screenshots.md";
+    readonly slug: "docs/guides/screenshots";
+    readonly section: "Guides";
+    readonly order: 5;
+    readonly navLabel: "Screenshots";
+    readonly title: "Screenshots";
+    readonly description: "Capture branded still screenshots with the screenshot() fixture: crop to a component, set quality and dark mode, and frame the shot on a background with overlays.";
+    readonly prev: "docs/guides/overlays";
     readonly next: "docs/guides/studio";
 }, {
     readonly source: "studio.md";
     readonly slug: "docs/guides/studio";
     readonly section: "Guides";
-    readonly order: 5;
+    readonly order: 6;
     readonly navLabel: "Studio";
     readonly title: "Studio";
     readonly description: "Remix render options, narration text, voices, and overlays from the web app, or manage them entirely in Studio with createStudioNarration and createStudioOverlays. Business tier.";
-    readonly prev: "docs/guides/assets-and-overlays";
+    readonly prev: "docs/guides/screenshots";
     readonly next: "docs/guides/public-urls-and-embeds";
 }, {
     readonly source: "public-urls-and-embeds.md";
     readonly slug: "docs/guides/public-urls-and-embeds";
     readonly section: "Guides";
-    readonly order: 6;
+    readonly order: 7;
     readonly navLabel: "Public URLs and embeds";
     readonly title: "Public URLs and Embeds";
     readonly description: "Enable public delivery for a video, understand stable language-specific URLs, and embed ScreenCI outputs in other sites.";
@@ -116,7 +126,7 @@ export declare const docsManifest: readonly [{
     readonly source: "update-screenci.mdx";
     readonly slug: "docs/guides/update-screenci";
     readonly section: "Guides";
-    readonly order: 7;
+    readonly order: 8;
     readonly navLabel: "Update ScreenCI";
     readonly title: "Update ScreenCI";
     readonly description: "Upgrade the screenci package, refresh Playwright when needed, and verify that existing videos still behave as expected.";
@@ -173,26 +183,26 @@ export declare function getDocBySlug(slug: string): {
     readonly title: "Agent Integration";
     readonly description: "The recommended path: point a coding agent at the integration brief so it scaffolds ScreenCI, authors a video for your flow, and records it.";
     readonly prev: "docs";
-    readonly next: "docs/installation";
+    readonly next: "docs/manual-setup";
 } | {
-    readonly source: "installation.mdx";
-    readonly slug: "docs/installation";
+    readonly source: "manual-setup.mdx";
+    readonly slug: "docs/manual-setup";
     readonly section: "Getting Started";
     readonly order: 3;
     readonly navLabel: "Manual setup & first video";
     readonly title: "Manual Setup & First Video";
     readonly description: "Wire ScreenCI up by hand: initialize a project, run the starter video locally, and record your first final video.";
     readonly prev: "docs/agent-integration";
-    readonly next: "docs/write-video-scripts";
+    readonly next: "docs/video-script-basics";
 } | {
-    readonly source: "write-video-scripts.md";
-    readonly slug: "docs/write-video-scripts";
+    readonly source: "video-script-basics.md";
+    readonly slug: "docs/video-script-basics";
     readonly section: "Getting Started";
     readonly order: 4;
     readonly navLabel: "Video script basics";
     readonly title: "Video Script Basics";
-    readonly description: "Author .video.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.";
-    readonly prev: "docs/installation";
+    readonly description: "Author .screenci.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.";
+    readonly prev: "docs/manual-setup";
     readonly next: "docs/ci-setup";
 } | {
     readonly source: "ci-setup.md";
@@ -202,7 +212,7 @@ export declare function getDocBySlug(slug: string): {
     readonly navLabel: "CI setup";
     readonly title: "CI Setup";
     readonly description: "Understand the generated GitHub Actions workflow, required secrets, and how to keep CI recordings deterministic.";
-    readonly prev: "docs/write-video-scripts";
+    readonly prev: "docs/video-script-basics";
     readonly next: "docs/guides/page-instrumentation";
 } | {
     readonly source: "page-instrumentation.md";
@@ -233,32 +243,42 @@ export declare function getDocBySlug(slug: string): {
     readonly title: "Camera and Zooming";
     readonly description: "Choose between autoZoom and manual framing, and use camera direction to guide attention without making the video frantic.";
     readonly prev: "docs/guides/narration-and-localization";
-    readonly next: "docs/guides/assets-and-overlays";
+    readonly next: "docs/guides/overlays";
 } | {
-    readonly source: "assets-and-overlays.md";
-    readonly slug: "docs/guides/assets-and-overlays";
+    readonly source: "overlays.md";
+    readonly slug: "docs/guides/overlays";
     readonly section: "Guides";
     readonly order: 4;
     readonly navLabel: "Overlays";
     readonly title: "Overlays";
     readonly description: "Add intro clips, corner logos, transitions, and timed overlays to ScreenCI recordings from files, HTML, or React.";
     readonly prev: "docs/guides/camera-and-zooming";
+    readonly next: "docs/guides/screenshots";
+} | {
+    readonly source: "screenshots.md";
+    readonly slug: "docs/guides/screenshots";
+    readonly section: "Guides";
+    readonly order: 5;
+    readonly navLabel: "Screenshots";
+    readonly title: "Screenshots";
+    readonly description: "Capture branded still screenshots with the screenshot() fixture: crop to a component, set quality and dark mode, and frame the shot on a background with overlays.";
+    readonly prev: "docs/guides/overlays";
     readonly next: "docs/guides/studio";
 } | {
     readonly source: "studio.md";
     readonly slug: "docs/guides/studio";
     readonly section: "Guides";
-    readonly order: 5;
+    readonly order: 6;
     readonly navLabel: "Studio";
     readonly title: "Studio";
     readonly description: "Remix render options, narration text, voices, and overlays from the web app, or manage them entirely in Studio with createStudioNarration and createStudioOverlays. Business tier.";
-    readonly prev: "docs/guides/assets-and-overlays";
+    readonly prev: "docs/guides/screenshots";
     readonly next: "docs/guides/public-urls-and-embeds";
 } | {
     readonly source: "public-urls-and-embeds.md";
     readonly slug: "docs/guides/public-urls-and-embeds";
     readonly section: "Guides";
-    readonly order: 6;
+    readonly order: 7;
     readonly navLabel: "Public URLs and embeds";
     readonly title: "Public URLs and Embeds";
     readonly description: "Enable public delivery for a video, understand stable language-specific URLs, and embed ScreenCI outputs in other sites.";
@@ -268,7 +288,7 @@ export declare function getDocBySlug(slug: string): {
     readonly source: "update-screenci.mdx";
     readonly slug: "docs/guides/update-screenci";
     readonly section: "Guides";
-    readonly order: 7;
+    readonly order: 8;
     readonly navLabel: "Update ScreenCI";
     readonly title: "Update ScreenCI";
     readonly description: "Upgrade the screenci package, refresh Playwright when needed, and verify that existing videos still behave as expected.";
@@ -327,28 +347,28 @@ export declare function getGeneratedDocsManifest(): ({
     title: "Agent Integration";
     description: "The recommended path: point a coding agent at the integration brief so it scaffolds ScreenCI, authors a video for your flow, and records it.";
     prev: "docs";
-    next: "docs/installation";
+    next: "docs/manual-setup";
 } | {
     outputPath: string;
-    source: "installation.mdx";
-    slug: "docs/installation";
+    source: "manual-setup.mdx";
+    slug: "docs/manual-setup";
     section: "Getting Started";
     order: 3;
     navLabel: "Manual setup & first video";
     title: "Manual Setup & First Video";
     description: "Wire ScreenCI up by hand: initialize a project, run the starter video locally, and record your first final video.";
     prev: "docs/agent-integration";
-    next: "docs/write-video-scripts";
+    next: "docs/video-script-basics";
 } | {
     outputPath: string;
-    source: "write-video-scripts.md";
-    slug: "docs/write-video-scripts";
+    source: "video-script-basics.md";
+    slug: "docs/video-script-basics";
     section: "Getting Started";
     order: 4;
     navLabel: "Video script basics";
     title: "Video Script Basics";
-    description: "Author .video.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.";
-    prev: "docs/installation";
+    description: "Author .screenci.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.";
+    prev: "docs/manual-setup";
     next: "docs/ci-setup";
 } | {
     outputPath: string;
@@ -359,7 +379,7 @@ export declare function getGeneratedDocsManifest(): ({
     navLabel: "CI setup";
     title: "CI Setup";
     description: "Understand the generated GitHub Actions workflow, required secrets, and how to keep CI recordings deterministic.";
-    prev: "docs/write-video-scripts";
+    prev: "docs/video-script-basics";
     next: "docs/guides/page-instrumentation";
 } | {
     outputPath: string;
@@ -393,35 +413,46 @@ export declare function getGeneratedDocsManifest(): ({
     title: "Camera and Zooming";
     description: "Choose between autoZoom and manual framing, and use camera direction to guide attention without making the video frantic.";
     prev: "docs/guides/narration-and-localization";
-    next: "docs/guides/assets-and-overlays";
+    next: "docs/guides/overlays";
 } | {
     outputPath: string;
-    source: "assets-and-overlays.md";
-    slug: "docs/guides/assets-and-overlays";
+    source: "overlays.md";
+    slug: "docs/guides/overlays";
     section: "Guides";
     order: 4;
     navLabel: "Overlays";
     title: "Overlays";
     description: "Add intro clips, corner logos, transitions, and timed overlays to ScreenCI recordings from files, HTML, or React.";
     prev: "docs/guides/camera-and-zooming";
+    next: "docs/guides/screenshots";
+} | {
+    outputPath: string;
+    source: "screenshots.md";
+    slug: "docs/guides/screenshots";
+    section: "Guides";
+    order: 5;
+    navLabel: "Screenshots";
+    title: "Screenshots";
+    description: "Capture branded still screenshots with the screenshot() fixture: crop to a component, set quality and dark mode, and frame the shot on a background with overlays.";
+    prev: "docs/guides/overlays";
     next: "docs/guides/studio";
 } | {
     outputPath: string;
     source: "studio.md";
     slug: "docs/guides/studio";
     section: "Guides";
-    order: 5;
+    order: 6;
     navLabel: "Studio";
     title: "Studio";
     description: "Remix render options, narration text, voices, and overlays from the web app, or manage them entirely in Studio with createStudioNarration and createStudioOverlays. Business tier.";
-    prev: "docs/guides/assets-and-overlays";
+    prev: "docs/guides/screenshots";
     next: "docs/guides/public-urls-and-embeds";
 } | {
     outputPath: string;
     source: "public-urls-and-embeds.md";
     slug: "docs/guides/public-urls-and-embeds";
     section: "Guides";
-    order: 6;
+    order: 7;
     navLabel: "Public URLs and embeds";
     title: "Public URLs and Embeds";
     description: "Enable public delivery for a video, understand stable language-specific URLs, and embed ScreenCI outputs in other sites.";
@@ -432,7 +463,7 @@ export declare function getGeneratedDocsManifest(): ({
     source: "update-screenci.mdx";
     slug: "docs/guides/update-screenci";
     section: "Guides";
-    order: 7;
+    order: 8;
     navLabel: "Update ScreenCI";
     title: "Update ScreenCI";
     description: "Upgrade the screenci package, refresh Playwright when needed, and verify that existing videos still behave as expected.";
@@ -484,8 +515,8 @@ export declare function getDocsSidebarConfig(typedocSidebarGroup?: TypedocSideba
     translations: {};
     collapsed: boolean;
     items: ({
-        label: "Overview" | "Agent integration" | "Manual setup & first video" | "Video script basics" | "CI setup" | "Page instrumentation" | "Narration and localization" | "Camera and zooming" | "Overlays" | "Studio" | "Public URLs and embeds" | "Update ScreenCI" | "CLI" | "Configuration" | "Public delivery API";
-        slug: "docs" | "docs/agent-integration" | "docs/installation" | "docs/write-video-scripts" | "docs/ci-setup" | "docs/guides/page-instrumentation" | "docs/guides/narration-and-localization" | "docs/guides/camera-and-zooming" | "docs/guides/assets-and-overlays" | "docs/guides/studio" | "docs/guides/public-urls-and-embeds" | "docs/guides/update-screenci" | "docs/reference/cli" | "docs/reference/configuration" | "docs/reference/public-delivery-api";
+        label: "Overview" | "Agent integration" | "Manual setup & first video" | "Video script basics" | "CI setup" | "Page instrumentation" | "Narration and localization" | "Camera and zooming" | "Overlays" | "Screenshots" | "Studio" | "Public URLs and embeds" | "Update ScreenCI" | "CLI" | "Configuration" | "Public delivery API";
+        slug: "docs/manual-setup" | "docs/guides/overlays" | "docs/guides/screenshots" | "docs" | "docs/agent-integration" | "docs/video-script-basics" | "docs/ci-setup" | "docs/guides/page-instrumentation" | "docs/guides/narration-and-localization" | "docs/guides/camera-and-zooming" | "docs/guides/studio" | "docs/guides/public-urls-and-embeds" | "docs/guides/update-screenci" | "docs/reference/cli" | "docs/reference/configuration" | "docs/reference/public-delivery-api";
         translations: {};
         attrs: {};
     } | TypedocSidebarItem)[];

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../docs/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqLf,CAAA;AAEV,eAAO,MAAM,YAAY,qDAAsD,CAAA;AAE/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAExC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,UAMjD;AAED,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKvC;AAYD,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,wBAAgB,oBAAoB,CAClC,mBAAmB,CAAC,EAAE,kBAAkB,GAAG,IAAI;;;;;;;;;;IAmBhD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;;;EAkBxD"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../docs/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiMf,CAAA;AAEV,eAAO,MAAM,YAAY,qDAAsD,CAAA;AAE/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAExC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,UAejD;AAED,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKvC;AAYD,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,wBAAgB,oBAAoB,CAClC,mBAAmB,CAAC,EAAE,kBAAkB,GAAG,IAAI;;;;;;;;;;IAmBhD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;;;EAkBxD"}

package/dist/docs/manifest.js

@@ -2,6 +2,7 @@
  * Source of truth for ScreenCI docs information architecture.
  * Slugs are web-facing and stable even if source filenames change.
  */
+import { getDocVideo, hasPublicId } from './videos';
 export const docsManifest = [
     {
         source: 'overview.mdx',
@@ -23,28 +24,28 @@ export const docsManifest = [
         title: 'Agent Integration',
         description: 'The recommended path: point a coding agent at the integration brief so it scaffolds ScreenCI, authors a video for your flow, and records it.',
         prev: 'docs',
-        next: 'docs/installation',
+        next: 'docs/manual-setup',
     },
     {
-        source: 'installation.mdx',
-        slug: 'docs/installation',
+        source: 'manual-setup.mdx',
+        slug: 'docs/manual-setup',
         section: 'Getting Started',
         order: 3,
         navLabel: 'Manual setup & first video',
         title: 'Manual Setup & First Video',
         description: 'Wire ScreenCI up by hand: initialize a project, run the starter video locally, and record your first final video.',
         prev: 'docs/agent-integration',
-        next: 'docs/write-video-scripts',
+        next: 'docs/video-script-basics',
     },
     {
-        source: 'write-video-scripts.md',
-        slug: 'docs/write-video-scripts',
+        source: 'video-script-basics.md',
+        slug: 'docs/video-script-basics',
         section: 'Getting Started',
         order: 4,
         navLabel: 'Video script basics',
         title: 'Video Script Basics',
-        description: 'Author .video.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.',
-        prev: 'docs/installation',
+        description: 'Author .screenci.ts files with Playwright-like APIs, ScreenCI narration and camera helpers, and workflow-aware pacing.',
+        prev: 'docs/manual-setup',
         next: 'docs/ci-setup',
     },
     {
@@ -55,7 +56,7 @@ export const docsManifest = [
         navLabel: 'CI setup',
         title: 'CI Setup',
         description: 'Understand the generated GitHub Actions workflow, required secrets, and how to keep CI recordings deterministic.',
-        prev: 'docs/write-video-scripts',
+        prev: 'docs/video-script-basics',
         next: 'docs/guides/page-instrumentation',
     },
     {
@@ -89,35 +90,46 @@ export const docsManifest = [
         title: 'Camera and Zooming',
         description: 'Choose between autoZoom and manual framing, and use camera direction to guide attention without making the video frantic.',
         prev: 'docs/guides/narration-and-localization',
-        next: 'docs/guides/assets-and-overlays',
+        next: 'docs/guides/overlays',
     },
     {
-        source: 'assets-and-overlays.md',
-        slug: 'docs/guides/assets-and-overlays',
+        source: 'overlays.md',
+        slug: 'docs/guides/overlays',
         section: 'Guides',
         order: 4,
         navLabel: 'Overlays',
         title: 'Overlays',
         description: 'Add intro clips, corner logos, transitions, and timed overlays to ScreenCI recordings from files, HTML, or React.',
         prev: 'docs/guides/camera-and-zooming',
+        next: 'docs/guides/screenshots',
+    },
+    {
+        source: 'screenshots.md',
+        slug: 'docs/guides/screenshots',
+        section: 'Guides',
+        order: 5,
+        navLabel: 'Screenshots',
+        title: 'Screenshots',
+        description: 'Capture branded still screenshots with the screenshot() fixture: crop to a component, set quality and dark mode, and frame the shot on a background with overlays.',
+        prev: 'docs/guides/overlays',
         next: 'docs/guides/studio',
     },
     {
         source: 'studio.md',
         slug: 'docs/guides/studio',
         section: 'Guides',
-        order: 5,
+        order: 6,
         navLabel: 'Studio',
         title: 'Studio',
         description: 'Remix render options, narration text, voices, and overlays from the web app, or manage them entirely in Studio with createStudioNarration and createStudioOverlays. Business tier.',
-        prev: 'docs/guides/assets-and-overlays',
+        prev: 'docs/guides/screenshots',
         next: 'docs/guides/public-urls-and-embeds',
     },
     {
         source: 'public-urls-and-embeds.md',
         slug: 'docs/guides/public-urls-and-embeds',
         section: 'Guides',
-        order: 6,
+        order: 7,
         navLabel: 'Public URLs and embeds',
         title: 'Public URLs and Embeds',
         description: 'Enable public delivery for a video, understand stable language-specific URLs, and embed ScreenCI outputs in other sites.',
@@ -128,7 +140,7 @@ export const docsManifest = [
         source: 'update-screenci.mdx',
         slug: 'docs/guides/update-screenci',
         section: 'Guides',
-        order: 7,
+        order: 8,
         navLabel: 'Update ScreenCI',
         title: 'Update ScreenCI',
         description: 'Upgrade the screenci package, refresh Playwright when needed, and verify that existing videos still behave as expected.',
@@ -175,7 +187,14 @@ export function getDocBySlug(slug) {
 }
 export function getOutputPathFromSlug(slug) {
     const entry = getDocBySlug(slug);
-    const extension = entry?.source.endsWith('.mdx') ? '.mdx' : '.md';
+    const video = getDocVideo(slug);
+    // A page that embeds a published video or screenshot injects a React
+    // component (DocVideoPlayer / DocScreenshot). Astro only renders component
+    // imports and JSX in .mdx, so such a page must be emitted as .mdx even when
+    // its source is plain .md. Without this, the embed silently renders as inert
+    // text. Pages without a published embed stay .md (matching their source).
+    const embedsComponent = video !== null && hasPublicId(video);
+    const extension = entry?.source.endsWith('.mdx') || embedsComponent ? '.mdx' : '.md';
     if (slug === 'docs')
         return `index${extension}`;
     return `${slug.replace(/^docs\//, '')}${extension}`;

package/dist/docs/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../docs/manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../docs/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEnD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,uJAAuJ;QACzJ,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,wBAAwB;KAC/B;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,mBAAmB;QAC7B,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,8IAA8I;QAChJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,mBAAmB;KAC1B;IACD;QACE,MAAM,EAAE,kBAAkB;QAC1B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,4BAA4B;QACtC,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,mHAAmH;QACrH,IAAI,EAAE,wBAAwB;QAC9B,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,qBAAqB;QAC/B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,wHAAwH;QAC1H,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,eAAe;KACtB;IACD;QACE,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,kHAAkH;QACpH,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,kCAAkC;KACzC;IACD;QACE,MAAM,EAAE,yBAAyB;QACjC,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,sBAAsB;QAChC,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,6IAA6I;QAC/I,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,wCAAwC;KAC/C;IACD;QACE,MAAM,EAAE,+BAA+B;QACvC,IAAI,EAAE,wCAAwC;QAC9C,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,4BAA4B;QACtC,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,0HAA0H;QAC5H,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,gCAAgC;KACvC;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,IAAI,EAAE,gCAAgC;QACtC,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,oBAAoB;QAC9B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,2HAA2H;QAC7H,IAAI,EAAE,wCAAwC;QAC9C,IAAI,EAAE,sBAAsB;KAC7B;IACD;QACE,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,mHAAmH;QACrH,IAAI,EAAE,gCAAgC;QACtC,IAAI,EAAE,yBAAyB;KAChC;IACD;QACE,MAAM,EAAE,gBAAgB;QACxB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,aAAa;QACvB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,oKAAoK;QACtK,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,oBAAoB;KAC3B;IACD;QACE,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,oLAAoL;QACtL,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,oCAAoC;KAC3C;IACD;QACE,MAAM,EAAE,2BAA2B;QACnC,IAAI,EAAE,oCAAoC;QAC1C,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,wBAAwB;QAClC,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,0HAA0H;QAC5H,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,6BAA6B;KACpC;IACD;QACE,MAAM,EAAE,qBAAqB;QAC7B,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,yHAAyH;QAC3H,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,oBAAoB;KAC3B;IACD;QACE,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,gGAAgG;QAClG,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE,8BAA8B;KACrC;IACD;QACE,MAAM,EAAE,kBAAkB;QAC1B,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,eAAe;QACzB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,oIAAoI;QACtI,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,oCAAoC;KAC3C;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,oCAAoC;QAC1C,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,qBAAqB;QAC/B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,yHAAyH;QAC3H,IAAI,EAAE,8BAA8B;QACpC,IAAI,EAAE,oBAAoB;KAC3B;CACO,CAAA;AAEV,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,iBAAiB,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAA;AAE/E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAE/B,qEAAqE;IACrE,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,eAAe,GAAG,KAAK,KAAK,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;IAC5D,MAAM,SAAS,GACb,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IAEpE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,QAAQ,SAAS,EAAE,CAAA;IAC/C,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,EAAE,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClC,GAAG,KAAK;QACR,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC;KAC9C,CAAC,CAAC,CAAA;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAoC;IACzD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,QAAQ;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,EAAE;KACV,CAAA;AACH,CAAC;AAWD,MAAM,UAAU,oBAAoB,CAClC,mBAA+C;IAE/C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,KAAK,GAAgD,YAAY;aACpE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC;aAC5C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,aAAa,CAAC,CAAA;QAErB,IAAI,OAAO,KAAK,WAAW,IAAI,mBAAmB,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QACjC,CAAC;QAED,OAAO;YACL,KAAK,EAAE,OAAO;YACd,YAAY,EAAE,EAAE;YAChB,SAAS,EAAE,KAAK;YAChB,KAAK;SACN,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAmB;IACvD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvB,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAClC,OAAO;YACL,KAAK,EAAE,oBAAoB;YAC3B,IAAI,EAAE,qBAAqB;SAC5B,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE;KACvB,CAAA;AACH,CAAC"}

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

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

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

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

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

@@ -23,4 +23,4 @@ video('How to find docs', async ({ page }) => {
         await page.getByRole('link', { name: 'View Documentation' }).click();
     });
 });
-//# sourceMappingURL=installation.video.js.map
+//# sourceMappingURL=installation.screenci.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installation.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/installation.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEzE,MAAM,SAAS,GAAG,eAAe,CAAC;IAChC,4CAA4C;IAC5C,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;IAC9B,wCAAwC;IACxC,EAAE,EAAE;QACF,IAAI,EAAE,kEAAkE;KACzE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,mFAAmF;KAC1F;CACF,CAAC,CAAA;AAEF,KAAK,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC3C,kEAAkE;IAClE,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QACxC,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,kDAAkD;IAClD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IAEtB,qEAAqE;IACrE,MAAM,QAAQ,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IACtE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

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

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

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

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

@@ -31,4 +31,4 @@ video('Landing light', async ({ page }) => {
         await page.getByRole('link', { name: 'View Documentation' }).click();
     });
 });
-//# sourceMappingURL=landing.video.js.map
+//# sourceMappingURL=landing.screenci.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"landing.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/landing.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEzE,MAAM,SAAS,GAAG,eAAe,CAAC;IAChC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE;IAC/D,EAAE,EAAE;QACF,IAAI,EAAE,kEAAkE;KACzE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,mFAAmF;KAC1F;CACF,CAAC,CAAA;AAEF,KAAK,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACxC,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QACxC,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;QAE1C,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACvB,QAAQ,CAAC,MAAM,GAAG,+BAA+B,CAAA;YACjD,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;YAChD,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACjD,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3D,IAAI,CAAC,CAAC,OAAO,YAAY,gBAAgB,CAAC,EAAE,CAAC;gBAC3C,OAAM;YACR,CAAC;YAED,OAAO,CAAC,KAAK,EAAE,CAAA;YACf,OAAO,CAAC,WAAW,GAAG,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IAEtB,MAAM,QAAQ,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IACtE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/docs/video-sources/locator-highlight-animated.screenci.d.ts

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

package/dist/docs/video-sources/locator-highlight-animated.screenci.d.ts.map

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

package/dist/docs/video-sources/locator-highlight-animated.screenci.js

@@ -0,0 +1,41 @@
+import { createOverlays, video } from 'screenci';
+// Animates the same ring as the Screenshots still: it pulses while the page is
+// driven underneath, then closes before the recording stops. An opacity-only
+// pulse keeps the ring landed exactly on the element (no scale, so no capture
+// padding is needed).
+const overlays = createOverlays({
+    ring: (target) => ({
+        html: '<div class="ring"></div>',
+        css: `
+      .ring {
+        width: 100%;
+        height: 100%;
+        box-sizing: border-box;
+        border: 4px solid #ec4899;
+        border-radius: 14px;
+        animation: ring-pulse 2s ease-in-out infinite;
+      }
+      @keyframes ring-pulse {
+        0%, 100% { opacity: 1; }
+        50% { opacity: 0.3; }
+      }
+    `,
+        over: target,
+        margin: 6,
+        animate: true,
+        durationMs: 2400,
+    }),
+});
+video('Locator highlight (animated)', async ({ page }) => {
+    await page.goto('https://screenci.com/');
+    await page.waitForLoadState('networkidle');
+    const cta = page.getByRole('link', { name: 'View Documentation' });
+    await cta.scrollIntoViewIfNeeded();
+    // The ring pulses while the page stays live. Every start() must be ended
+    // before the video function returns.
+    const ring = overlays.ring(cta);
+    await ring.start();
+    await cta.hover();
+    await ring.end();
+});
+//# sourceMappingURL=locator-highlight-animated.screenci.js.map

package/dist/docs/video-sources/locator-highlight-animated.screenci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-highlight-animated.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/locator-highlight-animated.screenci.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAEhD,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,sBAAsB;AACtB,MAAM,QAAQ,GAAG,cAAc,CAAC;IAC9B,IAAI,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,0BAA0B;QAChC,GAAG,EAAE;;;;;;;;;;;;;KAaJ;QACD,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;KACjB,CAAC;CACH,CAAC,CAAA;AAEF,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACvD,MAAM,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACxC,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;IAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;IAClE,MAAM,GAAG,CAAC,sBAAsB,EAAE,CAAA;IAElC,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;IAClB,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;IACjB,MAAM,IAAI,CAAC,GAAG,EAAE,CAAA;AAClB,CAAC,CAAC,CAAA"}

package/dist/docs/video-sources/locator-highlight-still.screenci.d.ts

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

package/dist/docs/video-sources/locator-highlight-still.screenci.d.ts.map

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

package/dist/docs/video-sources/locator-highlight-still.screenci.js

@@ -0,0 +1,19 @@
+import { createOverlays, screenshot } from 'screenci';
+// Rings a single element on the marketing site, then captures a branded still.
+// The Overlays guide animates the same example.
+const overlays = createOverlays({
+    ring: (target) => ({
+        html: '<div style="width:100%;height:100%;box-sizing:border-box;border:4px solid #ec4899;border-radius:14px"></div>',
+        over: target,
+        margin: 6,
+    }),
+});
+screenshot('Locator highlight', async ({ page }) => {
+    await page.goto('https://screenci.com/');
+    await page.waitForLoadState('networkidle');
+    const cta = page.getByRole('link', { name: 'View Documentation' });
+    await cta.scrollIntoViewIfNeeded();
+    // In a still, start the overlay and leave it open: it stays in the image.
+    await overlays.ring(cta).start();
+});
+//# sourceMappingURL=locator-highlight-still.screenci.js.map

package/dist/docs/video-sources/locator-highlight-still.screenci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-highlight-still.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/locator-highlight-still.screenci.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErD,+EAA+E;AAC/E,gDAAgD;AAChD,MAAM,QAAQ,GAAG,cAAc,CAAC;IAC9B,IAAI,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,8GAA8G;QACpH,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,CAAC;KACV,CAAC;CACH,CAAC,CAAA;AAEF,UAAU,CAAC,mBAAmB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACjD,MAAM,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACxC,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;IAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;IAClE,MAAM,GAAG,CAAC,sBAAsB,EAAE,CAAA;IAElC,0EAA0E;IAC1E,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAA;AAClC,CAAC,CAAC,CAAA"}

package/dist/docs/video-sources/product-pitch.screenci.d.ts

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

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

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