From 8c0d385772b0cc581c2de754faa83cf59d5feae4 Mon Sep 17 00:00:00 2001
From: Fred Boniface <fjla@fredboniface.co.uk>
Date: Tue, 21 Apr 2026 19:54:00 +0100
Subject: [PATCH] Add QuickLinks based on 'frecency' pattern

---
 src/lib/components/ui/TimezoneWarning.svelte  | 38 +++++-----
 .../components/ui/cards/QuickLinksCard.svelte | 71 +++++++++++++++++++
 src/lib/quick-links.svelte.ts                 | 60 ++++++++++++++++
 src/routes/+page.svelte                       |  2 +
 src/routes/board/+page.svelte                 | 21 ++++++
 src/routes/board/+page.ts                     | 12 ++--
 6 files changed, 181 insertions(+), 23 deletions(-)
 create mode 100644 src/lib/components/ui/cards/QuickLinksCard.svelte
 create mode 100644 src/lib/quick-links.svelte.ts

diff --git a/src/lib/components/ui/TimezoneWarning.svelte b/src/lib/components/ui/TimezoneWarning.svelte
index c2ebf57..c64ccca 100644
--- a/src/lib/components/ui/TimezoneWarning.svelte
+++ b/src/lib/components/ui/TimezoneWarning.svelte
@@ -1,6 +1,6 @@
 <script lang="ts">
 	import { onMount } from 'svelte';
-    import { slide } from 'svelte/transition';
+	import { slide } from 'svelte/transition';
 
 	let isNotLondon = $state(false);
 	let londonZone = $state('Greenwich Mean Time');
