@k2b/cloud 0.6.0-rc.0

package/src/ssr/admin-active-link.ts

@@ -0,0 +1,47 @@
+/**
+ * Resolving which admin sidebar link is the current one.
+ *
+ * Kept out of the sidebar component so it can be tested without a JSX runtime,
+ * and because the rule is subtle enough to deserve its own tests.
+ */
+
+const asUrl = (path: string): URL => new URL(`http://admin.local${path}`);
+
+/**
+ * Whether a link covers the current path at all. A section link stays lit on
+ * its sub-pages, which is why this is a prefix test rather than equality.
+ *
+ * Settings tabs live on one path and differ only by query parameter, so they
+ * compare that instead.
+ */
+const matches = (currentPath: string, href: string): boolean => {
+  const current = asUrl(currentPath);
+  const target = asUrl(href);
+  if (target.pathname === "/admin/settings") {
+    return current.pathname === "/admin/settings" && current.searchParams.get("tab") === target.searchParams.get("tab");
+  }
+  return current.pathname === target.pathname || current.pathname.startsWith(`${target.pathname}/`);
+};
+
+/**
+ * The most specific link covering the current path, or null if none does.
+ *
+ * Prefix matching applied per link lights up every ancestor: the observability
+ * overview at `/admin/observability` matched all of `/admin/observability/*`,
+ * so it stayed highlighted next to the page actually open. Comparing
+ * candidates and keeping the longest resolves that generically — including for
+ * `/admin` itself, which previously needed its own exact-match exception.
+ */
+export const activeAdminHref = (currentPath: string, hrefs: readonly string[]): string | null => {
+  let best: string | null = null;
+  let bestLength = -1;
+  for (const href of hrefs) {
+    if (!matches(currentPath, href)) continue;
+    const length = asUrl(href).pathname.length;
+    if (length > bestLength) {
+      best = href;
+      bestLength = length;
+    }
+  }
+  return best;
+};

package/src/ssr/admin-navigation.ts

