refactor: api change

src/samples/tic-tac-toe.ts

@@ -1,4 +1,7 @@
-import {createGameCommandRegistry, Part, MutableSignal, createRegion, createPart, isCellOccupied as isCellOccupiedUtil} from '@/index';
+import {
+    createGameCommandRegistry, Part, createRegion, createPart, isCellOccupied as isCellOccupiedUtil,
+    registerGameCommand, IGameContext
+} from '@/index';
 
 const BOARD_SIZE = 3;
 const MAX_TURNS = BOARD_SIZE * BOARD_SIZE;
@@ -31,33 +34,30 @@ export function createInitialState() {
     };
 }
 export type TicTacToeState = ReturnType<typeof createInitialState>;
-const registration = createGameCommandRegistry<TicTacToeState>();
-export const registry = registration.registry;
+export type TicTacToeGame = IGameContext<TicTacToeState>;
+export const registry = createGameCommandRegistry<TicTacToeState>();
 
-registration.add('setup', async function() {
-    const {context} = this;
+registerGameCommand(registry, 'setup', async function() {
     while (true) {
-        const currentPlayer = context.value.currentPlayer;
-        const turnNumber = context.value.turn + 1;
+        const currentPlayer = this.value.currentPlayer;
+        const turnNumber = this.value.turn + 1;
         const turnOutput = await this.run<{winner: WinnerType}>(`turn ${currentPlayer} ${turnNumber}`);
         if (!turnOutput.success) throw new Error(turnOutput.error);
 
-        context.produce(state => {
+        this.produce(state => {
             state.winner = turnOutput.result.winner;
             if (!state.winner) {
                 state.currentPlayer = state.currentPlayer === 'X' ? 'O' : 'X';
                 state.turn = turnNumber;
             }
         });
-        if (context.value.winner) break;
+        if (this.value.winner) break;
     }
 
-    return context.value;
+    return this.value;
 });
 
-registration.add('turn <player> <turn:number>', async function(cmd) {
-    const [turnPlayer, turnNumber] = cmd.params as [PlayerType, number];
-
+registerGameCommand(registry, 'turn <player:string> <turnNumber:int>', async function turn(turnPlayer: PlayerType, turnNumber: number) {
     const playCmd = await this.prompt(
         'play <player> <row:number> <col:number>',
         (command) => {
@@ -69,18 +69,18 @@ registration.add('turn <player> <turn:number>', async function(cmd) {
             if (!isValidMove(row, col)) {
                 return `Invalid position: (${row}, ${col}). Must be between 0 and ${BOARD_SIZE - 1}.`;
             }
-            if (isCellOccupied(this.context, row, col)) {
+            if (isCellOccupied(this, row, col)) {
                 return `Cell (${row}, ${col}) is already occupied.`;
             }
             return null;
         },
-        this.context.value.currentPlayer
+        this.value.currentPlayer
     );
     const [player, row, col] = playCmd.params as [PlayerType, number, number];
 
-    placePiece(this.context, row, col, turnPlayer);
+    placePiece(this, row, col, turnPlayer);
 
-    const winner = checkWinner(this.context);
+    const winner = checkWinner(this);
     if (winner) return { winner };
     if (turnNumber >= MAX_TURNS) return { winner: 'draw' as WinnerType };
 
@@ -91,7 +91,7 @@ function isValidMove(row: number, col: number): boolean {
     return !isNaN(row) && !isNaN(col) && row >= 0 && row < BOARD_SIZE && col >= 0 && col < BOARD_SIZE;
 }
 
-export function isCellOccupied(host: MutableSignal<TicTacToeState>, row: number, col: number): boolean {
+export function isCellOccupied(host: TicTacToeGame, row: number, col: number): boolean {
     return isCellOccupiedUtil(host.value.parts, 'board', [row, col]);
 }
 
@@ -103,7 +103,7 @@ export function hasWinningLine(positions: number[][]): boolean {
     );
 }
 
-export function checkWinner(host: MutableSignal<TicTacToeState>): WinnerType {
+export function checkWinner(host: TicTacToeGame): WinnerType {
     const parts = host.value.parts;
     const partsArray = Object.values(parts);
 
@@ -117,7 +117,7 @@ export function checkWinner(host: MutableSignal<TicTacToeState>): WinnerType {
     return null;
 }
 
-export function placePiece(host: MutableSignal<TicTacToeState>, row: number, col: number, player: PlayerType) {
+export function placePiece(host: TicTacToeGame, row: number, col: number, player: PlayerType) {
     const board = host.value.board;
     const moveNumber = Object.keys(host.value.parts).length + 1;
     const piece = createPart<{ player: PlayerType }>(