Files
kandev/apps/web/components/settings/notification-sound-section.tsx
T
João Salavisa e4c4efec18 feat(i18n): localize Settings > General > Notifications
Settings > General > Notifications held all of its copy as literals, so the page
stayed English under a locale switch. Every string now resolves through t() /
<Trans> at render, and the page is on the i18nGuardFiles allowlist so it cannot
drift back.

Event titles, sound preset names and the permission button label resolve from
maps of catalog keys rather than module-scope t(), so they follow a locale
switch. The Apprise install notice is a single <Trans> message so the link stays
inside the sentence. SCREENS in the pseudo-locale oracle gains a per-screen
allow list for text the frontend must not translate (backend-owned provider
names).
2026-08-02 01:49:44 +02:00

125 lines
4.1 KiB
TypeScript

"use client";
import { useEffect, useState } from "react";
import { IconVolume } from "@tabler/icons-react";
import { useTranslation } from "react-i18next";
import { Button } from "@kandev/ui/button";
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@kandev/ui/select";
import { Switch } from "@kandev/ui/switch";
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@kandev/ui/tooltip";
import {
getSoundPreferences,
isSoundPresetId,
playSoundPreset,
setSoundPreferences,
SOUND_PRESETS,
type SoundPreferences,
type SoundPresetId,
} from "@/lib/notifications/sound";
import { useSettingsSaveContributor } from "./settings-save-provider";
/**
* Catalog keys for the preset names, keyed by the preset id — the id is the
* persisted sentinel and must never be translated. Keys, not `t()` calls: a
* module-scope `t` would freeze the names at the boot locale (docs/i18n.md).
*/
const SOUND_PRESET_LABEL_KEYS: Record<SoundPresetId, string> = {
plim: "settings:soundPresetPlim",
chime: "settings:soundPresetChime",
ding: "settings:soundPresetDing",
pop: "settings:soundPresetPop",
};
export function NotificationSoundSection({
onDirtyChange,
}: {
onDirtyChange?: (isDirty: boolean) => void;
}) {
const { t } = useTranslation();
const [saved, setSaved] = useState<SoundPreferences>(getSoundPreferences);
const [prefs, setPrefs] = useState<SoundPreferences>(saved);
const revision = JSON.stringify(prefs);
const isDirty = revision !== JSON.stringify(saved);
useEffect(() => onDirtyChange?.(isDirty), [isDirty, onDirtyChange]);
useSettingsSaveContributor({
id: "general-notification-sound",
revision,
isDirty,
save: () => {
const submitted = prefs;
setSoundPreferences(submitted);
setSaved(submitted);
},
discard: () => setPrefs(saved),
});
return (
<div
className="space-y-4 rounded-md border p-4"
data-settings-dirty={isDirty}
data-testid="notification-sound-group"
>
<div className="flex items-center justify-between gap-4">
<div>
<div className="text-base font-medium">{t("settings:notificationSound")}</div>
<p className="text-sm text-muted-foreground">
{t("settings:notificationSoundDescription")}
</p>
</div>
<Switch
checked={prefs.enabled}
data-settings-dirty={prefs.enabled !== saved.enabled}
onCheckedChange={(enabled) => setPrefs({ ...prefs, enabled })}
aria-label={t("settings:enableNotificationSound")}
className="cursor-pointer"
/>
</div>
{prefs.enabled && (
<div className="flex items-center gap-2">
<Select
value={prefs.presetId}
onValueChange={(presetId) => {
if (!isSoundPresetId(presetId)) return;
setPrefs({ ...prefs, presetId });
playSoundPreset(presetId);
}}
>
<SelectTrigger
className="w-44 cursor-pointer"
aria-label={t("settings:notificationSoundSelect")}
data-settings-dirty={prefs.presetId !== saved.presetId}
>
<SelectValue />
</SelectTrigger>
<SelectContent>
{SOUND_PRESETS.map((preset) => (
<SelectItem key={preset.id} value={preset.id} className="cursor-pointer">
{t(SOUND_PRESET_LABEL_KEYS[preset.id])}
</SelectItem>
))}
</SelectContent>
</Select>
<TooltipProvider>
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="outline"
size="icon"
className="cursor-pointer"
aria-label={t("settings:previewSound")}
onClick={() => playSoundPreset(prefs.presetId)}
>
<IconVolume className="h-4 w-4" />
</Button>
</TooltipTrigger>
<TooltipContent>{t("settings:previewSound")}</TooltipContent>
</Tooltip>
</TooltipProvider>
</div>
)}
</div>
);
}