heroshot 0.16.0 → 0.18.0

package/dist/{snippet-Fc-PkcTD.js → snippet-ZcZmuryj.js}

@@ -9,7 +9,6 @@ import { homedir, platform } from "node:os";
 import { chromium } from "playwright";
 import { execSync } from "node:child_process";
 import pLimit from "p-limit";
-
 //#region src/ui.ts
 /**
 * Terminal UI using @clack/prompts
@@ -83,7 +82,6 @@ function spinner$1() {
 function log$1(text) {
 	console.log(text);
 }
-
 //#endregion
 //#region src/actionSchema.ts
 /**
@@ -211,7 +209,6 @@ const actionSchema = z.discriminatedUnion("type", [
 ]);
 /** Array of actions to execute sequentially before screenshot capture */
 const actionsSchema = z.array(actionSchema).describe("Ordered list of actions to execute before capturing. Actions run sequentially.");
-
 //#endregion
 //#region src/utils/generateUid.ts
 /**
@@ -221,7 +218,6 @@ const actionsSchema = z.array(actionSchema).describe("Ordered list of actions to
 function generateUid() {
 	return crypto.randomUUID().slice(0, 8);
 }
-
 //#endregion
 //#region src/schema.ts
 /**
@@ -335,33 +331,8 @@ const browserSchema = z.object({
 	deviceScaleFactor: z.number().min(1).max(3).optional().describe("Device pixel ratio (1 = standard, 2 = retina, 3 = ultra-high DPI)"),
 	bypassCSP: z.boolean().optional().describe("Bypass Content-Security-Policy restrictions. Enabled by default for reliable page.evaluate() calls"),
 	reducedMotion: z.enum(["reduce", "no-preference"]).optional().describe("Emulate prefers-reduced-motion media feature. Use \"reduce\" to disable animations"),
-	userAgent: z.string().optional().describe("Custom user agent string for the browser")
-});
-/** Shared CLI options for URL capture */
-const shotCliOptionsSchema = z.object({
-	selector: z.array(z.string()).optional(),
-	output: z.string().optional(),
-	padding: z.number().int().min(0).optional(),
-	width: z.number().int().positive().optional(),
-	height: z.number().int().positive().optional(),
-	mobile: z.boolean().optional(),
-	tablet: z.boolean().optional(),
-	desktop: z.boolean().optional(),
-	dark: z.boolean().optional(),
-	light: z.boolean().optional(),
-	scale: z.number().min(1).max(3).optional(),
-	retina: z.boolean().optional(),
-	quality: z.number().int().min(1).max(100).optional(),
-	viewportOnly: z.boolean().optional(),
-	reducedMotion: z.boolean().optional(),
-	userAgent: z.string().optional()
-});
-/** CLI command options for URL capture (includes --save and --clean flags) */
-const shotCommandOptionsSchema = shotCliOptionsSchema.extend({
-	save: z.boolean().optional(),
-	clean: z.boolean().optional(),
-	workers: z.number().int().min(1).optional(),
-	headed: z.boolean().optional()
+	userAgent: z.string().optional().describe("Custom user agent string for the browser"),
+	ignoreHTTPSErrors: z.boolean().optional().describe("Ignore TLS certificate errors (self-signed certs, custom CA). Dev-only setting")
 });
 /** Global config */
 const configSchema = z.object({
@@ -371,9 +342,9 @@ const configSchema = z.object({
 	browser: browserSchema.optional().describe("Default browser settings applied to all screenshots"),
 	workers: z.number().int().min(1).optional().describe("Number of parallel capture workers (default: 1)"),
 	screenshots: z.array(screenshotSchema).default([]).describe("Screenshot definitions"),
-	hiddenElements: z.record(z.string(), z.array(z.string())).optional().describe("Elements to hide per domain (hostname → CSS selectors)")
+	hiddenElements: z.record(z.string(), z.array(z.string())).optional().describe("Elements to hide per domain (hostname → CSS selectors)"),
+	locales: z.array(z.string().min(1)).optional().describe("Locale codes (e.g., [\"en\", \"de\"]).")
 });
-
 //#endregion
 //#region src/config.ts
 /**
@@ -384,7 +355,6 @@ const configSchema = z.object({
 function parseConfig(input) {
 	return configSchema.parse(input);
 }
-
 //#endregion
 //#region src/configFile.ts
 const HEROSHOT_DIRECTORY_NAME = ".heroshot";
@@ -425,7 +395,6 @@ function saveConfig(configPath, config) {
 	if (!existsSync(parentDirectory)) mkdirSync(parentDirectory, { recursive: true });
 	writeFileSync(configPath, JSON.stringify(config, null, 2), "utf8");
 }
-
 //#endregion
 //#region src/session.ts
 const SESSION_FILENAME = "session.enc";
@@ -433,7 +402,6 @@ const KEYS_DIRECTORY = path.join(homedir(), ".heroshot", "keys");
 const ALGORITHM = "aes-256-gcm";
 const KEY_LENGTH = 32;
 const IV_LENGTH = 16;
-const AUTH_TAG_LENGTH = 16;
 const SALT_LENGTH = 16;
 const SESSION_KEY_LENGTH = 20;
 /**
@@ -472,9 +440,9 @@ function encrypt(data, sessionKey) {
 */
 function decrypt(encryptedData, sessionKey) {
 	const salt = encryptedData.subarray(0, SALT_LENGTH);
-	const iv = encryptedData.subarray(SALT_LENGTH, SALT_LENGTH + IV_LENGTH);
-	const authTag = encryptedData.subarray(SALT_LENGTH + IV_LENGTH, SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH);
-	const ciphertext = encryptedData.subarray(SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH);
+	const iv = encryptedData.subarray(SALT_LENGTH, 32);
+	const authTag = encryptedData.subarray(32, 48);
+	const ciphertext = encryptedData.subarray(48);
 	const decipher = createDecipheriv(ALGORITHM, deriveKey(sessionKey, salt), iv);
 	decipher.setAuthTag(authTag);
 	return Buffer.concat([decipher.update(ciphertext), decipher.final()]).toString("utf8");
@@ -558,7 +526,6 @@ function getSessionKey(cliKey, directory = process.cwd()) {
 	if (environmentKey) return environmentKey;
 	return loadLocalKey(directory);
 }
-
 //#endregion
 //#region src/browser/constants.ts
 /** Default viewport dimensions */
@@ -580,7 +547,6 @@ function findPackageRoot(startDirectory) {
 }
 /** Path to editor directory */
 const EDITOR_DIR = path.join(findPackageRoot(path.dirname(fileURLToPath(import.meta.url))), "editor");
-
 //#endregion
 //#region src/browser/browserDetect.ts
 /**
@@ -660,7 +626,6 @@ function detectSystemBrowsers() {
 	}
 	return detected;
 }
-
 //#endregion
 //#region src/browser/noBrowserError.ts
 /**
@@ -682,7 +647,6 @@ function noBrowserError() {
 	].join("\n");
 	return new Error(message);
 }
-
 //#endregion
 //#region src/browser/launchBrowser.ts
 /**
@@ -731,14 +695,16 @@ async function launchBrowser(options = {}) {
 		...options.storageState && { storageState: options.storageState },
 		...options.colorScheme && { colorScheme: options.colorScheme },
 		...options.reducedMotion && { reducedMotion: options.reducedMotion },
-		...options.userAgent && { userAgent: options.userAgent }
+		...options.userAgent && { userAgent: options.userAgent },
+		...options.ignoreHTTPSErrors && { ignoreHTTPSErrors: true },
+		...options.locale && { locale: options.locale },
+		...options.locale && { extraHTTPHeaders: { "Accept-Language": options.locale } }
 	});
 	return {
 		browser,
 		context
 	};
 }
-
 //#endregion
 //#region src/utils/getColorSchemes.ts
 /**
@@ -752,7 +718,6 @@ function getColorSchemes(setting) {
 	if (setting === "dark") return ["dark"];
 	return ["light", "dark"];
 }
-
 //#endregion
 //#region src/sync/configHelpers.ts
 /**
@@ -778,12 +743,13 @@ function resolveOutputDirectory(configPath, configOutputDirectory, override) {
 /**
 * Calculate total number of captures needed.
 */
-function calculateTotalCaptures(screenshots, schemeCount) {
+function calculateTotalCaptures(screenshots, schemeCount, localeCount = 1) {
 	let total = 0;
 	const adjustedSchemeCount = Math.max(1, schemeCount);
+	const adjustedLocaleCount = Math.max(1, localeCount);
 	for (const screenshot of screenshots) {
 		const viewportCount = screenshot.viewports?.length ?? 1;
-		total += viewportCount * adjustedSchemeCount;
+		total += viewportCount * adjustedSchemeCount * adjustedLocaleCount;
 	}
 	return total;
 }
@@ -810,10 +776,26 @@ function buildBrowserOptions(config) {
 		deviceScaleFactor: config.browser?.deviceScaleFactor,
 		bypassCSP: config.browser?.bypassCSP,
 		reducedMotion: config.browser?.reducedMotion,
-		userAgent: config.browser?.userAgent
+		userAgent: config.browser?.userAgent,
+		ignoreHTTPSErrors: config.browser?.ignoreHTTPSErrors
 	};
 }
-
+//#endregion
+//#region src/utils/localeUrl.ts
+/**
+* Apply locale to a URL by replacing the {locale} placeholder.
+* If the URL contains no placeholder, it is returned unchanged.
+*
+* @example
+* applyLocale('http://localhost:5173/{locale}/about', 'de')
+* // → 'http://localhost:5173/de/about'
+*
+* applyLocale('http://localhost:5173/about', 'de')
+* // → 'http://localhost:5173/about'
+*/
+function applyLocale(url, locale) {
+	return url.replaceAll("{locale}", locale);
+}
 //#endregion
 //#region src/utils/parseViewport.ts
 /**
@@ -847,7 +829,6 @@ function parseViewport(variant) {
 		...VIEWPORT_PRESETS.desktop
 	};
 }
-
 //#endregion
 //#region src/utils/screenshotPath.ts
 /**
@@ -861,7 +842,7 @@ function slugifySegment(text) {
 * Supports subdirectory paths via forward slashes in the name (e.g., "registry/login-01").
 */
 function generateScreenshotFilename(options) {
-	const { name, viewport, colorScheme, format = "png" } = options;
+	const { name, viewport, colorScheme, locale, format = "png" } = options;
 	const segments = name.split("/").map(slugifySegment).filter(Boolean);
 	const directory = segments.length > 1 ? segments.slice(0, -1).join("/") : "";
 	const parts = [segments.at(-1) ?? ""];
@@ -869,9 +850,9 @@ function generateScreenshotFilename(options) {
 	if (colorScheme) parts.push(colorScheme);
 	const extension = format === "jpeg" ? "jpg" : "png";
 	const filename = `${parts.join("-")}.${extension}`;
-	return directory ? `${directory}/${filename}` : filename;
+	const pathWithDirectory = directory ? `${directory}/${filename}` : filename;
+	return locale ? `${locale}/${pathWithDirectory}` : pathWithDirectory;
 }
-
 //#endregion
 //#region src/sync/actions/click.ts
 /** MCP: locator.click(options) or locator.dblclick(options) */
@@ -886,7 +867,6 @@ async function executeClick(page, action) {
 		await (action.doubleClick ? locator.dblclick(options) : locator.click(options));
 	} else await (action.doubleClick ? locator.dblclick() : locator.click());
 }
-
 //#endregion
 //#region src/sync/actions/drag.ts
 /** MCP: startLocator.dragTo(endLocator) */
@@ -896,7 +876,6 @@ async function executeDrag(page, action) {
 	const to = page.locator(action.to);
 	await (action.timeout ? from.dragTo(to, { timeout: action.timeout }) : from.dragTo(to));
 }
-
 //#endregion
 //#region src/sync/actions/evaluate.ts
 /**
@@ -911,7 +890,6 @@ async function executeEvaluate(page, action) {
 		await page.evaluate(`(${action.function})(document.querySelector('${escapedSelector}'))`);
 	} else await page.evaluate(`(${action.function})()`);
 }
-
 //#endregion
 //#region src/sync/actions/fileUpload.ts
 /** MCP: locator.setInputFiles(paths) */
@@ -919,7 +897,6 @@ async function executeFileUpload(page, action) {
 	if (action.type !== "file_upload") return;
 	await page.locator(action.selector).setInputFiles(action.paths);
 }
-
 //#endregion
 //#region src/sync/actions/fillForm.ts
 /** MCP: locator.fill / setChecked / check / selectOption per field type */
@@ -945,7 +922,6 @@ async function executeFillForm(page, action) {
 		}[field.fieldType]?.();
 	}
 }
-
 //#endregion
 //#region src/sync/actions/handleDialog.ts
 /** MCP: Sets up a one-time dialog handler for the next dialog */
@@ -956,7 +932,6 @@ function executeHandleDialog(page, action) {
 		await (accept ? dialog.accept(promptText) : dialog.dismiss());
 	});
 }