@@ -19,24 +19,26 @@
 </script>
 
 {#if isNotLondon}
-	<div transition:slide={{duration: 300}} class="tzWarn"><p class="tzText">
-		All times are shown in <strong>{londonZone}</strong>
-    </p></div>
+	<div transition:slide={{ duration: 300 }} class="tzWarn">
+		<p class="tzText">
+			All times are shown in <strong>{londonZone}</strong>
+		</p>
+	</div>
 {/if}
 
 <style>
-    .tzWarn {
-        display: flex;
-        justify-content: center;
-        width: 100%;
-        padding: 1rem 0 0 0;
-    }
+	.tzWarn {
+		display: flex;
+		justify-content: center;
+		width: 100%;
+		padding: 1rem 0 0 0;
+	}
 
-    .tzText {
-        width: 80%;
-        text-align: center;
-        margin: auto;
-        font-family: 'URW Gothic', sans-serif;
-        font-size: 1.2rem;
-    }
-</style>
\ No newline at end of file
+	.tzText {
+		width: 80%;
+		text-align: center;
+		margin: auto;
+		font-family: 'URW Gothic', sans-serif;
+		font-size: 1.2rem;
+	}
+</style>
diff --git a/src/lib/components/ui/cards/QuickLinksCard.svelte b/src/lib/components/ui/cards/QuickLinksCard.svelte
new file mode 100644
index 0000000..49165c5
--- /dev/null
+++ b/src/lib/components/ui/cards/QuickLinksCard.svelte
@@ -0,0 +1,71 @@
+<script lang="ts">
+	import BaseCard from '$lib/components/ui/cards/BaseCard.svelte';
+	import Button from '$lib/components/ui/Button.svelte';
+
+	import { fade } from 'svelte/transition';
+	import { flip } from 'svelte/animate';
+
+	import { quickLinks } from '$lib/quick-links.svelte';
+
+	const flipDuration = 300;
+</script>
+
+<BaseCard header={'Quick Links'}>
+	<div class="card-content">
+		{#if quickLinks.list.length === 0}
+			<p class="msg">Your most viewed stations will appear here</p>
+		{:else}
+			<div class="stations-flex">
+				{#each quickLinks.list as station (station.id)}
+					<div
+						class="btn-container"
+						animate:flip={{ duration: flipDuration }}
+						in:fade|global={{ duration: 200 }}
+					>
+						<Button href={`/board?loc=${station.id}`}
+							><span class="stn-name">{station.id}</span></Button
+						>
+					</div>
+				{/each}
+			</div>
+		{/if}
+	</div>
+</BaseCard>
+
+<style>
+	.card-content {
+		display: flex;
+		flex-direction: column;
+		justify-content: center;
+		align-items: center;
+		text-align: center;
+		width: 90%;
+		min-height: 98px;
+		margin: auto;
+		padding: 10px 0 10px 0;
+	}
+
+	.stations-flex {
+		display: flex;
+		flex-wrap: wrap;
+		gap: 0.1rem 0.5rem;
+		justify-content: center;
+		align-items: flex-start;
+	}
+
+	.btn-container {
+		display: block;
+		width: fit-content;
+		will-change: transform;
+	}
+
+	.msg {
+		font-size: 1.1rem;
+		font-weight: 600;
+		color: var(--color-title);
+	}
+
+	.stn-name {
+		text-transform: capitalize;
+	}
+</style>
diff --git a/src/lib/quick-links.svelte.ts b/src/lib/quick-links.svelte.ts
new file mode 100644
index 0000000..8fd07e1
--- /dev/null
+++ b/src/lib/quick-links.svelte.ts
@@ -0,0 +1,60 @@
+export interface QuickLink {
+	id: string;
+	score: number;
+	lastAccessed: number;
+}
+
+const RETURNED_LENGTH: number = 9;
+const MAX_SCORE: number = 50;
+const MAX_ENTRIES: number = RETURNED_LENGTH * 4;
+
+class QuickLinksService {
+	#links = $state<QuickLink[]>([]);
+
+	constructor() {
+		if (typeof window !== 'undefined') {
+			const saved = localStorage.getItem('ql');
+			if (saved) {
+				this.#links = JSON.parse(saved);
+			}
+		}
+	}
+
+	get list(): QuickLink[] {
+		return this.#links.slice(0, RETURNED_LENGTH);
+	}
+
+	recordVisit(id: string) {
+		if (id == '') return;
+		const existing = this.#links.find((l) => l.id === id);
+
+		if (existing) {
+			existing.score += 1;
+			existing.lastAccessed = Date.now();
+		} else {
+			this.#links.push({
+				id: id,
+				score: 1,
+				lastAccessed: Date.now()
+			});
+		}
+
+		// Score decay - if MAX_SCORE reached, divide all by two
+		if (this.#links.some((l) => l.score > MAX_SCORE)) {
+			this.#links.forEach((l) => {
+				l.score = Math.max(1, Math.floor(l.score / 2));
+			});
+		}
+
+		// Sort & Prune
+		const sorted = [...this.#links].sort(
+			(a, b) => b.score - a.score || b.lastAccessed - a.lastAccessed
+		);
+
+		this.#links = sorted.slice(0, MAX_ENTRIES);
+
+		localStorage.setItem('ql', JSON.stringify(this.#links));
+	}
+}
+
+export const quickLinks = new QuickLinksService();
diff --git a/src/routes/+page.svelte b/src/routes/+page.svelte
index c18f801..031b100 100644
--- a/src/routes/+page.svelte
+++ b/src/routes/+page.svelte
@@ -1,11 +1,13 @@
 <script lang="ts">
 	import LocationBoardCard from '$lib/components/ui/cards/LocationBoardCard.svelte';
 	import NearbyStationsCard from '$lib/components/ui/cards/NearbyStationsCard.svelte';
+	import QuickLinksCard from '$lib/components/ui/cards/QuickLinksCard.svelte';
 </script>
 
 <div class="card-container">
 	<LocationBoardCard />
 	<NearbyStationsCard />
+	<QuickLinksCard />
 </div>
 
 <style>
diff --git a/src/routes/board/+page.svelte b/src/routes/board/+page.svelte
index 5a93fab..6999a76 100644
--- a/src/routes/board/+page.svelte
+++ b/src/routes/board/+page.svelte
@@ -1,3 +1,24 @@
+<script lang="ts">
+	import { untrack } from 'svelte';
+	import { quickLinks } from '$lib/quick-links.svelte';
+
+	let { data } = $props();
+
+	// Update 'QuickLinks'
+	$effect(() => {
+		if (data.BoardLocation) {
+			const id = data.BoardLocation?.c ?? data.BoardLocation?.t;
+			if (id) {
+				// Untrack, as we do not need to handle changes to quickLinks - this is WRITE_ONLY
+				untrack(() => {
+					quickLinks.recordVisit(id);
+					console.log(`QuickLink visit recorded: ${JSON.stringify(data.BoardLocation)}`);
+				});
+			}
+		}
+	});
+</script>
+
 <section>Live board are not yet implemented on the server</section>
 
 <style>
diff --git a/src/routes/board/+page.ts b/src/routes/board/+page.ts
index a33ed68..858009e 100644
--- a/src/routes/board/+page.ts
+++ b/src/routes/board/+page.ts
@@ -18,11 +18,13 @@ export const load: PageLoad = async ({ url }) => {
 		});
 	}
 
-	if (locId) {
-		const location = LOCATIONS.find(locId);
+	let BoardLocation;
 
-		if (location) {
-			title = location.n || location.t;
+	if (locId) {
+		BoardLocation = LOCATIONS.find(locId);
+
+		if (BoardLocation) {
+			title = BoardLocation.n || BoardLocation.t || 'Live Arr/Dep';
 		} else {
 			error(404, {
 				message: `Location (${locId.toUpperCase()}) not found`,
@@ -32,6 +34,6 @@ export const load: PageLoad = async ({ url }) => {
 	}
 	return {
 		title,
-		location
+		BoardLocation
 	};
 };