Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

19.6 KB
Raw Blame
import { Component, Show, Accessor, Setter } from 'solid-js';
import SettingsPanel from '@/components/shared/SettingsPanel';
import { Button } from '@/components/shared/Button';
import { ExternalTextLink } from '@/components/shared/ExternalTextLink';
import { Toggle } from '@/components/shared/Toggle';
import { EnvironmentLockBadge } from '@/components/shared/EnvironmentLockBadge';
import { FilterButtonGroup, type FilterOption } from '@/components/shared/FilterButtonGroup';
import type { TelemetryPreviewResponse } from '@/api/settings';
import { DockerRuntimeSettingsCard } from './DockerRuntimeSettingsCard';
import { GuestDockerDiscoverySettingsCard } from './GuestDockerDiscoverySettingsCard';
import { BrandingSettingsCard } from './BrandingSettingsCard';
import type { ReportBrandSettings } from '@/types/config';
import Sun from 'lucide-solid/icons/sun';
import Moon from 'lucide-solid/icons/moon';
import Languages from 'lucide-solid/icons/languages';
import Thermometer from 'lucide-solid/icons/thermometer';
import Maximize2 from 'lucide-solid/icons/maximize-2';
import {
  activeLocale,
  setLocalePreference,
  SUPPORTED_LOCALE_LABELS,
  SUPPORTED_LOCALES,
  t,
  type SupportedLocale,
} from '@/i18n';
import { temperatureStore } from '@/utils/temperature';
import { layoutStore } from '@/utils/layout';
import {
  PVE_POLLING_MAX_SECONDS,
  PVE_POLLING_MIN_SECONDS,
  getPvePollingCadenceSummary,
  getPvePollingCustomOption,
  getPvePollingPresetOptions,
} from '@/utils/systemSettingsPresentation';
import { PRIVACY_DOC_URL } from '@/utils/docsLinks';

import Laptop from 'lucide-solid/icons/laptop';

const getThemePreferenceOptions = (): FilterOption<'light' | 'dark' | 'system'>[] => [
  { value: 'light', label: t('settings.general.theme.option.light'), icon: Sun },
  { value: 'dark', label: t('settings.general.theme.option.dark'), icon: Moon },
  { value: 'system', label: t('settings.general.theme.option.system'), icon: Laptop },
];

const getLocalePreferenceOptions = (): FilterOption<SupportedLocale>[] =>
  SUPPORTED_LOCALES.map((locale) => ({
    value: locale,
    label: SUPPORTED_LOCALE_LABELS[locale],
  }));

const TEMPERATURE_UNIT_OPTIONS: FilterOption<'celsius' | 'fahrenheit'>[] = [
  { value: 'celsius', label: 'Celsius' },
  { value: 'fahrenheit', label: 'Fahrenheit' },
];

const TELEMETRY_ENV_VAR = 'PULSE_TELEMETRY';
const PVE_POLLING_INTERVAL_ENV_VAR = 'PVE_POLLING_INTERVAL';

const getPvePollingOptions = (): FilterOption<number | 'custom'>[] => [
  ...getPvePollingPresetOptions(),
  getPvePollingCustomOption(),
];

export interface GeneralSettingsPanelProps {
  darkMode: Accessor<boolean>;
  themePreference: Accessor<'light' | 'dark' | 'system'>;
  setThemePreference: (pref: 'light' | 'dark' | 'system') => void;
  pvePollingInterval: Accessor<number>;
  setPVEPollingInterval: Setter<number>;
  pvePollingSelection: Accessor<number | 'custom'>;
  setPVEPollingSelection: Setter<number | 'custom'>;
  pvePollingCustomSeconds: Accessor<number>;
  setPVEPollingCustomSeconds: Setter<number>;
  pvePollingEnvLocked: () => boolean;
  setHasUnsavedChanges: Setter<boolean>;
  reportBrandDisplayName: Accessor<string>;
  setReportBrandDisplayName: Setter<string>;
  reportBrandLogoBase64: Accessor<string>;
  setReportBrandLogoBase64: Setter<string>;
  reportBrandLogoFormat: Accessor<NonNullable<ReportBrandSettings['logoFormat']>>;
  setReportBrandLogoFormat: Setter<NonNullable<ReportBrandSettings['logoFormat']>>;

