react-autolocale 0.3.0-beta.0 → 0.3.0-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # react-autolocale
 
-Write your React + Vite app in one language. react-autolocale extracts the text, translates it with the engine you choose (a free local model, OpenAI or Anthropic Claude), and `vite build` produces a static page for every language (`/en/`, `/fr/`, `/es/`, ...). You don't call `t()` or manage keys, and your source files are never modified.
+Write your React + Vite app in one language. react-autolocale extracts the text, translates it with the engine you choose (a free local model, OpenAI, Anthropic Claude or Google Gemini), and `vite build` produces a static page for every language (`/en/`, `/fr/`, `/es/`, ...). You don't call `t()` or manage keys, and your source files are never modified.
 
 Translation is a separate, explicit command. Builds only read the generated catalogs. They never download a model, call an API or wait for a translation job.
 
@@ -63,7 +63,7 @@ Optional: `npx react-autolocale add switcher` copies an editable language switch
 | `export` | Copies the translations into `react-autolocale.overrides.json` for hand editing. | None |
 | `add switcher` / `add banner` | Copies an editable component into your project. | None |
 
-`init` also accepts flags, so it can run without prompts in scripts: `--source en --locales fr,es --provider local|openai|anthropic|ollama --model <id> --api-key-env <NAME> --output <dir> --yes`. Every command takes `--root <dir>`; the default is the nearest folder with a `package.json`.
+`init` also accepts flags, so it can run without prompts in scripts: `--source en --locales fr,es --provider local|openai|anthropic|gemini|ollama --model <id> --api-key-env <NAME> --output <dir> --yes`. Every command takes `--root <dir>`; the default is the nearest folder with a `package.json`.
 
 A `generate` run looks like this:
 
@@ -117,6 +117,12 @@ The engine only matters to `translate`/`generate`/`sync`. Extraction, the catalo
 - **Keys**: they are read from `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` (change the name with `apiKeyEnv`), from the environment or from `.env` / `.env.local` in the project root. Variables already set in your shell win. If you paste a key into `init`, it is appended to `.env` (never over an existing value) and `.env` is added to `.gitignore`. Keys are never printed or written into the config, the catalogs or the bundle. A missing key stops the command before any request is made.
 - **Defaults**: `gpt-6-astra` for OpenAI, and `claude-opus-5-5` at `effort: "low"` for Anthropic. Short UI strings rarely need more; Claude refusals fall back server-side on models that support it.
 - **Requests**: strings are sent in batches of 25, 3 at a time, with each string's element (`button`, `h1`, ...) as context. Replies are structured JSON with one translation per string; a batch that comes back the wrong size is retried one string at a time. The SDKs time out after 2 minutes and retry rate limits and server errors 3 times.
