@saasicat/ui-vue 0.5.0 → 0.7.0

package/dist/quasar/index.d.cts

@@ -2,8 +2,8 @@ import { Component, App } from 'vue';
 import { QuasarPluginOptions } from 'quasar';
 import { Pinia } from 'pinia';
 import { RouteRecordRaw, RouterHistory, Router } from 'vue-router';
-import { H as HttpClient } from '../action-registry-CQ2wL3R-.cjs';
-import { S as SuperAdminGuardOptions, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, A as ActionsMap, c as SuperAdminLoginAdapter, U as UiNotify, I as InstallPlugin } from '../ui-notify-D_eAAwRh.cjs';
+import { H as HttpClient } from '../messages-7b0P8W75.cjs';
+import { S as SuperAdminGuardOptions, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, A as ActionsMap, c as SuperAdminLoginAdapter, U as UiNotify, I as InstallPlugin, d as SuperAdminI18nOptions, e as SuperAdminI18n } from '../use-super-admin-i18n-DMktRVEt.cjs';
 import '@saasicat/types';
 
 interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {
@@ -59,11 +59,20 @@ interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {
      * including for the setup wizard. Consumed via `useSuperAdminHttp()`.
      */
     http?: HttpClient;
+    /**
+     * Optional: UI locale + string overrides. Default is German. The created
+     * context is returned on the handle (`handle.i18n`) — set
+     * `handle.i18n.locale.value = 'en'` (or pass a `Ref` here) to switch at
+     * runtime. Consumed via `useSuperAdminI18n()` / `useSaMessages()`.
+     */
+    i18n?: SuperAdminI18nOptions;
 }
 interface SuperAdminAppHandle {
     app: App;
     router: Router;
     pinia: Pinia;
+    /** i18n context of the shell — switch locale via `i18n.locale.value`. */
+    i18n: SuperAdminI18n;
     /** Mounts the app on a selector. Returns the root component instance. */
     mount: (selector: string | Element) => ReturnType<App['mount']>;
 }

package/dist/quasar/index.d.ts

@@ -2,8 +2,8 @@ import { Component, App } from 'vue';
 import { QuasarPluginOptions } from 'quasar';
 import { Pinia } from 'pinia';
 import { RouteRecordRaw, RouterHistory, Router } from 'vue-router';
-import { H as HttpClient } from '../action-registry-CQ2wL3R-.js';
-import { S as SuperAdminGuardOptions, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, A as ActionsMap, c as SuperAdminLoginAdapter, U as UiNotify, I as InstallPlugin } from '../ui-notify-COUzXEQ4.js';
+import { H as HttpClient } from '../messages-7b0P8W75.js';
+import { S as SuperAdminGuardOptions, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, A as ActionsMap, c as SuperAdminLoginAdapter, U as UiNotify, I as InstallPlugin, d as SuperAdminI18nOptions, e as SuperAdminI18n } from '../use-super-admin-i18n-B3v3-SWZ.js';
 import '@saasicat/types';
 
 interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {
@@ -59,11 +59,20 @@ interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {
      * including for the setup wizard. Consumed via `useSuperAdminHttp()`.
      */
     http?: HttpClient;
+    /**
+     * Optional: UI locale + string overrides. Default is German. The created
+     * context is returned on the handle (`handle.i18n`) — set
+     * `handle.i18n.locale.value = 'en'` (or pass a `Ref` here) to switch at
+     * runtime. Consumed via `useSuperAdminI18n()` / `useSaMessages()`.
+     */
+    i18n?: SuperAdminI18nOptions;
 }
 interface SuperAdminAppHandle {
     app: App;
     router: Router;
     pinia: Pinia;
+    /** i18n context of the shell — switch locale via `i18n.locale.value`. */
+    i18n: SuperAdminI18n;
     /** Mounts the app on a selector. Returns the root component instance. */
     mount: (selector: string | Element) => ReturnType<App['mount']>;
 }

package/dist/quasar/index.js

@@ -4,14 +4,16 @@ import {
   SUPER_ADMIN_ENDPOINTS_KEY,
   SUPER_ADMIN_EXTENSIONS_KEY,
   SUPER_ADMIN_HTTP_KEY,
+  SUPER_ADMIN_I18N_KEY,
   SUPER_ADMIN_LOGIN_ADAPTER_KEY,
   SUPER_ADMIN_MANIFEST_KEY,
   SUPER_ADMIN_NOTIFY_KEY,
-  buildNavigationGuard
-} from "../chunk-3YP2ZAOD.js";
+  buildNavigationGuard,
+  createSuperAdminI18n
+} from "../chunk-QZOSDCNP.js";
 import {
   defaultHttpClient
-} from "../chunk-LVGUSD3T.js";
+} from "../chunk-X5SQ5HMB.js";
 
 // src/quasar/create-super-admin-app.ts
 import { createApp } from "vue";