-
 //#endregion
 //#region src/sync/actions/hide.ts
 /** Hide elements by setting visibility: hidden (preserves layout) */
@@ -966,7 +941,6 @@ async function executeHide(page, action) {
 		for (const element of elements) element.style.setProperty("visibility", "hidden", "important");
 	});
 }
-
 //#endregion
 //#region src/sync/actions/hover.ts
 /** MCP: locator.hover() */
@@ -975,7 +949,6 @@ async function executeHover(page, action) {
 	const locator = page.locator(action.selector);
 	await (action.timeout ? locator.hover({ timeout: action.timeout }) : locator.hover());
 }
-
 //#endregion
 //#region src/sync/actions/navigate.ts
 /** MCP: page.goto(url) or page.goBack() */
@@ -984,7 +957,6 @@ async function executeNavigate(page, action) {
 	if (action.back) await page.goBack();
 	else if (action.url) await page.goto(action.url, { waitUntil: "domcontentloaded" });
 }
-
 //#endregion
 //#region src/sync/actions/pressKey.ts
 /** MCP: page.keyboard.press(key) */
@@ -992,7 +964,6 @@ async function executePressKey(page, action) {
 	if (action.type !== "press_key") return;
 	await page.keyboard.press(action.key);
 }
-
 //#endregion
 //#region src/sync/actions/resize.ts
 /** MCP: page.setViewportSize({ width, height }) */
