https://github.com/sunfish-shogi/tsshogi
https://github.com/sunfish-shogi/tsshogi
nodejs shogi typescript
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/sunfish-shogi/tsshogi
- Owner: sunfish-shogi
- License: mit
- Created: 2023-11-26T14:26:28.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-13T17:12:21.000Z (7 months ago)
- Last Synced: 2025-04-18T20:21:05.453Z (7 months ago)
- Topics: nodejs, shogi, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/tsshogi
- Size: 695 KB
- Stars: 9
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tsshogi
[](https://github.com/sunfish-shogi/tsshogi/actions/workflows/test.yml)
[](https://codecov.io/gh/sunfish-shogi/tsshogi)
将棋のアプリを開発するために作られたライブラリです。
KIF や KI2、CSA、JKF、SFEN/USI といった幅広いフォーマットでの入出力に対応しており、分岐や消費時間、コメントなど、それらのフォーマットで用いられるほとんどの表現に対応しています。
## インストール
```
npm install tsshogi
```
## 基本的な使用方法
```.ts
import fs from "node:fs";
import { importKIF } from "tsshogi";
/*
* .kifu ファイルを読み込む。
*/
// NOTE: .kif ファイルの場合は Shift-JIS から UTF-8 に変換する必要がある。
const data = fs.readFileSync("sample.kifu", "utf-8");
const record = importKIF(data);
if (record instanceof Error) {
throw record;
}
/*
* 指し手を表示用の形式で出力する。
*
* 出力:
* 1 ☗２六歩
* 2 ☖８四歩
* 3 ☗２五歩
* 4 ☖８五歩
* 5 ☗７八金
* 6 中断
*/
while (record.goForward()) {
// NOTE: record.current は現在の指し手、record.position は現在の局面を表す。
console.log(record.current.ply, record.current.displayText);
}
/*
* 指し手を追加する。
*/
const move = record.position.createMoveByUSI("4a3b");
if (!move) {
throw new Error("Invalid SFEN");
}
// NOTE: 合法手チェックをしない場合は ignoreValidation オプションを指定する。
if (!record.append(move)) {
throw new Error("Illegal move");
}
```
## 棋譜の構造
棋譜は 1 手が 1 ノードとなるような木構造で表されています。
前後の指し手は `next` プロパティと `prev` プロパティで相互に参照を持っています。
分岐は兄弟ノードからの `branch` プロパティで参照されています。
指し手を進めたり戻したりするのは `Record.goForward` や `Record.goBack`, `Record.goto` を使います。
分岐は `Record.switchBranchByIndex` で切り替えることができます。
## 主なデータ型
### `class Record`
棋譜を表すクラスです。分岐付きのKIF形式と同等の情報に加えて、現在の局面を管理します。
### `class Position`
局面を表すクラスです。
### `class Board`
盤面を表すクラスです。
### `class Hand`
駒台を表すクラスです。
### `class Move`
指し手を表すクラスです。手番や動かした駒の種類、取られた駒の情報も含みます。
### `class Square`
盤上のマス目を表すクラスです。
### `enum Color`
手番を表す列挙体です。
## 読み取り専用型
接頭辞 `Immutable` が付いた interface 型は各クラスの読み取り専用インターフェースです。
値を変更するコードを書きにくくなるだけで、変更されないことを保証するものではありません。
## 補助的な関数や定数
### `function detectRecordFormat`
文字列から棋譜のフォーマットを判別します。
### `enum InitialPositionSFEN`
一般的に用いられる初形配置の SFEN です。
### `function countExistingPieces`
局面に配置された駒を種類ごとに数えます。
### `function countNotExistingPieces`
平手と比べて不足している駒の枚数を数えます。
### `function countJishogiPoint`
持将棋の合意に適用される点数を計算します。
### `function countJishogiDeclarationPoint`
入玉宣言法の判定に適用される点数を計算します。
### `function judgeJishogiDeclaration`
入玉宣言法の合否を判定します。
### `function getBlackPlayerName`
先手または下手の対局者名をフルネーム優先で取得します。
### `function getWhitePlayerName`
後手または上手の対局者名をフルネーム優先で取得します。
### `function getBlackPlayerNamePreferShort`
先手または下手の対局者名を省略表記優先で取得します。
### `function getWhitePlayerNamePreferShort`
後手または上手の対局者名を省略表記優先で取得します。
## 注意点
文字コードの変換機能はありません。Shift_JIS でエンコードされた .kif ファイルや .ki2 ファイルがあることに注意してください。
CSA 形式棋譜フォーマットでは 1 つのファイルに複数の棋譜を埋め込むことが可能ですが、 tsshogi では最初の 1 件しか読み込みません。
全ての棋譜を読み込む場合は、セパレーターが書かれている行で分割してから個別に読み込ませてください。
## ライセンス
[MIT License](LICENSE)