+
+**Google Gemini** (`{ name: "gemini", model?, apiKeyEnv?, baseURL? }`) works the same way, with nothing to install: it calls Gemini's REST API directly, so there is no SDK.
+- **Key**: create one in [Google AI Studio](https://aistudio.google.com/apikey) and put `GEMINI_API_KEY=...` in `.env` (or let `init` save it for you). Change the variable name with `apiKeyEnv`.
+- **Model**: `gemini-2.5-flash` by default. Set `model` to any model id shown in AI Studio, for example a newer Flash or a Pro model for harder text.
+- **Behavior**: the same batching and context as the other cloud providers, with structured JSON replies. Rate limits (429) and server errors are retried with backoff, honoring `Retry-After`. A rejected key, a wrong model name or an exhausted quota stops the run with a clear message before anything is stored. Free-tier keys have low rate limits, so large first runs may need to be repeated; finished work is saved after every batch.
+- **Choose it**: `npx react-autolocale init --provider gemini`, or in the config: `provider: { name: "gemini" }`.
 - **Errors**: a rejected key, an unknown model or a used-up quota stops the run instead of failing every batch. A failing provider is never swapped for another one.
 
 **Ollama** (`{ name: "ollama", model: "llama3.1", url? }`) runs a local LLM that receives the context too.

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { F as toTranslator, I as getLanguage, M as TranslationError, N as createLocalTranslator, P as ollama, S as scanProject, a as findSite, b as manifestFile, c as hasRootSrc, d as OVERRIDES_FILE, f as exportTranslations, g as importLegacyCache, h as catalogFile, i as defaultInclude, j as writeJson, k as ensureBanner, l as resolveOutput, m as readOverrides, n as loadConfigFile, o as META_DIR, r as loadProject, s as defaultOutput, t as findConfigFile, u as toProjectPath, v as removeFromCatalogs, x as readManifest, y as translateMissing } from "./project-CGAWETvT.js";
-import { n as DEFAULT_MODELS, t as DEFAULT_KEY_ENV } from "./config-CYHyGpdX.js";
+import { F as toTranslator, I as getLanguage, M as TranslationError, N as createLocalTranslator, P as ollama, S as scanProject, a as findSite, b as manifestFile, c as hasRootSrc, d as OVERRIDES_FILE, f as exportTranslations, g as importLegacyCache, h as catalogFile, i as defaultInclude, j as writeJson, k as ensureBanner, l as resolveOutput, m as readOverrides, n as loadConfigFile, o as META_DIR, r as loadProject, s as defaultOutput, t as findConfigFile, u as toProjectPath, v as removeFromCatalogs, x as readManifest, y as translateMissing } from "./project-BazDFtnp.js";
+import { n as DEFAULT_MODELS, t as DEFAULT_KEY_ENV } from "./config-U-SpTtCW.js";
 import path from "node:path";
 import fs from "node:fs";
 import { spawnSync } from "node:child_process";
@@ -66,6 +66,11 @@ async function createProvider(project, log) {
 			name: `anthropic:${p.model ?? DEFAULT_MODELS.anthropic}`,
 			chunkSize: 100
 		};
+		case "gemini": return {
+			translator: geminiTranslator(p),
+			name: `gemini:${p.model ?? DEFAULT_MODELS.gemini}`,
+			chunkSize: 100
+		};
 	}
 }
 function apiKey(provider, envName) {
@@ -238,6 +243,92 @@ async function anthropicTranslator(root, p) {
 		}
 	});
 }