  telemetryEnabled: Accessor<boolean>;
  telemetryEnabledLocked: () => boolean;
  savingTelemetry: Accessor<boolean>;
  handleTelemetryEnabledChange: (enabled: boolean) => Promise<void>;
  telemetryPreview: Accessor<TelemetryPreviewResponse | null>;
  telemetryPreviewEnabled: Accessor<boolean>;
  telemetryPreviewPayload: Accessor<string>;
  loadingTelemetryPreview: Accessor<boolean>;
  resettingTelemetryInstallID: Accessor<boolean>;
  handleLoadTelemetryPreview: () => Promise<void>;
  handleCopyTelemetryPreview: () => Promise<void>;
  handleResetTelemetryInstallID: () => Promise<void>;

  disableDockerUpdateActions: Accessor<boolean>;
  disableDockerUpdateActionsLocked: () => boolean;
  savingDockerUpdateActions: Accessor<boolean>;
  handleDisableDockerUpdateActionsChange: (disabled: boolean) => Promise<void>;

  enableProxmoxGuestDockerInventory: Accessor<boolean>;
  guestDockerInventoryLocked: () => boolean;
  savingGuestDockerInventory: Accessor<boolean>;
  handleGuestDockerInventoryChange: (enabled: boolean) => Promise<void>;
}

