gpt-po 1.2.3 → 1.3.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm install *)"
+    ]
+  }
+}

package/README.md

@@ -5,6 +5,8 @@
 
 Translation tool for gettext (po) files that supports custom system prompts and user dictionaries. It also supports translating specified po files to a designated target language and updating po files based on pot files.
 
+**Supported LLM Providers:** OpenAI (GPT), Anthropic (Claude), and Google (Gemini)
+
 Read in other languages: English | [简体中文](./README_zh-CN.md)
 
 <a href="https://buymeacoffee.com/ryanhex" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-red.png" alt="Buy Me A Coffee" height="41" width="174"></a>
@@ -15,9 +17,18 @@ Read in other languages: English | [简体中文](./README_zh-CN.md)
 npm install gpt-po
 ```
 
-Set `OPENAI_API_KEY` before using this tool.
+Set `API_KEY` before using this tool. Depending on the provider, use `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or `GEMINI_API_KEY`.
+
+**It is recommended to use paid APIs to improve translation speed, as free tiers are often slower and have usage restrictions.**
 
-**It is recommended to use the paid OpenAI API to improve translation speed, as the free OpenAI API is slower (only 3 translations per minute) and has usage restrictions.**
+### Environment Variables
+- `OPENAI_API_KEY`: OpenAI API key.
+- `OPENAI_API_HOST`: OpenAI API host (default: `https://api.openai.com`).
+- `ANTHROPIC_API_KEY`: Anthropic API key.
+- `ANTHROPIC_API_HOST`: Anthropic API host.
+- `GEMINI_API_KEY`: Google Gemini API key.
+- `GEMINI_API_HOST`: Google Gemini API host.
+- `MODEL_TMP`: Model temperature (default: 0.1). This will override provider-specific temperature settings.
 
 ## Usage Scenarios
 
@@ -51,9 +62,10 @@ Usage: gpt-po [options]
 translate po file (default command)
 
 Options:
-  -k, --key <key>        openai api key (env: OPENAI_API_KEY)
-  --host <host>          openai api host (env: OPENAI_API_HOST)
-  --model <model>        openai model (default: "gpt-4o-mini", env: OPENAI_MODEL)
+  -p, --provider <provider>  API provider (choices: "openai", "anthropic", "gemini", default: "openai")
+  -k, --key <key>            API key (can also be set via OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY)
+  --host <host>              API host (can also be set via OPENAI_API_HOST, ANTHROPIC_API_HOST, GEMINI_API_HOST)
+  --model <model>            Model to use (default: gpt-5-nano for openai, claude-haiku-4-5 for anthropic, gemini-2.5-flash for gemini, env: MODEL)
   --po <file>            po file path
   --dir <dir>            po file directory
   -src, --source <lang>  source language (default: "english")
@@ -61,6 +73,8 @@ Options:
   -l, --lang <lang>      target language (ISO 639-1 code)
   -o, --output <file>    output file path, overwirte po file by default
   --context <file>       context file path (provides additional context to the bot)
+  --context-length <length>  Maximum accumulated length of source strings (msgid) to translate in each API request (default: 2000, env: API_CONTEXT_LENGTH)
+  --timeout <ms>         Timeout in milliseconds for API requests (default: 20000, env: API_TIMEOUT)
   -h, --help             display help for command
 ```
 
@@ -90,4 +104,4 @@ Options:
   --po <file>   po file path
   --pot <file>  pot file path
   -h, --help    display help for command
-```
+```

package/README_zh-CN.md

@@ -5,6 +5,8 @@
 
 gettext(po)文件翻译工具，支持自定义系统提示词和用户字典，支持翻译指定的po文件到指定的目标语言，支持根据pot文件更新po文件。
 
+**支持的LLM提供商：** OpenAI (GPT)、Anthropic (Claude) 和 Google (Gemini)
+
 使用其他语言阅读：[English](./README.md) | 简体中文
 
 <a href="https://buymeacoffee.com/ryanhex" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-red.png" alt="请我喝杯咖啡" height="41" width="174"></a>
@@ -15,11 +17,20 @@ gettext(po)文件翻译工具，支持自定义系统提示词和用户字典，
 npm install gpt-po
 ```
 
