fix(i18n): make en the complete source of truth for grid import and set-password (#2872 b/c) (#2877)

`en` and `zh` had drifted in both directions, silently: `fallbackLng: 'en'`
degrades a missing key into English rather than an error, and the missing-key
handler only fires in dev.

- 74 keys existed only in `zh` (`grid.import.*`, `auth.setPassword.*`). They
  were never in `en` — the English came from call-site `defaultValue:` args and
  a private map inside `ImportWizard` — so no other locale could translate them.
- 4 `en` keys were missing from `zh`, so Chinese users saw English.

`grid.import` had three disagreeing sources (en 62, zh 130, wizard map 133,
union 134, no two the same set); all three now agree on 134. `en` and `zh` are
at exact parity, 2448 keys each.

`IMPORT_DEFAULT_TRANSLATIONS` is kept, not deleted — it is what lets the wizard
render with no `I18nProvider` mounted — and is instead pinned to the `en` pack
by a test. `SetPasswordPage` drops its now-redundant inline `defaultValue:`
args; rendered text is byte-identical.

Two mutation-verified guards: en↔zh full key parity (both directions), and
wizard-map ↔ `en.grid.import` same keys and same text. The other eight packs
are ~357 keys behind and are deliberately not asserted — that backfill needs a
translation-strategy decision (#2872 part a).

Author: os-zhuang

.changeset/locale-key-parity-en-zh.md

@@ -0,0 +1,37 @@
+---
+"@object-ui/i18n": patch
+"@object-ui/plugin-grid": patch
+"@object-ui/console": patch
+---
+
+fix(i18n): make `en` the complete source of truth for grid import and set-password (objectui#2872 b/c)
+
+The `en` and `zh` packs had drifted in both directions, silently, because
+`fallbackLng: 'en'` degrades a missing key into English rather than an error and
+the missing-key handler only fires in dev.
+
+- **74 keys existed only in `zh`.** `grid.import.*` and `auth.setPassword.*` had
+  never been added to `en`, so no other locale could translate them: the English
+  text came from call-site `defaultValue:` args and a private map inside
+  `ImportWizard`. They now live in `en`, which is what translators and
+  `os i18n extract` read.
+- **4 `en` keys were missing from `zh`** (`console.commandPalette.title`,
+  two `console.ai.suggestions.metadataAssistant.*`, `help.keyboardShortcuts`),
+  so Chinese users saw English.
+
+`grid.import` in particular had three disagreeing sources — the `en` pack (62
+keys), `zh` (130) and `ImportWizard`'s own fallback map (133), union 134, no two
+the same set. All three are now aligned on 134.
+
+The wizard's fallback map is kept, not deleted: it is what lets the wizard render
+with no `I18nProvider` mounted (standalone embedding, unit tests). It is instead
+pinned to the `en` pack by a new test, so the two can no longer drift.
+
+`SetPasswordPage` drops its now-redundant inline `defaultValue:` args; the text
+is byte-identical, it just comes from the pack now.
+
+Adds two guards, both mutation-verified:
+- `en` ↔ `zh` full key parity, asserted in both directions. The other eight
+  packs are still ~357 keys behind and are tracked separately (objectui#2872
+  part a), so they are deliberately not asserted yet.
+- `IMPORT_DEFAULT_TRANSLATIONS` ↔ `en.grid.import`, same keys and same text.

apps/console/src/pages/auth/SetPasswordPage.tsx

@@ -52,20 +52,20 @@ export function SetPasswordPage() {
     e.preventDefault();
     if (newPassword !== confirmPassword) {
       toast.error(
-        t('auth.setPassword.passwordsMismatch', { defaultValue: 'Passwords do not match' }),
+        t('auth.setPassword.passwordsMismatch'),
       );
       return;
     }
     setSubmitting(true);
     try {
       await setInitialPassword(newPassword);
       toast.success(
-        t('auth.setPassword.success', { defaultValue: 'Local password set' }),
+        t('auth.setPassword.success'),
       );
       navigate(next);
     } catch (err) {
       toast.error(
-        t('auth.setPassword.failed', { defaultValue: 'Could not set password' }),
+        t('auth.setPassword.failed'),
         { description: (err as Error).message },
       );
     } finally {
@@ -78,34 +78,29 @@ export function SetPasswordPage() {
       <Card className="border-border/60 shadow-sm shadow-primary/5 backdrop-blur supports-[backdrop-filter]:bg-card/95">
         <CardHeader className="text-center">
           <CardTitle className="text-xl tracking-tight">
-            {t('auth.setPassword.title', { defaultValue: 'Set a recovery password' })}
+            {t('auth.setPassword.title')}
           </CardTitle>
           <CardDescription>
-            {t('auth.setPassword.description', {
-              defaultValue:
-                'You signed in via single sign-on. Set a local password so you can still sign in to this environment directly if SSO ever becomes unavailable.',
-            })}
+            {t('auth.setPassword.description')}
           </CardDescription>
         </CardHeader>
         <CardContent>
           {!isLoading && !user ? (
             <p className="text-center text-sm text-muted-foreground">
-              {t('auth.setPassword.noSession', {
-                defaultValue: 'Your session has expired.',
-              })}{' '}
+              {t('auth.setPassword.noSession')}{' '}
               <Link
                 to="/login"
                 className="font-medium text-primary underline-offset-4 hover:underline"
               >
-                {t('auth.setPassword.backToSignIn', { defaultValue: 'Sign in again' })}
+                {t('auth.setPassword.backToSignIn')}
               </Link>
             </p>
           ) : (
             <form onSubmit={handleSubmit} className="flex flex-col gap-4">
               {user?.email ? (
                 <div className="flex flex-col gap-2">
                   <Label htmlFor="set-password-email">
-                    {t('auth.setPassword.email', { defaultValue: 'Email' })}
+                    {t('auth.setPassword.email')}
                   </Label>
                   <Input
                     id="set-password-email"
@@ -119,7 +114,7 @@ export function SetPasswordPage() {
               ) : null}
               <div className="flex flex-col gap-2">
                 <Label htmlFor="new-password">
-                  {t('auth.setPassword.newPassword', { defaultValue: 'New password' })}
+                  {t('auth.setPassword.newPassword')}
                 </Label>
                 <Input
                   id="new-password"
@@ -133,7 +128,7 @@ export function SetPasswordPage() {
               </div>
               <div className="flex flex-col gap-2">
                 <Label htmlFor="confirm-password">
-                  {t('auth.setPassword.confirmPassword', { defaultValue: 'Confirm password' })}
+                  {t('auth.setPassword.confirmPassword')}
                 </Label>
                 <Input
                   id="confirm-password"
@@ -147,8 +142,8 @@ export function SetPasswordPage() {
               </div>
               <Button type="submit" className="w-full" disabled={submitting}>
                 {submitting
-                  ? t('auth.setPassword.submitting', { defaultValue: 'Saving…' })
-                  : t('auth.setPassword.submit', { defaultValue: 'Set password' })}
+                  ? t('auth.setPassword.submitting')
+                  : t('auth.setPassword.submit')}
               </Button>
             </form>
           )}

packages/i18n/src/__tests__/en-zh-key-parity.test.ts

@@ -0,0 +1,54 @@
+/**
+ * Full `en` ↔ `zh` key parity (objectui#2872 parts b and c).
+ *
+ * `fallbackLng: 'en'` means a key missing from a pack degrades silently — the
+ * UI just renders English and looks "not translated yet" rather than broken.
+ * The missing-key handler only fires in dev. So the packs had quietly drifted
+ * in BOTH directions:
+ *
+ *   - 74 keys existed only in `zh` (`grid.import.*`, `auth.setPassword.*`).
+ *     They were never in `en`, so no other locale could translate them — the
+ *     English text came from call-site `defaultValue:` args and a private map
+ *     inside `ImportWizard`.
+ *   - 4 `en` keys were missing from `zh`, so Chinese users saw English.
+ *
+ * `en` and `zh` are the two packs that are actually maintained in full, so
+ * they are pinned to each other here. The remaining eight packs are tracked
+ * separately (objectui#2872 part a) — they are missing ~357 keys each and
+ * cannot be asserted this way until that backfill lands.
+ */
+import { describe, it, expect } from 'vitest';
+import { builtInLocales } from '../locales';
+
+/** Flatten a nested translation node into sorted dot-paths. */
+function keyPaths(node: unknown, prefix = ''): string[] {
+  return node !== null && typeof node === 'object'
+    ? Object.entries(node as Record<string, unknown>)
+        .flatMap(([k, v]) => keyPaths(v, prefix ? `${prefix}.${k}` : k))
+        .sort()
+    : [prefix];
+}
+
+describe('en ↔ zh key parity', () => {
+  const en = keyPaths(builtInLocales.en);
+  const zh = keyPaths(builtInLocales.zh);
+
+  it('flattens a realistic number of keys', () => {
+    // Guard against the walker silently returning nothing and the two
+    // set-difference assertions below passing vacuously.
+    expect(en.length).toBeGreaterThan(2000);
+  });
+
+  it('has no en key missing from zh', () => {
+    const zhSet = new Set(zh);
+    expect(en.filter((k) => !zhSet.has(k))).toEqual([]);
+  });
+
+  it('has no zh key absent from en', () => {
+    // This direction matters just as much: a key only in `zh` cannot be
+    // translated into any other language, because `en` is what translators
+    // and the extraction tooling read as the source of truth.
+    const enSet = new Set(en);
+    expect(zh.filter((k) => !enSet.has(k))).toEqual([]);
+  });
+});

packages/i18n/src/locales/en.ts

@@ -236,7 +236,6 @@ const en = {
     },
     import: {
       title: 'Import {{object}}',
-      notAllowed: 'This object is not open for import.',
       stepUpload: 'Upload',
       stepMapping: 'Mapping',
       stepPreview: 'Preview',
@@ -245,9 +244,12 @@ const en = {
       previewDescription: 'Review data before importing.',
       dragDrop: 'Drag & drop a CSV or Excel file here, or click to browse',
       browseFiles: 'Browse Files',
+      downloadTemplate: 'Download template',
+      downloadTemplateHint: 'Get a CSV with the right columns (required fields marked *).',
+      templateFileName: '{{object}}-import-template',
       parsing: 'Parsing…',
       pasteHint: 'or paste (Ctrl/⌘+V) rows copied from Excel or Google Sheets',
-      legacyXls: "Legacy .xls files aren't supported — please re-save as .xlsx.",
+      legacyXls: 'Legacy .xls files aren\'t supported — please re-save as .xlsx.',
       unsupportedFile: 'Unsupported file type. Use CSV, TSV, or Excel (.xlsx).',
       parseFailed: 'Could not read this file. Please check the format and try again.',
       fileNeedsHeader: 'File must contain a header row and at least one data row.',
@@ -268,6 +270,13 @@ const en = {
       csvColumn: 'Column',
       mapsTo: 'Maps To',
       typeMismatch: 'Looks like {{type}}',
+      autoMatched: 'Auto-matched',
+      autoMatchedSummary: 'Auto-matched {{count}} column(s) — review and adjust below.',
+      confidence: {
+        high: 'High confidence',
+        medium: 'Medium confidence',
+        low: 'Low confidence',
+      },
       type: {
         number: 'Number',
         boolean: 'Boolean',
@@ -285,20 +294,89 @@ const en = {
       clickToFix: '— click a highlighted cell to fix it inline.',
       showingRows: 'Showing {{shown}} of {{total}} rows',
       importing: 'Importing… {{progress}}%',
+      asyncQueued: 'Queued — preparing to import…',
+      asyncProcessing: 'Importing {{processed}} of {{total}} rows… {{progress}}%',
+      asyncLargeHint: 'This file is large, so it will be imported in the background.',
+      largeSampleNotice: 'Previewing the first {{shown}} of {{total}} rows.',
+      cancelImport: 'Cancel import',
+      importCancelled: 'Import cancelled',
+      resultsTruncated: 'Showing the first {{count}} row results (of {{total}}).',
       importComplete: 'Import Complete',
       imported: '{{count}} imported',
+      createdCount: '{{count}} created',
+      updatedCount: '{{count}} updated',
       skippedCount: '{{count}} skipped',
       moreErrors: '…and {{count}} more errors',
+      downloadFailed: 'Download failed rows',
+      options: 'Import options',
+      writeMode: 'When a row matches an existing record',
+      writeModeOpt: {
+        insert: 'Always create new',
+        update: 'Update existing (skip if no match)',
+        upsert: 'Update if matched, else create',
+      },
+      matchFields: 'Match on',
+      matchFieldsPlaceholder: 'Choose match field(s)…',
+      matchFieldsHint: 'Rows are matched to existing records by these field(s).',
+      needMatchFields: 'Select at least one field to match on.',
+      optCreateOptions: 'Keep unknown option values',
+      optRunAutomations: 'Run automations & triggers',
+      optTreatHistorical: 'Import as historical data',
+      optTreatHistoricalHint: '(import completed records as-is — skip state-machine checks and keep their original timestamps & author instead of stamping now)',
+      optSkipBlankKey: 'Skip rows with a blank match value',
+      optBackground: 'Import in the background',
+      optBackgroundHint: '(runs as an undoable job)',
+      validate: 'Validate data',
+      validating: 'Validating…',
+      validateHint: 'Check every row against the server before importing.',
+      validatePassed: 'All {{ok}} rows are valid.',
+      validateFailed: '{{ok}} valid, {{errors}} with errors.',
+      errorRowPrefix: 'Row {{row}}: ',
+      referenceNotFound: 'No matching record for "{{value}}"',
+      referenceAmbiguous: '"{{value}}" matches more than one record — use a unique value or the record id',
+      invalidBoolean: '"{{value}}" is not a valid true/false value',
+      invalidNumber: '"{{value}}" is not a valid number',
+      invalidDate: '"{{value}}" is not a valid date',
+      invalidOption: '"{{value}}" is not one of the allowed options',
+      requiredValue: 'This field is required',
+      matchAmbiguous: 'Matches more than one existing record — use a unique value or the record id',
+      history: 'History',
+      historyBack: 'Back to import',
+      historyDescription: 'Recent imports for this object.',
+      historyHint: 'Background import jobs, newest first.',
+      historyRefresh: 'Refresh',
+      historyLoading: 'Loading…',
+      historyEmpty: 'No imports yet.',
+      historyUnsupported: 'Import history isn’t available for this data source.',
+      historyColStatus: 'Status',
+      historyColRows: 'Rows',
+      historyColResult: 'Result',
+      historyColTime: 'When',
+      errorCount: '{{count}} errors',
+      undoImport: 'Undo import',
+      undoing: 'Undoing…',
+      undoConfirm: 'Undo this import? Records it created will be deleted and records it updated will be restored to their previous values.',
+      reverted: 'Undone',
+      jobStatus: {
+        pending: 'Pending',
+        running: 'Running',
+        succeeded: 'Succeeded',
+        failed: 'Failed',
+        cancelled: 'Cancelled',
+      },
       cancel: 'Cancel',
       back: 'Back',
       next: 'Next',
       close: 'Close',
       importNRows: 'Import {{count}} Rows',
       importingProgress: 'Importing…',
-      requiredMark: '*',
       required: 'Required',
       invalidType: 'Invalid {{type}}',
-      legacyReferenceBlocked: 'Import blocked: {{fields}} are relation fields that need the server import route to resolve names into record IDs, and this connection doesn\u2019t support it. Importing them as plain text would corrupt the data. Upgrade the backend/client, or unmap these columns and import them separately.',
+      legacyReferenceBlocked: 'Import blocked: {{fields}} are relation fields that need the server import route to resolve names into record IDs, and this connection doesn’t support it. Importing them as plain text would corrupt the data. Upgrade the backend/client, or unmap these columns and import them separately.',
+      missingRequiredHint: 'Can’t continue — required field(s) not mapped: {{fields}}. Add a matching column to your file, or go back and upload one that includes it.',
+      legacyFallbackNotice: 'Imported via a compatibility fallback: this connection doesn’t support the server import route, so values were saved as text without server-side type coercion. Upgrade the backend/client for full import support (type coercion and relation lookups).',
+      notAllowed: 'This object is not open for import.',
+      requiredMark: '*',
     },
     bulk: {
       confirmDefault: 'This will apply to {{count}} record(s).',
@@ -1847,6 +1925,24 @@ const en = {
     shell: {
       tenantHostHint: 'You are signing in to this workspace',
     },
+    // These were previously supplied only as inline `defaultValue:` args at the
+    // SetPasswordPage call sites, so `zh` was the only pack that could carry a
+    // translation. Owning them here makes the page translatable everywhere.
+    setPassword: {
+      title: 'Set a recovery password',
+      description:
+        'You signed in via single sign-on. Set a local password so you can still sign in to this environment directly if SSO ever becomes unavailable.',
+      email: 'Email',
+      newPassword: 'New password',
+      confirmPassword: 'Confirm password',
+      submit: 'Set password',
+      submitting: 'Saving…',
+      success: 'Local password set',
+      failed: 'Could not set password',
+      passwordsMismatch: 'Passwords do not match',
+      noSession: 'Your session has expired.',
+      backToSignIn: 'Sign in again',
+    },
     layout: {
       headline: 'Build powerful business applications, faster.',
       subhead: 'The universal platform for enterprise data management, workflows, and analytics.',

packages/i18n/src/locales/zh.ts

@@ -295,6 +295,10 @@ const zh = {
       importNRows: '导入 {{count}} 行',
       importingProgress: '导入中…',
       requiredMark: '*',
+      optTreatHistorical: '作为历史数据导入',
+      optTreatHistoricalHint: '（按原样导入已完结的记录——跳过状态机校验，保留原始时间戳与作者，而不是记为当前时间）',
+      missingRequiredHint: '无法继续——以下必填字段未映射：{{fields}}。请在文件中添加对应的列，或返回上一步重新上传包含该列的文件。',
+      legacyFallbackNotice: '已通过兼容模式导入：当前连接不支持服务端导入接口，因此所有值均以文本写入，未做服务端类型转换。请升级后端/客户端以获得完整的导入支持（类型转换与关联查找）。',
       required: '必填',
       invalidType: '{{type}} 格式无效',
       legacyReferenceBlocked: '导入已阻止：{{fields}} 是关联字段，需要服务端导入接口把名称解析为记录 ID，而当前连接不支持。按纯文本导入会写坏数据。请升级后端/客户端，或取消这些列的映射后再导入。',
@@ -1361,6 +1365,7 @@ const zh = {
       toggleDarkMode: '切换深色模式',
     },
     commandPalette: {
+      title: '命令面板',
       placeholder: '输入命令或搜索...',
       noResults: '未找到结果。',
       searching: '搜索中…',
@@ -1508,6 +1513,8 @@ const zh = {
           buildCrm: '帮我搭建一个 CRM：客户、联系人、商机，并建立它们之间的关系。',
           buildApp: '做一个项目管理应用：项目、任务、成员。',
           buildFlow: '设计一个工单系统：工单、优先级、状态流转。',
+          buildInventory: '做一个库存管理应用：商品、库存量、供应商，以及低库存预警。',
+          buildRecruiting: '做一个招聘跟踪应用：候选人、在招岗位、面试阶段和面试记录。',
         },
         generic: {
           help: '你可以帮我做什么？',
@@ -2035,6 +2042,7 @@ const zh = {
     settings: '工作区设置',
   },
   help: {
+    keyboardShortcuts: '键盘快捷键',
     onThisPage: '本页目录',
     appDocs: '本应用文档',
     allDocs: '全部文档',