@@ -62,7 +64,9 @@ function createSuperAdminApp(options) {
     publicBootEndpoint: options.endpoints.publicBootEndpoint ?? `${options.endpoints.apiBase}/boot`,
     manifestEndpoint: options.endpoints.manifestEndpoint ?? `${options.endpoints.apiBase}/manifest`
   };
+  const i18n = createSuperAdminI18n(options.i18n);
   app.provide(SUPER_ADMIN_BRAND_KEY, { tag: "SuperAdmin", ...options.brand });
+  app.provide(SUPER_ADMIN_I18N_KEY, i18n);
   app.provide(SUPER_ADMIN_ENDPOINTS_KEY, endpoints);
   app.provide(SUPER_ADMIN_EXTENSIONS_KEY, options.extensions ?? {});
   app.provide(SUPER_ADMIN_ACTIONS_KEY, options.actions ?? {});
@@ -81,6 +85,7 @@ function createSuperAdminApp(options) {
     app,
     router,
     pinia,
+    i18n,
     mount: (selector) => app.mount(selector)
   };
 }

package/dist/testing-e2e/admin-pages-suite.cjs

@@ -60,7 +60,7 @@ function runAdminPagesSuite(test, expect, config) {
   const dashboardPath = config.dashboardPath ?? "/admin/";
   test.describe(`${config.appName}: SuperAdmin-Pages Smoke`, () => {
     for (const pageDef of config.pages) {
-      test(`${pageDef.name} rendert ohne Fehler`, async ({ page }) => {
+      test(`${pageDef.name} renders without errors`, async ({ page }) => {
         const errors = attachListeners(
           page,
           config.consoleErrorAllowlist,
@@ -78,18 +78,18 @@ function runAdminPagesSuite(test, expect, config) {
             timeout: 5e3
           });
         }
-        expect(errors.pageErrors, `pageerror-Events auf ${pageDef.path}`).toHaveLength(0);
+        expect(errors.pageErrors, `pageerror events on ${pageDef.path}`).toHaveLength(0);
         expect(
           errors.consoleErrors,
-          `console.error-Events auf ${pageDef.path}`
+          `console.error events on ${pageDef.path}`
         ).toHaveLength(0);
         expect(
           errors.networkErrors,
-          `HTTP-Errors auf /api/ w\xE4hrend ${pageDef.path}`
+          `HTTP errors on /api/ during ${pageDef.path}`
         ).toHaveLength(0);
       });
     }
-    test("Dashboard zeigt erwartete KPIs, Distributions und Shortcuts", async ({ page }) => {
+    test("Dashboard shows the expected KPIs, distributions and shortcuts", async ({ page }) => {
       attachListeners(page, config.consoleErrorAllowlist);
       await loginIfNeeded(page, config);
       const origin = new URL(config.loginUrl).origin;
@@ -100,7 +100,9 @@ function runAdminPagesSuite(test, expect, config) {
       const kpiLabels = await page.locator(".sa-kpi__label").allTextContents();
       const normalizedKpis = kpiLabels.map((s) => s.trim());
       for (const expected of config.expectedKpiLabels) {
-        expect(normalizedKpis, `KPI '${expected}' fehlt auf Dashboard`).toContain(expected);
+        expect(normalizedKpis, `KPI '${expected}' missing on the dashboard`).toContain(
+          expected
+        );
       }
       if (config.expectedDistributionTitles?.length) {
         const distTitles = await page.locator(".sa-dashboard__row-head h2").allTextContents();
@@ -108,21 +110,22 @@ function runAdminPagesSuite(test, expect, config) {
         for (const expected of config.expectedDistributionTitles) {
           expect(
             normalizedDist,
-            `Distribution '${expected}' fehlt auf Dashboard`
+            `Distribution '${expected}' missing on the dashboard`
           ).toContain(expected);
         }
       }
       const shortcutTitles = await page.locator(".sa-dashboard__shortcut-title").allTextContents();
       const normalizedShortcuts = shortcutTitles.map((s) => s.trim());
       for (const expected of config.expectedShortcutTitles) {
-        expect(normalizedShortcuts, `Shortcut '${expected}' fehlt auf Dashboard`).toContain(
-          expected
-        );
+        expect(
+          normalizedShortcuts,
+          `Shortcut '${expected}' missing on the dashboard`
+        ).toContain(expected);
       }
       for (const forbidden of config.forbiddenShortcutTitles ?? []) {
         expect(
           normalizedShortcuts,
-          `Shortcut '${forbidden}' darf nicht auf Dashboard sein`
+          `Shortcut '${forbidden}' must not be on the dashboard`
         ).not.toContain(forbidden);
       }
     });

package/dist/testing-e2e/admin-pages-suite.js

@@ -36,7 +36,7 @@ function runAdminPagesSuite(test, expect, config) {
   const dashboardPath = config.dashboardPath ?? "/admin/";
   test.describe(`${config.appName}: SuperAdmin-Pages Smoke`, () => {
     for (const pageDef of config.pages) {
-      test(`${pageDef.name} rendert ohne Fehler`, async ({ page }) => {
+      test(`${pageDef.name} renders without errors`, async ({ page }) => {
         const errors = attachListeners(
           page,
           config.consoleErrorAllowlist,
@@ -54,18 +54,18 @@ function runAdminPagesSuite(test, expect, config) {
             timeout: 5e3
           });
         }
-        expect(errors.pageErrors, `pageerror-Events auf ${pageDef.path}`).toHaveLength(0);
+        expect(errors.pageErrors, `pageerror events on ${pageDef.path}`).toHaveLength(0);
         expect(
           errors.consoleErrors,
-          `console.error-Events auf ${pageDef.path}`
+          `console.error events on ${pageDef.path}`
         ).toHaveLength(0);
         expect(
           errors.networkErrors,
-          `HTTP-Errors auf /api/ w\xE4hrend ${pageDef.path}`
+          `HTTP errors on /api/ during ${pageDef.path}`
         ).toHaveLength(0);
       });
     }
-    test("Dashboard zeigt erwartete KPIs, Distributions und Shortcuts", async ({ page }) => {
+    test("Dashboard shows the expected KPIs, distributions and shortcuts", async ({ page }) => {
       attachListeners(page, config.consoleErrorAllowlist);
       await loginIfNeeded(page, config);
       const origin = new URL(config.loginUrl).origin;
@@ -76,7 +76,9 @@ function runAdminPagesSuite(test, expect, config) {
       const kpiLabels = await page.locator(".sa-kpi__label").allTextContents();
       const normalizedKpis = kpiLabels.map((s) => s.trim());
       for (const expected of config.expectedKpiLabels) {
-        expect(normalizedKpis, `KPI '${expected}' fehlt auf Dashboard`).toContain(expected);
+        expect(normalizedKpis, `KPI '${expected}' missing on the dashboard`).toContain(
+          expected
+        );
       }
       if (config.expectedDistributionTitles?.length) {
         const distTitles = await page.locator(".sa-dashboard__row-head h2").allTextContents();
@@ -84,21 +86,22 @@ function runAdminPagesSuite(test, expect, config) {
         for (const expected of config.expectedDistributionTitles) {
           expect(
             normalizedDist,
-            `Distribution '${expected}' fehlt auf Dashboard`
+            `Distribution '${expected}' missing on the dashboard`
           ).toContain(expected);
         }
       }
       const shortcutTitles = await page.locator(".sa-dashboard__shortcut-title").allTextContents();
       const normalizedShortcuts = shortcutTitles.map((s) => s.trim());
       for (const expected of config.expectedShortcutTitles) {
-        expect(normalizedShortcuts, `Shortcut '${expected}' fehlt auf Dashboard`).toContain(
-          expected
-        );
+        expect(
+          normalizedShortcuts,
+          `Shortcut '${expected}' missing on the dashboard`
+        ).toContain(expected);
       }
       for (const forbidden of config.forbiddenShortcutTitles ?? []) {
         expect(
           normalizedShortcuts,
-          `Shortcut '${forbidden}' darf nicht auf Dashboard sein`
+          `Shortcut '${forbidden}' must not be on the dashboard`
         ).not.toContain(forbidden);
       }
     });

package/dist/{ui-notify-COUzXEQ4.d.ts → use-super-admin-i18n-B3v3-SWZ.d.ts}

@@ -1,7 +1,7 @@
-import { Component, App, InjectionKey } from 'vue';
+import { Component, App, InjectionKey, Ref, ComputedRef } from 'vue';
 import { NavigationGuardWithThis } from 'vue-router';
 import { ActionKey, ComponentKey, AdminManifest } from '@saasicat/types';
-import { A as ActionHandler, H as HttpClient } from './action-registry-CQ2wL3R-.js';
+import { A as ActionHandler, H as HttpClient, S as SaLocale, a as SaMessages, b as SaMessagesOverrides } from './messages-7b0P8W75.js';
 
 /**
  * App-specific branding data that the platform `AdminLayout` and other
@@ -175,4 +175,36 @@ type UiNotify = (kind: UiNotifyKind, message: string, options?: UiNotifyOptions)
 /** Vue inject key for the notify port (see `Symbol.for` note in super-admin-context.ts). */
 declare const SUPER_ADMIN_NOTIFY_KEY: InjectionKey<UiNotify>;
 
-export { type ActionsMap as A, type ExtensionsMap as E, type InstallPlugin as I, type SuperAdminGuardOptions as S, type UiNotify as U, type SuperAdminBrand as a, type SuperAdminEndpoints as b, type SuperAdminLoginAdapter as c, type ExtensionLoader as d, SUPER_ADMIN_ACTIONS_KEY as e, SUPER_ADMIN_BRAND_KEY as f, SUPER_ADMIN_ENDPOINTS_KEY as g, SUPER_ADMIN_EXTENSIONS_KEY as h, SUPER_ADMIN_HTTP_KEY as i, SUPER_ADMIN_LOGIN_ADAPTER_KEY as j, SUPER_ADMIN_MANIFEST_KEY as k, SUPER_ADMIN_NOTIFY_KEY as l, type SuperAdminAuthGuardOptions as m, type SuperAdminLoginResult as n, type SuperAdminManifestGuardOptions as o, type UiNotifyKind as p, type UiNotifyOptions as q, buildNavigationGuard as r };
+interface SuperAdminI18n {
+    /** Active UI locale — mutable; switching re-renders all catalog texts. */
+    locale: Ref<SaLocale>;
+    /** Resolved catalog for the active locale (platform + app overrides). */
+    messages: ComputedRef<SaMessages>;
+    /** BCP-47 tag for `Intl`/`toLocaleString` formatting in the active locale. */
+    intlLocale: ComputedRef<string>;
+}
+interface SuperAdminI18nOptions {
+    /**
+     * Initial UI locale, default `'de'`. Pass a `Ref` when the app wants to
+     * keep control (e.g. a user-profile setting or a header switcher).
+     */
+    locale?: SaLocale | Ref<SaLocale>;
+    /** Per-locale string overrides layered over the platform catalog. */
+    overrides?: Partial<Record<SaLocale, SaMessagesOverrides>>;
+}
+declare const SUPER_ADMIN_I18N_KEY: InjectionKey<SuperAdminI18n>;
+declare function createSuperAdminI18n(options?: SuperAdminI18nOptions): SuperAdminI18n;
+/**
+ * Returns the i18n context provided by `createSuperAdminApp()`. Outside a
+ * shell (isolated mounts, tests) a shared German default instance is returned
+ * so callers never have to guard for a missing context.
+ */
+declare function useSuperAdminI18n(): SuperAdminI18n;
+/**
+ * Focused accessor for one catalog namespace:
+ * `const msg = useSaMessages('plans')` → `msg.value.title` /
+ * template `msg.title`.
+ */
+declare function useSaMessages<K extends keyof SaMessages>(namespace: K): ComputedRef<SaMessages[K]>;
+
+export { type ActionsMap as A, type ExtensionsMap as E, type InstallPlugin as I, type SuperAdminGuardOptions as S, type UiNotify as U, type SuperAdminBrand as a, type SuperAdminEndpoints as b, type SuperAdminLoginAdapter as c, type SuperAdminI18nOptions as d, type SuperAdminI18n as e, type ExtensionLoader as f, SUPER_ADMIN_ACTIONS_KEY as g, SUPER_ADMIN_BRAND_KEY as h, SUPER_ADMIN_ENDPOINTS_KEY as i, SUPER_ADMIN_EXTENSIONS_KEY as j, SUPER_ADMIN_HTTP_KEY as k, SUPER_ADMIN_I18N_KEY as l, SUPER_ADMIN_LOGIN_ADAPTER_KEY as m, SUPER_ADMIN_MANIFEST_KEY as n, SUPER_ADMIN_NOTIFY_KEY as o, type SuperAdminAuthGuardOptions as p, type SuperAdminLoginResult as q, type SuperAdminManifestGuardOptions as r, type UiNotifyKind as s, type UiNotifyOptions as t, buildNavigationGuard as u, createSuperAdminI18n as v, useSaMessages as w, useSuperAdminI18n as x };

package/dist/{ui-notify-D_eAAwRh.d.cts → use-super-admin-i18n-DMktRVEt.d.cts}

@@ -1,7 +1,7 @@
-import { Component, App, InjectionKey } from 'vue';
+import { Component, App, InjectionKey, Ref, ComputedRef } from 'vue';
 import { NavigationGuardWithThis } from 'vue-router';
 import { ActionKey, ComponentKey, AdminManifest } from '@saasicat/types';
-import { A as ActionHandler, H as HttpClient } from './action-registry-CQ2wL3R-.cjs';
+import { A as ActionHandler, H as HttpClient, S as SaLocale, a as SaMessages, b as SaMessagesOverrides } from './messages-7b0P8W75.cjs';
 
 /**
  * App-specific branding data that the platform `AdminLayout` and other
@@ -175,4 +175,36 @@ type UiNotify = (kind: UiNotifyKind, message: string, options?: UiNotifyOptions)
 /** Vue inject key for the notify port (see `Symbol.for` note in super-admin-context.ts). */
 declare const SUPER_ADMIN_NOTIFY_KEY: InjectionKey<UiNotify>;
 
-export { type ActionsMap as A, type ExtensionsMap as E, type InstallPlugin as I, type SuperAdminGuardOptions as S, type UiNotify as U, type SuperAdminBrand as a, type SuperAdminEndpoints as b, type SuperAdminLoginAdapter as c, type ExtensionLoader as d, SUPER_ADMIN_ACTIONS_KEY as e, SUPER_ADMIN_BRAND_KEY as f, SUPER_ADMIN_ENDPOINTS_KEY as g, SUPER_ADMIN_EXTENSIONS_KEY as h, SUPER_ADMIN_HTTP_KEY as i, SUPER_ADMIN_LOGIN_ADAPTER_KEY as j, SUPER_ADMIN_MANIFEST_KEY as k, SUPER_ADMIN_NOTIFY_KEY as l, type SuperAdminAuthGuardOptions as m, type SuperAdminLoginResult as n, type SuperAdminManifestGuardOptions as o, type UiNotifyKind as p, type UiNotifyOptions as q, buildNavigationGuard as r };
+interface SuperAdminI18n {
+    /** Active UI locale — mutable; switching re-renders all catalog texts. */
+    locale: Ref<SaLocale>;
+    /** Resolved catalog for the active locale (platform + app overrides). */
+    messages: ComputedRef<SaMessages>;
+    /** BCP-47 tag for `Intl`/`toLocaleString` formatting in the active locale. */
+    intlLocale: ComputedRef<string>;
+}
+interface SuperAdminI18nOptions {
+    /**
+     * Initial UI locale, default `'de'`. Pass a `Ref` when the app wants to
+     * keep control (e.g. a user-profile setting or a header switcher).
+     */
+    locale?: SaLocale | Ref<SaLocale>;
+    /** Per-locale string overrides layered over the platform catalog. */
+    overrides?: Partial<Record<SaLocale, SaMessagesOverrides>>;
+}
+declare const SUPER_ADMIN_I18N_KEY: InjectionKey<SuperAdminI18n>;
+declare function createSuperAdminI18n(options?: SuperAdminI18nOptions): SuperAdminI18n;
+/**
+ * Returns the i18n context provided by `createSuperAdminApp()`. Outside a
+ * shell (isolated mounts, tests) a shared German default instance is returned
+ * so callers never have to guard for a missing context.
+ */
+declare function useSuperAdminI18n(): SuperAdminI18n;
+/**
+ * Focused accessor for one catalog namespace:
+ * `const msg = useSaMessages('plans')` → `msg.value.title` /
+ * template `msg.title`.
+ */
+declare function useSaMessages<K extends keyof SaMessages>(namespace: K): ComputedRef<SaMessages[K]>;
+
+export { type ActionsMap as A, type ExtensionsMap as E, type InstallPlugin as I, type SuperAdminGuardOptions as S, type UiNotify as U, type SuperAdminBrand as a, type SuperAdminEndpoints as b, type SuperAdminLoginAdapter as c, type SuperAdminI18nOptions as d, type SuperAdminI18n as e, type ExtensionLoader as f, SUPER_ADMIN_ACTIONS_KEY as g, SUPER_ADMIN_BRAND_KEY as h, SUPER_ADMIN_ENDPOINTS_KEY as i, SUPER_ADMIN_EXTENSIONS_KEY as j, SUPER_ADMIN_HTTP_KEY as k, SUPER_ADMIN_I18N_KEY as l, SUPER_ADMIN_LOGIN_ADAPTER_KEY as m, SUPER_ADMIN_MANIFEST_KEY as n, SUPER_ADMIN_NOTIFY_KEY as o, type SuperAdminAuthGuardOptions as p, type SuperAdminLoginResult as q, type SuperAdminManifestGuardOptions as r, type UiNotifyKind as s, type UiNotifyOptions as t, buildNavigationGuard as u, createSuperAdminI18n as v, useSaMessages as w, useSuperAdminI18n as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/ui-vue",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Vue 3 components + composables for the SuperAdmin UI shell. Provides boot loader, manifest loader (ETag cache), nav builder, action registry and standard pages.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -53,7 +53,7 @@
     "src"
   ],
   "dependencies": {
-    "@saasicat/types": "^0.5.0"
+    "@saasicat/types": "^0.7.0"
   },
   "peerDependencies": {
     "pinia": "^2.0.0 || ^3.0.0",

package/src/client/action-registry.ts

@@ -27,8 +27,8 @@ export interface ResolvedAction<TInput = unknown, TResult = unknown> {
 export class MissingHandlerError extends Error {
     constructor(actionKey: string) {
         super(
-            `Kein Handler für actionKey "${actionKey}" registriert. ` +
-                `Konsument-Shell muss \`actions["${actionKey}"]\` bereitstellen.`,
+            `No handler registered for actionKey "${actionKey}". ` +
+                `The consumer shell must provide \`actions["${actionKey}"]\`.`,
         );
         this.name = 'MissingHandlerError';
     }
@@ -37,8 +37,8 @@ export class MissingHandlerError extends Error {
 export class ActionDefNotInManifestError extends Error {
     constructor(actionKey: string) {
         super(
-            `actionKey "${actionKey}" ist im Manifest nicht deklariert. ` +
-                `Bitte als TenantAction in einer ManifestContribution registrieren.`,
+            `actionKey "${actionKey}" is not declared in the manifest. ` +
+                `Register it as a TenantAction in a ManifestContribution.`,
         );
         this.name = 'ActionDefNotInManifestError';
     }

package/src/client/batch-column-fetcher.ts

@@ -128,14 +128,14 @@ export class BatchColumnFetcher {
 
     private validateBatchEndpoint(col: TenantColumnDef): void {
         if (!col.endpoint || col.endpoint.trim().length === 0) {
-            throw new BatchColumnDriftError(col, 'endpoint ist leer');
+            throw new BatchColumnDriftError(col, 'endpoint is empty');
         }
         if (col.endpoint.includes('{slug}') || col.endpoint.includes('{tenantId}')) {
             throw new BatchColumnDriftError(
                 col,
-                'endpoint enthält per-Tenant-Placeholder ({slug}/{tenantId}). ' +
-                    'Spalten-Endpoints müssen batchfähig sein — bitte Backend ' +
-                    'auf `?tenantIds=...`-Parameter umstellen.',
+                'endpoint contains per-tenant placeholders ({slug}/{tenantId}). ' +
+                    'Column endpoints must be batchable — switch the backend ' +
+                    'to a `?tenantIds=...` parameter.',
             );
         }
     }

package/src/client/boot-loader.ts

@@ -41,9 +41,9 @@ export class BootLoader {
     constructor(options: BootLoaderOptions) {
         if (!options?.endpoint) {
             throw new Error(
-                'BootLoader: `endpoint` ist Pflicht (z. B. "/api/admin/boot" ' +
-                    'oder "/api/v1/admin/boot"). Plattform hat keinen Default, ' +
-                    'weil Apps unterschiedliche globalPrefix-Konventionen haben.',
+                'BootLoader: `endpoint` is required (e.g. "/api/admin/boot" ' +
+                    'or "/api/v1/admin/boot"). The platform has no default ' +
+                    'because apps use different globalPrefix conventions.',
             );
         }
         this.endpoint = options.endpoint;

package/src/client/i18n/currency.ts

@@ -0,0 +1,42 @@
+// Currency formatting for the admin UI. Amounts are net euro values; the
+// grouping and decimal separator follow the active UI locale
+// (de → `12.345,60 €`, en → `€12,345.60`).
+
+import { DEFAULT_SA_LOCALE, SA_INTL_LOCALES, type SaLocale } from './locale.js';
+
+const DEFAULT_CURRENCY = 'EUR';
+
+const formatters = new Map<string, Intl.NumberFormat>();
+
+function formatterFor(locale: SaLocale, currency: string, decimals: number): Intl.NumberFormat {
+    const key = `${locale}:${currency}:${decimals}`;
+    let formatter = formatters.get(key);
+    if (!formatter) {
+        formatter = new Intl.NumberFormat(SA_INTL_LOCALES[locale], {
+            style: 'currency',
+            currency,
+            minimumFractionDigits: decimals,
+            maximumFractionDigits: decimals,
+        });
+        formatters.set(key, formatter);
+    }
+    return formatter;
+}
+
+/**
+ * Formats a net amount for display. Whole amounts drop the decimals (`29 €`
+ * rather than `29,00 €`) — the plan and bundle prices the admin UI shows are
+ * mostly round numbers, and the zeros are noise in dense tables.
+ *
+ * Returns an em dash for null/undefined and for values that are not finite
+ * numbers, so callers can pass raw API fields straight through.
+ */
+export function formatCurrency(
+    amount: number | string | null | undefined,
+    locale: SaLocale = DEFAULT_SA_LOCALE,
+    currency: string = DEFAULT_CURRENCY,
+): string {
+    const value = typeof amount === 'string' ? Number(amount) : amount;
+    if (value === null || value === undefined || !Number.isFinite(value)) return '—';
+    return formatterFor(locale, currency, Number.isInteger(value) ? 0 : 2).format(value);
+}

package/src/client/i18n/define.ts

@@ -0,0 +1,59 @@
+// Typed message-catalog helpers. Every namespace is defined once in German —
+// the reference locale that fixes the key structure — and the English variant
+// must mirror that structure exactly, enforced at compile time via
+// `TranslationOf`.
+
+import type { SaLocale } from './locale.js';
+
+/** Nested string map — the shape of every message namespace. */
+export interface MessageTree {
+    readonly [key: string]: string | MessageTree;
+}
+
+/** Maps a reference namespace to "same keys, any string values". */
+export type TranslationOf<T> = {
+    readonly [K in keyof T]: T[K] extends string ? string : TranslationOf<T[K]>;
+};
+
+/** Deep partial of a namespace — the shape consumers pass as overrides. */
+export type PartialMessages<T> = {
+    readonly [K in keyof T]?: T[K] extends string ? string : PartialMessages<T[K]>;
+};
+
+/**
+ * Couples the German reference catalog with its English translation. Missing
+ * or extra keys in the English object are compile errors.
+ */
+export function defineMessages<T extends MessageTree>(
+    de: T,
+    en: TranslationOf<T>,
+): Record<SaLocale, T> {
+    // `TranslationOf<T>` and `T` are structurally identical for string-valued
+    // trees; the cast only erases the mapped-type wrapper.
+    return { de, en: en as T };
+}
+
+/**
+ * Recursively overlays `overrides` onto `base` without mutating either side.
+ * Only string leaves are replaced; keys not present in `base` are ignored —
+ * the catalog structure is fixed by the platform.
+ */
+export function mergeMessages<T extends MessageTree>(
+    base: T,
+    overrides: PartialMessages<T> | undefined,
+): T {
+    if (!overrides) return base;
+    const result: Record<string, string | MessageTree> = {};
+    for (const [key, baseValue] of Object.entries(base)) {
+        const override = (overrides as Record<string, unknown>)[key];
+        if (typeof baseValue === 'string') {
+            result[key] = typeof override === 'string' ? override : baseValue;
+        } else {
+            result[key] = mergeMessages(
+                baseValue,
+                override as PartialMessages<MessageTree> | undefined,
+            );
+        }
+    }
+    return result as T;
+}

package/src/client/i18n/format.ts

@@ -0,0 +1,12 @@
+// Placeholder interpolation for catalog messages: `{name}` is replaced with
+// `params.name`. Unknown placeholders stay verbatim so a missing param is
+// visible in the UI instead of silently disappearing.
+
+export type MessageParams = Record<string, string | number>;
+
+export function formatMessage(template: string, params: MessageParams): string {
+    return template.replace(/\{(\w+)\}/g, (match, name: string) => {
+        const value = params[name];
+        return value === undefined ? match : String(value);
+    });
+}

package/src/client/i18n/index.ts

@@ -0,0 +1,14 @@
+// Framework-free i18n core: locale registry, typed catalogs, interpolation.
+// The reactive Vue binding lives in `src/vue/use-super-admin-i18n.ts`.
+
+export * from './locale.js';
+export {
+    defineMessages,
+    mergeMessages,
+    type MessageTree,
+    type PartialMessages,
+    type TranslationOf,
+} from './define.js';
+export * from './format.js';
+export * from './currency.js';
+export * from './messages.js';

package/src/client/i18n/locale.ts

@@ -0,0 +1,15 @@
+// Supported display locales of the SuperAdmin UI. The platform ships a German
+// (reference) and an English catalog; consumers pick the locale per app or per
+// user via `createSuperAdminApp({ i18n })`.
+
+export type SaLocale = 'de' | 'en';
+
+export const SA_LOCALES: readonly SaLocale[] = ['de', 'en'];
+
+export const DEFAULT_SA_LOCALE: SaLocale = 'de';
+
+/** BCP-47 tags used for `Intl`/`toLocaleString` formatting per UI locale. */
+export const SA_INTL_LOCALES: Record<SaLocale, string> = {
+    de: 'de-DE',
+    en: 'en-US',
+};

package/src/client/i18n/messages/audit.ts

@@ -0,0 +1,42 @@
+import { defineMessages } from '../define.js';
+
+export const auditMessages = defineMessages(
+    {
+        title: 'Audit-Trail',
+        subtitle: '{count} Einträge · plattformweit.',
+        filterButton: 'Filtern',
+        detailActorPrefix: 'Actor:',
+        filters: {
+            actor: 'Actor (E-Mail)',
+            action: 'Action',
+            entity: 'Entity',
+            since: 'Seit',
+        },
+        columns: {
+            time: 'Zeit',
+            actor: 'Actor',
+            action: 'Action',
+            entity: 'Entity',
+            id: 'ID',
+        },
+    },
+    {
+        title: 'Audit trail',
+        subtitle: '{count} entries · platform-wide.',
+        filterButton: 'Filter',
+        detailActorPrefix: 'Actor:',
+        filters: {
+            actor: 'Actor (email)',
+            action: 'Action',
+            entity: 'Entity',
+            since: 'Since',
+        },
+        columns: {
+            time: 'Time',
+            actor: 'Actor',
+            action: 'Action',
+            entity: 'Entity',
+            id: 'ID',
+        },
+    },
+);