@saasicat/ui-vue 0.15.1 → 0.17.0

package/dist/client/index.d.cts

@@ -1,5 +1,5 @@
-import { H as HttpClient, K as KvStore, S as SaLocale } from '../messages-BIYw32u1.cjs';
-export { d as ActionDefNotInManifestError, A as ActionHandler, c as ActionRegistry, D as DEFAULT_SA_LOCALE, e as HttpResponse, M as MessageTree, f as MissingHandlerError, P as PartialMessages, R as ResolvedAction, g as SA_INTL_LOCALES, h as SA_LOCALES, i as SA_MESSAGES, a as SaMessages, b as SaMessagesOverrides, T as TranslationOf, j as defaultHttpClient, k as defaultKvStore, l as defineMessages, m as mergeMessages, r as resolveMessages } from '../messages-BIYw32u1.cjs';
+import { H as HttpClient, K as KvStore, S as SaLocale, x as SaNavMessages } from '../catalog-C4Gv2_KM.cjs';
+export { f as ActionDefNotInManifestError, A as ActionHandler, e as ActionRegistry, D as DEFAULT_SA_LOCALE, g as HttpResponse, M as MessageTree, h as MissingHandlerError, P as PartialMessages, R as ResolvedAction, i as SA_INTL_LOCALES, j as SA_LOCALES, k as SA_LOCALE_LABELS, l as SA_MESSAGES, m as SaBuiltinLocale, n as SaCatalog, o as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TranslationOf, p as builtinLocaleOf, q as createSaCatalog, r as defaultHttpClient, s as defaultKvStore, t as defineMessages, u as isSaBuiltinLocale, v as mergeMessages, w as resolveMessages } from '../catalog-C4Gv2_KM.cjs';
 import { PublicBootResponse, AdminManifest, StandardPageKey, TenantColumnDef, PromoCodeRecord, AdminTenantDetail, AdminUserListFilter, AdminUserListRow, AdminAuditListFilter, AuditEntry, AdminSubscriptionListRow } from '@saasicat/types';
 
 declare const ADMIN_UI_VERSION = "1.2.0";
@@ -122,8 +122,17 @@ interface NavBuilderOptions {
      * UI locale for the default labels and section names, default `'de'`.
      * Pass the same locale to `buildSidebar()`'s `sectionOrder` (via
      * `defaultSectionOrder(locale)`) — section names are compared as strings.
+     *
+     * Only resolves the two catalogs the platform ships. Prefer `nav`, which
+     * carries app overrides and app-supplied languages as well.
      */
     locale?: SaLocale;
+    /**
+     * Resolved `nav` namespace, as `useSuperAdminI18n().messages.value.nav`
+     * hands it out. Wins over `locale`, and is the only way the sidebar sees
+     * `i18n.overrides` or a language the app added itself.
+     */
+    nav?: SaNavMessages;
     /**
      * Optional: overrides the default routes for certain standard pages.
      * Consumers set this if they want an alternative URL structure.
@@ -149,9 +158,11 @@ interface NavBuilderOptions {
 /**
  * Localized default section names in drawer order (Übersicht → Produktkatalog
  * → Kunden → System). Pass the result to `buildSidebar()` when building routes
- * with a non-default locale.
+ * with a non-default locale, or hand it the resolved `nav` catalog directly —
+ * section names are compared as strings, so both sides must come from the same
+ * source.
  */
-declare function defaultSectionOrder(locale?: SaLocale): readonly string[];
+declare function defaultSectionOrder(locale?: SaLocale | SaNavMessages): readonly string[];
 /**
  * Returns the list of all routes defined by the current manifest —
  * filtered to the capabilities that the logged-in user has.
@@ -293,4 +304,39 @@ declare function formatMessage(template: string, params: MessageParams): string;
  */
 declare function formatCurrency(amount: number | string | null | undefined, locale?: SaLocale, currency?: string): string;
 
