screenci 0.0.71 → 0.0.72

package/README.md

@@ -71,18 +71,18 @@ but remap its rendered duration.
 
 ## Authoring helpers
 
-| Export            | What it does                                             |
-| ----------------- | -------------------------------------------------------- |
-| `defineConfig`    | Wraps Playwright config with ScreenCI defaults           |
-| `video`           | Declares a video recording test                          |
-| `createNarration` | Creates typed narration controllers                      |
-| `hide`            | Cuts setup or cleanup out of the visible recording       |
-| `autoZoom`        | Smooth camera follow for an interaction block            |
-| `zoomTo`          | Manual camera framing for a locator or point             |
-| `resetZoom`       | Returns from manual framing to the full viewport         |
-| `createOverlays`  | Inserts timed media overlays into the recording timeline |
-| `voices`          | Available voice constants such as `voices.Ava`           |
-| `modelTypes`      | Narration model constants                                |
+| Export           | What it does                                                 |
+| ---------------- | ------------------------------------------------------------ |
+| `defineConfig`   | Wraps Playwright config with ScreenCI defaults               |
+| `video`          | Declares a video recording test                              |
+| `video.localize` | Declares localized narration / text and records per language |
+| `hide`           | Cuts setup or cleanup out of the visible recording           |
+| `autoZoom`       | Smooth camera follow for an interaction block                |
+| `zoomTo`         | Manual camera framing for a locator or point                 |
+| `resetZoom`      | Returns from manual framing to the full viewport             |
+| `createOverlays` | Inserts timed media overlays into the recording timeline     |
+| `voices`         | Available voice constants such as `voices.Ava`               |
+| `modelTypes`     | Narration model constants                                    |
 
 See the [docs](https://screenci.com/docs) for configuration, narration,
 camera, and CI setup.

package/dist/cli.d.ts

@@ -75,5 +75,13 @@ export declare function ensureScreenciSecret(resolvedConfigPath?: string, opts?:
     pollAuth?: boolean;
 }): Promise<string | undefined>;
 export declare function main(): Promise<void>;
+export declare function parseRecordCliArgs(args: string[]): {
+    configPath: string | undefined;
+    verbose: boolean;
+    pollAuth: boolean;
+    remote: boolean;
+    languages: string | undefined;
+    otherArgs: string[];
+};
 export declare function logCliError(error: unknown): void;
 //# 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":"AAwBA,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EAEd,MAAM,iBAAiB,CAAA;AAMxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,gBAAgB,CAAA;AAKxE,OAAO,EAGL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EAOlB,MAAM,sBAAsB,CAAA;AAQ7B,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAA;AAqBvE,KAAK,yBAAyB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,yBAAyB,EAAE,CAAA;CACrC,CAAA;AAUD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,EAC5C,KAAK,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAkB,GACzC,OAAO,CAIT;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,yBAAyB,EAAE,GAC3C,MAAM,EAAE,CAiBV;AAiND,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;AASD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAA;AAEjE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,gBAAgB,CAAA;CACzB,CAAA;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAkE9C,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,CAAC,CAWZ;AAoTD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,EACtD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GACxC,MAAM,IAAI,CAiBZ;AAkaD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAiGhC;AAED,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;AAQD,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,CAeR;AAKD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CAcN;AA8GD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,UAAQ,GACd,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mBAAmB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,aAAa,EAAE,kBAAkB,EAAE,CAAA;IACnC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;CACrB,CAAC,CA8GD;AA8LD,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,GACnB,kBAAkB,GAAG,SAAS,CAmBhC;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GACnB,OAAO,GAAG,SAAS,CAQrB;AAkCD,wBAAgB,wBAAwB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAS3E;AAkGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAY9D;AAqND,wBAAsB,oBAAoB,CACxC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA8I7B;AAED,wBAAsB,IAAI,kBAoXzB;AAmOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAchD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EAEd,MAAM,iBAAiB,CAAA;AASxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,gBAAgB,CAAA;AAKxE,OAAO,EAGL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EAOlB,MAAM,sBAAsB,CAAA;AAQ7B,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAA;AAqBvE,KAAK,yBAAyB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,yBAAyB,EAAE,CAAA;CACrC,CAAA;AAUD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,EAC5C,KAAK,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAkB,GACzC,OAAO,CAIT;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,yBAAyB,EAAE,GAC3C,MAAM,EAAE,CAiBV;AAiND,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;AASD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAA;AAEjE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,gBAAgB,CAAA;CACzB,CAAA;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAkE9C,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,CAAC,CAWZ;AAoTD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,EACtD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GACxC,MAAM,IAAI,CAiBZ;AAkaD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAiGhC;AAED,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;AAQD,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,CAeR;AAKD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CAcN;AA8GD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,UAAQ,GACd,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mBAAmB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,aAAa,EAAE,kBAAkB,EAAE,CAAA;IACnC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;CACrB,CAAC,CA8GD;AA8LD,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,GACnB,kBAAkB,GAAG,SAAS,CAmBhC;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GACnB,OAAO,GAAG,SAAS,CAQrB;AAkCD,wBAAgB,wBAAwB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAS3E;AAkGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAY9D;AA2ND,wBAAsB,oBAAoB,CACxC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA8I7B;AAED,wBAAsB,IAAI,kBA8XzB;AAQD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAClD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,CAoDA;AAgUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAchD"}

