perf: 프런트엔드 import 경계를 세분화

Gateway 화면을 route 단위로 지연 로딩하고 common runtime import를 실제 소유 leaf export로 분리한다.\n\npackage boundary와 route loading 회귀 테스트로 root barrel 재유입을 차단한다.

app/game-frontend/src/components/command/reservedCommandBrief.ts

@@ -1,4 +1,4 @@
-import { JosaUtil } from '@sammo-ts/common';
+import { JosaUtil } from '@sammo-ts/common/util/JosaUtil';
 
 import type { CommandOption, CommandTable } from './types';
 

app/game-frontend/src/components/main/GeneralBattleSummary.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { computed } from 'vue';
 
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 
 export type GeneralBattleSummaryData = {
     available?: boolean;

app/game-frontend/src/components/main/MainFrontStatus.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed } from 'vue';
 import { resolveTournamentStageName } from '../../utils/tournamentStatus';
 

app/game-frontend/src/stores/mainDashboard.ts

@@ -5,12 +5,8 @@ import {
     MESSAGE_MAILBOX_PUBLIC,
     type MessageType,
 } from '@sammo-ts/logic/messages/message.js';
-import {
-    applyReadModelDelta,
-    cloneReadModelJson,
-    type PublicRealtimeEvent,
-    type RealtimeReadModelInvalidation,
-} from '@sammo-ts/common';
+import { applyReadModelDelta, cloneReadModelJson } from '@sammo-ts/common/realtime/delta';
+import type { PublicRealtimeEvent, RealtimeReadModelInvalidation } from '@sammo-ts/common/realtime/types';
 import { trpc } from '../utils/trpc';
 import { useMapViewerStore } from './mapViewer';
 import { useSessionStore } from './session';

app/game-frontend/src/utils/dashboardReadModel.ts

@@ -5,7 +5,7 @@ import {
     type RealtimeReadModelChanges,
     type RealtimeReadModelInvalidation,
     type RealtimeViewerIdentity,
-} from '@sammo-ts/common';
+} from '@sammo-ts/common/realtime/types';
 
 export type DashboardReadModelIdentity = RealtimeViewerIdentity;
 export type DashboardRefreshPlan = RealtimeReadModelInvalidation;

app/game-frontend/src/utils/formatLog.ts

@@ -1,3 +1,3 @@
-import { formatLegacyLogHtml } from '@sammo-ts/common';
+import { formatLegacyLogHtml } from '@sammo-ts/common/logging/formatLegacyLogHtml';
 
 export const formatLog = (text?: string): string => formatLegacyLogHtml(text);

app/game-frontend/src/utils/gatewayTrpc.ts

@@ -1,4 +1,4 @@
-import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common';
+import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common/http/trpcTransport';
 import { createTRPCProxyClient, httpBatchLink } from '@trpc/client';
 import type { AppRouter } from '@sammo-ts/gateway-api';
 

app/game-frontend/src/utils/legacyDateTime.ts

@@ -1,4 +1,4 @@
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 
 export const formatSeoulDateTime = (value: string | Date): string => formatServerDateTime(value);
 

app/game-frontend/src/utils/trpc.ts

@@ -1,4 +1,5 @@
-import { REALTIME_ACCESS_GRANT_HEADER, trpcJsonBodyHttpClientOptions } from '@sammo-ts/common';
+import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common/http/trpcTransport';
+import { REALTIME_ACCESS_GRANT_HEADER } from '@sammo-ts/common/realtime/types';
 import { createTRPCProxyClient, httpBatchLink } from '@trpc/client';
 import type { AppRouter } from '@sammo-ts/game-api';
 import { resolveBatchRealtimeAccessGrant } from './realtimeAccessGrant';

app/game-frontend/src/views/AuctionView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, reactive, ref, watch } from 'vue';
 import { useRoute } from 'vue-router';
 

app/game-frontend/src/views/BattleCenterView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, reactive, ref, watch } from 'vue';
 import { useRoute } from 'vue-router';
 import PanelCard from '../components/ui/PanelCard.vue';

app/game-frontend/src/views/BettingView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import TournamentBracket from '../components/tournament/TournamentBracket.vue';
 import TournamentPageHeader from '../components/tournament/TournamentPageHeader.vue';

app/game-frontend/src/views/BoardView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, nextTick, onMounted, reactive, ref, watch } from 'vue';
 import { useRoute, useRouter } from 'vue-router';
 

