locale-ai 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +15 -0
  2. package/dist/cli.js +0 -0
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # locale-ai
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/locale-ai.svg)](https://www.npmjs.com/package/locale-ai)
4
+ [![npm downloads](https://img.shields.io/npm/dm/locale-ai.svg)](https://www.npmjs.com/package/locale-ai)
5
+ [![CI](https://github.com/khabouss/locale-ai/actions/workflows/ci.yml/badge.svg)](https://github.com/khabouss/locale-ai/actions/workflows/ci.yml)
6
+ [![license](https://img.shields.io/npm/l/locale-ai.svg)](LICENSE)
7
+ [![node](https://img.shields.io/node/v/locale-ai.svg)](package.json)
8
+
3
9
  Translate your i18n JSON locale files **locally, on CPU, for free**. No API keys, no Python, nothing leaves your machine.
4
10
 
5
11
  ```bash
@@ -27,6 +33,15 @@ Download 346 MB? (Y/n)
27
33
  - **Incremental**: only missing keys are translated, existing translations are kept, re-runs are no-ops. `--overwrite` re-translates everything.
28
34
  - **Structure**: key order, numbers, booleans, arrays, indentation and trailing newline are preserved.
29
35
 
36
+ ## Why locale-ai?
37
+
38
+ - **No API keys, no cloud bill.** Google/DeepL/OpenAI-based translation tools work well but mean an account, a key, a per-character cost, and your strings leaving your machine. locale-ai runs the model on your own CPU.
39
+ - **Built for i18n files, not plain text.** General MT tools translate strings; they don't know that `{count}`, `<0>bold</0>`, or `$t(common.footer.tagline)` must survive untouched. locale-ai is built around i18next/ICU conventions specifically, so placeholders, plurals, and nested references come out intact instead of mangled or dropped.
40
+ - **Incremental by default.** Add one new key to `en.json` and only that key gets translated — existing translations in `fr.json`/`es.json`/etc. are left alone, so re-runs are cheap and safe to automate in CI.
41
+ - **Honest about quality.** The [Languages](#languages) section tells you which pairs are review-light vs. which need a human pass, instead of presenting every language as equally production-ready.
42
+
43
+ **When *not* to use it**: if you need professional/legal-grade translation, or languages outside the [supported list](#languages), use a human translator or a larger cloud model instead — locale-ai is built for keeping UI strings in sync across languages during development, with a review pass before shipping.
44
+
30
45
  ## Commands
31
46
 
32
47
  ```bash
package/dist/cli.js CHANGED
File without changes
package/package.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "name": "locale-ai",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "Translate your i18n locale files locally on CPU. Free, offline, no API keys.",
5
5
  "author": "Taha KHABOUSS",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "git+https://github.com/khabouss/i18nAI.git"
8
+ "url": "git+https://github.com/khabouss/locale-ai.git"
9
9
  },
10
- "homepage": "https://github.com/khabouss/i18nAI#readme",
10
+ "homepage": "https://github.com/khabouss/locale-ai#readme",
11
11
  "bugs": {
12
- "url": "https://github.com/khabouss/i18nAI/issues"
12
+ "url": "https://github.com/khabouss/locale-ai/issues"
13
13
  },
14
14
  "type": "module",
15
15
  "bin": {