-export { ADMIN_UI_VERSION, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type BatchColumnData, BatchColumnDriftError, BatchColumnFetcher, type BatchColumnFetcherOptions, type BatchColumnRow, type BatchColumnValue, BootLoadError, BootLoader, type BootLoaderOptions, type BuildRouteEntry, type CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpClient, HttpJsonError, KvStore, ManifestLoadError, ManifestLoader, type ManifestLoaderOptions, type MessageParams, type NavBuilderOptions, type ParamStyle, SaLocale, type SidebarItem, type SidebarSection, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, postJson, resolveExtension, trimTrailingSlashes };
+/** The slice of the public boot response these cards read. */
+interface LoginBootProject {
+    displayName?: string | null;
+    label?: string | null;
+    icon?: string | null;
+    logoUrl?: string | null;
+    environment?: string | null;
+}
+/** App-configured branding, used wherever boot says nothing. */
+interface LoginBrandFallback {
+    name?: string;
+    tag?: string;
+    logoText?: string;
+}
+interface LoginBranding {
+    name: string;
+    tag: string;
+    icon: string;
+    logoUrl: string | null;
+    /** Environment worth showing, i.e. anything but production. `null` hides it. */
+    environment: string | null;
+}
+/**
+ * `boot` is whatever the endpoint returned — possibly `null`, possibly an
+ * object without `project`. Both are treated as "boot said nothing" rather
+ * than as a reason to fail.
+ */
+declare function resolveLoginBranding(boot: {
+    project?: LoginBootProject | null;
+} | null | undefined, fallback?: LoginBrandFallback): LoginBranding;
+/** Test credentials must never be printed in production, whatever boot omits. */
+declare function isProductionBoot(boot: {
+    project?: LoginBootProject | null;
+} | null | undefined): boolean;
+
+export { ADMIN_UI_VERSION, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type BatchColumnData, BatchColumnDriftError, BatchColumnFetcher, type BatchColumnFetcherOptions, type BatchColumnRow, type BatchColumnValue, BootLoadError, BootLoader, type BootLoaderOptions, type BuildRouteEntry, type CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpClient, HttpJsonError, KvStore, type LoginBootProject, type LoginBrandFallback, type LoginBranding, ManifestLoadError, ManifestLoader, type ManifestLoaderOptions, type MessageParams, type NavBuilderOptions, type ParamStyle, SaLocale, type SidebarItem, type SidebarSection, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, isProductionBoot, postJson, resolveExtension, resolveLoginBranding, trimTrailingSlashes };

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HttpClient, K as KvStore, S as SaLocale } from '../messages-BIYw32u1.js';
-export { d as ActionDefNotInManifestError, A as ActionHandler, c as ActionRegistry, D as DEFAULT_SA_LOCALE, e as HttpResponse, M as MessageTree, f as MissingHandlerError, P as PartialMessages, R as ResolvedAction, g as SA_INTL_LOCALES, h as SA_LOCALES, i as SA_MESSAGES, a as SaMessages, b as SaMessagesOverrides, T as TranslationOf, j as defaultHttpClient, k as defaultKvStore, l as defineMessages, m as mergeMessages, r as resolveMessages } from '../messages-BIYw32u1.js';
+import { H as HttpClient, K as KvStore, S as SaLocale, x as SaNavMessages } from '../catalog-C4Gv2_KM.js';
+export { f as ActionDefNotInManifestError, A as ActionHandler, e as ActionRegistry, D as DEFAULT_SA_LOCALE, g as HttpResponse, M as MessageTree, h as MissingHandlerError, P as PartialMessages, R as ResolvedAction, i as SA_INTL_LOCALES, j as SA_LOCALES, k as SA_LOCALE_LABELS, l as SA_MESSAGES, m as SaBuiltinLocale, n as SaCatalog, o as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TranslationOf, p as builtinLocaleOf, q as createSaCatalog, r as defaultHttpClient, s as defaultKvStore, t as defineMessages, u as isSaBuiltinLocale, v as mergeMessages, w as resolveMessages } from '../catalog-C4Gv2_KM.js';
 import { PublicBootResponse, AdminManifest, StandardPageKey, TenantColumnDef, PromoCodeRecord, AdminTenantDetail, AdminUserListFilter, AdminUserListRow, AdminAuditListFilter, AuditEntry, AdminSubscriptionListRow } from '@saasicat/types';
 
 declare const ADMIN_UI_VERSION = "1.2.0";
@@ -122,8 +122,17 @@ interface NavBuilderOptions {
      * UI locale for the default labels and section names, default `'de'`.
      * Pass the same locale to `buildSidebar()`'s `sectionOrder` (via
      * `defaultSectionOrder(locale)`) — section names are compared as strings.
+     *
+     * Only resolves the two catalogs the platform ships. Prefer `nav`, which
+     * carries app overrides and app-supplied languages as well.
      */
     locale?: SaLocale;
+    /**
+     * Resolved `nav` namespace, as `useSuperAdminI18n().messages.value.nav`
+     * hands it out. Wins over `locale`, and is the only way the sidebar sees
+     * `i18n.overrides` or a language the app added itself.
+     */
+    nav?: SaNavMessages;
     /**
      * Optional: overrides the default routes for certain standard pages.
      * Consumers set this if they want an alternative URL structure.
@@ -149,9 +158,11 @@ interface NavBuilderOptions {
 /**
  * Localized default section names in drawer order (Übersicht → Produktkatalog
  * → Kunden → System). Pass the result to `buildSidebar()` when building routes
- * with a non-default locale.
+ * with a non-default locale, or hand it the resolved `nav` catalog directly —
+ * section names are compared as strings, so both sides must come from the same
+ * source.
  */
-declare function defaultSectionOrder(locale?: SaLocale): readonly string[];
+declare function defaultSectionOrder(locale?: SaLocale | SaNavMessages): readonly string[];
 /**
  * Returns the list of all routes defined by the current manifest —
  * filtered to the capabilities that the logged-in user has.
@@ -293,4 +304,39 @@ declare function formatMessage(template: string, params: MessageParams): string;
  */
 declare function formatCurrency(amount: number | string | null | undefined, locale?: SaLocale, currency?: string): string;
 
