powergrid-viewer 2.1.2 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powergrid-viewer",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/boardgamers/powergrid.git",
@@ -11,13 +11,14 @@
     "url": "https://github.com/boardgamers/powergrid/issues"
   },
   "dependencies": {
+    "@boardgamers/protocol": "0.2.2",
     "core-js": "^3.6.5",
     "lodash": "^4.17.19",
     "regenerator-runtime": "^0.13.7",
     "tslib": "^2.2.0",
     "vue": "^2.6.11",
     "vue-class-component": "^7.2.3",
-    "vue-property-decorator": "^8.4.2",
+    "vue-property-decorator": "^9.1.2",
     "powergrid-engine": "2.0.6"
   },
   "devDependencies": {
@@ -35,9 +36,10 @@
     "chai": "^4.1.2",
     "eslint": "^7.28.0",
     "eslint-plugin-vue": "^7.11.0",
+    "playwright": "1.62.1",
     "sass": "^1.26.5",
     "sass-loader": "^8.0.2",
-    "typescript": "^4.3.5",
+    "typescript": "^5.9.3",
     "vue-template-compiler": "^2.6.11"
   },
   "files": [
@@ -53,6 +55,7 @@
     "serve": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve",
     "build": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service build",
     "test:unit": "vue-cli-service test:unit",
-    "package": "vue-cli-service build --target lib --name powergrid-viewer src/wrapper.ts"
+    "package": "vue-cli-service build --target lib --name powergrid-viewer src/wrapper.ts",
+    "test:browser": "node scripts/protocol-smoke.mjs"
   }
 }

package/src/components/Game.vue

@@ -414,6 +414,7 @@
             </g>
         </svg>
 
+        <div class="chat-tabs-host"></div>
         <div class="journal-and-chat">
             <InlineLog v-if="G" :entries="logReversed.slice().reverse()" :mapName="G.options.map" />
             <div class="chat-host"></div>