@@ -1003,7 +974,6 @@ async function executeResize(page, action) {
 		height: action.height
 	});
 }
-
 //#endregion
 //#region src/sync/actions/selectOption.ts
 /** MCP: locator.selectOption(values) */
@@ -1012,7 +982,6 @@ async function executeSelectOption(page, action) {
 	const locator = page.locator(action.selector);
 	await (action.timeout ? locator.selectOption(action.values, { timeout: action.timeout }) : locator.selectOption(action.values));
 }
-
 //#endregion
 //#region src/sync/actions/type.ts
 /** MCP: locator.fill(text) or locator.pressSequentially(text) */
@@ -1025,7 +994,6 @@ async function executeType(page, action) {
 	} else await (action.slowly ? locator.pressSequentially(action.text) : locator.fill(action.text));
 	if (action.submit) await page.keyboard.press("Enter");
 }
-
 //#endregion
 //#region src/sync/actions/wait.ts
 /** MCP: waitForTimeout / getByText().waitFor() */
@@ -1035,7 +1003,6 @@ async function executeWait(page, action) {
 	if (action.text) await page.getByText(action.text).first().waitFor({ state: "visible" });
 	if (action.textGone) await page.getByText(action.textGone).first().waitFor({ state: "hidden" });
 }
-
 //#endregion
 //#region src/sync/actions/index.ts
 /** Dispatch map: action type -> handler function */
