merge: 최신 로컬 main을 정보 화면 버튼 통일에 통합

app/game-frontend/test/gameServerActivity.test.ts

@@ -0,0 +1,22 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+    GAME_SERVER_ACTIVITY_FRESHNESS_MS,
+    createGameServerActivityTracker,
+    isRecentGameServerActivity,
+} from '../src/utils/gameServerActivity.ts';
+
+void test('keeps the most recently observed server contact timestamp', () => {
+    const tracker = createGameServerActivityTracker();
+    tracker.markContact(2_000);
+    tracker.markContact(1_000);
+    tracker.markContact(Number.NaN);
+    assert.equal(tracker.lastContactAt.value, 1_000);
+});
+
+void test('treats three heartbeat intervals as recent activity', () => {
+    assert.equal(isRecentGameServerActivity(1_000, 1_000 + GAME_SERVER_ACTIVITY_FRESHNESS_MS), true);
+    assert.equal(isRecentGameServerActivity(1_000, 1_001 + GAME_SERVER_ACTIVITY_FRESHNESS_MS), false);
+    assert.equal(isRecentGameServerActivity(null, 1_000), false);
+});

app/game-frontend/test/serverClockProjection.test.ts

@@ -0,0 +1,51 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+    millisecondsUntilNextMinute,
+    projectServerClock,
+    sampleServerClock,
+} from '../src/utils/serverClockProjection.ts';
+
+void test('projects a running server clock from the browser sample instant', () => {
+    const sample = sampleServerClock(
+        {
+            serverTime: '2026-08-13T00:00:35.250Z',
+            clockMode: 'realtime',
+            clockRunning: true,
+        },
+        10_000
+    );
+    assert.ok(sample);
+    assert.equal(projectServerClock(sample, 34_750).time.toISOString(), '2026-08-13T00:01:00.000Z');
+    assert.equal(millisecondsUntilNextMinute(projectServerClock(sample, 10_000).time), 24_750);
+});
+
+void test('keeps manual clocks fixed even while client time advances', () => {
+    const sample = sampleServerClock(
+        { serverTime: '2026-08-13T00:00:35.000Z', clockMode: 'manual', clockRunning: false },
+        10_000
+    );
+    assert.ok(sample);
+    assert.equal(projectServerClock(sample, 130_000).time.toISOString(), '2026-08-13T00:00:35.000Z');
+});
+
+void test('holds a preopen clock until its wall-clock start delay passes', () => {
+    const sample = sampleServerClock(
+        {
+            serverTime: '2026-08-13T00:00:00.000Z',
+            serverWallTime: '2026-08-13T08:00:00.000Z',
+            clockMode: 'realtime',
+            clockRunning: false,
+            clockStartsAt: '2026-08-13T08:01:00.000Z',
+        },
+        10_000
+    );
+    assert.ok(sample);
+    assert.equal(projectServerClock(sample, 69_999).time.toISOString(), '2026-08-13T00:00:00.000Z');
+    assert.equal(projectServerClock(sample, 70_001).time.toISOString(), '2026-08-13T00:00:00.001Z');
+});
+
+void test('rejects an invalid server clock sample', () => {
+    assert.equal(sampleServerClock({ serverTime: 'not-a-time' }, 10_000), null);
+});