screenci 0.0.76 → 0.0.79

package/dist/docs/manifest.js

@@ -57,71 +57,115 @@ export const docsManifest = [
         title: 'CI Setup',
         description: 'Understand the generated GitHub Actions workflow, required secrets, and how to keep CI recordings deterministic.',
         prev: 'docs/video-script-basics',
-        next: 'docs/guides/page-instrumentation',
+        next: 'docs/guides/animated-interactions',
     },
     {
-        source: 'page-instrumentation.md',
-        slug: 'docs/guides/page-instrumentation',
+        source: 'animated-interactions.md',
+        slug: 'docs/guides/animated-interactions',
         section: 'Guides',
         order: 1,
-        navLabel: 'Page instrumentation',
-        title: 'Page Instrumentation',
+        navLabel: 'Animated interactions',
+        title: 'Animated Interactions',
         description: 'Understand how ScreenCI instruments the Playwright page so visible actions like clicks, typing, mouse movement, and scrolling are animated.',
         prev: 'docs/ci-setup',
-        next: 'docs/guides/narration-and-localization',
+        next: 'docs/guides/narration',
     },
     {
-        source: 'narration-and-localization.md',
-        slug: 'docs/guides/narration-and-localization',
-        section: 'Guides',
+        source: 'narration.md',
+        slug: 'docs/guides/narration',
+        section: 'Fixtures',
+        order: 1,
+        navLabel: 'Narration',
+        title: 'Narration',
+        description: 'Attach spoken cues to a video, overlap narration with visible UI motion, choose voices, use speech markup, and connect ElevenLabs for custom voices.',
+        prev: 'docs/guides/animated-interactions',
+        next: 'docs/guides/values',
+    },
+    {
+        source: 'values.md',
+        slug: 'docs/guides/values',
+        section: 'Fixtures',
         order: 2,
-        navLabel: 'Narration and localization',
-        title: 'Narration and Localization',
-        description: 'Create spoken cues, overlap narration with visible UI motion, and keep multi-language variants consistent and type-safe.',
-        prev: 'docs/guides/page-instrumentation',
-        next: 'docs/guides/camera-and-zooming',
+        navLabel: 'Values',
+        title: 'Values',
+        description: 'Inject per-language page content with video.values() for apps that do not self-localize, and let Studio manage field values without code changes.',
+        prev: 'docs/guides/narration',
+        next: 'docs/guides/audio',
     },
     {
-        source: 'camera-and-zooming.md',
-        slug: 'docs/guides/camera-and-zooming',
-        section: 'Guides',
+        source: 'audio.md',
+        slug: 'docs/guides/audio',
+        section: 'Fixtures',
         order: 3,
-        navLabel: 'Camera and zooming',
-        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',
+        navLabel: 'Audio',
+        title: 'Audio',
+        description: 'Add background music or sound effects to a video with video.audio(), control volume and looping, and let Studio manage track files.',
+        prev: 'docs/guides/values',
         next: 'docs/guides/overlays',
     },
     {
         source: 'overlays.md',
         slug: 'docs/guides/overlays',
-        section: 'Guides',
+        section: 'Fixtures',
         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',
+        prev: 'docs/guides/audio',
+        next: 'docs/guides/dependencies',
+    },
+    {
+        source: 'dependencies.md',
+        slug: 'docs/guides/dependencies',
+        section: 'Fixtures',
+        order: 5,
+        navLabel: 'Render dependencies',
+        title: 'Render Dependencies',
+        description: 'Embed one render inside another with selected(name): reuse intro clips and logo stills across videos and screenshots, and have dependents re-render automatically when the target selection changes.',
+        prev: 'docs/guides/overlays',
+        next: 'docs/guides/languages',
+    },
+    {
+        source: 'languages.md',
+        slug: 'docs/guides/languages',
+        section: 'Fixtures',
+        order: 6,
+        navLabel: 'Languages',
+        title: 'Languages',
+        description: 'Record per-language video versions from one script: set browser locale automatically, localize narration, values, overlays, and audio, and control the recording mode.',
+        prev: 'docs/guides/dependencies',
+        next: 'docs/guides/camera-and-zooming',
+    },
+    {
+        source: 'camera-and-zooming.md',
+        slug: 'docs/guides/camera-and-zooming',
+        section: 'Guides',
+        order: 2,
+        navLabel: 'Camera and zooming',
+        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/languages',
         next: 'docs/guides/screenshots',
     },
     {
         source: 'screenshots.md',
         slug: 'docs/guides/screenshots',
         section: 'Guides',
-        order: 5,
+        order: 3,
         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',
+        prev: 'docs/guides/camera-and-zooming',
         next: 'docs/guides/studio',
     },
     {
         source: 'studio.md',
         slug: 'docs/guides/studio',
         section: 'Guides',
-        order: 6,
+        order: 4,
         navLabel: 'Studio',
         title: 'Studio',
-        description: 'Remix render options, narration text, voices, and overlays from the web app, or manage them entirely in Studio with array-form declarations like video.narration([...]). Business tier.',
+        description: 'Remix render options, narration text, voices, overlays, and languages from the web app, or manage them entirely in Studio with studio(...) declarations like video.narration(studio([...])). Business tier.',
         prev: 'docs/guides/screenshots',
         next: 'docs/guides/public-urls-and-embeds',
     },