-使用此工具前先设置 `OPENAI_API_KEY`，Windows中使用 `set OPENAI_API_KEY=<key>`, Linux中 `export OPENAI_API_KEY=<key>`
+使用此工具前先设置 `API_KEY`，根据不同的提供商，使用 `OPENAI_API_KEY`，`ANTHROPIC_API_KEY` 或 `GEMINI_API_KEY`。
+
+**建议使用付费API以提高翻译速度，免费API速度较慢且有使用限制。**
 
-**建议使用付费的OpenAI API以提高翻译速度，免费的OpenAI API速度较慢（一分钟3条一天200条），且有使用限制。**
+*国内用户要设置`HTTPS_PROXY`环境变量上代理才能用，或者配置使用代理服务的HOST*
 
-*国内用户要设置`HTTPS_PROXY`环境变量上梯子才能用*
+### 环境变量
+- `OPENAI_API_KEY`: OpenAI API密钥。
+- `OPENAI_API_HOST`: OpenAI API主机（默认：`https://api.openai.com`）。
+- `ANTHROPIC_API_KEY`: Anthropic API密钥。
+- `ANTHROPIC_API_HOST`: Anthropic API主机。
+- `GEMINI_API_KEY`: Google Gemini API密钥。
+- `GEMINI_API_HOST`: Google Gemini API主机。
+- `MODEL_TMP`: 模型温度（默认：0.1）。这将覆盖特定于提供商的温度设置。
 
 ## 常见用法
 
@@ -53,9 +64,10 @@ npm install gpt-po
 翻译 po 文件（默认命令）
 
 选项:
-  -k, --key <key>        openai api key (环境变量: OPENAI_API_KEY)
-  --host <host>          openai api host (环境变量: OPENAI_API_HOST)
-  --model <model>        openai 模型 (默认: "gpt-4o-mini", 环境变量: OPENAI_MODEL)
+  -p, --provider <provider>  API 提供商 (可选: "openai", "anthropic", "gemini", 默认: "openai")
+  -k, --key <key>            API 密钥 (也可通过 OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY 设置)
+  --host <host>              API 主机 (也可通过 OPENAI_API_HOST, ANTHROPIC_API_HOST, GEMINI_API_HOST 设置)
+  --model <model>            要使用的模型 (默认: openai 为 gpt-5-nano, anthropic 为 claude-haiku-4-5, gemini 为 gemini-2.5-flash, 环境变量: MODEL)
   --po <file>            po 文件路径
   --dir <dir>            po 文件目录
   -src, --source <lang>  源语言 (默认: "english")
@@ -63,6 +75,8 @@ npm install gpt-po
   -l, --lang <lang>      目标语言 (ISO 639-1 代码)
   -o, --output <file>    输出文件路径，默认覆盖 po 文件
   --context <file>       上下文文件路径（为机器人提供额外的上下文）
