@scopeact/autoi18n 1.1.1 → 1.2.0

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/auto-i18n/auto-i18n/packages/autoi18n/dist/server.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,qGAAC","file":"/home/runner/work/auto-i18n/auto-i18n/packages/autoi18n/dist/server.cjs"}

package/dist/server.d.cts

@@ -0,0 +1,10 @@
+declare function getI18nConfig(defaultLang?: string): Promise<{
+    locale: any;
+    messages: Record<string, string>;
+}>;
+declare function getI18n(): Promise<{
+    t: (key: string) => string;
+    locale: any;
+}>;
+
+export { getI18n, getI18nConfig };

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+declare function getI18nConfig(defaultLang?: string): Promise<{
+    locale: any;
+    messages: Record<string, string>;
+}>;
+declare function getI18n(): Promise<{
+    t: (key: string) => string;
+    locale: any;
+}>;
+
+export { getI18n, getI18nConfig };

package/dist/server.js

@@ -0,0 +1,9 @@
+import {
+  getI18n,
+  getI18nConfig
+} from "./chunk-VBBY4GSW.js";
+export {
+  getI18n,
+  getI18nConfig
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,26 +1,79 @@
-{
-  "name": "@scopeact/autoi18n",
-  "version": "1.1.1",
-  "type": "module",
-  "bin": {
-    "@scopeact/autoi18n": "./dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/felipevetter/auto-i18n.git"
-  },
-  "dependencies": {
-    "@scopeact/autoi18n-core": "*",
-    "commander": "^14.0.2",
-    "chalk": "^5.6.2",
-    "dotenv": "^17.2.3",
-    "ora": "^9.0.0",
-    "ts-morph": "^27.0.2"
-  }
-}
+{
+    "name": "@scopeact/autoi18n",
+    "version": "1.2.0",
+    "description": "Auto i18n tool",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/felipevetter/auto-i18n.git"
+    },
+    "bin": {
+        "@scopeact/autoi18n": "./dist/cli.js"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs"
+        },
+        "./core": {
+            "types": "./dist/core/index.d.ts",
+            "import": "./dist/core/index.js",
+            "require": "./dist/core/index.cjs"
+        },
+        "./server": {
+            "types": "./dist/server.d.ts",
+            "import": "./dist/server.js",
+            "require": "./dist/server.cjs"
+        },
+        "./client": {
+            "types": "./dist/client.d.ts",
+            "import": "./dist/client.js",
+            "require": "./dist/client.cjs"
+        }
+    },
+    "files": [
+        "dist",
+        "schema.json"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "lint": "tsc --noEmit"
+    },
+    "keywords": [
+        "i18n",
+        "translation",
+        "automation",
+        "ai"
+    ],
+    "author": "Felipe Vetter",
+    "license": "MIT",
+    "peerDependencies": {
+        "next": ">=13.0.0",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
+    },
+    "dependencies": {
+        "@google/generative-ai": "^0.24.1",
+        "chalk": "^5.6.2",
+        "commander": "^14.0.2",
+        "dotenv": "^17.2.3",
+        "openai": "^6.14.0",
+        "ora": "^9.0.0",
+        "ts-morph": "^27.0.2"
+    },
+    "devDependencies": {
+        "@types/node": "^25.0.3",
+        "@types/react": "^19.2.7",
+        "@types/react-dom": "^19.2.3",
+        "next": "^16.1.1",
+        "react": "^19.2.3",
+        "react-dom": "^19.2.3",
+        "tsup": "^8.5.1",
+        "typescript": "^5.9.3"
+    }
+}

package/schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Auto i18n Config",
+  "type": "object",
+  "properties": {
+    "sourceLang": {
+      "type": "string",
+      "description": "O idioma de origem dos textos no seu código.",
+      "default": "pt"
+    },
+    "targetLangs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Lista de idiomas para os quais você deseja traduzir."
+    },
+    "files": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Glob patterns dos arquivos que o CLI deve escanear.",
+      "default": ["src/**/*.tsx"]
+    },
+    "autoInject": {
+      "type": "boolean",
+      "description": "Se deve automaticamente injetar no topo do arquivo o import de i18n (caso não exista).",
+      "default": true
+    },
+    "i18nLibrary": {
+      "type": "string",
+      "description": "A biblioteca de i18n que será utilizada.",
+      "default": "react-i18next",
+      "enum": ["react-i18next", "next-i18n"]
+    },
+    "provider": {
+      "type": "string",
+      "description": "O Provider de IA que será utilizado para tradução.",
+      "default": "openai",
+      "enum": ["openai", "google", "deepseek", "openrouter", "ollama"]
+    },
+    "model": {
+      "type": "string",
+      "description": "O modelo de IA que será utilizado para tradução.",
+      "default": "gpt-3.5-turbo"
+    },
+    "localesDir": {
+      "type": "string",
+      "description": "O diretório onde os arquivos JSON de tradução estão localizados.",
+      "default": "./locales"
+    }
+  },
+  "required": ["sourceLang", "targetLangs", "localesDir"]
+}

package/README.md

