fix(i18n): add spec-format translations array for server mode + full i18n service

The real ObjectStack server (pnpm start) uses AppPlugin.loadTranslations()
which reads from a top-level `translations` array, not `i18n.bundles`.

Changes:
- objectstack.shared.ts: add `translations` array in spec format
  (each entry maps locale → namespace-scoped data) so AppPlugin
  can load them into the kernel's in-memory i18n fallback
- createKernel.ts: expand i18n service with loadTranslations(),
  getLocales(), getDefaultLocale(), setDefaultLocale() methods
  required by AppPlugin and HttpDispatcher
- i18n-translations.test.ts: add 3 server-mode compatibility tests

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/5581f722-7675-404d-9a1b-a025dca6484a

Author: Copilot

CHANGELOG.md

@@ -17,6 +17,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **i18n Kernel Service `getTranslations` Returns Wrong Format** (`apps/console`): Fixed the `createKernel` i18n service registration where `getTranslations` returned a wrapped `{ locale, translations }` object instead of the flat `Record<string, any>` dictionary expected by the spec's `II18nService` interface. The HttpDispatcher wraps the service return value in `{ data: { locale, translations } }`, so the extra wrapping caused translations to be empty or double-nested in the API response (`/api/v1/i18n/translations/:lang`). The service now returns `resolveI18nTranslations(bundles, lang)` directly, aligning with the spec and making CRM business translations work correctly in all environments (MSW, server, dev).
 
+- **i18n Translations Empty in Server Mode (`pnpm start`)** (`apps/console`): Fixed translations returning `{}` when running the real ObjectStack server on port 3000. The runtime's `AppPlugin.loadTranslations()` looks for translations in a top-level `translations` array in the config, but the console's `sharedConfig` only provided them in the custom `i18n.bundles` format used by `createKernel.ts`. Added a `translations` array in the spec-expected format (each entry maps `{ [locale]: { namespace: data } }`) to `objectstack.shared.ts` so that `AppPlugin` can load them into the kernel's in-memory i18n fallback. Also expanded the i18n service registration in `createKernel.ts` to implement `loadTranslations()`, `getLocales()`, `getDefaultLocale()`, and `setDefaultLocale()` — methods required by both `AppPlugin` and `HttpDispatcher`.
+
 - **Duplicate Data in Calendar and Kanban Views** (`@object-ui/plugin-view`, `@object-ui/plugin-kanban`, `@object-ui/plugin-list`): Fixed a bug where Calendar and Kanban views displayed every record twice. The root cause was that `ObjectView` (plugin-view) unconditionally fetched data even when a `renderListView` callback was provided — causing parallel duplicate requests since `ListView` (plugin-list) independently fetches its own data. The duplicate fetch results triggered re-renders that destabilised child component rendering, leading to duplicate events in the calendar and duplicate cards on the kanban board. Additionally, `ObjectKanban` lacked proper external-data handling (`data`/`loading` props with `hasExternalData` guard), unlike `ObjectCalendar` which already had this pattern. Fixes: (1) `ObjectView` now skips its own fetch when `renderListView` is provided, (2) `ObjectKanban` now accepts explicit `data`/`loading` props and skips internal fetch when external data is supplied (matching `ObjectCalendar`'s pattern), (3) `ListView` now handles `{ value: [] }` OData response format consistently with `extractRecords` utility. Includes regression tests.
 
 - **CI Build Fix: Replace dynamic `require()` with static imports** (`@object-ui/plugin-view`): Replaced module-level `require('@object-ui/react')` calls in `index.tsx` and `ObjectView.tsx` with static `import` statements. The dynamic `require()` pattern is not supported by Next.js Turbopack, causing the docs site build to fail during SSR prerendering of the `/docs/components/complex/view-switcher` page with `Error: dynamic usage of require is not supported`. Since `@object-ui/react` is already a declared dependency and other files in the package use static imports from it, replacing the `require()` with static imports is safe and eliminates the SSR compatibility issue.

apps/console/objectstack.shared.ts

@@ -30,6 +30,19 @@ const i18nBundles = allConfigs
   .map((c: any) => c.i18n)
   .filter((i: any) => i?.namespace && i?.translations);
 
+// Build the spec `translations` array for the runtime's AppPlugin.
+// AppPlugin.loadTranslations expects `translations: Array<{ [locale]: data }>`.
+// Each locale's data is nested under the bundle's namespace so that
+// both the server-mode (AppPlugin → memory i18n) and MSW-mode (createKernel)
+// produce the same structure: `{ crm: { objects: { ... } } }`.
+const specTranslations: Record<string, any>[] = i18nBundles.map((bundle: any) => {
+  const result: Record<string, any> = {};
+  for (const [locale, data] of Object.entries(bundle.translations)) {
+    result[locale] = { [bundle.namespace]: data };
+  }
+  return result;
+});
+
 // Protocol-level composition via @objectstack/spec: handles object dedup,
 // array concatenation, actions→objects mapping, and manifest selection.
 const composed = composeStacks(allConfigs as any[], { objectConflict: 'override' }) as any;
@@ -97,7 +110,13 @@ export const sharedConfig = {
   },
   i18n: {
     bundles: i18nBundles,
+    defaultLocale: 'en',
   },
+  // Spec-format translations array consumed by AppPlugin.loadTranslations()
+  // in real-server mode (pnpm start). Each entry maps locale → namespace-scoped
+  // translation data so the runtime's memory i18n fallback serves the same
+  // structure as the MSW mock handler.
+  translations: specTranslations,
   plugins: [],
   datasources: [
     {

apps/console/src/__tests__/i18n-translations.test.ts

@@ -111,4 +111,42 @@ describe('i18n translations pipeline', () => {
 
     expect(json?.data?.translations?.crm?.objects?.account?.label).toBe(EXPECTED_EN_ACCOUNT_LABEL);
   });
-});
+
+  // ── Server-mode compatibility (AppPlugin.loadTranslations) ────────
+
+  it('kernel i18n service supports loadTranslations (AppPlugin compat)', () => {
+    const i18nService = result.kernel.getService('i18n');
+
+    // AppPlugin.loadTranslations calls these methods; they must exist
+    expect(typeof i18nService.loadTranslations).toBe('function');
+    expect(typeof i18nService.getLocales).toBe('function');
+    expect(typeof i18nService.getDefaultLocale).toBe('function');
+    expect(typeof i18nService.setDefaultLocale).toBe('function');
+  });
+
+  it('kernel i18n service getLocales returns all CRM locales', () => {
+    const i18nService = result.kernel.getService('i18n');
+    const locales = i18nService.getLocales();
+
+    // CRM declares 10 locales: en, zh, ja, ko, de, fr, es, pt, ru, ar
+    expect(locales).toContain('en');
+    expect(locales).toContain('zh');
+    expect(locales.length).toBeGreaterThanOrEqual(10);
+  });
+
+  it('appConfig.translations is spec-format array for AppPlugin', () => {
+    const translations = (appConfig as any).translations;
+
+    expect(Array.isArray(translations)).toBe(true);
+    expect(translations.length).toBeGreaterThan(0);
+
+    // Each entry maps locale → namespace-scoped data
+    const first = translations[0];
+    expect(first).toHaveProperty('zh');
+    expect(first).toHaveProperty('en');
+    // Data must be nested under namespace (e.g. 'crm')
+    expect(first.zh).toHaveProperty('crm');
+    expect(first.zh.crm.objects.account.label).toBe(EXPECTED_ZH_ACCOUNT_LABEL);
+    expect(first.en.crm.objects.account.label).toBe(EXPECTED_EN_ACCOUNT_LABEL);
+  });
+});