package/dist/cli.js

@@ -10,7 +10,7 @@ import { Command, CommanderError } from 'commander';
 import pc from 'picocolors';
 import { logger } from './src/logger.js';
 import { determinePackageManager, parsePackageManager, runInit, } from './src/init.js';
-import { SCREENCI_DISABLE_RECORDING_TIMINGS_ENV, SCREENCI_MOCK_RECORD_ENV, } from './src/runtimeMode.js';
+import { SCREENCI_DISABLE_RECORDING_TIMINGS_ENV, SCREENCI_MOCK_RECORD_ENV, SCREENCI_LANGUAGES_ENV, SCREENCI_TEXT_OVERRIDES_ENV, SCREENCI_RECORD_OPTIONS_ENV, } from './src/runtimeMode.js';
 import { DEFAULT_RECORD_UPLOAD_POLICY } from './src/defaults.js';
 import { findDuplicateTitles, formatDuplicateTitlesMessage, } from './src/titleValidation.js';
 import { createLinkSessionSpec, deletePersistedLinkSessionSpec, getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl, getLinkSessionFilePath, getScreenCIEnvironment, isStoredLinkSessionReusable, readPersistedLinkSessionSpec, SCREENCI_LINK_SESSION_FILE, writePersistedLinkSessionSpec, } from './src/linkSession.js';
