react-autolocale 0.1.0 → 0.3.0-beta.0

package/dist/{redirect-CKNY4ru5.js → redirect-pDFblLdm.js}

@@ -18,9 +18,12 @@ function redirectTarget(opts) {
 	return `/${target}${pathname}${opts.search ?? ""}${opts.hash ?? ""}`;
 }
 const STORAGE_KEY = "react-autolocale:language";
-/** The same logic as a tiny inline script, so the root page redirects before anything paints. */
+/**
+* The same logic as a tiny inline script, so the root page redirects before anything paints. When the visitor stays,
+* the URL is rewritten to the original language's prefix (no reload) so client-side routers see a prefixed path.
+*/
 function redirectScript(codes, original) {
-	return `(function(){try{var C=${JSON.stringify(codes)},O=${JSON.stringify(original)},p=location.pathname,m=/^\\/([a-z]{2,3})(?=\\/|$)/i.exec(p);if(m&&C.indexOf(m[1].toLowerCase())>-1)return;var t=null,s=localStorage.getItem(${JSON.stringify(STORAGE_KEY)});if(s&&C.indexOf(s)>-1)t=s;var l=navigator.languages||[navigator.language];for(var i=0;i<l.length&&!t;i++){var c=String(l[i]).toLowerCase();if(C.indexOf(c)>-1)t=c;else if(C.indexOf(c.split("-")[0])>-1)t=c.split("-")[0]}if(t&&t!==O)location.replace("/"+t+p+location.search+location.hash)}catch(e){}})()`;
+	return `(function(){try{var C=${JSON.stringify(codes)},O=${JSON.stringify(original)},p=location.pathname,m=/^\\/([a-z]{2,3})(?=\\/|$)/i.exec(p);if(m&&C.indexOf(m[1].toLowerCase())>-1)return;var t=null,s=localStorage.getItem(${JSON.stringify(STORAGE_KEY)});if(s&&C.indexOf(s)>-1)t=s;var l=navigator.languages||[navigator.language];for(var i=0;i<l.length&&!t;i++){var c=String(l[i]).toLowerCase();if(C.indexOf(c)>-1)t=c;else if(C.indexOf(c.split("-")[0])>-1)t=c.split("-")[0]}if(t&&t!==O)location.replace("/"+t+p+location.search+location.hash);else history.replaceState(history.state,"","/"+O+p+location.search+location.hash)}catch(e){}})()`;
 }
 //#endregion
 export { redirectScript as n, redirectTarget as r, STORAGE_KEY as t };

package/dist/suggestion-CkZQqMvZ.js

@@ -0,0 +1,24 @@
+//#region src/core/suggestion.ts
+/**
+* Should we offer the visitor another language? Looks at the first browser language we support:
+* if it is the page's own language, was dismissed, or the visitor already chose a language, offer nothing.
+*/
+function suggestLanguage(opts) {
+	if (opts.chosen) return null;
+	for (const tag of opts.browser) {
+		const lower = String(tag).toLowerCase();
+		const base = lower.split("-")[0];
+		const code = opts.codes.includes(lower) ? lower : opts.codes.includes(base) ? base : null;
+		if (!code) continue;
+		return code === opts.current || opts.dismissed.includes(code) ? null : code;
+	}
+	return null;
+}
+const DISMISSED_KEY = "react-autolocale:banner-dismissed";
+const BANNER_EN = {
+	prompt: "This page is also available in {language}.",
+	switch: "Read in {language}",
+	dismiss: "Not now"
+};
+//#endregion
+export { DISMISSED_KEY as n, suggestLanguage as r, BANNER_EN as t };

package/dist/translate-COrJX1KS.d.ts

@@ -0,0 +1,22 @@
+//#region src/core/translate.d.ts
+interface Translator {
+  /** `contexts[i]` says where `texts[i]` appears ("button", "h1", "placeholder", ...). Engines may ignore it. */
+  translate(texts: string[], from: string, to: string, contexts?: string[]): Promise<string[]>;
+}
+/** The simplest way to plug in your own engine (DeepL, an LLM, ...): one function. */
+type TranslateFn = (request: {
+  texts: string[];
+  contexts: string[];
+  from: string;
+  to: string;
+}) => Promise<string[]>;
+/**
+ * Uses a local LLM through Ollama (free, runs on your machine). Unlike the default models it is told
+ * where each string appears, which fixes most one-word mistakes ("Home" in a nav bar is not "Sommaire").
+ */
+declare function ollama(options?: {
+  model: string;
+  url?: string;
+}): Translator;
+//#endregion
+export { Translator as n, ollama as r, TranslateFn as t };

package/dist/vite.d.ts

@@ -1,16 +1,25 @@
+import { n as Translator, r as ollama, t as TranslateFn } from "./translate-COrJX1KS.js";
 import { Plugin } from "vite";
 //#region src/vite/index.d.ts
 export interface ReactAutolocaleOptions {
-  /** Folders (relative to the project root) scanned for JSX. Defaults to "src". */
+  /** Folders (relative to the project root) scanned for JSX. Prefer `include` in auto-locale.config.ts, which the CLI also reads. */
   include?: string[];
-  /** Fix individual translations by hand, e.g. { fr: { Contact: "Contact" } }. */
+  /** Fix individual translations in code, e.g. { fr: { Contact: "Contact" } }. Adds to (and wins over) react-autolocale.overrides.json. */
   overrides?: Record<string, Record<string, string>>;
   /**
    * Extra pages to build, mainly dynamic ones such as "/users/1" (a function can fetch them). Pages reached
    * by links and fixed routes written in your router (<Route path="/thank-you">) are found automatically.
    */
   routes?: string[] | (() => string[] | Promise<string[]>);
+  /** @deprecated Builds no longer translate. Set `provider` in auto-locale.config.ts; `react-autolocale translate` uses it. */
+  engine?: Translator | TranslateFn;
+  /** @deprecated Builds no longer translate. Set `glossary` in auto-locale.config.ts. */
+  glossary?: Record<string, Record<string, string>>;
 }
+/**
+ * Reads the generated catalogs and serves them to the runtime. It never translates, downloads a model or calls
+ * a translation API: missing translations show the source text, and `react-autolocale sync` fills them.
+ */
 export default function reactAutolocale(options?: ReactAutolocaleOptions): Plugin;
 //#endregion
-export { reactAutolocale };
+export { type TranslateFn, type Translator, reactAutolocale, ollama };