@saasicat/ui-vue 0.4.0 → 0.6.0

package/dist/quasar/index.d.cts

@@ -0,0 +1,95 @@
+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 '../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 {
+    /** 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;
+    /**
+     * 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: notify port for the standard pages' toasts. Default is the
+     * Quasar `Notify` implementation — apps with their own notification
+     * center replace it here without touching the pages.
+     */
+    notify?: UiNotify;
+    /**
+     * Optional: additional Vue plugins (e.g. an app's own NotificationCenter)
+     * that are installed after the platform setup, before the mount.
+     */
+    installPlugins?: InstallPlugin[];
+    /**
+     * 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;
+    /**
+     * 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']>;
+}
+/**
+ * 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.
+ */
+declare function createSuperAdminApp(options: CreateSuperAdminAppOptions): SuperAdminAppHandle;
+
+/**
+ * Quasar-backed notify port: `position: 'top'` matches the convention the
+ * standard pages used with their previous direct `$q.notify` calls.
+ */
+declare const quasarNotify: UiNotify;
+/** Returns the app-provided notify port, falling back to the Quasar default. */
+declare function useSuperAdminNotify(): UiNotify;
+
+export { type CreateSuperAdminAppOptions, type SuperAdminAppHandle, createSuperAdminApp, quasarNotify, useSuperAdminNotify };

package/dist/quasar/index.d.ts

@@ -0,0 +1,95 @@
+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 '../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 {
+    /** 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;
+    /**
+     * 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: notify port for the standard pages' toasts. Default is the
+     * Quasar `Notify` implementation — apps with their own notification
+     * center replace it here without touching the pages.
+     */
+    notify?: UiNotify;
+    /**
+     * Optional: additional Vue plugins (e.g. an app's own NotificationCenter)
+     * that are installed after the platform setup, before the mount.
+     */
+    installPlugins?: InstallPlugin[];
+    /**
+     * 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;
+    /**
+     * 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']>;
+}
+/**
+ * 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.
+ */
+declare function createSuperAdminApp(options: CreateSuperAdminAppOptions): SuperAdminAppHandle;
+
+/**
+ * Quasar-backed notify port: `position: 'top'` matches the convention the
+ * standard pages used with their previous direct `$q.notify` calls.
+ */
+declare const quasarNotify: UiNotify;
+/** Returns the app-provided notify port, falling back to the Quasar default. */
+declare function useSuperAdminNotify(): UiNotify;
+
+export { type CreateSuperAdminAppOptions, type SuperAdminAppHandle, createSuperAdminApp, quasarNotify, useSuperAdminNotify };

package/dist/quasar/index.js

@@ -0,0 +1,96 @@
+import {
+  SUPER_ADMIN_ACTIONS_KEY,
+  SUPER_ADMIN_BRAND_KEY,
+  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,
+  createSuperAdminI18n
+} from "../chunk-QZOSDCNP.js";
+import {
+  defaultHttpClient
+} from "../chunk-X5SQ5HMB.js";
+
+// src/quasar/create-super-admin-app.ts
+import { createApp } from "vue";
+import { Quasar, Notify as Notify2, Dialog, Loading } from "quasar";
+import { createPinia } from "pinia";
+import {
+  createRouter,
+  createWebHistory
+} from "vue-router";
+
+// src/quasar/notify.ts
+import { inject } from "vue";
+import { Notify } from "quasar";
+var quasarNotify = (kind, message, options) => {
+  Notify.create({
+    type: kind,
+    message,
+    position: "top",
+    caption: options?.caption,
+    timeout: options?.timeoutMs
+  });
+};
+function useSuperAdminNotify() {
+  return inject(SUPER_ADMIN_NOTIFY_KEY, quasarNotify);
+}
+
+// src/quasar/create-super-admin-app.ts
+var DEFAULT_QUASAR_OPTIONS = {
+  plugins: { Notify: Notify2, Dialog, Loading },
+  config: { notify: { position: "top-right", timeout: 3e3 } }
+};
+function createSuperAdminApp(options) {
+  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 = {
+    apiBase: options.endpoints.apiBase,
+    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 ?? {});
+  app.provide(SUPER_ADMIN_NOTIFY_KEY, options.notify ?? quasarNotify);
+  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,
+    i18n,
+    mount: (selector) => app.mount(selector)
+  };
+}
+export {
+  createSuperAdminApp,
+  quasarNotify,
+  useSuperAdminNotify
+};

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/use-super-admin-i18n-B3v3-SWZ.d.ts

