wip(i18n): translate the newly addressable global-filter keys; fix test typing

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

Author: claude

docs/audits/2026-07-unknown-key-strictness-ledger.counts.md

@@ -264,4 +264,4 @@ directory rather than per file.
 | `kernel/` | 260 |
 | `qa/` | 6 |
 | `shared/` | 20 |
-| `system/` | 350 |
+| `system/` | 351 |

examples/app-showcase/src/system/translations/index.ts

@@ -323,6 +323,20 @@ export const ShowcaseTranslationBundle = {
           kpi_paid_rate: { title: 'Paid Rate' },
           table_rate_by_status: { title: 'Paid Rate by Status' },
         },
+        // The filter bar drawn above the widgets — declared surface since
+        // `dashboards.<name>.globalFilters` (#16772), keyed by the filter's
+        // `name`; static options keyed by their `value`.
+        globalFilters: {
+          region: { label: 'Region', options: { amer: 'AMER', emea: 'EMEA', apac: 'APAC' } },
+        },
+      },
+      showcase_ops_dashboard: {
+        globalFilters: {
+          task_status: {
+            label: 'Task Status',
+            options: { backlog: 'Backlog', todo: 'To Do', in_progress: 'In Progress', in_review: 'In Review', done: 'Done' },
+          },
+        },
       },
     },
   },
@@ -973,6 +987,20 @@ export const ShowcaseTranslationBundle = {
           kpi_paid_rate: { title: '已付比例' },
           table_rate_by_status: { title: '各状态已付比例' },
         },
+        // Born under the ratchet with `dashboards.<name>.globalFilters`
+        // (#16772): the filter label and its static option labels are
+        // declared surface now, so they are translated at birth.
+        globalFilters: {
+          region: { label: '区域', options: { amer: '美洲', emea: '欧洲、中东和非洲', apac: '亚太' } },
+        },
+      },
+      showcase_ops_dashboard: {
+        globalFilters: {
+          task_status: {
+            label: '任务状态',
+            options: { backlog: '待办池', todo: '待处理', in_progress: '进行中', in_review: '审核中', done: '已完成' },
+          },
+        },
       },
     },
     // Page component copy became declared surface with `pages.<name>.components`

packages/platform-objects/src/apps/translations/en.ts

@@ -229,6 +229,12 @@ export const en: TranslationData = {
           description: 'Event volume grouped by action (login, logout, config, …)',
         },
       },
+      // The date-range bar above the widgets — addressable since
+      // `dashboards.<name>.globalFilters` (#16772), keyed by the filter's
+      // `field` because it authors no `name`.
+      globalFilters: {
+        created_at: { label: 'Date Range' },
+      },
     },
   },
 

packages/platform-objects/src/apps/translations/es-ES.ts

@@ -154,6 +154,12 @@ export const esES: TranslationData = {
         widget_events_by_user: { title: 'Eventos por Usuario', description: 'Distribución de actividad entre usuarios' },
         widget_recent_events: { title: 'Volumen de Eventos por Acción', description: 'Volumen de eventos agrupado por acción (inicio de sesión, cierre de sesión, configuración, …)' },
       },
+      // The date-range bar above the widgets — addressable since
+      // `dashboards.<name>.globalFilters` (#16772), keyed by the filter's
+      // `field` because it authors no `name`.
+      globalFilters: {
+        created_at: { label: 'Rango de fechas' },
+      },
     },
   },
 

packages/platform-objects/src/apps/translations/ja-JP.ts

@@ -154,6 +154,12 @@ export const jaJP: TranslationData = {
         widget_events_by_user: { title: 'ユーザー別イベント', description: 'ユーザー別アクティビティ分布' },
         widget_recent_events: { title: 'アクション別イベント件数', description: 'アクション別にグループ化されたイベント件数（ログイン、ログアウト、構成など）' },
       },
+      // The date-range bar above the widgets — addressable since
+      // `dashboards.<name>.globalFilters` (#16772), keyed by the filter's
+      // `field` because it authors no `name`.
+      globalFilters: {
+        created_at: { label: '日付範囲' },
+      },
     },
   },
 

packages/platform-objects/src/apps/translations/zh-CN.ts

@@ -164,6 +164,12 @@ export const zhCN: TranslationData = {
         widget_events_by_user: { title: '按用户分布的事件', description: '用户活动分布' },
         widget_recent_events: { title: '按操作统计的事件量', description: '按操作分组的事件量（登录、登出、配置等）' },
       },
+      // The date-range bar above the widgets — addressable since
+      // `dashboards.<name>.globalFilters` (#16772), keyed by the filter's
+      // `field` because it authors no `name`.
+      globalFilters: {
+        created_at: { label: '日期范围' },
+      },
     },
   },
 

packages/spec/src/system/i18n-resolver.test.ts

@@ -1175,12 +1175,14 @@ describe('translateDashboard — global filters (#16772)', () => {
   });
 
   it('translates the filter label and its static option labels, keyed by `name`', () => {
-    const out = translateDashboard(dashboard(), bundle, { locale: 'zh-CN' });
+    // The chain is the deployment's DECLARED one (#14882): `en` is consulted
+    // because the caller names it, never by default.
+    const out = translateDashboard(dashboard(), bundle, { locale: 'zh-CN', fallbackChain: ['en'] });
     expect(out.globalFilters![0].label).toBe('申请部门');
     expect(out.globalFilters![0].options).toEqual([
       { value: 'legal', label: '法务' },
       { value: 'sales', label: '销售' },
-      // Resolved key by key along the locale chain — `ops` comes from `en`.
+      // Resolved key by key along the declared chain — `ops` comes from `en`.
       { value: 'ops', label: 'Operations' },
       // No entry anywhere on the chain: authored label kept.
       { value: 'hr', label: 'HR' },
@@ -1211,7 +1213,7 @@ describe('translateDashboard — global filters (#16772)', () => {
     expect(out.globalFilters![2]).toBe(doc.globalFilters[2]);
     // The input is never mutated.
     expect(doc.globalFilters[0].label).toBe('Requesting Department');
-    expect(doc.globalFilters[0].options[0].label).toBe('Legal');
+    expect(doc.globalFilters[0].options?.[0]?.label).toBe('Legal');
   });
 
   it('CONTROL: leaves `globalFilters` off the copy when nothing resolved, and invents none on a dashboard without filters', () => {
@@ -2318,11 +2320,12 @@ describe('translatePage — slotted page roots and tab panels (#16772)', () => {
   };
 
   it('addresses a slotted page — the walk count is non-zero and every authored id is visited once', () => {
-    // Measured here, on this fixture: 9 components authored (1 header, 1
-    // path, 1 details, 1 tabs, 3 related lists in panels, 1 card, 1 nested
-    // related list); the `body` control is not a visit. The card's own
-    // number came from one app and one console build and is not restated.
-    expect(count(contractPage())).toBe(9);
+    // Measured here, on this fixture: 8 components authored (1 header, 1
+    // path, 1 details, 1 tabs, 2 related lists directly in panels, 1 card in
+    // a panel, 1 related list nested in that card); the `body` control is
+    // not a visit. The card's own number came from one app and one console
+    // build and is not restated.
+    expect(count(contractPage())).toBe(8);
     const ids: string[] = [];
     walkAddressedPageComponents(contractPage(), (c, { id, addressed }) => {
       if (addressed) ids.push(id as string);