@@ -0,0 +1,78 @@
+import { normalizeRedirectTo } from "../shared";
+import { platformMessages } from "./platform-messages";
+import type { RuntimeContext } from "./runtime";
+
+export type AdminLink = { href: string; icon: string; label: string };
+export type AdminGroup = { label: string; links: AdminLink[] };
+
+const normalizeAdminHref = (href: string | undefined): string | undefined => {
+  const normalized = normalizeRedirectTo(href);
+  return normalized === "/admin" || normalized?.startsWith("/admin/") ? normalized : undefined;
+};
+
+export const buildAdminGroups = (apps: readonly RuntimeContext["apps"][number][], locale = "en"): AdminGroup[] => {
+  const t = platformMessages.resolve([locale]).t;
+  const settingsLinks: AdminLink[] = [
+    { href: "/admin/settings?tab=general", icon: "ti-app-window", label: t.general },
+    { href: "/admin/settings?tab=mail", icon: "ti-mail", label: "Mail" },
+    { href: "/admin/settings?tab=pdf-rendering", icon: "ti-file-type-pdf", label: t.pdfRendering },
+    { href: "/admin/settings?tab=email-templates", icon: "ti-template", label: t.emailTemplates },
+    { href: "/admin/settings?tab=security", icon: "ti-shield-lock", label: t.security },
+    { href: "/admin/settings?tab=legal", icon: "ti-file-text", label: t.legal },
+  ];
+  const aiLinks: AdminLink[] = [
+    { href: "/admin/settings?tab=ai-general", icon: "ti-adjustments", label: t.general },
+    { href: "/admin/settings?tab=ai-providers", icon: "ti-sparkles", label: t.providers },
+    { href: "/admin/settings?tab=ai-usage", icon: "ti-chart-histogram", label: t.aiUsage },
+    { href: "/admin/settings?tab=ai-skills", icon: "ti-wand", label: t.skills },
+    { href: "/admin/settings?tab=ai-projects", icon: "ti-folders", label: t.projects },
+    { href: "/admin/settings?tab=ai-jobs", icon: "ti-activity", label: t.backgroundJobs },
+  ];
+  const contributedApps = apps
+    .map((app) => ({
+      app,
+      groups: (app.adminNav ?? [])
+        .map((group) => ({
+          label: group.label,
+          links: group.links.flatMap((link) => {
+            const href = normalizeAdminHref(link.href);
+            return href ? [{ href, icon: link.icon.replace(/^ti\s+/, ""), label: link.label }] : [];
+          }),
+        }))
+        .filter((group) => group.links.length > 0),
+    }))
+    .sort((a, b) => a.app.name.localeCompare(b.app.name));
+
+  const appsWithGroups = new Set(contributedApps.filter(({ groups }) => groups.length > 0).map(({ app }) => app.id));
+  const appLinks = apps
+    .filter((app) => !appsWithGroups.has(app.id))
+    .flatMap((app) => {
+      const href = normalizeAdminHref(app.adminHref);
+      return href ? [{ href, icon: app.icon.replace(/^ti\s+/, ""), label: app.name }] : [];
+    })
+    .sort((a, b) => a.label.localeCompare(b.label));
+
+  return [
+    {
+      label: t.general,
+      links: [
+        { href: "/admin", icon: "ti-dashboard", label: t.overview },
+        { href: "/admin/announcements", icon: "ti-speakerphone", label: t.announcements },
+      ],
+    },
+    ...contributedApps.flatMap(({ groups }) => groups),
+    {
+      label: t.userManagement,
+      links: [
+        { href: "/admin/settings?tab=user", icon: "ti-login", label: t.accountSignIn },
+        { href: "/admin/settings?tab=registration", icon: "ti-user-plus", label: t.accountRegistration },
+        { href: "/admin/settings?tab=linux", icon: "ti-terminal-2", label: t.linuxAccess },
+        { href: "/admin/settings?tab=account-operations", icon: "ti-tool", label: t.accountOperations },
+        { href: "/admin/settings?tab=freeipa", icon: "ti-building-fortress", label: "FreeIPA" },
+      ],
+    },
+    { label: t.ai, links: aiLinks },
+    { label: t.settings, links: settingsLinks },
+    ...(appLinks.length > 0 ? [{ label: t.appAdmin, links: appLinks }] : []),
+  ];
+};

package/src/ssr/app-appearance.ts

@@ -0,0 +1,23 @@
+import type { AppAppearance } from "../contracts/app";
+import { resolveRuntimeRoute } from "./app-navigation";
+import type { RuntimeContext } from "./runtime";
+
+const isHexColor = (value: string | undefined): value is `#${string}` => /^#[0-9a-f]{6}$/i.test(value ?? "");
+const clampStrength = (value: number | undefined, fallback: number): number =>
+  Number.isFinite(value) ? Math.max(0, Math.min(100, value ?? fallback)) : fallback;
+
+export const appAppearanceStyle = (appearance: AppAppearance | undefined): string | undefined => {
+  if (!isHexColor(appearance?.accent)) return undefined;
+  const from = isHexColor(appearance.background?.from) ? appearance.background.from : appearance.accent;
+  const to = isHexColor(appearance.background?.to) ? appearance.background.to : from;
+  const via = isHexColor(appearance.background?.via) ? appearance.background.via : "#ffffff";
+  const angle = Number.isFinite(appearance.background?.angle) ? Math.max(0, Math.min(360, appearance.background?.angle ?? 135)) : 135;
+  const strength = clampStrength(appearance.background?.strength, 20);
+  const darkStrength = Math.round(strength / 2);
+  return `--app-accent:${appearance.accent};--app-canvas-from:${from};--app-canvas-via:${via};--app-canvas-to:${to};--app-canvas-angle:${angle}deg;--app-canvas-strength:${strength}%;--app-canvas-dark-strength:${darkStrength}%`;
+};
+
+export const appAccentStyle = (accent: string | undefined): string | undefined =>
+  isHexColor(accent) ? `--app-accent:${accent}` : undefined;
+
+export const resolveCurrentApp = (apps: RuntimeContext["apps"], pathname: string) => resolveRuntimeRoute(apps, pathname)?.app;