@@ -1065,7 +1032,6 @@ async function executeActions(page, actions) {
 		await actionHandlers[action.type](page, action);
 	}
 }
-
 //#endregion
 //#region src/sync/annotationOverlay.ts
 const OVERLAY_ID$1 = "heroshot-annotation-overlay";
@@ -1246,7 +1212,6 @@ async function removeAnnotationOverlay(page) {
       if (existing) existing.remove();
     })()`);
 }
-
 //#endregion
 //#region src/sync/borderOverlay.ts
 const OVERLAY_ID = "heroshot-border-overlay";
@@ -1288,7 +1253,6 @@ async function removeBorderOverlay(page) {
       if (el) el.remove();
     })()`);
 }
-
 //#endregion
 //#region src/sync/borderRadiusMask.ts
 /**
@@ -1369,7 +1333,6 @@ async function removeBorderRadiusMask(page) {
       }
     })()`);
 }
-
 //#endregion
 //#region src/sync/elementFinder.ts
 /**
@@ -1399,7 +1362,6 @@ async function findElement(page, selector, maxAttempts = 10, intervalMs = 500) {
 	}
 	return null;
 }
-
 //#endregion
 //#region src/sync/paddingMask.ts
 const MASK_ID = "heroshot-padding-mask";
@@ -1464,7 +1426,6 @@ async function removePaddingMask(page) {
       if (existing) existing.remove();
     })()`);
 }
-
 //#endregion
 //#region src/sync/browserFunctions.ts
 /**
@@ -1484,7 +1445,6 @@ async function removePaddingMask(page) {
 function applyColorScheme(isDark) {
 	document.documentElement.classList.toggle("dark", isDark);
 }
-
 //#endregion
 //#region src/sync/pageScripts.ts
 /**
@@ -1584,7 +1544,6 @@ async function getElementBackgroundColor(page, selector) {
 async function applyColorSchemeClass(page, colorScheme) {
 	await page.evaluate(applyColorScheme, colorScheme === "dark");
 }
-
 //#endregion
 //#region src/sync/screenshot.ts
 /**
@@ -1628,7 +1587,6 @@ async function takeScreenshot(options) {
 		omitBackground
 	});
 }
-
 //#endregion
 //#region src/sync/elementCapture.ts
 /**
@@ -1740,7 +1698,6 @@ async function captureElementScreenshot(options) {
 	if (elementFill === "solid" || elementFill === "transparent") await restoreElementBackground(page, selector);
 	return { success: true };
 }
-
 //#endregion
 //#region src/sync/results.ts
 /**
@@ -1749,8 +1706,12 @@ async function captureElementScreenshot(options) {
 /**
 * Build a variant ID suffix.
 */