@@ -2022,7 +2023,7 @@ export default class Game extends Vue {
 
         if (!this.G || this.G.log.length == 1) {
             return 'Game Start!';
-        } else if (this.G.currentPlayers == []) {
+        } else if (this.G.currentPlayers.length === 0) {
             return 'Game ended!';
         } else if (this.player !== undefined && this.G?.currentPlayers.includes(this.player)) {
             const currentPlayer = this.G.players[this.player];

package/src/game-chat.ts

@@ -1,21 +1,22 @@
+import { ChatController, ChatMessage, chatSegments } from '@boardgamers/protocol/chat';
+import { mountChat } from '@boardgamers/protocol/chat/dom';
+import { attachChat, ViewerEmitter } from '@boardgamers/protocol/viewer';
 import { playerColors } from 'powergrid-engine/src/gamestate';
-type ChatMessage = { _id?: string; author?: string; text: string; createdAt?: string; playerIndex?: number };
-type ChatEmitter = {
-    on: (event: string, fn: (data: any) => void) => unknown;
-    emit: (event: string, data: any) => unknown;
-};
-export function mountGameChat(emitter: ChatEmitter, host: Element): void {
-    const panel = document.createElement('details');
-    panel.className = 'bgs-game-chat';
-    panel.open = true;
-    panel.innerHTML =
-        '<summary>Chat</summary><div class="chat-messages" role="log" aria-label="Game chat"></div><div class="chat-composer"><input type="text" aria-label="Chat message" placeholder="Message…" autocomplete="off"><button type="button">Send</button></div><div class="chat-status" role="status"></div>';
+type ChatEmitter = Pick<ViewerEmitter<any, any>, 'on' | 'emit'>;
+export function mountGameChat(emitter: ViewerEmitter<any, any>, host: Element): () => void {
+    const chat = new ChatController();
+    const detach = attachChat(emitter, chat);
+    const slot = host.querySelector<HTMLElement>('.chat-host') || document.createElement('div');
+    if (!slot.parentElement) host.insertAdjacentElement('afterend', slot);
     const style = document.createElement('style');
     style.textContent = `
 .bgs-game-chat{box-sizing:border-box;font:14px/1.4 Arial,sans-serif;border:1px solid #a2aa82;border-radius:3px;margin:8px 0;padding:8px 12px;background:#f3f0dc;color:#263521}
 .bgs-game-chat summary{cursor:pointer;font-weight:650;border-radius:3px;width:fit-content;padding:2px 4px;margin:-2px -4px}
 .bgs-game-chat summary:hover{color:#126778}
 .bgs-game-chat summary:focus-visible,.bgs-game-chat button:focus-visible{outline:2px solid #247d8c;outline-offset:3px}
+.bgs-game-chat .chat-day{display:flex;align-items:center;gap:8px;margin:12px 0 6px;font-size:.85em;opacity:.8}
+.bgs-game-chat .chat-day::before,.bgs-game-chat .chat-day::after{content:"";flex:1;border-top:1px solid currentColor;opacity:.3}
+.bgs-game-chat .chat-day time{margin:0;color:inherit;font-size:inherit}
 .bgs-game-chat .chat-messages{max-height:250px;overflow:auto;overscroll-behavior:auto;margin:6px 0 8px}
 .bgs-game-chat article{padding:5px 0;border-bottom:1px solid #75818d26;white-space:pre-wrap;overflow-wrap:anywhere}
 .bgs-game-chat article strong{padding:0 3px;font-weight:bold}
@@ -28,6 +29,11 @@ export function mountGameChat(emitter: ChatEmitter, host: Element): void {
 .bgs-game-chat button{box-sizing:border-box;height:30px;cursor:pointer;border:1px solid #7f8c8d;border-radius:3px;background:#dddeda;color:#172d34;padding:3px 12px;font:14px Arial,sans-serif}
 .bgs-game-chat button:hover:not(:disabled){background:#c8d3d0}
 .bgs-game-chat button:disabled{color:#788786;border-color:#b0bcb8;background:#dce3df;cursor:default}
+.bgs-game-chat .chat-mention{height:auto;padding:0 2px;border:0;background:transparent;color:inherit;font:inherit;font-weight:bold;text-decoration:underline}
+.bgs-game-chat article a{color:inherit;text-decoration:underline}
+.chat-suggestions{display:flex;flex-wrap:wrap;gap:4px;margin-top:4px}
+.chat-suggestions:empty{display:none}
+.chat-suggestions button[aria-pressed="true"]{outline:2px solid #527f89}
 .bgs-game-chat .chat-status{font-size:12px;margin-top:6px}
 .bgs-game-chat .chat-status:empty{display:none}
 .chat-shortcut{position:fixed;left:16px;bottom:max(16px,env(safe-area-inset-bottom));z-index:900;padding:7px 12px;border:1px solid #6a8589;border-radius:3px;background:#263521;color:#fff;font:600 14px Arial,sans-serif;cursor:pointer;box-shadow:0 2px 6px #0003}
@@ -44,292 +50,120 @@ export function mountGameChat(emitter: ChatEmitter, host: Element): void {
 .chat-shortcut:focus-visible{outline:2px solid #fff;outline-offset:2px}
 
 `;
-    panel.append(style);
-    const slot = host.querySelector('.chat-host');
-    if (slot) slot.append(panel);
-    else host.insertAdjacentElement('afterend', panel);
-    const feeds = host.querySelector('.journal-and-chat') as HTMLElement | null;
+    slot.append(style);
+    let players: { id: number; name: string; color?: string; faction?: string }[] = [];
+    let localPlayer: number | undefined;
+    let chatVisible = false;
+    const shortcut = document.createElement('button');
+    shortcut.type = 'button';
+    shortcut.className = 'chat-shortcut';
+    shortcut.hidden = true;
+    (host.querySelector('.chat-tabs-host') || slot).append(shortcut);
+    const feeds = host.querySelector<HTMLElement>('.journal-and-chat');
     const tabs = document.createElement('nav');
     tabs.className = 'game-feed-tabs';
     tabs.setAttribute('aria-label', 'Chat and journal');
     const chatTab = document.createElement('button');
     const journalTab = document.createElement('button');
     chatTab.type = journalTab.type = 'button';
-    chatTab.textContent = 'Chat';
     journalTab.textContent = 'Journal';
     tabs.append(chatTab, journalTab);
-    if (feeds) feeds.insertAdjacentElement('beforebegin', tabs);
-    function selectFeed(feed: 'chat' | 'journal'): void {
+    host.querySelector('.chat-tabs-host')?.append(tabs);
+    function selectFeed(feed: 'chat' | 'journal') {
         if (feeds) feeds.dataset.feed = feed;
         chatTab.setAttribute('aria-pressed', String(feed === 'chat'));
         journalTab.setAttribute('aria-pressed', String(feed === 'journal'));
     }
     selectFeed('chat');
-    chatTab.onclick = () => {
-        selectFeed('chat');
-        panel.open = true;
-        requestAnimationFrame(read);
-    };
-    journalTab.onclick = () => selectFeed('journal');
-    const list = panel.querySelector('.chat-messages') as HTMLDivElement;
-    const input = panel.querySelector('input') as HTMLInputElement;
-    const button = panel.querySelector('button') as HTMLButtonElement;
-    const status = panel.querySelector('.chat-status') as HTMLDivElement;
-    let messages: ChatMessage[] = [];
-    let players: { id: number; name: string; color?: string }[] = [];
-    let localPlayer: number | undefined;
-    emitter.on('state', (state) => {
-        players = state?.players || [];
-        render();
-    });
-    emitter.on('player', (player) => {
-        localPlayer = player?.index;
-        render();
+    const view = mountChat(slot, {
+        chat,
+        styles: false,
+        openPlayer: (index) => emitter.emit('player:clicked', { index }),
+        renderAuthor,
+        onVisibilityChange(visible) {
+            chatVisible = visible;
+            updateShortcut();
+        },
     });
-    let canSend = false;
-    let disabled = false;
-    let reason = 'Chat is connecting…';
-    let pending: { id: string; text: string } | undefined;
-    let timeout: ReturnType<typeof setTimeout> | undefined;
-    let readTimer: ReturnType<typeof setTimeout> | undefined;
-    let watermark = '';
-    let candidate = '';
-    let following = true;
-    const unread = new Set<string>();
-    const summary = panel.querySelector('summary')!;
-    const shortcut = document.createElement('button');
-    shortcut.type = 'button';
-    shortcut.className = 'chat-shortcut';
-    shortcut.hidden = true;
-    (feeds || panel).insertAdjacentElement('afterend', shortcut);
-    let chatVisible = false;
-    function updateShortcut(): void {
-        const count = unread.size;
+    function renderAuthor(message: ChatMessage): Node {
+        const author = document.createElement('strong');
+        author.textContent = message.author || 'Game';
+        const index =
+            message.playerIndex ??
+            (message.author === 'You' ? localPlayer : players.find((p) => p.name === message.author)?.id);
+        if (index !== undefined && playerColors[index]) {
+            author.style.backgroundColor = players.find((p) => p.id === index)?.color || playerColors[index];
+            author.style.color = author.style.backgroundColor === 'brown' ? '#fff' : '#111';
+        }
+        return author;
+    }
+    function updateShortcut() {
+        const count = chat.unread;
         const label = count ? `Chat · ${count} unread` : 'Chat';
         shortcut.textContent = label;
+        shortcut.hidden = chatVisible;
         shortcut.setAttribute('aria-label', `Open ${label}`);
-        summary.textContent = label;
         chatTab.textContent = label;
-        shortcut.hidden = chatVisible;
     }
     shortcut.onclick = () => {
         selectFeed('chat');
-        panel.open = true;
-        requestAnimationFrame(() => {
-            const firstUnread = Array.from(list.children).find((row) =>
-                unread.has((row as HTMLElement).dataset.id || '')
-            );
-            if (firstUnread) firstUnread.scrollIntoView({ block: 'center' });
-            else panel.scrollIntoView({ block: 'center' });
-            summary.focus({ preventScroll: true });
-            read();
-        });
+        view.open();
     };
-    const visibility = new IntersectionObserver(
-        (entries) => {
-            for (const entry of entries) {
-                if (entry.target === panel) {
-                    chatVisible =
-                        entry.isIntersecting &&
-                        entry.intersectionRect.height >=
-                            Math.min(panel.open ? 80 : 20, entry.boundingClientRect.height);
-                }
-            }
-            updateShortcut();
-            read();
-        },
-        { threshold: Array.from({ length: 21 }, (_, i) => i / 20) }
-    );
-    visibility.observe(panel);
-    function controls(): void {
-        button.disabled = !canSend || disabled || !!pending || !input.value.trim();
-        input.disabled = !canSend || disabled;
-    }
-    function read(): void {
-        if (!panel.open || document.visibilityState !== 'visible' || !document.hasFocus()) {
-            return;
-        }
-        const bounds = list.getBoundingClientRect();
-        if (!bounds.width || !bounds.height) return;
-        const visible = Array.from(list.children).filter((el) => {
-            const r = el.getBoundingClientRect();
-            return r.bottom <= Math.min(bounds.bottom, window.innerHeight) + 1 && r.top >= Math.max(bounds.top, 0);
-        });
-        for (const row of visible) unread.delete((row as HTMLElement).dataset.id || '');
-        updateShortcut();
-        const id = (visible[visible.length - 1] as HTMLElement)?.dataset.id || '';
-        if (!/^[a-f0-9]{24}$/i.test(id) || id.toLowerCase() <= watermark) {
-            return;
-        }
-        candidate = candidate > id.toLowerCase() ? candidate : id.toLowerCase();
-        if (!readTimer) {
-            readTimer = setTimeout(() => {
-                readTimer = undefined;
-                if (
-                    panel.open &&
-                    document.visibilityState === 'visible' &&
-                    document.hasFocus() &&
-                    candidate > watermark
-                ) {
-                    watermark = candidate;
-                    emitter.emit('chat:read', { messageId: watermark });
-                }
-            }, 500);
-        }
-    }
-    function render(): void {
-        list.textContent = '';
-        for (const message of messages) {
-            const row = document.createElement('article');
-            row.dataset.id = message._id || '';
-            const author = document.createElement('strong');
-            author.textContent = message.author || 'Game';
-            const index =
-                message.playerIndex ??
-                (message.author === 'You' ? localPlayer : players.find((p) => p.name === message.author)?.id);
-            if (index !== undefined && playerColors[index]) {
-                author.style.backgroundColor = players.find((p) => p.id === index)?.color || playerColors[index];
-                author.style.color = author.style.backgroundColor === 'brown' ? '#fff' : '#111';
+    const dispose = [
+        detach,
+        chat.subscribe(updateShortcut),
+        emitter.on('state', (state) => {
+            players = (state?.players || []).map((player: any, index: number) => ({ ...player, id: index }));
+            view.refresh();
+        }),
+        emitter.on('gamelog', ({ data }: any) => {
+            if (data?.state) {
+                players = (data.state.players || []).map((player: any, index: number) => ({ ...player, id: index }));
+                view.refresh();
             }
-            row.append(author, document.createTextNode(' '), document.createTextNode(message.text));
-            if (message.createdAt) {
-                const time = document.createElement('time');
-                const date = new Date(message.createdAt);
-                if (!isNaN(date.getTime())) {
-                    time.textContent = date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
-                    time.title = date.toLocaleString();
-                    row.append(time);
-                }
-            }
-
-            list.append(row);
-        }
-        if (following) {
-            list.scrollTop = list.scrollHeight;
-        }
-        updateShortcut();
-        read();
-    }
-    emitter.on('chat:messages', (data: ChatMessage[]) => {
-        messages = data || [];
-        unread.clear();
-        render();
-    });
-    emitter.on('chat:appended', (data: ChatMessage[]) => {
-        for (const message of data || []) {
-            if (!message._id || !messages.some((m) => m._id === message._id)) {
-                messages.push(message);
-                const own = message.playerIndex !== undefined && message.playerIndex === localPlayer;
-                if (message._id && !own && message.author !== 'You') unread.add(message._id);
-            }
-        }
-        render();
-    });
-    emitter.on('chat:updated', (data: ChatMessage[]) => {
-        for (const message of data || []) {
-            const index = messages.findIndex((m) => m._id === message._id);
-            if (index >= 0) {
-                messages[index] = message;
-            }
-        }
-        render();
-    });
-    emitter.on('chat:deleted', (ids: string[]) => {
-        messages = messages.filter((m) => !ids.includes(m._id || ''));
-        ids.forEach((id) => unread.delete(id));
-        render();
-    });
-    emitter.on('chat:disabled', (value: boolean) => {
-        disabled = value;
-        status.textContent = value ? 'Chat disabled' : reason;
-        controls();
-    });
-    emitter.on('chat:state', (value: { canSend: boolean; reason?: string }) => {
-        canSend = value.canSend;
-        reason = canSend
-            ? ''
-            : (
-                  {
-                      'not-logged-in': 'Sign in to chat',
-                      'not-confirmed': 'Confirm your account to chat',
-                      'not-a-player': 'Only players can send messages',
-                      'chat-disabled': 'Chat disabled',
-                      'no-game': 'Chat will be available when the game starts',
-                  } as Record<string, string>
-              )[value.reason || ''] || 'Chat is read-only';
-        status.textContent = reason;
-        controls();
-    });
-    emitter.on('chat:result', (result: { requestId: string; ok: boolean; error?: string }) => {
-        if (pending?.id !== result.requestId) {
-            return;
-        }
-        if (timeout) {
-            clearTimeout(timeout);
-        }
-        if (result.ok && input.value === pending.text) {
-            input.value = '';
-        }
-        status.textContent = result.ok ? '' : result.error || 'Message could not be sent. Your draft is kept.';
-        pending = undefined;
-        controls();
-    });
-    function sendMessage(): void {
-        if (button.disabled) {
-            return;
-        }
-        pending = { id: `${Date.now()}-${Math.random().toString(36).slice(2)}`, text: input.value };
-        controls();
-        status.textContent = 'Sending…';
-        const sending = pending;
-        timeout = setTimeout(() => {
-            if (pending) {
-                pending = undefined;
-                status.textContent = 'No confirmation received. Check the conversation before sending again.';
-                controls();
-            }
-        }, 20000);
-        emitter.emit('chat:send', { text: sending.text.trim(), requestId: sending.id });
-    }
-    button.onclick = sendMessage;
-    input.oninput = controls;
-    input.onkeydown = (event) => {
-        if (event.key === 'Enter' && !event.shiftKey && !event.isComposing) {
-            event.preventDefault();
-            event.stopPropagation();
-            sendMessage();
-        }
+        }),
+        emitter.on('player', (player) => {
+            localPlayer = player?.index;
+            view.refresh();
+        }),
+    ];
+    chatTab.onclick = () => {
+        selectFeed('chat');
+        chat.setOpen(true);
+        view.refresh();
     };
-    list.onscroll = () => {
-        if (list.clientHeight) following = list.scrollHeight - list.scrollTop - list.clientHeight < 32;
-        read();
+    journalTab.onclick = () => {
+        selectFeed('journal');
+        view.refresh();
     };
-    panel.ontoggle = () => {
-        if (panel.open && following) {
-            list.scrollTop = list.scrollHeight;
-        }
-        read();
+    dispose.push(() => tabs.remove());
+    return () => {
+        dispose.forEach((cleanup) => cleanup());
+        view.destroy();
+        shortcut.remove();
+        style.remove();
     };
-    window.addEventListener('scroll', read, { passive: true });
-    window.addEventListener('focus', read);
-    window.addEventListener('resize', read);
-    const sizing = new ResizeObserver(() => {
-        if (following && list.clientHeight) list.scrollTop = list.scrollHeight;
-        updateShortcut();
-        read();
-    });
-    sizing.observe(panel);
-    sizing.observe(list);
-    document.addEventListener('visibilitychange', read);
-    status.textContent = reason;
-    controls();
 }
 
 export function installLocalChat(emitter: ChatEmitter): void {
+    let seat = 0;
+    let roster: { id: string; name: string; playerIndex: number }[] = [];
+    emitter.on('player', (player) => {
+        seat = player.index ?? 0;
+    });
+    emitter.on('state', (state) => {
+        roster = (state?.players || []).map((player: any, index: number) => ({
+            id: String(index),
+            name: player.name || `Player ${index + 1}`,
+            playerIndex: index,
+        }));
+        emitter.emit('chat:state', { canSend: true, mentions: roster.filter((player) => player.playerIndex !== seat) });
+    });
     emitter.emit('chat:state', { canSend: true });
     emitter.emit('chat:messages', [
         {
             _id: '000000000000000000000001',
+            type: 'system',
             author: 'Playtest',
             text: 'Local chat preview. Messages stay in this browser.',
             createdAt: new Date().toISOString(),
@@ -338,7 +172,15 @@ export function installLocalChat(emitter: ChatEmitter): void {
     let next = 2;
     emitter.on('chat:send', ({ text, requestId }) => {
         emitter.emit('chat:appended', [
-            { _id: (next++).toString(16).padStart(24, '0'), author: 'You', text, createdAt: new Date().toISOString() },
+            {
+                _id: (next++).toString(16).padStart(24, '0'),
+                type: 'text',
+                author: 'You',
+                playerIndex: seat,
+                text,
+                segments: chatSegments(text, new Map(roster.map((player) => [player.name, player.id])), true),
+                createdAt: new Date().toISOString(),
+            },
         ]);
         emitter.emit('chat:result', { requestId, ok: true });
     });

package/src/launch.ts

@@ -1,3 +1,4 @@
+import { createViewer } from '@boardgamers/protocol/viewer';
 import { EventEmitter } from 'events';
 import type { GameState, Move } from 'powergrid-engine';
 import Vue from 'vue';
@@ -7,7 +8,14 @@ import { installActionSounds } from './sounds';
 import type { Preferences } from './types/ui-data';
 import { shouldAdoptLogState } from './util/turn-buffer';
 
+let dispose: (() => void) | undefined;
+
 function launch(selector: string) {
+    const target = document.querySelector(selector);
+    if (!target) throw new Error(`Viewer mount point not found: ${selector}`);
+    dispose?.();
+    const mountPoint = document.createElement('div');
+    target.append(mountPoint);
     let params: {
         state: null | GameState;
         player?: number;
@@ -35,75 +43,71 @@ function launch(selector: string) {
 
     const app = new Vue({
         render: (h) => h(Game, { props: params }, []),
-    }).$mount(selector);
+    }).$mount(mountPoint);
 
-    const item: EventEmitter = new EventEmitter();
     let replaying = false;
-
-    // The move payload is the whole current turn so far (an array of atomic moves),
-    // replayed by the engine wrapper from the last committed state.
-    params.emitter.on('move', (moves: Move[]) => item.emit('move', moves));
-    params.emitter.on('fetchState', () => item.emit('fetchState'));
-    params.emitter.on('addLog', (data: string[]) => item.emit('addLog', data));
-    params.emitter.on('replaceLog', (data: string[]) => item.emit('replaceLog', data));
-    params.emitter.on('replay:info', (info: { start: number; current: number; end: number }) =>
-        item.emit('replay:info', info)
-    );
-    params.emitter.on('update:preference', (data: { name: string; value: any }) =>
-        item.emit('update:preference', data)
-    );
-    item.addListener('avatars', (data) => {
-        params.avatars = data;
-        app.$forceUpdate();
-    });
-
-    item.addListener('state', (data) => {
-        params.state = data;
-        app.$forceUpdate();
-        app.$nextTick().then(() => item.emit('ready'));
-    });
-    item.addListener('state:updated', () => item.emit('fetchState'));
-    item.addListener('player', (data) => {
-        params.player = data.index;
-        app.$forceUpdate();
-    });
-    item.addListener('preferences', (data) => {
-        // Mutate (don't replace) the observable object so the update stays reactive
-        Object.assign(params.preferences, data);
-        app.$forceUpdate();
-    });
-    item.addListener('gamelog', (logData) => {
-        if (replaying) {
-            return;
-        }
-
-        if (shouldAdoptLogState(logData?.data?.state)) {
-            // Move responses carry the (possibly tentative) resulting state. Tentative
-            // states are never persisted or broadcast by the platform — this is the
-            // only way they reach the acting player's viewer. Committed states are
-            // refetched; see shouldAdoptLogState for why adopting them is unsafe.
-            params.state = logData.data.state;
+    const viewer = createViewer<GameState, Move[]>({
+        async onState(data) {
+            params.state = data;
             app.$forceUpdate();
-        } else {
-            item.emit('fetchState');
-        }
-    });
-
-    item.addListener('replay:start', () => {
-        params.emitter.emit('replayStart');
-        replaying = true;
-    });
-    item.addListener('replay:to', (info) => {
-        params.emitter.emit('replayTo', info);
-    });
-    item.addListener('replay:end', () => {
-        params.emitter.emit('replayEnd');
-        replaying = false;
-        item.emit('fetchState');
+            await app.$nextTick();
+        },
+        onPlayer(data) {
+            params.player = data.index;
+            app.$forceUpdate();
+        },
+        onPreferences(data) {
+            Object.assign(params.preferences, data);
+            app.$forceUpdate();
+        },
+        onAvatars(data) {
+            params.avatars = data;
+            app.$forceUpdate();
+        },
+        onUpdate() {
+            if (!replaying) viewer.fetchState();
+        },
+        async onLog(logData) {
+            if (replaying) return;
+            const data = logData.data as { state?: GameState } | undefined;
+            // Only tentative move responses may replace the local turn buffer.
+            if (shouldAdoptLogState(data?.state)) {
+                params.state = data!.state!;
+                app.$forceUpdate();
+                await app.$nextTick();
+            } else viewer.fetchState();
+        },
+        onReplayStart() {
+            replaying = true;
+            params.emitter.emit('replayStart');
+        },
+        onReplayTo(index) {
+            params.emitter.emit('replayTo', index);
+        },
+        onReplayEnd() {
+            params.emitter.emit('replayEnd');
+            replaying = false;
+            viewer.fetchState();
+        },
     });
-
+    const item = viewer.emitter;
+    params.emitter.on('move', (moves: Move[]) => viewer.move(moves));
+    params.emitter.on('fetchState', () => viewer.fetchState());
+    params.emitter.on('addLog', (data: string[]) => viewer.addLog(data));
+    params.emitter.on('replaceLog', (data: string[]) => viewer.replaceLog(data));
+    params.emitter.on('replay:info', (info) => viewer.setReplayInfo(info));
+    params.emitter.on('update:preference', ({ name, value }) => viewer.updatePreference(name, value));
     installActionSounds(item);
-    mountGameChat(item, app.$el);
+    const removeChat = mountGameChat(item, app.$el);
+    app.$once('hook:beforeDestroy', () => {
+        removeChat();
+        viewer.destroy();
+        params.emitter.removeAllListeners();
+    });
+    dispose = () => {
+        app.$destroy();
+        target.replaceChildren();
+    };
     return item;
 }