+/** Gemini's schema dialect (types in capitals) for {"translations": [string, ...]}. */
+const GEMINI_SCHEMA = {
+	type: "OBJECT",
+	properties: { translations: {
+		type: "ARRAY",
+		items: { type: "STRING" }
+	} },
+	required: ["translations"]
+};
+const GEMINI_RETRYABLE = /* @__PURE__ */ new Set([
+	429,
+	500,
+	502,
+	503,
+	504
+]);
+const GEMINI_RETRIES = 3;
+/** The model stopped because of its safety rules, not because it finished. */
+const GEMINI_DECLINED = /* @__PURE__ */ new Set([
+	"SAFETY",
+	"BLOCKLIST",
+	"PROHIBITED_CONTENT",
+	"SPII",
+	"IMAGE_SAFETY",
+	"RECITATION"
+]);
+/** Maps an HTTP failure to a TranslationError. Credential, permission and request errors stop the run. */
+function geminiError(status, data) {
+	const msg = String(data?.error?.message ?? `HTTP ${status}`).replace(/[.\s]+$/, "");
+	if (status === 401 || status === 403 || /API key not valid|API_KEY_INVALID/i.test(msg)) return new TranslationError(`Gemini: the API key was rejected or lacks permission (${msg})`, true);
+	if (status === 404) return new TranslationError(`Gemini: model not found; check the model name (${msg})`, true);
+	if (status === 400) return new TranslationError(`Gemini: request rejected (${msg})`, true);
+	if (status === 429) return new TranslationError(`Gemini: rate limit or quota reached after retries (${msg}). Run the command again later`, true);
+	return new TranslationError(`Gemini: ${msg}`);
+}
+function geminiTranslator(p, deps = {}) {
+	const key = apiKey("gemini", p.apiKeyEnv);
+	const model = p.model ?? DEFAULT_MODELS.gemini;
+	const url = `${(p.baseURL ?? "https://generativelanguage.googleapis.com/v1beta").replace(/\/+$/, "")}/models/${encodeURIComponent(model)}:generateContent`;
+	const sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+	const backoff = (attempt) => Math.min(3e4, 1e3 * 2 ** attempt + Math.random() * 500);
+	return batchedTranslator(async (texts, contexts, from, to) => {
+		const body = JSON.stringify({
+			systemInstruction: { parts: [{ text: systemPrompt(from, to) }] },
+			contents: [{
+				role: "user",
+				parts: [{ text: userPrompt(texts, contexts) }]
+			}],
+			generationConfig: {
+				temperature: 0,
+				responseMimeType: "application/json",
+				responseSchema: GEMINI_SCHEMA
+			}
+		});
+		for (let attempt = 0;; attempt++) {
+			let res;
+			try {
+				res = await fetch(url, {
+					method: "POST",
+					headers: {
+						"content-type": "application/json",
+						"x-goog-api-key": key
+					},
+					body,
+					signal: AbortSignal.timeout(12e4)
+				});
+			} catch (err) {
+				if (attempt >= GEMINI_RETRIES) throw new TranslationError(`Gemini: could not reach the API (${err.message})`);
+				await sleep(backoff(attempt));
+				continue;
+			}
+			if (GEMINI_RETRYABLE.has(res.status) && attempt < GEMINI_RETRIES) {
+				const wait = Number(res.headers.get("retry-after"));
+				await sleep(Number.isFinite(wait) && wait > 0 ? Math.min(wait, 60) * 1e3 : backoff(attempt));
+				continue;
+			}
+			const data = await res.json().catch(() => ({}));
+			if (!res.ok) throw geminiError(res.status, data);
+			if (data.promptFeedback?.blockReason) throw new TranslationError(`Gemini declined to translate this batch (${data.promptFeedback.blockReason})`);
+			const candidate = data.candidates?.[0];
+			if (!candidate || candidate.finishReason === "MAX_TOKENS") return "";
+			if (GEMINI_DECLINED.has(candidate.finishReason)) throw new TranslationError(`Gemini declined to translate this batch (${candidate.finishReason})`);
+			return (candidate.content?.parts ?? []).map((part) => part.text ?? "").join("");
+		}
+	});
+}
 //#endregion
 //#region src/cli/commands.ts
 const ok = (out, msg) => out.log(`✓ ${msg}`);
@@ -545,10 +636,15 @@ async function runInit(root, flags, prompt, out) {
 				value: "anthropic",
 				label: "Cloud AI: Anthropic Claude",
 				help: "Uses a hosted AI model. No large downloads, and usually faster for big translation jobs. Needs an API key;\nprovider usage may be billed to your account."
+			},
+			{
+				value: "gemini",
+				label: "Cloud AI: Google Gemini",
+				help: "Uses a hosted AI model. No large downloads, and usually faster for big translation jobs. Needs an API key;\nprovider usage may be billed to your account."
 			}
 		], "local");
 		let provider;