package/src/ssr/app-navigation.ts

@@ -0,0 +1,41 @@
+import type { RuntimeAppMeta } from "../contracts/app";
+import { hasRole, type User } from "../contracts/shared";
+
+export type VisibleNavigationApp = RuntimeAppMeta & {
+  nav: NonNullable<RuntimeAppMeta["nav"]>;
+};
+
+export type RuntimeRouteMatch = {
+  app: RuntimeAppMeta;
+  prefix: string;
+};
+
+/** Resolves the app owning the most specific registered prefix for a path. */
+export const resolveRuntimeRoute = (apps: readonly RuntimeAppMeta[], pathname: string): RuntimeRouteMatch | undefined => {
+  const path = pathname.split(/[?#]/, 1)[0] || "/";
+  return apps
+    .flatMap((app) => app.routes.map((prefix) => ({ app, prefix })))
+    .filter(({ prefix }) => prefix === "/" || path === prefix || path.startsWith(`${prefix}/`))
+    .sort((a, b) => b.prefix.length - a.prefix.length)[0];
+};
+
+/** True when a path is owned by an app other than the current caller. */
+export const hasDedicatedRuntimeRoute = (apps: readonly RuntimeAppMeta[], pathname: string, currentAppId: string): boolean => {
+  const match = resolveRuntimeRoute(apps, pathname);
+  return !!match && match.app.id !== currentAppId;
+};
+
+/** Apps rendered in the navigation for a given authenticated user. */
+export const visibleNavigationApps = (apps: readonly RuntimeAppMeta[], user: User | undefined): VisibleNavigationApp[] =>
+  apps.filter(
+    (app): app is VisibleNavigationApp =>
+      !!app.nav &&
+      app.nav.section !== "hidden" &&
+      (!app.nav.requiresAuth || !!user) &&
+      (!app.nav.requiresRoles ||
+        (!!user &&
+          app.nav.requiresRoles.some((role) => {
+            if (role === "guest") return user.profile === "guest";
+            return hasRole(user, role);
+          }))),
+  );

package/src/ssr/help-messages.ts

@@ -0,0 +1,104 @@
+import { i18n } from "@k2b/stdlib";
+
+/** Shared Help chrome only. Applications own article translations in their Help declaration. */
+export const helpMessages = i18n.define({
+  baseLocale: "en",
+  messages: {
+    en: {
+      shortcuts: "Shortcuts",
+      shortcutsDescription: "Keyboard actions for the current page.",
+      shortcutsIntro: "Shortcuts follow the current app and view. This list updates automatically.",
+      searchHelp: "Search help",
+      section: "Section",
+      help: "Help",
+      description: "Guides, workflows, and shortcuts",
+      searchDescription: "Find a task, concept, or shortcut.",
+      previousTopic: "Previous topic",
+      nextTopic: "Next topic",
+      topicNavigation: "Help topic navigation",
+      back: "Back",
+      backToHelp: "Back to help",
+      backToTopics: "Back to help topics",
+      actions: "Help actions",
+      copied: "Copied",
+      helpCopied: "Help copied as Markdown",
+      copyAllHelp: "Copy all help as Markdown",
+      articleCopied: "Article copied as Markdown",
+      copyArticle: "Copy article as Markdown",
+      openWindow: "Open help in a new browser window",
+      openFullPage: "Open full-page help",
+      closeHelp: "Close help",
+      close: "Close",
+      heading: "How can we help?",
+      headingDescription: "Find a task, concept, or shortcut for the current app.",
+      preparing: "Preparing…",
+      copyAllShort: "Copy all as Markdown",
+      copyAllFailed: ({ message }: { message: string }) => `Could not copy all help: ${message}`,
+      searchPlaceholder: "Search help…",
+      startHere: "Start here",
+      allTopics: "All topics",
+      results: ({ count }: { count: number }) => `${count} ${count === 1 ? "result" : "results"}`,
+      noResults: "No help topic matches this search.",
+      copyMarkdown: "Copy Markdown",
+      loading: "Loading help…",
+      loadFailed: "Could not load this topic",
+      tryAgain: "Try again",
+      onThisPage: "On this page",
+      articleCopiedAnnouncement: "Article copied as Markdown.",
+      allCopiedAnnouncement: "All help copied as Markdown.",
+      searchFailed: "Help could not be searched. Try again.",
+      requestFailed: "Help could not be loaded. Try again.",
+      invalidDocument: "Help server returned an invalid document",
+      loadFallback: "Could not load help",
+      copyFallback: "Could not copy help",
+    },
+    de: {
+      shortcuts: "Tastaturkürzel",
+      shortcutsDescription: "Tastaturaktionen für die aktuelle Seite.",
+      shortcutsIntro: "Die Tastaturkürzel richten sich nach der aktuellen App und Ansicht. Diese Liste wird automatisch aktualisiert.",
+      searchHelp: "Hilfe durchsuchen",
+      section: "Abschnitt",
+      help: "Hilfe",
+      description: "Anleitungen, Abläufe und Tastaturkürzel",
+      searchDescription: "Finde eine Aufgabe, ein Konzept oder ein Tastaturkürzel.",
+      previousTopic: "Vorheriges Thema",
+      nextTopic: "Nächstes Thema",
+      topicNavigation: "Navigation durch Hilfethemen",
+      back: "Zurück",
+      backToHelp: "Zurück zur Hilfe",
+      backToTopics: "Zurück zu den Hilfethemen",
+      actions: "Hilfeaktionen",
+      copied: "Kopiert",
+      helpCopied: "Hilfe als Markdown kopiert",
+      copyAllHelp: "Gesamte Hilfe als Markdown kopieren",
+      articleCopied: "Artikel als Markdown kopiert",
+      copyArticle: "Artikel als Markdown kopieren",
+      openWindow: "Hilfe in einem neuen Browserfenster öffnen",
+      openFullPage: "Hilfe als ganze Seite öffnen",
+      closeHelp: "Hilfe schließen",
+      close: "Schließen",
+      heading: "Wobei brauchst du Hilfe?",
+      headingDescription: "Finde eine Aufgabe, ein Konzept oder ein Tastaturkürzel für die aktuelle App.",
+      preparing: "Wird vorbereitet…",
+      copyAllShort: "Alles als Markdown kopieren",
+      copyAllFailed: ({ message }) => `Die gesamte Hilfe konnte nicht kopiert werden: ${message}`,
+      searchPlaceholder: "Hilfe durchsuchen…",
+      startHere: "Hier starten",
+      allTopics: "Alle Themen",
+      results: ({ count }) => i18n.plural(count, "de", { one: "1 Ergebnis", other: `${count} Ergebnisse` }),
+      noResults: "Kein Hilfethema passt zu dieser Suche.",
+      copyMarkdown: "Markdown kopieren",
+      loading: "Hilfe wird geladen…",
+      loadFailed: "Dieses Thema konnte nicht geladen werden",
+      tryAgain: "Erneut versuchen",
+      onThisPage: "Auf dieser Seite",
+      articleCopiedAnnouncement: "Artikel als Markdown kopiert.",
+      allCopiedAnnouncement: "Gesamte Hilfe als Markdown kopiert.",
+      searchFailed: "Die Hilfe konnte nicht durchsucht werden. Versuche es erneut.",
+      requestFailed: "Die Hilfe konnte nicht geladen werden. Versuche es erneut.",
+      invalidDocument: "Der Hilfeserver hat ein ungültiges Dokument zurückgegeben",
+      loadFallback: "Die Hilfe konnte nicht geladen werden",
+      copyFallback: "Die Hilfe konnte nicht kopiert werden",
+    },
+  },
+});

package/src/ssr/index.ts

@@ -0,0 +1,14 @@
+// Server-only exports (these transitively import bun:sql via services)
+// Do NOT import from this barrel in .island.tsx or .client.tsx files!
+
+export { default as AdminLayout } from "./AdminLayout";
+export { hasDedicatedRuntimeRoute, resolveRuntimeRoute, visibleNavigationApps } from "./app-navigation";
+export { default as Layout } from "./Layout";
+export {
+  default as MinimalLayout,
+  type MinimalLayoutPreferencePosition,
+  type MinimalLayoutProps,
+} from "./MinimalLayout";
+export { getLocalizedRuntimeContext, getRuntimeContext, type RuntimeContext } from "./runtime";
+export type { UrlFilterField } from "./url-filter";
+export { createUrlFilter, flag, list, oneOf, page, text } from "./url-filter";

package/src/ssr/islands/SearchBar.island.tsx

@@ -0,0 +1,80 @@
+import { TextInput, useLocale } from "@k2b/ui";
+import { createEffect, createSignal, onMount } from "solid-js";
+import { platformMessages } from "../platform-messages";
+
+type SearchBarProps = {
+  action?: string;
+  value?: string;
+  param?: string;
+  pageParam?: string;
+  placeholder?: string;
+  ariaLabel?: string;
+};
+
+/** Search bar that filters content via URL query parameter. */
+export default function SearchBar(props: SearchBarProps = {}) {
+  const locale = useLocale();
+  const t = () => platformMessages.resolve([locale()]).t;
+  const param = props.param ?? "search";
+  const pageParam = props.pageParam ?? "page";
+  const [query, setQuery] = createSignal(props.value ?? "");
+
+  createEffect(() => {
+    if (props.value !== undefined) {
+      setQuery(props.value);
+    }
+  });
+
+  onMount(() => {
+    if (props.value !== undefined) return;
+    const fallback = new URLSearchParams(window.location.search).get(param) ?? "";
+    setQuery(fallback);
+  });
+
+  const handleSubmit = (e: Event): void => {
+    e.preventDefault();
+    const current = new URL(window.location.href);
+    const url = props.action ? new URL(props.action, window.location.origin) : current;
+    const value = query().trim();
+
+    if (value.length > 0) {
+      url.searchParams.set(param, value);
+    } else {
+      url.searchParams.delete(param);
+    }
+    url.searchParams.delete(pageParam);
+
+    window.location.href = url.toString();
+  };
+
+  const handleClear = (): void => {
+    const current = new URL(window.location.href);
+    const url = props.action ? new URL(props.action, window.location.origin) : current;
+
+    url.searchParams.delete(param);
+    url.searchParams.delete(pageParam);
+
+    window.location.href = url.toString();
+  };
+
+  return (
+    <form onSubmit={handleSubmit} role="search" class="w-full">
+      <TextInput
+        name={param}
+        type="search"
+        placeholder={props.placeholder ?? `${t().search}…`}
+        aria-label={props.ariaLabel ?? t().search}
+        icon="ti ti-search"
+        activeIcon="ti ti-search"
+        value={query}
+        onValueChange={setQuery}
+        clearable
+        clearLabel={t().clearSearch}
+        onClear={handleClear}
+      />
+      <button type="submit" class="hidden">
+        {t().search}
+      </button>
+    </form>
+  );
+}

package/src/ssr/islands/index.ts

@@ -0,0 +1,16 @@
+export { default as SearchBar } from "./SearchBar.island";
+
+import { AppLaunchpadButton, AppLaunchpadProvider } from "../AppLaunchpad.island";
+import { LayoutHelpDocuments, LayoutHelpPage } from "../LayoutHelp";
+
+export type { AppLaunchpadApp, AppLaunchpadLegalLink } from "../AppLaunchpad.island";
+export { AppLaunchpadButton, AppLaunchpadProvider, openAppLaunchpad, setAppLaunchpadContext } from "../AppLaunchpad.island";
+export type { LayoutHelpDocumentsProps, LayoutHelpPageProps } from "../LayoutHelp";
+export { LayoutHelpDocuments, LayoutHelpPage, openLayoutHelpDialog } from "../LayoutHelp";
+
+export const Layout = {
+  HelpDocuments: LayoutHelpDocuments,
+  HelpPage: LayoutHelpPage,
+  AppLaunchpadButton,
+  AppLaunchpadProvider,
+};

package/src/ssr/layout-context.ts

@@ -0,0 +1,17 @@
+import type { RailPreferences } from "../contracts/rail-preferences";
+import type { User } from "../contracts/shared";
+import type { LayoutAnnouncementsState } from "../server/middleware/settings";
+import type { RuntimeContext } from "./runtime";
+
+export type LayoutContext = {
+  get(key: "user"): User | undefined;
+  get(key: "railPreferences"): RailPreferences | undefined;
+  get(key: "page"): { theme?: "light" | "dark" };
+  get(key: "runtime"): RuntimeContext;
+  get(key: "announcements"): LayoutAnnouncementsState | undefined;
+  /** Every application settings snapshot includes Core's app metadata. */
+  get(key: "settings"): Record<string, any>;
+  req: { raw: { headers: Headers; url: string } };
+};
+
+export type MinimalLayoutContext = Pick<LayoutContext, "get" | "req">;

package/src/ssr/layout-help-markdown.ts

@@ -0,0 +1,9 @@
+import type { HelpDocumentManifest, HelpDocumentPayload } from "@k2b/cloud/shared";
+
+type MarkdownHelpDocument = Pick<HelpDocumentManifest, "title" | "description"> & Pick<HelpDocumentPayload, "markdown">;
+
+export const formatHelpDocumentMarkdown = (document: MarkdownHelpDocument) =>
+  [`# ${document.title.trim()}`, document.description?.trim(), document.markdown.trim()].filter(Boolean).join("\n\n") + "\n";
+
+export const formatHelpBundleMarkdown = (documents: readonly MarkdownHelpDocument[]) =>
+  documents.map((document) => formatHelpDocumentMarkdown(document).trimEnd()).join("\n\n") + "\n";

package/src/ssr/layout-help-navigation.ts

@@ -0,0 +1,24 @@
+import type { HelpDocumentManifest } from "@k2b/cloud/shared";
+
+type HelpArticleSession = { articleScrollTop: number };
+type HelpArticleScroller = { scrollTop: number };
+type HelpArticleHeading = { focus: (options?: FocusOptions) => void };
+
+export const adjacentHelpDocuments = (documents: readonly HelpDocumentManifest[], activeId: string | null) => {
+  const index = documents.findIndex((document) => document.id === activeId);
+  if (index < 0) return { previous: null, next: null };
+
+  return {
+    previous: documents[index - 1] ?? null,
+    next: documents[index + 1] ?? null,
+  };
+};
+
+export const resetHelpArticleScroll = (session: HelpArticleSession, scroller?: HelpArticleScroller) => {
+  session.articleScrollTop = 0;
+  if (scroller) scroller.scrollTop = 0;
+};
+
+export const focusHelpArticleHeading = (heading?: HelpArticleHeading) => {
+  heading?.focus({ preventScroll: true });
+};

package/src/ssr/layout-help-url.ts

@@ -0,0 +1,5 @@
+/** Build a canonical, reload-safe URL on an app-owned Help route. */
+export const layoutHelpTopicHref = (pageBase: string, topicId: string | null) => {
+  const base = pageBase.endsWith("/") ? pageBase.slice(0, -1) : pageBase;
+  return topicId ? `${base}/${encodeURIComponent(topicId)}` : base;
+};

package/src/ssr/layout-runtime.ts

@@ -0,0 +1,22 @@
+export type LayoutBreadcrumb = {
+  title: string;
+  href?: string;
+};
+
+export type LayoutUpdate = {
+  title?: string;
+  breadcrumbs?: LayoutBreadcrumb[];
+};
+
+export const LAYOUT_UPDATE_EVENT = "cloud:layout:update";
+
+export const layout = {
+  update(update: LayoutUpdate) {
+    if (typeof window === "undefined") return;
+
+    const title = update.title ?? update.breadcrumbs?.at(-1)?.title;
+    if (title) document.title = title;
+
+    window.dispatchEvent(new CustomEvent<LayoutUpdate>(LAYOUT_UPDATE_EVENT, { detail: update }));
+  },
+};

package/src/ssr/page-error-messages.ts

@@ -0,0 +1,25 @@
+import { i18n } from "@k2b/stdlib";
+
+export const pageErrorMessages = i18n.define({
+  baseLocale: "en",
+  messages: {
+    en: {
+      forbidden: "Access denied",
+      forbiddenDescription: "Your account does not have permission to open this page.",
+      notFound: "Page not found",
+      notFoundDescription: "This page is unavailable or the link is no longer valid.",
+      failed: "Could not open this page",
+      failedDescription: "Please try again later.",
+      home: "Go to home page",
+    },
+    de: {
+      forbidden: "Zugriff verweigert",
+      forbiddenDescription: "Dein Konto hat keine Berechtigung, diese Seite zu öffnen.",
+      notFound: "Seite nicht gefunden",
+      notFoundDescription: "Diese Seite ist nicht verfügbar oder der Link ist nicht mehr gültig.",
+      failed: "Seite konnte nicht geöffnet werden",
+      failedDescription: "Bitte versuche es später erneut.",
+      home: "Zur Startseite",
+    },
+  },
+});

package/src/ssr/platform-messages.ts

@@ -0,0 +1,135 @@
+import { i18n } from "@k2b/stdlib";
+
+export const platformMessages = i18n.define({
+  baseLocale: "en",
+  messages: {
+    en: {
+      admin: "Admin",
+      platformAdministration: "Platform administration.",
+      start: "Start",
+      overview: "Overview",
+      general: "General",
+      announcements: "Announcements",
+      ai: "AI",
+      settings: "Settings",
+      appAdmin: "App administration",
+      userManagement: "Accounts & sign-in",
+      accountSignIn: "Sign-in",
+      accountRegistration: "Registration & requests",
+      accountOperations: "Operations",
+      linuxAccess: "Linux identities",
+      pdfRendering: "PDF rendering",
+      emailTemplates: "Email templates",
+      security: "Security",
+      legal: "Legal",
+      providers: "Providers",
+      skills: "Skills",
+      projects: "Projects",
+      aiUsage: "Usage",
+      backgroundJobs: "Background jobs",
+      apps: "Apps",
+      openApps: "Open apps",
+      home: "Home",
+      profile: "Profile",
+      displayName: "display name",
+      firstName: "first name",
+      lastName: "last name",
+      profileIncomplete: ({ fields }: { fields: string }) => `Your profile is incomplete. Missing: ${fields}.`,
+      accountExpired: "Your account has expired.",
+      accountExpires: ({ date }: { date: string }) => `Your account expires on ${date}.`,
+      guestAccountExpires: ({ date }: { date: string }) => `Your guest account expires on ${date}.`,
+      passwordExpired: "Your password has expired. Sign out and in again to change it.",
+      passwordExpires: ({ date }: { date: string }) => `Your password expires on ${date}.`,
+      newNotification: "New notification",
+      relatedItemReady: "A related item is ready.",
+      open: "Open",
+      dismissNotification: "Dismiss notification",
+      light: "Light",
+      dark: "Dark",
+      account: "Account",
+      login: "Login",
+      latestPlatformUpdates: "Latest platform updates",
+      gotIt: "Got it",
+      dismissBanner: "Dismiss banner",
+      searchTags: "Search tags",
+      searchTagsDescription: ({ tag }: { tag: string }) => `Use ${tag} to narrow your search. You can combine text and multiple tags.`,
+      tags: "Tags",
+      noAppSearchTags: "No app-specific search tags are available.",
+      openGlobalSearch: "Open global search",
+      globalSearchDescription: "Search across apps, pages, files, and items.",
+      searchShortcut: "Search (⌘/Ctrl+K)",
+      openShortcutHelp: "Open shortcut help",
+      shortcutHelpDescription: "Open help, guides, and keyboard shortcuts.",
+      openHelp: "Open help",
+      helpShortcut: "Help (Shift+/)",
+      signIn: "Sign in",
+      menu: "Menu",
+      search: "Search",
+      clearSearch: "Clear search",
+    },
+    de: {
+      admin: "Verwaltung",
+      platformAdministration: "Plattform verwalten.",
+      start: "Start",
+      overview: "Übersicht",
+      general: "Allgemein",
+      announcements: "Ankündigungen",
+      ai: "KI",
+      settings: "Einstellungen",
+      appAdmin: "App-Verwaltung",
+      userManagement: "Accounts & Anmeldung",
+      accountSignIn: "Anmeldung",
+      accountRegistration: "Registrierung & Anfragen",
+      accountOperations: "Betrieb",
+      linuxAccess: "Linux-Identitäten",
+      pdfRendering: "PDF-Erstellung",
+      emailTemplates: "E-Mail-Vorlagen",
+      security: "Sicherheit",
+      legal: "Rechtliches",
+      providers: "Anbieter",
+      skills: "Skills",
+      projects: "Projekte",
+      aiUsage: "Nutzung",
+      backgroundJobs: "Hintergrundaufgaben",
+      apps: "Apps",
+      openApps: "Apps öffnen",
+      home: "Start",
+      profile: "Profil",
+      displayName: "Anzeigename",
+      firstName: "Vorname",
+      lastName: "Nachname",
+      profileIncomplete: ({ fields }) => `Dein Profil ist unvollständig. Es fehlen: ${fields}.`,
+      accountExpired: "Dein Konto ist abgelaufen.",
+      accountExpires: ({ date }) => `Dein Konto läuft am ${date} ab.`,
+      guestAccountExpires: ({ date }) => `Dein Gastkonto läuft am ${date} ab.`,
+      passwordExpired: "Dein Passwort ist abgelaufen. Melde dich ab und erneut an, um es zu ändern.",
+      passwordExpires: ({ date }) => `Dein Passwort läuft am ${date} ab.`,
+      newNotification: "Neue Benachrichtigung",
+      relatedItemReady: "Ein zugehöriger Inhalt ist verfügbar.",
+      open: "Öffnen",
+      dismissNotification: "Benachrichtigung ausblenden",
+      light: "Hell",
+      dark: "Dunkel",
+      account: "Konto",
+      login: "Anmelden",
+      latestPlatformUpdates: "Neuigkeiten zur Plattform",
+      gotIt: "Verstanden",
+      dismissBanner: "Banner ausblenden",
+      searchTags: "Such-Tags",
+      searchTagsDescription: ({ tag }) => `Verwende ${tag} für eine gezieltere Suche. Text und mehrere Tags lassen sich kombinieren.`,
+      tags: "Tags",
+      noAppSearchTags: "Keine app-spezifischen Such-Tags verfügbar.",
+      openGlobalSearch: "Globale Suche öffnen",
+      globalSearchDescription: "Apps, Seiten, Dateien und weitere Inhalte durchsuchen.",
+      searchShortcut: "Suchen (⌘/Strg+K)",
+      openShortcutHelp: "Tastaturhilfe öffnen",
+      shortcutHelpDescription: "Hilfe, Anleitungen und Tastaturkürzel öffnen.",
+      openHelp: "Hilfe öffnen",
+      helpShortcut: "Hilfe (Umschalt+/)",
+      signIn: "Anmelden",
+      menu: "Menü",
+      search: "Suchen",
+      clearSearch: "Suche leeren",
+    },
+  },
+});