web-player: P5 (parcial) — helpers TypeScript

Crea src/lib/actions/pressable.ts y clickOutside.ts (Svelte actions;
role/tabindex se mantienen estáticos en el markup por accesibilidad
SSR, la acción solo añade click + Enter/Espacio) y src/lib/toggle.svelte.ts
(createToggle), usado por playlists.svelte.ts y queuePanel.svelte.ts.

format.ts: añade plural(n, uno, muchos); migra las 15 pluralizaciones
manuales del repo, unificando a minúscula (Δ visible en Playlists,
Inicio, liked, Explorar).

player.svelte.ts: añade toQueueItem, isQueueCurrent, playAllOrToggle,
playShuffled; renombra addToQueue → playNextItem (el nombre anterior
confundía: inserta a continuación, no al final). Migra los 5 sitios
que repetían el patrón isCurrentQueue/playAll (álbum, playlist, liked,
mezcla, Inicio). Simplifica liked.svelte.ts y recentlyPlayed.ts con
object spread en vez de reconstruir cada campo a mano.

navigation.svelte.ts: añade searchHref (migra el buildHref duplicado
de TopBar y Explorar) y appNavLinks (creado; su adopción en Sidebar/
TabsBar queda para P12, como indica esa parte).

menus.svelte.ts: createTrackMenu() sustituye el estado manual de menú
contextual (contextMenu + contextMenuStateFor + addToQueue) en Inicio,
Explorar y Mezcla.

Pendiente a propósito: la tarea 5 (eliminar el envoltorio TrackTarget
de tracks.ts y sus 8 accesores) se difiere a P13 — es el cambio de
mayor riesgo del plan, toca tipos de forma transversal en Inicio/
Explorar/Mezcla/menús, y no se pudo verificar visualmente sin Docker
en esta sesión.

Verificado con npm run check/build.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

web-player/src/lib/components/TopBar.svelte

@@ -3,6 +3,7 @@
 	import { page } from '$app/state';
 	import type { SessionUser } from '$lib/types';
 	import { SEARCH_DEBOUNCE_MS, SEARCH_MIN_LENGTH } from '$lib/config';
+	import { searchHref } from '$lib/navigation.svelte';
 	import Search from '@lucide/svelte/icons/search';
 	import X from '@lucide/svelte/icons/x';
 	import ChevronLeft from '@lucide/svelte/icons/chevron-left';
@@ -24,13 +25,9 @@
 	let searchInput: HTMLInputElement | undefined = $state();
 	let searchTimeout: ReturnType<typeof setTimeout> | undefined;
 