-export { ADMIN_UI_VERSION, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type BatchColumnData, BatchColumnDriftError, BatchColumnFetcher, type BatchColumnFetcherOptions, type BatchColumnRow, type BatchColumnValue, BootLoadError, BootLoader, type BootLoaderOptions, type BuildRouteEntry, type CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpClient, HttpJsonError, KvStore, ManifestLoadError, ManifestLoader, type ManifestLoaderOptions, type MessageParams, type NavBuilderOptions, type ParamStyle, SaLocale, type SidebarItem, type SidebarSection, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, postJson, resolveExtension, trimTrailingSlashes };
+/** The slice of the public boot response these cards read. */
+interface LoginBootProject {
+    displayName?: string | null;
+    label?: string | null;
+    icon?: string | null;
+    logoUrl?: string | null;
+    environment?: string | null;
+}
+/** App-configured branding, used wherever boot says nothing. */
+interface LoginBrandFallback {
+    name?: string;
+    tag?: string;
+    logoText?: string;
+}
+interface LoginBranding {
+    name: string;
+    tag: string;
+    icon: string;
+    logoUrl: string | null;
+    /** Environment worth showing, i.e. anything but production. `null` hides it. */
+    environment: string | null;
+}
+/**
+ * `boot` is whatever the endpoint returned — possibly `null`, possibly an
+ * object without `project`. Both are treated as "boot said nothing" rather
+ * than as a reason to fail.
+ */
+declare function resolveLoginBranding(boot: {
+    project?: LoginBootProject | null;
+} | null | undefined, fallback?: LoginBrandFallback): LoginBranding;
+/** Test credentials must never be printed in production, whatever boot omits. */
+declare function isProductionBoot(boot: {
+    project?: LoginBootProject | null;
+} | null | undefined): boolean;
+
+export { ADMIN_UI_VERSION, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type BatchColumnData, BatchColumnDriftError, BatchColumnFetcher, type BatchColumnFetcherOptions, type BatchColumnRow, type BatchColumnValue, BootLoadError, BootLoader, type BootLoaderOptions, type BuildRouteEntry, type CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpClient, HttpJsonError, KvStore, type LoginBootProject, type LoginBrandFallback, type LoginBranding, ManifestLoadError, ManifestLoader, type ManifestLoaderOptions, type MessageParams, type NavBuilderOptions, type ParamStyle, SaLocale, type SidebarItem, type SidebarSection, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, isProductionBoot, postJson, resolveExtension, resolveLoginBranding, trimTrailingSlashes };

package/dist/client/index.js

