Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

Crowdin autotranslate script

Blue Mouse2598cbf714cd
diff --git a/web/package-lock.json b/web/package-lock.json
index 046a8bc52..79a086f06 100644
--- a/web/package-lock.json
+++ b/web/package-lock.json
@@ -60,6 +60,8 @@
"vaul": "^1.1.2"
},
"devDependencies": {
+ "@crowdin/crowdin-api-client": "^1.55.1",
+ "@google/genai": "^1.50.1",
"@react-router/dev": "^7.14.0",
"@tailwindcss/forms": "^0.5.11",
"@tailwindcss/typography": "^0.5.19",
@@ -554,6 +556,19 @@
"node": ">=6.9.0"
}
},
+ "node_modules/@crowdin/crowdin-api-client": {
+ "version": "1.55.1",
+ "resolved": "https://registry.npmjs.org/@crowdin/crowdin-api-client/-/crowdin-api-client-1.55.1.tgz",
+ "integrity": "sha512-uH2lH9wr7krBPKVttrj1EiV0P7AgSjQWYhyej4GjI58agHYFUjSFiMAs+7r8lJmJSQhl7oUOOJen4yD/njDNbw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "axios": "1.14.0"
+ },
+ "engines": {
+ "node": ">=12.9.0"
+ }
+ },
"node_modules/@emnapi/core": {
"version": "1.9.1",
"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.9.1.tgz",
@@ -1080,6 +1095,30 @@
"integrity": "sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ==",
"license": "MIT"
},
+ "node_modules/@google/genai": {
+ "version": "1.50.1",
+ "resolved": "https://registry.npmjs.org/@google/genai/-/genai-1.50.1.tgz",
+ "integrity": "sha512-YbkX7H9+1Pt8wOt7DDREy8XSoiL6fRDzZQRyaVBarFf8MR3zHGqVdvM4cLbDXqPhxqvegZShgfxb8kw9C7YhAQ==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "google-auth-library": "^10.3.0",
+ "p-retry": "^4.6.2",
+ "protobufjs": "^7.5.4",
+ "ws": "^8.18.0"
+ },
+ "engines": {
+ "node": ">=20.0.0"
+ },
+ "peerDependencies": {
+ "@modelcontextprotocol/sdk": "^1.25.2"
+ },
+ "peerDependenciesMeta": {
+ "@modelcontextprotocol/sdk": {
+ "optional": true
+ }
+ }
+ },
"node_modules/@headlessui/react": {
"version": "2.2.10",
"resolved": "https://registry.npmjs.org/@headlessui/react/-/react-2.2.10.tgz",
@@ -2628,6 +2667,80 @@
"react-dom": ">= 16.8"
}
},
+ "node_modules/@protobufjs/aspromise": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz",
+ "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/base64": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/@protobufjs/base64/-/base64-1.1.2.tgz",
+ "integrity": "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/codegen": {
+ "version": "2.0.4",
+ "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.4.tgz",
+ "integrity": "sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/eventemitter": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@protobufjs/eventemitter/-/eventemitter-1.1.0.tgz",
+ "integrity": "sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/fetch": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.0.tgz",
+ "integrity": "sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==",
+ "dev": true,
+ "license": "BSD-3-Clause",
+ "dependencies": {
+ "@protobufjs/aspromise": "^1.1.1",
+ "@protobufjs/inquire": "^1.1.0"
+ }
+ },
+ "node_modules/@protobufjs/float": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/@protobufjs/float/-/float-1.0.2.tgz",
+ "integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/inquire": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.0.tgz",
+ "integrity": "sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/path": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/@protobufjs/path/-/path-1.1.2.tgz",
+ "integrity": "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/pool": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@protobufjs/pool/-/pool-1.1.0.tgz",
+ "integrity": "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/@protobufjs/utf8": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.0.tgz",
+ "integrity": "sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
"node_modules/@radix-ui/primitive": {
"version": "1.1.3",
"resolved": "https://registry.npmjs.org/@radix-ui/primitive/-/primitive-1.1.3.tgz",
@@ -4952,6 +5065,13 @@
"@types/react": "^19.2.0"
}
},
+ "node_modules/@types/retry": {
+ "version": "0.12.0",
+ "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz",
+ "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/@types/sanitize-html": {
"version": "2.16.1",
"resolved": "https://registry.npmjs.org/@types/sanitize-html/-/sanitize-html-2.16.1.tgz",
@@ -5015,6 +5135,16 @@
"node": ">= 0.6"
}
},
+ "node_modules/agent-base": {
+ "version": "7.1.4",
+ "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+ "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 14"
+ }
+ },
"node_modules/arg": {
"version": "5.0.2",
"resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
@@ -5040,6 +5170,25 @@
"integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
"license": "MIT"
},
+ "node_modules/asynckit": {
+ "version": "0.4.0",
+ "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+ "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/axios": {
+ "version": "1.14.0",
+ "resolved": "https://registry.npmjs.org/axios/-/axios-1.14.0.tgz",
+ "integrity": "sha512-3Y8yrqLSwjuzpXuZ0oIYZ/XGgLwUIBU3uLvbcpb0pidD9ctpShJd43KSlEEkVQg6DS0G9NKyzOvBfUtDKEyHvQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "follow-redirects": "^1.15.11",
+ "form-data": "^4.0.5",
+ "proxy-from-env": "^2.1.0"
+ }
+ },
"node_modules/babel-dead-code-elimination": {
"version": "1.0.11",
"resolved": "https://registry.npmjs.org/babel-dead-code-elimination/-/babel-dead-code-elimination-1.0.11.tgz",
@@ -5059,6 +5208,27 @@
"integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
"license": "MIT"
},
+ "node_modules/base64-js": {
+ "version": "1.5.1",
+ "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+ "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/feross"
+ },
+ {
+ "type": "patreon",
+ "url": "https://www.patreon.com/feross"
+ },
+ {
+ "type": "consulting",
+ "url": "https://feross.org/support"
+ }
+ ],
+ "license": "MIT"
+ },
"node_modules/baseline-browser-mapping": {
"version": "2.9.11",
"resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.11.tgz",
@@ -5087,6 +5257,16 @@
"integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
"license": "MIT"
},
+ "node_modules/bignumber.js": {
+ "version": "9.3.1",
+ "resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-9.3.1.tgz",
+ "integrity": "sha512-Ko0uX15oIUS7wJ3Rb30Fs6SkVbLmPBAKdlm7q9+ak9bbIeFf0MwuBsQV6z7+X768/cHsfg+WlysDWJcmthjsjQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "*"
+ }
+ },
"node_modules/billboard.js": {
"version": "3.18.0",
"resolved": "https://registry.npmjs.org/billboard.js/-/billboard.js-3.18.0.tgz",
@@ -5239,6 +5419,13 @@
"node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
}
},
+ "node_modules/buffer-equal-constant-time": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz",
+ "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==",
+ "dev": true,
+ "license": "BSD-3-Clause"
+ },
"node_modules/buffer-from": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
@@ -5339,6 +5526,19 @@
"node": ">=6"
}
},
+ "node_modules/combined-stream": {
+ "version": "1.0.8",
+ "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+ "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "delayed-stream": "~1.0.0"
+ },
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
"node_modules/commander": {
"version": "7.2.0",
"resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz",
@@ -5991,6 +6191,16 @@
"node": ">=12"
}
},
+ "node_modules/data-uri-to-buffer": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-4.0.1.tgz",
+ "integrity": "sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 12"
+ }
+ },
"node_modules/dayjs": {
"version": "1.11.20",
"resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.20.tgz",
@@ -6047,6 +6257,16 @@
"robust-predicates": "^3.0.2"
}
},
+ "node_modules/delayed-stream": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+ "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.4.0"
+ }
+ },
"node_modules/depd": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
@@ -6188,6 +6408,16 @@
"node": ">= 0.4"
}
},
+ "node_modules/ecdsa-sig-formatter": {
+ "version": "1.0.11",
+ "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz",
+ "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "safe-buffer": "^5.0.1"
+ }
+ },
"node_modules/ee-first": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
@@ -6272,6 +6502,22 @@
"node": ">= 0.4"
}
},
+ "node_modules/es-set-tostringtag": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+ "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0",
+ "get-intrinsic": "^1.2.6",
+ "has-tostringtag": "^1.0.2",
+ "hasown": "^2.0.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/esbuild": {
"version": "0.17.19",
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.17.19.tgz",
@@ -6427,6 +6673,13 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/extend": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
+ "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/fast-glob": {
"version": "3.3.3",
"resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
@@ -6530,6 +6783,30 @@
}
}
},
+ "node_modules/fetch-blob": {
+ "version": "3.2.0",
+ "resolved": "https://registry.npmjs.org/fetch-blob/-/fetch-blob-3.2.0.tgz",
+ "integrity": "sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/jimmywarting"
+ },
+ {
+ "type": "paypal",
+ "url": "https://paypal.me/jimmywarting"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "node-domexception": "^1.0.0",
+ "web-streams-polyfill": "^3.0.3"
+ },
+ "engines": {
+ "node": "^12.20 || >= 14.13"
+ }
+ },
"node_modules/file-saver": {
"version": "2.0.5",
"resolved": "https://registry.npmjs.org/file-saver/-/file-saver-2.0.5.tgz",
@@ -6598,6 +6875,44 @@
"url": "https://github.com/sponsors/sindresorhus"
}
},
+ "node_modules/follow-redirects": {
+ "version": "1.16.0",
+ "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz",
+ "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "individual",
+ "url": "https://github.com/sponsors/RubenVerborgh"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=4.0"
+ },
+ "peerDependenciesMeta": {
+ "debug": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/form-data": {
+ "version": "4.0.5",
+ "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz",
+ "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "asynckit": "^0.4.0",
+ "combined-stream": "^1.0.8",
+ "es-set-tostringtag": "^2.1.0",
+ "hasown": "^2.0.2",
+ "mime-types": "^2.1.12"
+ },
+ "engines": {
+ "node": ">= 6"
+ }
+ },
"node_modules/formatly": {
"version": "0.3.0",
"resolved": "https://registry.npmjs.org/formatly/-/formatly-0.3.0.tgz",
@@ -6614,6 +6929,19 @@
"node": ">=18.3.0"
}
},
+ "node_modules/formdata-polyfill": {
+ "version": "4.0.10",
+ "resolved": "https://registry.npmjs.org/formdata-polyfill/-/formdata-polyfill-4.0.10.tgz",
+ "integrity": "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "fetch-blob": "^3.1.2"
+ },
+ "engines": {
+ "node": ">=12.20.0"
+ }
+ },
"node_modules/forwarded": {
"version": "0.2.0",
"resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
@@ -6683,6 +7011,55 @@
"url": "https://github.com/sponsors/ljharb"
}
},
+ "node_modules/gaxios": {
+ "version": "7.1.4",
+ "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-7.1.4.tgz",
+ "integrity": "sha512-bTIgTsM2bWn3XklZISBTQX7ZSddGW+IO3bMdGaemHZ3tbqExMENHLx6kKZ/KlejgrMtj8q7wBItt51yegqalrA==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "extend": "^3.0.2",
+ "https-proxy-agent": "^7.0.1",
+ "node-fetch": "^3.3.2"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/gaxios/node_modules/node-fetch": {
+ "version": "3.3.2",
+ "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-3.3.2.tgz",
+ "integrity": "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "data-uri-to-buffer": "^4.0.0",
+ "fetch-blob": "^3.1.4",
+ "formdata-polyfill": "^4.0.10"
+ },
+ "engines": {
+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/node-fetch"
+ }
+ },
+ "node_modules/gcp-metadata": {
+ "version": "8.1.2",
+ "resolved": "https://registry.npmjs.org/gcp-metadata/-/gcp-metadata-8.1.2.tgz",
+ "integrity": "sha512-zV/5HKTfCeKWnxG0Dmrw51hEWFGfcF2xiXqcA3+J90WDuP0SvoiSO5ORvcBsifmx/FoIjgQN3oNOGaQ5PhLFkg==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "gaxios": "^7.0.0",
+ "google-logging-utils": "^1.0.0",
+ "json-bigint": "^1.0.0"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
"node_modules/gensync": {
"version": "1.0.0-beta.2",
"resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
@@ -6773,6 +7150,34 @@
"url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
}
},
+ "node_modules/google-auth-library": {
+ "version": "10.6.2",
+ "resolved": "https://registry.npmjs.org/google-auth-library/-/google-auth-library-10.6.2.tgz",
+ "integrity": "sha512-e27Z6EThmVNNvtYASwQxose/G57rkRuaRbQyxM2bvYLLX/GqWZ5chWq2EBoUchJbCc57eC9ArzO5wMsEmWftCw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "base64-js": "^1.3.0",
+ "ecdsa-sig-formatter": "^1.0.11",
+ "gaxios": "^7.1.4",
+ "gcp-metadata": "8.1.2",
+ "google-logging-utils": "1.1.3",
+ "jws": "^4.0.0"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/google-logging-utils": {
+ "version": "1.1.3",
+ "resolved": "https://registry.npmjs.org/google-logging-utils/-/google-logging-utils-1.1.3.tgz",
+ "integrity": "sha512-eAmLkjDjAFCVXg7A1unxHsLf961m6y17QFqXqAXGj/gVkKFrEICfStRfwUlGNfeCEjNRa32JEWOUTlYXPyyKvA==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=14"
+ }
+ },
"node_modules/gopd": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
@@ -6803,6 +7208,22 @@
"url": "https://github.com/sponsors/ljharb"
}
},
+ "node_modules/has-tostringtag": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+ "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "has-symbols": "^1.0.3"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
"node_modules/hasown": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
@@ -6863,6 +7284,20 @@
"url": "https://opencollective.com/express"
}
},
+ "node_modules/https-proxy-agent": {
+ "version": "7.0.6",
+ "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+ "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "agent-base": "^7.1.2",
+ "debug": "4"
+ },
+ "engines": {
+ "node": ">= 14"
+ }
+ },
"node_modules/i18n-iso-countries": {
"version": "7.14.0",
"resolved": "https://registry.npmjs.org/i18n-iso-countries/-/i18n-iso-countries-7.14.0.tgz",
@@ -7094,6 +7529,16 @@
"node": ">=6"
}
},
+ "node_modules/json-bigint": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/json-bigint/-/json-bigint-1.0.0.tgz",
+ "integrity": "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "bignumber.js": "^9.0.0"
+ }
+ },
"node_modules/json5": {
"version": "2.2.3",
"resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
@@ -7119,6 +7564,29 @@
"setimmediate": "^1.0.5"
}
},
+ "node_modules/jwa": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz",
+ "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "buffer-equal-constant-time": "^1.0.1",
+ "ecdsa-sig-formatter": "1.0.11",
+ "safe-buffer": "^5.0.1"
+ }
+ },
+ "node_modules/jws": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz",
+ "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "jwa": "^2.0.1",
+ "safe-buffer": "^5.0.1"
+ }
+ },
"node_modules/knip": {
"version": "6.3.1",
"resolved": "https://registry.npmjs.org/knip/-/knip-6.3.1.tgz",
@@ -7458,6 +7926,13 @@
"integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
"license": "MIT"
},
+ "node_modules/long": {
+ "version": "5.3.2",
+ "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",
+ "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==",
+ "dev": true,
+ "license": "Apache-2.0"
+ },
"node_modules/loose-envify": {
"version": "1.4.0",
"resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
@@ -7742,6 +8217,27 @@
"node": ">= 0.6"
}
},
+ "node_modules/node-domexception": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/node-domexception/-/node-domexception-1.0.0.tgz",
+ "integrity": "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==",
+ "deprecated": "Use your platform's native DOMException instead",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/jimmywarting"
+ },
+ {
+ "type": "github",
+ "url": "https://paypal.me/jimmywarting"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=10.5.0"
+ }
+ },
"node_modules/node-fetch": {
"version": "2.7.0",
"resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
@@ -8009,6 +8505,20 @@
"url": "https://github.com/sponsors/sindresorhus"
}
},
+ "node_modules/p-retry": {
+ "version": "4.6.2",
+ "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz",
+ "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/retry": "0.12.0",
+ "retry": "^0.13.1"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
"node_modules/pako": {
"version": "1.0.11",
"resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
@@ -8190,6 +8700,31 @@
"react-is": "^16.13.1"
}
},
+ "node_modules/protobufjs": {
+ "version": "7.5.5",
+ "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.5.tgz",
+ "integrity": "sha512-3wY1AxV+VBNW8Yypfd1yQY9pXnqTAN+KwQxL8iYm3/BjKYMNg4i0owhEe26PWDOMaIrzeeF98Lqd5NGz4omiIg==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "BSD-3-Clause",
+ "dependencies": {
+ "@protobufjs/aspromise": "^1.1.2",
+ "@protobufjs/base64": "^1.1.2",
+ "@protobufjs/codegen": "^2.0.4",
+ "@protobufjs/eventemitter": "^1.1.0",
+ "@protobufjs/fetch": "^1.1.0",
+ "@protobufjs/float": "^1.0.2",
+ "@protobufjs/inquire": "^1.1.0",
+ "@protobufjs/path": "^1.1.2",
+ "@protobufjs/pool": "^1.1.0",
+ "@protobufjs/utf8": "^1.1.0",
+ "@types/node": ">=13.7.0",
+ "long": "^5.0.0"
+ },
+ "engines": {
+ "node": ">=12.0.0"
+ }
+ },
"node_modules/proxy-addr": {
"version": "2.0.7",
"resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
@@ -8203,6 +8738,16 @@
"node": ">= 0.10"
}
},
+ "node_modules/proxy-from-env": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-2.1.0.tgz",
+ "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=10"
+ }
+ },
"node_modules/qr.js": {
"version": "0.0.0",
"resolved": "https://registry.npmjs.org/qr.js/-/qr.js-0.0.0.tgz",
@@ -8678,6 +9223,16 @@
"url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
}
},
+ "node_modules/retry": {
+ "version": "0.13.1",
+ "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",
+ "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 4"
+ }
+ },
"node_modules/reusify": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
@@ -10155,6 +10710,16 @@
"node": "20 || >=22"
}
},
+ "node_modules/web-streams-polyfill": {
+ "version": "3.3.3",
+ "resolved": "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz",
+ "integrity": "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 8"
+ }
+ },
"node_modules/webidl-conversions": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
@@ -10193,6 +10758,28 @@
"node": ">= 8"
}
},
+ "node_modules/ws": {
+ "version": "8.20.0",
+ "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+ "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=10.0.0"
+ },
+ "peerDependencies": {
+ "bufferutil": "^4.0.1",
+ "utf-8-validate": ">=5.0.2"
+ },
+ "peerDependenciesMeta": {
+ "bufferutil": {
+ "optional": true
+ },
+ "utf-8-validate": {
+ "optional": true
+ }
+ }
+ },
"node_modules/yallist": {
"version": "3.1.1",
"resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
diff --git a/web/package.json b/web/package.json
index 383ca1923..23eca2871 100644
--- a/web/package.json
+++ b/web/package.json
@@ -15,7 +15,8 @@
"lint:tsc": "tsc --noEmit",
"format": "oxfmt --write ./app",
"format:check": "oxfmt --check ./app",
- "knip": "knip"
+ "knip": "knip",
+ "translate": "node scripts/translate.js"
},
"dependencies": {
"@headlessui/react": "^2.2.10",
@@ -72,6 +73,8 @@
"vaul": "^1.1.2"
},
"devDependencies": {
+ "@crowdin/crowdin-api-client": "^1.55.1",
+ "@google/genai": "^1.50.1",
"@react-router/dev": "^7.14.0",
"@tailwindcss/forms": "^0.5.11",
"@tailwindcss/typography": "^0.5.19",
diff --git a/web/scripts/translate.js b/web/scripts/translate.js
new file mode 100644
index 000000000..edd2b0514
--- /dev/null
+++ b/web/scripts/translate.js
@@ -0,0 +1,588 @@
+#!/usr/bin/env node
+/**
+ * Auto-translate untranslated Crowdin source strings via Gemini.
+ *
+ * Workflow:
+ * 1. crowdin upload (uploads new keys from en.json to Crowdin)
+ * 2. node web/scripts/translate.js (this script — translates missing strings)
+ * 3. crowdin download (pulls translations back into web/public/locales/*.json)
+ *
+ * Usage:
+ * GEMINI_API_KEY=... node web/scripts/translate.js [options]
+ *
+ * Options:
+ * --languages=<csv> Restrict to specific target language IDs (e.g. de,uk).
+ * --limit=<n> Cap untranslated strings per language (debug aid).
+ * --dry-run Translate but skip uploading to Crowdin.
+ * --help, -h Show help.
+ *
+ * Environment:
+ * GEMINI_API_KEY Required. Google AI Studio API key.
+ * CROWDIN_API_TOKEN Optional. Overrides token from crowdin.yml.
+ * CROWDIN_PROJECT_ID Optional. Overrides project_id from crowdin.yml.
+ */
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { Client } from '@crowdin/crowdin-api-client'
+import { GoogleGenAI } from '@google/genai'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const WEB_DIR = path.resolve(__dirname, '..')
+const CROWDIN_YML = path.join(WEB_DIR, 'crowdin.yml')
+
+const CONFIG = {
+ GEMINI_MODEL: 'gemini-3.1-pro-preview',
+ THINKING_LEVEL: 'low',
+ BATCH_SIZE: 25,
+ LANGUAGE_CONCURRENCY: 4,
+ PER_LANGUAGE_BATCH_CONCURRENCY: 2,
+ UPLOAD_CONCURRENCY: 8,
+ MAX_RETRIES: 4,
+ INITIAL_RETRY_DELAY_MS: 1000,
+}
+
+// ---------------------------------------------------------------- helpers --
+
+const ansi = (code) => (s) => `\x1b[${code}m${s}\x1b[0m`
+const c = {
+ bold: ansi('1'),
+ dim: ansi('2'),
+ red: ansi('31'),
+ green: ansi('32'),
+ yellow: ansi('33'),
+ blue: ansi('34'),
+ cyan: ansi('36'),
+ gray: ansi('90'),
+}
+const log = (...a) => console.log(...a)
+const info = (...a) => console.log(c.cyan('info'), ...a)
+const warn = (...a) => console.log(c.yellow('warn'), ...a)
+const fail = (...a) => console.error(c.red('err '), ...a)
+const ok = (...a) => console.log(c.green(' ok '), ...a)
+const tag = (label) => c.gray(`[${label}]`)
+
+function parseArgs(argv) {
+ const out = { languages: null, dryRun: false, limit: null, help: false }
+ for (const a of argv.slice(2)) {
+ if (a === '--help' || a === '-h') out.help = true
+ else if (a === '--dry-run') out.dryRun = true
+ else if (a.startsWith('--languages=')) {
+ out.languages = a
+ .slice('--languages='.length)
+ .split(',')
+ .map((s) => s.trim())
+ .filter(Boolean)
+ } else if (a.startsWith('--limit=')) {
+ const n = Number.parseInt(a.slice('--limit='.length), 10)
+ if (!Number.isFinite(n) || n <= 0) throw new Error(`Invalid --limit value: ${a}`)
+ out.limit = n
+ } else throw new Error(`Unknown argument: ${a} (try --help)`)
+ }
+ return out
+}
+
+function printHelp() {
+ log(`${c.bold('translate.js')} — auto-fill missing Crowdin translations via Gemini.
+
+${c.bold('Usage')}
+ GEMINI_API_KEY=... node web/scripts/translate.js [options]
+
+${c.bold('Options')}
+ --languages=<csv> Restrict to specific target language IDs (e.g. de,uk).
+ --limit=<n> Cap number of untranslated strings per language (debug).
+ --dry-run Fetch + translate but skip uploading to Crowdin.
+ --help, -h Show this help.
+
+${c.bold('Environment')}
+ GEMINI_API_KEY Required. Google AI Studio API key.
+ CROWDIN_API_TOKEN Optional. Overrides token from crowdin.yml.
+ CROWDIN_PROJECT_ID Optional. Overrides project_id from crowdin.yml.
+`)
+}
+
+async function loadCrowdinConfig() {
+ let projectId = process.env.CROWDIN_PROJECT_ID
+ let token = process.env.CROWDIN_API_TOKEN
+
+ if (!projectId || !token) {
+ const yml = await fs.readFile(CROWDIN_YML, 'utf8').catch(() => null)
+ if (!yml) {
+ throw new Error(
+ `crowdin.yml not found at ${CROWDIN_YML}. Set CROWDIN_API_TOKEN and CROWDIN_PROJECT_ID env vars instead.`,
+ )
+ }
+ projectId ||= yml.match(/['"]?project_id['"]?\s*:\s*['"]([^'"]+)['"]/)?.[1] ?? null
+ token ||= yml.match(/['"]?api_token['"]?\s*:\s*['"]([^'"]+)['"]/)?.[1] ?? null
+ }
+ if (!projectId) throw new Error('Could not determine Crowdin project_id (set CROWDIN_PROJECT_ID).')
+ if (!token) throw new Error('Could not determine Crowdin api_token (set CROWDIN_API_TOKEN).')
+
+ const id = Number(projectId)
+ if (!Number.isFinite(id)) throw new Error(`Crowdin project_id is not a number: ${projectId}`)
+
+ return { projectId: id, token }
+}
+
+async function pMap(items, mapper, concurrency = 4) {
+ const results = new Array(items.length)
+ let cursor = 0
+ let aborted = false
+ let abortError = null
+
+ async function worker() {
+ while (!aborted) {
+ const idx = cursor++
+ if (idx >= items.length) return
+ try {
+ results[idx] = await mapper(items[idx], idx)
+ } catch (e) {
+ aborted = true
+ abortError = e
+ }
+ }
+ }
+
+ await Promise.all(
+ Array.from({ length: Math.min(Math.max(concurrency, 1), items.length) }, () => worker()),
+ )
+ if (aborted) throw abortError
+ return results
+}
+
+async function withRetry(fn, { retries = CONFIG.MAX_RETRIES, baseDelay = CONFIG.INITIAL_RETRY_DELAY_MS, label = 'op' } = {}) {
+ let lastErr
+ for (let attempt = 0; attempt <= retries; attempt++) {
+ try {
+ return await fn()
+ } catch (e) {
+ lastErr = e
+ const status = httpStatus(e)
+ const isLast = attempt === retries
+ const isClientError =
+ typeof status === 'number' && status >= 400 && status < 500 && status !== 408 && status !== 429
+ if (isLast || isClientError) throw e
+ const delay = baseDelay * 2 ** attempt + Math.floor(Math.random() * 250)
+ warn(`${label}: attempt ${attempt + 1} failed (${e?.message ?? e}); retrying in ${delay}ms`)
+ await sleep(delay)
+ }
+ }
+ throw lastErr
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+function httpStatus(e) {
+ const candidates = [e?.response?.status, e?.status, e?.statusCode, typeof e?.code === 'number' ? e.code : null]
+ for (const v of candidates) if (typeof v === 'number') return v
+ return null
+}
+
+function chunk(arr, size) {
+ const out = []
+ for (let i = 0; i < arr.length; i += size) out.push(arr.slice(i, i + size))
+ return out
+}
+
+// ---------------------------------------------------------------- crowdin --
+
+class CrowdinService {
+ constructor({ projectId, token }) {
+ this.projectId = projectId
+ const client = new Client({ token })
+ this.projectsApi = client.projectsGroupsApi
+ this.sourceStringsApi = client.sourceStringsApi
+ this.stringTranslationsApi = client.stringTranslationsApi
+ }
+
+ async getTargetLanguages() {
+ const res = await withRetry(() => this.projectsApi.getProject(this.projectId), {
+ label: 'crowdin.getProject',
+ })
+ return res.data.targetLanguages.map((l) => ({
+ id: l.id,
+ name: l.name,
+ locale: l.locale,
+ twoLettersCode: l.twoLettersCode,
+ }))
+ }
+
+ async listAllSourceStrings() {
+ const res = await withRetry(
+ () => this.sourceStringsApi.withFetchAll().listProjectStrings(this.projectId),
+ { label: 'crowdin.listSourceStrings' },
+ )
+ return res.data.map((d) => ({
+ id: d.data.id,
+ identifier: d.data.identifier,
+ key: d.data.key ?? d.data.identifier,
+ text: typeof d.data.text === 'string' ? d.data.text : null,
+ context: d.data.context || '',
+ isHidden: !!d.data.isHidden,
+ }))
+ }
+
+ async listTranslatedStringIds(languageId) {
+ const res = await withRetry(
+ () =>
+ this.stringTranslationsApi
+ .withFetchAll()
+ .listLanguageTranslations(this.projectId, languageId),
+ { label: `crowdin.listLanguageTranslations(${languageId})` },
+ )
+ const ids = new Set()
+ for (const t of res.data) {
+ const sid = t.data.stringId ?? t.data.string_id
+ if (typeof sid === 'number') ids.add(sid)
+ }
+ return ids
+ }
+
+ async addTranslation({ stringId, languageId, text }) {
+ return await withRetry(
+ () =>
+ this.stringTranslationsApi.addTranslation(this.projectId, {
+ stringId,
+ languageId,
+ text,
+ }),
+ { label: `crowdin.addTranslation(${languageId}#${stringId})` },
+ )
+ }
+}
+
+// ----------------------------------------------------------------- gemini --
+
+class GeminiTranslator {
+ constructor({ apiKey }) {
+ this.ai = new GoogleGenAI({ apiKey })
+ }
+
+ buildSystemInstruction(language) {
+ const langLabel = language.name
+ ? `${language.name} (${language.id})`
+ : language.id
+ return [
+ `You are a professional UI/UX translator working on Swetrix — a privacy-focused, developer-oriented web analytics product.`,
+ `Translate the supplied user interface strings from English into ${langLabel}.`,
+ ``,
+ `Rules (all are mandatory):`,
+ `1. Preserve every interpolation placeholder verbatim, exactly as it appears: {{name}}, {{count}}, {{max}} — do not translate, reorder, rename, or alter casing.`,
+ `2. Preserve every HTML/JSX-like tag verbatim, including unusual ones such as <0>, <1>, <span>, <integrationLink>, <discordUrl>. Translate only the text BETWEEN tags. Keep tag pairs balanced.`,
+ `3. Do not translate brand names: Swetrix, Google Analytics, Matomo, Plausible, Stripe, Paddle, GitHub, Discord, Telegram, Slack, etc.`,
+ `4. Keep widely accepted technical terms (API, URL, dashboard, analytics, GDPR, CAPTCHA, dashboard, webhook, etc.) in the form most natural for the target language — translate only when a well-established native term exists.`,
+ `5. Match the formality, capitalization style, and punctuation of the source. Sentence case in source → sentence case in target. Imperative mood → imperative mood.`,
+ `6. Keep translations concise; UI labels should be short. Prefer the natural phrasing a native speaker would use.`,
+ `7. Do not add explanations, quotes, prefixes, suffixes, or commentary. Return ONLY the translation text.`,
+ `8. Treat the "key" path as additional context about WHERE the string is used in the UI — use it to choose the right tone (e.g. button labels vs error messages vs marketing copy).`,
+ `9. If a source string is purely a placeholder/URL/email/number/code, output it unchanged.`,
+ ].join('\n')
+ }
+
+ buildBatchPrompt(items) {
+ const payload = items.map((s) => ({
+ id: s.batchId,
+ key: s.key,
+ source: s.text,
+ ...(s.context ? { context: s.context } : {}),
+ }))
+ return [
+ `Translate the following ${items.length} strings.`,
+ `Each string has an "id" (integer), a "key" (dot-path describing UI location), the English "source" text, and optionally a "context" hint.`,
+ ``,
+ `Return a JSON array containing one object per input, each shaped like {"id": <integer>, "text": <translation>}.`,
+ `The output array must contain exactly ${items.length} objects, one per input id, in any order.`,
+ ``,
+ `Input:`,
+ JSON.stringify(payload, null, 2),
+ ].join('\n')
+ }
+
+ async translateBatch(items, language) {
+ const systemInstruction = this.buildSystemInstruction(language)
+ const prompt = this.buildBatchPrompt(items)
+
+ const response = await withRetry(
+ () =>
+ this.ai.models.generateContent({
+ model: CONFIG.GEMINI_MODEL,
+ contents: prompt,
+ config: {
+ systemInstruction,
+ responseMimeType: 'application/json',
+ responseSchema: {
+ type: 'array',
+ items: {
+ type: 'object',
+ properties: {
+ id: { type: 'integer' },
+ text: { type: 'string' },
+ },
+ required: ['id', 'text'],
+ propertyOrdering: ['id', 'text'],
+ },
+ },
+ thinkingConfig: { thinkingLevel: CONFIG.THINKING_LEVEL },
+ },
+ }),
+ { label: `gemini.translate(${language.id}, n=${items.length})` },
+ )
+
+ const text = response.text ?? response.response?.text ?? ''
+ let parsed
+ try {
+ parsed = JSON.parse(text)
+ } catch (e) {
+ throw new Error(`Gemini returned non-JSON output for ${language.id}: ${e.message}\n--- output ---\n${text}`)
+ }
+ if (!Array.isArray(parsed)) {
+ throw new Error(`Gemini returned non-array output for ${language.id}: ${typeof parsed}`)
+ }
+
+ const map = new Map()
+ for (const row of parsed) {
+ if (row && typeof row.id === 'number' && typeof row.text === 'string') {
+ map.set(row.id, row.text)
+ }
+ }
+ return map
+ }
+}
+
+// -------------------------------------------------------- placeholder check
+
+const PLACEHOLDER_RE = /\{\{[^}]+\}\}/g
+const TAG_RE = /<\/?[\w-]+\s*\/?>/g
+
+function placeholderSet(s) {
+ return new Set(s.match(PLACEHOLDER_RE) ?? [])
+}
+function tagSet(s) {
+ return new Set((s.match(TAG_RE) ?? []).map((t) => t.replace(/\s+/g, '').toLowerCase()))
+}
+function setsEqual(a, b) {
+ if (a.size !== b.size) return false
+ for (const v of a) if (!b.has(v)) return false
+ return true
+}
+
+function validateTranslation(source, translation) {
+ if (typeof translation !== 'string' || translation.length === 0) {
+ return { ok: false, reason: 'empty translation' }
+ }
+ if (!setsEqual(placeholderSet(source), placeholderSet(translation))) {
+ return { ok: false, reason: 'placeholder mismatch' }
+ }
+ if (!setsEqual(tagSet(source), tagSet(translation))) {
+ return { ok: false, reason: 'tag mismatch' }
+ }
+ return { ok: true }
+}
+
+// ------------------------------------------------------------------ flow ---
+
+async function findUntranslated(crowdin, allStrings, language) {
+ const translatedIds = await crowdin.listTranslatedStringIds(language.id)
+ return allStrings.filter(
+ (s) => !s.isHidden && typeof s.text === 'string' && s.text.length > 0 && !translatedIds.has(s.id),
+ )
+}
+
+async function translateLanguage({ crowdin, gemini, language, untranslated, args }) {
+ const label = tag(language.id)
+ if (untranslated.length === 0) {
+ ok(`${label} already complete — no untranslated strings`)
+ return { language: language.id, translated: 0, uploaded: 0, failed: 0, invalid: 0 }
+ }
+
+ const work = args.limit ? untranslated.slice(0, args.limit) : untranslated
+ info(`${label} translating ${c.bold(work.length)} strings (model=${CONFIG.GEMINI_MODEL})`)
+
+ const indexed = work.map((s, i) => ({ ...s, batchId: i }))
+ const batches = chunk(indexed, CONFIG.BATCH_SIZE)
+ const translations = new Map()
+ let batchesDone = 0
+
+ await pMap(
+ batches,
+ async (batch) => {
+ const result = await gemini.translateBatch(batch, language)
+ for (const item of batch) {
+ const t = result.get(item.batchId)
+ if (typeof t === 'string') translations.set(item.id, t)
+ }
+ batchesDone++
+ const percent = Math.round((batchesDone / batches.length) * 100)
+ info(`${label} batch ${batchesDone}/${batches.length} done (${percent}%)`)
+ },
+ CONFIG.PER_LANGUAGE_BATCH_CONCURRENCY,
+ )
+
+ let invalid = 0
+ const validTranslations = []
+ for (const s of work) {
+ const t = translations.get(s.id)
+ if (typeof t !== 'string') {
+ invalid++
+ warn(`${label} ${c.gray(s.key)} — Gemini returned no translation`)
+ continue
+ }
+ const v = validateTranslation(s.text, t)
+ if (!v.ok) {
+ invalid++
+ warn(`${label} ${c.gray(s.key)} — ${v.reason}; skipping. src=${JSON.stringify(s.text)} got=${JSON.stringify(t)}`)
+ continue
+ }
+ validTranslations.push({ stringId: s.id, key: s.key, text: t })
+ }
+
+ if (args.dryRun) {
+ ok(`${label} dry-run complete — ${validTranslations.length} translations ready (not uploaded)`)
+ if (validTranslations.length > 0) {
+ const sample = validTranslations.slice(0, 5)
+ for (const s of sample) log(` ${c.gray(s.key)} → ${JSON.stringify(s.text)}`)
+ if (validTranslations.length > sample.length) log(` ${c.gray(`… +${validTranslations.length - sample.length} more`)}`)
+ }
+ return {
+ language: language.id,
+ translated: validTranslations.length,
+ uploaded: 0,
+ failed: 0,
+ invalid,
+ }
+ }
+
+ let uploaded = 0
+ let failed = 0
+ await pMap(
+ validTranslations,
+ async (t) => {
+ try {
+ await crowdin.addTranslation({ stringId: t.stringId, languageId: language.id, text: t.text })
+ uploaded++
+ } catch (e) {
+ failed++
+ const status = httpStatus(e)
+ warn(`${label} upload failed for ${c.gray(t.key)} [HTTP ${status ?? '?'}]: ${e?.message ?? e}`)
+ }
+ },
+ CONFIG.UPLOAD_CONCURRENCY,
+ )
+
+ const summary =
+ `translated=${validTranslations.length} uploaded=${uploaded} ` +
+ `failed=${failed} invalid=${invalid}`
+ if (failed === 0 && invalid === 0) ok(`${label} ${summary}`)
+ else warn(`${label} ${summary}`)
+
+ return { language: language.id, translated: validTranslations.length, uploaded, failed, invalid }
+}
+
+// ------------------------------------------------------------------ main ---
+
+async function main() {
+ let args
+ try {
+ args = parseArgs(process.argv)
+ } catch (e) {
+ fail(e.message)
+ process.exit(2)
+ }
+ if (args.help) {
+ printHelp()
+ return
+ }
+
+ const geminiApiKey = process.env.GEMINI_API_KEY
+ if (!geminiApiKey) {
+ fail('GEMINI_API_KEY environment variable is required.')
+ process.exit(2)
+ }
+
+ const startedAt = Date.now()
+ const { projectId, token } = await loadCrowdinConfig()
+ const crowdin = new CrowdinService({ projectId, token })
+ const gemini = new GeminiTranslator({ apiKey: geminiApiKey })
+
+ info(`fetching project metadata (project_id=${projectId})…`)
+ const allLanguages = await crowdin.getTargetLanguages()
+ const languages = args.languages
+ ? allLanguages.filter((l) => args.languages.includes(l.id) || args.languages.includes(l.twoLettersCode))
+ : allLanguages
+
+ if (languages.length === 0) {
+ fail(`No matching target languages. Available: ${allLanguages.map((l) => l.id).join(', ')}`)
+ process.exit(1)
+ }
+
+ info(`fetching all source strings…`)
+ const allStrings = await crowdin.listAllSourceStrings()
+ info(`found ${c.bold(allStrings.length)} source strings; target languages: ${c.bold(languages.map((l) => l.id).join(', '))}`)
+
+ info(`scanning untranslated strings per language…`)
+ const perLanguage = await pMap(
+ languages,
+ async (language) => {
+ const untranslated = await findUntranslated(crowdin, allStrings, language)
+ log(` ${tag(language.id)} ${untranslated.length} untranslated`)
+ return { language, untranslated }
+ },
+ CONFIG.LANGUAGE_CONCURRENCY,
+ )
+
+ const totalToTranslate = perLanguage.reduce((s, x) => s + x.untranslated.length, 0)
+ if (totalToTranslate === 0) {
+ ok(`All target languages are fully translated — nothing to do.`)
+ return
+ }
+ info(`total strings to translate: ${c.bold(totalToTranslate)}${args.dryRun ? c.yellow(' (dry-run)') : ''}`)
+
+ const results = await pMap(
+ perLanguage,
+ async ({ language, untranslated }) =>
+ translateLanguage({ crowdin, gemini, language, untranslated, args }),
+ CONFIG.LANGUAGE_CONCURRENCY,
+ )
+
+ const summary = results.reduce(
+ (acc, r) => ({
+ translated: acc.translated + r.translated,
+ uploaded: acc.uploaded + r.uploaded,
+ failed: acc.failed + r.failed,
+ invalid: acc.invalid + r.invalid,
+ }),
+ { translated: 0, uploaded: 0, failed: 0, invalid: 0 },
+ )
+
+ const elapsed = ((Date.now() - startedAt) / 1000).toFixed(1)
+ log()
+ log(c.bold('Summary'))
+ for (const r of results) {
+ log(` ${tag(r.language)} translated=${r.translated} uploaded=${r.uploaded} failed=${r.failed} invalid=${r.invalid}`)
+ }
+ log()
+ log(
+ `${c.bold('Total')}: translated=${summary.translated} uploaded=${summary.uploaded} ` +
+ `failed=${summary.failed} invalid=${summary.invalid} ` +
+ `${c.gray(`(${elapsed}s)`)}`,
+ )
+
+ if (!args.dryRun && summary.uploaded > 0) {
+ log()
+ ok(`Done. Run ${c.bold('crowdin download')} to pull translations into web/public/locales/*.json.`)
+ }
+
+ if (summary.failed > 0 || summary.invalid > 0) process.exitCode = 1
+}
+
+main().catch((e) => {
+ const status = httpStatus(e)
+ if (typeof status === 'number') {
+ fail(`${e?.message ?? e} (HTTP ${status})`)
+ } else {
+ fail(e?.stack ?? e)
+ }
+ process.exit(1)
+})