chore(translation): Add Simplified Chinese (zh-CN support) (#19531)

Co-authored-by: Alex Y <alexjst@users.noreply.github.com>

Author: benjiaming

datahub-web-react/src/alchemy-components/components/Editor/RemirrorLocaleProvider.tsx

@@ -21,7 +21,9 @@ async function loadRemirrorLocale(locale: string): Promise<void> {
         return;
     }
     const { default: messages } = await loader();
-    const plurals = (remirrorPlurals as Record<string, ((n: number, ord?: boolean) => string) | undefined>)[locale];
+    // Lingui keys plural rules by language only (`pt`, `zh`); region tags fall back to primary subtag.
+    const pluralsByLocale = remirrorPlurals as Record<string, ((n: number, ord?: boolean) => string) | undefined>;
+    const plurals = pluralsByLocale[locale] ?? pluralsByLocale[locale.split('-')[0]];
     if (plurals) {
         remirrorI18n.loadLocaleData(locale, { plurals });
     }
@@ -32,15 +34,23 @@ type Props = {
     children: React.ReactNode;
 };
 
+// Prefer full BCP-47 tag (e.g. zh-CN, pt-BR) before primary subtag.
+export function resolveRemirrorLocale(language: string): string {
+    if (REMIRROR_SUPPORTED_LOCALES.includes(language)) {
+        return language;
+    }
+    const primarySubtag = language.split('-')[0];
+    return REMIRROR_SUPPORTED_LOCALES.includes(primarySubtag) ? primarySubtag : 'en';
+}
+
 /**
  * Shares DataHub's Remirror translations with any Remirror editor. Wrap a `<Remirror>` tree
  * with this so the editor's built-in labels follow the active app language, falling back to
  * English for languages we don't ship a bundle for.
  */
 export default function RemirrorLocaleProvider({ children }: Props) {
     const { i18n: appI18n } = useTranslation();
-    const appLanguage = (appI18n.resolvedLanguage || appI18n.language || 'en').split('-')[0];
-    const locale = REMIRROR_SUPPORTED_LOCALES.includes(appLanguage) ? appLanguage : 'en';
+    const locale = resolveRemirrorLocale(appI18n.resolvedLanguage || appI18n.language || 'en');
     // Only activate once the bundle is loaded, so labels never flash raw message ids. Until then
     // the provider stays on English (Remirror's built-in).
     const [activeLocale, setActiveLocale] = useState('en');

datahub-web-react/src/alchemy-components/components/Editor/__tests__/RemirrorLocaleProvider.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+
+import { resolveRemirrorLocale } from '@components/components/Editor/RemirrorLocaleProvider';
+
+describe('resolveRemirrorLocale', () => {
+    it('prefers an exact BCP-47 match when a bundle exists', () => {
+        expect(resolveRemirrorLocale('zh-CN')).toBe('zh-CN');
+        expect(resolveRemirrorLocale('pt-BR')).toBe('pt-BR');
+    });
+
+    it('falls back to the primary language subtag when only that bundle exists', () => {
+        expect(resolveRemirrorLocale('de-DE')).toBe('de');
+        expect(resolveRemirrorLocale('ja-JP')).toBe('ja');
+    });
+
+    it('falls back to English when no bundle matches', () => {
+        expect(resolveRemirrorLocale('pt-PT')).toBe('en');
+        expect(resolveRemirrorLocale('zh-Hant-TW')).toBe('en');
+        expect(resolveRemirrorLocale('ko-KR')).toBe('en');
+    });
+});

datahub-web-react/src/app/i18n/__tests__/utils.test.ts

@@ -46,7 +46,7 @@ describe('detectBrowserLanguage', () => {
 
     it('returns the first supported language in preference order', () => {
         // Use unsupported tags first so preference order is exercised past them.
-        stubLanguages(['ko-KR', 'zh-CN', 'fr-FR', 'de']);
+        stubLanguages(['ko-KR', 'th-TH', 'fr-FR', 'de']);
         expect(detectBrowserLanguage()).toBe('fr');
     });
 
@@ -58,7 +58,29 @@ describe('detectBrowserLanguage', () => {
     });
 
     it('returns undefined when no preferred language is supported', () => {
-        stubLanguages(['ko-KR', 'zh-CN']);
+        stubLanguages(['ko-KR', 'th-TH']);
+        expect(detectBrowserLanguage()).toBeUndefined();
+    });
+
+    it('maps Simplified Chinese tags to zh-CN', () => {
+        stubLanguages(['zh-CN']);
+        expect(detectBrowserLanguage()).toBe('zh-CN');
+        stubLanguages(['zh-Hans']);
+        expect(detectBrowserLanguage()).toBe('zh-CN');
+        stubLanguages(['zh']);
+        expect(detectBrowserLanguage()).toBe('zh-CN');
+        stubLanguages(['zh-SG']);
+        expect(detectBrowserLanguage()).toBe('zh-CN');
+    });
+
+    it('does not map Traditional Chinese tags to zh-CN', () => {
+        stubLanguages(['zh-TW']);
+        expect(detectBrowserLanguage()).toBeUndefined();
+        stubLanguages(['zh-Hant']);
+        expect(detectBrowserLanguage()).toBeUndefined();
+        stubLanguages(['zh-HK']);
+        expect(detectBrowserLanguage()).toBeUndefined();
+        stubLanguages(['zh-MO']);
         expect(detectBrowserLanguage()).toBeUndefined();
     });
 

datahub-web-react/src/app/i18n/constants.ts

@@ -10,6 +10,7 @@ import jaJP from 'antd/lib/locale/ja_JP';
 import nbNO from 'antd/lib/locale/nb_NO';
 import ptBR from 'antd/lib/locale/pt_BR';
 import svSE from 'antd/lib/locale/sv_SE';
+import zhCN from 'antd/lib/locale/zh_CN';
 
 import { LocaleConfig, SupportedLanguage } from '@app/i18n/types';
 
@@ -90,6 +91,13 @@ export const JA_LOCALE_CONFIG: LocaleConfig = {
     label: '日本語 (Beta)',
 };
 
+export const ZH_CN_LOCALE_CONFIG: LocaleConfig = {
+    lang: 'zh-CN',
+    antd: zhCN,
+    dayjs: 'zh-cn',
+    label: '简体中文',
+};
+
 export const LOCALE_MAP: Record<SupportedLanguage, LocaleConfig> = {
     en: EN_LOCALE_CONFIG,
     de: DE_LOCALE_CONFIG,
@@ -102,6 +110,7 @@ export const LOCALE_MAP: Record<SupportedLanguage, LocaleConfig> = {
     hu: HU_LOCALE_CONFIG,
     fi: FI_LOCALE_CONFIG,
     ja: JA_LOCALE_CONFIG,
+    'zh-CN': ZH_CN_LOCALE_CONFIG,
 };
 
 export const LANGUAGE_OPTIONS: SelectOption[] = [
@@ -116,6 +125,7 @@ export const LANGUAGE_OPTIONS: SelectOption[] = [
     HU_LOCALE_CONFIG,
     FI_LOCALE_CONFIG,
     JA_LOCALE_CONFIG,
+    ZH_CN_LOCALE_CONFIG,
 ].map((localeConfig) => ({
     value: localeConfig.lang,
     label: localeConfig.label,

datahub-web-react/src/app/i18n/types.ts

@@ -1,6 +1,6 @@
 import { Locale } from 'antd/lib/locale-provider';
 
-export type SupportedLanguage = 'en' | 'de' | 'es' | 'pt-BR' | 'fr' | 'it' | 'nb' | 'sv' | 'hu' | 'fi' | 'ja';
+export type SupportedLanguage = 'en' | 'de' | 'es' | 'pt-BR' | 'fr' | 'it' | 'nb' | 'sv' | 'hu' | 'fi' | 'ja' | 'zh-CN';
 
 export type LocaleConfig = {
     lang: SupportedLanguage;

datahub-web-react/src/app/i18n/utils.ts

@@ -5,6 +5,12 @@ export function isSupportedLanguage(lang: string): lang is SupportedLanguage {
     return lang in LOCALE_MAP;
 }
 
+function lookupSupportedLanguage(code: string): SupportedLanguage | undefined {
+    // Cast after the runtime membership check so companion-locale codes (e.g. zh-TW on the
+    // zh-CN-only PR) type-check without being present in the SupportedLanguage union yet.
+    return code in LOCALE_MAP ? (code as SupportedLanguage) : undefined;
+}
+
 /**
  * Best-effort match of the browser's preferred languages (`navigator.languages`, most-preferred
  * first) to a supported UI locale. Tries an exact, case-insensitive match first, then folds region
@@ -20,6 +26,14 @@ export function detectBrowserLanguage(): SupportedLanguage | undefined {
         if (!tag) return undefined;
         const lower = tag.toLowerCase();
         const base = lower.split('-')[0];
+        if (base === 'zh') {
+            if (lower.includes('hant') || lower === 'zh-tw' || lower === 'zh-hk' || lower === 'zh-mo') {
+                // Prefer zh-TW when registered (companion PR); never fold Traditional to zh-CN.
+                return lookupSupportedLanguage('zh-TW');
+            }
+            // zh-Hans, zh-CN, zh-SG, bare zh
+            return lookupSupportedLanguage('zh-CN');
+        }
         // Exact (case-insensitive) match first, then fold region variants to their base language.
         return (
             supported.find((locale) => locale.toLowerCase() === lower) ??

datahub-web-react/src/i18n/locales/zh-CN/alchemy.json

@@ -0,0 +1,93 @@
+{
+    "avatar.defaultName": "用户名",
+    "calendarChart.weekday.fri": "周五",
+    "calendarChart.weekday.mon": "周一",
+    "calendarChart.weekday.sat": "周六",
+    "calendarChart.weekday.sun": "周日",
+    "calendarChart.weekday.thu": "周四",
+    "calendarChart.weekday.tue": "周二",
+    "calendarChart.weekday.wed": "周三",
+    "codeBlock.editorLabel": "代码编辑器",
+    "codeBlock.format": "格式化",
+    "codeBlock.formatInvalid": "无法格式化此代码，请检查代码是否有效。",
+    "codeBlock.formatSuccess": "已格式化",
+    "codeBlock.languageSelectLabel": "语言",
+    "codeBlock.sqlSyntaxWarning": "此 SQL 可能存在语法问题。",
+    "codeBlock.syntaxInvalid": "此代码存在语法问题。",
+    "codeBlock.truncated": "此代码因超出最大长度而被截断。",
+    "codeBlock.validate": "校验",
+    "codeBlock.validateSuccess": "校验通过",
+    "colorPicker.invalidHex.error": "请输入有效的十六进制颜色代码",
+    "datePicker.placeholder": "选择日期",
+    "editor.addImage.altLabel": "替代文本",
+    "editor.addImage.embed": "嵌入图片",
+    "editor.addImage.title": "添加图片",
+    "editor.addImage.urlLabel": "图片 URL",
+    "editor.command.editLink": "编辑链接",
+    "editor.command.insertImage": "图片",
+    "editor.command.insertLink": "链接",
+    "editor.command.toggleBulletList": "项目符号列表",
+    "editor.command.toggleLink": "移除链接",
+    "editor.command.updateLink": "更新链接",
+    "editor.heading.h1": "标题 1",
+    "editor.heading.h2": "标题 2",
+    "editor.heading.h3": "标题 3",
+    "editor.heading.h4": "标题 4",
+    "editor.heading.h5": "标题 5",
+    "editor.heading.normal": "正文",
+    "editor.link.textLabel": "文本",
+    "editor.link.title": "添加链接",
+    "editor.link.urlLabel": "链接 URL",
+    "editor.mentions.notFound": "未找到实体",
+    "editor.table.deleteColumn": "删除列",
+    "editor.table.deleteRow": "删除行",
+    "editor.table.deleteTable": "删除表格",
+    "editor.table.insertColumnLeft": "在左侧插入列",
+    "editor.table.insertColumnRight": "在右侧插入列",
+    "editor.table.insertRowAbove": "在上方插入行",
+    "editor.table.insertRowBelow": "在下方插入行",
+    "editor.upload.chooseFile": "选择文件",
+    "editor.upload.failedTitle": "上传失败",
+    "editor.upload.fileTooLarge": "你的文件大小（{{sizeGb}}GB）超出了 {{maxGb}}GB 的上限",
+    "editor.upload.fileTypeNotSupported": "不支持的文件类型{{extensionSuffix}}",
+    "editor.upload.notSupported": "当前场景暂不支持上传文件",
+    "editor.upload.tabUrl": "URL",
+    "editor.upload.uploadFile": "上传文件",
+    "fileNode.uploading": "正在上传 {{fileName}}...",
+    "fileUpload.dragDropPrompt": "拖入文件或<uploadButton>点击上传</uploadButton>",
+    "fileUpload.maxSize": "最大大小：2GB",
+    "graphCard.moreInfo": "更多信息",
+    "graphCard.noStats": "当前尚未收集该数据资产的统计数据。",
+    "incidentStage.fixed": "已修复",
+    "incidentStage.inProgress": "处理中",
+    "incidentStage.investigation": "调查中",
+    "incidentStage.noAction": "无需处理",
+    "incidentStage.triage": "待分类",
+    "input.placeholder": "占位文本",
+    "loadedImage.error": "未找到图片",
+    "loadedVideo.error": "视频加载失败",
+    "loadedVideo.unsupportedFallback": "你的浏览器不支持 HTML5 视频。请改用<anchor>视频链接</anchor>。",
+    "noData": "暂无数据",
+    "pagination.nextPage": "下一页",
+    "pagination.previousPage": "上一页",
+    "radio.label": "标签",
+    "resizablePills.moreHiddenCount_other": "另有 {{count}} 项已隐藏",
+    "search.placeholder": "搜索...",
+    "select.placeholder": "请选择一个选项",
+    "selectItems.addMoreSection": "添加更多",
+    "selectItems.entitiesLabel": "实体",
+    "selectItems.itemsLabel": "项",
+    "selectItems.noEntityFound": "未找到 {{entityName}}",
+    "selectItems.removeAll": "全部移除",
+    "selectItems.searchForEntity": "搜索 {{entityName}}...",
+    "selectItems.selectedSection": "已选择",
+    "switch.label": "标签",
+    "table.loading": "正在加载数据...",
+    "textArea.placeholder": "占位文本",
+    "tooltipHeader.imageAlt": "提示框标题",
+    "whiskerChart.metric.firstQuartile": "第一四分位数",
+    "whiskerChart.metric.max": "最大值",
+    "whiskerChart.metric.median": "中位数",
+    "whiskerChart.metric.min": "最小值",
+    "whiskerChart.metric.thirdQuartile": "第三四分位数"
+}

datahub-web-react/src/i18n/locales/zh-CN/analytics.json

@@ -0,0 +1,11 @@
+{
+    "allDomains": "所有数据域",
+    "dataLandscapeSummary": "数据全景概览",
+    "domainLandscapeSummary": "数据域全景概览",
+    "failedToLoadCharts": "加载图表失败",
+    "failedToLoadDomains": "加载数据域失败",
+    "failedToLoadHighlights": "加载重点指标失败",
+    "noDomainData": "该数据域暂无分析数据",
+    "selectDomain": "选择数据域",
+    "usageAnalytics": "使用分析"
+}

datahub-web-react/src/i18n/locales/zh-CN/auth.json

@@ -0,0 +1,30 @@
+{
+    "confirmPasswordLabel": "确认密码",
+    "confirmPasswordRequired": "请确认你的密码",
+    "emailLabel": "邮箱",
+    "emailPlaceholder": "name@company.com",
+    "emailRequired": "请填写你的邮箱",
+    "fullNameLabel": "全名",
+    "fullNamePlaceholder": "名字 姓氏",
+    "fullNameRequired": "请填写你的姓名",
+    "login.failed": "登录失败！{{error}}",
+    "login.loading": "正在登录...",
+    "login.ssoButton": "使用 SSO 登录",
+    "login.submitButton": "登录",
+    "passwordHint": "长度必须为 8 个字符，区分大小写",
+    "passwordLabel": "密码",
+    "passwordRequired": "请填写你的密码",
+    "passwordsDoNotMatch": "两次输入的密码不一致",
+    "reset.failed": "登录失败！",
+    "reset.loading": "正在重置凭据...",
+    "reset.submitButton": "重置凭据",
+    "signup.acceptInviteFailed": "接受邀请失败：{{error}}",
+    "signup.acceptedInvite": "已接受邀请！",
+    "signup.loginFailed": "登录失败！发生了意外错误。",
+    "signup.subHeading": "开始之前，我们还有几个问题",
+    "signup.submitButton": "开始使用",
+    "usernameLabel": "用户名",
+    "usernamePlaceholder": "请输入用户名",
+    "usernameRequired": "请填写你的用户名",
+    "welcomeToDataHub": "欢迎使用 DataHub"
+}