lingui-po-translate 1.0.3 → 1.0.6

package/README.md

@@ -77,13 +77,10 @@ t({
   comment: "@manual:zh-Hans,zh-Hant"
 })
 
-// Combine with context
+// Combine with context (use ; as separator)
 t({
   message: "Technical term",
-  comment: `
-    @manual:zh-Hans
-    @context:Industry-specific terminology
-  `
+  comment: "@manual:zh-Hans; @context:Industry-specific terminology"
 })
 ```
 
@@ -176,6 +173,8 @@ Options:
   --baseUrl <url>                 Custom API base URL for OpenAI-compatible APIs
   --prompt <prompt>               Additional instructions for AI translation
   --matcher <matcher>             Interpolation matcher: "none", "icu", "i18next", "sprintf"
+  --model <model>                 Model for AI translation (default: "gpt-4o-mini")
+  --debug                         Print debug info including API requests/responses
   -v, --version                   Output the version number
   -h, --help                      Display help
 ```
@@ -234,6 +233,48 @@ lingui-po-translate \
   --prompt="This is a medical application. Keep technical terms like 'MRI', 'CT scan' in English. Use polite Japanese (敬語)."
 ```
 
+## Model Selection
+
+Specify a different model for translation:
+
+```bash
+# Use GPT-4o for higher quality translations
+lingui-po-translate \
+  --srcFile=locales/en.po \
+  --targetFile=locales/zh.po \
+  --targetLng=zh \
+  --service=openai \
+  --serviceConfig="YOUR_API_KEY" \
+  --model=gpt-4o
+
+# Use with DeepSeek
+lingui-po-translate \
+  --baseUrl="https://api.deepseek.com/v1" \
+  --serviceConfig="YOUR_DEEPSEEK_KEY" \
+  --model=deepseek-chat \
+  ...
+```
+
+Default model: `gpt-4o-mini`
+
+## Debugging
+
+Use `--debug` to print API requests and responses:
+
+```bash
+lingui-po-translate \
+  --srcFile=locales/en.po \
+  --targetFile=locales/zh.po \
+  --targetLng=zh \
+  --service=openai \
+  --serviceConfig="YOUR_API_KEY" \
+  --debug
+```
+
+This will print:
+- System prompt and user prompt sent to the API
+- Full API response including token usage
+
 ## Weblate Integration
 
 For entries marked with `@manual`, the tool copies the original text to `msgstr`. This prevents Weblate from flagging them as "untranslated".

package/dist/core/invoke-translation-service.js

@@ -67,6 +67,7 @@ async function runTranslationService(rawInputs, args) {
         prompt: args.prompt,
         baseUrl: args.baseUrl,
         debug: args.debug,
+        model: args.model,
     };
     console.info(`Invoke '${args.service}' from '${args.srcLng}' to '${args.targetLng}' with ${serviceArgs.strings.length} inputs...`);
     const translationService = await (0, service_definitions_1.instantiateTService)(args.service);

package/dist/core/translate-cli.js

@@ -32,7 +32,7 @@ function formatCliOptions(options) {
 }
 exports.formatCliOptions = formatCliOptions;
 async function translateCli(cliArgs) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     checkForEmptyStringOptions(cliArgs);
     const fileFormats = (0, file_format_definitions_1.getTFileFormatList)();
     const services = (0, service_definitions_1.getTServiceList)();
@@ -74,6 +74,7 @@ async function translateCli(cliArgs) {
         sourceOverride: (0, core_definitions_1.parseSourceOverride)(cliArgs.sourceOverride),
         baseUrl: (_c = cliArgs.baseUrl) !== null && _c !== void 0 ? _c : null,
         debug: (_d = cliArgs.debug) !== null && _d !== void 0 ? _d : false,
+        model: (_e = cliArgs.model) !== null && _e !== void 0 ? _e : null,
     };
     const result = await (0, translate_core_1.translateCore)(coreArgs);
     const flushTarget = !oldTarget || !(0, tset_ops_1.areEqual)(oldTarget, result.newTarget);

package/dist/file-formats/po/comment-parser.js

@@ -8,11 +8,13 @@ exports.hasManualMarking = exports.shouldSkipForManual = exports.parseExtractedC
  * - @manual:zh-Hans,zh-Hant - languages requiring manual translation
  * - @context:text - context for AI translation
  * - Plain text (without @) - also treated as context
+ * - Multiple directives can be separated by ; or newline
  *
  * Example:
+ * #. @manual:zh-Hans; @context:This is a save button
+ * Or:
  * #. @manual:zh-Hans
  * #. @context:This is a save button
- * #. Some additional context
  *
  * @param extracted - The extracted comment string from PO file
  * @returns ParsedComment with manual languages and context
@@ -25,30 +27,38 @@ function parseExtractedComment(extracted) {
     if (!extracted) {
         return result;
     }
-    const lines = extracted.split("\n");
+    // Split by newline first, then by ; for each line
+    const parts = [];
+    for (const line of extracted.split("\n")) {
+        for (const part of line.split(";")) {
+            const trimmed = part.trim();
+            if (trimmed) {
+                parts.push(trimmed);
+            }
+        }
+    }
     const contextParts = [];
-    for (const line of lines) {
-        const trimmedLine = line.trim();
-        if (trimmedLine.startsWith("@manual:")) {
+    for (const part of parts) {
+        if (part.startsWith("@manual:")) {
             // Parse @manual:zh-Hans,zh-Hant
-            const langList = trimmedLine.substring("@manual:".length).trim();
+            const langList = part.substring("@manual:".length).trim();
             if (langList) {
                 result.manual = langList.split(",").map((lang) => lang.trim()).filter(Boolean);
             }
         }
-        else if (trimmedLine.startsWith("@context:")) {
+        else if (part.startsWith("@context:")) {
             // Parse @context:text
-            const contextText = trimmedLine.substring("@context:".length).trim();
+            const contextText = part.substring("@context:".length).trim();
             if (contextText) {
                 contextParts.push(contextText);
             }
         }
-        else if (trimmedLine && !trimmedLine.startsWith("@")) {
+        else if (!part.startsWith("@")) {
             // Plain text without @ prefix is also context
-            contextParts.push(trimmedLine);
+            contextParts.push(part);
         }
     }
-    result.context = contextParts.join("\n");
+    result.context = contextParts.join(" ");
     return result;
 }
 exports.parseExtractedComment = parseExtractedComment;

package/dist/index.js

@@ -33,6 +33,7 @@ function run(process, cliBinDir) {
         .option("--sourceOverride <mapping>", "override source language for specific targets (e.g., 'zh-Hant:zh-Hans,pt-BR:pt-PT')")
         .option("--baseUrl <url>", "custom API base URL for OpenAI-compatible services (e.g., 'https://api.openai.com/v1')")
         .option("--debug", "print debug information including API requests")
+        .option("--model <model>", "model to use for AI translation services (e.g., gpt-4o-mini, gpt-4o)")
         .version((0, extract_version_1.extractVersion)({ cliBinDir }), "-v, --version")
         .parse(process.argv);
     if ((_a = commander_1.default.args) === null || _a === void 0 ? void 0 : _a.length) {
@@ -53,6 +54,7 @@ function run(process, cliBinDir) {
         sourceOverride: commander_1.default.opts().sourceOverride,
         baseUrl: commander_1.default.opts().baseUrl,
         debug: commander_1.default.opts().debug,
+        model: commander_1.default.opts().model,
     };
     (0, translate_cli_1.translateCli)(args)
         .then(() => {

package/dist/services/openai-translate.js

@@ -5,7 +5,7 @@ const openai_1 = require("openai");
 const util_1 = require("../util/util");
 const lodash_1 = require("lodash");
 async function translateSingleString(tString, args) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const OPENAI_API_KEY = args.serviceConfig;
     if (!OPENAI_API_KEY || !OPENAI_API_KEY.trim().length) {
         (0, util_1.logFatal)('Missing OpenAI API Key: Please get an API key from https://platform.openai.com/account/api-keys and then call lingui-po-translate with --serviceConfig="YOUR API KEY"');
@@ -26,9 +26,10 @@ async function translateSingleString(tString, args) {
             content: userPrompt,
         },
     ];
+    const model = (_c = args.model) !== null && _c !== void 0 ? _c : "gpt-4o-mini";
     if (args.debug) {
         console.log("\n[DEBUG] OpenAI Request:");
-        console.log("  Model: gpt-4o-mini-2024-07-18");
+        console.log("  Model:", model);
         console.log("  System:", systemPrompt);
         console.log("  User:", userPrompt);
     }
@@ -39,7 +40,7 @@ async function translateSingleString(tString, args) {
      */
     try {
         const completion = await openai.createChatCompletion({
-            model: "gpt-4o-mini-2024-07-18",
+            model,
             messages: messages,
             temperature: 0,
             max_tokens: 2048,
@@ -47,7 +48,7 @@ async function translateSingleString(tString, args) {
         if (args.debug) {
             console.log("\n[DEBUG] OpenAI Full Response:", JSON.stringify(completion.data, null, 2));
         }
-        const text = (_c = completion.data.choices[0].message) === null || _c === void 0 ? void 0 : _c.content;
+        const text = (_d = completion.data.choices[0].message) === null || _d === void 0 ? void 0 : _d.content;
         if (text == undefined) {
             (0, util_1.logFatal)("OpenAI returned undefined for prompt " + prompt);
         }
@@ -58,7 +59,7 @@ async function translateSingleString(tString, args) {
             (0, util_1.logFatal)("OpenAI: " +
                 e.message +
                 ", Status text: " +
-                JSON.stringify((_d = e === null || e === void 0 ? void 0 : e.response) === null || _d === void 0 ? void 0 : _d.statusText));
+                JSON.stringify((_e = e === null || e === void 0 ? void 0 : e.response) === null || _e === void 0 ? void 0 : _e.statusText));
         }
         else {
             throw e;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lingui-po-translate",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "description": "AI-powered translation tool for Lingui PO files with context-aware translations",
   "repository": {
     "type": "git",