참고 자료 및 출처

대한장기협회 · Korea Janggi Association

협회의 대국 규정은 점수 계산과 반복, 빅장의 30점 조건, 그리고 궁이 말을 잡은 뒤의 예외에 참고가 되었습니다.

• 기물행마법 (보관본)
• 대국 규정 (2013년 보관본)
• 대국 규칙 (2011년 보관본)

대한장기연맹 · Korean Janggi Federation

별도의 연맹입니다. 2020년 개정에서 대회의 무승부를 없애 점수 기준 해석의 근거가 되었고, 2022년 개정은 한수쉼과 연속 두 번의 한수쉼 뒤 정산을 명확히 했습니다.

• 2022년 규칙 개정

Wikipedia contributors · Janggi / 장기

영어판과 한국어판 문서로 판, 말의 움직임, 점수, 한의 덤 1.5점, 일상적인 대국 방식을 교차 확인했습니다. 커뮤니티의 설명은 연맹 규정과 다를 때가 있습니다.

• 장기 (한국어판)

PyChess Variants contributors

실제로 동작하는 장기 구현이자 이해하기 쉬운 게임 설명입니다. 궁성 대각선에서의 포의 움직임, 판정, 상차림 선택을 확인할 때 참고했습니다. 상차림 이름은 판의 방향을 비교할 때 주의가 필요합니다. 영어 자료입니다.

• 장기 설명서 소스 (영어)
• 상차림 화면 소스 (영어)

이 게임의 규칙 해석

각 말의 움직임을 추적하고, 자료끼리 다른 부분에서 내린 결정을 설명하는 연구 노트입니다. 일반과 점수제의 차이도 다룹니다. 영어 자료입니다.

장하영 · Jang Ha-young, writing in 서산시대

프로 기사의 칼럼으로, 해설이 달린 기보와 포진 통계, 맞상에 대한 논의를 제공했습니다. 기보 덕분에 어떤 설명이 실제로 어느 쪽 판 방향을 뜻하는지 가릴 수 있었습니다. 칼럼끼리도 일부 이름이 다릅니다.

• 대표 포진의 핵심 개념
• 쌍마 포진에 대한 대응
• 초반의 마와 상

Korean Wikipedia & Wikimedia Commons contributors

상 문서와 상차림 도해에서 왼상차림의 정확한 배치를 확인했습니다. 영어판 상차림 틀은 위키백과가 양쪽 진영을 어떻게 그리는지 확인하는 데 도움이 되었습니다.

• 양상 판 도해
• 영어판 장기 상차림 틀

한게임 · 장기 용어 사전

네 가지 상차림의 한국어 이름과 포진 용어, 처음 배치와 전개된 포진의 구분을 참고했습니다. 판의 방향이 늘 명시되어 있지는 않습니다.

BrainTV · 포진과 그 장점

다섯 가지 포진과 그 장단점에 대한 설명은 처음 배치와 거기서 이어지는 포진을 연결하는 데 도움이 되었습니다.

보조 커뮤니티 자료 · 나무위키

나무위키와 장기 게시판으로 맞상과 엇상의 일상적인 쓰임을 비교했습니다. 조사 당시 검색 요약으로만 볼 수 있었기 때문에, 비교를 뒷받침할 뿐 규칙을 정하지는 않습니다.

• 나무위키 용어 문서
• 장기 커뮤니티 토론

The Chess Variant Pages & Korean Wikibooks contributors

상차림 순서, 열여섯 가지 조합, 전개된 포진에 대한 추가 배경 자료입니다. The Chess Variant Pages의 글은 보관본으로 봐야 할 수도 있습니다. 위키책을 제외하면 영어 자료입니다.

• 상차림 (보관본)
• 위키책: 초반 포진법

이 게임의 상차림 이름

도해, 번역한 구절, 풀이한 기보, 각 자료의 근거에 대한 평가를 담은 전체 비교입니다. 영어 자료입니다.

