@saasicat/ui-vue 0.4.0 → 0.6.0

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/{manifest-store-factory.ts → vue/manifest-store-factory.ts}

@@ -13,7 +13,7 @@
 import { defineStore, type StoreDefinition } from 'pinia';
 import { ref, type Ref } from 'vue';
 import type { AdminManifest } from '@saasicat/types';
-import type { ManifestLoader } from './manifest-loader.js';
+import type { ManifestLoader } from '../client/manifest-loader.js';
 
 export interface ManifestStoreState {
     manifest: Ref<AdminManifest | null>;

package/src/{platform-loaders.ts → vue/platform-loaders.ts}

@@ -5,10 +5,10 @@
 // a single constant that `main.ts` passes to `createSuperAdminApp()` and that
 // the loader wiring from this helper consumes.
 
-import { BootLoader } from './boot-loader.js';
-import { ManifestLoader } from './manifest-loader.js';
-import type { SuperAdminEndpoints } from './create-super-admin-app.js';
-import type { HttpClient, KvStore } from './types.js';
+import { BootLoader } from '../client/boot-loader.js';
+import { ManifestLoader } from '../client/manifest-loader.js';
+import type { SuperAdminEndpoints } from './super-admin-context.js';
+import type { HttpClient, KvStore } from '../client/types.js';
 
 export interface CreatePlatformLoadersOptions {
     /**

package/src/{project-page-host.ts → vue/project-page-host.ts}

@@ -14,7 +14,7 @@ import {
     SUPER_ADMIN_EXTENSIONS_KEY,
     SUPER_ADMIN_MANIFEST_KEY,
     type ExtensionsMap,
-} from './create-super-admin-app.js';
+} from './super-admin-context.js';
 
 // `defineAsyncComponent` gets its own wrapper component per loader
 // function — without a cache, re-renders would recreate the same component
@@ -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/{create-super-admin-app.ts → vue/super-admin-context.ts}

@@ -1,29 +1,17 @@
-// createSuperAdminApp — universal bootstrap helper for SuperAdmin Vue apps.
-// Bundles the Quasar/Pinia/Router setup that every consumer app rebuilds itself
-// today, and exposes the platform contract maps (`extensions:`, `actions:`)
-// via `provide()`.
+// SuperAdmin shell contract — injection keys, option types and the
+// navigation guard shared between the Quasar bootstrap
+// (`createSuperAdminApp()`, `@saasicat/ui-vue/quasar`) and the framework
+// components/composables in this package.
 //
-// What the helper does NOT do:
-//   - Auth stores, login flows, JWT refresh — app-specific.
-//   - CSS imports (Quasar CSS, Material Icons, app theme) — these stay in the
-//     app's own `main.ts`, because tsup does not bundle CSS.
+// Lives in the Vue layer (no Quasar import) so that the main entry and all
+// composables stay consumable without Quasar being installed.
 
-import { createApp, type App, type Component, type InjectionKey } from 'vue';
-import { Quasar, Notify, Dialog, Loading, type QuasarPluginOptions } from 'quasar';
-import { createPinia, type Pinia } from 'pinia';
-import {
-    createRouter,
-    createWebHistory,
-    type NavigationGuardWithThis,
-    type RouteLocationNormalized,
-    type RouteRecordRaw,
-    type Router,
-    type RouterHistory,
-} from 'vue-router';
+import type { App, Component, InjectionKey } from 'vue';
+import type { NavigationGuardWithThis, RouteLocationNormalized } from 'vue-router';
 
 import type { ActionKey, AdminManifest, ComponentKey } from '@saasicat/types';
-import type { ActionHandler } from './action-registry.js';
-import { defaultHttpClient, type HttpClient } from './types.js';
+import type { ActionHandler } from '../client/action-registry.js';
+import type { HttpClient } from '../client/types.js';
 
 /**
  * App-specific branding data that the platform `AdminLayout` and other
@@ -133,25 +121,11 @@ export interface SuperAdminManifestGuardOptions {
     errorRoute?: string;
 }
 
-export interface CreateSuperAdminAppOptions {
-    /** App root component (`App.vue`). */
-    rootComponent: Component;
-    /** App branding (logo, name). */
-    brand: SuperAdminBrand;
-    /** Endpoint configuration. */
-    endpoints: SuperAdminEndpoints;
-    /** App's own routes (login, standard pages, bundle pages, …). */
-    appRoutes: RouteRecordRaw[];
-    /**
-     * Static `extensions:` map. Manifest `projectPages[].componentKey` is
-     * looked up in it (see Spec §4.4).
-     */
-    extensions?: ExtensionsMap;
-    /**
-     * Static `actions:` map. Manifest `tenants.actions[].actionKey` is looked
-     * up in it.
-     */
-    actions?: ActionsMap;
+/**
+ * Guard configuration shared by `buildNavigationGuard()` and
+ * `createSuperAdminApp()` (which embeds both fields in its options).
+ */
+export interface SuperAdminGuardOptions {
     /**
      * Optional: auth guard. When set, `router.beforeEach` is wired up
      * automatically — `to.meta.public === true` bypasses the guard.
@@ -162,47 +136,11 @@ export interface CreateSuperAdminAppOptions {
      * render until the manifest is loaded (prevents sidebar flicker).
      */
     manifestGuard?: SuperAdminManifestGuardOptions;
-    /**
-     * Optional: login adapter. When set, it is exposed via `provide()` for the
-     * shared `<SuperAdminLoginPage>` (from `pages-standard/`) — the app no
-     * longer needs to hold its own LoginPage Vue component.
-     */
-    loginAdapter?: SuperAdminLoginAdapter;
-    /**
-     * Optional: router history variant, default `createWebHistory()`.
-     * Apps with a subpath mount override this.
-     */
-    routerHistory?: RouterHistory;
-    /**
-     * Optional: Quasar configuration. Default loads `Notify`/`Dialog`/`Loading`
-     * with the established consumer convention (`top-right`, 3 s).
-     */
-    quasarOptions?: Partial<QuasarPluginOptions>;
-    /**
-     * Optional: additional Vue plugins (e.g. an app's own NotificationCenter)
-     * that are installed after the platform setup, before the mount.
-     */
-    installPlugins?: Array<(app: App) => void>;
-    /**
-     * Optional: `HttpClient` for all pre-login calls (boot, first-run setup).
-     * Default `defaultHttpClient()` (= `fetch`). Consumers pass their own
-     * variant through (auth header, baseURL, retry) — it then applies uniformly,
-     * including for the setup wizard. Consumed via `useSuperAdminHttp()`.
-     */
-    http?: HttpClient;
-}
-
-export interface SuperAdminAppHandle {
-    app: App;
-    router: Router;
-    pinia: Pinia;
-    /** Mounts the app on a selector. Returns the root component instance. */
-    mount: (selector: string | Element) => ReturnType<App['mount']>;
 }
 
 // Vue inject keys are registered globally via `Symbol.for(...)`. Reason:
 // apps import `createSuperAdminApp` (and thus `app.provide(KEY, ...)`) from
-// the built `dist/index.js` bundle, but shared `.vue` pages in the
+// the built `dist/` bundles, but shared `.vue` pages in the
 // `pages-standard/` directory directly from `src/`. Both paths produce two
 // independent module instances — with local `Symbol(...)` the identity would
 // differ, and `inject()` would always throw "not found". `Symbol.for(...)`
@@ -241,68 +179,11 @@ export const SUPER_ADMIN_HTTP_KEY: InjectionKey<HttpClient> = Symbol.for(
     '@saasicat/ui-vue/SUPER_ADMIN_HTTP',
 );
 
-const DEFAULT_QUASAR_OPTIONS: QuasarPluginOptions = {
-    plugins: { Notify, Dialog, Loading },
-    config: { notify: { position: 'top-right', timeout: 3000 } },
-};
-
 /**
- * Universal bootstrap function for SuperAdmin apps. Replaces the `main.ts`
- * boilerplate duplicated per app today (Quasar + Pinia + Router + manifest
- * guard) and exposes the platform maps via `provide()` for downstream
- * components.
+ * Additional Vue plugins (e.g. an app's own NotificationCenter) that a
+ * bootstrap installs after the platform setup, before the mount.
  */
-export function createSuperAdminApp(options: CreateSuperAdminAppOptions): SuperAdminAppHandle {
-    const app = createApp(options.rootComponent);
-
-    app.use(Quasar, options.quasarOptions ?? DEFAULT_QUASAR_OPTIONS);
-
-    const pinia = createPinia();
-    app.use(pinia);
-
-    const router = createRouter({
-        history: options.routerHistory ?? createWebHistory(),
-        routes: options.appRoutes,
-    });
-
-    const navGuard = buildNavigationGuard(options);
-    if (navGuard) {
-        router.beforeEach(navGuard);
-    }
-
-    app.use(router);
-
-    const endpoints: Required<SuperAdminEndpoints> = {
-        apiBase: options.endpoints.apiBase,
-        publicBootEndpoint:
-            options.endpoints.publicBootEndpoint ?? `${options.endpoints.apiBase}/boot`,
-        manifestEndpoint:
-            options.endpoints.manifestEndpoint ?? `${options.endpoints.apiBase}/manifest`,
-    };
-
-    app.provide(SUPER_ADMIN_BRAND_KEY, { tag: 'SuperAdmin', ...options.brand });
-    app.provide(SUPER_ADMIN_ENDPOINTS_KEY, endpoints);
-    app.provide(SUPER_ADMIN_EXTENSIONS_KEY, options.extensions ?? {});
-    app.provide(SUPER_ADMIN_ACTIONS_KEY, options.actions ?? {});
-    if (options.manifestGuard?.getManifest) {
-        app.provide(SUPER_ADMIN_MANIFEST_KEY, options.manifestGuard.getManifest);
-    }
-    if (options.loginAdapter) {
-        app.provide(SUPER_ADMIN_LOGIN_ADAPTER_KEY, options.loginAdapter);
-    }
-    app.provide(SUPER_ADMIN_HTTP_KEY, options.http ?? defaultHttpClient());
-
-    for (const plugin of options.installPlugins ?? []) {
-        plugin(app);
-    }
-
-    return {
-        app,
-        router,
-        pinia,
-        mount: (selector) => app.mount(selector),
-    };
-}
+export type InstallPlugin = (app: App) => void;
 
 /**
  * Internal helper, exported for isolated unit tests of the navigation
@@ -310,7 +191,7 @@ export function createSuperAdminApp(options: CreateSuperAdminAppOptions): SuperA
  * `createSuperAdminApp()`, not this helper directly.
  */
 export function buildNavigationGuard(
-    options: Pick<CreateSuperAdminAppOptions, 'authGuard' | 'manifestGuard'>,
+    options: SuperAdminGuardOptions,
 ): NavigationGuardWithThis<undefined> | null {
     const { authGuard, manifestGuard } = options;
     if (!authGuard && !manifestGuard) return null;

package/src/vue/ui-notify.ts

@@ -0,0 +1,30 @@
+// UI notify port — the single toast/snackbar seam between platform pages and
+// the host app. Standard pages emit user feedback exclusively through this
+// port; which component library renders it is the app's choice.
+//
+// `createSuperAdminApp()` (`@saasicat/ui-vue/quasar`) provides a
+// Quasar-backed default; apps override it via
+// `createSuperAdminApp({ notify })` or by providing the key themselves.
+
+import type { InjectionKey } from 'vue';
+
+/**
+ * Feedback kind, aligned with the established page conventions
+ * (`positive` = success, `negative` = error).
+ */
+export type UiNotifyKind = 'positive' | 'negative' | 'warning' | 'info';
+
+export interface UiNotifyOptions {
+    /** Secondary line below the message (e.g. changed fields, one-time password). */
+    caption?: string;
+    /** Display duration in ms; implementations fall back to their default when unset. */
+    timeoutMs?: number;
+}
+
+/** Notify port. Compatible with the `(kind, message)` callbacks pages already accept. */
+export type UiNotify = (kind: UiNotifyKind, message: string, options?: UiNotifyOptions) => void;
+
+/** Vue inject key for the notify port (see `Symbol.for` note in super-admin-context.ts). */
+export const SUPER_ADMIN_NOTIFY_KEY: InjectionKey<UiNotify> = Symbol.for(
+    '@saasicat/ui-vue/SUPER_ADMIN_NOTIFY',
+);

package/src/{use-actions.ts → vue/use-actions.ts}

@@ -7,7 +7,7 @@
 
 import { computed, type ComputedRef, type Ref } from 'vue';
 import type { AdminManifest } from '@saasicat/types';
-import { ActionRegistry, type ActionHandler } from './action-registry.js';
+import { ActionRegistry, type ActionHandler } from '../client/action-registry.js';
 
 export interface UseActionsResult {
     registry: ComputedRef<ActionRegistry | null>;

package/src/{use-api-list.ts → vue/use-api-list.ts}

@@ -5,7 +5,7 @@
 // Direct use is also allowed for custom endpoints.
 
 import { ref, watch, type Ref } from 'vue';
-import { defaultHttpClient, type HttpClient } from './types.js';
+import { defaultHttpClient, type HttpClient } from '../client/types.js';
 
 export interface ApiListResponse<T> {
     items: T[];

package/src/{use-audit-entries.ts → 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/{use-batch-columns.ts → vue/use-batch-columns.ts}

@@ -12,7 +12,7 @@ import {
     BatchColumnFetcher,
     type BatchColumnData,
     type BatchColumnFetcherOptions,
-} from './batch-column-fetcher.js';
+} from '../client/batch-column-fetcher.js';
 
 export interface UseBatchColumnsResult {
     /** Data per column key (`columnKey → tenantId → value`). */

package/src/{use-bulk-publish.ts → vue/use-bulk-publish.ts}

@@ -11,7 +11,8 @@
 // `mfaCode` parameter through.
 
 import { computed, ref, type ComputedRef, type Ref } from 'vue';
-import { defaultHttpClient, type HttpClient } from './types.js';
+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/{use-bundle-versions-map.ts → vue/use-bundle-versions-map.ts}

@@ -11,7 +11,7 @@
 
 import { ref, watch, type Ref } from 'vue';
 import type { BundleRow, BundleVersionRow } from '@saasicat/types';
-import { defaultHttpClient, type HttpClient } from './types.js';
+import { defaultHttpClient, type HttpClient } from '../client/types.js';
 
 export interface UseBundleVersionsMapOptions {
     adminEndpoint: string;
@@ -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/{use-bundles.ts → vue/use-bundles.ts}

@@ -16,7 +16,7 @@ import type {
     UpdateBundleData,
     UpdateBundleVersionDraftData,
 } from '@saasicat/types';
-import { defaultHttpClient, type HttpClient } from './types.js';
+import { defaultHttpClient, type HttpClient } from '../client/types.js';
 
 export interface UseBundlesOptions {
     /**
@@ -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();