i18n-boost 0.1.0

package/dist/server/index.mjs

@@ -0,0 +1,180 @@
+// src/server/express.ts
+import express, { Router } from "express";
+
+// src/server/handler.ts
+import { timingSafeEqual, createHash } from "crypto";
+import { readFile } from "fs/promises";
+import path from "path";
+
+// src/core/key-utils.ts
+function flattenObject(obj, prefix = "", separator = ".") {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const fullKey = prefix ? `${prefix}${separator}${key}` : key;
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      const nested = flattenObject(
+        value,
+        fullKey,
+        separator
+      );
+      Object.assign(result, nested);
+    } else if (typeof value === "string") {
+      result[fullKey] = value;
+    }
+  }
+  return result;
+}
+
+// src/server/handler.ts
+var MAX_TARGET_LOCALES = 30;
+var MAX_FRONTEND_KEYS = 5e3;
+var LOCALE_PATTERN = /^[a-z]{2,3}(-[A-Z][a-zA-Z]{1,7})?$/;
+var warnedNoSecret = false;
+function safeCompare(a, b) {
+  const ha = createHash("sha256").update(a).digest();
+  const hb = createHash("sha256").update(b).digest();
+  return timingSafeEqual(ha, hb);
+}
+function isValidBody(body) {
+  if (typeof body !== "object" || body === null) return false;
+  const b = body;
+  if (!Array.isArray(b.targetLocales)) return false;
+  if (!b.targetLocales.every((l) => typeof l === "string" && LOCALE_PATTERN.test(l))) return false;
+  if (b.frontendTexts !== void 0) {
+    if (typeof b.frontendTexts !== "object" || b.frontendTexts === null) return false;
+    if (Array.isArray(b.frontendTexts)) return false;
+    const ft = b.frontendTexts;
+    if (!Object.values(ft).every((v) => typeof v === "string")) return false;
+  }
+  return true;
+}
+var I18nHandlerError = class extends Error {
+  constructor(statusCode, message) {
+    super(message);
+    this.statusCode = statusCode;
+    this.name = "I18nHandlerError";
+  }
+  statusCode;
+};
+async function readFlatJson(filePath) {
+  try {
+    const raw = await readFile(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return flattenObject(parsed);
+  } catch {
+    return {};
+  }
+}
+async function handleSync(body, options) {
+  if (options.secret !== void 0) {
+    if (options.requestSecret === void 0 || !safeCompare(options.requestSecret, options.secret)) {
+      throw new I18nHandlerError(401, "Unauthorized");
+    }
+  } else if (!warnedNoSecret) {
+    warnedNoSecret = true;
+    console.warn("[i18n-boost] No secret configured \u2014 /sync endpoint is unauthenticated");
+  }
+  if (!isValidBody(body)) {
+    throw new I18nHandlerError(400, "Invalid request body");
+  }
+  const { targetLocales, frontendTexts = {} } = body;
+  if (targetLocales.length > MAX_TARGET_LOCALES) {
+    throw new I18nHandlerError(400, `Too many targetLocales (max ${MAX_TARGET_LOCALES})`);
+  }
+  if (Object.keys(frontendTexts).length > MAX_FRONTEND_KEYS) {
+    throw new I18nHandlerError(400, `Too many frontendTexts keys (max ${MAX_FRONTEND_KEYS})`);
+  }
+  const sourceLocalePath = path.join(options.localesDir, `${options.sourceLocale}.json`);
+  const backendKeys = await readFlatJson(sourceLocalePath);
+  const collisions = Object.keys(frontendTexts).filter((k) => backendKeys[k] !== void 0);
+  if (collisions.length > 0) {
+    console.warn(
+      `[i18n-boost] Key collision(s) \u2014 backend wins: ${collisions.join(", ")}`
+    );
+  }
+  const allTexts = { ...frontendTexts, ...backendKeys };
+  const allKeys = Object.keys(allTexts);
+  const allValues = allKeys.map((k) => allTexts[k]);
+  const locales = {};
+  for (const targetLocale of targetLocales) {
+    try {
+      const result = await options.provider.translate({
+        texts: allValues,
+        sourceLocale: options.sourceLocale,
+        targetLocale
+      });
+      const translated = {};
+      for (let i = 0; i < allKeys.length; i++) {
+        translated[allKeys[i]] = result.translations[i];
+      }
+      locales[targetLocale] = translated;
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new I18nHandlerError(500, `Translation failed for ${targetLocale}: ${message}`);
+    }
+  }
+  return { sourceKeys: backendKeys, locales };
+}
+
+// src/server/express.ts
+var BLOCKED_ENVS = ["production", "staging"];
+function createI18nRouter(options) {
+  const env = process.env["NODE_ENV"];
+  if (BLOCKED_ENVS.includes(env ?? "")) {
+    throw new Error(
+      `[i18n-boost] createI18nRouter() is a development-only tool and must not run in '${env}'. Remove it from your production server setup.`
+    );
+  }
+  const router = Router();
+  router.use(express.json({ limit: "1mb" }));
+  router.post("/sync", async (req, res) => {
+    try {
+      const rawSecret = req.headers["x-i18n-secret"];
+      const requestSecret = Array.isArray(rawSecret) ? rawSecret[0] : rawSecret;
+      const result = await handleSync(req.body, {
+        ...options,
+        requestSecret
+      });
+      res.json(result);
+    } catch (err) {
+      if (err instanceof I18nHandlerError) {
+        res.status(err.statusCode).json({ error: err.message });
+      } else {
+        res.status(500).json({ error: "Internal server error" });
+      }
+    }
+  });
+  return router;
+}
+
+// src/server/fastify.ts
+var BLOCKED_ENVS2 = ["production", "staging"];
+function createI18nPlugin(options) {
+  const env = process.env["NODE_ENV"];
+  if (BLOCKED_ENVS2.includes(env ?? "")) {
+    throw new Error(
+      `[i18n-boost] createI18nPlugin() is a development-only tool and must not run in '${env}'. Remove it from your production server setup.`
+    );
+  }
+  return async function plugin(fastify) {
+    fastify.post("/sync", { bodyLimit: 1048576 }, async (request, reply) => {
+      try {
+        const result = await handleSync(request.body, {
+          ...options,
+          requestSecret: request.headers["x-i18n-secret"]
+        });
+        return result;
+      } catch (err) {
+        if (err instanceof I18nHandlerError) {
+          return reply.status(err.statusCode).send({ error: err.message });
+        }
+        return reply.status(500).send({ error: "Internal server error" });
+      }
+    });
+  };
+}
+export {
+  I18nHandlerError,
+  createI18nPlugin,
+  createI18nRouter
+};

package/dist/setup/postinstall.cjs

@@ -0,0 +1,33 @@
+"use strict";var N=Object.create;var h=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var $=Object.getPrototypeOf,H=Object.prototype.hasOwnProperty;var b=(n,e)=>()=>(n&&(e=n(n=0)),e);var k=(n,e)=>{for(var t in e)h(n,t,{get:e[t],enumerable:!0})},I=(n,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of F(e))!H.call(n,r)&&r!==t&&h(n,r,{get:()=>e[r],enumerable:!(s=B(e,r))||s.enumerable});return n};var _=(n,e,t)=>(t=n!=null?N($(n)):{},I(e||!n||!n.__esModule?h(t,"default",{value:n,enumerable:!0}):t,n)),J=n=>I(h({},"__esModule",{value:!0}),n);var A,P=b(()=>{A=[{code:"en-US",native_name:"English (US)",english_name:"English (US)"},{code:"en-GB",native_name:"English (UK)",english_name:"English (UK)"},{code:"es-419",native_name:"Espa\xF1ol (Latinoam\xE9rica)",english_name:"Spanish (Latin America)"},{code:"es-ES",native_name:"Espa\xF1ol (Espa\xF1a)",english_name:"Spanish (Spain)"},{code:"pt-BR",native_name:"Portugu\xEAs (Brasil)",english_name:"Portuguese (Brazil)"},{code:"fr-FR",native_name:"Fran\xE7ais",english_name:"French"},{code:"fr-CA",native_name:"Fran\xE7ais (Canada)",english_name:"French (Canada)"},{code:"de-DE",native_name:"Deutsch",english_name:"German"},{code:"it-IT",native_name:"Italiano",english_name:"Italian"},{code:"nl-NL",native_name:"Nederlands",english_name:"Dutch"},{code:"zh-CN",native_name:"\u7B80\u4F53\u4E2D\u6587",english_name:"Chinese (Simplified)"},{code:"zh-TW",native_name:"\u7E41\u9AD4\u4E2D\u6587",english_name:"Chinese (Traditional)"},{code:"ja-JP",native_name:"\u65E5\u672C\u8A9E",english_name:"Japanese"},{code:"ko-KR",native_name:"\uD55C\uAD6D\uC5B4",english_name:"Korean"},{code:"ar-SA",native_name:"\u0627\u0644\u0639\u0631\u0628\u064A\u0629",english_name:"Arabic"},{code:"hi-IN",native_name:"\u0939\u093F\u0928\u094D\u0926\u0940",english_name:"Hindi"},{code:"ru-RU",native_name:"\u0420\u0443\u0441\u0441\u043A\u0438\u0439",english_name:"Russian"},{code:"tr-TR",native_name:"T\xFCrk\xE7e",english_name:"Turkish"},{code:"id-ID",native_name:"Bahasa Indonesia",english_name:"Indonesian"},{code:"vi-VN",native_name:"Ti\u1EBFng Vi\u1EC7t",english_name:"Vietnamese"},{code:"pl-PL",native_name:"Polski",english_name:"Polish"},{code:"sv-SE",native_name:"Svenska",english_name:"Swedish"},{code:"no-NO",native_name:"Norsk",english_name:"Norwegian"},{code:"da-DK",native_name:"Dansk",english_name:"Danish"},{code:"fi-FI",native_name:"Suomi",english_name:"Finnish"},{code:"th-TH",native_name:"\u0E44\u0E17\u0E22",english_name:"Thai"},{code:"he-IL",native_name:"\u05E2\u05D1\u05E8\u05D9\u05EA",english_name:"Hebrew"},{code:"uk-UA",native_name:"\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430",english_name:"Ukrainian"},{code:"cs-CZ",native_name:"\u010Ce\u0161tina",english_name:"Czech"},{code:"el-GR",native_name:"\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC",english_name:"Greek"}]});var T={};k(T,{runInit:()=>G});async function R(n){try{let e=await(0,m.readFile)(g.default.join(n,"package.json"),"utf-8");return JSON.parse(e)}catch{return{}}}function j(n){let e=n.scripts;return!e||typeof e!="object"?!1:"i18gen"in e}async function G(n){let{cwd:e}=n,{projectType:t}=await(0,o.default)({type:"select",name:"projectType",message:"Project type:",choices:[{title:"Back-End   (API keys here, exposes translation endpoint)",value:"backend"},{title:"Front-End  (calls your backend to translate)",value:"frontend"}]});if(!t){console.log(a.default.yellow("Setup cancelled."));return}t==="backend"?await W(e):await z(e)}async function W(n){let{outputDir:e}=await(0,o.default)({type:"text",name:"outputDir",message:"Output directory:",initial:"src/locales"});if(e===void 0){console.log(a.default.yellow("Setup cancelled."));return}let{provider:t}=await(0,o.default)({type:"select",name:"provider",message:"Choose a translation provider:",choices:[{title:"DeepL",value:"deepl"},{title:"OpenAI-compatible API  (OpenAI, DeepSeek, Groq, Ollama\u2026)",value:"openai"},{title:"Anthropic  (Claude)",value:"anthropic"},{title:"LibreTranslate  (self-hosted)",value:"libre-translate"},{title:"I'll decide later  (run `i18n-boost --help` for guidance)",value:"none"}]});if(t===void 0){console.log(a.default.yellow("Setup cancelled."));return}C(t);let s={name:t};if(t==="anthropic"||t==="openai"){let{model:l}=await(0,o.default)({type:"text",name:"model",message:`Preferred model (${t}):`,initial:E[t]??""});s.model=l}if(t==="libre-translate"){let{apiUrl:l}=await(0,o.default)({type:"text",name:"apiUrl",message:"libre-translate API URL:",initial:"http://localhost:5000"});s.apiUrl=l}let r=await R(n),f=!1;j(r)||(f=(await(0,o.default)({type:"confirm",name:"addScript",message:'Add "i18gen": "i18n-boost generate" to package.json?',initial:!0})).addScript??!1);let{confirm:u}=await(0,o.default)({type:"confirm",name:"confirm",message:"Write .i18nrc.json?",initial:!0});if(!u){console.log(a.default.yellow("Aborted. No files written."));return}let c={type:"backend",outputDir:e,provider:s},d=g.default.join(n,".i18nrc.json");if(await(0,m.writeFile)(d,JSON.stringify(c,null,2),"utf-8"),console.log(a.default.green(`\u2713 Written ${d}`)),f){let l=r.scripts??{};l.i18gen="i18n-boost generate",r.scripts=l;let w=g.default.join(n,"package.json");await(0,m.writeFile)(w,JSON.stringify(r,null,2),"utf-8"),console.log(a.default.green('\u2713 Added "i18gen" script to package.json'))}O(t),V(t,s.model)}function V(n,e){let t=`{
+    provider: '${n}',
+    secret: process.env.I18N_SECRET,
+    localesDir: './src/locales',
+    sourceLocale: 'en-US',
+  }`;console.log(`
+`+a.default.cyan("\u2500\u2500 Express \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")),console.log(`  import { createI18nRouter } from 'i18n-boost/server';
+  app.use('/api/i18n', createI18nRouter(${t}));`),console.log(`
+`+a.default.cyan("\u2500\u2500 Fastify \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")),console.log(`  import { createI18nPlugin } from 'i18n-boost/server';
+  await fastify.register(createI18nPlugin(${t}), { prefix: '/api/i18n' });`),console.log(`
+`+a.default.cyan("\u2500\u2500 NestJS \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")),console.log(`  import { handleSync, I18nHandlerError } from 'i18n-boost/server';
+
+  @Post('sync')
+  async sync(@Body() body: unknown, @Headers('x-i18n-secret') secret?: string) {
+    try {
+      return await handleSync(body, {
+        provider: this.provider,
+        secret: process.env.I18N_SECRET,
+        localesDir: './src/locales',
+        sourceLocale: 'en-US',
+        requestSecret: secret,
+      });
+    } catch (err) {
+      if (err instanceof I18nHandlerError) throw new HttpException(err.message, err.statusCode);
+      throw err;
+    }
+  }`)}async function z(n){let e=A.map(i=>({title:`${i.code}  (${i.english_name})`,value:i.code})),{preset:t}=await(0,o.default)({type:"select",name:"preset",message:"Preset:",choices:[{title:"i18next",value:"i18next"},{title:"next-intl",value:"next-intl"}]});if(t===void 0){console.log(a.default.yellow("Setup cancelled."));return}let{sourceLocale:s}=await(0,o.default)({type:"select",name:"sourceLocale",message:"Source locale:",choices:e,initial:e.findIndex(i=>i.value==="en-US")});if(s===void 0){console.log(a.default.yellow("Setup cancelled."));return}let{targetLocales:r}=await(0,o.default)({type:"multiselect",name:"targetLocales",message:"Target locales:",choices:e.filter(i=>i.value!==s),min:1});if(!r||r.length===0){console.log(a.default.yellow("Setup cancelled."));return}let{outputDir:f}=await(0,o.default)({type:"text",name:"outputDir",message:"Output directory:",initial:"src/locales"}),{strategy:u}=await(0,o.default)({type:"select",name:"strategy",message:"Translation strategy:",choices:[{title:"Via backend   (your backend translates \u2014 no API keys here)",value:"backend"},{title:"Direct        (API key in env var \u2014 for SSR / CI builds)",value:"direct"}]});if(u===void 0){console.log(a.default.yellow("Setup cancelled."));return}let c;if(u==="backend"){let{backendUrl:i}=await(0,o.default)({type:"text",name:"backendUrl",message:"Backend URL:",initial:"http://localhost:3001/api/i18n/sync"}),{secret:p}=await(0,o.default)({type:"text",name:"secret",message:"Secret (blank for none):",initial:""});c={name:"backend",url:i},p&&p.trim()!==""&&(c.secret=p)}else{let{provider:i}=await(0,o.default)({type:"select",name:"provider",message:"Choose a translation provider:",choices:[{title:"DeepL",value:"deepl"},{title:"OpenAI-compatible API  (OpenAI, DeepSeek, Groq, Ollama\u2026)",value:"openai"},{title:"Anthropic  (Claude)",value:"anthropic"},{title:"LibreTranslate  (self-hosted)",value:"libre-translate"},{title:"I'll decide later  (run `i18n-boost --help` for guidance)",value:"none"}]});if(i===void 0){console.log(a.default.yellow("Setup cancelled."));return}if(C(i),c={name:i},i==="anthropic"||i==="openai"){let{model:p}=await(0,o.default)({type:"text",name:"model",message:`Preferred model (${i}):`,initial:E[i]??""});c.model=p}if(i==="libre-translate"){let{apiUrl:p}=await(0,o.default)({type:"text",name:"apiUrl",message:"libre-translate API URL:",initial:"http://localhost:5000"});c.apiUrl=p}}let d=await R(n),l=!1;j(d)||(l=(await(0,o.default)({type:"confirm",name:"addScript",message:'Add "i18gen": "i18n-boost generate" to package.json?',initial:!0})).addScript??!1);let{confirm:w}=await(0,o.default)({type:"confirm",name:"confirm",message:"Write .i18nrc.json?",initial:!0});if(!w){console.log(a.default.yellow("Aborted. No files written."));return}let D={type:"frontend",preset:t,sourceLocale:s,targetLocales:r,outputDir:f,provider:c},S=g.default.join(n,".i18nrc.json");if(await(0,m.writeFile)(S,JSON.stringify(D,null,2),"utf-8"),console.log(a.default.green(`\u2713 Written ${S}`)),l){let i=d.scripts??{};i.i18gen="i18n-boost generate",d.scripts=i;let p=g.default.join(n,"package.json");await(0,m.writeFile)(p,JSON.stringify(d,null,2),"utf-8"),console.log(a.default.green('\u2713 Added "i18gen" script to package.json'))}u==="direct"&&O(c.name),q()}function C(n){let e=x[n];e&&console.log(a.default.dim(`  \u2192 Obtain an API key from ${e} and set ${a.default.bold("I18NBOOST_KEY=<your-api-key>")}`))}function O(n){let e=x[n];e&&(console.log(`
+`+a.default.cyan("\u2500\u2500 Environment variable \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")),console.log(`  Obtain an API key from ${e} and set:`),console.log("    export I18NBOOST_KEY=<your-api-key>"),console.log("    npx i18n-boost generate --translate"))}function q(){console.log(`
+`+a.default.cyan("\u2500\u2500 Usage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")),console.log(`  import { tt } from 'i18n-boost/tt';
+
+  // Mark strings for extraction and translation:
+  const label = tt('ui.submit', 'Submit');
+  const greeting = tt('home.hello', 'Hello, world!');`)}var a,m,g,o,E,x,L=b(()=>{"use strict";a=_(require("picocolors"),1),m=require("fs/promises"),g=_(require("path"),1),o=_(require("prompts"),1);P();E={anthropic:"claude-haiku-4-5-20251001",openai:"gpt-4o-mini"};x={anthropic:"Anthropic",openai:"OpenAI",deepl:"DeepL","libre-translate":"LibreTranslate"}});var Y={};k(Y,{runPostinstall:()=>U});module.exports=J(Y);var v=require("fs"),y=require("path");async function U(n){let e=n?.cwd??process.env.INIT_CWD??process.cwd();if((0,v.existsSync)((0,y.join)(e,".i18nrc.json"))||(0,v.existsSync)((0,y.join)(e,".i18nrc.js"))||(0,v.existsSync)((0,y.join)(e,".i18nrc.cjs"))||!process.stdout.isTTY)return;let{runInit:t}=await Promise.resolve().then(()=>(L(),T));try{await t({cwd:e})}catch{console.log("\ni18n-boost: Setup cancelled. Run `npx i18n-boost init` when ready.\n")}}U().catch(()=>process.exit(0));0&&(module.exports={runPostinstall});

