devsam/core2026
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 게임 엔진에 Clock 인터페이스 및 관련 클래스 추가, 테스트 케이스 작성

Browse Source
This commit is contained in:
Hide_D
2025-12-28 12:48:13 +00:00
parent 4f69d31fb1
commit cbea41ffbc
9 changed files with 121 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/game-engine/package.json
+3
View File
@@ -9,6 +9,9 @@
"lint": "node -e \"console.log('lint not configured')\"",
"test": "vitest run --config vitest.config.ts"
},
"dependencies": {
"@sammo-ts/common": "workspace:*"
},
"devDependencies": {
"vitest": "^4.0.16"
}
app/game-engine/src/lifecycle/clock.ts
+1 -76
View File
@@ -1,76 +1 @@
import type { Clock } from './types.js';
export class SystemClock implements Clock {
// 시스템 시간을 기준으로 동작하는 기본 시계.
nowMs(): number {
return Date.now();
}
async sleepMs(ms: number): Promise<void> {
if (ms <= 0) {
return;
}
await new Promise((resolve) => setTimeout(resolve, ms));
}
}
export class ManualClock implements Clock {
// 테스트에서 시간을 직접 이동시키는 수동 시계.
private currentMs: number;
constructor(initialMs = 0) {
this.currentMs = initialMs;
}
nowMs(): number {
return this.currentMs;
}
async sleepMs(ms: number): Promise<void> {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
advanceMs(ms: number): void {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
setMs(ms: number): void {
this.currentMs = ms;
}
}
export class StepClock implements Clock {
// 호출마다 일정 간격씩 시간이 진행되는 시계.
private currentMs: number;
private readonly stepMs: number;
constructor(stepMs: number, initialMs = 0) {
if (stepMs <= 0) {
throw new Error('stepMs must be positive');
}
this.stepMs = stepMs;
this.currentMs = initialMs;
}
nowMs(): number {
this.currentMs += this.stepMs;
return this.currentMs;
}
async sleepMs(ms: number): Promise<void> {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
setMs(ms: number): void {
this.currentMs = ms;
}
}
export { ManualClock, StepClock, SystemClock } from '@sammo-ts/common';
app/game-engine/src/lifecycle/types.ts
+1 -4
View File
@@ -43,10 +43,7 @@ export type TurnDaemonCommand =
| { type: 'resume'; reason?: string }
| { type: 'shutdown'; reason?: string };
export interface Clock {
nowMs(): number;
sleepMs(ms: number): Promise<void>;
}
export type { Clock } from '@sammo-ts/common';
export interface TurnSchedule {
getNextTurnTime(lastTurnTime: Date): Date;
packages/common/package.json
+4 -2
View File
@@ -9,10 +9,12 @@
"build": "tsc -p tsconfig.json",
"dev": "node -e \"console.log('dev not configured')\"",
"lint": "node -e \"console.log('lint not configured')\"",
"test": "node -e \"console.log('test not configured')\""
"test": "vitest run --config vitest.config.ts"
},
"dependencies": {
"js-sha512": "^0.9.0"
},
"devDependencies": {}
"devDependencies": {
"vitest": "^4.0.16"
}
}
packages/common/src/index.ts
+1
View File
@@ -1,4 +1,5 @@
export * from './rng.js';
export * from './time/Clock.js';
export * from './util/BytesLike.js';
export * from './util/convertBytesLikeToArrayBuffer.js';
export * from './util/convertBytesLikeToUint8Array.js';
packages/common/src/time/Clock.ts
+86
View File
@@ -0,0 +1,86 @@
export interface Clock {
nowMs(): number;
sleepMs(ms: number): Promise<void>;
}
export class SystemClock implements Clock {
// 시스템 시간을 기준으로 동작하는 기본 시계.
nowMs(): number {
return Date.now();
}
async sleepMs(ms: number): Promise<void> {
if (ms <= 0) {
return;
}
await new Promise((resolve) => setTimeout(resolve, ms));
}
}
export class ManualClock implements Clock {
// 테스트에서 시간을 직접 이동시키는 수동 시계.
private currentMs: number;
constructor(initialMs = 0) {
this.currentMs = initialMs;
}
nowMs(): number {
return this.currentMs;
}
async sleepMs(ms: number): Promise<void> {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
advanceMs(ms: number): void {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
setMs(ms: number): void {
this.currentMs = ms;
}
}
export class StepClock implements Clock {
// 호출마다 일정 간격씩 시간이 진행되는 시계.
private currentMs: number;
private readonly stepMs: number;
constructor(stepMs: number, initialMs = 0) {
if (stepMs <= 0) {
throw new Error('stepMs must be positive');
}
this.stepMs = stepMs;
this.currentMs = initialMs;
}
nowMs(): number {
this.currentMs += this.stepMs;
return this.currentMs;
}
async sleepMs(ms: number): Promise<void> {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
advanceMs(ms: number): void {
if (ms <= 0) {
return;
}
this.currentMs += ms;
}
setMs(ms: number): void {
this.currentMs = ms;
}
}
app/game-engine/test/clock.test.ts → packages/common/test/clock.test.ts
+8 -1
View File
@@ -1,5 +1,6 @@
import { describe, expect, it } from 'vitest';
import { ManualClock, StepClock } from '../src/lifecycle/clock.js';
import { ManualClock, StepClock } from '../src/time/Clock.js';
describe('ManualClock', () => {
it('returns current time without advancing', () => {
@@ -37,6 +38,12 @@ describe('StepClock', () => {
expect(clock.nowMs()).toBe(1250);
});
it('advances manually', () => {
const clock = new StepClock(10, 0);
clock.advanceMs(50);
expect(clock.nowMs()).toBe(60);
});
it('rejects non-positive step', () => {
expect(() => new StepClock(0)).toThrow('stepMs must be positive');
expect(() => new StepClock(-5)).toThrow('stepMs must be positive');
packages/common/vitest.config.ts
+9
View File
@@ -0,0 +1,9 @@
import { defineConfig } from 'vitest/config';
export default defineConfig({
test: {
environment: 'node',
globals: true,
include: ['test/**/*.test.ts'],
},
});
pnpm-lock.yaml
Generated
+8
View File
@@ -18,6 +18,10 @@ importers:
app/game-api: {}
app/game-engine:
dependencies:
'@sammo-ts/common':
specifier: workspace:*
version: link:../../packages/common
devDependencies:
vitest:
specifier: ^4.0.16
@@ -34,6 +38,10 @@ importers:
js-sha512:
specifier: ^0.9.0
version: 0.9.0
devDependencies:
vitest:
specifier: ^4.0.16
version: 4.0.16(@types/node@20.19.27)
packages/infra:
dependencies: