ai-i18n-tools 1.0.0
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.
- package/LICENSE +21 -0
- package/README.md +157 -0
- package/dist/api/openrouter.d.ts +115 -0
- package/dist/api/openrouter.d.ts.map +1 -0
- package/dist/api/openrouter.js +399 -0
- package/dist/api/openrouter.js.map +1 -0
- package/dist/cli/doc-translate.d.ts +90 -0
- package/dist/cli/doc-translate.d.ts.map +1 -0
- package/dist/cli/doc-translate.js +1153 -0
- package/dist/cli/doc-translate.js.map +1 -0
- package/dist/cli/export-ui-xliff.d.ts +32 -0
- package/dist/cli/export-ui-xliff.d.ts.map +1 -0
- package/dist/cli/export-ui-xliff.js +153 -0
- package/dist/cli/export-ui-xliff.js.map +1 -0
- package/dist/cli/extract-strings.d.ts +12 -0
- package/dist/cli/extract-strings.d.ts.map +1 -0
- package/dist/cli/extract-strings.js +80 -0
- package/dist/cli/extract-strings.js.map +1 -0
- package/dist/cli/file-utils.d.ts +10 -0
- package/dist/cli/file-utils.d.ts.map +1 -0
- package/dist/cli/file-utils.js +77 -0
- package/dist/cli/file-utils.js.map +1 -0
- package/dist/cli/format.d.ts +21 -0
- package/dist/cli/format.d.ts.map +1 -0
- package/dist/cli/format.js +75 -0
- package/dist/cli/format.js.map +1 -0
- package/dist/cli/helpers.d.ts +27 -0
- package/dist/cli/helpers.d.ts.map +1 -0
- package/dist/cli/helpers.js +84 -0
- package/dist/cli/helpers.js.map +1 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +772 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/log-output.d.ts +13 -0
- package/dist/cli/log-output.d.ts.map +1 -0
- package/dist/cli/log-output.js +75 -0
- package/dist/cli/log-output.js.map +1 -0
- package/dist/cli/translate-svg.d.ts +7 -0
- package/dist/cli/translate-svg.d.ts.map +1 -0
- package/dist/cli/translate-svg.js +167 -0
- package/dist/cli/translate-svg.js.map +1 -0
- package/dist/cli/translate-ui-strings.d.ts +27 -0
- package/dist/cli/translate-ui-strings.d.ts.map +1 -0
- package/dist/cli/translate-ui-strings.js +357 -0
- package/dist/cli/translate-ui-strings.js.map +1 -0
- package/dist/core/cache-tracking-keys.d.ts +12 -0
- package/dist/core/cache-tracking-keys.d.ts.map +1 -0
- package/dist/core/cache-tracking-keys.js +20 -0
- package/dist/core/cache-tracking-keys.js.map +1 -0
- package/dist/core/cache.d.ts +153 -0
- package/dist/core/cache.d.ts.map +1 -0
- package/dist/core/cache.js +546 -0
- package/dist/core/cache.js.map +1 -0
- package/dist/core/config.d.ts +58 -0
- package/dist/core/config.d.ts.map +1 -0
- package/dist/core/config.js +392 -0
- package/dist/core/config.js.map +1 -0
- package/dist/core/doc-file-tracking.d.ts +8 -0
- package/dist/core/doc-file-tracking.d.ts.map +1 -0
- package/dist/core/doc-file-tracking.js +27 -0
- package/dist/core/doc-file-tracking.js.map +1 -0
- package/dist/core/errors.d.ts +19 -0
- package/dist/core/errors.d.ts.map +1 -0
- package/dist/core/errors.js +23 -0
- package/dist/core/errors.js.map +1 -0
- package/dist/core/locale-utils.d.ts +20 -0
- package/dist/core/locale-utils.d.ts.map +1 -0
- package/dist/core/locale-utils.js +75 -0
- package/dist/core/locale-utils.js.map +1 -0
- package/dist/core/output-paths.d.ts +22 -0
- package/dist/core/output-paths.d.ts.map +1 -0
- package/dist/core/output-paths.js +130 -0
- package/dist/core/output-paths.js.map +1 -0
- package/dist/core/prompt-builder.d.ts +62 -0
- package/dist/core/prompt-builder.d.ts.map +1 -0
- package/dist/core/prompt-builder.js +232 -0
- package/dist/core/prompt-builder.js.map +1 -0
- package/dist/core/prompts.d.ts +27 -0
- package/dist/core/prompts.d.ts.map +1 -0
- package/dist/core/prompts.js +57 -0
- package/dist/core/prompts.js.map +1 -0
- package/dist/core/svg-asset-paths.d.ts +40 -0
- package/dist/core/svg-asset-paths.d.ts.map +1 -0
- package/dist/core/svg-asset-paths.js +107 -0
- package/dist/core/svg-asset-paths.js.map +1 -0
- package/dist/core/types.d.ts +388 -0
- package/dist/core/types.d.ts.map +1 -0
- package/dist/core/types.js +265 -0
- package/dist/core/types.js.map +1 -0
- package/dist/core/ui-languages.d.ts +66 -0
- package/dist/core/ui-languages.d.ts.map +1 -0
- package/dist/core/ui-languages.js +277 -0
- package/dist/core/ui-languages.js.map +1 -0
- package/dist/core/user-edited-model.d.ts +3 -0
- package/dist/core/user-edited-model.d.ts.map +1 -0
- package/dist/core/user-edited-model.js +3 -0
- package/dist/core/user-edited-model.js.map +1 -0
- package/dist/edit-cache-app/app.js +1326 -0
- package/dist/edit-cache-app/index.html +287 -0
- package/dist/edit-cache-app/styles.css +664 -0
- package/dist/extractors/base-extractor.d.ts +15 -0
- package/dist/extractors/base-extractor.d.ts.map +1 -0
- package/dist/extractors/base-extractor.js +23 -0
- package/dist/extractors/base-extractor.js.map +1 -0
- package/dist/extractors/classify-segment.d.ts +6 -0
- package/dist/extractors/classify-segment.d.ts.map +1 -0
- package/dist/extractors/classify-segment.js +20 -0
- package/dist/extractors/classify-segment.js.map +1 -0
- package/dist/extractors/json-extractor.d.ts +16 -0
- package/dist/extractors/json-extractor.d.ts.map +1 -0
- package/dist/extractors/json-extractor.js +128 -0
- package/dist/extractors/json-extractor.js.map +1 -0
- package/dist/extractors/markdown-extractor.d.ts +15 -0
- package/dist/extractors/markdown-extractor.d.ts.map +1 -0
- package/dist/extractors/markdown-extractor.js +205 -0
- package/dist/extractors/markdown-extractor.js.map +1 -0
- package/dist/extractors/svg-extractor.d.ts +19 -0
- package/dist/extractors/svg-extractor.d.ts.map +1 -0
- package/dist/extractors/svg-extractor.js +132 -0
- package/dist/extractors/svg-extractor.js.map +1 -0
- package/dist/extractors/ui-string-extractor.d.ts +40 -0
- package/dist/extractors/ui-string-extractor.d.ts.map +1 -0
- package/dist/extractors/ui-string-extractor.js +146 -0
- package/dist/extractors/ui-string-extractor.js.map +1 -0
- package/dist/extractors/ui-string-locations.d.ts +23 -0
- package/dist/extractors/ui-string-locations.d.ts.map +1 -0
- package/dist/extractors/ui-string-locations.js +138 -0
- package/dist/extractors/ui-string-locations.js.map +1 -0
- package/dist/glossary/glossary.d.ts +34 -0
- package/dist/glossary/glossary.d.ts.map +1 -0
- package/dist/glossary/glossary.js +260 -0
- package/dist/glossary/glossary.js.map +1 -0
- package/dist/glossary/matcher.d.ts +10 -0
- package/dist/glossary/matcher.d.ts.map +1 -0
- package/dist/glossary/matcher.js +12 -0
- package/dist/glossary/matcher.js.map +1 -0
- package/dist/index.d.ts +44 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +44 -0
- package/dist/index.js.map +1 -0
- package/dist/processors/admonition-placeholders.d.ts +8 -0
- package/dist/processors/admonition-placeholders.d.ts.map +1 -0
- package/dist/processors/admonition-placeholders.js +59 -0
- package/dist/processors/admonition-placeholders.js.map +1 -0
- package/dist/processors/anchor-placeholders.d.ts +8 -0
- package/dist/processors/anchor-placeholders.d.ts.map +1 -0
- package/dist/processors/anchor-placeholders.js +37 -0
- package/dist/processors/anchor-placeholders.js.map +1 -0
- package/dist/processors/batch-processor.d.ts +10 -0
- package/dist/processors/batch-processor.d.ts.map +1 -0
- package/dist/processors/batch-processor.js +33 -0
- package/dist/processors/batch-processor.js.map +1 -0
- package/dist/processors/bold-code-placeholders.d.ts +14 -0
- package/dist/processors/bold-code-placeholders.d.ts.map +1 -0
- package/dist/processors/bold-code-placeholders.js +116 -0
- package/dist/processors/bold-code-placeholders.js.map +1 -0
- package/dist/processors/doc-postprocess.d.ts +51 -0
- package/dist/processors/doc-postprocess.d.ts.map +1 -0
- package/dist/processors/doc-postprocess.js +215 -0
- package/dist/processors/doc-postprocess.js.map +1 -0
- package/dist/processors/emphasis-placeholders.d.ts +6 -0
- package/dist/processors/emphasis-placeholders.d.ts.map +1 -0
- package/dist/processors/emphasis-placeholders.js +262 -0
- package/dist/processors/emphasis-placeholders.js.map +1 -0
- package/dist/processors/flat-link-rewrite.d.ts +32 -0
- package/dist/processors/flat-link-rewrite.d.ts.map +1 -0
- package/dist/processors/flat-link-rewrite.js +90 -0
- package/dist/processors/flat-link-rewrite.js.map +1 -0
- package/dist/processors/glossary-force-placeholders.d.ts +12 -0
- package/dist/processors/glossary-force-placeholders.d.ts.map +1 -0
- package/dist/processors/glossary-force-placeholders.js +58 -0
- package/dist/processors/glossary-force-placeholders.js.map +1 -0
- package/dist/processors/inline-code-placeholders.d.ts +11 -0
- package/dist/processors/inline-code-placeholders.d.ts.map +1 -0
- package/dist/processors/inline-code-placeholders.js +87 -0
- package/dist/processors/inline-code-placeholders.js.map +1 -0
- package/dist/processors/placeholder-handler.d.ts +38 -0
- package/dist/processors/placeholder-handler.d.ts.map +1 -0
- package/dist/processors/placeholder-handler.js +55 -0
- package/dist/processors/placeholder-handler.js.map +1 -0
- package/dist/processors/translation-placeholder-leaks.d.ts +2 -0
- package/dist/processors/translation-placeholder-leaks.d.ts.map +1 -0
- package/dist/processors/translation-placeholder-leaks.js +9 -0
- package/dist/processors/translation-placeholder-leaks.js.map +1 -0
- package/dist/processors/url-placeholders.d.ts +10 -0
- package/dist/processors/url-placeholders.d.ts.map +1 -0
- package/dist/processors/url-placeholders.js +29 -0
- package/dist/processors/url-placeholders.js.map +1 -0
- package/dist/processors/validator.d.ts +23 -0
- package/dist/processors/validator.d.ts.map +1 -0
- package/dist/processors/validator.js +186 -0
- package/dist/processors/validator.js.map +1 -0
- package/dist/runtime/i18next-helpers.d.ts +146 -0
- package/dist/runtime/i18next-helpers.d.ts.map +1 -0
- package/dist/runtime/i18next-helpers.js +192 -0
- package/dist/runtime/i18next-helpers.js.map +1 -0
- package/dist/runtime/index.d.ts +4 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/index.js +4 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/template.d.ts +21 -0
- package/dist/runtime/template.d.ts.map +1 -0
- package/dist/runtime/template.js +28 -0
- package/dist/runtime/template.js.map +1 -0
- package/dist/runtime/ui-language-display.d.ts +16 -0
- package/dist/runtime/ui-language-display.d.ts.map +1 -0
- package/dist/runtime/ui-language-display.js +26 -0
- package/dist/runtime/ui-language-display.js.map +1 -0
- package/dist/server/translation-editor.d.ts +25 -0
- package/dist/server/translation-editor.d.ts.map +1 -0
- package/dist/server/translation-editor.js +583 -0
- package/dist/server/translation-editor.js.map +1 -0
- package/dist/utils/concurrency.d.ts +31 -0
- package/dist/utils/concurrency.d.ts.map +1 -0
- package/dist/utils/concurrency.js +103 -0
- package/dist/utils/concurrency.js.map +1 -0
- package/dist/utils/hash.d.ts +5 -0
- package/dist/utils/hash.d.ts.map +1 -0
- package/dist/utils/hash.js +9 -0
- package/dist/utils/hash.js.map +1 -0
- package/dist/utils/ignore-parser.d.ts +7 -0
- package/dist/utils/ignore-parser.d.ts.map +1 -0
- package/dist/utils/ignore-parser.js +26 -0
- package/dist/utils/ignore-parser.js.map +1 -0
- package/dist/utils/logger.d.ts +45 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +158 -0
- package/dist/utils/logger.js.map +1 -0
- package/docs/GETTING_STARTED.md +697 -0
- package/docs/PACKAGE_OVERVIEW.md +427 -0
- package/docs/ai-i18n-tools-context.md +481 -0
- package/package.json +117 -0
- package/translated-docs/README.de.md +157 -0
- package/translated-docs/README.es.md +157 -0
- package/translated-docs/README.fr.md +157 -0
- package/translated-docs/README.hi.md +157 -0
- package/translated-docs/README.ja.md +157 -0
- package/translated-docs/README.ko.md +157 -0
- package/translated-docs/README.pt-BR.md +157 -0
- package/translated-docs/README.zh-CN.md +157 -0
- package/translated-docs/README.zh-TW.md +157 -0
- package/translated-docs/docs/GETTING_STARTED.de.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.es.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.fr.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.hi.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.ja.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.ko.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.pt-BR.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.zh-CN.md +682 -0
- package/translated-docs/docs/GETTING_STARTED.zh-TW.md +682 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.de.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.es.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.fr.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.hi.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.ja.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.ko.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.pt-BR.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.zh-CN.md +428 -0
- package/translated-docs/docs/PACKAGE_OVERVIEW.zh-TW.md +428 -0
|
@@ -0,0 +1,399 @@
|
|
|
1
|
+
import fs from "fs";
|
|
2
|
+
import chalk from "chalk";
|
|
3
|
+
import { BatchTranslationError, } from "../core/types.js";
|
|
4
|
+
import { englishLanguageNameForLocale, normalizeLocale, resolveTranslationModels, } from "../core/config.js";
|
|
5
|
+
import { buildDocumentBatchPrompt, buildDocumentSinglePrompt, buildUIPromptMessages, parseBatchJsonArrayResponse, parseBatchJsonObjectResponse, parseBatchTranslationResponse, parseUIJsonArrayResponse, } from "../core/prompt-builder.js";
|
|
6
|
+
/** OpenRouter: prefer throughput; allow backup providers. */
|
|
7
|
+
const OPENROUTER_PROVIDER = {
|
|
8
|
+
sort: "throughput",
|
|
9
|
+
allow_fallbacks: true,
|
|
10
|
+
};
|
|
11
|
+
/** Thrown when every model in the chain fails for {@link OpenRouterClient.translateDocumentBatch}. */
|
|
12
|
+
export class DocumentBatchAllModelsFailedError extends Error {
|
|
13
|
+
constructor(message, details) {
|
|
14
|
+
super(message);
|
|
15
|
+
this.details = details;
|
|
16
|
+
this.name = "DocumentBatchAllModelsFailedError";
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* OpenRouter chat client with ordered `translationModels` fallback chain.
|
|
21
|
+
*/
|
|
22
|
+
export class OpenRouterClient {
|
|
23
|
+
constructor(opts) {
|
|
24
|
+
this.apiKey = opts.apiKey ?? process.env.OPENROUTER_API_KEY ?? "";
|
|
25
|
+
if (!this.apiKey) {
|
|
26
|
+
throw new Error("OPENROUTER_API_KEY is required");
|
|
27
|
+
}
|
|
28
|
+
this.baseUrl = opts.config.openrouter.baseUrl.replace(/\/$/, "");
|
|
29
|
+
const override = opts.translationModels;
|
|
30
|
+
const fromOverride = Array.isArray(override) && override.length > 0
|
|
31
|
+
? override
|
|
32
|
+
.filter((m) => typeof m === "string" && m.trim().length > 0)
|
|
33
|
+
.map((m) => m.trim())
|
|
34
|
+
: null;
|
|
35
|
+
this.modelsToTry =
|
|
36
|
+
fromOverride !== null && fromOverride.length > 0
|
|
37
|
+
? fromOverride
|
|
38
|
+
: resolveTranslationModels(opts.config.openrouter);
|
|
39
|
+
if (this.modelsToTry.length === 0) {
|
|
40
|
+
throw new Error("No OpenRouter models configured (translationModels or defaultModel)");
|
|
41
|
+
}
|
|
42
|
+
this.maxTokens = opts.config.openrouter.maxTokens;
|
|
43
|
+
this.temperature = opts.config.openrouter.temperature;
|
|
44
|
+
this.debugTrafficFilePath = opts.debugTrafficFilePath ?? null;
|
|
45
|
+
this.logger = opts.logger;
|
|
46
|
+
this.localeDisplayNames = {};
|
|
47
|
+
for (const [k, v] of Object.entries(opts.config.localeDisplayNames ?? {})) {
|
|
48
|
+
if (typeof v === "string") {
|
|
49
|
+
this.localeDisplayNames[normalizeLocale(k)] = v;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
this.sourceLanguageLabel = this.languageLabelForPrompt(opts.config.sourceLocale);
|
|
53
|
+
this.httpReferer = opts.httpReferer ?? "https://github.com/wsj-br/ai-i18n-tools";
|
|
54
|
+
this.xTitle = opts.xTitle ?? "ai-i18n-tools";
|
|
55
|
+
}
|
|
56
|
+
getConfiguredModels() {
|
|
57
|
+
return this.modelsToTry;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* BCP-47 locale id plus English display name for LLM prompts (e.g. `pt-BR: Brazilian Portuguese`).
|
|
61
|
+
* Uses a colon so it reads as a clear key–value / label field (common in prompt instructions);
|
|
62
|
+
* it does not clash with hyphens inside tags (`zh-CN`, `pt-BR`) the way a bare `-` can.
|
|
63
|
+
* Order: `localeDisplayNames` from config, else `englishLanguageNameForLocale` (Intl), else raw code.
|
|
64
|
+
*/
|
|
65
|
+
languageLabelForPrompt(localeCode) {
|
|
66
|
+
const n = normalizeLocale(localeCode);
|
|
67
|
+
const configured = this.localeDisplayNames[n];
|
|
68
|
+
const display = configured && configured.trim().length > 0
|
|
69
|
+
? configured.trim()
|
|
70
|
+
: englishLanguageNameForLocale(n);
|
|
71
|
+
if (display && display.length > 0) {
|
|
72
|
+
return `${n}: ${display}`;
|
|
73
|
+
}
|
|
74
|
+
return localeCode;
|
|
75
|
+
}
|
|
76
|
+
appendDebugLog(direction, payload) {
|
|
77
|
+
if (!this.debugTrafficFilePath) {
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
const ts = new Date().toISOString();
|
|
81
|
+
const sep = `========== ${direction.toUpperCase()} ${ts} ==========`;
|
|
82
|
+
const body = typeof payload === "string" ? payload : JSON.stringify(payload, null, 2);
|
|
83
|
+
try {
|
|
84
|
+
fs.appendFileSync(this.debugTrafficFilePath, `${sep}\n${body}\n\n`, "utf8");
|
|
85
|
+
}
|
|
86
|
+
catch (e) {
|
|
87
|
+
this.logger?.warn(`[debug-traffic] Failed to write: ${e}`);
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
async handleRateLimit(response) {
|
|
91
|
+
if (response.status === 429) {
|
|
92
|
+
const retryAfter = response.headers.get("retry-after");
|
|
93
|
+
const ms = retryAfter ? parseFloat(retryAfter) * 1000 : 2000;
|
|
94
|
+
await new Promise((r) => setTimeout(r, Number.isFinite(ms) ? ms : 2000));
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
/** Match doc-translate log lines: two-space indent, locale, filename. */
|
|
98
|
+
warnModelSwitch(localeCode, relativePath, failedModel, nextModel, error) {
|
|
99
|
+
const loc = relativePath != null ? `${localeCode} ${relativePath}` : localeCode;
|
|
100
|
+
const detail = error instanceof Error ? error.message : String(error);
|
|
101
|
+
console.warn(chalk.yellow(` ⚠️ ${loc}: ${failedModel} failed (${detail}). Trying ${nextModel}…`));
|
|
102
|
+
}
|
|
103
|
+
extractUsage(data) {
|
|
104
|
+
const cost = data.usage.cost ?? data.cost;
|
|
105
|
+
return {
|
|
106
|
+
inputTokens: data.usage.prompt_tokens,
|
|
107
|
+
outputTokens: data.usage.completion_tokens,
|
|
108
|
+
totalTokens: data.usage.total_tokens,
|
|
109
|
+
cost,
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
toOpenRouterMessages(messages) {
|
|
113
|
+
return messages.map((m, i) => {
|
|
114
|
+
if (m.role === "system" && i === 0) {
|
|
115
|
+
return {
|
|
116
|
+
role: "system",
|
|
117
|
+
content: [
|
|
118
|
+
{
|
|
119
|
+
type: "text",
|
|
120
|
+
text: m.content,
|
|
121
|
+
cache_control: { type: "ephemeral" },
|
|
122
|
+
},
|
|
123
|
+
],
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
return { role: m.role, content: m.content };
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
/** Single HTTP call for one model (with one 429 retry). */
|
|
130
|
+
async fetchCompletion(model, openRouterMessages) {
|
|
131
|
+
const requestPayload = {
|
|
132
|
+
model,
|
|
133
|
+
max_tokens: this.maxTokens,
|
|
134
|
+
temperature: this.temperature,
|
|
135
|
+
messages: openRouterMessages,
|
|
136
|
+
provider: OPENROUTER_PROVIDER,
|
|
137
|
+
};
|
|
138
|
+
if (this.debugTrafficFilePath) {
|
|
139
|
+
this.appendDebugLog("request", requestPayload);
|
|
140
|
+
}
|
|
141
|
+
let response = await fetch(`${this.baseUrl}/chat/completions`, {
|
|
142
|
+
method: "POST",
|
|
143
|
+
headers: {
|
|
144
|
+
Authorization: `Bearer ${this.apiKey}`,
|
|
145
|
+
"Content-Type": "application/json",
|
|
146
|
+
"HTTP-Referer": this.httpReferer,
|
|
147
|
+
"X-Title": this.xTitle,
|
|
148
|
+
},
|
|
149
|
+
body: JSON.stringify(requestPayload),
|
|
150
|
+
});
|
|
151
|
+
if (response.status === 429) {
|
|
152
|
+
await this.handleRateLimit(response);
|
|
153
|
+
response = await fetch(`${this.baseUrl}/chat/completions`, {
|
|
154
|
+
method: "POST",
|
|
155
|
+
headers: {
|
|
156
|
+
Authorization: `Bearer ${this.apiKey}`,
|
|
157
|
+
"Content-Type": "application/json",
|
|
158
|
+
"HTTP-Referer": this.httpReferer,
|
|
159
|
+
"X-Title": this.xTitle,
|
|
160
|
+
},
|
|
161
|
+
body: JSON.stringify(requestPayload),
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
const rawBody = await response.text();
|
|
165
|
+
if (this.debugTrafficFilePath) {
|
|
166
|
+
let parsedBody = rawBody;
|
|
167
|
+
try {
|
|
168
|
+
parsedBody = response.ok ? JSON.parse(rawBody) : rawBody;
|
|
169
|
+
}
|
|
170
|
+
catch {
|
|
171
|
+
/* keep text */
|
|
172
|
+
}
|
|
173
|
+
this.appendDebugLog("response", {
|
|
174
|
+
status: response.status,
|
|
175
|
+
ok: response.ok,
|
|
176
|
+
body: parsedBody,
|
|
177
|
+
});
|
|
178
|
+
}
|
|
179
|
+
if (!response.ok) {
|
|
180
|
+
throw new Error(`OpenRouter API error: ${response.status} - ${rawBody}`);
|
|
181
|
+
}
|
|
182
|
+
let data;
|
|
183
|
+
try {
|
|
184
|
+
data = JSON.parse(rawBody);
|
|
185
|
+
}
|
|
186
|
+
catch (e) {
|
|
187
|
+
throw e instanceof Error ? e : new Error(String(e));
|
|
188
|
+
}
|
|
189
|
+
const content = data.choices[0]?.message?.content;
|
|
190
|
+
if (content === undefined || content === null || String(content).trim() === "") {
|
|
191
|
+
throw new Error("Empty OpenRouter response content");
|
|
192
|
+
}
|
|
193
|
+
const usage = this.extractUsage(data);
|
|
194
|
+
return {
|
|
195
|
+
content: String(content),
|
|
196
|
+
model,
|
|
197
|
+
usage,
|
|
198
|
+
cost: usage.cost,
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
async chat(messages, options) {
|
|
202
|
+
const openRouterMessages = this.toOpenRouterMessages(messages);
|
|
203
|
+
const start = Math.max(0, Math.floor(options?.startModelIndex ?? 0));
|
|
204
|
+
let lastError;
|
|
205
|
+
for (let mi = start; mi < this.modelsToTry.length; mi++) {
|
|
206
|
+
const model = this.modelsToTry[mi];
|
|
207
|
+
try {
|
|
208
|
+
return await this.fetchCompletion(model, openRouterMessages);
|
|
209
|
+
}
|
|
210
|
+
catch (e) {
|
|
211
|
+
lastError = e;
|
|
212
|
+
const nextModel = this.modelsToTry[mi + 1];
|
|
213
|
+
if (nextModel && options?.docLogContext) {
|
|
214
|
+
this.warnModelSwitch(options.docLogContext.locale, options.docLogContext.relativePath, model, nextModel, e);
|
|
215
|
+
}
|
|
216
|
+
else if (!options?.docLogContext) {
|
|
217
|
+
this.logger?.warn(`Model ${model} failed: ${e}`);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
throw new Error(`All translation models failed (${this.modelsToTry.slice(start).join(", ")}). Last error: ${lastError}`);
|
|
222
|
+
}
|
|
223
|
+
stripTranslateTags(content) {
|
|
224
|
+
return content
|
|
225
|
+
.replace(/^\s*<translate>\s*/i, "")
|
|
226
|
+
.replace(/\s*<\/translate>\s*$/i, "")
|
|
227
|
+
.trim();
|
|
228
|
+
}
|
|
229
|
+
async translateDocumentSegment(content, targetLocale, glossaryHints, options) {
|
|
230
|
+
const contentType = options?.contentType ?? "markdown";
|
|
231
|
+
const { systemPrompt, userContent } = buildDocumentSinglePrompt(content, {
|
|
232
|
+
sourceLanguageLabel: this.sourceLanguageLabel,
|
|
233
|
+
targetLanguageLabel: this.languageLabelForPrompt(targetLocale),
|
|
234
|
+
glossaryHints,
|
|
235
|
+
}, contentType);
|
|
236
|
+
const res = await this.chat([
|
|
237
|
+
{ role: "system", content: systemPrompt },
|
|
238
|
+
{ role: "user", content: userContent },
|
|
239
|
+
], {
|
|
240
|
+
startModelIndex: options?.startModelIndex,
|
|
241
|
+
docLogContext: options?.docLogContext,
|
|
242
|
+
});
|
|
243
|
+
return {
|
|
244
|
+
content: this.stripTranslateTags(res.content),
|
|
245
|
+
model: res.model,
|
|
246
|
+
usage: res.usage,
|
|
247
|
+
cost: res.cost,
|
|
248
|
+
debugPrompt: { systemPrompt, userContent },
|
|
249
|
+
rawAssistantContent: res.content,
|
|
250
|
+
};
|
|
251
|
+
}
|
|
252
|
+
async translateDocumentBatch(segments, locale, glossaryHints = [], options) {
|
|
253
|
+
if (segments.length === 0) {
|
|
254
|
+
return {
|
|
255
|
+
translations: new Map(),
|
|
256
|
+
model: this.modelsToTry[0],
|
|
257
|
+
usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
|
|
258
|
+
};
|
|
259
|
+
}
|
|
260
|
+
const contentType = options?.contentType ?? "markdown";
|
|
261
|
+
const responseFormat = options?.responseFormat ?? "xml-tags";
|
|
262
|
+
const { systemPrompt, userContent } = buildDocumentBatchPrompt(segments, {
|
|
263
|
+
sourceLanguageLabel: this.sourceLanguageLabel,
|
|
264
|
+
targetLanguageLabel: this.languageLabelForPrompt(locale),
|
|
265
|
+
glossaryHints,
|
|
266
|
+
}, contentType, responseFormat);
|
|
267
|
+
const openRouterMessages = this.toOpenRouterMessages([
|
|
268
|
+
{ role: "system", content: systemPrompt },
|
|
269
|
+
{ role: "user", content: userContent },
|
|
270
|
+
]);
|
|
271
|
+
const start = Math.max(0, Math.floor(options?.startModelIndex ?? 0));
|
|
272
|
+
let lastError;
|
|
273
|
+
let lastFailureDetails;
|
|
274
|
+
for (let mi = start; mi < this.modelsToTry.length; mi++) {
|
|
275
|
+
const model = this.modelsToTry[mi];
|
|
276
|
+
let completion;
|
|
277
|
+
try {
|
|
278
|
+
completion = await this.fetchCompletion(model, openRouterMessages);
|
|
279
|
+
}
|
|
280
|
+
catch (e) {
|
|
281
|
+
lastError = e;
|
|
282
|
+
lastFailureDetails = {
|
|
283
|
+
systemPrompt,
|
|
284
|
+
userContent,
|
|
285
|
+
lastModel: model,
|
|
286
|
+
lastError: e,
|
|
287
|
+
lastRawAssistantContent: undefined,
|
|
288
|
+
};
|
|
289
|
+
const nextModel = this.modelsToTry[mi + 1];
|
|
290
|
+
if (nextModel && options?.docLogContext) {
|
|
291
|
+
this.warnModelSwitch(locale, options.docLogContext.relativePath, model, nextModel, e);
|
|
292
|
+
}
|
|
293
|
+
else if (!options?.docLogContext) {
|
|
294
|
+
if (e instanceof BatchTranslationError) {
|
|
295
|
+
this.logger?.warn(`Batch parse failed with ${model}: ${e.message}`);
|
|
296
|
+
}
|
|
297
|
+
else {
|
|
298
|
+
this.logger?.warn(`Batch request failed with ${model}: ${e}`);
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
continue;
|
|
302
|
+
}
|
|
303
|
+
try {
|
|
304
|
+
let translations;
|
|
305
|
+
if (responseFormat === "json-array") {
|
|
306
|
+
translations = parseBatchJsonArrayResponse(completion.content, segments.length);
|
|
307
|
+
}
|
|
308
|
+
else if (responseFormat === "json-object") {
|
|
309
|
+
translations = parseBatchJsonObjectResponse(completion.content, segments.length);
|
|
310
|
+
}
|
|
311
|
+
else {
|
|
312
|
+
translations = parseBatchTranslationResponse(completion.content, segments.length, completion.content);
|
|
313
|
+
}
|
|
314
|
+
return {
|
|
315
|
+
translations,
|
|
316
|
+
model: completion.model,
|
|
317
|
+
usage: completion.usage,
|
|
318
|
+
cost: completion.cost,
|
|
319
|
+
debugPrompt: { systemPrompt, userContent },
|
|
320
|
+
rawAssistantContent: completion.content,
|
|
321
|
+
};
|
|
322
|
+
}
|
|
323
|
+
catch (e) {
|
|
324
|
+
lastError = e;
|
|
325
|
+
lastFailureDetails = {
|
|
326
|
+
systemPrompt,
|
|
327
|
+
userContent,
|
|
328
|
+
lastModel: model,
|
|
329
|
+
lastError: e,
|
|
330
|
+
lastRawAssistantContent: completion.content,
|
|
331
|
+
};
|
|
332
|
+
const nextModel = this.modelsToTry[mi + 1];
|
|
333
|
+
if (nextModel && options?.docLogContext) {
|
|
334
|
+
this.warnModelSwitch(locale, options.docLogContext.relativePath, model, nextModel, e);
|
|
335
|
+
}
|
|
336
|
+
else if (!options?.docLogContext) {
|
|
337
|
+
if (e instanceof BatchTranslationError) {
|
|
338
|
+
this.logger?.warn(`Batch parse failed with ${model}: ${e.message}`);
|
|
339
|
+
}
|
|
340
|
+
else {
|
|
341
|
+
this.logger?.warn(`Batch parse failed with ${model}: ${e}`);
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
const msg = `All translation models failed for batch (${this.modelsToTry.slice(start).join(", ")}). Last error: ${lastError instanceof Error ? lastError.message : String(lastError)}`;
|
|
347
|
+
const details = lastFailureDetails ??
|
|
348
|
+
{
|
|
349
|
+
systemPrompt,
|
|
350
|
+
userContent,
|
|
351
|
+
lastModel: this.modelsToTry[Math.max(0, this.modelsToTry.length - 1)],
|
|
352
|
+
lastError,
|
|
353
|
+
lastRawAssistantContent: undefined,
|
|
354
|
+
};
|
|
355
|
+
throw new DocumentBatchAllModelsFailedError(msg, details);
|
|
356
|
+
}
|
|
357
|
+
/**
|
|
358
|
+
* UI strings: translate a batch of strings and return a JSON array response, with model fallback chain.
|
|
359
|
+
*/
|
|
360
|
+
async translateUIBatch(texts, targetLocale, options) {
|
|
361
|
+
if (texts.length === 0) {
|
|
362
|
+
return {
|
|
363
|
+
translations: [],
|
|
364
|
+
model: this.modelsToTry[0],
|
|
365
|
+
usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
|
|
366
|
+
};
|
|
367
|
+
}
|
|
368
|
+
const { systemPrompt, userContent } = buildUIPromptMessages(texts, {
|
|
369
|
+
sourceLanguageLabel: this.sourceLanguageLabel,
|
|
370
|
+
targetLanguageLabel: this.languageLabelForPrompt(targetLocale),
|
|
371
|
+
glossaryHints: options?.glossaryHints,
|
|
372
|
+
});
|
|
373
|
+
const openRouterMessages = this.toOpenRouterMessages([
|
|
374
|
+
{ role: "system", content: systemPrompt },
|
|
375
|
+
{ role: "user", content: userContent },
|
|
376
|
+
]);
|
|
377
|
+
const start = Math.max(0, Math.floor(options?.startModelIndex ?? 0));
|
|
378
|
+
let lastError;
|
|
379
|
+
for (let mi = start; mi < this.modelsToTry.length; mi++) {
|
|
380
|
+
const model = this.modelsToTry[mi];
|
|
381
|
+
try {
|
|
382
|
+
const result = await this.fetchCompletion(model, openRouterMessages);
|
|
383
|
+
const translations = parseUIJsonArrayResponse(result.content, texts.length);
|
|
384
|
+
return {
|
|
385
|
+
translations,
|
|
386
|
+
model: result.model,
|
|
387
|
+
usage: result.usage,
|
|
388
|
+
cost: result.cost,
|
|
389
|
+
};
|
|
390
|
+
}
|
|
391
|
+
catch (e) {
|
|
392
|
+
lastError = e;
|
|
393
|
+
this.logger?.warn(`UI batch failed with ${model}: ${e}`);
|
|
394
|
+
}
|
|
395
|
+
}
|
|
396
|
+
throw new Error(`All translation models failed for UI batch (${this.modelsToTry.slice(start).join(", ")}). Last error: ${lastError}`);
|
|
397
|
+
}
|
|
398
|
+
}
|
|
399
|
+
//# sourceMappingURL=openrouter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../../src/api/openrouter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import type { DocSegmentTranslation, I18nConfig, I18nDocTranslateConfig } from "../core/types.js";
|
|
2
|
+
export type { DocSegmentTranslation };
|
|
3
|
+
import { TranslationCache } from "../core/cache.js";
|
|
4
|
+
import { PlaceholderHandler } from "../processors/placeholder-handler.js";
|
|
5
|
+
import { Glossary } from "../glossary/glossary.js";
|
|
6
|
+
import { OpenRouterClient } from "../api/openrouter.js";
|
|
7
|
+
import type { DocumentBatchResponseFormat } from "../core/prompt-builder.js";
|
|
8
|
+
import { AsyncMutex } from "../utils/concurrency.js";
|
|
9
|
+
/** Batch segment prompt/response shape for `translate-docs --prompt-format`. */
|
|
10
|
+
export type TranslatePromptFormat = "xml" | "json-array" | "json-object";
|
|
11
|
+
export declare function translatePromptFormatToResponseFormat(fmt: TranslatePromptFormat | undefined): DocumentBatchResponseFormat;
|
|
12
|
+
export interface TranslateRunOptions {
|
|
13
|
+
cwd: string;
|
|
14
|
+
locales: string[];
|
|
15
|
+
dryRun: boolean;
|
|
16
|
+
force: boolean;
|
|
17
|
+
/**
|
|
18
|
+
* Re-run each file even when file hash matches tracking + output exists; segment cache still applies (unlike `force`).
|
|
19
|
+
*/
|
|
20
|
+
forceUpdate: boolean;
|
|
21
|
+
noCache: boolean;
|
|
22
|
+
verbose: boolean;
|
|
23
|
+
pathFilter?: string;
|
|
24
|
+
typeFilter?: "markdown" | "json";
|
|
25
|
+
jsonOnly?: boolean;
|
|
26
|
+
noJson?: boolean;
|
|
27
|
+
/** Path to the active log file (printed in the header block). */
|
|
28
|
+
logPath?: string;
|
|
29
|
+
/**
|
|
30
|
+
* Max parallel target locales (CLI `-j`). Effective default set in `runTranslate` from config (3).
|
|
31
|
+
*/
|
|
32
|
+
concurrency?: number;
|
|
33
|
+
/**
|
|
34
|
+
* Max parallel batch API calls per file (CLI `-b`). Effective default set in `runTranslate` from config (4).
|
|
35
|
+
*/
|
|
36
|
+
batchConcurrency?: number;
|
|
37
|
+
/** Internal: serialize SQLite cache access when multiple locales run in parallel. */
|
|
38
|
+
cacheMutex?: AsyncMutex;
|
|
39
|
+
/** Which `documentations` block index (namespaces file_tracking keys in the shared cache). */
|
|
40
|
+
documentationBlockIndex?: number;
|
|
41
|
+
/**
|
|
42
|
+
* Batch segment prompt/response shape (`translate-docs --prompt-format`).
|
|
43
|
+
* Default `xml`: <seg>/<t>; `json-array` / `json-object` match {@link buildDocumentBatchPrompt} JSON modes.
|
|
44
|
+
*/
|
|
45
|
+
promptFormat?: TranslatePromptFormat;
|
|
46
|
+
}
|
|
47
|
+
export interface TranslateTotals {
|
|
48
|
+
filesWritten: number;
|
|
49
|
+
filesSkipped: number;
|
|
50
|
+
/** Files that ran translation (not file-level skipped); includes dry-run. */
|
|
51
|
+
filesProcessed?: number;
|
|
52
|
+
inputTokens: number;
|
|
53
|
+
outputTokens: number;
|
|
54
|
+
costUsd?: number;
|
|
55
|
+
/** Translatable segments resolved from SQLite cache (per file or summed in `runTranslate`). */
|
|
56
|
+
segmentsCached?: number;
|
|
57
|
+
/** Translatable segments translated via API (or dry-run) this run. */
|
|
58
|
+
segmentsTranslated?: number;
|
|
59
|
+
}
|
|
60
|
+
type ProtectState = ReturnType<PlaceholderHandler["protectForTranslation"]> & {
|
|
61
|
+
glossaryForceReplacements?: string[];
|
|
62
|
+
};
|
|
63
|
+
/** Glossary forced tokens first, then markdown URL/admonition/emphasis protection when `useMarkdownPlaceholders`. */
|
|
64
|
+
export declare function protectSegmentForTranslation(raw: string, glossary: Glossary, locale: string, useMarkdownPlaceholders: boolean): {
|
|
65
|
+
text: string;
|
|
66
|
+
state: ProtectState;
|
|
67
|
+
};
|
|
68
|
+
export declare function shouldRunMarkdown(opts: TranslateRunOptions, config: I18nDocTranslateConfig): boolean;
|
|
69
|
+
export declare function shouldRunJson(opts: TranslateRunOptions, config: I18nDocTranslateConfig): boolean;
|
|
70
|
+
export declare function matchesPathFilter(relPath: string, filter: string | undefined): boolean;
|
|
71
|
+
export declare function translateMarkdownFile(absSource: string, relPath: string, locale: string, config: I18nDocTranslateConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>, translatedMarkdownRelPaths: ReadonlySet<string>): Promise<{
|
|
72
|
+
skipped: boolean;
|
|
73
|
+
totals: TranslateTotals;
|
|
74
|
+
}>;
|
|
75
|
+
export declare function translateJsonFile(absSource: string, relPath: string, locale: string, config: I18nDocTranslateConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>): Promise<{
|
|
76
|
+
skipped: boolean;
|
|
77
|
+
totals: TranslateTotals;
|
|
78
|
+
}>;
|
|
79
|
+
/** Translate one SVG asset (`translate-svg`); uses `config.svg` for paths and optional `svg.svgExtractor`. */
|
|
80
|
+
export declare function translateSvgAssetFile(absSource: string, relPathFromCwd: string, relPathFromSourceRoot: string, locale: string, config: I18nConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>): Promise<{
|
|
81
|
+
skipped: boolean;
|
|
82
|
+
totals: TranslateTotals;
|
|
83
|
+
}>;
|
|
84
|
+
export declare function rewriteSourceMarkdownLanguageListBlocks(config: I18nDocTranslateConfig, opts: TranslateRunOptions, markdownFiles: string[]): number;
|
|
85
|
+
/** Run translate for all enabled kinds and locales. */
|
|
86
|
+
export declare function runTranslate(config: I18nDocTranslateConfig, opts: TranslateRunOptions, files: {
|
|
87
|
+
markdown: string[];
|
|
88
|
+
json: string[];
|
|
89
|
+
}, jsonAbsRoot: string): Promise<TranslateTotals>;
|
|
90
|
+
//# sourceMappingURL=doc-translate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doc-translate.d.ts","sourceRoot":"","sources":["../../src/cli/doc-translate.ts"],"names":[],"mappings":"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"}
|