@saasicat/ui-vue 0.16.0 → 0.17.0

package/dist/{chunk-MGKJCVDU.js → chunk-247RJPU4.js}

@@ -1,10 +1,7 @@
 import {
-  DEFAULT_SA_LOCALE,
-  SA_INTL_LOCALES,
-  defaultKvStore,
-  isSaLocale,
-  resolveMessages
-} from "./chunk-TZ2NGQXK.js";
+  createSaCatalog,
+  defaultKvStore
+} from "./chunk-IZGFS5RS.js";
 
 // src/vue/super-admin-context.ts
 var SUPER_ADMIN_BRAND_KEY = /* @__PURE__ */ Symbol.for(
@@ -72,27 +69,30 @@ var SUPER_ADMIN_I18N_KEY = /* @__PURE__ */ Symbol.for(
   "@saasicat/ui-vue/SUPER_ADMIN_I18N"
 );
 function createSuperAdminI18n(options = {}) {
-  const locale = isRef(options.locale) ? options.locale : createOwnedLocale(options);
-  const messages = computed(
-    () => resolveMessages(locale.value, options.overrides?.[locale.value])
+  const catalog = createSaCatalog(options);
+  const locale = isRef(options.locale) ? options.locale : createOwnedLocale(options, catalog);
+  const active = computed(
+    () => catalog.has(locale.value) ? locale.value : catalog.defaultLocale
   );
-  const intlLocale = computed(() => SA_INTL_LOCALES[locale.value]);
+  const messages = computed(() => catalog.messagesFor(active.value));
+  const intlLocale = computed(() => catalog.intlLocaleFor(active.value));
   const writable = !isReadonly(locale);
   return {
     locale,
     messages,
     intlLocale,
-    switcherEnabled: (options.switcher ?? true) && writable
+    switcherEnabled: (options.switcher ?? true) && writable && catalog.locales.length > 1,
+    availableLocales: catalog.locales
   };
 }
-function createOwnedLocale(options) {
-  if (options.persist === false) {
-    return ref(options.locale ?? DEFAULT_SA_LOCALE);
-  }
+function createOwnedLocale(options, catalog) {
+  const initial = options.locale ?? catalog.defaultLocale;
+  if (options.persist === false) return ref(initial);
   const storage = options.storage ?? defaultKvStore();
-  const stored = storage.get(SA_LOCALE_STORAGE_KEY);
-  const locale = ref(isSaLocale(stored) ? stored : options.locale ?? DEFAULT_SA_LOCALE);
-  watch(locale, (next) => storage.set(SA_LOCALE_STORAGE_KEY, next));
+  const key = `${options.storageKeyPrefix ?? ""}${SA_LOCALE_STORAGE_KEY}`;
+  const stored = storage.get(key);
+  const locale = ref(stored && catalog.has(stored) ? stored : initial);
+  watch(locale, (next) => storage.set(key, next));
   return locale;
 }
 var fallbackI18n = null;

package/dist/{chunk-TZ2NGQXK.js → chunk-IZGFS5RS.js}

@@ -53,9 +53,12 @@ var SA_LOCALE_LABELS = {
   de: "Deutsch",
   en: "English"
 };
-function isSaLocale(value) {
+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) {
@@ -93,7 +96,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,
@@ -259,7 +262,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.",
@@ -471,7 +474,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.",
@@ -1145,7 +1148,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",
@@ -1273,7 +1276,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",
@@ -3109,6 +3112,37 @@ 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
+  };
+}
+
 export {
   defaultKvStore,
   defaultHttpClient,
@@ -3116,12 +3150,14 @@ export {
   DEFAULT_SA_LOCALE,
   SA_INTL_LOCALES,
   SA_LOCALE_LABELS,
-  isSaLocale,
+  isSaBuiltinLocale,
+  builtinLocaleOf,
   defineMessages,
   mergeMessages,
   navMessages,
   formatMessage,
   formatCurrency,
   SA_MESSAGES,
-  resolveMessages
+  resolveMessages,
+  createSaCatalog
 };

package/dist/{chunk-CRUUZMMN.js → chunk-XPSD5HKG.js}

@@ -2,8 +2,9 @@ import {
   DEFAULT_SA_LOCALE,
   defaultHttpClient,
   defaultKvStore,
+  isSaBuiltinLocale,
   navMessages
-} from "./chunk-TZ2NGQXK.js";
+} from "./chunk-IZGFS5RS.js";
 
 // src/client/version.ts
 var ADMIN_UI_VERSION = "1.2.0";
@@ -213,15 +214,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]])
   );
@@ -541,6 +548,23 @@ function queryString(params) {
   return value ? `?${value}` : "";
 }
 