package/dist/tt.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var a=(t,n)=>{for(var e in n)s(t,e,{get:n[e],enumerable:!0})},g=(t,n,e,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of o(n))!p.call(t,r)&&r!==e&&s(t,r,{get:()=>n[r],enumerable:!(i=c(n,r))||i.enumerable});return t};var u=t=>g(s({},"__esModule",{value:!0}),t);var f={};a(f,{tt:()=>l});module.exports=u(f);function l(t,n){if(n!==void 0)return n;let e=t.includes(".")?t.split(".").pop():t;return d(e)}function d(t){let n=t.replace(/([a-z0-9])([A-Z])/g,"$1 $2");return n.charAt(0).toUpperCase()+n.slice(1).toLowerCase()}0&&(module.exports={tt});

package/dist/tt.d.cts

@@ -0,0 +1,3 @@
+declare function tt(key: string, defaultText?: string): string;
+
+export { tt };

package/dist/tt.d.ts

@@ -0,0 +1,3 @@
+declare function tt(key: string, defaultText?: string): string;
+
+export { tt };

package/dist/tt.mjs

@@ -0,0 +1 @@
+function s(n,t){if(t!==void 0)return t;let e=n.includes(".")?n.split(".").pop():n;return r(e)}function r(n){let t=n.replace(/([a-z0-9])([A-Z])/g,"$1 $2");return t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()}export{s as tt};

