//! Map parsing functionality for converting raw board layouts into structured data. use crate::constants::{MapTile, BOARD_CELL_SIZE}; use glam::IVec2; use thiserror::Error; /// Error type for map parsing operations. #[derive(Debug, Error)] pub enum ParseError { #[error("Unknown character in board: {0}")] UnknownCharacter(char), #[error("House door must have exactly 2 positions, found {0}")] InvalidHouseDoorCount(usize), } /// Represents the parsed data from a raw board layout. #[derive(Debug)] pub struct ParsedMap { /// The parsed tile layout. pub tiles: [[MapTile; BOARD_CELL_SIZE.y as usize]; BOARD_CELL_SIZE.x as usize], /// The positions of the house door tiles. pub house_door: [Option; 2], /// The positions of the tunnel end tiles. pub tunnel_ends: [Option; 2], /// Pac-Man's starting position. pub pacman_start: Option, } /// Parser for converting raw board layouts into structured map data. pub struct MapTileParser; impl MapTileParser { /// Parses a single character into a map tile. /// /// # Arguments /// /// * `c` - The character to parse /// /// # Returns /// /// The parsed map tile, or an error if the character is unknown. pub fn parse_character(c: char) -> Result { match c { '#' => Ok(MapTile::Wall), '.' => Ok(MapTile::Pellet), 'o' => Ok(MapTile::PowerPellet), ' ' => Ok(MapTile::Empty), 'T' => Ok(MapTile::Tunnel), 'X' => Ok(MapTile::Empty), // Pac-Man's starting position, treated as empty '=' => Ok(MapTile::Wall), // House door is represented as a wall tile _ => Err(ParseError::UnknownCharacter(c)), } } /// Parses a raw board layout into structured map data. /// /// # Arguments /// /// * `raw_board` - The raw board layout as an array of strings /// /// # Returns /// /// The parsed map data, or an error if parsing fails. /// /// # Errors /// /// Returns an error if the board contains unknown characters or if the house door /// is not properly defined by exactly two '=' characters. pub fn parse_board(raw_board: [&str; BOARD_CELL_SIZE.y as usize]) -> Result { let mut tiles = [[MapTile::Empty; BOARD_CELL_SIZE.y as usize]; BOARD_CELL_SIZE.x as usize]; let mut house_door = [None; 2]; let mut tunnel_ends = [None; 2]; let mut pacman_start: Option = None; for (y, line) in raw_board.iter().enumerate().take(BOARD_CELL_SIZE.y as usize) { for (x, character) in line.chars().enumerate().take(BOARD_CELL_SIZE.x as usize) { let tile = Self::parse_character(character)?; // Track special positions match tile { MapTile::Tunnel => { if tunnel_ends[0].is_none() { tunnel_ends[0] = Some(IVec2::new(x as i32, y as i32)); } else { tunnel_ends[1] = Some(IVec2::new(x as i32, y as i32)); } } MapTile::Wall if character == '=' => { if house_door[0].is_none() { house_door[0] = Some(IVec2::new(x as i32, y as i32)); } else { house_door[1] = Some(IVec2::new(x as i32, y as i32)); } } _ => {} } // Track Pac-Man's starting position if character == 'X' { pacman_start = Some(IVec2::new(x as i32, y as i32)); } tiles[x][y] = tile; } } // Validate house door configuration let house_door_count = house_door.iter().filter(|x| x.is_some()).count(); if house_door_count != 2 { return Err(ParseError::InvalidHouseDoorCount(house_door_count)); } Ok(ParsedMap { tiles, house_door, tunnel_ends, pacman_start, }) } }