app/game-frontend/src/views/DynastyDetailView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref, watch } from 'vue';
 import { useRoute, useRouter } from 'vue-router';
 

app/game-frontend/src/views/InheritView.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
-import { formatServerDateTime, JosaUtil } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
+import { JosaUtil } from '@sammo-ts/common/util/JosaUtil';
 import { computed, onMounted, reactive, ref } from 'vue';
 import { trpc } from '../utils/trpc';
 

app/game-frontend/src/views/MainView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import type { RuntimeNavigationConfig } from '@sammo-ts/common/navigation/menuConfig';
 import { computed, onMounted, onUnmounted, ref, watch } from 'vue';
 import { storeToRefs } from 'pinia';

app/game-frontend/src/views/NationCitiesView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
 import { useGameFeedback } from '../composables/useGameFeedback';

app/game-frontend/src/views/NationPersonnelView.vue

@@ -2,7 +2,7 @@
 import { computed, onMounted, ref, watch } from 'vue';
 import { useRouter } from 'vue-router';
 
-import { JosaUtil } from '@sammo-ts/common';
+import { JosaUtil } from '@sammo-ts/common/util/JosaUtil';
 
 import PersonnelSelectionDialog from '../components/personnel/PersonnelSelectionDialog.vue';
 import { useGameFeedback } from '../composables/useGameFeedback';

app/game-frontend/src/views/NationSecretView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import { trpc } from '../utils/trpc';
 type Result = Awaited<ReturnType<typeof trpc.nation.getSecretGeneralList.query>>;

app/game-frontend/src/views/PastPlaysView.vue

@@ -1,7 +1,10 @@
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue';
 
-import { isLegacyArchiveProfile, type LegacyArchiveProfile } from '@sammo-ts/common';
+import {
+    isLegacyArchiveProfile,
+    type LegacyArchiveProfile,
+} from '@sammo-ts/common/legacyArchive/ArchivedGeneralSnapshot';
 
 import GeneralBasicCard from '../components/main/GeneralBasicCard.vue';
 import GeneralBattleSummary, { type GeneralBattleSummaryData } from '../components/main/GeneralBattleSummary.vue';

app/game-frontend/src/views/SurveyView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
 

app/game-frontend/src/views/TournamentView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import TournamentBracket from '../components/tournament/TournamentBracket.vue';
 import TournamentPageHeader from '../components/tournament/TournamentPageHeader.vue';

app/game-frontend/src/views/TrafficView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
 

app/game-frontend/src/views/TroopView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
 

app/gateway-frontend/src/router/index.ts

@@ -1,12 +1,13 @@
 import { createRouter, createWebHistory } from 'vue-router';