@@ -16,23 +16,29 @@ import {
   createAdminResourceClient,
   defaultSectionOrder,
   getJson,
+  isProductionBoot,
   postJson,
   resolveExtension,
+  resolveLoginBranding,
   trimTrailingSlashes
-} from "../chunk-66BUSVC5.js";
+} from "../chunk-XPSD5HKG.js";
 import {
   DEFAULT_SA_LOCALE,
   SA_INTL_LOCALES,
   SA_LOCALES,
+  SA_LOCALE_LABELS,
   SA_MESSAGES,
+  builtinLocaleOf,
+  createSaCatalog,
   defaultHttpClient,
   defaultKvStore,
   defineMessages,
   formatCurrency,
   formatMessage,
+  isSaBuiltinLocale,
   mergeMessages,
   resolveMessages
-} from "../chunk-TBLXKSTR.js";
+} from "../chunk-IZGFS5RS.js";
 export {
   ADMIN_UI_VERSION,
   ActionDefNotInManifestError,
@@ -49,10 +55,13 @@ export {
   MissingHandlerError,
   SA_INTL_LOCALES,
   SA_LOCALES,
+  SA_LOCALE_LABELS,
   SA_MESSAGES,
   buildRoutes,
   buildSidebar,
+  builtinLocaleOf,
   createAdminResourceClient,
+  createSaCatalog,
   defaultHttpClient,
   defaultKvStore,
   defaultSectionOrder,
@@ -60,9 +69,12 @@ export {
   formatCurrency,
   formatMessage,
   getJson,
+  isProductionBoot,
+  isSaBuiltinLocale,
   mergeMessages,
   postJson,
   resolveExtension,
+  resolveLoginBranding,
   resolveMessages,
   trimTrailingSlashes
 };

package/dist/index.cjs

@@ -48,6 +48,8 @@ __export(src_exports, {
   PromotionsApiError: () => PromotionsApiError,
   SA_INTL_LOCALES: () => SA_INTL_LOCALES,
   SA_LOCALES: () => SA_LOCALES,
+  SA_LOCALE_LABELS: () => SA_LOCALE_LABELS,
+  SA_LOCALE_STORAGE_KEY: () => SA_LOCALE_STORAGE_KEY,
   SA_MESSAGES: () => SA_MESSAGES,
   SUPER_ADMIN_ACTIONS_KEY: () => SUPER_ADMIN_ACTIONS_KEY,
   SUPER_ADMIN_BRAND_KEY: () => SUPER_ADMIN_BRAND_KEY,
@@ -65,11 +67,13 @@ __export(src_exports, {
   buildQuotaRegistry: () => buildQuotaRegistry,
   buildRoutes: () => buildRoutes,
   buildSidebar: () => buildSidebar,
+  builtinLocaleOf: () => builtinLocaleOf,
   createAdminResourceClient: () => createAdminResourceClient,
   createAdminRoutes: () => createAdminRoutes,
   createManifestStore: () => createManifestStore,
   createPlatformLoaders: () => createPlatformLoaders,
   createProjectPageHostRoute: () => createProjectPageHostRoute,
+  createSaCatalog: () => createSaCatalog,
   createSuperAdminI18n: () => createSuperAdminI18n,
   defaultHttpClient: () => defaultHttpClient,
   defaultIconForActionKey: () => defaultIconForActionKey,
@@ -81,10 +85,13 @@ __export(src_exports, {
   formatCurrency: () => formatCurrency,
   formatMessage: () => formatMessage,
   getJson: () => getJson,
+  isProductionBoot: () => isProductionBoot,
+  isSaBuiltinLocale: () => isSaBuiltinLocale,
   mergeMessages: () => mergeMessages,
   postJson: () => postJson,
   provideEntitlement: () => provideEntitlement,
   resolveExtension: () => resolveExtension,
+  resolveLoginBranding: () => resolveLoginBranding,
   resolveMessages: () => resolveMessages,
   trimTrailingSlashes: () => trimTrailingSlashes,
   useActions: () => useActions,
@@ -132,23 +139,45 @@ module.exports = __toCommonJS(src_exports);
 var ADMIN_UI_VERSION = "1.2.0";
 
 // src/client/types.ts
-function defaultKvStore() {
-  if (typeof globalThis.localStorage === "undefined") {
-    return {
-      get: () => null,
-      set: () => {
-      },
-      remove: () => {
-      }
-    };
+var NOOP_KV_STORE = {
+  get: () => null,
+  set: () => {
+  },
+  remove: () => {
   }
-  const ls = globalThis.localStorage;
+};
+function defaultKvStore() {
+  const ls = resolveLocalStorage();
+  if (!ls) return NOOP_KV_STORE;
   return {
-    get: (k) => ls.getItem(k),
-    set: (k, v) => ls.setItem(k, v),
-    remove: (k) => ls.removeItem(k)
+    get: (k) => {
+      try {
+        return ls.getItem(k);
+      } catch {
+        return null;
+      }
+    },
+    set: (k, v) => {
+      try {
+        ls.setItem(k, v);
+      } catch {
+      }
+    },
+    remove: (k) => {
+      try {
+        ls.removeItem(k);
+      } catch {
+      }
+    }
   };
 }
+function resolveLocalStorage() {
+  try {
+    return globalThis.localStorage ?? null;
+  } catch {
+    return null;
+  }
+}
 function defaultHttpClient() {
   return (url, init) => fetch(url, init);
 }
@@ -316,6 +345,16 @@ var SA_INTL_LOCALES = {
   de: "de-DE",
   en: "en-US"
 };
+var SA_LOCALE_LABELS = {
+  de: "Deutsch",
+  en: "English"
+};
+function isSaBuiltinLocale(value) {
+  return typeof value === "string" && SA_LOCALES.includes(value);
+}
+function builtinLocaleOf(locale, fallback = DEFAULT_SA_LOCALE) {
+  return isSaBuiltinLocale(locale) ? locale : fallback;
+}
 
 // src/client/i18n/define.ts
 function defineMessages(de, en) {
@@ -437,15 +476,21 @@ var PAGE_SECTIONS = {
   platformEmail: "system",
   platformEmailHistory: "system"
 };
+function resolveNav(options) {
+  return options.nav ?? builtinNav(options.locale);
+}
+function builtinNav(locale) {
+  return navMessages[isSaBuiltinLocale(locale) ? locale : DEFAULT_SA_LOCALE];
+}
 function defaultSectionOrder(locale = DEFAULT_SA_LOCALE) {
-  const sections = navMessages[locale].sections;
+  const sections = typeof locale === "string" ? builtinNav(locale).sections : locale.sections;
   return [sections.overview, sections.catalog, sections.customers, sections.system];
 }
 function buildRoutes(manifest, options = {}) {
   const routes = [];
   const capabilities = manifest.capabilities ?? {};
   const standard = manifest.navigation?.standardPages ?? {};
-  const nav = navMessages[options.locale ?? DEFAULT_SA_LOCALE];
+  const nav = resolveNav(options);
   const defaultNavSections = Object.fromEntries(
     Object.entries(PAGE_SECTIONS).map(([page, section]) => [page, nav.sections[section]])
   );
@@ -780,7 +825,7 @@ function formatterFor(locale, currency, decimals) {
   const key = `${locale}:${currency}:${decimals}`;
   let formatter = formatters.get(key);
   if (!formatter) {
-    formatter = new Intl.NumberFormat(SA_INTL_LOCALES[locale], {
+    formatter = new Intl.NumberFormat(SA_INTL_LOCALES[locale] ?? locale, {
       style: "currency",
       currency,
       minimumFractionDigits: decimals,
@@ -946,7 +991,7 @@ var bundlesMessages = defineMessages(
       bundleKeyHint: "API-stabil \xB7 wird aus dem Label erzeugt",
       errorKeyFormat: "Nur A-Z, 0-9, Underscore; muss mit Buchstabe beginnen.",
       errorKeyExists: "Dieser Bundle-Key existiert bereits.",
-      descriptionPlaceholder: "z. B. Kampagnen, WhatsApp und Korrespondenz f\xFCr aktive Vereine.",
+      descriptionPlaceholder: "z. B. Kampagnen, WhatsApp und Korrespondenz.",
       sectionPricing: "v1 \xB7 Pricing & G\xFCltigkeit",
       pricingHint: "Monats- & Jahrespreis sowie Datum, ab dem das Bundle verkaufbar wird.",
       validFromImmediate: "\u2713 Bundle ist nach Anlage sofort live und verkaufbar.",
@@ -1158,7 +1203,7 @@ var bundlesMessages = defineMessages(
       bundleKeyHint: "API-stable \xB7 derived from the label",
       errorKeyFormat: "Only A-Z, 0-9, underscore; must start with a letter.",
       errorKeyExists: "This bundle key already exists.",
-      descriptionPlaceholder: "e.g. Campaigns, WhatsApp and correspondence for active clubs.",
+      descriptionPlaceholder: "e.g. Campaigns, WhatsApp and correspondence.",
       sectionPricing: "v1 \xB7 pricing & validity",
       pricingHint: "Monthly & yearly price plus the date from which the bundle becomes sellable.",
       validFromImmediate: "\u2713 The bundle is live and sellable right after creation.",
@@ -1832,7 +1877,7 @@ var marketingMessages = defineMessages(
       ctaOverrideLabel: "CTA-Text \xFCberschreiben (optional)",
       ctaOverrideHint: "leer lassen f\xFCr Auto-Text",
       topFeatureCount: "{count} Eintr\xE4ge",
-      featureLabelPlaceholder: "z. B. Beitragsverwaltung",
+      featureLabelPlaceholder: "z. B. Erweiterte Berichte",
       featureStrongPlaceholder: "Highlight, z. B. bis 100",
       moveUp: "Nach oben",
       moveDown: "Nach unten",
@@ -1960,7 +2005,7 @@ var marketingMessages = defineMessages(
       ctaOverrideLabel: "Override CTA text (optional)",
       ctaOverrideHint: "leave empty for the auto text",
       topFeatureCount: "{count} entries",
-      featureLabelPlaceholder: "e.g. Membership management",
+      featureLabelPlaceholder: "e.g. Advanced reporting",
       featureStrongPlaceholder: "Highlight, e.g. up to 100",
       moveUp: "Move up",
       moveDown: "Move down",
@@ -3403,7 +3448,8 @@ var shellMessages = defineMessages(
       productionWarning: "Aktionen wirken sich sofort auf alle Mandanten aus.",
       subtitle: "SuperAdmin \xB7 Plattform-Verwaltung",
       roleBadge: "SUPER ADMIN",
-      logout: "Abmelden"
+      logout: "Abmelden",
+      language: "Sprache"
     },
     drawer: {
       docs: "Doku \xF6ffnen"
@@ -3471,7 +3517,8 @@ var shellMessages = defineMessages(
       productionWarning: "Actions take effect immediately for all tenants.",
       subtitle: "SuperAdmin \xB7 Platform administration",
       roleBadge: "SUPER ADMIN",
-      logout: "Sign out"
+      logout: "Sign out",
+      language: "Language"
     },
     drawer: {
       docs: "Open documentation"
@@ -3744,6 +3791,54 @@ function resolveMessages(locale, overrides) {
   return mergeMessages(SA_MESSAGES[locale], overrides);
 }
 
+// src/client/i18n/catalog.ts
+function createSaCatalog(options = {}) {
+  const additional = options.additionalLocales ?? {};
+  const known = /* @__PURE__ */ new Set([...SA_LOCALES, ...Object.keys(additional)]);
+  const requested = options.locales?.filter((code) => known.has(code));
+  const offered = requested && requested.length > 0 ? requested : [...SA_LOCALES, ...Object.keys(additional)];
+  const labelFor = (locale) => additional[locale]?.label ?? (isSaBuiltinLocale(locale) ? SA_LOCALE_LABELS[locale] : locale);
+  const cache = /* @__PURE__ */ new Map();
+  const messagesFor = (locale) => {
+    const hit = cache.get(locale);
+    if (hit) return hit;
+    const definition = additional[locale];
+    const base = SA_MESSAGES[definition?.basedOn ?? (isSaBuiltinLocale(locale) ? locale : "en")];
+    const translated = definition ? mergeMessages(base, definition.messages) : base;
+    const resolved = mergeMessages(translated, options.overrides?.[locale]);
+    cache.set(locale, resolved);
+    return resolved;
+  };
+  const offeredSet = new Set(offered);
+  return {
+    locales: offered.map((code) => ({ code, label: labelFor(code) })),
+    has: (locale) => offeredSet.has(locale),
+    // The app's first offered locale beats the platform default: an app
+    // shipping English only must not start in German.
+    defaultLocale: offered.includes(DEFAULT_SA_LOCALE) ? DEFAULT_SA_LOCALE : offered[0],
+    messagesFor,
+    intlLocaleFor: (locale) => additional[locale]?.intlLocale ?? (isSaBuiltinLocale(locale) ? SA_INTL_LOCALES[locale] : locale),
+    labelFor
+  };
+}
+
+// src/client/login-branding.ts
+var DEFAULT_TAG = "SuperAdmin";
+function resolveLoginBranding(boot, fallback = {}) {
+  const project = boot?.project ?? null;
+  const environment = project?.environment ?? null;
+  return {
+    name: project?.displayName || fallback.name || "",
+    tag: project?.label || fallback.tag || DEFAULT_TAG,
+    icon: project?.icon || fallback.logoText || "",
+    logoUrl: project?.logoUrl || null,
+    environment: environment && environment !== "production" ? environment : null
+  };
+}
+function isProductionBoot(boot) {
+  return boot?.project?.environment === "production";
+}
+
 // src/vue/super-admin-context.ts
 var SUPER_ADMIN_BRAND_KEY = /* @__PURE__ */ Symbol.for(
   "@saasicat/ui-vue/SUPER_ADMIN_BRAND"
@@ -3841,22 +3936,42 @@ function useSuperAdminHttp() {
 
 // src/vue/use-super-admin-i18n.ts
 var import_vue2 = require("vue");
+var SA_LOCALE_STORAGE_KEY = "sa:locale";
 var SUPER_ADMIN_I18N_KEY = /* @__PURE__ */ Symbol.for(
   "@saasicat/ui-vue/SUPER_ADMIN_I18N"
 );
 function createSuperAdminI18n(options = {}) {
-  const locale = (0, import_vue2.isRef)(options.locale) ? options.locale : (0, import_vue2.ref)(options.locale ?? DEFAULT_SA_LOCALE);
-  const messages = (0, import_vue2.computed)(
-    () => resolveMessages(locale.value, options.overrides?.[locale.value])
+  const catalog = createSaCatalog(options);
+  const locale = (0, import_vue2.isRef)(options.locale) ? options.locale : createOwnedLocale(options, catalog);
+  const active = (0, import_vue2.computed)(
+    () => catalog.has(locale.value) ? locale.value : catalog.defaultLocale
   );
-  const intlLocale = (0, import_vue2.computed)(() => SA_INTL_LOCALES[locale.value]);
-  return { locale, messages, intlLocale };
+  const messages = (0, import_vue2.computed)(() => catalog.messagesFor(active.value));
+  const intlLocale = (0, import_vue2.computed)(() => catalog.intlLocaleFor(active.value));
+  const writable = !(0, import_vue2.isReadonly)(locale);
+  return {
+    locale,
+    messages,
+    intlLocale,
+    switcherEnabled: (options.switcher ?? true) && writable && catalog.locales.length > 1,
+    availableLocales: catalog.locales
+  };
+}
+function createOwnedLocale(options, catalog) {
+  const initial = options.locale ?? catalog.defaultLocale;
+  if (options.persist === false) return (0, import_vue2.ref)(initial);
+  const storage = options.storage ?? defaultKvStore();
+  const key = `${options.storageKeyPrefix ?? ""}${SA_LOCALE_STORAGE_KEY}`;
+  const stored = storage.get(key);
+  const locale = (0, import_vue2.ref)(stored && catalog.has(stored) ? stored : initial);
+  (0, import_vue2.watch)(locale, (next) => storage.set(key, next));
+  return locale;
 }
 var fallbackI18n = null;
 function useSuperAdminI18n() {
   const injected = (0, import_vue2.inject)(SUPER_ADMIN_I18N_KEY, null);
   if (injected) return injected;
-  fallbackI18n ??= createSuperAdminI18n();
+  fallbackI18n ??= createSuperAdminI18n({ persist: false });
   return fallbackI18n;
 }
 function useSaMessages(namespace) {
@@ -4404,7 +4519,7 @@ function useTenantBilling(options = {}) {
 
 // src/vue/use-subscription-draft.ts
 var import_vue12 = require("vue");
-var import_types10 = require("@saasicat/types");
+var import_types11 = require("@saasicat/types");
 var DEFAULT_YEARLY_FACTOR = 10;
 function unwrap(source) {
   if (source && typeof source === "object" && "value" in source) {
@@ -4444,7 +4559,7 @@ function useSubscriptionDraft(options) {
     const planFeatures = selectedPlan.value?.features ?? [];
     const selected = selectedBundles.value;
     const keptIds = new Set(
-      (0, import_types10.selectChargeableBundles)(planFeatures, selected).map((b) => b.bundleVersionId)
+      (0, import_types11.selectChargeableBundles)(planFeatures, selected).map((b) => b.bundleVersionId)
     );
     return selected.filter((b) => keptIds.has(b.bundleVersionId));
   });
@@ -6586,6 +6701,8 @@ function defaultTenantPlanSectionI18n(locale) {
   PromotionsApiError,
   SA_INTL_LOCALES,
   SA_LOCALES,
+  SA_LOCALE_LABELS,
+  SA_LOCALE_STORAGE_KEY,
   SA_MESSAGES,
   SUPER_ADMIN_ACTIONS_KEY,
   SUPER_ADMIN_BRAND_KEY,
@@ -6603,11 +6720,13 @@ function defaultTenantPlanSectionI18n(locale) {
   buildQuotaRegistry,
   buildRoutes,
   buildSidebar,
+  builtinLocaleOf,
   createAdminResourceClient,
   createAdminRoutes,
   createManifestStore,
   createPlatformLoaders,
   createProjectPageHostRoute,
+  createSaCatalog,
   createSuperAdminI18n,
   defaultHttpClient,
   defaultIconForActionKey,
@@ -6619,10 +6738,13 @@ function defaultTenantPlanSectionI18n(locale) {
   formatCurrency,
   formatMessage,
   getJson,
+  isProductionBoot,
+  isSaBuiltinLocale,
   mergeMessages,
   postJson,
   provideEntitlement,
   resolveExtension,
+  resolveLoginBranding,
   resolveMessages,
   trimTrailingSlashes,
   useActions,

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import { BootLoaderOptions, ManifestLoaderOptions, BuildRouteEntry, SidebarSection, NavBuilderOptions, BatchColumnData, BatchColumnFetcherOptions, BootLoader, ManifestLoader } from './client/index.cjs';
-export { ADMIN_UI_VERSION, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpJsonError, ManifestLoadError, MessageParams, ParamStyle, SidebarItem, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, postJson, resolveExtension, trimTrailingSlashes } from './client/index.cjs';
-import { H as HttpClient, c as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './messages-BIYw32u1.cjs';
-export { d as ActionDefNotInManifestError, D as DEFAULT_SA_LOCALE, e as HttpResponse, M as MessageTree, f as MissingHandlerError, P as PartialMessages, R as ResolvedAction, g as SA_INTL_LOCALES, h as SA_LOCALES, i as SA_MESSAGES, a as SaMessages, b as SaMessagesOverrides, T as TranslationOf, j as defaultHttpClient, k as defaultKvStore, l as defineMessages, m as mergeMessages, r as resolveMessages } from './messages-BIYw32u1.cjs';
-import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter } from './use-super-admin-i18n-DL_qI1BY.cjs';
-export { f as ExtensionLoader, I as InstallPlugin, g as SUPER_ADMIN_ACTIONS_KEY, h as SUPER_ADMIN_BRAND_KEY, i as SUPER_ADMIN_ENDPOINTS_KEY, j as SUPER_ADMIN_EXTENSIONS_KEY, k as SUPER_ADMIN_HTTP_KEY, l as SUPER_ADMIN_I18N_KEY, m as SUPER_ADMIN_LOGIN_ADAPTER_KEY, n as SUPER_ADMIN_MANIFEST_KEY, o as SUPER_ADMIN_NOTIFY_KEY, p as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, e as SuperAdminI18n, d as SuperAdminI18nOptions, q as SuperAdminLoginResult, r as SuperAdminManifestGuardOptions, U as UiNotify, s as UiNotifyKind, t as UiNotifyOptions, u as buildNavigationGuard, v as createSuperAdminI18n, w as useSaMessages, x as useSuperAdminI18n } from './use-super-admin-i18n-DL_qI1BY.cjs';
+export { ADMIN_UI_VERSION, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpJsonError, LoginBootProject, LoginBrandFallback, LoginBranding, ManifestLoadError, MessageParams, ParamStyle, SidebarItem, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, isProductionBoot, postJson, resolveExtension, resolveLoginBranding, trimTrailingSlashes } from './client/index.cjs';
+import { H as HttpClient, e as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './catalog-C4Gv2_KM.cjs';
+export { f as ActionDefNotInManifestError, D as DEFAULT_SA_LOCALE, g as HttpResponse, M as MessageTree, h as MissingHandlerError, P as PartialMessages, R as ResolvedAction, i as SA_INTL_LOCALES, j as SA_LOCALES, k as SA_LOCALE_LABELS, l as SA_MESSAGES, m as SaBuiltinLocale, n as SaCatalog, o as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TranslationOf, p as builtinLocaleOf, q as createSaCatalog, r as defaultHttpClient, s as defaultKvStore, t as defineMessages, u as isSaBuiltinLocale, v as mergeMessages, w as resolveMessages } from './catalog-C4Gv2_KM.cjs';
+import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter } from './use-super-admin-i18n-BdPqeTHl.cjs';
+export { f as ExtensionLoader, I as InstallPlugin, g as SA_LOCALE_STORAGE_KEY, h as SUPER_ADMIN_ACTIONS_KEY, i as SUPER_ADMIN_BRAND_KEY, j as SUPER_ADMIN_ENDPOINTS_KEY, k as SUPER_ADMIN_EXTENSIONS_KEY, l as SUPER_ADMIN_HTTP_KEY, m as SUPER_ADMIN_I18N_KEY, n as SUPER_ADMIN_LOGIN_ADAPTER_KEY, o as SUPER_ADMIN_MANIFEST_KEY, p as SUPER_ADMIN_NOTIFY_KEY, q as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, e as SuperAdminI18n, d as SuperAdminI18nOptions, r as SuperAdminLoginResult, s as SuperAdminManifestGuardOptions, U as UiNotify, t as UiNotifyKind, u as UiNotifyOptions, v as buildNavigationGuard, w as createSuperAdminI18n, x as useSaMessages, y as useSuperAdminI18n } from './use-super-admin-i18n-BdPqeTHl.cjs';
 import { AdminManifest, TenantListFilter, TenantDto, AuditQuery, AuditEntry, FeatureUiRegistry, PromoPreviewResponse, OnboardingSelectionRequest, PublicMarketingBundle, FeatureDef, FeatureKey, PublicBootResponse, DiscoverySnapshot, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, SyncDiscoveryResult, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, SubscriptionBundleRecord, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, PromotionRow, CreatePromotionData, UpdatePromotionData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, TenantActionDef } from '@saasicat/types';
 import { RouteRecordRaw, NavigationGuardWithThis } from 'vue-router';
 import * as vue from 'vue';

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { BootLoaderOptions, ManifestLoaderOptions, BuildRouteEntry, SidebarSection, NavBuilderOptions, BatchColumnData, BatchColumnFetcherOptions, BootLoader, ManifestLoader } from './client/index.js';
-export { ADMIN_UI_VERSION, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpJsonError, ManifestLoadError, MessageParams, ParamStyle, SidebarItem, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, postJson, resolveExtension, trimTrailingSlashes } from './client/index.js';
-import { H as HttpClient, c as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './messages-BIYw32u1.js';
-export { d as ActionDefNotInManifestError, D as DEFAULT_SA_LOCALE, e as HttpResponse, M as MessageTree, f as MissingHandlerError, P as PartialMessages, R as ResolvedAction, g as SA_INTL_LOCALES, h as SA_LOCALES, i as SA_MESSAGES, a as SaMessages, b as SaMessagesOverrides, T as TranslationOf, j as defaultHttpClient, k as defaultKvStore, l as defineMessages, m as mergeMessages, r as resolveMessages } from './messages-BIYw32u1.js';
-import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter } from './use-super-admin-i18n-CWNu_W3u.js';
-export { f as ExtensionLoader, I as InstallPlugin, g as SUPER_ADMIN_ACTIONS_KEY, h as SUPER_ADMIN_BRAND_KEY, i as SUPER_ADMIN_ENDPOINTS_KEY, j as SUPER_ADMIN_EXTENSIONS_KEY, k as SUPER_ADMIN_HTTP_KEY, l as SUPER_ADMIN_I18N_KEY, m as SUPER_ADMIN_LOGIN_ADAPTER_KEY, n as SUPER_ADMIN_MANIFEST_KEY, o as SUPER_ADMIN_NOTIFY_KEY, p as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, e as SuperAdminI18n, d as SuperAdminI18nOptions, q as SuperAdminLoginResult, r as SuperAdminManifestGuardOptions, U as UiNotify, s as UiNotifyKind, t as UiNotifyOptions, u as buildNavigationGuard, v as createSuperAdminI18n, w as useSaMessages, x as useSuperAdminI18n } from './use-super-admin-i18n-CWNu_W3u.js';
+export { ADMIN_UI_VERSION, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpJsonError, LoginBootProject, LoginBrandFallback, LoginBranding, ManifestLoadError, MessageParams, ParamStyle, SidebarItem, buildRoutes, buildSidebar, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, isProductionBoot, postJson, resolveExtension, resolveLoginBranding, trimTrailingSlashes } from './client/index.js';
+import { H as HttpClient, e as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './catalog-C4Gv2_KM.js';
+export { f as ActionDefNotInManifestError, D as DEFAULT_SA_LOCALE, g as HttpResponse, M as MessageTree, h as MissingHandlerError, P as PartialMessages, R as ResolvedAction, i as SA_INTL_LOCALES, j as SA_LOCALES, k as SA_LOCALE_LABELS, l as SA_MESSAGES, m as SaBuiltinLocale, n as SaCatalog, o as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TranslationOf, p as builtinLocaleOf, q as createSaCatalog, r as defaultHttpClient, s as defaultKvStore, t as defineMessages, u as isSaBuiltinLocale, v as mergeMessages, w as resolveMessages } from './catalog-C4Gv2_KM.js';
+import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter } from './use-super-admin-i18n-uteRCL9q.js';
+export { f as ExtensionLoader, I as InstallPlugin, g as SA_LOCALE_STORAGE_KEY, h as SUPER_ADMIN_ACTIONS_KEY, i as SUPER_ADMIN_BRAND_KEY, j as SUPER_ADMIN_ENDPOINTS_KEY, k as SUPER_ADMIN_EXTENSIONS_KEY, l as SUPER_ADMIN_HTTP_KEY, m as SUPER_ADMIN_I18N_KEY, n as SUPER_ADMIN_LOGIN_ADAPTER_KEY, o as SUPER_ADMIN_MANIFEST_KEY, p as SUPER_ADMIN_NOTIFY_KEY, q as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, e as SuperAdminI18n, d as SuperAdminI18nOptions, r as SuperAdminLoginResult, s as SuperAdminManifestGuardOptions, U as UiNotify, t as UiNotifyKind, u as UiNotifyOptions, v as buildNavigationGuard, w as createSuperAdminI18n, x as useSaMessages, y as useSuperAdminI18n } from './use-super-admin-i18n-uteRCL9q.js';
 import { AdminManifest, TenantListFilter, TenantDto, AuditQuery, AuditEntry, FeatureUiRegistry, PromoPreviewResponse, OnboardingSelectionRequest, PublicMarketingBundle, FeatureDef, FeatureKey, PublicBootResponse, DiscoverySnapshot, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, SyncDiscoveryResult, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, SubscriptionBundleRecord, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, PromotionRow, CreatePromotionData, UpdatePromotionData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, TenantActionDef } from '@saasicat/types';
 import { RouteRecordRaw, NavigationGuardWithThis } from 'vue-router';
 import * as vue from 'vue';