Fairy-Stockfish

이 오픈 소스 엔진이 봇의 수를 탐색합니다. 엔진에 내장된 장기 변형은 빅장과 반복에서 이 게임과 다르기 때문에, 심판은 이 게임의 자체 엔진이 맡습니다.

• 엔진과 함께 제공되는 라이선스
• Fairy-Stockfish와 Stockfish 제작자
• Stockfish 프로젝트

fairy-stockfish-nnue.wasm

WebAssembly 이식판 덕분에 엔진이 브라우저 안에서, 사용자의 기기로 실행됩니다. 배포된 엔진 파일은 라이선스와 제작자 목록과 함께 수정 없이 제공됩니다.

Guido Zuidhof & coi-serviceworker contributors

GitHub Pages 같은 호스팅에서 멀티스레드 WebAssembly를 가능하게 하는 서비스 워커 기법에 대한 감사입니다. 이 게임은 이 라이브러리를 설치하지 않고 같은 방식을 자체 서비스 워커로 구현했습니다.

봇을 이 게임의 규칙에 맞춘 방법

엔진 변형, 수 검증, 명목상의 실력, 설치형 웹 앱에서 엔진을 실행하는 방법에 대한 노트입니다.

React & React DOM

판과 조작 버튼, 그리고 이 페이지를 그립니다. React Hooks ESLint 플러그인은 훅의 사용 방식을 검사합니다.

Redux Toolkit

대국, 환경설정, 결과를 예측 가능한 상태 변화로 관리합니다.

React Redux

React 화면을 게임에 저장된 상태와 연결합니다.

clsx

선택, 수, 화면 상태를 표시하는 데 쓰는 클래스 이름을 조합합니다.

Tailwind CSS와 Vite 플러그인

판과 그 주변 화면의 스타일 유틸리티를 제공합니다.

Vite

개발 중에 앱을 제공하고, GitHub Pages에 배포할 파일을 빌드합니다.

• React 플러그인 (MIT)

Vite PWA

서비스 워커를 빌드하고 등록하며, 설치형 앱의 매니페스트를 생성합니다.

Workbox

빌드, 프리캐싱, 라우팅, 윈도 패키지로 앱을 오프라인에서도 쓸 수 있게 합니다.

TypeScript

게임, 화면, 테스트가 함께 쓰는 타입을 검사합니다.

pnpm

버전이 고정된 의존성을 설치하고 워크스페이스의 명령을 실행합니다.

Playwright

데스크톱과 모바일 화면 크기의 실제 브라우저로 인수 테스트를 실행합니다.

Vitest

규칙과 화면 뒤의 판단을 포함한 단위 테스트를 실행합니다.

Testing Library

React Testing Library, DOM Testing Library, jest-dom은 커스텀 훅 테스트와 그 검증을 돕습니다.

• DOM Testing Library
• jest-dom

fast-check

규칙 오류를 찾기 위해 무작위 대국과 국면을 만들고, 실패 사례를 더 작은 예로 줄입니다.

jsdom

Node에서 실행되는 훅 테스트에 브라우저와 비슷한 문서를 제공합니다.

ESLint & @eslint/js

코드 품질을 검사하고 워크스페이스 패키지 사이의 경계를 지키게 합니다.

typescript-eslint

ESLint가 TypeScript를 이해하고 타입에 따른 규칙을 검사할 수 있게 합니다.

ESLint React

React 컴포넌트가 올바른지 검사합니다.

globals

어떤 전역 이름이 브라우저와 Node에 속하는지 린트 설정에 알려 줍니다.

Prettier

코드를 일관되게 정리합니다. 서식 규칙과 린트 규칙의 충돌은 eslint-config-prettier 덕분에 생기지 않습니다.

• eslint-config-prettier

DefinitelyTyped contributors

프로젝트 전반에 쓰이는 React, React DOM, Node의 타입 정의를 관리합니다.