From 42f1211ea274fdc8917586ecfdb0184f25799140 Mon Sep 17 00:00:00 2001
From: Aaron Kimbrell <aronwk.aaron@gmail.com>
Date: Sun, 27 Sep 2026 14:58:51 -0500
Subject: [PATCH] feat(dashboard): open a creation on the UGC page from its
 link

/ugc?item=<id>&kind=model|modular opens that model's or car's viewer,
looking it up when it is not on the list's first page. Opening an item
puts it in the address bar, closing it takes it out, and Back and
Forward close and reopen it, so a creation can be shared or bookmarked.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 dDashboardServer/static/js/ugc.js | 66 +++++++++++++++++++++++++++----
 1 file changed, 59 insertions(+), 7 deletions(-)

diff --git a/dDashboardServer/static/js/ugc.js b/dDashboardServer/static/js/ugc.js
index afc4f8c21..8817b5d92 100644
--- a/dDashboardServer/static/js/ugc.js
+++ b/dDashboardServer/static/js/ugc.js
@@ -168,9 +168,51 @@
 		}).catch(function (e) { stats.textContent = 'Could not load the mesh: ' + e.message; });
 	}
 
-	function preview(id) {
-		var item = items.find(function (i) { return i.id === id; }) || { id: id, state: 'done' };
+	// ---- the open item in the address bar (?item=<id>&kind=model|modular), so it can be shared and Back closes it ----
+
+	var pushedItem = false;
+
+	function urlItem() {
+		var params = new URLSearchParams(location.search), id = params.get('item');
+		if (!id || !/^\d{1,20}$/.test(id)) return null;
+		return { id: id, kind: params.get('kind') === 'modular' ? 'modular' : 'model' };
+	}
+
+	function setKind(value) {
+		if (value === kind) return;
+		kind = value;
+		page = 0;
+		$('kindButtons').querySelectorAll('[data-kind]').forEach(function (b) { b.classList.toggle('active', b.dataset.kind === kind); });
+		load();
+	}
+
+	// Opens the item the address names, or closes the open one when it names none
+	function openFromUrl() {
+		var wanted = urlItem();
+		if (!wanted) {
+			if (current) bootstrap.Modal.getOrCreateInstance($('previewModal')).hide();
+			return;
+		}
+		setKind(wanted.kind);
+		if (current && current.id === wanted.id && current.kind === wanted.kind) return;
+		var known = items.find(function (i) { return i.id === wanted.id; });
+		if (known) return preview(wanted.id, known);
+		// Not on the page of the list that is showing: look it up by its id
+		api.get('/api/ugc?kind=' + wanted.kind + '&search=' + wanted.id + '&size=10').then(function (d) {
+			canManage = d.canManage;
+			publicUrl = (d.ugcPublicUrl || '').replace(/\/+$/, '');
+			preview(wanted.id, (d.items || []).find(function (i) { return i.id === wanted.id; }));
+		}).catch(function () { preview(wanted.id); });
+	}
+
+	function preview(id, found) {
+		var item = found || items.find(function (i) { return i.id === id; }) || { id: id, state: 'done' };
 		current = { id: id, kind: kind, stats: null };
+		var shown = urlItem();
+		if (!shown || shown.id !== id || shown.kind !== kind) {
+			history.pushState(null, '', location.pathname + '?item=' + encodeURIComponent(id) + '&kind=' + kind);
+			pushedItem = true;
+		}
 		$('previewTitle').textContent = (kind === 'model' ? 'Model ' : 'Car or rocket ') + id + (item.characterName ? ' by ' + item.characterName : '');
 		$('previewIcon').src = fileUrl(kind, id, 'icon.png');
 		$('previousIconBox').classList.add('d-none');
@@ -232,11 +274,7 @@
 
 	$('kindButtons').addEventListener('click', function (e) {
 		var button = e.target.closest('[data-kind]');
-		if (!button) return;
-		kind = button.dataset.kind;
-		page = 0;
-		this.querySelectorAll('[data-kind]').forEach(function (b) { b.classList.toggle('active', b === button); });
-		load();
+		if (button) setKind(button.dataset.kind);
 	});
 	$('viewButtons').addEventListener('click', function (e) {
 		var button = e.target.closest('[data-view]');
@@ -283,6 +321,16 @@
 		current = null;
 		if (lxfmlViewer && lxfmlViewer.dispose) lxfmlViewer.dispose();
 		lxfmlViewer = null;
+		// Closed here rather than with Back: take the item out of the address too
+		if (urlItem()) {
+			if (pushedItem) history.back();
+			else history.replaceState(null, '', location.pathname);
+		}
+		pushedItem = false;
+	});
+	window.addEventListener('popstate', function () {
+		pushedItem = false;
+		openFromUrl();
 	});
 	// ---- deleting and purging stored files ----
 
@@ -422,7 +470,11 @@
 
 	if (window.Live) Live.on('ugc', load);
 
+	var linked = urlItem();
+	if (linked) kind = linked.kind;
+	$('kindButtons').querySelectorAll('[data-kind]').forEach(function (b) { b.classList.toggle('active', b.dataset.kind === kind); });
 	load();
+	if (linked) openFromUrl();
 	loadStatus();
 	setInterval(loadStatus, 10000);
 })();