@saasicat/ui-vue 0.5.0 → 0.7.0

package/src/pages-tenant/default-i18n.ts

@@ -1,6 +1,10 @@
 // Default i18n map for the tenant plan section. Consumers override individual
 // keys via the `i18n` prop or pass their own map through (build a vue-i18n
-// resolver on top of this shape).
+// resolver on top of this shape). The map that a component falls back to is
+// picked from the active SuperAdmin locale via
+// `defaultTenantPlanSectionI18n()`.
+
+import type { SaLocale } from '../client/i18n/locale.js';
 
 export interface TenantPlanSectionI18n {
     sectionTitle: string;
@@ -139,6 +143,29 @@ export interface TenantPlanSectionI18n {
     packageSnapshotNone: string;
     packageSnapshotShowRaw: string;
     packageSnapshotHideRaw: string;
+    /** Inline error prefix (`Fehler: …`). */
+    errorLabel: string;
+    /** Tenant self-service page "Meine Bundles" (MySubscriptionBundlesPage). */
+    myBundlesTitle: string;
+    myBundlesSubtitle: string;
+    myBundlesEmptyPrefix: string;
+    myBundlesEmptySuffix: string;
+    myBundlesBookedSince: string;
+    myBundlesCanceledAt: string;
+    myBundlesRunsUntil: string;
+    myBundlesCancelInProgress: string;
+    myBundlesBookInProgress: string;
+    myBundlesCancelConfirm: string;
+    myBundlesStatusCanceledPending: string;
+    myBundlesStatusEnded: string;
+    myBundlesAddBundleLabel: string;
+    myBundlesAddSelectPlaceholder: string;
+    myBundlesPricePerMonthShort: string;
+    myBundlesHiddenIncompatible: string;
+    myBundlesBundleVersionIdLabel: string;
+    myBundlesBundleVersionIdPlaceholder: string;
+    myBundlesMinimumTermLabel: string;
+    myBundlesMinimumTermPlaceholder: string;
 }
 
 /** German default strings — apps can override them selectively. */
@@ -277,4 +304,193 @@ export const DEFAULT_I18N_DE: TenantPlanSectionI18n = {
     packageSnapshotNone: 'Diese Subscription wurde nicht über ein Webseiten-Angebot abgeschlossen.',
     packageSnapshotShowRaw: 'Rohdaten anzeigen',
     packageSnapshotHideRaw: 'Rohdaten ausblenden',
+    errorLabel: 'Fehler',
+    myBundlesTitle: 'Meine Bundles',
+    myBundlesSubtitle:
+        'Eigenständig gebuchte Add-On-Pakete zu deinem Plan. Mindestlaufzeit + Kündigungs- Termin pro Bundle.',
+    myBundlesEmptyPrefix: 'Du hast noch kein Bundle gebucht. Über',
+    myBundlesEmptySuffix: 'kannst du dein Paket um zusätzliche Features & Quotas erweitern.',
+    myBundlesBookedSince: 'Gebucht seit',
+    myBundlesCanceledAt: 'Gekündigt am',
+    myBundlesRunsUntil: 'läuft bis',
+    myBundlesCancelInProgress: 'Kündige …',
+    myBundlesBookInProgress: 'Buche …',
+    myBundlesCancelConfirm:
+        'Bundle wirklich kündigen? Die Kündigung wird zum nächstmöglichen Termin wirksam.',
+    myBundlesStatusCanceledPending: 'Kündigung wirksam ab …',
+    myBundlesStatusEnded: 'Beendet',
+    myBundlesAddBundleLabel: 'Bundle',
+    myBundlesAddSelectPlaceholder: '— bitte wählen —',
+    myBundlesPricePerMonthShort: '€ / Mo',
+    myBundlesHiddenIncompatible: 'weitere Bundle(s) ausgeblendet — nicht kompatibel mit Plan',
+    myBundlesBundleVersionIdLabel: 'BundleVersion-ID',
+    myBundlesBundleVersionIdPlaceholder: 'UUID der gewünschten Bundle-Version',
+    myBundlesMinimumTermLabel: 'Mindestlaufzeit (Monate, optional)',
+    myBundlesMinimumTermPlaceholder: 'Default: 12',
 };
+
+/** English default strings — mirror of {@link DEFAULT_I18N_DE}. */
+export const DEFAULT_I18N_EN: TenantPlanSectionI18n = {
+    sectionTitle: 'Plan & usage',
+    sectionSubtitle: 'Current plan, usage and bundles.',
+    loading: 'Loading …',
+    noSubscription: 'No subscription found for this tenant.',
+    activePlan: 'Current plan',
+    cycleMonthly: 'Monthly',
+    cycleYearly: 'Yearly',
+    statusActive: 'Active',
+    statusTrial: 'Trial',
+    statusPastDue: 'Payment overdue',
+    statusCanceled: 'Canceled',
+    statusPendingSales: 'Sales review',
+    trialEndsAt: 'Trial ends on',
+    pilotEndsAt: 'Pilot ends on',
+    nextBillingDate: 'Next billing date',
+    pendingChange: 'Pending plan change',
+    changeFromTo: 'Change to',
+    changeEffectiveAt: 'effective as of',
+    changePlanButton: 'Change plan',
+    cancelSubscriptionButton: 'Cancel subscription',
+    usageTitle: 'Usage',
+    featuresOverviewTitle: 'Features',
+    featuresActive: 'Included',
+    featuresLocked: 'Not included',
+    bundlesStoreTitle: 'Bundles',
+    bundlesBookedTitle: 'Booked bundles',
+    bundlesAvailableTitle: 'Available bundles',
+    bundlesAvailableEmpty: 'There are currently no additional bundles available.',
+    bundlesPerMonth: 'net/month',
+    bundleBookAction: 'Book bundle',
+    bundleBookInProgress: 'Booking …',
+    bundleCancelAction: 'Cancel',
+    bundleReactivateAction: 'Reactivate',
+    bundleReactivateConfirmTitle: 'Reactivate bundle',
+    bundleReactivateConfirmBody:
+        'The cancellation will be reverted. The bundle stays booked, continues to run normally and will be billed again.',
+    bundleCanceledAt: 'Canceled effective',
+    bundleMinimumTermUntil: 'Minimum term until',
+    bundleIncludesLabel: 'Includes',
+    bundleAlreadyBooked: 'Already booked',
+    bundleIncompatible: 'Not compatible with the current plan',
+    bundleMissingRequires: 'Requires',
+    bundlePreviewAddTitle: 'Book bundle',
+    bundlePreviewCancelTitle: 'Cancel bundle',
+    bundlePreviewLoading: 'Calculating preview …',
+    bundlePreviewProrationTitle: 'Prorated billing',
+    bundlePreviewProratedNow: 'Prorated amount due today',
+    bundlePreviewProrationDays: 'days',
+    bundlePreviewNextPeriod: 'Regular price from the next period',
+    bundlePreviewTrialNote:
+        'Nothing is charged during the trial — billing starts with the first paid period.',
+    bundlePreviewNoPrice: 'No list price is configured for the current billing cycle.',
+    bundlePreviewMinimumTermLabel: 'Minimum term',
+    bundlePreviewMinimumTermMonths: 'months, until',
+    bundlePreviewMinimumTermNone: 'No minimum term',
+    bundlePreviewRedundantTitle: 'Features already included (would be paid for twice)',
+    bundlePreviewRedundantCoveredByPlan: 'already in the plan',
+    bundlePreviewRedundantCoveredByBundle: 'already in bundle',
+    bundlePreviewMissingRequiresTitle: 'Missing prerequisites',
+    bundlePreviewBlockersTitle: 'Booking not possible',
+    bundlePreviewWarningsTitle: 'Notes',
+    bundlePreviewEffectiveAt: 'Cancellation effective as of',
+    bundlePreviewSavings: 'Savings per period once effective',
+    bundlePreviewConfirmAdd: 'Book (chargeable)',
+    bundlePreviewConfirmCancel: 'Confirm cancellation',
+    bundlePreviewInProgress: 'Processing …',
+    bundlePreviewClose: 'Cancel',
+    pendingVersionTitle: 'Upcoming plan change',
+    pendingVersionChipNonRegressive: 'Improvement',
+    pendingVersionChipRegressive: 'Confirmation required',
+    pendingVersionEffectiveAt: 'Effective as of',
+    pendingVersionAcceptAction: 'Accept changes',
+    pendingVersionAcceptInProgress: 'Accepting …',
+    pendingVersionAcceptedAt: 'Accepted on',
+    wizardTitle: 'Change plan',
+    wizardClose: 'Close',
+    wizardCurrent: 'Current',
+    wizardBadgeCurrent: 'active',
+    wizardBadgePopular: 'popular',
+    wizardPriceUnitMonthly: 'net/month',
+    wizardPriceUnitYearly: 'net/year',
+    wizardPriceOnRequest: 'on request',
+    wizardStepChoose: 'Choose plan',
+    wizardStepChooseIntro:
+        'Choose your target plan and the billing cycle. In the next step we show the usage check and the feature diff.',
+    wizardStepPreview: 'Preview',
+    wizardStepConfirm: 'Confirm',
+    wizardNext: 'Next',
+    wizardBack: 'Back',
+    wizardPreviewLoading: 'Calculating preview …',
+    wizardEffectiveAtLabel: 'Effective as of',
+    wizardEffectiveImmediate: 'Effective immediately',
+    wizardProrationTitle: 'Prorated billing',
+    wizardProrationLine: 'Additional amount until the end of the period:',
+    wizardProrationDays: 'days',
+    wizardLimitsTitle: 'Limit comparison',
+    wizardLimitsUsed: 'Usage',
+    wizardLimitsCurrent: 'Current',
+    wizardLimitsTarget: 'Target',
+    wizardFeaturesGained: 'Newly unlocked',
+    wizardFeaturesLost: 'Features you lose',
+    wizardBlockersTitle: 'Blockers',
+    wizardConfirmImmediate: 'The change takes effect immediately.',
+    wizardConfirmScheduled: 'The change takes effect on',
+    wizardConfirmAction: 'Confirm change',
+    wizardConfirmInProgress: 'Changing …',
+    wizardConfirmPriceTitle: 'Price overview',
+    wizardConfirmProratedNow: 'Prorated amount due today',
+    wizardConfirmRecurringNext: 'Regular price from the next period',
+    wizardConfirmRecurringFrom: 'Regular price due from',
+    wizardConfirmPerCycleMonthly: 'per month',
+    wizardConfirmPerCycleYearly: 'per year',
+    wizardConfirmTrialNote: 'Nothing is charged during the trial.',
+    wizardConfirmRecurringTrialEnd: 'Regular price from the end of the trial',
+    wizardChangeTypeUpgrade: 'Upgrade',
+    wizardChangeTypeDowngrade: 'Downgrade',
+    wizardChangeTypeCycle: 'Cycle change',
+    wizardChangeTypeNoop: 'No change',
+    packageSnapshotTitle: 'Booked plan (snapshot)',
+    packageSnapshotSubtitle:
+        'Read-only copy of the plan as it was marketed at the time of purchase.',
+    packageSnapshotCapturedAt: 'Captured on',
+    packageSnapshotOfferRef: 'Offer reference',
+    packageSnapshotPlanLabel: 'Plan',
+    packageSnapshotPlanVersionLabel: 'Plan version',
+    packageSnapshotCycleLabel: 'Billing cycle',
+    packageSnapshotBundlesLabel: 'Included bundles',
+    packageSnapshotBundlesEmpty: 'No bundles in the plan.',
+    packageSnapshotPriceMonthly: 'Monthly price',
+    packageSnapshotPriceYearly: 'Yearly price',
+    packageSnapshotPriceTotal: 'Total price',
+    packageSnapshotNone: 'This subscription was not created through a website offer.',
+    packageSnapshotShowRaw: 'Show raw data',
+    packageSnapshotHideRaw: 'Hide raw data',
+    errorLabel: 'Error',
+    myBundlesTitle: 'My bundles',
+    myBundlesSubtitle:
+        'Add-on packages booked independently on top of your plan. Minimum term + cancellation date per bundle.',
+    myBundlesEmptyPrefix: 'You have not booked a bundle yet. Use',
+    myBundlesEmptySuffix: 'to extend your plan with additional features & quotas.',
+    myBundlesBookedSince: 'Booked since',
+    myBundlesCanceledAt: 'Canceled on',
+    myBundlesRunsUntil: 'runs until',
+    myBundlesCancelInProgress: 'Canceling …',
+    myBundlesBookInProgress: 'Booking …',
+    myBundlesCancelConfirm:
+        'Really cancel this bundle? The cancellation takes effect on the next possible date.',
+    myBundlesStatusCanceledPending: 'Cancellation effective as of …',
+    myBundlesStatusEnded: 'Ended',
+    myBundlesAddBundleLabel: 'Bundle',
+    myBundlesAddSelectPlaceholder: '— please select —',
+    myBundlesPricePerMonthShort: '€ / mo',
+    myBundlesHiddenIncompatible: 'more bundle(s) hidden — not compatible with plan',
+    myBundlesBundleVersionIdLabel: 'BundleVersion ID',
+    myBundlesBundleVersionIdPlaceholder: 'UUID of the desired bundle version',
+    myBundlesMinimumTermLabel: 'Minimum term (months, optional)',
+    myBundlesMinimumTermPlaceholder: 'Default: 12',
+};
+
+/** Default map for the given UI locale — fallback layer under the `i18n` prop. */
+export function defaultTenantPlanSectionI18n(locale: SaLocale): TenantPlanSectionI18n {
+    return locale === 'en' ? DEFAULT_I18N_EN : DEFAULT_I18N_DE;
+}

package/src/pages-tenant/tenant-plan-section/BundlePreviewDialog.vue

@@ -23,7 +23,10 @@
 
             <template v-else-if="preview">
                 <!-- Blocker: booking/cancellation not possible -->
-                <q-card-section v-if="preview.blockers.length > 0" class="sp-bundle-preview__blockers">
+                <q-card-section
+                    v-if="preview.blockers.length > 0"
+                    class="sp-bundle-preview__blockers"
+                >
                     <div class="sp-bundle-preview__block-title">
                         {{ i18n.bundlePreviewBlockersTitle }}
                     </div>
@@ -77,7 +80,9 @@
                     </div>
                     <div class="sp-bundle-preview__price-row">
                         <span>{{ i18n.bundlePreviewMinimumTermLabel }}</span>
-                        <span v-if="addPreview.minimumTermMonths > 0 && addPreview.minimumTermEndsAt">
+                        <span
+                            v-if="addPreview.minimumTermMonths > 0 && addPreview.minimumTermEndsAt"
+                        >
                             {{ addPreview.minimumTermMonths }}
                             {{ i18n.bundlePreviewMinimumTermMonths }}
                             {{ formatDate(addPreview.minimumTermEndsAt) }}
@@ -123,10 +128,7 @@
                 </q-card-section>
 
                 <!-- Warnings (e.g. MINIMUM_TERM_BINDS) -->
-                <q-card-section
-                    v-if="otherWarnings.length > 0"
-                    class="sp-bundle-preview__warnings"
-                >
+                <q-card-section v-if="otherWarnings.length > 0" class="sp-bundle-preview__warnings">
                     <div class="sp-bundle-preview__block-title">
                         {{ i18n.bundlePreviewWarningsTitle }}
                     </div>

package/src/pages-tenant/tenant-plan-section/TenantBundleStore.vue

@@ -9,18 +9,13 @@
                 <li v-for="row in bookedRows" :key="row.id" class="sp-plan-section__item">
                     <div>
                         <span class="sp-plan-section__item-label">{{ row.label }}</span>
-                        <span
-                            v-if="row.canceledAt"
-                            class="sp-plan-section__item-canceled"
-                        >
+                        <span v-if="row.canceledAt" class="sp-plan-section__item-canceled">
                             {{ i18n.bundleCanceledAt }}
                             {{ formatDate(row.canceledEffectiveAt ?? row.canceledAt) }}
                         </span>
-                        <span
-                            v-else-if="row.minimumTermEndsAt"
-                            class="sp-plan-section__item-price"
-                        >
-                            {{ i18n.bundleMinimumTermUntil }} {{ formatDate(row.minimumTermEndsAt) }}
+                        <span v-else-if="row.minimumTermEndsAt" class="sp-plan-section__item-price">
+                            {{ i18n.bundleMinimumTermUntil }}
+                            {{ formatDate(row.minimumTermEndsAt) }}
                         </span>
                     </div>
                     <div class="sp-bundle-store__booked-actions">
@@ -114,7 +109,11 @@
                         color="primary"
                         unelevated
                         class="sp-bundle-store__card-action"
-                        :label="buyingId === row.bundle.bundleVersionId ? i18n.bundleBookInProgress : i18n.bundleBookAction"
+                        :label="
+                            buyingId === row.bundle.bundleVersionId
+                                ? i18n.bundleBookInProgress
+                                : i18n.bundleBookAction
+                        "
                         :loading="buyingId === row.bundle.bundleVersionId"
                         :disable="buyingId !== null"
                         @click="emit('buy', row.bundle.bundleVersionId)"

package/src/pages-tenant/tenant-plan-section/TenantFeatureMatrix.vue

@@ -38,6 +38,7 @@
 <script setup lang="ts">
 import { computed } from 'vue';
 import type { FeatureUiRegistry } from '@saasicat/types';
+import { useSuperAdminI18n } from '../../vue/use-super-admin-i18n.js';
 import type { TenantPlanSectionI18n } from '../default-i18n.js';
 
 // TenantFeatureMatrix — complete feature-scope overview (#18):
@@ -54,6 +55,8 @@ const props = defineProps<{
     i18n: TenantPlanSectionI18n;
 }>();
 
+const { intlLocale } = useSuperAdminI18n();
+
 interface FeatureRow {
     key: string;
     active: boolean;
@@ -81,7 +84,7 @@ const features = computed<FeatureRow[]>(() => {
     // Included first, then alphabetically by label.
     return rows.sort((a, b) => {
         if (a.active !== b.active) return a.active ? -1 : 1;
-        return a.label.localeCompare(b.label, 'de');
+        return a.label.localeCompare(b.label, intlLocale.value);
     });
 });
 </script>

package/src/quasar/create-super-admin-app.ts

@@ -43,6 +43,12 @@ import {
     type SuperAdminLoginAdapter,
 } from '../vue/super-admin-context.js';
 import { SUPER_ADMIN_NOTIFY_KEY, type UiNotify } from '../vue/ui-notify.js';
+import {
+    SUPER_ADMIN_I18N_KEY,
+    createSuperAdminI18n,
+    type SuperAdminI18n,
+    type SuperAdminI18nOptions,
+} from '../vue/use-super-admin-i18n.js';
 import { quasarNotify } from './notify.js';
 
 export interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {
@@ -98,12 +104,21 @@ export 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;
 }
 
 export 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']>;
 }
@@ -147,7 +162,10 @@ export function createSuperAdminApp(options: CreateSuperAdminAppOptions): SuperA
             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 ?? {});