@@ -1,256 +0,0 @@
-# @scopeact/autoi18n
-
-[![npm version](https://img.shields.io/npm/v/@scopeact/autoi18n.svg)](https://www.npmjs.com/package/@scopeact/autoi18n)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-> CLI to automatically migrate React / TypeScript projects to i18n using AST and LLMs.
-
-**auto-i18n** scans TS/TSX files, extracts hardcoded strings, replaces them with `t("key")`, generates translation files, and optionally injects the correct i18n imports — all with explicit, opinionated trade-offs.
-
-This is a **migration tool**, not a runtime framework.
-
----
-
-## Why this exists
-
-Internationalizing a React codebase usually means:
-
-* Manually hunting hardcoded strings
-* Guessing translation keys
-* Rewriting components by hand
-* Copy-pasting JSON across languages
-
-It’s repetitive, boring, and easy to screw up.
-
-**auto-i18n automates the mechanical work and delegates semantic decisions to an LLM.**
-
----
-
-## What this tool does
-
-* Parses **TypeScript and TSX using AST** (no regex hacks)
-* Detects static hardcoded strings
-* Rewrites code to use `t("key")`
-* Generates translation files
-* Uses an **LLM to generate semantic translation keys**
-* Optionally injects i18n imports automatically
-* Supports different i18n libraries
-
----
-
-## Installation
-
-No global install required:
-
-```bash
-npx @scopeact/auto-i18n init
-```
-
----
-
-## Usage
-
-### 1. Initialize configuration
-
-```bash
-npx @scopeact/auto-i18n init
-```
-
-This creates:
-
-* `auto-i18n.config.json`
-
----
-
-### 2. Run the migration
-
-```bash
-npx @scopeact/auto-i18n run
-```
-
-The tool will:
-
-1. Parse files into AST
-2. Detect static string literals
-3. Ask the LLM to infer **semantic translation keys**
-4. Rewrite source code
-5. Inject i18n imports if missing
-6. Generate translation files
-
----
-
-## Example
-
-### Before
-
-```tsx
-export function Home() {
-  return (
-    <div>
-      <h1>Hello world</h1>
-      <p>Welcome to our platform</p>
-    </div>
-  );
-}
-```
-
-### After
-
-```tsx
-import { useTranslation } from "react-i18next";
-
-export function Home() {
-  return (
-    <div>
-      <h1>{t("greeting")}</h1>
-      <p>{t("description")}</p>
-    </div>
-  );
-}
-```
-
-Generated translation file:
-
-```json
-{
-  "greeting": "Hello world",
-  "description": "Welcome to our platform"
-}
-```
-
----
-
-## Configuration
-
-Example `auto-i18n.config.json`:
-
-```json
-{
-  "sourceLang": "pt",
-  "targetLangs": [ "en", "es", "de" ],
-  "autoInject": true,
-  "i18nLibrary": "react-i18next",
-  "provider": "ollama",
-  "localesDir": "./locales",
-  "model": "gemma3-translator",
-  "files": [ "**/*.tsx" ]
-}
-```
-
-### Options
-
-#### `autoInject`
-
-```json
-{
-  "autoInject": true
-}
-```
-
-Automatically injects the required i18n import at the top of the file **if it does not already exist**.
-
-This avoids manual setup and keeps the migration fully automated.
-
----
-
-#### `i18nLibrary`
-
-```json
-{
-  "i18nLibrary": "react-i18next"
-}
-```
-
-Defines which i18n library should be used when injecting imports and hooks.
-
-Supported values:
-
-* `react-i18next`
-* `next-i18n`
-
-This affects:
-
-* import statements
-* generated code structure
-
----
-
-## Why keys are AI-generated (no dry-run)
-
-Translation key naming is a **semantic problem**, not a mechanical one.
-
-For example:
-
-* Is `"Hello world"` a title, a CTA, or a heading?
-* Does it belong to `home`, `layout`, or `marketing`?
-
-These decisions cannot be inferred deterministically.
-
-**auto-i18n intentionally requires an LLM to:**
-
-* infer intent
-* generate meaningful keys
-* avoid arbitrary conventions
-
-Because of this, a traditional dry-run would produce **misleading results** and is intentionally not supported.
-
-This trade-off is explicit.
-
----
-
-## Why AST instead of regex
-
-Regex does not understand JSX or TypeScript.
-
-AST parsing:
-
-* Preserves syntax structure
-* Avoids accidental replacements
-* Handles real-world React code
-* Produces predictable transformations
-
-This tool is designed for **production codebases**, not demos.
-
----
-
-## Limitations
-
-This tool does **not** handle:
-
-* Dynamic strings (`"Hello " + name`)
-* Template literals with expressions
-* Runtime-generated text
-* Context-dependent translations
-
-It is meant to **bootstrap i18n**, not replace human review.
-
----
-
-## When you should NOT use this
-
-* Your project already has a mature i18n setup
-* Translations depend heavily on runtime logic
-* You expect zero review after migration
-
----
-
-## Design philosophy
-
-* Explicit over clever
-* Predictable over magical
-* Narrow scope over feature bloat
-
-This tool solves **one specific problem**, deliberately.
-
----
-
-## License
-
-Distributed under MIT license. See [LICENSE](LICENSE) for more details.
-
----
-
-## 🇧🇷 Nota
-
-README principal em inglês por usabilidade global.
-Português aqui só pra lembrar que esse projeto nasceu no Brasil.

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}