export const GeneralSettingsPanel: Component<GeneralSettingsPanelProps> = (props) => {
  const handlePVEPollingSelection = (value: number | 'custom') => {
    if (props.pvePollingEnvLocked()) return;

    props.setPVEPollingSelection(value);
    props.setPVEPollingInterval(value === 'custom' ? props.pvePollingCustomSeconds() : value);
    props.setHasUnsavedChanges(true);
  };

  return (
    <div class="space-y-3 sm:space-y-6">
      {/* Appearance Card */}
      <SettingsPanel
        title={t('settings.general.appearance.title')}
        noPadding
        bodyClass="divide-y divide-border"
      >
        <div class="flex items-center justify-between gap-2 p-2 sm:gap-4 sm:p-6">
          <div class="flex min-w-0 items-center gap-3">
            {/* Animated theme icon */}
            <div
              class={`relative hidden shrink-0 rounded-md border border-border bg-surface p-2.5 transition-all duration-300 sm:block`}
            >
              <div class="relative w-5 h-5">
                <Sun
                  class={`absolute inset-0 w-5 h-5 text-slate-500 transition-all duration-300 ${props.darkMode() ? 'opacity-0 rotate-90 scale-50' : 'opacity-100 rotate-0 scale-100'}`}
                  strokeWidth={2}
                />
                <Moon
                  class={`absolute inset-0 w-5 h-5 text-slate-500 transition-all duration-300 ${props.darkMode() ? 'opacity-100 rotate-0 scale-100' : 'opacity-0 -rotate-90 scale-50'}`}
                  strokeWidth={2}
                />
              </div>
            </div>
            <div class="min-w-0 text-sm text-muted">
              <p class="text-[10px] font-medium leading-tight text-base-content sm:truncate sm:text-sm">
                {t('settings.general.theme.title')}
              </p>
              <p class="hidden text-xs text-muted sm:line-clamp-2">
                {t('settings.general.theme.description')}
              </p>
            </div>
          </div>
          <FilterButtonGroup
            class="max-w-[72%] shrink-0 [&_button]:px-1.5 [&_svg]:hidden sm:w-auto sm:max-w-full sm:[&_button]:px-3 sm:[&_svg]:block"
            options={getThemePreferenceOptions()}
            value={props.themePreference()}
            onChange={props.setThemePreference}
            variant="settings"
          />
        </div>

        {/* Language Selector: stacks on phones so every locale option fits on one line */}
        <div class="flex flex-col items-start gap-2 p-2 sm:flex-row sm:items-center sm:justify-between sm:gap-4 sm:p-6">
          <div class="flex min-w-0 items-center gap-3">
            <div class="hidden shrink-0 rounded-md border border-border bg-surface p-2.5 sm:block">
              <Languages class="w-5 h-5 text-slate-500" strokeWidth={2} />
            </div>
            <div class="min-w-0 text-sm text-muted">
              <p class="truncate text-xs font-medium text-base-content sm:text-sm">
                {t('settings.general.language.title')}
              </p>
              <p class="hidden text-xs text-muted sm:line-clamp-2">
                {t('settings.general.language.description')}
              </p>
            </div>
          </div>
          <FilterButtonGroup
            class="max-w-full shrink-0 [&_button]:px-1.5 sm:w-auto sm:[&_button]:px-3"
            options={getLocalePreferenceOptions()}
            value={activeLocale()}
            onChange={setLocalePreference}
            variant="settings"
            ariaLabel={t('settings.general.language.ariaLabel')}
          />
        </div>

        {/* Temperature Unit Selector */}
        <div class="flex items-center justify-between gap-2 p-2 sm:gap-4 sm:p-6">
          <div class="flex min-w-0 items-center gap-3">
            <div class="hidden shrink-0 rounded-md border border-border bg-surface p-2.5 sm:block">
              <Thermometer class="w-5 h-5" strokeWidth={2} />
            </div>
            <div class="min-w-0 text-sm text-muted">
              <p class="text-[10px] font-medium leading-tight text-base-content sm:truncate sm:text-sm">
                {t('settings.general.temperature.title')}
              </p>
              <p class="hidden text-xs text-muted sm:line-clamp-2">
                {t('settings.general.temperature.description')}
              </p>
            </div>
          </div>
          <FilterButtonGroup
            class="max-w-[72%] shrink-0 [&_button]:px-1.5 sm:w-auto sm:max-w-full sm:[&_button]:px-3"
            options={TEMPERATURE_UNIT_OPTIONS}
            value={temperatureStore.unit()}
            onChange={(value) => temperatureStore.setUnit(value)}
            variant="settings"
          />
        </div>

        {/* Full-width Mode Toggle */}
        <div class="flex items-center justify-between gap-2 p-2 sm:gap-4 sm:p-6">
          <div class="flex min-w-0 items-center gap-3">
            <div class="hidden shrink-0 rounded-md border border-border bg-surface p-2.5 sm:block">
              <Maximize2 class="w-5 h-5 text-slate-500" strokeWidth={2} />
            </div>
            <div class="min-w-0 text-sm text-muted">
              <p class="truncate text-xs font-medium text-base-content sm:text-sm">
                {t('settings.general.fullWidth.title')}
              </p>
              <p class="hidden text-xs text-muted sm:line-clamp-2">
                {t('settings.general.fullWidth.description')}
              </p>
            </div>
          </div>
          <Toggle
            checked={layoutStore.isFullWidth()}
            class="shrink-0"
            ariaLabel={t('settings.general.fullWidth.title')}
            onChange={() => layoutStore.toggle()}
          />
        </div>

        <div class="p-2 sm:p-6">
          <BrandingSettingsCard
            displayName={props.reportBrandDisplayName}
            setDisplayName={props.setReportBrandDisplayName}
            logoBase64={props.reportBrandLogoBase64}
            setLogoBase64={props.setReportBrandLogoBase64}
            logoFormat={props.reportBrandLogoFormat}
            setLogoFormat={props.setReportBrandLogoFormat}
            setHasUnsavedChanges={props.setHasUnsavedChanges}
          />
        </div>
      </SettingsPanel>

      {/* Usage Data + Privacy Card */}
      <SettingsPanel
        id="usage-telemetry"
        title={t('settings.general.telemetry.section.title')}
        description={t('settings.general.telemetry.section.description')}
        noPadding
        bodyClass="divide-y divide-border"
      >
        <div class="space-y-3 p-2.5 sm:space-y-4 sm:p-6">
          <div class="flex items-center justify-between gap-4">
            <div class="flex-1 min-w-0 space-y-1">
              <div class="flex items-center gap-2">
                <span class="text-sm font-medium text-base-content truncate">
                  {t('settings.general.telemetry.title')}
                </span>
                <Show when={props.telemetryEnabledLocked()}>
                  <EnvironmentLockBadge envVar={TELEMETRY_ENV_VAR} />
                </Show>
              </div>
              <p class="hidden text-xs leading-relaxed text-muted sm:block">
                {t('settings.general.telemetry.description')}{' '}
                <ExternalTextLink href={PRIVACY_DOC_URL} variant="muted">
                  {t('settings.general.telemetry.fullDetails')}
                </ExternalTextLink>
              </p>
              <ExternalTextLink
                href={PRIVACY_DOC_URL}
                variant="muted"
                class="text-[11px] sm:hidden"
              >
                {t('settings.general.telemetry.fullDetails')}
              </ExternalTextLink>
            </div>
            <Toggle
              checked={props.telemetryEnabled()}
              class="shrink-0"
              ariaLabel={t('settings.general.telemetry.title')}
              disabled={props.telemetryEnabledLocked() || props.savingTelemetry()}
              onChange={() => props.handleTelemetryEnabledChange(!props.telemetryEnabled())}
            />
          </div>

          <div class="flex flex-wrap gap-2 sm:gap-3">
            <Button
              variant="primary"
              size="settingsActionXs"
              disabled={props.loadingTelemetryPreview()}
              onClick={() => void props.handleLoadTelemetryPreview()}
            >
              {props.telemetryPreview()
                ? t('settings.general.telemetry.refreshPayload')
                : t('settings.general.telemetry.previewPayload')}
            </Button>
            <Button
              variant="secondary"
              size="settingsActionXs"
              disabled={props.resettingTelemetryInstallID()}
              onClick={() => void props.handleResetTelemetryInstallID()}
            >
              {t('settings.general.telemetry.resetId')}
            </Button>
            <Show when={props.telemetryPreviewPayload()}>
              <Button
                variant="secondary"
                size="settingsActionXs"
                onClick={() => void props.handleCopyTelemetryPreview()}
              >
                {t('settings.general.telemetry.copyJson')}
              </Button>
            </Show>
          </div>

          <Show when={props.telemetryPreviewPayload()}>
            <div class="rounded-md border border-border bg-surface-alt">
              <div class="flex flex-col gap-1 border-b border-border px-4 py-3">
                <p class="text-xs font-semibold uppercase tracking-wide text-muted">
                  {t('settings.general.telemetry.payloadTitle')}
                </p>
                <Show when={!props.telemetryPreviewEnabled()}>
                  <p class="text-xs text-muted leading-relaxed">
                    {t('settings.general.telemetry.disabledPreview')}
                  </p>
                </Show>
              </div>
              <pre
                aria-label={t('settings.general.telemetry.payloadAriaLabel')}
                class="overflow-x-auto px-4 py-3 text-xs leading-relaxed text-base-content"
              >
                {props.telemetryPreviewPayload()}
              </pre>
            </div>
          </Show>
        </div>
      </SettingsPanel>

      <DockerRuntimeSettingsCard
        disableDockerUpdateActions={props.disableDockerUpdateActions}
        disableDockerUpdateActionsLocked={props.disableDockerUpdateActionsLocked}
        savingDockerUpdateActions={props.savingDockerUpdateActions}
        handleDisableDockerUpdateActionsChange={props.handleDisableDockerUpdateActionsChange}
      />

      <GuestDockerDiscoverySettingsCard
        enableProxmoxGuestDockerInventory={props.enableProxmoxGuestDockerInventory}
        guestDockerInventoryLocked={props.guestDockerInventoryLocked}
        savingGuestDockerInventory={props.savingGuestDockerInventory}
        handleGuestDockerInventoryChange={props.handleGuestDockerInventoryChange}
      />

      {/* Monitoring Cadence Card */}
      <SettingsPanel
        title={t('settings.general.monitoringCadence.section.title')}
        description={t('settings.general.monitoringCadence.section.description')}
        noPadding
        bodyClass="divide-y divide-border"
      >
        <div class="p-2.5 sm:p-6">
          <div class="space-y-3 sm:space-y-4">
            <div class="space-y-2">
              <p class="text-[10px] font-bold uppercase tracking-wider text-muted">
                {getPvePollingCadenceSummary(props.pvePollingInterval())}
              </p>
              <p class="text-xs text-muted leading-relaxed max-w-3xl">
                {t('settings.general.monitoringCadence.description')}
              </p>
            </div>

            <div class="space-y-4 pt-2">
              {/* Preset buttons */}
              <FilterButtonGroup
                class="grid-cols-2 xl:grid-cols-5"
                options={getPvePollingOptions()}
                value={props.pvePollingSelection()}
                onChange={handlePVEPollingSelection}
                variant="prominent"
                disabled={props.pvePollingEnvLocked()}
              />

              {/* Custom interval input */}
              <Show when={props.pvePollingSelection() === 'custom'}>
                <div class="mt-4 flex flex-col sm:flex-row sm:items-center gap-4 rounded-md border border-dashed border-border bg-surface-hover p-4 transition-all animate-in fade-in slide-in-from-top-1">
                  <div class="flex-1 min-w-0">
                    <label
                      for="pve-custom-polling-seconds"
                      class="block text-sm font-medium text-base-content truncate"
                    >
                      {t('settings.general.monitoringCadence.custom.title')}
                    </label>
                    <p class="text-xs text-muted mt-0.5 line-clamp-2">
                      {t('settings.general.monitoringCadence.custom.description', {
                        min: PVE_POLLING_MIN_SECONDS,
                        max: PVE_POLLING_MAX_SECONDS,
                      })}
                    </p>
                  </div>
                  <input
                    id="pve-custom-polling-seconds"
                    type="number"
                    min={PVE_POLLING_MIN_SECONDS}
                    max={PVE_POLLING_MAX_SECONDS}
                    value={props.pvePollingCustomSeconds()}
                    class="w-full sm:w-32 min-h-10 rounded-md border border-border px-3 py-2 text-sm focus:outline-hidden focus:ring-2 focus:ring-blue-500 focus:border-transparent dark:focus:ring-blue-400 shadow-xs"
                    disabled={props.pvePollingEnvLocked()}
                    onInput={(e) => {
                      if (props.pvePollingEnvLocked()) return;
                      const parsed = Math.floor(Number(e.currentTarget.value));
                      if (Number.isNaN(parsed)) {
                        return;
                      }
                      const clamped = Math.min(
                        PVE_POLLING_MAX_SECONDS,
                        Math.max(PVE_POLLING_MIN_SECONDS, parsed),
                      );
                      props.setPVEPollingCustomSeconds(clamped);
                      props.setPVEPollingInterval(clamped);
                      props.setHasUnsavedChanges(true);
                    }}
                  />
                </div>
              </Show>

              {/* Env override warning */}
              <Show when={props.pvePollingEnvLocked()}>
                <div class="flex items-center gap-3 rounded-md border border-amber-200 bg-amber-50 px-4 py-3 text-xs text-amber-800 dark:border-amber-800 dark:bg-amber-900/25 dark:text-amber-200">
                  <svg
                    class="h-4 w-4 shrink-0 mt-0.5 self-start"
                    viewBox="0 0 24 24"
                    fill="none"
                    stroke="currentColor"
                    stroke-width="2"
                  >
                    <circle cx="12" cy="12" r="10" />
                    <line x1="12" y1="8" x2="12" y2="12" />
                    <circle cx="12" cy="16" r="0.5" />
                  </svg>
                  <span class="leading-relaxed">
                    {t('settings.general.monitoringCadence.envLocked', {
                      envVar: PVE_POLLING_INTERVAL_ENV_VAR,
                    })}
                  </span>
                </div>
              </Show>
            </div>
          </div>
        </div>
      </SettingsPanel>
    </div>
  );
};