+  --context-length <length>  每次 API 请求中源字符串（msgid）的最大累计长度（默认：2000，环境变量：API_CONTEXT_LENGTH）
+  --timeout <ms>         API 请求超时时间（单位：毫秒，默认：20000，环境变量：API_TIMEOUT）
   -h, --help             显示命令帮助
 ```
 

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gpt-po",
-    "version": "1.2.3",
+    "version": "1.3.0",
     "description": "command tool for translate po files by gpt",
     "main": "lib/src/index.js",
     "type": "module",
@@ -11,7 +11,7 @@
         "start": "node lib/src/index.js",
         "test": "echo \"Error: no test specified\" && exit 1",
         "prebuild": "rimraf ./lib",
-        "build": "tsc",
+        "build": "tsc -p tsconfig.json",
         "postbuild": "ncp ./src/ ./lib/src/ \"--filter=^(?!.*\\.ts$).*$\"",
         "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
         "lint": "tslint -p tsconfig.json"
@@ -34,7 +34,7 @@
         "openai"
     ],
     "devDependencies": {
-        "@types/gettext-parser": "^4.0.4",
+        "@types/gettext-parser": "^9.0.0",
         "@types/jest": "^29.5.12",
         "jest": "^29.7.0",
         "ncp": "^2.0.0",
@@ -46,11 +46,13 @@
         "typescript": "^5.5.4"
     },
     "dependencies": {
+        "@anthropic-ai/sdk": "^0.99.0",
+        "@google/genai": "^2.6.0",
         "commander": "^12.1.0",
-        "gettext-parser": "^8.0.0",
-        "openai": "^4.56.0"
+        "gettext-parser": "^9.0.1",
+        "openai": "^6.39.0"
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     }
 }

package/lib/src/index.js

@@ -30,37 +30,58 @@ class SharedOptionsCommand extends Command {
 }
 const translateCommand = new SharedOptionsCommand("translate")
     .description("translate po file (default command)")
-    .addOption(new Option("-k, --key <key>", "openai api key").env("OPENAI_API_KEY"))
-    .addOption(new Option("--host <host>", "openai api host").env("OPENAI_API_HOST"))
-    .addOption(new Option("--model <model>", "openai model").env("OPENAI_MODEL").default("gpt-4o-mini"))
+    .addOption(new Option("-p, --provider <provider>", "api provider").choices(["openai", "anthropic", "gemini"]).default("openai"))
+    .addOption(new Option("-k, --key <key>", "api key (can also be set via OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY)"))
+    .addOption(new Option("--host <host>", "api host (can also be set via OPENAI_API_HOST, ANTHROPIC_API_HOST, GEMINI_API_HOST)"))
+    .addOption(new Option("--model <model>", "model to use (default: gpt-5-nano for openai, claude-haiku-4-5 for anthropic, gemini-2.5-flash for gemini)"))
     .addOption(new Option("--po <file>", "po file path").conflicts("dir"))
     .addOption(new Option("--dir <dir>", "po file directory").conflicts("po"))
     .option("-src, --source <lang>", "source language (ISO 639-1)", "en")
     .option("-l, --lang <lang>", "target language (ISO 639-1)")
     .option("--verbose", "print verbose log")
     .option("--context <file>", "text file that provides the bot additional context")
+    .addOption(new Option("--context-length <length>", "maximum accumulated length of source strings (msgid) to translate in each API request").env("API_CONTEXT_LENGTH").default("2000"))
+    .addOption(new Option("--timeout <ms>", "timeout in milliseconds for API requests").env("API_TIMEOUT").default("20000"))
     .addOption(new Option("-o, --output <file>", "output file path, overwirte po file by default").conflicts("dir"))
     .addCompileOptions()
     .action(async (args) => {
-    const { key, host, model, po, dir, source, lang, verbose, output, context } = args;
+    const { provider, key, host, model, po, dir, source, lang, verbose, output, context, contextLength, timeout } = args;
     if (host) {
-        process.env.OPENAI_API_HOST = host;
+        if (provider === "openai")
+            process.env.OPENAI_API_HOST = host;
+        if (provider === "anthropic")
+            process.env.ANTHROPIC_API_HOST = host;
+        if (provider === "gemini")
+            process.env.GEMINI_API_HOST = host;
     }
     if (key) {
-        process.env.OPENAI_API_KEY = key;
+        if (provider === "openai")
+            process.env.OPENAI_API_KEY = key;
+        if (provider === "anthropic")
+            process.env.ANTHROPIC_API_KEY = key;
+        if (provider === "gemini")
+            process.env.GEMINI_API_KEY = key;
     }
-    // process.env.OPENAI_API_KEY is not set, exit
-    if (!process.env.OPENAI_API_KEY) {
+    if (provider === "openai" && !process.env.OPENAI_API_KEY) {
         console.error("OPENAI_API_KEY is required");
         process.exit(1);
     }
-    init();
+    if (provider === "anthropic" && !process.env.ANTHROPIC_API_KEY) {
+        console.error("ANTHROPIC_API_KEY is required");
+        process.exit(1);
+    }
+    if (provider === "gemini" && !process.env.GEMINI_API_KEY) {
+        console.error("GEMINI_API_KEY is required");
+        process.exit(1);
+    }
+    const finalModel = model || process.env.MODEL || process.env.OPENAI_MODEL || (provider === "anthropic" ? "claude-haiku-4-5" : provider === "gemini" ? "gemini-2.5-flash" : "gpt-5-nano");
+    init(provider);
     const compileOptions = getCompileOptions(args);
     if (po) {
-        await translatePo(model, po, source, lang, verbose, output, context, compileOptions);
+        await translatePo(provider, finalModel, po, source, lang, verbose, output, context, parseInt(contextLength), parseInt(timeout), compileOptions);
     }
     else if (dir) {
-        await translatePoDir(model, dir, source, lang, verbose, context, compileOptions);
+        await translatePoDir(provider, finalModel, dir, source, lang, verbose, context, parseInt(contextLength), parseInt(timeout), compileOptions);
     }
     else {
         console.error("po file or directory is required");

package/lib/src/manipulate.js

@@ -15,10 +15,6 @@ export function removeByOptions(potrans, options) {
             if (options?.fuzzy && fuzzyRegx.test(entry.comments?.flag || "")) {
                 delete potrans.translations[ctx][msgid];
             }
-            // remove obsolete
-            if (options?.obsolete && obsoleteRegx.test(entry.comments?.flag || "")) {
-                delete potrans.translations[ctx][msgid];
-            }
             // remove untranslated
             if (options?.untranslated && msgstr.length === 0) {
                 delete potrans.translations[ctx][msgid];
@@ -48,6 +44,8 @@ export function removeByOptions(potrans, options) {
             }
         }
     }
+    if (options?.obsolete && potrans.obsolete)
+        delete potrans.obsolete;
     return potrans;
 }
 //# sourceMappingURL=manipulate.js.map

package/lib/src/sync.d.ts

@@ -1,2 +1,2 @@
-import { CompileOptions } from "./utils.js";
-export declare function sync(po: string, pot: string, compileOptions?: CompileOptions): Promise<void>;
+import { GetTextPoCompilerOptions } from "gettext-parser";
+export declare function sync(po: string, pot: string, compileOptions?: GetTextPoCompilerOptions): Promise<void>;

package/lib/src/translate.d.ts

@@ -1,7 +1,5 @@
-import { GetTextTranslation } from "gettext-parser";
-import { OpenAI } from "openai";
-import { CompileOptions } from "./utils.js";
-export declare function init(force?: boolean): OpenAI;
-export declare function translate(src: string, lang: string, model: string, translations: GetTextTranslation[], contextFile: string): Promise<void>;
-export declare function translatePo(model: string, po: string, source: string, lang: string, verbose: boolean, output: string, contextFile: string, compileOptions?: CompileOptions): Promise<void>;
-export declare function translatePoDir(model: string | undefined, dir: string, source: string, lang: string, verbose: boolean, contextFile: string, compileOptions?: CompileOptions): Promise<void>;
+import { GetTextPoCompilerOptions, GetTextTranslation } from "gettext-parser";
+export declare function init(provider: string, force?: boolean): void;
+export declare function translate(provider: string, src: string, lang: string, model: string, translations: GetTextTranslation[], contextFile: string, timeout: number): Promise<void>;
+export declare function translatePo(provider: string, model: string, po: string, source: string, lang: string, verbose: boolean, output: string, contextFile: string, contextLength: number, timeout: number, compileOptions?: GetTextPoCompilerOptions): Promise<void>;
+export declare function translatePoDir(provider: string, model: string, dir: string, source: string, lang: string, verbose: boolean, contextFile: string, contextLength: number, timeout: number, compileOptions?: GetTextPoCompilerOptions): Promise<void>;

package/lib/src/translate.js

@@ -1,5 +1,7 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { GoogleGenAI } from "@google/genai";
 import * as fs from "fs";
-import { OpenAI } from "openai";
+import OpenAI from "openai";
 import path from "path";
 import { fileURLToPath } from "url";
 import pkg from "../package.json" with { type: "json" };
@@ -7,18 +9,36 @@ import { compilePo, copyFileIfNotExists, findConfig, parsePo, printProgress } fr
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 let _openai;
+let _anthropic;
+let _gemini;
 let _systemprompt;
 let _userprompt;
 let _userdict;
-export function init(force) {
-    if (!_openai || force) {
-        let configuration = {
-            apiKey: process.env.OPENAI_API_KEY
+export function init(provider, force) {
+    if (provider === "openai" && (!_openai || force)) {
+        _openai = new OpenAI({
+            apiKey: process.env.OPENAI_API_KEY,
+            baseURL: process.env.OPENAI_API_HOST
+                ? process.env.OPENAI_API_HOST.replace(/\/+$/, "") + "/v1"
+                : undefined
+        });
+    }
+    else if (provider === "anthropic" && (!_anthropic || force)) {
+        _anthropic = new Anthropic({
+            apiKey: process.env.ANTHROPIC_API_KEY,
+            baseURL: process.env.ANTHROPIC_API_HOST ? process.env.ANTHROPIC_API_HOST.replace(/\/+$/, "") : undefined
+        });
+    }
+    else if (provider === "gemini" && (!_gemini || force)) {
+        const options = {
+            apiKey: process.env.GEMINI_API_KEY || ""
         };
-        _openai = new OpenAI(configuration);
-        if (process.env.OPENAI_API_HOST) {
-            _openai.baseURL = process.env.OPENAI_API_HOST.replace(/\/+$/, "") + "/v1";
+        if (process.env.GEMINI_API_HOST) {
+            options.httpOptions = {
+                baseUrl: process.env.GEMINI_API_HOST.replace(/\/+$/, "")
+            };
         }
+        _gemini = new GoogleGenAI(options);
     }
     // load systemprompt.txt from project
     if (!_systemprompt || force) {
@@ -34,9 +54,8 @@ export function init(force) {
         copyFileIfNotExists(userdict, path.join(__dirname, "dictionary.json"));
         _userdict = { default: JSON.parse(fs.readFileSync(userdict, "utf-8")) };
     }
-    return _openai;
 }
-export async function translate(src, lang, model, translations, contextFile) {
+export async function translate(provider, src, lang, model, translations, contextFile, timeout) {
     const lang_code = lang
         .toLowerCase()
         .trim()
@@ -48,56 +67,98 @@ export async function translate(src, lang, model, translations, contextFile) {
         }
         return acc;
     }, { user: [], assistant: [] });
-    const notes = translations
-        .reduce((acc, tr) => {
-        if (tr.comments?.extracted) {
-            acc.push(tr.comments?.extracted);
-        }
-        return acc;
-    }, [])
-        .join("\n");
+    const escapePseudoXmlAttr = (value) => String(value)
+        .replace(/&/g, "&")
+        .replace(/"/g, """)
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/\r?\n/g, " &#10; ");
     const context = contextFile ? "\n\nContext: " + fs.readFileSync(contextFile, "utf-8") : "";
     const translationsContent = translations
         .map((tr, idx) => {
-        const contextAttr = tr.msgctxt ? ` context="${tr.msgctxt}"` : "";
-        return `<translate index="${idx + dicts.user.length + 1}"${contextAttr}>${tr.msgid}</translate>`;
+        const contextAttr = tr.msgctxt ? ` context="${escapePseudoXmlAttr(tr.msgctxt)}"` : "";
+        const noteAttr = tr.comments?.extracted ? ` note="${escapePseudoXmlAttr(tr.comments.extracted)}"` : "";
+        return `<translate index="${idx + dicts.user.length + 1}"${contextAttr}${noteAttr}>${tr.msgid}</translate>`;
     })
         .join("\n");
-    const res = await _openai.chat.completions.create({
-        model: model,
-        temperature: 0.1,
-        messages: [
-            {
-                role: "system",
-                content: _systemprompt + context
-            },
-            {
-                role: "user",
-                content: `${_userprompt}\n\nWait for my incoming message in "${src}" and translate it into "${lang}"(a language code and an optional region code). ` +
-                    notes
-            },
-            {
-                role: "assistant",
-                content: `Understood, I will translate your incoming "${src}" message into "${lang}", carefully following guidelines. Please go ahead and send your message for translation.`
-            },
-            // add userdict
+    const temperature = process.env.MODEL_TMP
+        ? parseFloat(process.env.MODEL_TMP)
+        : process.env.OPENAI_MODEL_TMP
+            ? parseFloat(process.env.OPENAI_MODEL_TMP)
+            : 0.1;
+    const systemContent = _systemprompt + context;
+    const initialUserContent = `${_userprompt}\n\nWait for my incoming message(s) in \`${src}\` and translate them into \`${lang}\` (\`${src}\` and \`${lang}\` are XPG/POSIX locale names, used in Unix-like systems and GNU Gettext).`;
+    const initialAssistantContent = `Understood, I will translate your incoming \`${src}\` message(s) into \`${lang}\`, carefully following guidelines. Please go ahead and send your message(s) for translation.`;
+    let content = "";
+    if (provider === "openai") {
+        const messages = [
+            { role: "system", content: systemContent },
+            { role: "user", content: initialUserContent },
+            { role: "assistant", content: initialAssistantContent },
             ...(dicts.user.length > 0
                 ? [
                     { role: "user", content: dicts.user.join("\n") },
                     { role: "assistant", content: dicts.assistant.join("\n") }
                 ]
                 : []),
-            // add user translations
-            {
-                role: "user",
-                content: translationsContent
+            { role: "user", content: translationsContent }
+        ];
+        const res = await _openai.chat.completions.create({ model, temperature, messages }, { timeout, stream: false });
+        content = res.choices[0].message.content ?? "";
+    }
+    else if (provider === "anthropic") {
+        const messages = [
+            { role: "user", content: initialUserContent },
+            { role: "assistant", content: initialAssistantContent },
+            ...(dicts.user.length > 0
+                ? [
+                    { role: "user", content: dicts.user.join("\n") },
+                    { role: "assistant", content: dicts.assistant.join("\n") }
+                ]
+                : []),
+            { role: "user", content: translationsContent }
+        ];
+        let res = await _anthropic.messages.create({ model, temperature, system: systemContent, messages, max_tokens: 4096 }, { timeout });
+        if (typeof res === "string") {
+            res = JSON.parse(res);
+        }
+        if (res.content && res.content.length > 0 && res.content[0].type === "text") {
+            content = res.content[0].text;
+        }
+        else {
+            console.error("Error: Anthropic response content is empty or not a text block.", res.content);
+            content = ""; // Default to empty string or handle error appropriately
+        }
+    }
+    else if (provider === "gemini") {
+        const contents = [
+            { role: "user", parts: [{ text: initialUserContent }] },
+            { role: "model", parts: [{ text: initialAssistantContent }] },
+            ...(dicts.user.length > 0
+                ? [
+                    { role: "user", parts: [{ text: dicts.user.join("\n") }] },
+                    { role: "model", parts: [{ text: dicts.assistant.join("\n") }] }
+                ]
+                : []),
+            { role: "user", parts: [{ text: translationsContent }] }
+        ];
+        const res = await _gemini.models.generateContent({
+            model,
+            contents,
+            config: {
+                systemInstruction: systemContent,
+                temperature,
+                maxOutputTokens: 4096,
+                httpOptions: { timeout }
             }
-        ]
-    }, {
-        timeout: 20000,
-        stream: false
-    });
-    const content = res.choices[0].message.content ?? "";
+        });
+        if (res.candidates && res.candidates.length > 0) {
+            const candidate = res.candidates[0];
+            if (candidate.content && candidate.content.parts && candidate.content.parts.length > 0) {
+                content = candidate.content.parts[0].text || "";
+            }
+        }
+    }
     translations.forEach((trans, idx) => {
         const tag = `<translated index="${idx + dicts.user.length + 1}">`;
         const s = content.indexOf(tag);
@@ -110,7 +171,7 @@ export async function translate(src, lang, model, translations, contextFile) {
         }
     });
 }
