i18n

name	i18n
description	Use when changing massCode localization, adding user-facing strings, creating locale keys, or wiring text through the project's translation system.

I18n

Overview

В massCode новый пользовательский текст всегда проходит через localization system. Базовым source of truth для новых ключей считается английская локаль.

Localization Rules

• Базовый язык проекта — English.
• en_US остаётся базовым source of truth для новых ключей.
• Все новые ключи сначала добавляй в src/main/i18n/locales/en_US/.
• При добавлении нового ключа сразу добавляй его и в русскую локаль, чтобы ru_RU не отставала от базового английского набора.
• Не хардкодь user-facing strings ни в template, ни в script logic.
• Используй i18n.t('namespace:key.path') или сокращённый i18n.t('key.path') для default ui namespace.
• Импорт i18n делай из @/electron.

After Locale Changes

• После добавления или изменения locale keys запускай pnpm i18n:copy.
• Не оставляй en_US и ru_RU в несинхронном состоянии.
• Остальные локали могут догоняться отдельно контрибьюторами и не считаются обязательным блокером для каждой локальной правки.

Common Mistakes

• Хардкодить новый текст “временно”.
• Добавлять ключи не в en_US, а сразу в другой locale.
• Обновить en_US, но забыть сразу добавить тот же ключ в ru_RU.
• Использовать текст напрямую в template, хотя это часть UI.
• Забывать pnpm i18n:copy после изменения locale source-of-truth.