@@ -168,6 +186,7 @@ export function createSuperAdminApp(options: CreateSuperAdminAppOptions): SuperA
         app,
         router,
         pinia,
+        i18n,
         mount: (selector) => app.mount(selector),
     };
 }

package/src/testing-e2e/admin-pages-suite.ts

@@ -109,7 +109,7 @@ export function runAdminPagesSuite(
 
     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,
@@ -127,19 +127,19 @@ export function runAdminPagesSuite(
                         timeout: 5_000,
                     });
                 }
-                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ährend ${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;
@@ -151,7 +151,9 @@ export function runAdminPagesSuite(
             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) {
@@ -162,7 +164,7 @@ export function runAdminPagesSuite(
                 for (const expected of config.expectedDistributionTitles) {
                     expect(
                         normalizedDist,
-                        `Distribution '${expected}' fehlt auf Dashboard`,
+                        `Distribution '${expected}' missing on the dashboard`,
                     ).toContain(expected);
                 }
             }
@@ -172,14 +174,15 @@ export function runAdminPagesSuite(
                 .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/src/vue/project-page-host.ts

@@ -60,13 +60,15 @@ export const ProjectPageHost = defineComponent({
             const page = matchingPage.value;
             const cmp = resolvedComponent.value;
             if (page && cmp) return h(cmp);
+            // Misconfiguration diagnostics — developer-facing, therefore not
+            // part of the localized catalog.
             return h('div', { class: 'sa-project-page-host__missing', role: 'alert' }, [
-                h('h2', 'Seite nicht verfügbar'),
+                h('h2', 'Page not available'),
                 h(
                     'p',
                     page
-                        ? `componentKey "${page.componentKey}" ist nicht in der extensions:-Map registriert. Apps müssen die Komponente in createSuperAdminApp({ extensions }) eintragen.`
-                        : `Keine Manifest-Definition für ${route.path}. Entweder fehlt die ProjectPage im Manifest, oder die Capability ist nicht aktiv.`,
+                        ? `componentKey "${page.componentKey}" is not registered in the extensions: map. Apps must register the component in createSuperAdminApp({ extensions }).`
+                        : `No manifest definition for ${route.path}. Either the ProjectPage is missing from the manifest, or the capability is not active.`,
                 ),
             ]);
         };

package/src/vue/use-audit-entries.ts

@@ -29,9 +29,9 @@ export interface UseAuditEntriesResult extends UseApiListResult<AuditEntry> {
 export function useAuditEntries(options: UseAuditEntriesOptions): UseAuditEntriesResult {
     if (!options?.endpoint) {
         throw new Error(
-            'useAuditEntries: `endpoint` ist Pflicht (z. B. "/api/admin/audit" ' +
-                'oder "/api/v1/admin/audit"). Plattform hat keinen Default, weil ' +
-                'Apps unterschiedliche globalPrefix-Konventionen haben.',
+            'useAuditEntries: `endpoint` is required (e.g. "/api/admin/audit" ' +
+                'or "/api/v1/admin/audit"). The platform has no default because ' +
+                'apps use different globalPrefix conventions.',
         );
     }
     const filter = options.filter ?? ref<AuditQuery>({});

package/src/vue/use-bulk-publish.ts

@@ -12,6 +12,7 @@
 
 import { computed, ref, type ComputedRef, type Ref } from 'vue';
 import { defaultHttpClient, type HttpClient } from '../client/types.js';
+import { useSaMessages } from './use-super-admin-i18n.js';
 
 export type BulkItemKind = 'plan';
 
@@ -62,11 +63,12 @@ export interface UseBulkPublishResult {
 }
 
 export function useBulkPublish(options: UseBulkPublishOptions): UseBulkPublishResult {
+    const msg = useSaMessages('planVersions');
     if (!options?.endpoints) {
         throw new Error(
-            'useBulkPublish: `endpoints` ist Pflicht (Mapping plan → URL-Builder). ' +
-                'Plattform hat keinen Default, weil Apps unterschiedliche ' +
-                'globalPrefix-Konventionen haben.',
+            'useBulkPublish: `endpoints` is required (mapping plan → URL builder). ' +
+                'The platform has no default because apps use different ' +
+                'globalPrefix conventions.',
         );
     }
     const http = options.http ?? defaultHttpClient();
@@ -128,7 +130,7 @@ export function useBulkPublish(options: UseBulkPublishOptions): UseBulkPublishRe
             // Mark all items as failed with a clear reason.
             for (const item of items.value) {
                 item.status = 'failed';
-                item.error = 'changeNote ist Pflicht beim Publish.';
+                item.error = msg.value.bulkPublish.changeNoteRequired;
             }
             return;
         }

package/src/vue/use-bundle-versions-map.ts

@@ -36,10 +36,10 @@ export function useBundleVersionsMap(
     options: UseBundleVersionsMapOptions,
 ): UseBundleVersionsMapResult {
     if (!options?.adminEndpoint) {
-        throw new Error('useBundleVersionsMap: `adminEndpoint` ist Pflicht.');
+        throw new Error('useBundleVersionsMap: `adminEndpoint` is required.');
     }
     if (!options?.bundles) {
-        throw new Error('useBundleVersionsMap: `bundles` ist Pflicht.');
+        throw new Error('useBundleVersionsMap: `bundles` is required.');
     }
 
     const http = options.http ?? defaultHttpClient();
@@ -58,7 +58,9 @@ export function useBundleVersionsMap(
             headers: { 'content-type': 'application/json', ...authHeaders() },
         });
         if (res.status >= 400) {
-            throw new Error(`HTTP ${res.status} beim Laden der Versionen für Bundle '${bundleId}'`);
+            throw new Error(
+                `HTTP ${res.status} while loading the versions for bundle '${bundleId}'`,
+            );
         }
         return ((await res.json().catch(() => null)) as BundleVersionRow[] | null) ?? [];
     }
@@ -74,7 +76,7 @@ export function useBundleVersionsMap(
                         return [b.id, versions] as const;
                     } catch (err) {
                         console.warn(
-                            `useBundleVersionsMap: Bundle '${b.bundleKey}' Versions-Load failed`,
+                            `useBundleVersionsMap: loading versions for bundle '${b.bundleKey}' failed`,
                             err,
                         );
                         return [b.id, []] as const;

package/src/vue/use-bundles.ts

@@ -58,13 +58,13 @@ export interface UseBundlesResult {
 export function useBundles(options: UseBundlesOptions): UseBundlesResult {
     if (!options?.adminEndpoint) {
         throw new Error(
-            'useBundles: `adminEndpoint` ist Pflicht (z. B. "/api/admin" oder ' +
-                '"/api/v1/admin"). Plattform hat keinen Default, weil Apps ' +
-                'unterschiedliche globalPrefix-Konventionen haben.',
+            'useBundles: `adminEndpoint` is required (e.g. "/api/admin" or ' +
+                '"/api/v1/admin"). The platform has no default, because apps use ' +
+                'different globalPrefix conventions.',
         );
     }
     if (!options?.projectKey) {
-        throw new Error('useBundles: `projectKey` ist Pflicht.');
+        throw new Error('useBundles: `projectKey` is required.');
     }
 
     const http = options.http ?? defaultHttpClient();
@@ -91,7 +91,7 @@ export function useBundles(options: UseBundlesOptions): UseBundlesResult {
             throw new BundlesApiError(
                 res.status,
                 body,
-                `Bundles-API antwortete mit HTTP ${res.status}`,
+                `Bundles API responded with HTTP ${res.status}`,
             );
         }
         return body as T;
@@ -117,7 +117,7 @@ export function useBundles(options: UseBundlesOptions): UseBundlesResult {
             method: 'POST',
             body: JSON.stringify(data),
         });
-        if (!created) throw new BundlesApiError(0, null, 'Create gab keinen Body zurück');
+        if (!created) throw new BundlesApiError(0, null, 'Create returned no body');
         bundles.value = [...bundles.value, created];
         return created;
     }
@@ -127,7 +127,7 @@ export function useBundles(options: UseBundlesOptions): UseBundlesResult {
             method: 'PATCH',
             body: JSON.stringify(data),
         });
-        if (!updated) throw new BundlesApiError(0, null, 'Update gab keinen Body zurück');
+        if (!updated) throw new BundlesApiError(0, null, 'Update returned no body');
         bundles.value = bundles.value.map((b) => (b.id === bundleId ? updated : b));
         return updated;
     }
@@ -189,10 +189,10 @@ export interface UseBundleVersionsResult {
 
 export function useBundleVersions(options: UseBundleVersionsOptions): UseBundleVersionsResult {
     if (!options?.adminEndpoint) {
-        throw new Error('useBundleVersions: `adminEndpoint` ist Pflicht.');
+        throw new Error('useBundleVersions: `adminEndpoint` is required.');
     }
     if (!options?.bundleId) {
-        throw new Error('useBundleVersions: `bundleId` ist Pflicht.');
+        throw new Error('useBundleVersions: `bundleId` is required.');
     }
 
     const http = options.http ?? defaultHttpClient();
@@ -220,7 +220,7 @@ export function useBundleVersions(options: UseBundleVersionsOptions): UseBundleV
             throw new BundlesApiError(
                 res.status,
                 body,
-                `BundleVersions-API antwortete mit HTTP ${res.status}`,
+                `BundleVersions API responded with HTTP ${res.status}`,
             );
         }
         return body as T;
@@ -246,7 +246,7 @@ export function useBundleVersions(options: UseBundleVersionsOptions): UseBundleV
             method: 'POST',
             body: JSON.stringify(data),
         });
-        if (!result) throw new BundlesApiError(0, null, 'CreateDraft gab keinen Body zurück');
+        if (!result) throw new BundlesApiError(0, null, 'CreateDraft returned no body');
         versions.value = [...versions.value, result.bundleVersion];
         return result;
     }
@@ -259,7 +259,7 @@ export function useBundleVersions(options: UseBundleVersionsOptions): UseBundleV
             `${versionUrlBase}/${versionId}`,
             { method: 'PATCH', body: JSON.stringify(data) },
         );
-        if (!result) throw new BundlesApiError(0, null, 'UpdateDraft gab keinen Body zurück');
+        if (!result) throw new BundlesApiError(0, null, 'UpdateDraft returned no body');
         versions.value = versions.value.map((v) => (v.id === versionId ? result.bundleVersion : v));
         return result;
     }
@@ -277,7 +277,7 @@ export function useBundleVersions(options: UseBundleVersionsOptions): UseBundleV
             `${versionUrlBase}/${versionId}/publish`,
             { method: 'POST', body: JSON.stringify(opts) },
         );
-        if (!result) throw new BundlesApiError(0, null, 'Publish gab keinen Body zurück');
+        if (!result) throw new BundlesApiError(0, null, 'Publish returned no body');
         // Reload versions, because publishing may mark another version as
         // superseded — the local cache would otherwise be inconsistent.
         await load();