-	function buildHref(term: string) {
-		return term ? `/explore?q=${encodeURIComponent(term)}` : '/explore';
-	}
-
 	function runSearch(term: string) {
 		if (term.length > 0 && term.length < SEARCH_MIN_LENGTH) return;
-		goto(buildHref(term), {
+		goto(searchHref(term), {
 			replaceState: page.url.pathname === '/explore',
 			keepFocus: true,
 			noScroll: true

web-player/src/lib/components/player/Queue.svelte

@@ -4,6 +4,7 @@
 	import Artwork from '$lib/components/ui/Artwork.svelte';
 	import ArtistLink from '$lib/components/ui/ArtistLink.svelte';
 	import IconButton from '$lib/components/ui/IconButton.svelte';
+	import { pressable } from '$lib/actions/pressable';
 	import { fmtTime } from '$lib/format';
 	import X from '@lucide/svelte/icons/x';
 	import { fly } from 'svelte/transition';
@@ -71,12 +72,7 @@
 				<div
 					role="button"
 					tabindex="0"
-					onclick={() => player.playQueueIndex(index)}
-					onkeydown={(e) => {
-						if (e.key !== 'Enter' && e.key !== ' ') return;
-						e.preventDefault();
-						player.playQueueIndex(index);
-					}}
+					use:pressable={() => player.playQueueIndex(index)}
 					class="flex items-center gap-3 rounded-control p-2.25 text-left hover:bg-hover"
 				>
 					<Artwork trackIds={[track.id]} size="sm" alt={track.title} class="shrink-0 opacity-80" />

web-player/src/lib/components/ui/AccountMenu.svelte

@@ -9,6 +9,7 @@
 	import MenuItem from './MenuItem.svelte';
 	import GlassMenu from './GlassMenu.svelte';
 	import { themeMode } from '$lib/theme/mode.svelte';
+	import { clickOutside } from '$lib/actions/clickOutside';
 
 	interface Props {
 		user: SessionUser;
@@ -27,7 +28,6 @@
 	}: Props = $props();
 
 	let open = $state(false);
-	let menuRef: HTMLDivElement | undefined = $state();
 
 	function toggle() {
 		open = !open;
@@ -36,13 +36,9 @@
 	function close() {
 		open = false;
 	}
-
-	function onDocumentClick(event: MouseEvent) {
-		if (menuRef && !menuRef.contains(event.target as Node)) open = false;
-	}
 </script>
 
-<div class="relative" bind:this={menuRef}>
+<div class="relative" use:clickOutside={close}>
 	{@render trigger({ toggle, open })}
 
 	{#if open}
@@ -69,5 +65,3 @@
 		</GlassMenu>
 	{/if}
 </div>
-
-<svelte:window onclick={onDocumentClick} />

web-player/src/lib/components/ui/AlbumCard.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import MediaCard from './MediaCard.svelte';
 	import Artwork from './Artwork.svelte';
+	import { plural } from '$lib/format';
 
 	interface Props {
 		id: string;
@@ -35,9 +36,7 @@
 			typeLabel,
 			subtitle,
 			releaseYear ? String(releaseYear) : undefined,
-			trackCount === undefined
-				? undefined
-				: `${trackCount} ${trackCount === 1 ? 'canción' : 'canciones'}`
+			trackCount === undefined ? undefined : plural(trackCount, 'canción', 'canciones')
 		]
 			.filter((part) => !!part)
 			.join(' · ')

web-player/src/lib/components/ui/PlaylistCard.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import MediaCard from './MediaCard.svelte';
 	import Artwork from './Artwork.svelte';
+	import { plural } from '$lib/format';
 
 	interface Props {
 		id: string;
@@ -13,7 +14,7 @@
 
 	let { id, name, trackCount, trackIds, updatedAt, index = 0 }: Props = $props();
 
-	const subtitle = $derived(`${trackCount} ${trackCount === 1 ? 'Canción' : 'Canciones'}`);
+	const subtitle = $derived(plural(trackCount, 'canción', 'canciones'));
 </script>
 
 <MediaCard href="/playlists/{id}" title={name} {subtitle} {index}>

web-player/src/lib/components/ui/TrackTitleCell.svelte

@@ -3,6 +3,7 @@
 	import Artwork from './Artwork.svelte';
 	import ExplicitBadge from './ExplicitBadge.svelte';
 	import ArtistLink from './ArtistLink.svelte';
+	import { pressable } from '$lib/actions/pressable';
 
 	interface Props {
 		trackId: string | number;
@@ -33,24 +34,14 @@
 		overlay,
 		badge
 	}: Props = $props();
-
-	function onKeydown(event: KeyboardEvent) {
-		if (event.key !== 'Enter' && event.key !== ' ') return;
-		event.preventDefault();
-		onClick();
-	}
-
-	function onclick(event: MouseEvent) {
-		event.stopPropagation();
-		onClick();
-	}
 </script>
 
+<!-- svelte-ignore a11y_click_events_have_key_events -->
 <div
 	role="button"
 	tabindex="0"
-	{onclick}
-	onkeydown={onKeydown}
+	use:pressable={onClick}
+	onclick={(event) => event.stopPropagation()}
 	class="flex min-w-0 items-center gap-3.5 text-left"
 >
 	<Artwork trackIds={[trackId]} src={coverSrc} {size} alt={title} class="shrink-0">