screenci 0.0.9 → 0.0.11

package/README.md

@@ -82,79 +82,65 @@ export default defineConfig({
 
 screenci enforces `workers: 1`, `retries: 0`, and `fullyParallel: false` — FFmpeg records one screen at a time. Don't fight it.
 
-## Captions & AI voiceovers
+## AI voiceovers
 
-`createCaptions()` maps caption keys to text. At render time screenci sends the text through ElevenLabs and lines up the audio with your recording.
+`createVoiceOvers()` maps keys to text (or audio files). At render time screenci generates voiceover audio and syncs it to your recording.
 
 ```ts
-import { video, createCaptions } from 'screenci'
-
-const captions = createCaptions({
-  intro: 'Welcome to the dashboard.',
-  addButton: 'Click here to create a new project.',
+import { video, createVoiceOvers, voices } from 'screenci'
+
+const voiceOvers = createVoiceOvers({
+  voice: { name: voices.Aria },
+  languages: {
+    en: {
+      captions: {
+        intro: 'Welcome to the dashboard.',
+        addButton: 'Click here to create a new project.',
+      },
+    },
+  },
 })
 
 video('Dashboard walkthrough', async ({ page }) => {
   await page.goto('/dashboard')
 
-  await captions.intro.start()
+  await voiceOvers.intro.start()
   // ...anything you do here plays over the voiceover...
-  await captions.intro.end()
+  await voiceOvers.intro.end()
 
   await page.locator('#new-project').click()
-  await captions.addButton.start()
-  await captions.addButton.end()
+  await voiceOvers.addButton.start()
+  await voiceOvers.addButton.end()
 })
 ```
 
-### With a voice
-
-```ts
-import { createCaptions, voices } from 'screenci'
-
-const captions = createCaptions(
-  { voice: voices.en.Jude },
-  {
-    intro: 'Welcome to the dashboard.',
-    addButton: 'Click here to create a new project.',
-  }
-)
-```
-
 ### Multi-language (type-safe)
 
-TypeScript will yell at you if any language is missing a key. That's a feature.
+TypeScript enforces that every language has the same keys. Missing a translation is a compile error.
 
 ```ts
-import { createCaptions, voices } from 'screenci'
-
-const captions = createCaptions({
-  en: {
-    voice: voices.en.Jude,
-    captions: {
-      intro: 'Welcome to the dashboard.',
-      addButton: 'Click here to create a new project.',
+import { createVoiceOvers, voices } from 'screenci'
+
+const voiceOvers = createVoiceOvers({
+  voice: { name: voices.Ava },
+  languages: {
+    en: {
+      captions: {
+        intro: 'Welcome to the dashboard.',
+        addButton: 'Click here to create a new project.',
+      },
     },
-  },
-  fi: {
-    voice: voices.fi.Martti,
-    captions: {
-      intro: 'Tervetuloa hallintapaneeliin.',
-      addButton: 'Klikkaa tästä luodaksesi uuden projektin.',
+    fi: {
+      voice: { name: voices.Nora },
+      captions: {
+        intro: 'Tervetuloa hallintapaneeliin.',
+        addButton: 'Klikkaa tästä luodaksesi uuden projektin.',
+      },
     },
   },
 })
 ```
 
-### Sync actions to audio
-
-```ts
-// Wait until the voiceover is 60% done, then perform the action
-await captions.intro.waitUntil('60%')
-await page.locator('#cta').click()
-await captions.intro.end()
-```
-
 ## Hide the boring parts
 
 `hide()` cuts a section from the final video. Perfect for logins, page loads, and test setup.
@@ -200,14 +186,14 @@ video('Profile settings', async ({ page }) => {
 
 ## API
 
-| Export           | What it does                                         |
-| ---------------- | ---------------------------------------------------- |
-| `defineConfig`   | Wraps Playwright config with screenci defaults       |
-| `video`          | Declares a video recording test                      |
-| `createCaptions` | Creates typed caption controllers with AI voiceovers |
-| `hide`           | Cuts a section from the final video                  |
-| `autoZoom`       | Smooth camera pan that follows interactions          |
-| `voices`         | Available voice constants (`voices.en.Jude`, etc.)   |
+| Export             | What it does                                                       |
+| ------------------ | ------------------------------------------------------------------ |
+| `defineConfig`     | Wraps Playwright config with screenci defaults                     |
+| `video`            | Declares a video recording test                                    |
+| `createVoiceOvers` | Creates typed voiceover controllers with AI-generated audio        |
+| `hide`             | Cuts a section from the final video                                |
+| `autoZoom`         | Smooth camera pan that follows interactions                        |
+| `voices`           | Available voice constants (`voices.Ava`, `voices.elevenlabs(...)`) |
 
 The `page` fixture inside `video()` is a `ScreenCIPage` — a Playwright `Page` with animated cursor support wired in on all locator methods.
 
@@ -223,5 +209,5 @@ The `page` fixture inside `video()` is a `ScreenCIPage` — a Playwright `Page`
 Upload to screenci.com for rendering, voiceover generation, and the permanent embed link:
 
 ```bash
-npm run upload-latest
+npm run retry
 ```

package/dist/Dockerfile

@@ -0,0 +1,48 @@
+# Recording runtime ───────────────────────────────────────────────────────────
+FROM docker.io/library/node:25.2.1-slim AS builder
+
+WORKDIR /build
+
+COPY package.json package.json
+RUN npm install --include=dev --ignore-scripts
+
+COPY tsconfig.json tsconfig.json
+COPY Dockerfile Dockerfile
+COPY index.ts index.ts
+COPY cli.ts cli.ts
+COPY src src
+RUN npm run build
+
+# ── Runtime image ─────────────────────────────────────────────────────────────
+FROM docker.io/library/node:25.2.1-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    xvfb \
+    ffmpeg \
+    x11-utils \
+    && rm -rf /var/lib/apt/lists/*
+
+# ── Dependency layer (cached until package.json changes) ──────────────────────
+# Install screenci as a workspace package so npm creates the bin link.
+COPY package.json ./screenci/
+RUN printf '{"private":true,"workspaces":["screenci"]}' > package.json && npm install
+
+# Playwright browser download: only re-runs when the playwright version changes.
+RUN npx playwright install chromium --with-deps
+
+# ── screenci build output ─────────────────────────────────────────────────────
+COPY --from=builder /build/dist ./screenci/dist/
+
+# Explicit bin wrapper — no npm bin-linking magic needed.
+RUN printf '#!/bin/sh\nexec node /app/screenci/dist/cli.js "$@"\n' > /app/node_modules/.bin/screenci && \
+    chmod +x /app/node_modules/.bin/screenci
+
+# Create .screenci directory for recordings
+RUN mkdir -p .screenci
+
+# Add node_modules/.bin to PATH
+ENV PATH="/app/node_modules/.bin:${PATH}"
+
+CMD ["echo", "Container ready"]

package/dist/cli.d.ts

@@ -1,4 +1,24 @@
 #!/usr/bin/env -S npx tsx
+import type { RecordingCustomVoiceRef, RecordingData } from './src/events.js';
+import type { VoiceKey } from './src/voices.js';
+type PreparedUploadAsset = {
+    fileHash: string;
+    path: string;
+    size: number;
+    name?: string;
+    fileBuffer?: Buffer;
+    contentType?: string;
+};
+declare const MIN_CONTAINER_RUNTIME_MAJOR_VERSION: {
+    readonly podman: 5;
+    readonly docker: 28;
+};
+type ContainerRuntimeName = keyof typeof MIN_CONTAINER_RUNTIME_MAJOR_VERSION;
+export declare function stripVoicePath(voice: VoiceKey | RecordingCustomVoiceRef): VoiceKey | RecordingCustomVoiceRef;
+export declare function annotateRecordingDataWithAssetHashes(data: RecordingData, assets: PreparedUploadAsset[]): RecordingData;
+export declare function getDevBackendUrl(): string;
+export declare function getDevFrontendUrl(): string;
 export declare function main(): Promise<void>;
-export declare function detectContainerRuntime(): string;
+export declare function detectContainerRuntime(forcedRuntime?: ContainerRuntimeName): string;
+export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AAurBA,wBAAsB,IAAI,kBAoJzB;AAqED,wBAAgB,sBAAsB,IAAI,MAAM,CAc/C"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AAwBA,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AA4D/C,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AA6FD,QAAA,MAAM,mCAAmC;;;CAG/B,CAAA;AAEV,KAAK,oBAAoB,GAAG,MAAM,OAAO,mCAAmC,CAAA;AAyhB5E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,GAAG,uBAAuB,GACxC,QAAQ,GAAG,uBAAuB,CAKpC;AAED,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,mBAAmB,EAAE,GAC5B,aAAa,CAqEf;AAmQD,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAukBD,wBAAsB,IAAI,kBAgRzB;AAyJD,wBAAgB,sBAAsB,CACpC,aAAa,CAAC,EAAE,oBAAoB,GACnC,MAAM,CAoBR"}