@@ -129,29 +173,40 @@ export const docsManifest = [
         source: 'public-urls-and-embeds.md',
         slug: 'docs/guides/public-urls-and-embeds',
         section: 'Guides',
-        order: 7,
+        order: 5,
         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.',
         prev: 'docs/guides/studio',
+        next: 'docs/guides/redact',
+    },
+    {
+        source: 'redact.md',
+        slug: 'docs/guides/redact',
+        section: 'Guides',
+        order: 6,
+        navLabel: 'Redact sensitive content',
+        title: 'Redact Sensitive Content',
+        description: 'Keep secrets out of a recording with redact: mask locators, typed values, and always-secret elements in the page before the frame is captured, so they are never uploaded.',
+        prev: 'docs/guides/public-urls-and-embeds',
         next: 'docs/guides/screen-audio',
     },
     {
         source: 'screen-audio.md',
         slug: 'docs/guides/screen-audio',
         section: 'Guides',
-        order: 8,
+        order: 7,
         navLabel: 'Screen audio',
         title: 'Screen Audio',
         description: 'Capture system audio alongside the screen recording and mix it into the rendered video. Linux only, with an automatic, isolated per-worker capture sink.',
-        prev: 'docs/guides/public-urls-and-embeds',
+        prev: 'docs/guides/redact',
         next: 'docs/guides/update-screenci',
     },
     {
         source: 'update-screenci.mdx',
         slug: 'docs/guides/update-screenci',
         section: 'Guides',
-        order: 9,
+        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.',
@@ -192,7 +247,12 @@ export const docsManifest = [
         next: 'docs/reference/api',
     },
 ];
-export const docsSections = ['Getting Started', 'Guides', 'Reference'];
+export const docsSections = [
+    'Getting Started',
+    'Fixtures',
+    'Guides',
+    'Reference',
+];
 export function getDocBySlug(slug) {
     return docsManifest.find((entry) => entry.slug === slug);
 }

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":"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"}

package/dist/docs/video-sources/camera-and-zooming.screenci.d.ts

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

package/dist/docs/video-sources/camera-and-zooming.screenci.d.ts.map

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

package/dist/docs/video-sources/camera-and-zooming.screenci.js