-export async function translatePo(model, po, source, lang, verbose, output, contextFile, compileOptions) {
+export async function translatePo(provider, model, po, source, lang, verbose, output, contextFile, contextLength, timeout, compileOptions) {
     const potrans = await parsePo(po);
     if (!lang)
         lang = potrans.headers["Language"];
@@ -170,13 +231,13 @@ export async function translatePo(model, po, source, lang, verbose, output, cont
             await new Promise((resolve) => setTimeout(resolve, 20000));
         }
         const trans = list[i];
-        if (c < 2000) {
+        if (c < contextLength) {
             translations.push(trans);
             c += trans.msgid.length;
         }
-        if (c >= 2000 || i == list.length - 1) {
+        if (c >= contextLength || i == list.length - 1) {
             try {
-                await translate(source, lang, model, translations, contextFile);
+                await translate(provider, source, lang, model, translations, contextFile, timeout);
                 if (verbose) {
                     translations.forEach((trans) => {
                         console.log(trans.msgid);
@@ -187,7 +248,7 @@ export async function translatePo(model, po, source, lang, verbose, output, cont
                 c = 0;
                 // update progress
                 printProgress(i + 1, list.length);
-                // save po file after each 2000 characters
+                // save po file after each 2000 characters by default
                 await compilePo(potrans, output || po, compileOptions);
             }
             catch (error) {
@@ -205,7 +266,7 @@ export async function translatePo(model, po, source, lang, verbose, output, cont
                 else {
                     console.error(error.message);
                     if (error.code == "ECONNABORTED") {
-                        console.log('you may need to set "HTTPS_PROXY" to reach openai api.');
+                        console.log('you may need to set "HTTPS_PROXY" to reach api.');
                     }
                 }
             }
@@ -213,13 +274,13 @@ export async function translatePo(model, po, source, lang, verbose, output, cont
     }
     console.log("done.");
 }
-export async function translatePoDir(model = "gpt-3.5-turbo", dir, source, lang, verbose, contextFile, compileOptions) {
+export async function translatePoDir(provider, model, dir, source, lang, verbose, contextFile, contextLength, timeout, compileOptions) {
     const files = fs.readdirSync(dir);
     for (const file of files) {
         if (file.endsWith(".po")) {
             const po = path.join(dir, file);
             console.log(`translating ${po}`);
-            await translatePo(model, po, source, lang, verbose, po, contextFile, compileOptions);
+            await translatePo(provider, model, po, source, lang, verbose, po, contextFile, contextLength, timeout, compileOptions);
         }
     }
 }

package/lib/src/userprompt.txt

@@ -13,20 +13,25 @@ Translation guidelines are as follows:
    - Respond with the translated message wrapped in `<translated>` XML tags, including the same index attribute, e.g., `<translated index="1">`.
 
 4. **Context Handling**:
-   - Some messages will include a context attribute in the translate tag, e.g., `<translate index="1" context="Menu">`.
+   - Some messages will include a context attribute in the `translate` tag, e.g., `<translate index="1" context="Menu">`.
    - Use this context to inform your translation but only return the translated text.
-   - Example:
+   - Example (translating from `en_GB` to `fr_FR`):
      Input: `<translate index="1" context="Menu">File</translate>`
      Output: `<translated index="1">Fichier</translated>`
 
+5. **Translator notes**:
+   - Some messages will include translator notes attribute in the `translate` tag, e.g., `<translate index="2" notes="Placeholder is a person's name">`.
+   - These notes are for you, to aid you in achieving an accurate translation.
+   - Pay attention to these notes, but do not include them in your response, and never respond to the notes.
+
 5. **Multiple Translations**:
    - You may receive multiple translation requests in a single input, each with a unique index.
    - Ensuring the complete number of requests are translated, even if they are repeated, while maintaining the original order when possible.
 
-**Examples**:
+**Example (translating from `en_US` to `zh_CN`):**
 - Input:
   `<translate index="1">This is a message. </translate>`
-  `<translate index="2"> Hello %s</translate>`
+  `<translate index="2" notes="TRANSLATORS: Placeholder is a person's first name"> Hello %s</translate>`
 - Output:
   `<translated index="1">这是一条信息</translated>`
   `<translated index="2"> 你好 %s</translated>`

package/lib/src/utils.d.ts

@@ -1,4 +1,4 @@
-import { GetTextTranslations } from "gettext-parser";
+import { GetTextTranslations, GetTextPoCompilerOptions } from "gettext-parser";
 /**
  * copy source file to destination file if destination file does not exist
  * @param file destination file path
@@ -8,12 +8,7 @@ import { GetTextTranslations } from "gettext-parser";
 export declare function copyFileIfNotExists(file: string, copyFile: string, force?: boolean): void;
 export declare function openFileByDefault(filePath: string): void;
 export declare function parsePo(poFile: string, defaultCharset?: string): Promise<GetTextTranslations>;
-export type CompileOptions = {
-    foldLength?: number;
-    sort?: boolean | ((a: never, b: never) => number);
-    escapeCharacters?: boolean;
-};
-export declare function compilePo(data: GetTextTranslations, poFile: string, options?: CompileOptions): Promise<void>;
+export declare function compilePo(data: GetTextTranslations, poFile: string, options?: GetTextPoCompilerOptions): Promise<void>;
 export declare function printProgress(progress: number, total: number, extra?: string): void;
 export declare function gitRootDir(dir?: string): string | null;
 /**

package/lib/src/utils.js

@@ -36,7 +36,7 @@ export function parsePo(poFile, defaultCharset) {
         fs.readFile(poFile, (err, buffer) => {
             if (err)
                 reject(err);
-            const result = po.parse(buffer, defaultCharset ?? "utf-8");
+            const result = po.parse(buffer, { defaultCharset: defaultCharset ?? "utf-8" });
             resolve(result);
         });
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gpt-po",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "description": "command tool for translate po files by gpt",
   "main": "lib/src/index.js",
   "type": "module",
@@ -11,7 +11,7 @@
     "start": "node lib/src/index.js",
     "test": "echo \"Error: no test specified\" && exit 1",
     "prebuild": "rimraf ./lib",
-    "build": "tsc",
+    "build": "tsc -p tsconfig.json",
     "postbuild": "ncp ./src/ ./lib/src/ \"--filter=^(?!.*\\.ts$).*$\"",
     "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
     "lint": "tslint -p tsconfig.json"
@@ -34,7 +34,7 @@
     "openai"
   ],
   "devDependencies": {
-    "@types/gettext-parser": "^4.0.4",
+    "@types/gettext-parser": "^9.0.0",
     "@types/jest": "^29.5.12",
     "jest": "^29.7.0",
     "ncp": "^2.0.0",
@@ -46,11 +46,13 @@
     "typescript": "^5.5.4"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.99.0",
+    "@google/genai": "^2.6.0",
     "commander": "^12.1.0",
-    "gettext-parser": "^8.0.0",
-    "openai": "^4.56.0"
+    "gettext-parser": "^9.0.1",
+    "openai": "^6.39.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   }
 }