feat(core): 定义基础类型 — Position, Color, CellState, Move, GameConfig

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

core/src/lib.rs

@@ -1 +1,3 @@
 // Gobang core library — 纯游戏逻辑，零 GUI 依赖
+
+pub mod types;

core/src/types.rs

@@ -0,0 +1,133 @@
+use serde::{Deserialize, Serialize};
+use std::cmp::Ordering;
+
+/// 棋盘最大尺寸
+pub const MAX_BOARD_SIZE: usize = 19;
+
+/// 棋子颜色
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
+pub enum Color {
+    Black,
+    White,
+}
+
+impl Color {
+    /// 切换颜色 (黑→白, 白→黑)
+    pub fn opponent(self) -> Self {
+        match self {
+            Color::Black => Color::White,
+            Color::White => Color::Black,
+        }
+    }
+}
+
+/// 棋盘位置 (0-based)
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
+pub struct Position {
+    pub x: usize,
+    pub y: usize,
+}
+
+impl Position {
+    pub fn new(x: usize, y: usize) -> Self {
+        Self { x, y }
+    }
+}
+
+impl PartialOrd for Position {
+    fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
+        Some(self.cmp(other))
+    }
+}
+
+impl Ord for Position {
+    fn cmp(&self, other: &Self) -> Ordering {
+        self.x.cmp(&other.x).then(self.y.cmp(&other.y))
+    }
+}
+
+/// 棋盘格状态
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
+pub enum CellState {
+    Empty,
+    Occupied(Color),
+}
+
+/// 一步棋
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Move {
+    pub position: Position,
+    pub color: Color,
+    pub turn: u32,
+}
+
+/// 落子错误
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum MoveError {
+    OutOfBounds,
+    Occupied,
+    ForbiddenMove,
+    GameOver,
+}
+
+impl std::fmt::Display for MoveError {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        let msg = match self {
+            MoveError::OutOfBounds => "坐标超出棋盘范围",
+            MoveError::Occupied => "该位置已有棋子",
+            MoveError::ForbiddenMove => "禁手位置，不能落子",
+            MoveError::GameOver => "游戏已结束",
+        };
+        write!(f, "{}", msg)
+    }
+}
+
+/// 落子结果
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct MoveResult {
+    pub position: Position,
+    pub is_win: bool,
+    pub is_forbidden: bool,
+}
+
+/// 游戏结果
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GameResult {
+    pub winner: Option<Color>,
+    pub win_positions: Vec<Position>,
+}
+
+/// 游戏模式 (Tauri IPC 兼容 — 纯标签, 不含字段)
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum GameMode {
+    Local,
+    VsAi,
+    Online,
+    Replay,
+}
+
+/// 游戏配置
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GameConfig {
+    pub board_size: usize,
+    pub use_forbidden_rules: bool,
+    pub use_timer: bool,
+    pub time_limit_secs: u32,
+    pub ai_difficulty: u32,
+    pub player_color: Color,
+    pub is_server: bool,
+}
+
+impl Default for GameConfig {
+    fn default() -> Self {
+        Self {
+            board_size: 15,
+            use_forbidden_rules: true,
+            use_timer: false,
+            time_limit_secs: 60,
+            ai_difficulty: 3,
+            player_color: Color::Black,
+            is_server: false,
+        }
+    }
+}