@@ -0,0 +1,57 @@
+import { autoZoom, hide, resetRecordingSize, resetZoom, resizeRecording, video, voices, zoomTo, } from 'screenci';
+video.use({
+    renderOptions: {
+        narration: {
+            voice: { name: voices.Sophie, style: 'Friendly product guide' },
+        },
+        output: {
+            background: {
+                backgroundCss: 'linear-gradient(313deg, #ffffff 0%, #d6d6d6 100%)',
+            },
+        },
+    },
+});
+// Camera walkthrough for the Camera and Zooming guide. It records the public
+// marketing site (screenci.com), so it needs no login. The mirror in
+// screenci/videos strips the screenci.com origin so the gotos route through the
+// configured baseURL.
+video.narration({
+    en: {
+        auto: 'autoZoom [pronounce: auto zoom] follows a cluster of related actions on its own.',
+        manual: 'zoomTo [pronounce: zoom to] frames an exact target before you interact with it.',
+        pan: 'Give it a point instead of an element for a deliberate pan.',
+        step: 'resizeRecording [pronounce: resize recording] steps back to reveal the styled background.',
+        outro: 'Treat the camera as direction, not decoration.',
+    },
+})('Camera and zooming', async ({ page, narration }) => {
+    await hide(async () => {
+        await page.goto('https://screenci.com/');
+        await page.waitForLoadState('networkidle');
+    });
+    // autoZoom follows the interaction automatically as it opens the docs.
+    await narration.auto.start();
+    await autoZoom(async () => {
+        await page.getByRole('link', { name: 'View Documentation' }).click();
+    });
+    await narration.auto.end();
+    await page.waitForLoadState('networkidle');
+    // Manual framing on an exact target before any interaction.
+    await narration.manual.start();
+    await zoomTo(page.getByRole('heading', { level: 1 }).first());
+    await page.waitForTimeout(900);
+    await narration.manual.end();
+    // A deliberate pan to a hand-picked point, then back to the full frame.
+    await narration.pan.start();
+    await zoomTo({ x: 1200, y: 680 });
+    await page.waitForTimeout(900);
+    await resetZoom();
+    await narration.pan.end();
+    // Step the recording back to show the styled background, then restore it.
+    await narration.step.start();
+    await resizeRecording(0.8);
+    await page.waitForTimeout(900);
+    await resetRecordingSize();
+    await narration.step.end();
+    await narration.outro();
+});
+//# sourceMappingURL=camera-and-zooming.screenci.js.map

package/dist/docs/video-sources/camera-and-zooming.screenci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-and-zooming.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/camera-and-zooming.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,KAAK,EACL,MAAM,EACN,MAAM,GACP,MAAM,UAAU,CAAA;AAEjB,KAAK,CAAC,GAAG,CAAC;IACR,aAAa,EAAE;QACb,SAAS,EAAE;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE;SAChE;QACD,MAAM,EAAE;YACN,UAAU,EAAE;gBACV,aAAa,EAAE,mDAAmD;aACnE;SACF;KACF;CACF,CAAC,CAAA;AAEF,6EAA6E;AAC7E,qEAAqE;AACrE,gFAAgF;AAChF,sBAAsB;AACtB,KAAK,CAAC,SAAS,CAAC;IACd,EAAE,EAAE;QACF,IAAI,EAAE,kFAAkF;QACxF,MAAM,EACJ,iFAAiF;QACnF,GAAG,EAAE,6DAA6D;QAClE,IAAI,EAAE,2FAA2F;QACjG,KAAK,EAAE,gDAAgD;KACxD;CACF,CAAC,CAAC,oBAAoB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;IACrD,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,uEAAuE;IACvE,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IAC5B,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;IACF,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;IAC1B,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;IAE1C,4DAA4D;IAC5D,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IAC7D,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;IAE5B,wEAAwE;IACxE,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;IAC3B,MAAM,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IACjC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,SAAS,EAAE,CAAA;IACjB,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;IAEzB,0EAA0E;IAC1E,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IAC5B,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;IAC1B,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,kBAAkB,EAAE,CAAA;IAC1B,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;IAE1B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;AACzB,CAAC,CAAC,CAAA"}

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