package/locales/languages.json

@@ -0,0 +1,72 @@
+[
+  {
+    "code": "en-US",
+    "native_name": "English (US)",
+    "english_name": "English (US)"
+  },
+  {
+    "code": "en-GB",
+    "native_name": "English (UK)",
+    "english_name": "English (UK)"
+  },
+  {
+    "code": "es-419",
+    "native_name": "Español (Latinoamérica)",
+    "english_name": "Spanish (Latin America)"
+  },
+  {
+    "code": "es-ES",
+    "native_name": "Español (España)",
+    "english_name": "Spanish (Spain)"
+  },
+  {
+    "code": "pt-BR",
+    "native_name": "Português (Brasil)",
+    "english_name": "Portuguese (Brazil)"
+  },
+  { "code": "fr-FR", "native_name": "Français", "english_name": "French" },
+  {
+    "code": "fr-CA",
+    "native_name": "Français (Canada)",
+    "english_name": "French (Canada)"
+  },
+  { "code": "de-DE", "native_name": "Deutsch", "english_name": "German" },
+  { "code": "it-IT", "native_name": "Italiano", "english_name": "Italian" },
+  { "code": "nl-NL", "native_name": "Nederlands", "english_name": "Dutch" },
+  {
+    "code": "zh-CN",
+    "native_name": "简体中文",
+    "english_name": "Chinese (Simplified)"
+  },
+  {
+    "code": "zh-TW",
+    "native_name": "繁體中文",
+    "english_name": "Chinese (Traditional)"
+  },
+  { "code": "ja-JP", "native_name": "日本語", "english_name": "Japanese" },
+  { "code": "ko-KR", "native_name": "한국어", "english_name": "Korean" },
+  { "code": "ar-SA", "native_name": "العربية", "english_name": "Arabic" },
+  { "code": "hi-IN", "native_name": "हिन्दी", "english_name": "Hindi" },
+  { "code": "ru-RU", "native_name": "Русский", "english_name": "Russian" },
+  { "code": "tr-TR", "native_name": "Türkçe", "english_name": "Turkish" },
+  {
+    "code": "id-ID",
+    "native_name": "Bahasa Indonesia",
+    "english_name": "Indonesian"
+  },
+  {
+    "code": "vi-VN",
+    "native_name": "Tiếng Việt",
+    "english_name": "Vietnamese"
+  },
+  { "code": "pl-PL", "native_name": "Polski", "english_name": "Polish" },
+  { "code": "sv-SE", "native_name": "Svenska", "english_name": "Swedish" },
+  { "code": "no-NO", "native_name": "Norsk", "english_name": "Norwegian" },
+  { "code": "da-DK", "native_name": "Dansk", "english_name": "Danish" },
+  { "code": "fi-FI", "native_name": "Suomi", "english_name": "Finnish" },
+  { "code": "th-TH", "native_name": "ไทย", "english_name": "Thai" },
+  { "code": "he-IL", "native_name": "עברית", "english_name": "Hebrew" },
+  { "code": "uk-UA", "native_name": "Українська", "english_name": "Ukrainian" },
+  { "code": "cs-CZ", "native_name": "Čeština", "english_name": "Czech" },
+  { "code": "el-GR", "native_name": "Ελληνικά", "english_name": "Greek" }
+]

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "i18n-boost",
+  "version": "0.1.0",
+  "description": "Automate i18n in TypeScript/JavaScript projects with tt() markers and automatic translation",
+  "type": "module",
+  "bin": {
+    "i18n-boost": "bin/i18n-boost.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./tt": {
+      "types": "./dist/tt.d.ts",
+      "import": "./dist/tt.mjs",
+      "require": "./dist/tt.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "locales",
+    "schema.json"
+  ],
+  "scripts": {
+    "build": "tsup && node -e \"require('fs').cpSync('src/locales', 'locales', {recursive:true})\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "pnpm build && pnpm test",
+    "postinstall": "node ./dist/setup/postinstall.cjs"
+  },
+  "dependencies": {
+    "cac": "^6.7.14",
+    "fast-glob": "^3.3.2",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.30.0",
+    "express": ">=4.18.0",
+    "fastify": ">=4.26.0",
+    "openai": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.30.0",
+    "@types/express": "^4.17.0",
+    "@types/prompts": "^2.4.9",
+    "@types/supertest": "^6.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "express": "^4.18.0",
+    "fastify": "^4.26.0",
+    "openai": "^4.0.0",
+    "supertest": "^7.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "i18n",
+    "i18next",
+    "next-intl",
+    "typescript",
+    "translation",
+    "automation"
+  ],
+  "license": "MIT"
+}