-		if (name === "openai" || name === "anthropic") provider = {
+		if (name === "openai" || name === "anthropic" || name === "gemini") provider = {
 			name,
 			model: flags.model ?? DEFAULT_MODELS[name],
 			apiKeyEnv: flags.apiKeyEnv ?? DEFAULT_KEY_ENV[name]
@@ -560,7 +656,7 @@ async function runInit(root, flags, prompt, out) {
 				model: flags.model
 			};
 		} else if (name === "local") provider = { name };
-		else throw new Error(`Unknown provider "${name}". Choose local, openai, anthropic or ollama.`);
+		else throw new Error(`Unknown provider "${name}". Choose local, openai, anthropic, gemini or ollama.`);
 		const auto = defaultOutput(root);
 		out.log(`\nGenerated output:\n  ${auto}/\nInternal metadata:\n  ${META_DIR}/`);
 		let output = flags.output ?? await prompt.ask("Catalog folder (press Enter to keep)", auto);
@@ -578,19 +674,23 @@ async function runInit(root, flags, prompt, out) {
 	const provider = config.provider;
 	const ignore = [`${META_DIR}/cache.json`];
 	let modelNote = "";
-	if (provider && typeof provider === "object" && "name" in provider && (provider.name === "openai" || provider.name === "anthropic")) {
+	if (provider && typeof provider === "object" && "name" in provider && (provider.name === "openai" || provider.name === "anthropic" || provider.name === "gemini")) {
 		const keyEnv = provider.apiKeyEnv ?? DEFAULT_KEY_ENV[provider.name];
 		ignore.push(".env", ".env.local");
 		if (keyIsAvailable(root, keyEnv)) out.log(`${keyEnv} is already set (value hidden).`);
 		else {
-			const key = await prompt.secret(`Paste your ${provider.name === "openai" ? "OpenAI" : "Anthropic"} API key to save it in .env (leave empty to do it later)`);
+			const key = await prompt.secret(`Paste your ${{
+				openai: "OpenAI",
+				anthropic: "Anthropic",
+				gemini: "Google Gemini"
+			}[provider.name]} API key to save it in .env (leave empty to do it later)`);
 			if (key) {
 				saveKeyToEnv(root, keyEnv, key);
 				out.log(`Saved ${keyEnv} to .env (value hidden).`);
 			} else out.log(`Add ${keyEnv}=... to .env (or your environment) before running translate. No request is made without it.`);
 		}
-		const pkg = SDK[provider.name];
-		if (!sdkInstalled(root, pkg)) {
+		const pkg = provider.name === "gemini" ? null : SDK[provider.name];
+		if (pkg && !sdkInstalled(root, pkg)) {
 			const cmd = {
 				npm: [
 					"install",
@@ -635,6 +735,7 @@ async function runInit(root, flags, prompt, out) {
 		local: "Local model",
 		openai: "OpenAI",
 		anthropic: "Anthropic Claude",
+		gemini: "Google Gemini",
 		ollama: "Ollama"
 	}[p.name];
 	const out_ = toProjectPath(root, resolveOutput(root, config.output));
@@ -710,7 +811,7 @@ function createPrompter(interactive) {
 const HELP = `react-autolocale
 
 Usage:
-  react-autolocale init [--source en] [--locales fr,es] [--provider local|openai|anthropic|ollama]
+  react-autolocale init [--source en] [--locales fr,es] [--provider local|openai|anthropic|gemini|ollama]
                         [--model <id>] [--api-key-env <NAME>] [--output <dir>] [--yes] [--force]
       Sets up auto-locale.config.ts, the translation provider and the Vite plugin. Downloads nothing.
   react-autolocale generate [--lang fr,es]

package/dist/{config-CYHyGpdX.js → config-U-SpTtCW.js}

@@ -7,15 +7,18 @@ const PROVIDER_NAMES = [
 	"local",
 	"ollama",
 	"openai",
-	"anthropic"
+	"anthropic",
+	"gemini"
 ];
 const DEFAULT_MODELS = {
 	openai: "gpt-6-astra",
-	anthropic: "claude-opus-5-5"
+	anthropic: "claude-opus-5-5",
+	gemini: "gemini-2.5-flash"
 };
 const DEFAULT_KEY_ENV = {
 	openai: "OPENAI_API_KEY",
-	anthropic: "ANTHROPIC_API_KEY"
+	anthropic: "ANTHROPIC_API_KEY",
+	gemini: "GEMINI_API_KEY"
 };
 //#endregion
 export { defineConfig as i, DEFAULT_MODELS as n, PROVIDER_NAMES as r, DEFAULT_KEY_ENV as t };

package/dist/config.d.ts

@@ -30,7 +30,17 @@ interface AnthropicProvider {
   /** How much the model thinks per request. Short UI strings rarely need more than "low" (the default). */
   effort?: "low" | "medium" | "high" | "xhigh" | "max";
 }
-type ProviderConfig = LocalProvider | OllamaProvider | OpenAIProvider | AnthropicProvider;
+/** Google Gemini through its REST API. No SDK needed. Get a key at https://aistudio.google.com/apikey. */
+interface GeminiProvider {
+  name: "gemini";
+  /** Defaults to "gemini-2.5-flash". Use any model id listed in Google AI Studio. */
+  model?: string;
+  /** Environment variable holding the key. Defaults to GEMINI_API_KEY. */
+  apiKeyEnv?: string;
+  /** Custom endpoint, e.g. a proxy. Defaults to https://generativelanguage.googleapis.com/v1beta. */
+  baseURL?: string;
+}
+type ProviderConfig = LocalProvider | OllamaProvider | OpenAIProvider | AnthropicProvider | GeminiProvider;
 interface AutoLocaleConfig {
   /** Language the source code is written in, e.g. "en". */
   sourceLocale?: string;
@@ -53,4 +63,4 @@ interface AutoLocaleConfig {
 /** Typed helper for auto-locale.config.ts. */
 export declare function defineConfig(config: AutoLocaleConfig): AutoLocaleConfig;
 //#endregion
-export type { AnthropicProvider, AutoLocaleConfig, LocalProvider, OllamaProvider, OpenAIProvider, ProviderConfig, TranslateFn, Translator };
+export type { AnthropicProvider, AutoLocaleConfig, GeminiProvider, LocalProvider, OllamaProvider, OpenAIProvider, ProviderConfig, TranslateFn, Translator };

package/dist/config.js

@@ -1 +1 @@
-export { i as defineConfig } from "./config-CYHyGpdX.js";
+export { i as defineConfig } from "./config-U-SpTtCW.js";

package/dist/{project-CGAWETvT.js → project-BazDFtnp.js}

@@ -1,5 +1,5 @@
 import { t as BANNER_EN } from "./suggestion-CkZQqMvZ.js";
-import { r as PROVIDER_NAMES } from "./config-CYHyGpdX.js";
+import { r as PROVIDER_NAMES } from "./config-U-SpTtCW.js";
 import path from "node:path";
 import fs from "node:fs";
 import { spawnSync } from "node:child_process";

package/dist/vite.js

@@ -1,5 +1,5 @@
 import { n as redirectScript } from "./redirect-pDFblLdm.js";
-import { A as readBanner, C as isSourceFile, D as translateHead, E as transformJsx, I as getLanguage, O as messageId, P as ollama, T as parserPlugins, _ as loadDicts, d as OVERRIDES_FILE, m as readOverrides, p as mergeOverrides, r as loadProject, w as walk } from "./project-CGAWETvT.js";
+import { A as readBanner, C as isSourceFile, D as translateHead, E as transformJsx, I as getLanguage, O as messageId, P as ollama, T as parserPlugins, _ as loadDicts, d as OVERRIDES_FILE, m as readOverrides, p as mergeOverrides, r as loadProject, w as walk } from "./project-BazDFtnp.js";
 import path from "node:path";
 import fs from "node:fs";
 import { JSDOM, VirtualConsole } from "jsdom";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-autolocale",
-  "version": "0.3.0-beta.0",
+  "version": "0.3.0-beta.1",
   "description": "Wrap your React + Vite app in <AutoScale> and get fully translated static pages (/fr, /es, ...). Translations are generated by an explicit CLI step with a local model, OpenAI or Anthropic; builds never translate.",
   "license": "MIT",
   "keywords": [