-function buildVariantSuffix(viewportName, colorScheme) {
-	return [viewportName, colorScheme].filter(Boolean).join("-");
+function buildVariantSuffix(viewportName, colorScheme, locale) {
+	return [
+		locale,
+		viewportName,
+		colorScheme
+	].filter(Boolean).join("-");
 }
 /**
 * Show capture results and return summary.
@@ -1786,7 +1747,6 @@ function showResults(results, outputDirectory, staleFiles, deletedFiles) {
 		deletedFiles: deletedFiles.length > 0 ? deletedFiles : void 0
 	};
 }
-
 //#endregion
 //#region src/sync/capture.ts
 /**
@@ -1854,18 +1814,20 @@ async function captureScreenshot(page, screenshot, outputDirectory, captureOptio
 		name,
 		viewport: variant.viewportName,
 		colorScheme: variant.colorScheme,
+		locale: variant.locale,
 		format
 	});
-	const suffix = buildVariantSuffix(variant.viewportName, variant.colorScheme);
+	const suffix = buildVariantSuffix(variant.viewportName, variant.colorScheme, variant.locale);
 	verbose(`Capturing: ${name}${suffix ? ` (${suffix})` : ""}`);
-	const navResult = await navigateAndPrepare(page, url, variant.colorScheme);
+	const effectiveUrl = variant.localeUrl ?? url;
+	const navResult = await navigateAndPrepare(page, effectiveUrl, variant.colorScheme);
 	if (!navResult.success) return {
 		...navResult,
 		filename
 	};
 	if (captureOptions.hiddenElements) {
 		const { hiddenElements: hiddenByDomain } = captureOptions;
-		const { hostname } = new URL(url);
+		const { hostname } = new URL(effectiveUrl);
 		if (hiddenByDomain[hostname]?.length) await executeHide(page, {
 			type: "hide",
 			selectors: hiddenByDomain[hostname]
@@ -1928,7 +1890,7 @@ async function captureAndLog(page, screenshot, outputDirectory, captureOptions,
 			await page.waitForTimeout(delay);
 		}
 	}
-	const suffix = buildVariantSuffix(variant.viewportName, variant.colorScheme);
+	const suffix = buildVariantSuffix(variant.viewportName, variant.colorScheme, variant.locale);
 	const displayName = suffix ? `${screenshot.name} (${suffix})` : screenshot.name;
 	const idSuffix = suffix ? `-${suffix}` : "";
 	return {
@@ -1939,38 +1901,47 @@ async function captureAndLog(page, screenshot, outputDirectory, captureOptions,
 		error: result.error
 	};
 }
-
 //#endregion
 //#region src/sync/parallelCapture.ts
 /**
 * Parallel screenshot capture with multiple workers.
 */
 /**
-* Build capture jobs from screenshots and schemes.
+* Build capture jobs from screenshots, schemes, and locales.
 * Each job represents a single screenshot capture task.
 */
-function buildCaptureJobs(screenshots, schemes) {
+function buildCaptureJobs(screenshots, schemes, locales = []) {
 	const jobs = [];
 	const hasMultipleSchemes = schemes.length > 1;
 	const schemesToCapture = schemes.length === 0 ? [void 0] : schemes;
+	const localesToCapture = locales.length === 0 ? [void 0] : locales;
 	for (const screenshot of screenshots) {
 		const viewportVariants = screenshot.viewports ?? [];
 		const hasMultipleViewports = viewportVariants.length > 1;
-		for (const scheme of schemesToCapture) if (viewportVariants.length === 0) jobs.push({
-			screenshot,
-			colorScheme: scheme,
-			hasMultipleSchemes,
-			hasMultipleViewports: false
-		});
-		else for (const viewportVariant of viewportVariants) {
-			const parsedViewport = parseViewport(viewportVariant);
-			jobs.push({
+		for (const locale of localesToCapture) {
+			const localeUrl = locale && screenshot.url.includes("{locale}") ? applyLocale(screenshot.url, locale) : void 0;
+			for (const scheme of schemesToCapture) if (viewportVariants.length === 0) jobs.push({
 				screenshot,
 				colorScheme: scheme,
-				viewport: parsedViewport,
 				hasMultipleSchemes,
-				hasMultipleViewports
+				hasMultipleViewports: false,
+				locale,
+				locales,
+				localeUrl
 			});
+			else for (const viewportVariant of viewportVariants) {
+				const parsedViewport = parseViewport(viewportVariant);
+				jobs.push({
+					screenshot,
+					colorScheme: scheme,
+					viewport: parsedViewport,
+					hasMultipleSchemes,
+					hasMultipleViewports,
+					locale,
+					locales,
+					localeUrl
+				});
+			}
 		}
 	}
 	return jobs;
@@ -1987,12 +1958,14 @@ async function executeBatch(jobs, outputDirectory, captureOptions, browserOption
 		storageState: browserOptions.storageState,
 		bypassCSP: browserOptions.bypassCSP,
 		reducedMotion: browserOptions.reducedMotion,
-		userAgent: browserOptions.userAgent
+		userAgent: browserOptions.userAgent,
+		ignoreHTTPSErrors: browserOptions.ignoreHTTPSErrors,
+		locale: jobs[0]?.locale
 	});
 	const page = await context.newPage();
 	try {
 		for (const job of jobs) {
-			const { screenshot, colorScheme, viewport, hasMultipleSchemes, hasMultipleViewports } = job;
+			const { screenshot, colorScheme, viewport, hasMultipleSchemes, hasMultipleViewports, locale, locales } = job;
 			if (viewport) await page.setViewportSize({
 				width: viewport.width,
 				height: viewport.height
@@ -2000,7 +1973,9 @@ async function executeBatch(jobs, outputDirectory, captureOptions, browserOption
 			if (colorScheme) await page.emulateMedia({ colorScheme });
 			const result = await captureAndLog(page, screenshot, outputDirectory, captureOptions, {
 				viewportName: hasMultipleViewports ? viewport?.name : void 0,
-				colorScheme: hasMultipleSchemes ? colorScheme : void 0
+				colorScheme: hasMultipleSchemes ? colorScheme : void 0,
+				locale: (locales ?? []).length > 1 ? locale : void 0,
+				localeUrl: job.localeUrl
 			});
 			results.push(result);
 			onProgress(result);
@@ -2011,16 +1986,17 @@ async function executeBatch(jobs, outputDirectory, captureOptions, browserOption
 	return results;
 }
 /**
-* Group jobs by URL to minimize page navigations.
-* Jobs for the same URL are kept together.
+* Group jobs by effective URL + locale to minimize page navigations.
+* Jobs for the same URL AND same locale are kept together.
+* Locale is a browser context-level setting, so different locales must be separate groups.
 */
 function groupJobsByUrl(jobs) {
 	const groups = /* @__PURE__ */ new Map();
 	for (const job of jobs) {
-		const { url } = job.screenshot;
-		const group = groups.get(url) ?? [];
+		const key = `${job.localeUrl ?? job.screenshot.url}::${job.locale ?? ""}`;
+		const group = groups.get(key) ?? [];
 		group.push(job);
-		groups.set(url, group);
+		groups.set(key, group);
 	}
 	return groups;
 }
@@ -2061,15 +2037,21 @@ async function captureParallel(options) {
 	for (const settled of settledResults) if (settled.status === "fulfilled") allResults.push(...settled.value);
 	return allResults;
 }
-
 //#endregion
 //#region src/sync/schemeCapture.ts
 /**
-* Capture screenshots for a single color scheme.
+* Color scheme + locale screenshot capture orchestration.
+*/
+/**
+* Capture screenshots for a single color scheme + locale combination.
 * Launches a browser, captures all screenshots, and closes the browser.
+*
+* Locale is a browser context-level setting in Playwright, so each locale
+* gets its own browser launch. This ensures Accept-Language and JS locale APIs
+* (Intl, navigator.language) reflect the correct locale for all pages captured.
 */
 async function captureWithScheme(options) {
-	const { screenshots, outputDirectory, captureOptions, browserOptions, colorScheme, schemes, captureSpinner, progress } = options;
+	const { screenshots, outputDirectory, captureOptions, browserOptions, colorScheme, schemes, locale, locales, captureSpinner, progress } = options;
 	const results = [];
 	const { browser, context } = await launchBrowser({
 		headless: !browserOptions.headed,
@@ -2079,22 +2061,33 @@ async function captureWithScheme(options) {
 		colorScheme,
 		bypassCSP: browserOptions.bypassCSP,
 		reducedMotion: browserOptions.reducedMotion,
-		userAgent: browserOptions.userAgent
+		userAgent: browserOptions.userAgent,
+		ignoreHTTPSErrors: browserOptions.ignoreHTTPSErrors,
+		locale
 	});
 	const page = await context.newPage();
 	if (colorScheme) await page.emulateMedia({ colorScheme });
 	const hasMultipleSchemes = schemes.length > 1;
+	const hasMultipleLocales = locales.length > 1;
 	for (const screenshot of screenshots) {
 		const viewportVariants = screenshot.viewports ?? [];
 		const hasMultipleViewports = viewportVariants.length > 1;
+		const localeUrl = locale && screenshot.url.includes("{locale}") ? applyLocale(screenshot.url, locale) : void 0;
 		if (viewportVariants.length === 0) {
 			progress.captured++;
-			const variant = { colorScheme: hasMultipleSchemes ? colorScheme : void 0 };
-			const suffix = variant.colorScheme ? ` (${variant.colorScheme})` : "";
-			captureSpinner.message(`Capturing ${progress.captured}/${progress.total}: ${screenshot.name}${suffix}`);
+			const variant = {
+				colorScheme: hasMultipleSchemes ? colorScheme : void 0,
+				locale: hasMultipleLocales ? locale : void 0,
+				localeUrl
+			};
+			const suffix = [variant.locale, variant.colorScheme].filter(Boolean).join(", ");
+			const suffixDisplay = suffix ? ` (${suffix})` : "";
+			captureSpinner.message(`Capturing ${progress.captured}/${progress.total}: ${screenshot.name}${suffixDisplay}`);
 			const result = await captureAndLog(page, screenshot, outputDirectory, captureOptions, variant);
 			results.push(result);
-		} else for (const viewportVariant of viewportVariants) {
+			continue;
+		}
+		for (const viewportVariant of viewportVariants) {
 			const parsedViewport = parseViewport(viewportVariant);
 			await page.setViewportSize({
 				width: parsedViewport.width,
@@ -2103,9 +2096,15 @@ async function captureWithScheme(options) {
 			progress.captured++;
 			const variant = {
 				viewportName: hasMultipleViewports ? parsedViewport.name : void 0,
-				colorScheme: hasMultipleSchemes ? colorScheme : void 0
+				colorScheme: hasMultipleSchemes ? colorScheme : void 0,
+				locale: hasMultipleLocales ? locale : void 0,
+				localeUrl
 			};
-			const suffix = [variant.viewportName, variant.colorScheme].filter(Boolean).join(", ");
+			const suffix = [
+				variant.locale,
+				variant.viewportName,
+				variant.colorScheme
+			].filter(Boolean).join(", ");
 			const suffixDisplay = suffix ? ` (${suffix})` : "";
 			captureSpinner.message(`Capturing ${progress.captured}/${progress.total}: ${screenshot.name}${suffixDisplay}`);
 			const result = await captureAndLog(page, screenshot, outputDirectory, captureOptions, variant);
@@ -2115,7 +2114,6 @@ async function captureWithScheme(options) {
 	await browser.close();
 	return results;
 }
-
 //#endregion
 //#region src/sync/sessionLoader.ts
 /**
@@ -2132,7 +2130,6 @@ function loadEncryptedSession(sessionKeyOption) {
 	}
 	verbose("Failed to decrypt session - using fresh browser");
 }
-
 //#endregion
 //#region src/sync/files.ts
 /**
@@ -2170,7 +2167,6 @@ function deleteStaleFiles(outputDirectory, staleFiles) {
 function findStaleFiles(existingFiles, writtenFiles) {
 	return existingFiles.filter((file) => !writtenFiles.has(file));
 }
-
 //#endregion
 //#region src/sync/staleFiles.ts
 /**
@@ -2193,7 +2189,6 @@ function handleStaleFiles(outputDirectory, results, options) {
 		deleted
 	};
 }
-
 //#endregion
 //#region src/sync/sync.ts
 /**
@@ -2204,9 +2199,9 @@ function handleStaleFiles(outputDirectory, results, options) {
 * Execute screenshot capture (parallel or sequential based on workers).
 */
 async function executeCapture(context) {
-	const { screenshots, outputDirectory, captureOptions, browserOptions, schemes, workers, captureSpinner, progress } = context;
+	const { screenshots, outputDirectory, captureOptions, browserOptions, schemes, locales, workers, captureSpinner, progress } = context;
 	if (workers > 1) return captureParallel({
-		jobs: buildCaptureJobs(screenshots, schemes),
+		jobs: buildCaptureJobs(screenshots, schemes, locales),
 		outputDirectory,
 		captureOptions,
 		browserOptions,
@@ -2216,7 +2211,8 @@ async function executeCapture(context) {
 	});
 	const results = [];
 	const schemesToCapture = schemes.length === 0 ? [void 0] : schemes;
-	for (const colorScheme of schemesToCapture) {
+	const localesToCapture = locales.length === 0 ? [void 0] : locales;
+	for (const locale of localesToCapture) for (const colorScheme of schemesToCapture) {
 		const schemeResults = await captureWithScheme({
 			screenshots,
 			outputDirectory,
@@ -2224,6 +2220,8 @@ async function executeCapture(context) {
 			browserOptions,
 			colorScheme,
 			schemes,
+			locale,
+			locales,
 			captureSpinner,
 			progress
 		});
@@ -2265,8 +2263,9 @@ async function sync(options = {}) {
 	const outputDirectory = resolveOutputDirectory(configPath, config.outputDirectory, options.outputDirectory);
 	const storageState = loadEncryptedSession(options.sessionKey);
 	const schemes = getColorSchemes(config.browser?.colorScheme);
+	const locales = config.locales ?? [];
 	const captureOptions = buildCaptureOptions(config, options.viewportOnly);
-	const totalToCapture = calculateTotalCaptures(screenshots, schemes.length);
+	const totalToCapture = calculateTotalCaptures(screenshots, schemes.length, Math.max(1, locales.length));
 	const browserOptions = {
 		...buildBrowserOptions(config),
 		storageState,
@@ -2284,6 +2283,7 @@ async function sync(options = {}) {
 			captureOptions,
 			browserOptions,
 			schemes,
+			locales,
 			workers,
 			captureSpinner,
 			progress: {
@@ -2310,7 +2310,6 @@ async function sync(options = {}) {
 	});
 	return showResults(results, outputDirectory, staleFiles, deletedFiles);
 }
-
 //#endregion
 //#region src/cli/snippet.ts
 /**
@@ -2397,6 +2396,5 @@ function snippetAction(pattern, options, configPath) {
 	log$1("");
 	return true;
 }
-
 //#endregion
-export { intro$1 as C, setVerbose as D, outro$1 as E, spinner$1 as O, error as S, note$1 as T, loadConfig as _, launchBrowser as a, screenshotSchema as b, generateSessionKey as c, loadSession as d, saveLocalKey as f, getConfigPath as g, ensureHeroshotDirectory as h, filterScreenshots as i, verbose as k, getSessionPath as l, sessionExists as m, snippetAction as n, DEFAULT_VIEWPORT as o, saveSession as p, sync as r, EDITOR_DIR as s, generateSnippets as t, loadLocalKey as u, saveConfig as v, log$1 as w, generateUid as x, VIEWPORT_PRESETS as y };
+export { intro$1 as C, setVerbose as D, outro$1 as E, spinner$1 as O, error as S, note$1 as T, loadConfig as _, launchBrowser as a, screenshotSchema as b, generateSessionKey as c, loadSession as d, saveLocalKey as f, getConfigPath as g, ensureHeroshotDirectory as h, filterScreenshots as i, verbose as k, getSessionPath as l, sessionExists as m, snippetAction as n, DEFAULT_VIEWPORT as o, saveSession as p, sync as r, EDITOR_DIR as s, generateSnippets as t, loadLocalKey as u, saveConfig as v, log$1 as w, generateUid as x, VIEWPORT_PRESETS as y };