baseline

2026-02-04 23:31:53 +01:00
commit cd59ccd99b
2401 changed files with 56808 additions and 0 deletions
--- a/lib/Support/helpers/app.php
+++ b/lib/Support/helpers/app.php
@@ -0,0 +1,208 @@
+<?php
+
+function e($string): void
+{
+    echo htmlspecialchars((string) $string, ENT_QUOTES, 'UTF-8');
+}
+
+function asset(string $path): string
+{
+    return \MintyPHP\Router::getBaseUrl() . ltrim($path, '/');
+}
+
+function localeBase(): string
+{
+    $locale = \MintyPHP\I18n::$locale ?? \MintyPHP\I18n::$defaultLocale;
+    $prefix = $locale !== '' ? $locale . '/' : '';
+    return \MintyPHP\Router::getBaseUrl() . $prefix;
+}
+
+function lurl(string $path = ''): string
+{
+    return localeBase() . ltrim($path, '/');
+}
+
+function appTitle(): string
+{
+    $default = defined('APP_NAME') ? APP_NAME : 'IMVS';
+    $title = appSetting('app_title');
+    if ($title !== null) {
+        return $title;
+    }
+    return $default;
+}
+
+function appUrl(string $path = ''): string
+{
+    if ($path !== '' && preg_match('#^https?://#i', $path)) {
+        return $path;
+    }
+    $base = getenv('APP_URL') ?: '';
+    $base = rtrim((string) $base, '/');
+    if ($base === '') {
+        $scheme = 'http';
+        $https = $_SERVER['HTTPS'] ?? '';
+        $forwarded = $_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '';
+        if ($https === 'on' || $https === '1' || $forwarded === 'https') {
+            $scheme = 'https';
+        }
+        $host = $_SERVER['HTTP_HOST'] ?? '';
+        if ($host !== '') {
+            $base = $scheme . '://' . $host;
+        }
+    }
+    if ($base === '') {
+        return \MintyPHP\Router::getBaseUrl() . ltrim((string) $path, '/');
+    }
+    $path = ltrim((string) $path, '/');
+    return $base . '/' . $path;
+}
+
+function appLogoUrlAbsolute(int $size = 128): string
+{
+    $url = appLogoUrl($size);
+    return appUrl($url);
+}
+
+function appSetting(string $key): ?string
+{
+    $cacheFile = dirname(__DIR__, 3) . '/config/settings.php';
+    if (!is_file($cacheFile)) {
+        return null;
+    }
+    $settings = include $cacheFile;
+    if (!is_array($settings)) {
+        return null;
+    }
+    $value = $settings[$key] ?? null;
+    $value = $value !== null ? trim((string) $value) : '';
+    return $value !== '' ? $value : null;
+}
+
+function appDefaultLocale(): ?string
+{
+    $locale = appSetting('app_locale');
+    if ($locale === null) {
+        return null;
+    }
+    $available = defined('APP_LOCALES') ? APP_LOCALES : [];
+    if ($available && !in_array($locale, $available, true)) {
+        return null;
+    }
+    return $locale;
+}
+
+function appDefaultTheme(): string
+{
+    $setting = appSetting('app_theme');
+    if (in_array($setting, ['light', 'dark'], true)) {
+        return $setting;
+    }
+    $envTheme = getenv('APP_THEME') ?: 'light';
+    $envTheme = strtolower(trim((string) $envTheme));
+    return in_array($envTheme, ['light', 'dark'], true) ? $envTheme : 'light';
+}
+
+function allowUserTheme(): bool
+{
+    $value = appSetting('app_theme_user');
+    if ($value === null || $value === '') {
+        return true;
+    }
+    return in_array(strtolower($value), ['1', 'true', 'yes', 'on'], true);
+}
+
+function appPrimaryColor(): ?string
+{
+    $tenantColor = $_SESSION['current_tenant']['primary_color'] ?? null;
+    if ($tenantColor !== null) {
+        $tenantColor = strtolower(trim((string) $tenantColor));
+        if (preg_match('/^#([0-9a-f]{3}|[0-9a-f]{6})$/i', $tenantColor)) {
+            return $tenantColor;
+        }
+    }
+
+    $value = appSetting('app_primary_color');
+    if ($value === null) {
+        return null;
+    }
+    $value = strtolower(trim($value));
+    if (!preg_match('/^#([0-9a-f]{3}|[0-9a-f]{6})$/i', $value)) {
+        return null;
+    }
+    return $value;
+}
+
+function appPrimaryCssVars(): string
+{
+    $hex = appPrimaryColor();
+    if ($hex === null) {
+        return '';
+    }
+    $hex = ltrim($hex, '#');
+    if (strlen($hex) === 3) {
+        $hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
+    }
+    $r = hexdec(substr($hex, 0, 2)) / 255;
+    $g = hexdec(substr($hex, 2, 2)) / 255;
+    $b = hexdec(substr($hex, 4, 2)) / 255;
+
+    $max = max($r, $g, $b);
+    $min = min($r, $g, $b);
+    $delta = $max - $min;
+
+    $h = 0.0;
+    if ($delta !== 0.0) {
+        if ($max === $r) {
+            $h = 60 * fmod((($g - $b) / $delta), 6);
+        } elseif ($max === $g) {
+            $h = 60 * ((($b - $r) / $delta) + 2);
+        } else {
+            $h = 60 * ((($r - $g) / $delta) + 4);
+        }
+    }
+    if ($h < 0) {
+        $h += 360;
+    }
+
+    $l = ($max + $min) / 2;
+    $s = $delta === 0.0 ? 0.0 : $delta / (1 - abs(2 * $l - 1));
+
+    $h = round($h, 2);
+    $s = round($s * 100, 2) . '%';
+    $l = round($l * 100, 2) . '%';
+
+    return "--app-primary-h-base: {$h}; --app-primary-s-base: {$s}; --app-primary-l-base: {$l}; --app-primary-h-light: {$h}; --app-primary-s-light: {$s}; --app-primary-l-light: {$l};";
+}
+
+function appLogoUrl(?int $size = null): string
+{
+    if (class_exists('MintyPHP\\Service\\BrandingLogoService') && \MintyPHP\Service\BrandingLogoService::hasLogo()) {
+        $query = $size ? '?size=' . (int) $size : '';
+        return lurl('branding/logo' . $query);
+    }
+    return asset('brand/logo.svg');
+}
+
+function appFaviconUrl(string $file): string
+{
+    $tenantUuid = $_SESSION['current_tenant']['uuid'] ?? '';
+    if ($tenantUuid !== '' && class_exists('MintyPHP\\Service\\TenantFaviconService')) {
+        if (\MintyPHP\Service\TenantFaviconService::hasFavicon($tenantUuid)) {
+            return asset('favicon/tenants/' . $tenantUuid . '/' . ltrim($file, '/'));
+        }
+    }
+    return asset('favicon/' . ltrim($file, '/'));
+}
+
+function d()
+{
+    return call_user_func_array('MintyPHP\\Debugger::debug', func_get_args());
+}
+
+function sortByDescription(array &$items): void
+{
+    usort($items, static fn($a, $b) =>
+        strcasecmp((string) ($a['description'] ?? ''), (string) ($b['description'] ?? ''))
+    );
+}