@@ -1004,7 +1004,7 @@ export function formatFailedVideoMessage(videoName, message) {
     if (message.startsWith(EXPRESSIVE_TIER_ERROR_PREFIX)) {
         return [
             `${videoName}: ${message}`,
-            "If you want to keep using the current tier, remove `voice.style` or `modelType: 'expressive'` from `createNarration()`.",
+            "If you want to keep using the current tier, remove `voice.style` or `modelType: 'expressive'` from the localize `voice`.",
         ].join('\n');
     }
     return `${videoName}: ${message}`;
@@ -1447,7 +1447,7 @@ export function extractGrep(args) {
 // authenticated commands; the backend dispatches the workflow using the GitHub
 // token stored for the project. An optional `--grep` records only matching
 // videos/screenshots.
-async function triggerRemoteRun(configPath, grep) {
+async function triggerRemoteRun(configPath, grep, languages) {
     const { screenciConfig, secret, apiUrl } = await requireScreenCISecret(configPath, { interactive: detectInteractiveSession() });
     const res = await fetch(`${apiUrl}/cli/trigger-run`, {
         method: 'POST',
@@ -1458,14 +1458,19 @@ async function triggerRemoteRun(configPath, grep) {
         body: JSON.stringify({
             projectName: screenciConfig.projectName,
             ...(grep ? { grep } : {}),
+            ...(languages ? { languages } : {}),
         }),
     });
     if (!res.ok) {
         const text = await res.text();
         throw new Error(`Failed to trigger remote run: ${res.status} ${text}${hint401(res.status, secret)}`);
     }
-    logger.info(grep
-        ? `Triggered the remote recording workflow for "${screenciConfig.projectName}" (filter: ${grep}).`
+    const filters = [
+        ...(grep ? [`filter: ${grep}`] : []),
+        ...(languages ? [`languages: ${languages}`] : []),
+    ];
+    logger.info(filters.length > 0
+        ? `Triggered the remote recording workflow for "${screenciConfig.projectName}" (${filters.join(', ')}).`
         : `Triggered the remote recording workflow for "${screenciConfig.projectName}".`);
 }
 function getLastRecordFilePath(screenciDir) {
@@ -1721,19 +1726,21 @@ export async function main() {
         .option('-v, --verbose', 'verbose output')
         .option('--poll-auth', 'wait for sign-in to complete (polling every 5s, up to 5 minutes) instead of exiting, then continue recording')
         .option('--remote', 'trigger the GitHub Actions recording workflow for this project remotely instead of recording locally')
+        .option('--languages <langs>', 'record/render only these languages (comma-separated, e.g. fi,en)')
         .allowUnknownOption(true)
         .action(async () => {
         const parsed = parseRecordCliArgs(getSubcommandArgv('record'));
         // `--remote` is a pure dispatch: it fires the project's GitHub Actions
         // recording workflow and exits, so there is no local Playwright run. A
-        // pass-through `--grep` becomes the remote recording filter.
+        // pass-through `--grep` becomes the remote recording filter, and
+        // `--languages` limits which language versions are recorded.
         if (parsed.remote) {
-            await triggerRemoteRun(parsed.configPath, extractGrep(parsed.otherArgs));
+            await triggerRemoteRun(parsed.configPath, extractGrep(parsed.otherArgs), parsed.languages);
             return;
         }
         let playwrightFailure = null;
         try {
-            await run('record', parsed.otherArgs, parsed.configPath, parsed.verbose, false, parsed.pollAuth);
+            await run('record', parsed.otherArgs, parsed.configPath, parsed.verbose, false, parsed.pollAuth, parsed.languages);
         }
         catch (error) {
             if (!(error instanceof Error))
@@ -1966,11 +1973,12 @@ function getSubcommandArgv(command) {
     const commandIndex = argv.indexOf(command);
     return commandIndex === -1 ? [] : argv.slice(commandIndex + 1);
 }
-function parseRecordCliArgs(args) {
+export function parseRecordCliArgs(args) {
     let configPath;
     let verbose = false;
     let pollAuth = false;
     let remote = false;
+    let languages;
     const otherArgs = [];
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -1985,6 +1993,20 @@ function parseRecordCliArgs(args) {
             configPath = nextArg;
             i++;
         }
+        else if (arg === '--languages' || arg === '--language') {
+            // screenci-only flag: parsed out so it is not forwarded to Playwright.
+            const nextArg = args[i + 1];
+            if (nextArg === undefined) {
+                logger.error('Error: --languages requires a comma-separated value');
+                process.exit(1);
+            }
+            languages = nextArg;
+            i++;
+        }
+        else if (arg.startsWith('--languages=') ||
+            arg.startsWith('--language=')) {
+            languages = arg.slice(arg.indexOf('=') + 1);
+        }
         else if (arg === '--verbose' || arg === '-v') {
             verbose = true;
         }
@@ -2003,6 +2025,7 @@ function parseRecordCliArgs(args) {
         verbose,
         pollAuth,
         remote,
+        languages,
         otherArgs,
     };
 }
@@ -2053,7 +2076,85 @@ function validateArgs(args) {
         }
     }
 }
-async function run(command, additionalArgs, customConfigPath, verbose = false, mockRecord = false, pollAuth = false) {
+/**
+ * Fetch the project's current Studio text-field overrides so they can be
+ * injected as SCREENCI_TEXT_OVERRIDES before a recording. On-screen `text`
+ * fields render during the recording (they cannot be patched at render time),
+ * so any Studio edits must be present here; code-declared seeds are the
+ * fallback. Best-effort: any failure returns an empty env so the SDK uses the
+ * code seeds, and a recording is never blocked by this fetch.
+ */
+async function fetchTextOverridesEnv(configPath, languages, verbose) {
+    try {
+        const { screenciConfig, secret, apiUrl } = await requireScreenCISecret(configPath, { interactive: false });
+        const params = new URLSearchParams({
+            projectName: screenciConfig.projectName,
+        });
+        if (languages)
+            params.set('languages', languages);
+        const res = await fetch(`${apiUrl}/cli/text-overrides?${params.toString()}`, { headers: { 'X-ScreenCI-Secret': secret } });
+        if (!res.ok) {
+            if (verbose) {
+                logger.warn(`Could not fetch Studio text overrides (${res.status}); using code-declared values.`);
+            }
+            return {};
+        }
+        const body = (await res.json());
+        const overrides = body.overrides;
+        if (overrides === undefined ||
+            overrides === null ||
+            typeof overrides !== 'object' ||
+            Object.keys(overrides).length === 0) {
+            return {};
+        }
+        return { [SCREENCI_TEXT_OVERRIDES_ENV]: JSON.stringify(overrides) };
+    }
+    catch (error) {
+        if (verbose) {
+            logger.warn(`Could not fetch Studio text overrides; using code-declared values.${error instanceof Error ? ` (${error.message})` : ''}`);
+        }
+        return {};
+    }
+}
+/**
+ * Fetch the project's current Studio record-option overrides so they can be
+ * injected as SCREENCI_RECORD_OPTIONS before a recording. Record options (aspect
+ * ratio, quality, fps) change the captured viewport/encode, so any Studio edits
+ * must be present here; code-declared values are the fallback. Best-effort: any
+ * failure returns an empty env so the SDK uses the code values, and a recording
+ * is never blocked by this fetch.
+ */
+async function fetchRecordOptionsEnv(configPath, verbose) {
+    try {
+        const { screenciConfig, secret, apiUrl } = await requireScreenCISecret(configPath, { interactive: false });
+        const params = new URLSearchParams({
+            projectName: screenciConfig.projectName,
+        });
+        const res = await fetch(`${apiUrl}/cli/record-options?${params.toString()}`, { headers: { 'X-ScreenCI-Secret': secret } });
+        if (!res.ok) {
+            if (verbose) {
+                logger.warn(`Could not fetch Studio record options (${res.status}); using code-declared values.`);
+            }
+            return {};
+        }
+        const body = (await res.json());
+        const recordOptions = body.recordOptions;
+        if (recordOptions === undefined ||
+            recordOptions === null ||
+            typeof recordOptions !== 'object' ||
+            Object.keys(recordOptions).length === 0) {
+            return {};
+        }
+        return { [SCREENCI_RECORD_OPTIONS_ENV]: JSON.stringify(recordOptions) };
+    }
+    catch (error) {
+        if (verbose) {
+            logger.warn(`Could not fetch Studio record options; using code-declared values.${error instanceof Error ? ` (${error.message})` : ''}`);
+        }
+        return {};
+    }
+}
+async function run(command, additionalArgs, customConfigPath, verbose = false, mockRecord = false, pollAuth = false, languages) {
     const configPath = resolveScreenCIConfigPathOrExit(customConfigPath);
     if (command === 'test' || process.env.SCREENCI_RECORDING !== 'true') {
         await loadEnvFileFromConfigSource(configPath, false);
@@ -2070,11 +2171,25 @@ async function run(command, additionalArgs, customConfigPath, verbose = false, m
         const screenciDir = resolve(dirname(configPath), '.screenci');
         clearRecordingDirectories(screenciDir);
     }
+    // Studio text-field overrides are injected for the record command only: they
+    // resolve in the SDK's `text` fixture before the recording runs. `test` (the
+    // preview run) keeps code-declared values.
+    const textOverridesEnv = command === 'record'
+        ? await fetchTextOverridesEnv(configPath, languages, verbose)
+        : {};
+    // Studio record-option overrides are likewise injected for record only: they
+    // resolve in the SDK's `recordOptions` fixture before the capture runs.
+    const recordOptionsEnv = command === 'record' ? await fetchRecordOptionsEnv(configPath, verbose) : {};
     const envForChild = { ...process.env };
     await validateUniqueDiscoveredTestTitles(configPath, additionalArgs, {
         ...envForChild,
         SCREENCI_CONFIG_DIR: dirname(configPath),
         ...(command === 'record' ? { SCREENCI_RECORDING: 'true' } : {}),
+        ...(command === 'record' && languages
+            ? { [SCREENCI_LANGUAGES_ENV]: languages }
+            : {}),
+        ...textOverridesEnv,
+        ...recordOptionsEnv,
         ...(command === 'test' && !mockRecord
             ? { [SCREENCI_DISABLE_RECORDING_TIMINGS_ENV]: 'true' }
             : {}),
@@ -2101,6 +2216,14 @@ async function run(command, additionalArgs, customConfigPath, verbose = false, m
             SCREENCI_CONFIG_DIR: dirname(configPath),
             // Enable recording only for record command
             ...(command === 'record' ? { SCREENCI_RECORDING: 'true' } : {}),
+            // Per-language filter: the builder records only these languages.
+            ...(command === 'record' && languages
+                ? { [SCREENCI_LANGUAGES_ENV]: languages }
+                : {}),
+            // Studio text-field overrides resolved from the backend (record only).
+            ...textOverridesEnv,
+            // Studio record-option overrides resolved from the backend (record only).
+            ...recordOptionsEnv,
             ...(command === 'test' && !mockRecord
                 ? { [SCREENCI_DISABLE_RECORDING_TIMINGS_ENV]: 'true' }
                 : {}),