Skip to content

feat(i18n): translate the four highest-traffic namespaces into the eight trailing locales (#2872 part a) - #2903

Merged
os-zhuang merged 1 commit into
mainfrom
claude/custom-system-page-i18n-6ni3f8
Jul 28, 2026
Merged

feat(i18n): translate the four highest-traffic namespaces into the eight trailing locales (#2872 part a)#2903
os-zhuang merged 1 commit into
mainfrom
claude/custom-system-page-i18n-6ni3f8

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Implements the "high-frequency namespaces only" strategy chosen for #2872 part (a).

Backfills console, home, topbar and layout193 keys × 8 packs = 1,544 strings — so a ja/ko/de/fr/es/pt/ru/ar admin sees the AI console, home screen, top bar and system navigation in their own language instead of silently falling back to English.

before after
ja / ko / de / es 469 missing 277
fr / pt / ru / ar 471 missing 279
en ↔ zh 2499 : 2499, 0 diff unchanged

Not a full backfill by design: grid (101), gantt (58), dashboard (25) and the long tail stay on English fallback and remain tracked under #2872.

The load-bearing part: four keys deliberately left untranslated

console.ai.planApproveMessage
console.ai.planApproveDefaultsMessage
console.ai.planAnswerMessage
console.ai.changesConfirmMessage

These are not labels. They are text a button transmits to the agent, and the cloud confirm gate (service-ai-studio confirm-gate.ts APPROVAL_RE) decides whether that text reads as approval. It recognises Chinese and English — nothing else. zh.ts already documents this:

the cloud confirm gate […] only treats Chinese text as approval when it is 确认-anchored […] A bare "…搭建吧" silently fails the gate → the agent re-proposes and the button looks inert.

AiChatPage therefore selects them by the language of the conversation, not the UI, and the t() call is expected to miss in every non-Chinese pack and fall through to its English defaultValue. Translating them would be an outright regression: a German user's "Build it" would start sending German, the gate would stop matching, and the agent would re-propose instead of building — inert button, nothing visibly erroring.

Important

This fixes a regression I introduced in #2900. That PR added changesConfirmMessage to all ten packs, so on main today a German/Japanese/Russian user clicking Confirm on the change card sends translated text the gate cannot match. This PR removes it from the eight and restores the English fallback.

I found it only because this backfill forced me to classify every console.ai key as label-vs-outbound. Worth noting for the record — the same category error is what the new guard now prevents.

packages/i18n/src/__tests__/outbound-agent-messages.test.ts pins the invariant in both directions: the four keys must be absent from the eight packs and present in en/zh — plus a third assertion that every other console.ai label is translated, so the narrow exception can't quietly become an excuse for leaving surrounding labels in English.

Verification

  • Full suite: 7800 passed, 24 skipped, 0 failed.
  • turbo build: 44/44 — the check that caught the fix(i18n): unconditional Chinese in the chatbot confirm card and field inspector (#2884, #2885) #2900 build break.
  • ESLint: 25 errors, identical to baseline, all pre-existing.
  • The guard was mutation-tested twice: re-adding two outbound keys to de fails it, and deleting an ordinary console.ai label from de fails the non-vacuity assertion. Both restored after.
  • The merge script cross-checked its own line parser against the real parsed module for each pack and refused to write until they agreed — it caught two parser bugs (quoted keys like 'developer-tools', and values wrapping to the next line) before touching any file.
  • Placeholder sets ({{count}}, {{app}}, {{n}}, …) verified programmatically per string against the English source; spot-checked rendered output across all nine packs.

Note

@object-ui/plugin-map#type-check fails locally with maplibre-gl@6.0.0 has no default export. It is pre-existing — reproduces on clean origin/main with my changes stashed — and is not in CI's path (turbo build covers this repo's build). Unrelated to i18n; flagging rather than folding an unrelated fix into this PR.

Translation quality

Translations are model-generated. Terminology follows each pack's existing conventions, and locale-appropriate quotation marks are used (「」 ja, „" de, « » fr, «» ru/es). They would still benefit from native review before anyone treats them as final — flagging plainly rather than implying they are professionally translated.


Generated by Claude Code

…ght trailing locales (#2872 part a)

Backfills `console`, `home`, `topbar` and `layout` — 193 keys x 8 packs,
1,544 strings — so a ja/ko/de/fr/es/pt/ru/ar admin sees the AI console, the
home screen, the top bar and the system navigation in their own language
instead of silently falling back to English. The gap in those eight packs
drops from 469-471 keys to 277-279; en and zh stay at exact parity.

This is the "high-frequency namespaces only" strategy, not a full backfill:
`grid` (101), `gantt` (58), `dashboard` (25) and the long tail stay on
English fallback and remain tracked under #2872.

Four keys are deliberately NOT translated, and that is the load-bearing part
of this change:

  console.ai.planApproveMessage
  console.ai.planApproveDefaultsMessage
  console.ai.planAnswerMessage
  console.ai.changesConfirmMessage

These are not labels — they are text a button TRANSMITS to the agent, and the
cloud confirm gate (service-ai-studio confirm-gate.ts APPROVAL_RE) decides
whether it reads as approval. It recognises Chinese and English, nothing else.
AiChatPage picks them by the language of the CONVERSATION, not the UI, so the
t() call is expected to miss in every non-Chinese pack and fall through to its
English defaultValue. Translating them would make a German user's "Build it"
send German, the gate stop matching, and the agent re-propose instead of
building — the button looks inert while nothing visibly errors.

#2900 shipped exactly that bug for changesConfirmMessage, which had been added
to all ten packs; this removes it from the eight and restores the English
fallback. A new guard pins the invariant in both directions and was
mutation-tested against re-adding an outbound key and against dropping an
ordinary label.

Translations are model-generated and would benefit from native review; every
string's placeholder set was verified programmatically against the English
source.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TubWYdWquVkS9dj733sDmC
@vercel

vercel Bot commented Jul 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Jul 28, 2026 5:52am

Request Review

@github-actions github-actions Bot added the tests label Jul 28, 2026
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 27.9 KB 350 KB
Entry file index-Bi3MxUz_.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 8.20KB 2.97KB
app-shell (runtime-config.js) 7.42KB 2.32KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 7.57KB 2.97KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 22.10KB 4.37KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.12KB 3.41KB
auth (LoginForm.js) 17.86KB 5.29KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.43KB 2.09KB
auth (SocialSignInButtons.js) 9.60KB 3.89KB
auth (UserMenu.js) 3.40KB 1.22KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 35.76KB 9.11KB
auth (createAuthenticatedFetch.js) 4.37KB 1.69KB
auth (index.js) 2.17KB 0.96KB
auth (org-roles.js) 5.50KB 2.36KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 4.91KB 0.87KB
auth (useIsWorkspaceAdmin.js) 1.61KB 0.85KB
collaboration (CommentThread.js) 18.38KB 4.49KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 3.65KB 1.42KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.25KB 0.53KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 449.62KB 97.73KB
core (index.js) 2.12KB 0.77KB
create-plugin (index.js) 9.28KB 2.98KB
data-objectstack (index.js) 127.78KB 32.15KB
fields (index.js) 218.37KB 53.54KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (i18n.js) 4.32KB 1.77KB
i18n (index.js) 2.46KB 0.96KB
i18n (pickLocalized.js) 1.70KB 0.83KB
i18n (provider.js) 5.37KB 1.72KB
i18n (useObjectLabel.js) 25.17KB 5.80KB
i18n (useSafeTranslation.js) 3.26KB 1.44KB
layout (index.js) 38.45KB 10.67KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.74KB
mobile (index.js) 1.50KB 0.62KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 4.42KB 1.27KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.71KB 0.42KB
mobile (useResponsiveConfig.js) 1.36KB 0.63KB
mobile (useSpecGesture.js) 1.77KB 0.77KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 6.84KB 2.42KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 3.67KB 1.12KB
permissions (evaluator.js) 4.00KB 1.23KB
permissions (index.js) 0.91KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.52KB
permissions (usePermissions.js) 1.55KB 0.71KB
plugin-ai (index.js) 15.71KB 3.79KB
plugin-calendar (index.js) 44.90KB 12.35KB
plugin-charts (index.js) 57.26KB 16.24KB
plugin-chatbot (index.js) 179.94KB 42.67KB
plugin-dashboard (index.js) 109.60KB 28.33KB
plugin-designer (index.js) 210.56KB 42.56KB
plugin-detail (index.js) 214.86KB 52.39KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 103.47KB 25.10KB
plugin-gantt (index.js) 162.26KB 39.53KB
plugin-grid (index.js) 179.25KB 46.97KB
plugin-kanban (index.js) 47.82KB 13.18KB
plugin-list (index.js) 98.64KB 23.33KB
plugin-map (index.js) 16.80KB 5.24KB
plugin-markdown (index.js) 13.65KB 4.67KB
plugin-report (index.js) 37.07KB 9.81KB
plugin-timeline (index.js) 25.03KB 7.11KB
plugin-tree (index.js) 8.36KB 2.81KB
plugin-view (index.js) 85.68KB 20.85KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.55KB 0.67KB
providers (UploadProvider.js) 11.71KB 3.53KB
providers (index.js) 0.44KB 0.22KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 3.19KB 1.38KB
react (LazyPluginLoader.js) 3.77KB 1.33KB
react (SchemaRenderer.js) 18.70KB 6.09KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 1.00KB 0.55KB
sdui-parser (codegen.js) 4.09KB 1.74KB
sdui-parser (index.js) 2.16KB 0.94KB
sdui-parser (parse.js) 10.04KB 2.82KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 4.69KB 1.48KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 0.20KB 0.18KB
types (crud.js) 0.20KB 0.18KB
types (data-display.js) 0.20KB 0.18KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 0.77KB 0.41KB
types (disclosure.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (index.js) 1.86KB 0.91KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 0.20KB 0.18KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (spec-report.js) 5.04KB 1.93KB
types (system-fields.js) 2.39KB 1.17KB
types (theme.js) 0.20KB 0.18KB
types (ui-action.js) 0.75KB 0.46KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@os-zhuang
os-zhuang marked this pull request as ready for review July 28, 2026 05:56
@os-zhuang
os-zhuang merged commit e05f052 into main Jul 28, 2026
14 checks passed
@os-zhuang
os-zhuang deleted the claude/custom-system-page-i18n-6ni3f8 branch July 28, 2026 05:57
os-zhuang pushed a commit that referenced this pull request Jul 28, 2026
…ently erode

#2903 translated `console`, `home`, `topbar` and `layout` into all ten packs.
Nothing stopped that from decaying: `fallbackLng: 'en'` means dropping a key
from `de` renders English, which reads as "not translated yet" rather than
"we lost this", and the missing-key handler is dev-only so CI never sees it.

This is #2872's P3 applied only to the namespaces that are actually complete.
Full parity would fail today by ~277 keys per pack with no action attached —
a broken build, not a guard. Widen RATCHETED_NAMESPACES as each remaining
namespace is translated, not before.

Asserts both directions, because the packs have drifted both ways before:
every ratcheted en key exists in the other nine packs, and no pack defines a
ratcheted key en lacks (#2872 part b was exactly that, 74 keys deep, hidden
behind a component-private fallback so English "happened to" render).

The four outbound agent messages are excluded — they are deliberately absent
from the eight non-gate packs, and outbound-agent-messages.test.ts owns that
invariant; the two guards would otherwise contradict each other.

A non-vacuity assertion pins the ratchet at >300 keys and requires every named
namespace to contribute, so a rename cannot reduce the file to a no-op.
Mutation-tested in both directions: removing topbar.offline from fr fails the
first, adding an en-less key to fr fails the second.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TubWYdWquVkS9dj733sDmC
os-zhuang added a commit that referenced this pull request Jul 28, 2026
…rejects, + parity ratchet (#2905)

* fix(i18n): the change card's Confirm button sent text the cloud gate rejects

The English `console.ai.changesConfirmMessage` was "Confirm the changes —
apply what you just proposed." The cloud confirm gate (service-ai-studio
confirm-gate.ts APPROVAL_RE) recognises `apply (this|the) change` — not
"apply what". The message therefore failed the gate, and failing it is
silent: the agent re-proposes instead of applying and the Confirm button on
the change card just looks inert.

This hit English conversations AND all eight locales that fall back to
English for that key. Now "Confirm — apply the change you just proposed." —
singular, so it still matches if the gate ever tightens to a word boundary.
The Chinese string always matched (确认修改) and is unchanged. The same
literal lives in four places (locale pack, prop default, its doc comment,
AiChatPage defaultValue); all four move together.

Why the existing guard missed it: i18n.test.ts mirrored only the CHINESE
clause of APPROVAL_RE, and the English half was weakened to "starts with
Confirm, contains apply" because nothing in this repo could see the real
pattern. That assertion passed against a string the gate rejected — green
guard, broken feature.

The mirror is now verbatim and covers both clauses, driving an it.each over
every outbound approval message in zh and en. Two supporting tests keep it
honest: the gate must stay narrow (a plain build request is not approval),
and planAnswerMessage must NOT match, since it answers a structure question
rather than granting blanket approval.

Verified by running the real regex against every outbound string, and by
mutation-testing the new guard against the exact string that shipped.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TubWYdWquVkS9dj733sDmC

* test(i18n): ratchet the four backfilled namespaces so they cannot silently erode

#2903 translated `console`, `home`, `topbar` and `layout` into all ten packs.
Nothing stopped that from decaying: `fallbackLng: 'en'` means dropping a key
from `de` renders English, which reads as "not translated yet" rather than
"we lost this", and the missing-key handler is dev-only so CI never sees it.

This is #2872's P3 applied only to the namespaces that are actually complete.
Full parity would fail today by ~277 keys per pack with no action attached —
a broken build, not a guard. Widen RATCHETED_NAMESPACES as each remaining
namespace is translated, not before.

Asserts both directions, because the packs have drifted both ways before:
every ratcheted en key exists in the other nine packs, and no pack defines a
ratcheted key en lacks (#2872 part b was exactly that, 74 keys deep, hidden
behind a component-private fallback so English "happened to" render).

The four outbound agent messages are excluded — they are deliberately absent
from the eight non-gate packs, and outbound-agent-messages.test.ts owns that
invariant; the two guards would otherwise contradict each other.

A non-vacuity assertion pins the ratchet at >300 keys and requires every named
namespace to contribute, so a rename cannot reduce the file to a no-op.
Mutation-tested in both directions: removing topbar.offline from fr fails the
first, adding an en-less key to fr fails the second.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TubWYdWquVkS9dj733sDmC

---------

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants