Load multiple AppPlugin configs; adapt i18n

Refactor runtime config handling to load each example stack as an independent AppPlugin and normalize i18n/views handling.

- Introduce prepareConfig() and export appConfigs + setupAppConfig from objectstack.shared.ts; merge views into object defs and convert stack i18n -> spec translations format.
- Replace monolithic composeStacks/merged config approach with per-stack appConfigs; build aggregated sharedConfig fields (objects/apps/pages/dashboards/reports) from individual configs for backward compatibility.
- Update createKernel to accept appConfigs (while still supporting legacy appConfig), register one AppPlugin per config, aggregate cubes for analytics, and collect i18n bundles across configs.
- Update MSW/browser/server mocks and tests to pass appConfigs + setupAppConfig; adjust memory i18n plugin usage.
- Update top-level objectstack.config.ts to prepare and register each example config as AppPlugin instead of using a composed merged app.

This change fixes ordering/timing issues around SetupPlugin/AppPlugin and ensures the i18n pipeline and seed data work consistently across MSW and server modes.

Author: hotlong

apps/console/objectstack.config.ts

@@ -4,7 +4,7 @@ const require = createRequire(import.meta.url);
 // @ts-ignore
 globalThis.require = require;
 
-import { sharedConfig } from './objectstack.shared';
+import { sharedConfig, appConfigs, setupAppConfig } from './objectstack.shared';
 
 // @ts-ignore
 import * as MSWPluginPkg from '@objectstack/plugin-msw';
@@ -73,9 +73,12 @@ class MemoryI18nPlugin {
  */
 const plugins: any[] = [
     new MemoryI18nPlugin(),
-    new AppPlugin(sharedConfig),
     new ObjectQLPlugin(),
     new DriverPlugin(new InMemoryDriver(), 'memory'),
+    // Each example stack loaded as an independent AppPlugin
+    ...appConfigs.map((config: any) => new AppPlugin(config)),
+    // Setup App registered via AppPlugin so ObjectQLPlugin discovers it
+    new AppPlugin(setupAppConfig),
     new HonoServerPlugin({ port: 3000 }),
     new ConsolePlugin(),
 ];

apps/console/objectstack.shared.ts

@@ -1,5 +1,4 @@
 import type { ObjectStackDefinition } from '@objectstack/spec';
-import { composeStacks } from '@objectstack/spec';
 import { mergeViewsIntoObjects } from '@object-ui/core';
 import { SETUP_APP_DEFAULTS } from '@objectstack/plugin-setup';
 import crmConfigImport from '@object-ui/example-crm/objectstack.config';
@@ -15,47 +14,48 @@ function resolveDefault<T>(mod: MaybeDefault<T>): T {
   return mod as T;
 }
 
-const crmConfig = resolveDefault<ObjectStackDefinition>(crmConfigImport);
-const todoConfig = resolveDefault<ObjectStackDefinition>(todoConfigImport);
-const kitchenSinkConfig = resolveDefault<ObjectStackDefinition>(kitchenSinkConfigImport);
-
-const allConfigs = [crmConfig, todoConfig, kitchenSinkConfig];
-
-// Aggregate seed data from all manifest.data arrays (spec selects one manifest,
-// so we collect data from all stacks before composing).
-const allData = allConfigs.flatMap((c: any) => c.manifest?.data || c.data || []);
-
-// Aggregate i18n bundles from all stacks that declare an i18n section.
-// Each bundle carries a namespace (e.g. 'crm') and per-language translations.
-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 };
+/**
+ * Adapter: prepare a stack config for AppPlugin.
+ * - Merges stack-level views into object definitions
+ * - Converts i18n translations to the spec format AppPlugin expects
+ */
+function prepareConfig(config: any) {
+  const result = { ...config };
+  if (result.objects && result.views) {
+    result.objects = mergeViewsIntoObjects(result.objects, result.views);
+  }
+  if (result.i18n?.namespace && result.i18n?.translations) {
+    const ns = result.i18n.namespace;
+    const converted: Record<string, any> = {};
+    for (const [locale, data] of Object.entries(result.i18n.translations)) {
+      converted[locale] = { [ns]: data };
+    }
+    result.translations = [converted];
   }
   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;
+const crmConfig = prepareConfig(resolveDefault<ObjectStackDefinition>(crmConfigImport));
+const todoConfig = prepareConfig(resolveDefault<ObjectStackDefinition>(todoConfigImport));
+const kitchenSinkConfig = prepareConfig(resolveDefault<ObjectStackDefinition>(kitchenSinkConfigImport));
 
-// Adapter: merge views[].listViews into object definitions for the runtime.
-if (composed.objects && composed.views) {
-  composed.objects = mergeViewsIntoObjects(composed.objects, composed.views);
-}
+/**
+ * Individual prepared configs for per-plugin AppPlugin loading.
+ * Used by createKernel and server-mode objectstack.config.ts.
+ */
+export const appConfigs = [crmConfig, todoConfig, kitchenSinkConfig];
+
+// Setup App config for registration via AppPlugin (avoids SetupPlugin timing issue)
+export const setupAppConfig = {
+  apps: [SETUP_APP_DEFAULTS],
+  manifest: { id: 'setup', name: 'setup' },
+};
 
 // Patch CRM App Navigation to include Report using a supported navigation type
-// (type: 'url' passes schema validation while still routing correctly via React Router)
-const apps = [...JSON.parse(JSON.stringify(composed.apps || [])), SETUP_APP_DEFAULTS];
+const apps = [
+  ...JSON.parse(JSON.stringify(appConfigs.flatMap((c: any) => c.apps || []))),
+  SETUP_APP_DEFAULTS,
+];
 const crmApp = apps.find((a: any) => a.name === 'crm_app');
 if (crmApp?.navigation) {
     const dashboardIdx = crmApp.navigation.findIndex((n: any) => n.id === 'nav_dashboard');
@@ -69,24 +69,29 @@ if (crmApp?.navigation) {
     });
 }
 
+// Aggregate i18n bundles from all stacks
+const i18nBundles = appConfigs
+  .map((c: any) => c.i18n)
+  .filter((i: any) => i?.namespace && i?.translations);
+
+// Aggregate seed data across all configs
+const allData = appConfigs.flatMap((c: any) => c.manifest?.data || c.data || []);
+
+/**
+ * Aggregated sharedConfig for backward compatibility.
+ * Used by tests that mock objectstack.shared and by components
+ * that need aggregated metadata (apps, objects, etc.).
+ */
 export const sharedConfig = {
-  // ============================================================================
-  // Project Metadata
-  // ============================================================================
-  
   name: '@object-ui/console',
   version: '0.1.0',
   description: 'ObjectStack Console',
-  
-  // ============================================================================
-  // Merged Stack Configuration (CRM + Todo + Kitchen Sink)
-  // ============================================================================
-  objects: composed.objects,
+
+  objects: appConfigs.flatMap((c: any) => c.objects || []),
   apps,
-  dashboards: composed.dashboards,
+  dashboards: appConfigs.flatMap((c: any) => c.dashboards || []),
   reports: [
-    ...(composed.reports || []),
-    // Console-specific report not in any example stack
+    ...appConfigs.flatMap((c: any) => c.reports || []),
     {
       name: 'sales_performance_q1',
       label: 'Q1 Sales Performance',
@@ -101,7 +106,7 @@ export const sharedConfig = {
       ]
     }
   ],
-  pages: composed.pages,
+  pages: appConfigs.flatMap((c: any) => c.pages || []),
   manifest: {
     id: 'com.objectui.console',
     version: '0.1.0',
@@ -113,11 +118,6 @@ export const sharedConfig = {
     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

@@ -13,7 +13,7 @@ import { describe, it, expect, beforeAll, afterAll } from 'vitest';
 import { setupServer } from 'msw/node';
 import { createKernel, type KernelResult } from '../mocks/createKernel';
 import { createAuthHandlers } from '../mocks/authHandlers';
-import appConfig from '../../objectstack.shared';
+import { appConfigs, setupAppConfig } from '../../objectstack.shared';
 import { crmLocales } from '@object-ui/example-crm';
 
 // Expected values from the CRM i18n bundles — avoid hard-coding in assertions
@@ -26,7 +26,7 @@ describe('i18n translations pipeline', () => {
 
   beforeAll(async () => {
     result = await createKernel({
-      appConfig,
+      appConfigs: [...appConfigs, setupAppConfig],
       persistence: false,
       mswOptions: {
         enableBrowser: false,

apps/console/src/mocks/browser.ts

@@ -16,7 +16,7 @@ import { setupWorker } from 'msw/browser';
 import { ObjectKernel } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 import type { MSWPlugin } from '@objectstack/plugin-msw';
-import appConfig from '../../objectstack.shared';
+import { appConfigs, setupAppConfig } from '../../objectstack.shared';
 import { createKernel } from './createKernel';
 import { createAuthHandlers } from './authHandlers';
 
@@ -43,7 +43,7 @@ export async function startMockServer() {
   if (import.meta.env.DEV) console.log('[MSW] Starting ObjectStack Runtime (Browser Mode)...');
 
   const result = await createKernel({
-    appConfig,
+    appConfigs: [...appConfigs, setupAppConfig],
     mswOptions: {
       enableBrowser: false,
       baseUrl: '/api/v1',

apps/console/src/mocks/createKernel.ts

@@ -22,8 +22,10 @@ import type { Cube } from '@objectstack/spec/data';
 import { http, HttpResponse } from 'msw';
 
 export interface KernelOptions {
-  /** Application configuration (defineStack output) */
-  appConfig: any;
+  /** Application configuration (defineStack output). Deprecated: use appConfigs instead. */
+  appConfig?: any;
+  /** Individual application configurations loaded as separate AppPlugin instances. */
+  appConfigs?: any[];
   /** Whether to skip system validation (useful in browser) */
   skipSystemValidation?: boolean;
   /** MSWPlugin options; when provided, MSWPlugin is added to the kernel. */
@@ -297,7 +299,10 @@ function resolveI18nTranslations(
  * so that kernel setup logic is not duplicated.
  */
 export async function createKernel(options: KernelOptions): Promise<KernelResult> {
-  const { appConfig, skipSystemValidation = true, mswOptions, persistence } = options;
+  const { appConfig, appConfigs, skipSystemValidation = true, mswOptions, persistence } = options;
+
+  // Support both single appConfig (legacy) and multiple appConfigs
+  const configs: any[] = appConfigs ?? (appConfig ? [appConfig] : []);
 
   const driver = new InMemoryDriver(
     persistence !== undefined ? { persistence } : undefined,
@@ -309,15 +314,17 @@ export async function createKernel(options: KernelOptions): Promise<KernelResult
 
   await kernel.use(new ObjectQLPlugin());
   await kernel.use(new DriverPlugin(driver, 'memory'));
-  await kernel.use(new AppPlugin(appConfig));
+  for (const config of configs) {
+    await kernel.use(new AppPlugin(config));
+  }
   await kernel.use(new SetupPlugin());
 
   // Register MemoryAnalyticsService so that HttpDispatcher can serve
   // /api/v1/analytics/* endpoints in demo/MSW/dev environments.
   // Without this, analytics routes return 405 because the kernel has
   // no 'analytics' service and the dispatcher skips the handler.
-  const cubes = buildCubesFromConfig(appConfig);
-  const memoryAnalytics = new MemoryAnalyticsService({ driver, cubes });
+  const allCubes = configs.flatMap(c => buildCubesFromConfig(c));
+  const memoryAnalytics = new MemoryAnalyticsService({ driver, cubes: allCubes });
   kernel.registerService('analytics', {
     query: (query: any) => memoryAnalytics.query(query),
     getMeta: (cubeName?: string) => memoryAnalytics.getMeta(cubeName),
@@ -327,11 +334,13 @@ export async function createKernel(options: KernelOptions): Promise<KernelResult
   });
 
   // ── i18n service registration ──────────────────────────────────────
-  // Read translation bundles from the app config (populated by each stack's
-  // `i18n: { namespace, translations }` field and merged via sharedConfig).
-  // This ensures both MSW/mock and server modes share the same translation
-  // resolution pipeline — no manual per-environment i18n handlers required.
-  const i18nBundles: I18nBundle[] = appConfig.i18n?.bundles ?? [];
+  // Collect translation bundles from all app configs.
+  // Each config may have i18n.bundles (aggregated) or i18n with namespace+translations (individual stack).
+  const i18nBundles: I18nBundle[] = configs.flatMap((c: any) => {
+    if (c.i18n?.bundles) return c.i18n.bundles;
+    if (c.i18n?.namespace && c.i18n?.translations) return [c.i18n];
+    return [];
+  });
 
   if (i18nBundles.length > 0) {
     // Build a complete i18n service that satisfies both:

apps/console/src/mocks/server.ts

@@ -16,7 +16,7 @@ import { ObjectKernel } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 import { setupServer } from 'msw/node';
 import type { MSWPlugin } from '@objectstack/plugin-msw';
-import appConfig from '../../objectstack.shared';
+import { appConfigs, setupAppConfig } from '../../objectstack.shared';
 import { createKernel } from './createKernel';
 import { createAuthHandlers } from './authHandlers';
 
@@ -34,7 +34,7 @@ export async function startMockServer() {
   console.log('[MSW] Starting ObjectStack Runtime (Test Mode)...');
 
   const result = await createKernel({
-    appConfig,
+    appConfigs: [...appConfigs, setupAppConfig],
     persistence: false,
     mswOptions: {
       enableBrowser: false,