@saasicat/ui-vue 0.19.0 → 0.22.0

package/dist/quasar/index.cjs

@@ -92,17 +92,27 @@ var SUPER_ADMIN_ACTIONS_KEY = /* @__PURE__ */ Symbol.for(
 var SUPER_ADMIN_MANIFEST_KEY = /* @__PURE__ */ Symbol.for(
   "@saasicat/ui-vue/SUPER_ADMIN_MANIFEST"
 );
+var SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY = /* @__PURE__ */ Symbol.for("@saasicat/ui-vue/SUPER_ADMIN_MANIFEST_CLEAR_CACHE");
 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 isUnauthorizedError(err) {
+  const status = err?.status;
+  return status === 401 || status === 403;
+}
 function buildNavigationGuard(options) {
   const { authGuard, manifestGuard } = options;
   if (!authGuard && !manifestGuard) return null;
+  let redirectedForUnauthorized = false;
+  let reachedLoginAfterRedirect = false;
   return async (to) => {
-    if (to.meta?.public === true) return true;
+    if (to.meta?.public === true) {
+      if (redirectedForUnauthorized) reachedLoginAfterRedirect = true;
+      return true;
+    }
     if (authGuard) {
       if (!authGuard.isAuthenticated()) return authGuard.onUnauthenticated();
       if (authGuard.isSuperAdmin && !authGuard.isSuperAdmin()) {
@@ -112,7 +122,15 @@ function buildNavigationGuard(options) {
     if (manifestGuard) {
       try {
         await manifestGuard.ensureLoaded();
+        redirectedForUnauthorized = false;
+        reachedLoginAfterRedirect = false;
       } catch (err) {
+        if (authGuard && isUnauthorizedError(err)) {
+          if (!redirectedForUnauthorized || !reachedLoginAfterRedirect) {
+            redirectedForUnauthorized = true;
+            return authGuard.onUnauthenticated();
+          }
+        }
         if (manifestGuard.errorRoute && to.path !== manifestGuard.errorRoute) {
           return manifestGuard.errorRoute;
         }
@@ -249,8 +267,7 @@ var bundlesMessages = defineMessages(
       title: "Bundles",
       subtitle: "Produktgruppen aus Features & Quotas \u2014 verwendet in Pl\xE4nen. Bundles werden im SuperAdmin kuratiert.",
       displayLocale: "Anzeige-Sprache",
-      newBundle: "Neues Bundle",
-      reload: "Liste neu laden"
+      newBundle: "Neues Bundle"
     },
     filter: {
       all: "Alle Status",
@@ -464,8 +481,7 @@ var bundlesMessages = defineMessages(
       title: "Bundles",
       subtitle: "Product groups made of features & quotas \u2014 used in plans. Bundles are curated in the SuperAdmin.",
       displayLocale: "Display language",
-      newBundle: "New bundle",
-      reload: "Reload list"
+      newBundle: "New bundle"
     },
     filter: {
       all: "All statuses",
@@ -664,6 +680,9 @@ var commonMessages = defineMessages(
     loading: "Lade \u2026",
     saving: "Speichere \u2026",
     loadingData: "Daten werden geladen\u2026",
+    noData: "Keine Daten vorhanden",
+    filters: "Filter",
+    results: "Ergebnisse",
     error: "Fehler",
     errorLoadFailed: "Laden fehlgeschlagen",
     errorSaveFailed: "Speichern fehlgeschlagen",
@@ -709,7 +728,16 @@ var commonMessages = defineMessages(
     unlimited: "unbegrenzt",
     both: "Beide",
     createFailed: "Anlegen fehlgeschlagen",
-    noChanges: "Keine \xC4nderungen"
+    noChanges: "Keine \xC4nderungen",
+    paginator: {
+      label: "Seitennavigation",
+      rowsPerPage: "Zeilen pro Seite",
+      all: "Alle",
+      page: "Seite {page}/{pages}",
+      pageInput: "Seite, 1 bis {pages}",
+      previous: "Vorherige Seite",
+      next: "N\xE4chste Seite"
+    }
   },
   {
     save: "Save",
@@ -734,6 +762,9 @@ var commonMessages = defineMessages(
     loading: "Loading \u2026",
     saving: "Saving \u2026",
     loadingData: "Loading data\u2026",
+    noData: "No data available",
+    filters: "Filters",
+    results: "Results",
     error: "Error",
     errorLoadFailed: "Failed to load",
     errorSaveFailed: "Failed to save",
@@ -779,7 +810,16 @@ var commonMessages = defineMessages(
     unlimited: "unlimited",
     both: "Both",
     createFailed: "Creation failed",
-    noChanges: "No changes"
+    noChanges: "No changes",
+    paginator: {
+      label: "Pagination",
+      rowsPerPage: "Rows per page",
+      all: "All",
+      page: "Page {page}/{pages}",
+      pageInput: "Page, 1 to {pages}",
+      previous: "Previous page",
+      next: "Next page"
+    }
   }
 );
 
@@ -884,7 +924,7 @@ var discoveryMessages = defineMessages(
     quota: {
       usageProvider: "UsageProvider",
       usageProviderMissing: "fehlt",
-      noUsageProviderWarning: "Eine harte Quota ohne UsageProvider ist nicht deploy-f\xE4hig (Preflight, SPEC_V2 \xA76.3).",
+      noUsageProviderWarning: "Eine harte Quota ohne UsageProvider ist nicht deploy-f\xE4hig (Preflight).",
       outdatedBanner: "Die code-abgeleiteten Quota-Fakten (Einheit/Enforcement/Provider) haben sich seit der letzten Freigabe ge\xE4ndert \u2014 bitte pr\xFCfen und"
     },
     caps: {
@@ -988,7 +1028,7 @@ var discoveryMessages = defineMessages(
     quota: {
       usageProvider: "UsageProvider",
       usageProviderMissing: "missing",
-      noUsageProviderWarning: "A hard quota without a UsageProvider is not deployable (preflight, SPEC_V2 \xA76.3).",
+      noUsageProviderWarning: "A hard quota without a UsageProvider is not deployable (preflight).",
       outdatedBanner: "The code-derived quota facts (unit/enforcement/provider) have changed since the last approval \u2014 please review and"
     },
     caps: {
@@ -1148,8 +1188,7 @@ var marketingMessages = defineMessages(
       localesLabel: "Sprachen:",
       defaultLocale: "Default-Sprache",
       deactivateLocale: "Sprache deaktivieren",
-      addLocale: "+ Sprache",
-      refresh: "Aktualisieren"
+      addLocale: "+ Sprache"
     },
     page: {
       loading: "Lade Marketing-Catalog \u2026",
@@ -1217,7 +1256,7 @@ var marketingMessages = defineMessages(
     },
     promotionsTab: {
       title: "Aktionen & Rabatte",
-      subtitle: "Zeitlich begrenzte Preis-Aktionen \u2014 \xFCberschreiben den regul\xE4ren Preis auf der Pricing-Page (SPEC_V2 \xA79a).",
+      subtitle: "Zeitlich begrenzte Preis-Aktionen \u2014 \xFCberschreiben den regul\xE4ren Preis auf der Pricing-Page.",
       add: "+ Aktion anlegen",
       timelineHead: "Aktions-Timeline \xB7 gestrichelt = heute",
       today: "heute",
@@ -1276,8 +1315,7 @@ var marketingMessages = defineMessages(
       localesLabel: "Languages:",
       defaultLocale: "Default language",
       deactivateLocale: "Deactivate language",
-      addLocale: "+ Language",
-      refresh: "Refresh"
+      addLocale: "+ Language"
     },
     page: {
       loading: "Loading marketing catalog \u2026",
@@ -1345,7 +1383,7 @@ var marketingMessages = defineMessages(
     },
     promotionsTab: {
       title: "Promotions & discounts",
-      subtitle: "Time-limited price promotions \u2014 they override the regular price on the pricing page (SPEC_V2 \xA79a).",
+      subtitle: "Time-limited price promotions \u2014 they override the regular price on the pricing page.",
       add: "+ Create promotion",
       timelineHead: "Promotion timeline \xB7 dashed = today",
       today: "today",
@@ -1660,10 +1698,8 @@ var planDetailMessages = defineMessages(
       versionsSummary: "{published} live/superseded",
       versionsSummaryWithDrafts: "{published} live/superseded \xB7 {drafts} Draft",
       openDraft: "Offener Draft",
-      noDraft: "Kein Draft",
       readyToEdit: "Bereit zum Bearbeiten",
-      noOpenDraft: "Keine Draft-Version offen",
-      createNewDraft: "Neue Draft anlegen"
+      noOpenDraft: "Keine Draft-Version offen"
     },
     versions: {
       title: "Versionen",
@@ -1787,10 +1823,8 @@ var planDetailMessages = defineMessages(
       versionsSummary: "{published} live/superseded",
       versionsSummaryWithDrafts: "{published} live/superseded \xB7 {drafts} draft",
       openDraft: "Open draft",
-      noDraft: "No draft",
       readyToEdit: "Ready to edit",
-      noOpenDraft: "No draft version open",
-      createNewDraft: "Create a new draft"
+      noOpenDraft: "No draft version open"
     },
     versions: {
       title: "Versions",
@@ -2177,6 +2211,7 @@ var plansMessages = defineMessages(
     // PlansPage — shell of the plan area: loading state, toasts and the
     // error texts of the draft/publish/archive/discard actions.
     page: {
+      subtitle: "Pl\xE4ne b\xFCndeln Features & Quotas zu einem Angebot. Jede \xC4nderung wird als neue Version ver\xF6ffentlicht \u2014 Live-Versionen bleiben unangetastet.",
       loading: "Pl\xE4ne werden geladen\u2026",
       toastPlanCreated: "Plan {planKey} angelegt \u2014 jetzt die erste Version zusammenstellen.",
       toastDraftSaved: "Draft v{version} von {planKey} gespeichert.",
@@ -2223,7 +2258,10 @@ var plansMessages = defineMessages(
     // PlanList — default plan overview with one row per plan.
     list: {
       title: "Alle Pl\xE4ne",
-      summary: "{plans} Pl\xE4ne \xB7 {live} live \xB7 {drafts} offene Drafts \xB7 {tenants} Mandanten zugeordnet",
+      statPlans: "Pl\xE4ne",
+      statLive: "Live",
+      statDrafts: "Offene Drafts",
+      statTenants: "Mandanten",
       matrixView: "Matrix-Ansicht",
       newPlan: "Neuer Plan",
       searchPlaceholder: "Plan suchen\u2026",
@@ -2261,7 +2299,10 @@ var plansMessages = defineMessages(
     // PlanMatrix — all plans side by side, components as rows.
     matrix: {
       title: "Pl\xE4ne \xB7 Matrix-Vergleich",
-      summary: "Alle Pl\xE4ne nebeneinander \xB7 {plans} Pl\xE4ne \xB7 {features} Features \xB7 {quotas} Quotas \xB7 {bundles} Bundles",
+      statPlans: "Pl\xE4ne",
+      statFeatures: "Features",
+      statQuotas: "Quotas",
+      statBundles: "Bundles",
       catalogPreview: "Catalog-Vorschau",
       createPlan: "Plan anlegen",
       createPlanSub: "oder Klon erstellen",
@@ -2402,6 +2443,7 @@ var plansMessages = defineMessages(
   },
   {
     page: {
+      subtitle: "Plans bundle features & quotas into an offering. Every change ships as a new version \u2014 live versions stay untouched.",
       loading: "Loading plans\u2026",
       toastPlanCreated: "Plan {planKey} created \u2014 now assemble the first version.",
       toastDraftSaved: "Draft v{version} of {planKey} saved.",
@@ -2446,7 +2488,10 @@ var plansMessages = defineMessages(
     },
     list: {
       title: "All plans",
-      summary: "{plans} plans \xB7 {live} live \xB7 {drafts} open drafts \xB7 {tenants} tenants assigned",
+      statPlans: "Plans",
+      statLive: "Live",
+      statDrafts: "Open drafts",
+      statTenants: "Tenants",
       matrixView: "Matrix view",
       newPlan: "New plan",
       searchPlaceholder: "Search plan\u2026",
@@ -2483,7 +2528,10 @@ var plansMessages = defineMessages(
     },
     matrix: {
       title: "Plans \xB7 matrix comparison",
-      summary: "All plans side by side \xB7 {plans} plans \xB7 {features} features \xB7 {quotas} quotas \xB7 {bundles} bundles",
+      statPlans: "Plans",
+      statFeatures: "Features",
+      statQuotas: "Quotas",
+      statBundles: "Bundles",
       catalogPreview: "Catalog preview",
       createPlan: "Create plan",
       createPlanSub: "or create a clone",
@@ -2972,8 +3020,7 @@ var tenantsMessages = defineMessages(
       columnUsage: "Verbrauch",
       columnCreatedAt: "Angelegt",
       suspended: "Suspendiert",
-      empty: "Keine Mandanten mit diesen Filtern.",
-      pagination: "{total} Mandanten \xB7 Seite {page} / {pages}"
+      empty: "Keine Mandanten mit diesen Filtern."
     },
     detail: {
       backToList: "Mandanten-Liste",
@@ -3021,8 +3068,7 @@ var tenantsMessages = defineMessages(
       columnUsage: "Usage",
       columnCreatedAt: "Created",
       suspended: "Suspended",
-      empty: "No tenants match these filters.",
-      pagination: "{total} tenants \xB7 Page {page} / {pages}"
+      empty: "No tenants match these filters."
     },
     detail: {
       backToList: "Tenant list",
@@ -3280,6 +3326,9 @@ function createSuperAdminApp(options) {
   if (options.manifestGuard?.getManifest) {
     app.provide(SUPER_ADMIN_MANIFEST_KEY, options.manifestGuard.getManifest);
   }
+  if (options.manifestGuard?.clearCache) {
+    app.provide(SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY, options.manifestGuard.clearCache);
+  }
   if (options.loginAdapter) {
     app.provide(SUPER_ADMIN_LOGIN_ADAPTER_KEY, options.loginAdapter);
   }

package/dist/quasar/index.d.cts

@@ -2,8 +2,8 @@ import { Component, App } from 'vue';
 import { QuasarPluginOptions } from 'quasar';
 import { Pinia } from 'pinia';
 import { RouteRecordRaw, RouterHistory, Router } from 'vue-router';
-import { H as HttpClient } from '../catalog-JXdKdIqG.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-1nCOkvgi.cjs';
+import { H as HttpClient } from '../catalog-DJcfm5N2.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-CgTuNi8h.cjs';
 import '@saasicat/types';
 
 interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {

package/dist/quasar/index.d.ts

@@ -2,8 +2,8 @@ import { Component, App } from 'vue';
 import { QuasarPluginOptions } from 'quasar';
 import { Pinia } from 'pinia';
 import { RouteRecordRaw, RouterHistory, Router } from 'vue-router';
-import { H as HttpClient } from '../catalog-JXdKdIqG.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-BlqcD0N7.js';
+import { H as HttpClient } from '../catalog-DJcfm5N2.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-CHNdsSlm.js';
 import '@saasicat/types';
 
 interface CreateSuperAdminAppOptions extends SuperAdminGuardOptions {

package/dist/quasar/index.js

@@ -6,14 +6,15 @@ import {
   SUPER_ADMIN_HTTP_KEY,
   SUPER_ADMIN_I18N_KEY,
   SUPER_ADMIN_LOGIN_ADAPTER_KEY,
+  SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY,
   SUPER_ADMIN_MANIFEST_KEY,
   SUPER_ADMIN_NOTIFY_KEY,
   buildNavigationGuard,
   createSuperAdminI18n
-} from "../chunk-RVG6LQHL.js";
+} from "../chunk-LY52T4N4.js";
 import {
   defaultHttpClient
-} from "../chunk-DPTIOQXX.js";
+} from "../chunk-F7NRM6KI.js";
 
 // src/quasar/create-super-admin-app.ts
 import { createApp } from "vue";
@@ -74,6 +75,9 @@ function createSuperAdminApp(options) {
   if (options.manifestGuard?.getManifest) {
     app.provide(SUPER_ADMIN_MANIFEST_KEY, options.manifestGuard.getManifest);
   }
+  if (options.manifestGuard?.clearCache) {
+    app.provide(SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY, options.manifestGuard.clearCache);
+  }
   if (options.loginAdapter) {
     app.provide(SUPER_ADMIN_LOGIN_ADAPTER_KEY, options.loginAdapter);
   }

package/dist/testing-e2e/admin-pages-suite.d.cts

@@ -0,0 +1,37 @@
+import { test, expect } from '@playwright/test';
+
+interface AdminPagesSuiteConfig {
+    /** Display name, e.g. 'demoapp' / 'clubapp'. */
+    appName: string;
+    /** URL of the login page (full). */
+    loginUrl: string;
+    /** Test account. */
+    email: string;
+    password: string;
+    /** Paths the smoke test should click through. */
+    pages: ReadonlyArray<{
+        /** Display name in the test description. */
+        name: string;
+        /** Path relative to the origin (e.g. '/admin/tenants'). */
+        path: string;
+        /** Optional: if set, check that this selector exists. */
+        expectVisible?: string;
+        /** Optional: HTTP patterns that are OK as 4xx/5xx (e.g. missing backend endpoints). */
+        allowedFailures?: readonly RegExp[];
+    }>;
+    /** Expected KPI card labels on the dashboard page. */
+    expectedKpiLabels: readonly string[];
+    /** Expected distribution section titles. */
+    expectedDistributionTitles?: readonly string[];
+    /** Expected shortcut titles on the dashboard. */
+    expectedShortcutTitles: readonly string[];
+    /** Shortcuts that must NOT appear (e.g. "Dashboard"). */
+    forbiddenShortcutTitles?: readonly string[];
+    /** Console error patterns that should be ignored. */
+    consoleErrorAllowlist?: readonly RegExp[];
+    /** Path to the dashboard page (default `/admin/`). */
+    dashboardPath?: string;
+}
+declare function runAdminPagesSuite(test: typeof test, expect: typeof expect, config: AdminPagesSuiteConfig): void;
+
+export { type AdminPagesSuiteConfig, runAdminPagesSuite };

package/dist/testing-e2e/admin-pages-suite.d.ts

@@ -0,0 +1,37 @@
+import { test, expect } from '@playwright/test';
+
+interface AdminPagesSuiteConfig {
+    /** Display name, e.g. 'demoapp' / 'clubapp'. */
+    appName: string;
+    /** URL of the login page (full). */
+    loginUrl: string;
+    /** Test account. */
+    email: string;
+    password: string;
+    /** Paths the smoke test should click through. */
+    pages: ReadonlyArray<{
+        /** Display name in the test description. */
+        name: string;
+        /** Path relative to the origin (e.g. '/admin/tenants'). */
+        path: string;
+        /** Optional: if set, check that this selector exists. */
+        expectVisible?: string;
+        /** Optional: HTTP patterns that are OK as 4xx/5xx (e.g. missing backend endpoints). */
+        allowedFailures?: readonly RegExp[];
+    }>;
+    /** Expected KPI card labels on the dashboard page. */
+    expectedKpiLabels: readonly string[];
+    /** Expected distribution section titles. */
+    expectedDistributionTitles?: readonly string[];
+    /** Expected shortcut titles on the dashboard. */
+    expectedShortcutTitles: readonly string[];
+    /** Shortcuts that must NOT appear (e.g. "Dashboard"). */
+    forbiddenShortcutTitles?: readonly string[];
+    /** Console error patterns that should be ignored. */
+    consoleErrorAllowlist?: readonly RegExp[];
+    /** Path to the dashboard page (default `/admin/`). */
+    dashboardPath?: string;
+}
+declare function runAdminPagesSuite(test: typeof test, expect: typeof expect, config: AdminPagesSuiteConfig): void;
+
+export { type AdminPagesSuiteConfig, runAdminPagesSuite };

package/dist/{use-super-admin-i18n-BlqcD0N7.d.ts → use-super-admin-i18n-CHNdsSlm.d.ts}

@@ -1,7 +1,7 @@
 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 SaLocaleOption, c as SaLocaleDefinition, d as SaMessagesOverrides, K as KvStore } from './catalog-JXdKdIqG.js';
+import { A as ActionHandler, H as HttpClient, S as SaLocale, a as SaMessages, b as SaLocaleOption, c as SaLocaleDefinition, d as SaMessagesOverrides, K as KvStore } from './catalog-DJcfm5N2.js';
 
 /**
  * App-specific branding data that the platform `AdminLayout` and other
@@ -70,6 +70,17 @@ interface SuperAdminLoginAdapter {
      * storage, MFA hops etc.
      */
     login(email: string, password: string): Promise<SuperAdminLoginResult>;
+    /**
+     * Undoes what `login` established — token, session storage, app store.
+     *
+     * Whoever knows how to start a session is the only one who knows how to
+     * end it, so it belongs next to `login` rather than in a second seam. The
+     * platform's own sign-out affordances call it; without it they can only
+     * navigate to `/login`, and an app whose `isAuthenticated()` reads a
+     * surviving token lets the operator straight back in — a sign-out button
+     * that does not sign out.
+     */
+    logout?(): void | Promise<void>;
     /**
      * Target route after a successful login. Default: `/admin/dashboard`
      * (platform convention for the standard pages — apps with a different
@@ -112,6 +123,20 @@ interface SuperAdminManifestGuardOptions {
      * manifest guard again and produces a redirect loop.
      */
     errorRoute?: string;
+    /**
+     * Discards the cached manifest, so the next `ensureLoaded()` fetches a
+     * fresh body instead of revalidating.
+     *
+     * Needed because the loader keeps an ETag in storage. Its own documented
+     * failure — "server returned 304 but the cache body is missing" — survives
+     * a full page reload: the next request sends the same `If-None-Match`,
+     * gets another 304, and lands back on the error page. Retry is a dead end
+     * for that case unless something clears the ETag first.
+     *
+     * `ManifestLoader.clearCache()` and the manifest store's reset both fit;
+     * pass whichever the app uses.
+     */
+    clearCache?: () => void | Promise<void>;
 }
 /**
  * Guard configuration shared by `buildNavigationGuard()` and
@@ -143,6 +168,13 @@ declare const SUPER_ADMIN_ACTIONS_KEY: InjectionKey<ActionsMap>;
  * `<ProjectPageHost>` needs it to resolve project pages.
  */
 declare const SUPER_ADMIN_MANIFEST_KEY: InjectionKey<() => AdminManifest | null>;
+/**
+ * Vue inject key for `manifestGuard.clearCache`.
+ *
+ * The fail-closed error page is route-mounted and gets no props, so the only
+ * way it can reach the app's cache is through the shell.
+ */
+declare const SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY: InjectionKey<() => void | Promise<void>>;
 /** Vue inject key for `useSuperAdminLoginAdapter()`. */
 declare const SUPER_ADMIN_LOGIN_ADAPTER_KEY: InjectionKey<SuperAdminLoginAdapter>;
 /** Vue inject key for `useSuperAdminHttp()` (pre-login HttpClient). */
@@ -152,11 +184,6 @@ declare const SUPER_ADMIN_HTTP_KEY: InjectionKey<HttpClient>;
  * 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;
 
 /**
@@ -253,4 +280,4 @@ declare function useSuperAdminI18n(): SuperAdminI18n;
  */
 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, SA_LOCALE_STORAGE_KEY as g, SUPER_ADMIN_ACTIONS_KEY as h, SUPER_ADMIN_BRAND_KEY as i, SUPER_ADMIN_ENDPOINTS_KEY as j, SUPER_ADMIN_EXTENSIONS_KEY as k, SUPER_ADMIN_HTTP_KEY as l, SUPER_ADMIN_I18N_KEY as m, SUPER_ADMIN_LOGIN_ADAPTER_KEY as n, SUPER_ADMIN_MANIFEST_KEY as o, SUPER_ADMIN_NOTIFY_KEY as p, type SuperAdminAuthGuardOptions as q, type SuperAdminLoginResult as r, type SuperAdminManifestGuardOptions as s, type UiNotifyKind as t, type UiNotifyOptions as u, buildNavigationGuard as v, createSuperAdminI18n as w, useSaMessages as x, useSuperAdminI18n as y };
+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, SA_LOCALE_STORAGE_KEY as g, SUPER_ADMIN_ACTIONS_KEY as h, SUPER_ADMIN_BRAND_KEY as i, SUPER_ADMIN_ENDPOINTS_KEY as j, SUPER_ADMIN_EXTENSIONS_KEY as k, SUPER_ADMIN_HTTP_KEY as l, SUPER_ADMIN_I18N_KEY as m, SUPER_ADMIN_LOGIN_ADAPTER_KEY as n, SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY as o, SUPER_ADMIN_MANIFEST_KEY as p, SUPER_ADMIN_NOTIFY_KEY as q, type SuperAdminAuthGuardOptions as r, type SuperAdminLoginResult as s, type SuperAdminManifestGuardOptions as t, type UiNotifyKind as u, type UiNotifyOptions as v, buildNavigationGuard as w, createSuperAdminI18n as x, useSaMessages as y, useSuperAdminI18n as z };

package/dist/{use-super-admin-i18n-1nCOkvgi.d.cts → use-super-admin-i18n-CgTuNi8h.d.cts}

@@ -1,7 +1,7 @@
 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 SaLocaleOption, c as SaLocaleDefinition, d as SaMessagesOverrides, K as KvStore } from './catalog-JXdKdIqG.cjs';
+import { A as ActionHandler, H as HttpClient, S as SaLocale, a as SaMessages, b as SaLocaleOption, c as SaLocaleDefinition, d as SaMessagesOverrides, K as KvStore } from './catalog-DJcfm5N2.cjs';
 
 /**
  * App-specific branding data that the platform `AdminLayout` and other
@@ -70,6 +70,17 @@ interface SuperAdminLoginAdapter {
      * storage, MFA hops etc.
      */
     login(email: string, password: string): Promise<SuperAdminLoginResult>;
+    /**
+     * Undoes what `login` established — token, session storage, app store.
+     *
+     * Whoever knows how to start a session is the only one who knows how to
+     * end it, so it belongs next to `login` rather than in a second seam. The
+     * platform's own sign-out affordances call it; without it they can only
+     * navigate to `/login`, and an app whose `isAuthenticated()` reads a
+     * surviving token lets the operator straight back in — a sign-out button
+     * that does not sign out.
+     */
+    logout?(): void | Promise<void>;
     /**
      * Target route after a successful login. Default: `/admin/dashboard`
      * (platform convention for the standard pages — apps with a different
@@ -112,6 +123,20 @@ interface SuperAdminManifestGuardOptions {
      * manifest guard again and produces a redirect loop.
      */
     errorRoute?: string;
+    /**
+     * Discards the cached manifest, so the next `ensureLoaded()` fetches a
+     * fresh body instead of revalidating.
+     *
+     * Needed because the loader keeps an ETag in storage. Its own documented
+     * failure — "server returned 304 but the cache body is missing" — survives
+     * a full page reload: the next request sends the same `If-None-Match`,
+     * gets another 304, and lands back on the error page. Retry is a dead end
+     * for that case unless something clears the ETag first.
+     *
+     * `ManifestLoader.clearCache()` and the manifest store's reset both fit;
+     * pass whichever the app uses.
+     */
+    clearCache?: () => void | Promise<void>;
 }
 /**
  * Guard configuration shared by `buildNavigationGuard()` and
@@ -143,6 +168,13 @@ declare const SUPER_ADMIN_ACTIONS_KEY: InjectionKey<ActionsMap>;
  * `<ProjectPageHost>` needs it to resolve project pages.
  */
 declare const SUPER_ADMIN_MANIFEST_KEY: InjectionKey<() => AdminManifest | null>;
+/**
+ * Vue inject key for `manifestGuard.clearCache`.
+ *
+ * The fail-closed error page is route-mounted and gets no props, so the only
+ * way it can reach the app's cache is through the shell.
+ */
+declare const SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY: InjectionKey<() => void | Promise<void>>;
 /** Vue inject key for `useSuperAdminLoginAdapter()`. */
 declare const SUPER_ADMIN_LOGIN_ADAPTER_KEY: InjectionKey<SuperAdminLoginAdapter>;
 /** Vue inject key for `useSuperAdminHttp()` (pre-login HttpClient). */
@@ -152,11 +184,6 @@ declare const SUPER_ADMIN_HTTP_KEY: InjectionKey<HttpClient>;
  * 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;
 
 /**
@@ -253,4 +280,4 @@ declare function useSuperAdminI18n(): SuperAdminI18n;
  */
 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, SA_LOCALE_STORAGE_KEY as g, SUPER_ADMIN_ACTIONS_KEY as h, SUPER_ADMIN_BRAND_KEY as i, SUPER_ADMIN_ENDPOINTS_KEY as j, SUPER_ADMIN_EXTENSIONS_KEY as k, SUPER_ADMIN_HTTP_KEY as l, SUPER_ADMIN_I18N_KEY as m, SUPER_ADMIN_LOGIN_ADAPTER_KEY as n, SUPER_ADMIN_MANIFEST_KEY as o, SUPER_ADMIN_NOTIFY_KEY as p, type SuperAdminAuthGuardOptions as q, type SuperAdminLoginResult as r, type SuperAdminManifestGuardOptions as s, type UiNotifyKind as t, type UiNotifyOptions as u, buildNavigationGuard as v, createSuperAdminI18n as w, useSaMessages as x, useSuperAdminI18n as y };
+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, SA_LOCALE_STORAGE_KEY as g, SUPER_ADMIN_ACTIONS_KEY as h, SUPER_ADMIN_BRAND_KEY as i, SUPER_ADMIN_ENDPOINTS_KEY as j, SUPER_ADMIN_EXTENSIONS_KEY as k, SUPER_ADMIN_HTTP_KEY as l, SUPER_ADMIN_I18N_KEY as m, SUPER_ADMIN_LOGIN_ADAPTER_KEY as n, SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY as o, SUPER_ADMIN_MANIFEST_KEY as p, SUPER_ADMIN_NOTIFY_KEY as q, type SuperAdminAuthGuardOptions as r, type SuperAdminLoginResult as s, type SuperAdminManifestGuardOptions as t, type UiNotifyKind as u, type UiNotifyOptions as v, buildNavigationGuard as w, createSuperAdminI18n as x, useSaMessages as y, useSuperAdminI18n as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/ui-vue",
-  "version": "0.19.0",
+  "version": "0.22.0",
   "description": "Vue 3 components, resource clients and composables for the SuperAdmin UI shell. Provides boot and manifest loaders, navigation, actions and standard pages.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -43,9 +43,14 @@
     "./components/*": "./src/components/*",
     "./sa-theme.css": "./src/pages-standard/sa-theme.css",
     "./testing-e2e/*": {
-      "types": "./dist/testing-e2e/*.d.ts",
-      "import": "./dist/testing-e2e/*.js",
-      "require": "./dist/testing-e2e/*.cjs"
+      "import": {
+        "types": "./dist/testing-e2e/*.d.ts",
+        "default": "./dist/testing-e2e/*.js"
+      },
+      "require": {
+        "types": "./dist/testing-e2e/*.d.cts",
+        "default": "./dist/testing-e2e/*.cjs"
+      }
     }
   },
   "files": [
@@ -53,7 +58,7 @@
     "src"
   ],
   "dependencies": {
-    "@saasicat/types": "^0.19.0"
+    "@saasicat/types": "^0.22.0"
   },
   "peerDependencies": {
     "pinia": "^2.0.0 || ^3.0.0",
@@ -74,14 +79,17 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.59.1",
+    "@quasar/vite-plugin": "^1.12.0",
     "@types/node": "^25.6.0",
     "@vitejs/plugin-vue": "^6.0.8",
     "@vue/test-utils": "^2.4.11",
     "jsdom": "^30.0.1",
     "pinia": "^3.0.0",
     "quasar": "^2.24.0",
+    "sass": "^1.101.3",
     "tsup": "^8.0.0",
     "typescript": "^6.0.0",
+    "vite": "^7.3.6",
     "vitest": "^4.1.10",
     "vue": "^3.5.0",
     "vue-router": "^5.0.0",
@@ -102,11 +110,13 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
-    "typecheck": "vue-tsc --noEmit -p tsconfig.json",
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json && vue-tsc --noEmit -p tsconfig.tests.json",
     "pretest": "pnpm run build",
     "test": "node --test tests/**/*.test.js",
     "test:component": "vitest run --config vitest.config.ts",
-    "test:e2e": "playwright test"
+    "test:e2e": "playwright test",
+    "test:visual": "playwright test --project=visual",
+    "test:visual:update": "playwright test --project=visual --update-snapshots"
   }
 }

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

@@ -40,7 +40,6 @@ export const bundlesMessages = defineMessages(
                 'Produktgruppen aus Features & Quotas — verwendet in Plänen. Bundles werden im SuperAdmin kuratiert.',
             displayLocale: 'Anzeige-Sprache',
             newBundle: 'Neues Bundle',
-            reload: 'Liste neu laden',
         },
         filter: {
             all: 'Alle Status',
@@ -271,7 +270,6 @@ export const bundlesMessages = defineMessages(
                 'Product groups made of features & quotas — used in plans. Bundles are curated in the SuperAdmin.',
             displayLocale: 'Display language',
             newBundle: 'New bundle',
-            reload: 'Reload list',
         },
         filter: {
             all: 'All statuses',