apps/console/src/mocks/createKernel.ts

@@ -332,8 +332,43 @@ export async function createKernel(options: KernelOptions): Promise<KernelResult
   const i18nBundles: I18nBundle[] = appConfig.i18n?.bundles ?? [];
 
   if (i18nBundles.length > 0) {
+    // Build a complete i18n service that satisfies both:
+    //  - HttpDispatcher.handleI18n (calls getTranslations, getLocales)
+    //  - AppPlugin.loadTranslations (calls loadTranslations, setDefaultLocale)
+    // In MSW mode the custom handler serves translations directly, but the
+    // kernel service is still needed for the broker shim and dispatcher paths.
+    const appPluginTranslations = new Map<string, Record<string, unknown>>();
+    let defaultLocale = 'en';
+
     kernel.registerService('i18n', {
-      getTranslations: (lang: string) => resolveI18nTranslations(i18nBundles, lang),
+      getTranslations: (lang: string) => {
+        const resolved = resolveI18nTranslations(i18nBundles, lang);
+        const extra = appPluginTranslations.get(lang);
+        if (extra) {
+          // Shallow merge: AppPlugin-loaded translations override bundle translations
+          return { ...resolved, ...extra };
+        }
+        return resolved;
+      },
+      loadTranslations: (locale: string, data: Record<string, unknown>) => {
+        const existing = appPluginTranslations.get(locale) ?? {};
+        appPluginTranslations.set(locale, { ...existing, ...data });
+      },
+      getLocales: () => {
+        // Collect all available locales from bundles + any loaded via loadTranslations
+        const locales = new Set<string>();
+        for (const bundle of i18nBundles) {
+          for (const lang of Object.keys(bundle.translations)) {
+            locales.add(lang);
+          }
+        }
+        for (const lang of appPluginTranslations.keys()) {
+          locales.add(lang);
+        }
+        return [...locales];
+      },
+      getDefaultLocale: () => defaultLocale,
+      setDefaultLocale: (locale: string) => { defaultLocale = locale; },
     });
   }