@@ -1,20 +1,23 @@
-import { autoZoom, hide, video, voices } from 'screenci';
-// The default voice (how narration is spoken) for every language.
-video.use({ renderOptions: { narration: { voice: { name: voices.Sophie } } } });
-// Localized narration cues by language. The fixture exposes them as markers.
-video.narration({
+import { autoZoom, hide, video } from 'screenci';
+video
+    .overlays({
+    logo: { path: './assets/logo.png', duration: '2s' },
+})
+    .narration({
     en: {
         docs: 'Here is where to find ScreenCI [pronounce: screen see eye] docs.',
     },
     es: {
         docs: 'Aqui es donde encontrar la documentacion de ScreenCI [pronounce: screen see eye].',
     },
-})('How to find docs', async ({ page, narration }) => {
+})('How to find docs', async ({ page, narration, overlays }) => {
     // Run setup without showing these actions in the final recording.
     await hide(async () => {
         await page.goto('https://screenci.com/');
         await page.waitForLoadState('networkidle');
     });
+    // Open with a brief brand intro card before the walkthrough begins.
+    await overlays.logo.for('2s');
     // Play the matching narration line for this step.
     await narration.docs();
     // Automatically zoom into interactions so they are easier to follow.

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

@@ -1 +1 @@
-{"version":3,"file":"installation.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/installation.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAExD,kEAAkE;AAClE,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAE/E,6EAA6E;AAC7E,KAAK,CAAC,SAAS,CAAC;IACd,EAAE,EAAE;QACF,IAAI,EAAE,kEAAkE;KACzE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,mFAAmF;KAC1F;CACF,CAAC,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;IACnD,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"}
+{"version":3,"file":"installation.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/installation.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAEhD,KAAK;KACF,QAAQ,CAAC;IACR,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;CACpD,CAAC;KACD,SAAS,CAAC;IACT,EAAE,EAAE;QACF,IAAI,EAAE,kEAAkE;KACzE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,mFAAmF;KAC1F;CACF,CAAC,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/D,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,oEAAoE;IACpE,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAE7B,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/languages.screenci.d.ts

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

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

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

package/dist/docs/video-sources/languages.screenci.js

@@ -0,0 +1,68 @@
+import { hide, resetZoom, video, voices, zoomTo } from 'screenci';
+video.use({
+    renderOptions: {
+        narration: {
+            voice: { name: voices.Sophie, style: 'Friendly product guide' },
+        },
+    },
+});
+const appUrl = process.env.SCREENCI_APP_URL ?? 'https://app.screenci.com/';
+// Languages walkthrough recorded against the ScreenCI app (app.screenci.com) for
+// the Languages guide. It shows the Studio Languages section where teammates add
+// or remove recorded languages without touching code. Studio lives behind auth,
+// so recording this needs a logged-in session: set SCREENCI_APP_STORAGE_STATE
+// (see screenci.config.ts). The navigation mirrors studio.screenci.ts.
+//
+// The logo intro (assets/logo.png) is gitignored: it is uploaded on the first
+// record and reused on later runs (CI included).
+video
+    .overlays({
+    logo: { path: './assets/logo.png', fill: 'recording', duration: '2s' },
+})
+    .narration({
+    en: {
+        intro: 'One script records a separate version for each language.',
+        studio: 'On the Business tier, manage the language set from Studio.',
+        add: 'Adding a language fills in its narration, then renders from the same capture.',
+        outro: 'No translation drift: every language covers the same cues.',
+    },
+})('Languages walkthrough', async ({ page, narration, overlays }) => {
+    // Studio lives behind auth (SCREENCI_APP_STORAGE_STATE, see screenci.config.ts).
+    video.skip(!process.env.SCREENCI_APP_STORAGE_STATE, 'Requires SCREENCI_APP_STORAGE_STATE (a logged-in app session).');
+    // Open a finished video's Studio page without showing the navigation.
+    await hide(async () => {
+        await page.goto(appUrl);
+        await page.waitForLoadState('networkidle');
+        await page
+            .getByRole('heading', { name: 'Projects' })
+            .waitFor({ timeout: 30000 });
+        await page.getByTestId('projects-list').getByRole('link').first().click();
+        await page.locator('a[href*="/video/"]').first().click();
+        await page
+            .getByRole('heading', { name: /language versions/i })
+            .waitFor({ timeout: 15000 });
+        await page
+            .getByRole('link', { name: /^open /i })
+            .first()
+            .click();
+        await page
+            .getByRole('heading', { name: /^studio$/i })
+            .waitFor({ timeout: 30000 });
+    });
+    await overlays.logo.for('2s');
+    await narration.intro();
+    // Frame the Studio Languages section while explaining web-managed languages.
+    await narration.studio.start();
+    const languagesHeading = page
+        .getByRole('heading', { name: /languages/i })
+        .first();
+    if (await languagesHeading.isVisible().catch(() => false)) {
+        await zoomTo(languagesHeading);
+        await page.waitForTimeout(900);
+        await resetZoom();
+    }
+    await narration.studio.end();
+    await narration.add();
+    await narration.outro();
+});
+//# sourceMappingURL=languages.screenci.js.map

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

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

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

@@ -23,7 +23,7 @@ video.overlays({
         over: target,
         margin: 6,
         animate: true,
-        durationMs: 2400,
+        duration: '2.4s',
     }),
 })('Locator highlight (animated)', async ({ page, overlays }) => {
     await page.goto('https://screenci.com/');

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

@@ -1 +1 @@
-{"version":3,"file":"locator-highlight-animated.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/locator-highlight-animated.screenci.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAEhC,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,sBAAsB;AACtB,KAAK,CAAC,QAAQ,CAAC;IACb,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,CAAC,8BAA8B,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9D,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"}
+{"version":3,"file":"locator-highlight-animated.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/locator-highlight-animated.screenci.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAEhC,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,sBAAsB;AACtB,KAAK,CAAC,QAAQ,CAAC;IACb,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,QAAQ,EAAE,MAAM;KACjB,CAAC;CACH,CAAC,CAAC,8BAA8B,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9D,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/narration.screenci.d.ts

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

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

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

package/dist/docs/video-sources/narration.screenci.js

@@ -0,0 +1,71 @@
+import { hide, resetZoom, video, voices, zoomTo } from 'screenci';
+video.use({
+    renderOptions: {
+        narration: {
+            voice: { name: voices.Sophie, style: 'Friendly product guide' },
+        },
+    },
+});
+const appUrl = process.env.SCREENCI_APP_URL ?? 'https://app.screenci.com/';
+// Narration walkthrough recorded against the ScreenCI app (app.screenci.com) for
+// the Narration guide. It explains cue-based narration out loud, then shows the
+// Studio narration editor where teammates manage the spoken text without code.
+// Studio lives behind auth, so recording this needs a logged-in session: set
+// SCREENCI_APP_STORAGE_STATE to a Playwright storageState JSON (see
+// screenci.config.ts). The navigation mirrors studio.screenci.ts.
+//
+// The logo intro (assets/logo.png) is gitignored: it is uploaded to the ScreenCI
+// backend on the first record and reused on later runs (CI included).
+video
+    .overlays({
+    logo: { path: './assets/logo.png', fill: 'recording', duration: '2s' },
+})
+    .narration({
+    en: {
+        intro: 'Narration is cue based: you attach a script, then mark where speech starts.',
+        overlap: 'A cue can start, run while the interface moves, and end on your mark.',
+        studio: 'On the Business tier, teammates manage the same narration in Studio.',
+        outro: 'Change the words and re-render, with no re-recording required.',
+    },
+})('Narration walkthrough', async ({ page, narration, overlays }) => {
+    // Studio lives behind auth (SCREENCI_APP_STORAGE_STATE, see screenci.config.ts).
+    // Skip rather than stall on the login page when the session is not configured.
+    video.skip(!process.env.SCREENCI_APP_STORAGE_STATE, 'Requires SCREENCI_APP_STORAGE_STATE (a logged-in app session).');
+    // Open a finished video's Studio page without showing the navigation.
+    await hide(async () => {
+        await page.goto(appUrl);
+        await page.waitForLoadState('networkidle');
+        await page
+            .getByRole('heading', { name: 'Projects' })
+            .waitFor({ timeout: 30000 });
+        await page.getByTestId('projects-list').getByRole('link').first().click();
+        await page.locator('a[href*="/video/"]').first().click();
+        await page
+            .getByRole('heading', { name: /language versions/i })
+            .waitFor({ timeout: 15000 });
+        await page
+            .getByRole('link', { name: /^open /i })
+            .first()
+            .click();
+        await page
+            .getByRole('heading', { name: /^studio$/i })
+            .waitFor({ timeout: 30000 });
+    });
+    // Brand intro, then explain the cue model out loud.
+    await overlays.logo.for('2s');
+    await narration.intro();
+    // Frame the Studio narration section while explaining overlap and Studio editing.
+    await narration.overlap.start();
+    const narrationHeading = page
+        .getByRole('heading', { name: /narration/i })
+        .first();
+    if (await narrationHeading.isVisible().catch(() => false)) {
+        await zoomTo(narrationHeading);
+        await page.waitForTimeout(900);
+        await resetZoom();
+    }
+    await narration.overlap.end();
+    await narration.studio();
+    await narration.outro();
+});
+//# sourceMappingURL=narration.screenci.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"narration.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/narration.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjE,KAAK,CAAC,GAAG,CAAC;IACR,aAAa,EAAE;QACb,SAAS,EAAE;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE;SAChE;KACF;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,2BAA2B,CAAA;AAE1E,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,oEAAoE;AACpE,kEAAkE;AAClE,EAAE;AACF,iFAAiF;AACjF,sEAAsE;AACtE,KAAK;KACF,QAAQ,CAAC;IACR,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE;CACvE,CAAC;KACD,SAAS,CAAC;IACT,EAAE,EAAE;QACF,KAAK,EACH,6EAA6E;QAC/E,OAAO,EACL,uEAAuE;QACzE,MAAM,EACJ,sEAAsE;QACxE,KAAK,EAAE,gEAAgE;KACxE;CACF,CAAC,CAAC,uBAAuB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;IACpE,iFAAiF;IACjF,+EAA+E;IAC/E,KAAK,CAAC,IAAI,CACR,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EACvC,gEAAgE,CACjE,CAAA;IAED,sEAAsE;IACtE,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvB,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;QAE1C,MAAM,IAAI;aACP,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;aAC1C,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9B,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAA;QACzE,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAA;QACxD,MAAM,IAAI;aACP,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;aACpD,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9B,MAAM,IAAI;aACP,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;aACtC,KAAK,EAAE;aACP,KAAK,EAAE,CAAA;QACV,MAAM,IAAI;aACP,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;aAC3C,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,oDAAoD;IACpD,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC7B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;IAEvB,kFAAkF;IAClF,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAC/B,MAAM,gBAAgB,GAAG,IAAI;SAC1B,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;SAC5C,KAAK,EAAE,CAAA;IACV,IAAI,MAAM,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAC9B,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,SAAS,EAAE,CAAA;IACnB,CAAC;IACD,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;IAE7B,MAAM,SAAS,CAAC,MAAM,EAAE,CAAA;IACxB,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;AACzB,CAAC,CAAC,CAAA"}

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

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

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

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

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

@@ -0,0 +1,60 @@
+import { hide, resetZoom, video, voices, zoomTo } from 'screenci';
+video.use({
+    renderOptions: {
+        narration: {
+            voice: { name: voices.Sophie, style: 'Friendly product guide' },
+        },
+    },
+});
+const appUrl = process.env.SCREENCI_APP_URL ?? 'https://app.screenci.com/';
+// Public URLs walkthrough recorded against the ScreenCI app (app.screenci.com) for
+// the Public URLs and Embeds guide. It opens a finished video and highlights the
+// Enable public URL switch that mints stable, language-specific delivery URLs.
+// Recording needs a logged-in session: set SCREENCI_APP_STORAGE_STATE (see
+// screenci.config.ts). The navigation mirrors studio.screenci.ts up to the video
+// page.
+//
+// The logo intro (assets/logo.png) is gitignored: it is uploaded on the first
+// record and reused on later runs (CI included).
+video
+    .overlays({
+    logo: { path: './assets/logo.png', fill: 'recording', duration: '2s' },
+})
+    .narration({
+    en: {
+        intro: 'Public URLs give a finished video a stable delivery surface.',
+        enable: 'Turn on Enable public URL to mint a route for each language.',
+        auto: 'Auto-select keeps every language on its latest finished render.',
+        outro: 'Embed the URL in docs, changelogs, or release pages.',
+    },
+})('Public URLs and embeds', async ({ page, narration, overlays }) => {
+    // The public-delivery switch lives behind auth (SCREENCI_APP_STORAGE_STATE).
+    video.skip(!process.env.SCREENCI_APP_STORAGE_STATE, 'Requires SCREENCI_APP_STORAGE_STATE (a logged-in app session).');
+    // Open a finished video page without showing the navigation.
+    await hide(async () => {
+        await page.goto(appUrl);
+        await page.waitForLoadState('networkidle');
+        await page
+            .getByRole('heading', { name: 'Projects' })
+            .waitFor({ timeout: 30000 });
+        await page.getByTestId('projects-list').getByRole('link').first().click();
+        await page.locator('a[href*="/video/"]').first().click();
+        await page
+            .getByRole('heading', { name: /language versions/i })
+            .waitFor({ timeout: 15000 });
+    });
+    await overlays.logo.for('2s');
+    await narration.intro();
+    // Frame the public-delivery control, identified by its label text.
+    await narration.enable.start();
+    const enableControl = page.getByText(/enable public url/i).first();
+    if (await enableControl.isVisible().catch(() => false)) {
+        await zoomTo(enableControl);
+        await page.waitForTimeout(900);
+        await resetZoom();
+    }
+    await narration.enable.end();
+    await narration.auto();
+    await narration.outro();
+});
+//# sourceMappingURL=public-urls-and-embeds.screenci.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-urls-and-embeds.screenci.js","sourceRoot":"","sources":["../../../docs/video-sources/public-urls-and-embeds.screenci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjE,KAAK,CAAC,GAAG,CAAC;IACR,aAAa,EAAE;QACb,SAAS,EAAE;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE;SAChE;KACF;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,2BAA2B,CAAA;AAE1E,mFAAmF;AACnF,iFAAiF;AACjF,+EAA+E;AAC/E,2EAA2E;AAC3E,iFAAiF;AACjF,QAAQ;AACR,EAAE;AACF,8EAA8E;AAC9E,iDAAiD;AACjD,KAAK;KACF,QAAQ,CAAC;IACR,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE;CACvE,CAAC;KACD,SAAS,CAAC;IACT,EAAE,EAAE;QACF,KAAK,EAAE,8DAA8D;QACrE,MAAM,EAAE,8DAA8D;QACtE,IAAI,EAAE,iEAAiE;QACvE,KAAK,EAAE,sDAAsD;KAC9D;CACF,CAAC,CAAC,wBAAwB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;IACrE,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CACR,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EACvC,gEAAgE,CACjE,CAAA;IAED,6DAA6D;IAC7D,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvB,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAA;QAE1C,MAAM,IAAI;aACP,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;aAC1C,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9B,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAA;QACzE,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAA;QACxD,MAAM,IAAI;aACP,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;aACpD,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC7B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;IAEvB,mEAAmE;IACnE,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAA;IAClE,IAAI,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;QAC3B,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,SAAS,EAAE,CAAA;IACnB,CAAC;IACD,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;IAE5B,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IACtB,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;AACzB,CAAC,CAAC,CAAA"}

package/dist/docs/video-sources/speaking-style.screenci.d.ts

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

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

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