package/schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "i18n-boost configuration",
+  "description": "Configuration schema for i18n-boost (.i18nrc.json)",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["backend", "frontend"],
+      "description": "Project type. 'backend' projects only use sourceLocale; 'frontend' projects translate to targetLocales.",
+      "default": "frontend"
+    },
+    "sourceLocale": {
+      "type": "string",
+      "description": "Source locale code in BCP-47 format with region (default: en-US)",
+      "default": "en-US",
+      "enum": [
+        "en-US", "en-GB", "es-ES", "es-419", "pt-BR",
+        "fr-FR", "fr-CA", "de-DE", "it-IT", "nl-NL",
+        "zh-CN", "zh-TW", "ja-JP", "ko-KR", "ar-SA",
+        "hi-IN", "ru-RU", "tr-TR", "id-ID", "vi-VN",
+        "pl-PL", "sv-SE", "no-NO", "da-DK", "fi-FI",
+        "th-TH", "he-IL", "uk-UA", "cs-CZ", "el-GR"
+      ]
+    },
+    "targetLocales": {
+      "type": "array",
+      "description": "Target locale codes to translate to (BCP-47 with region)",
+      "default": [],
+      "items": {
+        "type": "string",
+        "enum": [
+          "en-US", "en-GB", "es-ES", "es-419", "pt-BR",
+          "fr-FR", "fr-CA", "de-DE", "it-IT", "nl-NL",
+          "zh-CN", "zh-TW", "ja-JP", "ko-KR", "ar-SA",
+          "hi-IN", "ru-RU", "tr-TR", "id-ID", "vi-VN",
+          "pl-PL", "sv-SE", "no-NO", "da-DK", "fi-FI",
+          "th-TH", "he-IL", "uk-UA", "cs-CZ", "el-GR"
+        ]
+      }
+    },
+    "include": {
+      "type": "array",
+      "description": "Glob patterns for source files to scan for tt() markers",
+      "default": ["src/**/*.{ts,tsx,js,jsx}"],
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "exclude": {
+      "type": "array",
+      "description": "Glob patterns to exclude from scanning (takes precedence over include)",
+      "default": ["**/*.spec.*", "**/*.test.*", "**/*.d.ts", "**/node_modules/**", "**/.git/**"],
+      "items": { "type": "string" }
+    },
+    "outputDir": {
+      "type": "string",
+      "description": "Output directory for locale files (created automatically if absent)",
+      "default": "src/locales"
+    },
+    "outputFormat": {
+      "type": "string",
+      "enum": ["flat", "nested"],
+      "description": "JSON structure format. 'flat': { \"a.b\": \"v\" }  |  'nested': { \"a\": { \"b\": \"v\" } }. Only applies to i18next preset.",
+      "default": "nested"
+    },
+    "preset": {
+      "type": "string",
+      "enum": ["i18next", "next-intl"],
+      "description": "i18n runtime preset that determines the output format and conventions",
+      "default": "i18next"
+    },
+    "provider": {
+      "type": "object",
+      "description": "Translation provider configuration. API keys are read from environment variables, not stored here.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "enum": ["anthropic", "openai", "deepl", "libre-translate", "backend", "none"],
+          "description": "Translation provider to use"
+        },
+        "model": {
+          "type": "string",
+          "description": "Model identifier (anthropic and openai providers). Defaults: anthropic → claude-haiku-4-5-20251001, openai → gpt-4o-mini"
+        },
+        "baseUrl": {
+          "type": "string",
+          "description": "Base URL for OpenAI-compatible APIs (DeepSeek, Groq, Qwen, Ollama, etc.)"
+        },
+        "apiUrl": {
+          "type": "string",
+          "description": "Endpoint URL for libre-translate. Default: https://libretranslate.com/translate"
+        },
+        "url": {
+          "type": "string",
+          "description": "URL of your backend translation endpoint (required when name is 'backend')"
+        },
+        "secret": {
+          "type": "string",
+          "description": "Shared secret sent as x-i18n-secret header to your backend endpoint"
+        }
+      },
+      "required": ["name"],
+      "if": { "properties": { "name": { "const": "backend" } }, "required": ["name"] },
+      "then": { "required": ["url"] }
+    },
+    "transform": {
+      "type": "object",
+      "description": "Transform configuration for replacing tt() calls with t() after generation",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "If true, every 'generate' run also transforms tt() → t()",
+          "default": false
+        },
+        "importSource": {
+          "type": "string",
+          "description": "Module from which the t() function is imported after transform",
+          "default": "i18next"
+        },
+        "functionName": {
+          "type": "string",
+          "description": "Name of the target translation function (almost always 't')",
+          "default": "t"
+        }
+      }
+    }
+  },
+  "required": ["sourceLocale"]
+}