+// 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";
+}
+
 export {
   ADMIN_UI_VERSION,
   HttpJsonError,
@@ -561,5 +585,7 @@ export {
   ActionRegistry,
   BatchColumnDriftError,
   BatchColumnFetcher,
-  createAdminResourceClient
+  createAdminResourceClient,
+  resolveLoginBranding,
+  isProductionBoot
 };

package/dist/client/index.cjs

@@ -39,7 +39,9 @@ __export(client_exports, {
   SA_MESSAGES: () => SA_MESSAGES,
   buildRoutes: () => buildRoutes,
   buildSidebar: () => buildSidebar,
+  builtinLocaleOf: () => builtinLocaleOf,
   createAdminResourceClient: () => createAdminResourceClient,
+  createSaCatalog: () => createSaCatalog,
   defaultHttpClient: () => defaultHttpClient,
   defaultKvStore: () => defaultKvStore,
   defaultSectionOrder: () => defaultSectionOrder,
@@ -47,10 +49,12 @@ __export(client_exports, {
   formatCurrency: () => formatCurrency,
   formatMessage: () => formatMessage,
   getJson: () => getJson,
-  isSaLocale: () => isSaLocale,
+  isProductionBoot: () => isProductionBoot,
+  isSaBuiltinLocale: () => isSaBuiltinLocale,
   mergeMessages: () => mergeMessages,
   postJson: () => postJson,
   resolveExtension: () => resolveExtension,
+  resolveLoginBranding: () => resolveLoginBranding,
   resolveMessages: () => resolveMessages,
   trimTrailingSlashes: () => trimTrailingSlashes
 });
@@ -270,9 +274,12 @@ var SA_LOCALE_LABELS = {
   de: "Deutsch",
   en: "English"
 };
-function isSaLocale(value) {
+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) {
@@ -394,15 +401,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]])
   );
@@ -737,7 +750,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,
@@ -903,7 +916,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.",
@@ -1115,7 +1128,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.",
@@ -1789,7 +1802,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",
@@ -1917,7 +1930,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",
@@ -3702,6 +3715,54 @@ function resolveMessages(locale, overrides) {
   if (!overrides) return SA_MESSAGES[locale];
   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";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADMIN_UI_VERSION,
@@ -3723,7 +3784,9 @@ function resolveMessages(locale, overrides) {
   SA_MESSAGES,
   buildRoutes,
   buildSidebar,
+  builtinLocaleOf,
   createAdminResourceClient,
+  createSaCatalog,
   defaultHttpClient,
   defaultKvStore,
   defaultSectionOrder,
@@ -3731,10 +3794,12 @@ function resolveMessages(locale, overrides) {
   formatCurrency,
   formatMessage,
   getJson,
-  isSaLocale,
+  isProductionBoot,
+  isSaBuiltinLocale,
   mergeMessages,
   postJson,
   resolveExtension,
+  resolveLoginBranding,
   resolveMessages,
   trimTrailingSlashes
 });

package/dist/client/index.d.cts

@@ -1,5 +1,5 @@
-import { H as HttpClient, K as KvStore, S as SaLocale } from '../messages-DetB75lX.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_LOCALE_LABELS, j as SA_MESSAGES, a as SaMessages, b as SaMessagesOverrides, T as TranslationOf, k as defaultHttpClient, l as defaultKvStore, m as defineMessages, n as isSaLocale, o as mergeMessages, r as resolveMessages } from '../messages-DetB75lX.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-DetB75lX.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_LOCALE_LABELS, j as SA_MESSAGES, a as SaMessages, b as SaMessagesOverrides, T as TranslationOf, k as defaultHttpClient, l as defaultKvStore, m as defineMessages, n as isSaLocale, o as mergeMessages, r as resolveMessages } from '../messages-DetB75lX.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,25 +16,29 @@ import {
   createAdminResourceClient,
   defaultSectionOrder,
   getJson,
+  isProductionBoot,
   postJson,
   resolveExtension,
+  resolveLoginBranding,
   trimTrailingSlashes
-} from "../chunk-CRUUZMMN.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,
-  isSaLocale,
+  isSaBuiltinLocale,
   mergeMessages,
   resolveMessages
-} from "../chunk-TZ2NGQXK.js";
+} from "../chunk-IZGFS5RS.js";
 export {
   ADMIN_UI_VERSION,
   ActionDefNotInManifestError,
@@ -55,7 +59,9 @@ export {
   SA_MESSAGES,
   buildRoutes,
   buildSidebar,
+  builtinLocaleOf,
   createAdminResourceClient,
+  createSaCatalog,
   defaultHttpClient,
   defaultKvStore,
   defaultSectionOrder,
@@ -63,10 +69,12 @@ export {
   formatCurrency,
   formatMessage,
   getJson,
-  isSaLocale,
+  isProductionBoot,
+  isSaBuiltinLocale,
   mergeMessages,
   postJson,
   resolveExtension,
+  resolveLoginBranding,
   resolveMessages,
   trimTrailingSlashes
 };