@saasicat/ui-vue 0.4.0 → 0.5.0

package/dist/quasar/index.cjs

@@ -0,0 +1,159 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/quasar/index.ts
+var quasar_exports = {};
+__export(quasar_exports, {
+  createSuperAdminApp: () => createSuperAdminApp,
+  quasarNotify: () => quasarNotify,
+  useSuperAdminNotify: () => useSuperAdminNotify
+});
+module.exports = __toCommonJS(quasar_exports);
+
+// src/quasar/create-super-admin-app.ts
+var import_vue2 = require("vue");
+var import_quasar2 = require("quasar");
+var import_pinia = require("pinia");
+var import_vue_router = require("vue-router");
+
+// src/client/types.ts
+function defaultHttpClient() {
+  return (url, init) => fetch(url, init);
+}
+
+// src/vue/super-admin-context.ts
+var SUPER_ADMIN_BRAND_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_BRAND"
+);
+var SUPER_ADMIN_ENDPOINTS_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_ENDPOINTS"
+);
+var SUPER_ADMIN_EXTENSIONS_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_EXTENSIONS"
+);
+var SUPER_ADMIN_ACTIONS_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_ACTIONS"
+);
+var SUPER_ADMIN_MANIFEST_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_MANIFEST"
+);
+var SUPER_ADMIN_LOGIN_ADAPTER_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_LOGIN_ADAPTER"
+);
+var SUPER_ADMIN_HTTP_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_HTTP"
+);
+function buildNavigationGuard(options) {
+  const { authGuard, manifestGuard } = options;
+  if (!authGuard && !manifestGuard) return null;
+  return async (to) => {
+    if (to.meta?.public === true) return true;
+    if (authGuard) {
+      if (!authGuard.isAuthenticated()) return authGuard.onUnauthenticated();
+      if (authGuard.isSuperAdmin && !authGuard.isSuperAdmin()) {
+        return authGuard.onUnauthenticated();
+      }
+    }
+    if (manifestGuard) {
+      try {
+        await manifestGuard.ensureLoaded();
+      } catch (err) {
+        if (manifestGuard.errorRoute && to.path !== manifestGuard.errorRoute) {
+          return manifestGuard.errorRoute;
+        }
+        console.error("[SuperAdmin] manifest load failed", err);
+      }
+    }
+    return true;
+  };
+}
+
+// src/vue/ui-notify.ts
+var SUPER_ADMIN_NOTIFY_KEY = /* @__PURE__ */ Symbol.for(
+  "@saasicat/ui-vue/SUPER_ADMIN_NOTIFY"
+);
+
+// src/quasar/notify.ts
+var import_vue = require("vue");
+var import_quasar = require("quasar");
+var quasarNotify = (kind, message, options) => {
+  import_quasar.Notify.create({
+    type: kind,
+    message,
+    position: "top",
+    caption: options?.caption,
+    timeout: options?.timeoutMs
+  });
+};
+function useSuperAdminNotify() {
+  return (0, import_vue.inject)(SUPER_ADMIN_NOTIFY_KEY, quasarNotify);
+}
+
+// src/quasar/create-super-admin-app.ts
+var DEFAULT_QUASAR_OPTIONS = {
+  plugins: { Notify: import_quasar2.Notify, Dialog: import_quasar2.Dialog, Loading: import_quasar2.Loading },
+  config: { notify: { position: "top-right", timeout: 3e3 } }
+};
+function createSuperAdminApp(options) {
+  const app = (0, import_vue2.createApp)(options.rootComponent);
+  app.use(import_quasar2.Quasar, options.quasarOptions ?? DEFAULT_QUASAR_OPTIONS);
+  const pinia = (0, import_pinia.createPinia)();
+  app.use(pinia);
+  const router = (0, import_vue_router.createRouter)({
+    history: options.routerHistory ?? (0, import_vue_router.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`
+  };
+  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 ?? {});
+  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,
+    mount: (selector) => app.mount(selector)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSuperAdminApp,
+  quasarNotify,
+  useSuperAdminNotify
+});

package/dist/quasar/index.d.cts

@@ -0,0 +1,86 @@
+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 '@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;
+}
+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']>;
+}
+/**
+ * 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,86 @@
+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 '@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;
+}
+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']>;
+}
+/**
+ * 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,91 @@
+import {
+  SUPER_ADMIN_ACTIONS_KEY,
+  SUPER_ADMIN_BRAND_KEY,
+  SUPER_ADMIN_ENDPOINTS_KEY,
+  SUPER_ADMIN_EXTENSIONS_KEY,
+  SUPER_ADMIN_HTTP_KEY,
+  SUPER_ADMIN_LOGIN_ADAPTER_KEY,
+  SUPER_ADMIN_MANIFEST_KEY,
+  SUPER_ADMIN_NOTIFY_KEY,
+  buildNavigationGuard
+} from "../chunk-3YP2ZAOD.js";
+import {
+  defaultHttpClient
+} from "../chunk-LVGUSD3T.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`
+  };
+  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 ?? {});
+  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,
+    mount: (selector) => app.mount(selector)
+  };
+}
+export {
+  createSuperAdminApp,
+  quasarNotify,
+  useSuperAdminNotify
+};

package/dist/ui-notify-COUzXEQ4.d.ts

@@ -0,0 +1,178 @@
+import { Component, App, InjectionKey } 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';
+
+/**
+ * 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>;
+
+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 };