-import HomeView from '../views/HomeView.vue';
-import LobbyView from '../views/LobbyView.vue';
-import AdminOverviewView from '../views/AdminOverviewView.vue';
-import AdminView from '../views/AdminView.vue';
-import ServerOperationsView from '../views/ServerOperationsView.vue';
-import AccountView from '../views/AccountView.vue';
-import OAuthCallbackView from '../views/OAuthCallbackView.vue';
-import SignupView from '../views/SignupView.vue';
+
+const HomeView = () => import('../views/HomeView.vue');
+const LobbyView = () => import('../views/LobbyView.vue');
+const AdminOverviewView = () => import('../views/AdminOverviewView.vue');
+const AdminView = () => import('../views/AdminView.vue');
+const ServerOperationsView = () => import('../views/ServerOperationsView.vue');
+const AccountView = () => import('../views/AccountView.vue');
+const OAuthCallbackView = () => import('../views/OAuthCallbackView.vue');
+const SignupView = () => import('../views/SignupView.vue');
 
 const router = createRouter({
     history: createWebHistory(import.meta.env.BASE_URL),

app/gateway-frontend/src/utils/formatLog.ts

@@ -1,3 +1,3 @@
-import { formatLegacyLogHtml } from '@sammo-ts/common';
+import { formatLegacyLogHtml } from '@sammo-ts/common/logging/formatLegacyLogHtml';
 
 export const formatLog = (text: string): string => formatLegacyLogHtml(text);

app/gateway-frontend/src/utils/gameTrpc.ts

@@ -1,4 +1,4 @@
-import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common';
+import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common/http/trpcTransport';
 import { createTRPCProxyClient, httpBatchLink } from '@trpc/client';
 import type { appRouter } from '@sammo-ts/game-api';
 
@@ -9,9 +9,7 @@ const resolveProfileUrl = (template: string, profile: string): string =>
 
 export const createGameTrpc = (profile: string, port: number, gameToken?: string) => {
     const urlTemplate = import.meta.env.VITE_GAME_API_URL_TEMPLATE;
-    const url = urlTemplate
-        ? resolveProfileUrl(urlTemplate, profile)
-        : `http://localhost:${port}/api/trpc`;
+    const url = urlTemplate ? resolveProfileUrl(urlTemplate, profile) : `http://localhost:${port}/api/trpc`;
     return createTRPCProxyClient<GameRouter>({
         links: [
             httpBatchLink({

app/gateway-frontend/src/utils/trpc.ts

@@ -1,4 +1,4 @@
-import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common';
+import { trpcJsonBodyHttpClientOptions } from '@sammo-ts/common/http/trpcTransport';
 import { createTRPCProxyClient, httpBatchLink, httpLink } from '@trpc/client';
 import type { AppRouter } from '@sammo-ts/gateway-api';
 

app/gateway-frontend/src/views/AccountView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue';
 import { useRouter } from 'vue-router';
 

app/gateway-frontend/src/views/AdminView.vue

@@ -1,11 +1,10 @@
 <script setup lang="ts">
 import {
     formatServerDateTime,
-    gatewayProfileCapabilities,
     serverDateTimeInputToIso,
     toServerDateTimeInputValue,
-    type GatewayProfileStatus,
-} from '@sammo-ts/common';
+} from '@sammo-ts/common/time/ServerDateTime';
+import { gatewayProfileCapabilities, type GatewayProfileStatus } from '@sammo-ts/common/gateway/profileStatus';
 import { computed, onMounted, ref, watch } from 'vue';
 import ServerProfileTabs from '../components/ServerProfileTabs.vue';
 import AdminConsoleLayout from '../layouts/AdminConsoleLayout.vue';

app/gateway-frontend/src/views/HomeView.vue

@@ -3,7 +3,7 @@ import { computed, onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
 import type { inferRouterOutputs } from '@trpc/server';
 import type { AppRouter } from '@sammo-ts/gateway-api';
-import { gatewayProfileCapabilities } from '@sammo-ts/common';
+import { gatewayProfileCapabilities } from '@sammo-ts/common/gateway/profileStatus';
 
 import MapPreview from '../components/MapPreview.vue';
 import KakaoOtpDialog from '../components/KakaoOtpDialog.vue';

app/gateway-frontend/src/views/LobbyView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime } from '@sammo-ts/common';
+import { formatServerDateTime } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, ref, onMounted, onUnmounted, watch } from 'vue';
 import { useRouter } from 'vue-router';
 import type { inferRouterOutputs } from '@trpc/server';

app/gateway-frontend/src/views/ServerOperationsView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { formatServerDateTime, serverDateTimeInputToIso } from '@sammo-ts/common';
+import { formatServerDateTime, serverDateTimeInputToIso } from '@sammo-ts/common/time/ServerDateTime';
 import { computed, nextTick, onBeforeUnmount, onMounted, reactive, ref, watch } from 'vue';
 
 import CompactHelp from '../components/CompactHelp.vue';

app/gateway-frontend/test/routerLoading.test.mjs

@@ -0,0 +1,25 @@
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { describe, it } from 'node:test';
+
+const routerSourcePath = path.resolve(import.meta.dirname, '../src/router/index.ts');
+
+void describe('gateway route loading contract', () => {
+    void it('loads view components through route-level dynamic imports', async () => {
+        const source = await readFile(routerSourcePath, 'utf8');
+        const staticViewImports = [...source.matchAll(/^import\s+.+\s+from\s+['"]\.\.\/views\//gm)];
+        const lazyViewComponents = new Set(
+            [...source.matchAll(/^const\s+([A-Z][A-Za-z0-9]+View)\s*=\s*\(\)\s*=>\s*import\(['"]\.\.\/views\//gm)].map(
+                (match) => match[1]
+            )
+        );
+        const routedViewComponents = new Set(
+            [...source.matchAll(/^\s*component:\s*([A-Z][A-Za-z0-9]+View),?$/gm)].map((match) => match[1])
+        );
+
+        assert.deepEqual(staticViewImports, []);
+        assert.deepEqual(lazyViewComponents, routedViewComponents);
+        assert.ok(lazyViewComponents.size >= 8);
+    });
+});