readme.ko.md

TypeSokoban

中文 | English | 日本語

이 프로젝트는 오직 TypeScript의 타입 시스템만으로 구현된 "소코반" 게임입니다. 런타임 JavaScript 로직이 전혀 포함되어 있지 않으며, 모든 게임 로직, 맵 렌더링, 승패 판정은 컴파일 단계의 타입 검사 중에 수행됩니다.

게임 기호 설명

기호	의미
👾	주인공 (Player)
👽	목표 지점 위의 주인공 (Player on Target)
😃	상자 (Box)
😎	목표 지점 위의 상자 (Box on Target)
🕶️	목표 지점 (Target)
🎇	벽 (Wall)
🌑	바닥 (Floor)

게임 방법

게임은 TypeScript의 속성 접근(Dot Notation)을 통해 진행됩니다. src/index.ts에서 연속적인 마침표 연산으로 주인공을 제어할 수 있습니다:

1. 스테이지 선택: .stage1부터 .stage100까지 사용할 수 있습니다.
2. 이동 제어:
   • .w: 위로 이동
   • .s: 아래로 이동
   • .a: 왼쪽으로 이동
   • .d: 오른쪽으로 이동
3. 화면 확인: 이동 명령 뒤에 .over를 추가하면 IDE의 타입 힌트(Hover)에 현재 맵의 렌더링 결과가 표시됩니다.
4. 클리어 판정: 스테이지 내의 모든 상자가 목표 지점으로 옮겨지면(즉, 맵에 더 이상 😃 기호가 남지 않으면), 타입 시스템에서 .GameClear.WoW.MuchFun에 접근할 수 있게 됩니다.

예시

TypeGame
  .stage1      // 1스테이지 입장
  .s.d.d.over  // 아래로 한 칸, 오른쪽으로 두 칸 이동 후 맵 확인

핵심 구현 원리

1. 상태 머신 (src/TypeGame.ts)

게임의 핵심 로직은 Step 타입에 캡슐화되어 있습니다. 이동 방향의 앞뒤 두 칸 상태(prev2, prev1, next1, next2)에 따라 현재 칸이 다음 턴에 어떤 상태가 되어야 하는지 결정합니다.

2. 좌표 변환 (src/utils.ts)

로직을 단순화하기 위해 "왼쪽 이동" 판단 코드만 작성되었습니다. 위, 아래, 오른쪽 이동의 경우 MatrixRotateAndScale 타입을 통해 2차원 배열(행렬)을 회전/전치시켜 왼쪽 이동 문제로 변환하여 처리한 뒤, 다시 원래 위치로 회전시킵니다.

3. 재귀적 렌더링 (src/utils.ts)

• Join: 튜플 타입의 한 행 기호들을 하나의 긴 문자열로 연결합니다.
• Render: 2차원 배열을 중첩된 객체 구조로 변환하여 IDE의 타입 미리보기에서 여러 줄 문자열로 맵이 나타나도록 합니다.

개발 환경

• VSCode 사용을 권장합니다.
• TypeScript 버전 4.1 이상(Template Literal Types 지원)이 필요합니다.
• src/index.ts에서 .over 속성에 마우스를 올리면 실시간으로 렌더링된 게임 화면을 볼 수 있습니다.