Implement the planner-multiplayer-awareness OpenSpec change: - Add setUserName to use-yjs.ts that persists to localStorage and syncs via awareness - Create ParticipantList component showing all session participants with color dots, host badge, and inline name editing for the local user - Replace plain text cursor labels with SVG pointer arrows and styled name tags (colored background, drop shadow, rounded corners, z-index below map controls) - Track awareness add/remove events and display auto-dismissing toasts (3s) when participants join or leave the session - Add i18n keys for participant UI in English and German Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
118 lines
3.7 KiB
TypeScript
118 lines
3.7 KiB
TypeScript
import { useEffect, useRef, useState } from "react";
|
|
import * as Y from "yjs";
|
|
import { WebsocketProvider } from "y-websocket";
|
|
|
|
const COLORS = [
|
|
"#ef4444", "#f97316", "#eab308", "#22c55e",
|
|
"#06b6d4", "#3b82f6", "#8b5cf6", "#ec4899",
|
|
];
|
|
|
|
const NAMES = [
|
|
"Hiker", "Cyclist", "Runner", "Explorer",
|
|
"Wanderer", "Pathfinder", "Trailblazer", "Navigator",
|
|
];
|
|
|
|
function randomItem<T>(arr: T[]): T {
|
|
return arr[Math.floor(Math.random() * arr.length)]!;
|
|
}
|
|
|
|
function getOrCreateUserIdentity(): { color: string; name: string } {
|
|
try {
|
|
const stored = localStorage.getItem("trails:user");
|
|
if (stored) return JSON.parse(stored);
|
|
} catch { /* localStorage unavailable */ }
|
|
|
|
const identity = { color: randomItem(COLORS), name: randomItem(NAMES) };
|
|
try { localStorage.setItem("trails:user", JSON.stringify(identity)); } catch { /* localStorage unavailable */ }
|
|
return identity;
|
|
}
|
|
|
|
export interface YjsState {
|
|
doc: Y.Doc;
|
|
provider: WebsocketProvider;
|
|
waypoints: Y.Array<Y.Map<unknown>>;
|
|
routeData: Y.Map<unknown>;
|
|
awareness: WebsocketProvider["awareness"];
|
|
connected: boolean;
|
|
setUserName: (name: string) => void;
|
|
}
|
|
|
|
export function useYjs(
|
|
sessionId: string,
|
|
initialWaypoints?: Array<{ lat: number; lon: number; name?: string }>,
|
|
): YjsState | null {
|
|
const [state, setState] = useState<YjsState | null>(null);
|
|
const providerRef = useRef<WebsocketProvider | null>(null);
|
|
const docRef = useRef<Y.Doc | null>(null);
|
|
const initializedWaypoints = useRef(false);
|
|
const identityRef = useRef<{ color: string; name: string } | null>(null);
|
|
|
|
useEffect(() => {
|
|
const doc = new Y.Doc();
|
|
docRef.current = doc;
|
|
|
|
const wsUrl = `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}/sync`;
|
|
const provider = new WebsocketProvider(wsUrl, sessionId, doc);
|
|
providerRef.current = provider;
|
|
|
|
const waypoints = doc.getArray<Y.Map<unknown>>("waypoints");
|
|
const routeData = doc.getMap("routeData");
|
|
|
|
const identity = getOrCreateUserIdentity();
|
|
identityRef.current = identity;
|
|
provider.awareness.setLocalStateField("user", { color: identity.color, name: identity.name });
|
|
|
|
const setUserName = (newName: string) => {
|
|
if (!identityRef.current) return;
|
|
identityRef.current = { ...identityRef.current, name: newName };
|
|
try { localStorage.setItem("trails:user", JSON.stringify(identityRef.current)); } catch { /* localStorage unavailable */ }
|
|
provider.awareness.setLocalStateField("user", { ...identityRef.current });
|
|
};
|
|
|
|
// Initialize waypoints once after first sync
|
|
if (initialWaypoints?.length && !initializedWaypoints.current) {
|
|
(provider as unknown as { on(event: string, cb: () => void): void }).on("synced", () => {
|
|
// Only add if the doc is empty (avoid duplicating on reconnect)
|
|
if (waypoints.length === 0 && !initializedWaypoints.current) {
|
|
initializedWaypoints.current = true;
|
|
doc.transact(() => {
|
|
for (const wp of initialWaypoints) {
|
|
const yMap = new Y.Map();
|
|
yMap.set("lat", wp.lat);
|
|
yMap.set("lon", wp.lon);
|
|
if (wp.name) yMap.set("name", wp.name);
|
|
waypoints.push([yMap]);
|
|
}
|
|
});
|
|
}
|
|
});
|
|
}
|
|
|
|
const updateState = (connected: boolean) => {
|
|
setState({
|
|
doc,
|
|
provider,
|
|
waypoints,
|
|
routeData,
|
|
awareness: provider.awareness,
|
|
connected,
|
|
setUserName,
|
|
});
|
|
};
|
|
|
|
provider.on("status", ({ status }: { status: string }) => {
|
|
updateState(status === "connected");
|
|
});
|
|
|
|
updateState(false);
|
|
|
|
return () => {
|
|
provider.destroy();
|
|
doc.destroy();
|
|
providerRef.current = null;
|
|
docRef.current = null;
|
|
};
|
|
}, [sessionId]);
|
|
|
|
return state;
|
|
}
|