@@ -0,0 +1,210 @@
+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, S as SaLocale, a as SaMessages, b as SaMessagesOverrides } from './messages-7b0P8W75.js';
+
+/**
+ * App-specific branding data that the platform `AdminLayout` and other
+ * consumers read via `useSuperAdminBrand()`.
+ */
+interface SuperAdminBrand {
+    /** 2-letter abbreviation in the logo badge (`'ma'`, `'da'`, …). */
+    logoText: string;
+    /** Full display name (`'DemoApp'`, `'ClubApp'`, …). */
+    name: string;
+    /** Optional: tag to the right of the name, default `'SuperAdmin'`. */
+    tag?: string;
+}
+/**
+ * Endpoint configuration. `apiBase` is the shared prefix under which
+ * `/manifest`, `/boot` and extra routes live.
+ */
+interface SuperAdminEndpoints {
+    /** Shared prefix, e.g. `'/api/admin'` or `'/api/v1/admin'`. */
+    apiBase: string;
+    /** Pre-login branding endpoint, default `${apiBase}/boot`. */
+    publicBootEndpoint?: string;
+    /** Post-login full-manifest endpoint, default `${apiBase}/manifest`. */
+    manifestEndpoint?: string;
+}
+type ExtensionLoader = () => Promise<Component | {
+    default: Component;
+}>;
+type ExtensionsMap = Record<ComponentKey, ExtensionLoader>;
+type ActionsMap = Record<ActionKey, ActionHandler>;
+interface SuperAdminAuthGuardOptions {
+    /** App provides: is the user currently logged in? */
+    isAuthenticated: () => boolean;
+    /** App provides: does the user have the SuperAdmin role? Default: only check `isAuthenticated`. */
+    isSuperAdmin?: () => boolean;
+    /** App provides: redirect path for unauthenticated calls (e.g. `'/login'`). */
+    onUnauthenticated: () => string;
+}
+/**
+ * Result of a login attempt. Apps pass this back from their auth store to the
+ * platform LoginPage; the page renders an appropriate error message.
+ *
+ * `ok: true` → login succeeded, page redirects to `redirectAfterLogin`.
+ * `ok: false` → page shows `message` or a translation derived from `code`.
+ *
+ * Known codes:
+ *   - `BAD_CREDENTIALS` — wrong email/password combination.
+ *   - `NOT_SUPER_ADMIN` — account does not have the SuperAdmin role.
+ *   - otherwise          — app-specific; `message` is displayed directly.
+ */
+type SuperAdminLoginResult = {
+    ok: true;
+} | {
+    ok: false;
+    code?: 'BAD_CREDENTIALS' | 'NOT_SUPER_ADMIN' | string;
+    message?: string;
+};
+/**
+ * Login adapter. The app passes its auth-store call through here. The platform
+ * LoginPage consumes it via `useSuperAdminLoginAdapter()`, without knowledge
+ * of app-specific stores (Pinia, auth API routes, MFA hooks).
+ */
+interface SuperAdminLoginAdapter {
+    /**
+     * Performs the login. The app store encapsulates the API call, token
+     * storage, MFA hops etc.
+     */
+    login(email: string, password: string): Promise<SuperAdminLoginResult>;
+    /**
+     * Target route after a successful login. Default: `/admin/dashboard`
+     * (platform convention for the standard pages — apps with a different
+     * default mount override this here).
+     */
+    redirectAfterLogin?: string;
+    /**
+     * Optional: dev hint (test account), shown below the form. Deliberately
+     * rendered only when `environment !== 'production'`.
+     */
+    devHint?: {
+        email: string;
+        password: string;
+    };
+}
+interface SuperAdminManifestGuardOptions {
+    /**
+     * App provides: loads the manifest into the app store. The router guard
+     * `await`s the promise before the route is resolved.
+     *
+     * **On loader error:** the promise REJECTS. The router guard catches the
+     * rejection and decides depending on `errorRoute`:
+     *   - `errorRoute` set → redirect to this route (fail-closed).
+     *   - `errorRoute` not set → `console.error` + render allowed
+     *     (defensive default behavior; the app must render the manifest gap
+     *     itself).
+     */
+    ensureLoaded: () => Promise<void>;
+    /**
+     * Optional: read accessor on the loaded manifest. When set, it is exposed
+     * via `provide(SUPER_ADMIN_MANIFEST_KEY)` — the `<ProjectPageHost>`
+     * resolves manifest `projectPages` through it against the
+     * `extensions:` map.
+     */
+    getManifest?: () => AdminManifest | null;
+    /**
+     * Optional: path that the router guard redirects to on a manifest load
+     * error (fail-closed mode). The app must register the route in `appRoutes`
+     * and mark it as `meta.public = true`, otherwise it runs through the
+     * manifest guard again and produces a redirect loop.
+     */
+    errorRoute?: string;
+}
+/**
+ * Guard configuration shared by `buildNavigationGuard()` and
+ * `createSuperAdminApp()` (which embeds both fields in its options).
+ */
+interface SuperAdminGuardOptions {
+    /**
+     * Optional: auth guard. When set, `router.beforeEach` is wired up
+     * automatically — `to.meta.public === true` bypasses the guard.
+     */
+    authGuard?: SuperAdminAuthGuardOptions;
+    /**
+     * Optional: manifest guard. Runs after a successful auth guard, blocks the
+     * render until the manifest is loaded (prevents sidebar flicker).
+     */
+    manifestGuard?: SuperAdminManifestGuardOptions;
+}
+/** Vue inject key for `useSuperAdminBrand()`. */
+declare const SUPER_ADMIN_BRAND_KEY: InjectionKey<SuperAdminBrand>;
+/** Vue inject key for `useSuperAdminEndpoints()`. */
+declare const SUPER_ADMIN_ENDPOINTS_KEY: InjectionKey<Required<SuperAdminEndpoints>>;
+/** Vue inject key for `useSuperAdminExtensions()`. */
+declare const SUPER_ADMIN_EXTENSIONS_KEY: InjectionKey<ExtensionsMap>;
+/** Vue inject key for `useSuperAdminActions()`. */
+declare const SUPER_ADMIN_ACTIONS_KEY: InjectionKey<ActionsMap>;
+/**
+ * Vue inject key for the manifest accessor. Only provided when
+ * `manifestGuard.getManifest` was passed to `createSuperAdminApp()` — the
+ * `<ProjectPageHost>` needs it to resolve project pages.
+ */
+declare const SUPER_ADMIN_MANIFEST_KEY: InjectionKey<() => AdminManifest | null>;
+/** Vue inject key for `useSuperAdminLoginAdapter()`. */
+declare const SUPER_ADMIN_LOGIN_ADAPTER_KEY: InjectionKey<SuperAdminLoginAdapter>;
+/** Vue inject key for `useSuperAdminHttp()` (pre-login HttpClient). */
+declare const SUPER_ADMIN_HTTP_KEY: InjectionKey<HttpClient>;
+/**
+ * Additional Vue plugins (e.g. an app's own NotificationCenter) that a
+ * bootstrap installs after the platform setup, before the mount.
+ */
+type InstallPlugin = (app: App) => void;
+/**
+ * Internal helper, exported for isolated unit tests of the navigation
+ * behavior (auth redirect, manifest fail-closed path). Consumers should call
+ * `createSuperAdminApp()`, not this helper directly.
+ */
+declare function buildNavigationGuard(options: SuperAdminGuardOptions): NavigationGuardWithThis<undefined> | null;
+
+/**
+ * Feedback kind, aligned with the established page conventions
+ * (`positive` = success, `negative` = error).
+ */
+type UiNotifyKind = 'positive' | 'negative' | 'warning' | 'info';
+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. */
+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). */
+declare const SUPER_ADMIN_NOTIFY_KEY: InjectionKey<UiNotify>;
+
+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 };