Skip to main content

flatland_client_ui/
world.rs

1use crate::color::RgbColor;
2use flatland_client_lib::GameState;
3use flatland_protocol::{BuildingView, InteriorMapView, TerrainKindView};
4
5use crate::map_presentation::{self, MapPresentation};
6
7/// The TUI map uses one terminal cell per world meter on both axes so terrain, entities,
8/// resources, and mouse targeting share the same grid. Terminal fonts are taller than wide,
9/// so buildings look vertically stretched compared to the content-admin editor.
10
11pub struct WorldView {
12    pub width: usize,
13    pub height: usize,
14    pub cells: Vec<String>,
15    /// Per-cell foreground color from presentation catalog (None = entity-specific style).
16    pub cell_fg: Vec<Option<RgbColor>>,
17    /// T1 target ring (red).
18    pub target_t1_cells: Vec<bool>,
19    /// T2 target ring (blue).
20    pub target_t2_cells: Vec<bool>,
21    pub origin_x: f32,
22    pub origin_y: f32,
23    pub inside_building: Option<String>,
24}
25
26/// Presentation flags for [`WorldView::build_with_options`].
27#[derive(Debug, Clone, Copy)]
28pub struct WorldViewOptions {
29    /// Paint local player `@` at view center (TUI). Gfx uses a sprite instead.
30    pub paint_local_player: bool,
31    /// Paint NPCs, resources, loot, chests, quest boards, entities into the cell grid.
32    /// Gfx sets this false and draws those at continuous world coordinates.
33    pub paint_overlays: bool,
34}
35
36impl Default for WorldViewOptions {
37    fn default() -> Self {
38        Self {
39            paint_local_player: true,
40            paint_overlays: true,
41        }
42    }
43}
44
45impl WorldViewOptions {
46    /// Terrain / walls only — gfx draws movers at precise x,y.
47    pub fn terrain_only() -> Self {
48        Self {
49            paint_local_player: false,
50            paint_overlays: false,
51        }
52    }
53}
54
55impl WorldView {
56    pub fn build_with_target(
57        state: &GameState,
58        view_w: usize,
59        view_h: usize,
60        map_target: Option<(f32, f32)>,
61    ) -> Self {
62        Self::build_with_options(
63            state,
64            view_w,
65            view_h,
66            map_target,
67            WorldViewOptions::default(),
68        )
69    }
70
71    /// Like [`build_with_target`] with gfx/TUI presentation flags.
72    pub fn build_with_options(
73        state: &GameState,
74        view_w: usize,
75        view_h: usize,
76        map_target: Option<(f32, f32)>,
77        options: WorldViewOptions,
78    ) -> Self {
79        let (px, py) = state.player_position();
80        Self::build_with_anchor(state, view_w, view_h, px, py, map_target, options)
81    }
82
83    /// Build a view anchored at explicit world coordinates (gfx uses smoothed camera).
84    pub fn build_with_anchor(
85        state: &GameState,
86        view_w: usize,
87        view_h: usize,
88        anchor_x: f32,
89        anchor_y: f32,
90        map_target: Option<(f32, f32)>,
91        options: WorldViewOptions,
92    ) -> Self {
93        map_presentation::maybe_reload_for_content_rev(state.content_rev);
94        let px = anchor_x;
95        let py = anchor_y;
96        let inside_building = state.effective_inside_building();
97
98        let width = view_w.max(3);
99        let height = view_h.max(3);
100        let grass = map_presentation::terrain_for(TerrainKindView::Grass);
101        let mut cells = vec![grass.glyph.clone(); width * height];
102        let mut cell_fg = vec![Some(grass.color); width * height];
103
104        let half_w = (width / 2) as i32;
105        let half_h = (height / 2) as i32;
106
107        // Interior rendering is authoritative from `inside_building`, not stale `interior_map`.
108        if let (Some(_bid), Some(interior)) =
109            (inside_building.as_deref(), state.interior_map.as_ref())
110        {
111            paint_interior_background(&mut cells, &mut cell_fg, width, height, interior);
112            paint_interior_rooms(
113                &mut cells,
114                &mut cell_fg,
115                width,
116                height,
117                interior,
118                px,
119                py,
120                half_w,
121                half_h,
122            );
123            let door_gaps = interior_door_gaps(interior, &state.doors);
124            for room in &interior.rooms {
125                paint_building_walls(
126                    &mut cells,
127                    &mut cell_fg,
128                    width,
129                    height,
130                    room.x0,
131                    room.y0,
132                    room.x1 - room.x0,
133                    room.y1 - room.y0,
134                    px,
135                    py,
136                    half_w,
137                    half_h,
138                    &door_gaps,
139                );
140            }
141        } else {
142            paint_terrain(
143                &mut cells,
144                &mut cell_fg,
145                width,
146                height,
147                state,
148                px,
149                py,
150                half_w,
151                half_h,
152            );
153
154            for building in &state.buildings {
155                if building.tags.iter().any(|t| t == "well") {
156                    paint_well(
157                        &mut cells,
158                        &mut cell_fg,
159                        width,
160                        height,
161                        building,
162                        px,
163                        py,
164                        half_w,
165                        half_h,
166                    );
167                } else {
168                    paint_building_walls_centered(
169                        &mut cells,
170                        &mut cell_fg,
171                        width,
172                        height,
173                        building,
174                        px,
175                        py,
176                        half_w,
177                        half_h,
178                    );
179                }
180            }
181        }
182
183        if options.paint_overlays {
184            for door in &state.doors {
185                if let Some((gx, gy)) =
186                    world_to_grid(door.x, door.y, px, py, half_w, half_h, width, height)
187                {
188                    let idx = gy * width + gx;
189                    paint_presentation(
190                        &mut cells,
191                        &mut cell_fg,
192                        idx,
193                        &map_presentation::door_presentation(door.open),
194                    );
195                }
196            }
197
198            for npc in &state.npcs {
199                if let Some((gx, gy)) =
200                    world_to_grid(npc.x, npc.y, px, py, half_w, half_h, width, height)
201                {
202                    let idx = gy * width + gx;
203                    paint_presentation(
204                        &mut cells,
205                        &mut cell_fg,
206                        idx,
207                        &map_presentation::npc_for(npc),
208                    );
209                }
210            }
211
212            let ground = empty_ground_glyph();
213            let player_glyph = map_presentation::player_presentation().glyph;
214            for node in &state.resource_nodes {
215                if let Some((gx, gy)) =
216                    world_to_grid(node.x, node.y, px, py, half_w, half_h, width, height)
217                {
218                    let idx = gy * width + gx;
219                    let pres = map_presentation::resource_for(node);
220                    if can_paint_world_object(&cells[idx], &ground, &player_glyph) {
221                        paint_presentation(&mut cells, &mut cell_fg, idx, &pres);
222                    }
223                }
224            }
225
226            for drop in &state.ground_drops {
227                if let Some((gx, gy)) =
228                    world_to_grid(drop.x, drop.y, px, py, half_w, half_h, width, height)
229                {
230                    let idx = gy * width + gx;
231                    if can_paint_world_object(&cells[idx], &ground, &player_glyph) {
232                        paint_presentation(
233                            &mut cells,
234                            &mut cell_fg,
235                            idx,
236                            &map_presentation::loot_presentation(),
237                        );
238                    }
239                }
240            }
241
242            for chest in &state.placed_containers {
243                if let Some((gx, gy)) =
244                    world_to_grid(chest.x, chest.y, px, py, half_w, half_h, width, height)
245                {
246                    let idx = gy * width + gx;
247                    if can_paint_world_object(&cells[idx], &ground, &player_glyph) {
248                        paint_presentation(
249                            &mut cells,
250                            &mut cell_fg,
251                            idx,
252                            &map_presentation::chest_presentation(chest.locked),
253                        );
254                    }
255                }
256            }
257
258            if state.effective_inside_building().is_none() {
259                for inter in &state.interactables {
260                    if inter.kind != "quest_board" {
261                        continue;
262                    }
263                    if let Some((gx, gy)) =
264                        world_to_grid(inter.x, inter.y, px, py, half_w, half_h, width, height)
265                    {
266                        let idx = gy * width + gx;
267                        if can_paint_world_object(&cells[idx], &ground, &player_glyph) {
268                            paint_presentation(
269                                &mut cells,
270                                &mut cell_fg,
271                                idx,
272                                &map_presentation::quest_board_presentation(),
273                            );
274                        }
275                    }
276                }
277            }
278
279            for entity in &state.entities {
280                // When gfx draws a sprite for the local player, omit the `@` glyph.
281                if !options.paint_local_player && entity.id == state.entity_id {
282                    continue;
283                }
284                if let Some(pres) = entity_presentation(entity, state.entity_id) {
285                    if let Some((gx, gy)) = world_to_grid(
286                        entity.transform.position.x,
287                        entity.transform.position.y,
288                        px,
289                        py,
290                        half_w,
291                        half_h,
292                        width,
293                        height,
294                    ) {
295                        let idx = gy * width + gx;
296                        paint_presentation(&mut cells, &mut cell_fg, idx, &pres);
297                    }
298                }
299            }
300        }
301
302        if options.paint_local_player {
303            if state.player_entity().is_some() {
304                let cx = half_w as usize;
305                let cy = half_h as usize;
306                let idx = cy * width + cx;
307                if idx < cells.len() {
308                    paint_presentation(
309                        &mut cells,
310                        &mut cell_fg,
311                        idx,
312                        &map_presentation::player_presentation(),
313                    );
314                }
315            }
316        }
317
318        let mut target_t1_cells = vec![false; cells.len()];
319        let mut target_t2_cells = vec![false; cells.len()];
320        if options.paint_overlays {
321            for (slot, cells_out) in [(1, &mut target_t1_cells), (2, &mut target_t2_cells)] {
322                let target_id = state
323                    .combat_slots
324                    .iter()
325                    .find(|s| s.slot_index == slot)
326                    .and_then(|s| s.target_entity_id)
327                    .or_else(|| if slot == 1 { state.combat_target } else { None });
328                let Some(target_id) = target_id else {
329                    continue;
330                };
331                if let Some(entity) = state.entities.iter().find(|e| e.id == target_id) {
332                    if let Some((gx, gy)) = world_to_grid(
333                        entity.transform.position.x,
334                        entity.transform.position.y,
335                        px,
336                        py,
337                        half_w,
338                        half_h,
339                        width,
340                        height,
341                    ) {
342                        let idx = gy * width + gx;
343                        if idx < cells_out.len() {
344                            cells_out[idx] = true;
345                        }
346                    }
347                }
348            }
349        }
350
351        if options.paint_overlays {
352            if let Some((tx, ty)) = map_target {
353                if let Some((gx, gy)) = world_to_grid(tx, ty, px, py, half_w, half_h, width, height)
354                {
355                    let idx = gy * width + gx;
356                    if idx < cells.len() {
357                        cells[idx] = "X".into();
358                        cell_fg[idx] = Some(RgbColor::YELLOW);
359                    }
360                }
361            }
362        }
363
364        Self {
365            width,
366            height,
367            cells,
368            cell_fg,
369            target_t1_cells,
370            target_t2_cells,
371            origin_x: px,
372            origin_y: py,
373            inside_building,
374        }
375    }
376}
377
378fn paint_presentation(
379    cells: &mut [String],
380    cell_fg: &mut [Option<RgbColor>],
381    idx: usize,
382    pres: &MapPresentation,
383) {
384    cells[idx] = pres.glyph.clone();
385    cell_fg[idx] = Some(pres.color);
386}
387
388fn empty_ground_glyph() -> String {
389    map_presentation::terrain_for(TerrainKindView::Grass).glyph
390}
391
392fn entity_presentation(
393    entity: &flatland_protocol::EntityState,
394    player_id: u64,
395) -> Option<MapPresentation> {
396    if entity.id == player_id {
397        return Some(map_presentation::player_presentation());
398    }
399    if entity
400        .vitals
401        .as_ref()
402        .is_some_and(|v| v.life_state == flatland_protocol::LifeState::Dead)
403    {
404        return Some(map_presentation::corpse_presentation());
405    }
406    Some(map_presentation::entity_fallback(&entity.label))
407}
408
409fn paint_interior_background(
410    cells: &mut [String],
411    cell_fg: &mut [Option<RgbColor>],
412    _width: usize,
413    _height: usize,
414    interior: &InteriorMapView,
415) {
416    let bg = crate::color::parse_color(&interior.background_color).unwrap_or(RgbColor::BLACK);
417    for idx in 0..cells.len() {
418        cells[idx] = " ".into();
419        cell_fg[idx] = Some(bg);
420    }
421}
422
423fn paint_interior_rooms(
424    cells: &mut [String],
425    cell_fg: &mut [Option<RgbColor>],
426    width: usize,
427    height: usize,
428    interior: &InteriorMapView,
429    px: f32,
430    py: f32,
431    half_w: i32,
432    half_h: i32,
433) {
434    let default_color = interior
435        .default_floor_color
436        .as_deref()
437        .and_then(crate::color::parse_color)
438        .unwrap_or(RgbColor::rgb(0x2a, 0x2a, 0x2a));
439    for room in &interior.rooms {
440        let floor_color = room
441            .floor_color
442            .as_deref()
443            .and_then(crate::color::parse_color)
444            .unwrap_or(default_color);
445        let glyph = room.floor_glyph.as_deref().unwrap_or(".").to_string();
446        let x0 = room.x0.floor() as i32;
447        let y0 = room.y0.floor() as i32;
448        let x1 = room.x1.ceil() as i32 - 1;
449        let y1 = room.y1.ceil() as i32 - 1;
450        for wy in y0..=y1 {
451            for wx in x0..=x1 {
452                if let Some((gx, gy)) =
453                    world_to_grid(wx as f32, wy as f32, px, py, half_w, half_h, width, height)
454                {
455                    let idx = gy * width + gx;
456                    cells[idx] = glyph.clone();
457                    cell_fg[idx] = Some(floor_color);
458                }
459            }
460        }
461    }
462}
463
464fn interior_door_gaps(
465    interior: &InteriorMapView,
466    doors: &[flatland_protocol::DoorView],
467) -> Vec<(f32, f32)> {
468    let mut gaps: Vec<(f32, f32)> = interior
469        .room_doors
470        .iter()
471        .filter_map(|d| {
472            doors
473                .iter()
474                .find(|door| door.id == d.id)
475                .filter(|door| door.open)
476                .map(|door| (door.x, door.y))
477        })
478        .collect();
479    for door in doors {
480        if door.portal.is_some() && door.open {
481            gaps.push((door.x, door.y));
482        }
483    }
484    gaps
485}
486
487fn near_door_gap(wx: i32, wy: i32, door_gaps: &[(f32, f32)]) -> bool {
488    door_gaps
489        .iter()
490        .any(|(dx, dy)| (wx as f32 - dx).abs() < 0.75 && (wy as f32 - dy).abs() < 0.75)
491}
492
493fn paint_terrain(
494    cells: &mut [String],
495    cell_fg: &mut [Option<RgbColor>],
496    width: usize,
497    height: usize,
498    state: &GameState,
499    px: f32,
500    py: f32,
501    _half_w: i32,
502    _half_h: i32,
503) {
504    for gy in 0..height {
505        for gx in 0..width {
506            let Some((wx, wy)) = grid_to_world(gx, gy, px, py, width, height) else {
507                continue;
508            };
509            let zone = state.terrain_zone_at(wx, wy);
510            let kind = zone.map(|z| z.kind).unwrap_or(TerrainKindView::Grass);
511            let elev = zone.map(|z| z.elevation).unwrap_or(0.0);
512            let style = map_presentation::terrain_for_zone(
513                kind,
514                elev,
515                zone.and_then(|z| z.glyph.as_deref()),
516                zone.and_then(|z| z.color.as_deref()),
517            );
518            let idx = gy * width + gx;
519            paint_presentation(cells, cell_fg, idx, &style);
520        }
521    }
522}
523
524fn paint_well(
525    cells: &mut [String],
526    cell_fg: &mut [Option<RgbColor>],
527    width: usize,
528    height: usize,
529    building: &BuildingView,
530    px: f32,
531    py: f32,
532    half_w: i32,
533    half_h: i32,
534) {
535    let hw = building.width_m / 2.0;
536    let hd = building.depth_m / 2.0;
537    let x0 = (building.x - hw).floor() as i32;
538    let y0 = (building.y - hd).floor() as i32;
539    let x1 = (building.x + hw).ceil() as i32 - 1;
540    let y1 = (building.y + hd).ceil() as i32 - 1;
541    let water = map_presentation::shallow_water_presentation();
542    let center = map_presentation::well_center_presentation();
543
544    for wy in y0..=y1 {
545        for wx in x0..=x1 {
546            let pres = if wx == building.x.round() as i32 && wy == building.y.round() as i32 {
547                center.clone()
548            } else {
549                water.clone()
550            };
551            if let Some((gx, gy)) =
552                world_to_grid(wx as f32, wy as f32, px, py, half_w, half_h, width, height)
553            {
554                let idx = gy * width + gx;
555                if !is_wall(&cells[idx]) {
556                    paint_presentation(cells, cell_fg, idx, &pres);
557                }
558            }
559        }
560    }
561}
562
563fn paint_building_walls_centered(
564    cells: &mut [String],
565    cell_fg: &mut [Option<RgbColor>],
566    width: usize,
567    height: usize,
568    building: &BuildingView,
569    px: f32,
570    py: f32,
571    half_w: i32,
572    half_h: i32,
573) {
574    let hw = building.width_m / 2.0;
575    let hd = building.depth_m / 2.0;
576    paint_building_walls(
577        cells,
578        cell_fg,
579        width,
580        height,
581        building.x - hw,
582        building.y - hd,
583        building.width_m,
584        building.depth_m,
585        px,
586        py,
587        half_w,
588        half_h,
589        &[],
590    );
591}
592
593/// Paint perimeter walls for an axis-aligned rectangle (origin = south-west corner).
594fn paint_building_walls(
595    cells: &mut [String],
596    cell_fg: &mut [Option<RgbColor>],
597    width: usize,
598    height: usize,
599    origin_x: f32,
600    origin_y: f32,
601    width_m: f32,
602    depth_m: f32,
603    px: f32,
604    py: f32,
605    half_w: i32,
606    half_h: i32,
607    door_gaps: &[(f32, f32)],
608) {
609    let x0 = origin_x.floor() as i32;
610    let y0 = origin_y.floor() as i32;
611    let x1 = (origin_x + width_m).ceil() as i32 - 1;
612    let y1 = (origin_y + depth_m).ceil() as i32 - 1;
613
614    if x1 < x0 || y1 < y0 {
615        return;
616    }
617
618    for wx in x0..=x1 {
619        if !near_door_gap(wx, y0, door_gaps) {
620            paint_wall_cell(
621                cells, cell_fg, width, height, wx, y0, px, py, half_w, half_h, "-",
622            );
623        }
624        if !near_door_gap(wx, y1, door_gaps) {
625            paint_wall_cell(
626                cells, cell_fg, width, height, wx, y1, px, py, half_w, half_h, "-",
627            );
628        }
629    }
630    for wy in y0 + 1..y1 {
631        if !near_door_gap(x0, wy, door_gaps) {
632            paint_wall_cell(
633                cells, cell_fg, width, height, x0, wy, px, py, half_w, half_h, "|",
634            );
635        }
636        if !near_door_gap(x1, wy, door_gaps) {
637            paint_wall_cell(
638                cells, cell_fg, width, height, x1, wy, px, py, half_w, half_h, "|",
639            );
640        }
641    }
642    if !near_door_gap(x0, y0, door_gaps) {
643        paint_wall_cell(
644            cells, cell_fg, width, height, x0, y0, px, py, half_w, half_h, "+",
645        );
646    }
647    if !near_door_gap(x1, y0, door_gaps) {
648        paint_wall_cell(
649            cells, cell_fg, width, height, x1, y0, px, py, half_w, half_h, "+",
650        );
651    }
652    if !near_door_gap(x0, y1, door_gaps) {
653        paint_wall_cell(
654            cells, cell_fg, width, height, x0, y1, px, py, half_w, half_h, "+",
655        );
656    }
657    if !near_door_gap(x1, y1, door_gaps) {
658        paint_wall_cell(
659            cells, cell_fg, width, height, x1, y1, px, py, half_w, half_h, "+",
660        );
661    }
662}
663
664fn paint_wall_cell(
665    cells: &mut [String],
666    cell_fg: &mut [Option<RgbColor>],
667    width: usize,
668    height: usize,
669    wx: i32,
670    wy: i32,
671    px: f32,
672    py: f32,
673    half_w: i32,
674    half_h: i32,
675    ch: &str,
676) {
677    let Some((gx, gy)) = world_to_grid(wx as f32, wy as f32, px, py, half_w, half_h, width, height)
678    else {
679        return;
680    };
681    let idx = gy * width + gx;
682    let ground = empty_ground_glyph();
683    if cells[idx] == ground || is_wall(&cells[idx]) {
684        cells[idx] = merge_wall_corner(&cells[idx], ch, &ground);
685        cell_fg[idx] = Some(map_presentation::wall_presentation().color);
686    }
687}
688
689fn is_wall(glyph: &str) -> bool {
690    matches!(glyph.chars().next(), Some('+' | '-' | '|'))
691}
692
693/// Overlays (resources, loot, chests, boards) paint on any non-wall cell.
694fn can_paint_world_object(glyph: &str, _ground: &str, _player_glyph: &str) -> bool {
695    !is_wall(glyph)
696}
697
698fn merge_wall_corner(existing: &str, incoming: &str, ground: &str) -> String {
699    if existing == ground {
700        return incoming.to_string();
701    }
702    if existing == incoming {
703        return existing.to_string();
704    }
705    "+".to_string()
706}
707
708fn world_to_grid(
709    x: f32,
710    y: f32,
711    px: f32,
712    py: f32,
713    half_w: i32,
714    half_h: i32,
715    width: usize,
716    height: usize,
717) -> Option<(usize, usize)> {
718    let dx = (x - px).round() as i32;
719    let dy = (y - py).round() as i32;
720
721    if dx.abs() > half_w || dy.abs() > half_h {
722        return None;
723    }
724
725    let gx = half_w + dx;
726    let gy = half_h - dy;
727
728    if gx < 0 || gy < 0 {
729        return None;
730    }
731    let gx = gx as usize;
732    let gy = gy as usize;
733    if gx >= width || gy >= height {
734        return None;
735    }
736    Some((gx, gy))
737}
738
739/// Inverse of [`world_to_grid`]: map view cell → world meters (cell center).
740pub fn grid_to_world(
741    gx: usize,
742    gy: usize,
743    px: f32,
744    py: f32,
745    view_w: usize,
746    view_h: usize,
747) -> Option<(f32, f32)> {
748    if gx >= view_w || gy >= view_h {
749        return None;
750    }
751    let half_w = (view_w / 2) as i32;
752    let half_h = (view_h / 2) as i32;
753    let dx = gx as i32 - half_w;
754    let dy = half_h - gy as i32;
755    Some((px + dx as f32, py + dy as f32))
756}
757
758#[cfg(test)]
759mod tests {
760    use super::*;
761    use flatland_protocol::{
762        BuildingView, EntityState, PlayerVitals, PrimaryAttributes, Transform, WorldCoord,
763    };
764
765    fn state_with_building(building: BuildingView) -> GameState {
766        GameState {
767            session_id: 1,
768            entity_id: 1,
769            character_id: None,
770            tick: 0,
771            chunk_rev: 0,
772            content_rev: 0,
773            publish_rev: 0,
774            entities: vec![EntityState {
775                id: 1,
776                label: "You".into(),
777                transform: Transform {
778                    position: WorldCoord::surface(148.0, 118.0),
779                    yaw: 0.0,
780                    velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
781                },
782                vitals: Some(PlayerVitals::default()),
783                attributes: Some(PrimaryAttributes::default()),
784                skills: Some(flatland_protocol::PlayerSkills::default()),
785                inside_building: None,
786                tile_id: None,
787                presentation_state: None,
788                sprite_mode: None,
789                progression_xp: None,
790            }],
791            player: None,
792            resource_nodes: vec![],
793            ground_drops: vec![],
794            placed_containers: vec![],
795            buildings: vec![building],
796            doors: vec![],
797            interior_map: None,
798            npcs: vec![],
799            blueprints: vec![],
800            world_width_m: 256.0,
801            world_height_m: 256.0,
802            terrain_zones: vec![],
803            z_platforms: vec![],
804            z_transitions: vec![],
805            world_clock: flatland_protocol::WorldClock::default(),
806            inventory: Default::default(),
807            inventory_hints: Default::default(),
808            logs: Default::default(),
809            intents_sent: 0,
810            ticks_received: 0,
811            connected: true,
812            disconnect_reason: None,
813            show_stats: false,
814            show_craft_menu: false,
815            craft_menu_index: 0,
816            craft_batch_quantity: 1,
817            show_shop_menu: false,
818            shop_catalog: None,
819            shop_tab: flatland_client_lib::ShopTab::default(),
820            shop_menu_index: 0,
821            shop_quantity: 1,
822            shop_trade_log: std::collections::VecDeque::new(),
823            show_npc_verb_menu: false,
824            npc_verb_target: None,
825            npc_verb_index: 0,
826            show_npc_chat: false,
827            npc_chat: None,
828            show_inventory_menu: false,
829            inventory_menu_index: 0,
830            show_move_picker: false,
831            show_rename_prompt: false,
832            show_worker_rename: false,
833            rename_buffer: String::new(),
834            move_picker_index: 0,
835            move_picker: None,
836            show_destroy_picker: false,
837            destroy_confirm_pending: false,
838            destroy_picker: None,
839            combat_target: None,
840            combat_target_label: None,
841            in_combat: false,
842            auto_attack: true,
843            combat_has_los: false,
844            attack_cd_ticks: 0,
845            gcd_ticks: 0,
846            weapon_ability_id: "unarmed".into(),
847            mainhand_template_id: None,
848            mainhand_label: None,
849            worn: std::collections::BTreeMap::new(),
850            carry_mass: 0.0,
851            carry_mass_max: 0.0,
852            encumbrance: flatland_protocol::EncumbranceState::Light,
853            inventory_stacks: Vec::new(),
854            keychain_stacks: Vec::new(),
855            combat_target_detail: None,
856            cast_progress: None,
857            ability_cooldowns: Vec::new(),
858            blocking_active: false,
859            max_target_slots: 1,
860            combat_slots: Vec::new(),
861            rotation_presets: Vec::new(),
862            show_loadout_menu: false,
863            show_keychain_menu: false,
864            keychain_menu_index: 0,
865            show_rotation_editor: false,
866            loadout_menu_index: 0,
867            rotation_editor: Default::default(),
868            harvest_in_progress: false,
869            harvest_started_at: None,
870            pending_craft_ack: None,
871            pending_worker_job_ack: None,
872            quest_log: Vec::new(),
873            interactables: Vec::new(),
874            show_quest_offer: false,
875            pending_quest_offer: None,
876            show_quest_menu: false,
877            quest_menu_index: 0,
878            quest_withdraw_confirm: false,
879            hired_workers: Vec::new(),
880            show_workers_menu: false,
881            workers_menu_index: 0,
882            worker_step_display: std::collections::BTreeMap::new(),
883            show_worker_give_picker: false,
884            worker_give_picker_index: 0,
885            worker_give_picker: None,
886            show_worker_teach_picker: false,
887            worker_teach_picker_index: 0,
888            worker_teach_picker: None,
889            worker_route_editor: None,
890            progression_curve: None,
891        }
892    }
893
894    #[test]
895    fn shallow_water_terrain_paints_tilde() {
896        use flatland_protocol::TerrainZoneView;
897        let mut state = state_with_building(BuildingView {
898            id: "x".into(),
899            label: "X".into(),
900            x: 128.0,
901            y: 128.0,
902            width_m: 1.0,
903            depth_m: 1.0,
904            interior_blueprint: None,
905            tags: vec![],
906        });
907        state.terrain_zones.push(TerrainZoneView {
908            id: "pond".into(),
909            x0: 126.0,
910            y0: 126.0,
911            x1: 130.0,
912            y1: 130.0,
913            kind: TerrainKindView::ShallowWater,
914            elevation: -0.5,
915            glyph: None,
916            color: None,
917            tile_id: None,
918            z_order: 0,
919        });
920        state.entities = vec![EntityState {
921            id: 1,
922            label: "You".into(),
923            transform: Transform {
924                position: WorldCoord::surface(128.0, 128.0),
925                yaw: 0.0,
926                velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
927            },
928            vitals: Some(PlayerVitals::default()),
929            attributes: Some(PrimaryAttributes::default()),
930            skills: Some(flatland_protocol::PlayerSkills::default()),
931            inside_building: None,
932            tile_id: None,
933            presentation_state: None,
934            sprite_mode: None,
935            progression_xp: None,
936        }];
937        state.player = state.entities.first().cloned();
938        let view = WorldView::build_with_target(&state, 9, 9, None);
939        let flat = view.cells.join("");
940        let water = map_presentation::shallow_water_presentation();
941        assert!(
942            flat.contains(&water.glyph),
943            "expected water tiles ({:?}): {flat}",
944            water.glyph
945        );
946        assert!(
947            view.cell_fg.iter().any(|c| *c == Some(water.color)),
948            "expected water color on terrain cells"
949        );
950    }
951
952    #[test]
953    fn zone_glyph_and_color_overrides_paint_on_map() {
954        use flatland_protocol::TerrainZoneView;
955        let mut state = state_with_building(BuildingView {
956            id: "x".into(),
957            label: "X".into(),
958            x: 128.0,
959            y: 128.0,
960            width_m: 1.0,
961            depth_m: 1.0,
962            interior_blueprint: None,
963            tags: vec![],
964        });
965        state.terrain_zones.push(TerrainZoneView {
966            id: "marked".into(),
967            x0: 126.0,
968            y0: 126.0,
969            x1: 130.0,
970            y1: 130.0,
971            kind: TerrainKindView::Grass,
972            elevation: 0.0,
973            glyph: Some("%".into()),
974            color: Some("magenta".into()),
975            tile_id: None,
976            z_order: 0,
977        });
978        state.entities = vec![EntityState {
979            id: 1,
980            label: "You".into(),
981            transform: Transform {
982                position: WorldCoord::surface(128.0, 128.0),
983                yaw: 0.0,
984                velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
985            },
986            vitals: Some(PlayerVitals::default()),
987            attributes: Some(PrimaryAttributes::default()),
988            skills: Some(flatland_protocol::PlayerSkills::default()),
989            inside_building: None,
990            tile_id: None,
991            presentation_state: None,
992            sprite_mode: None,
993            progression_xp: None,
994        }];
995        state.player = state.entities.first().cloned();
996        let view = WorldView::build_with_target(&state, 9, 9, None);
997        let flat = view.cells.join("");
998        assert!(
999            flat.contains('%'),
1000            "expected custom zone glyph on map: {flat}"
1001        );
1002        assert!(
1003            view.cell_fg.iter().any(|c| *c == Some(RgbColor::MAGENTA)),
1004            "expected custom zone color on terrain cells"
1005        );
1006    }
1007
1008    #[test]
1009    fn well_paints_water_ring_and_center() {
1010        let building = BuildingView {
1011            id: "town_well".into(),
1012            label: "Well".into(),
1013            x: 122.0,
1014            y: 106.0,
1015            width_m: 3.0,
1016            depth_m: 3.0,
1017            interior_blueprint: None,
1018            tags: vec!["well".into()],
1019        };
1020        let mut state = state_with_building(building);
1021        state.entities = vec![EntityState {
1022            id: 1,
1023            label: "You".into(),
1024            transform: Transform {
1025                position: WorldCoord::surface(120.0, 106.0),
1026                yaw: 0.0,
1027                velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
1028            },
1029            vitals: Some(PlayerVitals::default()),
1030            attributes: Some(PrimaryAttributes::default()),
1031            skills: Some(flatland_protocol::PlayerSkills::default()),
1032            inside_building: None,
1033            tile_id: None,
1034            presentation_state: None,
1035            sprite_mode: None,
1036            progression_xp: None,
1037        }];
1038        state.player = state.entities.first().cloned();
1039        let view = WorldView::build_with_target(&state, 9, 9, None);
1040        let flat = view.cells.join("");
1041        assert!(flat.contains('~'), "expected well water: {flat}");
1042        assert!(flat.contains('O'), "expected well center: {flat}");
1043    }
1044
1045    #[test]
1046    fn broker_hut_draws_wall_outline() {
1047        let building = BuildingView {
1048            id: "broker_hut".into(),
1049            label: "Broker's Hut".into(),
1050            x: 148.0,
1051            y: 118.0,
1052            width_m: 8.0,
1053            depth_m: 6.0,
1054            interior_blueprint: None,
1055            tags: vec![],
1056        };
1057        let mut state = state_with_building(building);
1058        state.player = state.entities.first().cloned();
1059        let view = WorldView::build_with_target(&state, 25, 15, None);
1060        let flat = view.cells.join("");
1061        assert!(flat.contains('+'), "expected corners: {flat}");
1062        assert!(flat.contains('-'), "expected horiz walls: {flat}");
1063        assert!(flat.contains('|'), "expected vert walls: {flat}");
1064    }
1065
1066    #[test]
1067    fn interior_map_renders_rooms_and_walls() {
1068        use flatland_protocol::{InteriorMapView, InteriorRoomView};
1069        let building = BuildingView {
1070            id: "broker_hut".into(),
1071            label: "Broker's Hut".into(),
1072            x: 148.0,
1073            y: 118.0,
1074            width_m: 8.0,
1075            depth_m: 6.0,
1076            interior_blueprint: Some("broker_hut".into()),
1077            tags: vec![],
1078        };
1079        let mut state = state_with_building(building);
1080        state.interior_map = Some(InteriorMapView {
1081            building_id: "broker_hut".into(),
1082            blueprint_id: "broker_hut".into(),
1083            background_color: "#000000".into(),
1084            default_floor_color: Some("#2a2a2a".into()),
1085            floor_height_m: 3.0,
1086            rooms: vec![InteriorRoomView {
1087                id: "main".into(),
1088                label: "Main".into(),
1089                floor: 0,
1090                x0: 0.0,
1091                y0: 0.0,
1092                x1: 8.5,
1093                y1: 7.0,
1094                floor_color: None,
1095                floor_glyph: None,
1096            }],
1097            room_doors: vec![],
1098        });
1099        state.entities = vec![EntityState {
1100            id: 1,
1101            label: "You".into(),
1102            transform: Transform {
1103                position: WorldCoord::surface(4.0, 3.0),
1104                yaw: 0.0,
1105                velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
1106            },
1107            vitals: Some(PlayerVitals::default()),
1108            attributes: Some(PrimaryAttributes::default()),
1109            skills: Some(flatland_protocol::PlayerSkills::default()),
1110            inside_building: Some("broker_hut".into()),
1111            tile_id: None,
1112            presentation_state: None,
1113            sprite_mode: None,
1114            progression_xp: None,
1115        }];
1116        state.player = state.entities.first().cloned();
1117        let view = WorldView::build_with_target(&state, 25, 15, None);
1118        assert_eq!(view.inside_building.as_deref(), Some("broker_hut"));
1119        let flat = view.cells.join("");
1120        assert!(flat.contains('+'), "expected interior walls: {flat}");
1121        assert!(flat.contains('@'), "expected player marker: {flat}");
1122    }
1123
1124    #[test]
1125    fn stale_interior_map_renders_outdoor_when_outside() {
1126        use flatland_protocol::{InteriorMapView, InteriorRoomView};
1127        let building = BuildingView {
1128            id: "town_hall".into(),
1129            label: "Town Hall".into(),
1130            x: 163.0,
1131            y: 137.0,
1132            width_m: 20.0,
1133            depth_m: 10.0,
1134            interior_blueprint: Some("town_hall".into()),
1135            tags: vec![],
1136        };
1137        let mut state = state_with_building(building);
1138        state.interior_map = Some(InteriorMapView {
1139            building_id: "town_hall".into(),
1140            blueprint_id: "town_hall".into(),
1141            background_color: "#000000".into(),
1142            default_floor_color: Some("#2a2a2a".into()),
1143            floor_height_m: 3.0,
1144            rooms: vec![InteriorRoomView {
1145                id: "main_hall".into(),
1146                label: "Main".into(),
1147                floor: 0,
1148                x0: -3.5,
1149                y0: -8.0,
1150                x1: 18.5,
1151                y1: 6.0,
1152                floor_color: None,
1153                floor_glyph: None,
1154            }],
1155            room_doors: vec![],
1156        });
1157        state.player = state.entities.first().cloned();
1158        let view = WorldView::build_with_target(&state, 25, 15, None);
1159        assert!(view.inside_building.is_none());
1160        let flat = view.cells.join("");
1161        let grass = map_presentation::terrain_for(TerrainKindView::Grass).glyph;
1162        assert!(
1163            flat.contains(&grass),
1164            "expected outdoor terrain, not stale interior background: {flat}"
1165        );
1166        assert!(
1167            !flat.chars().all(|c| c == ' ' || c == '@'),
1168            "stale interior_map must not paint black interior when outside"
1169        );
1170    }
1171
1172    #[test]
1173    fn stale_inside_flag_still_renders_outdoor_world() {
1174        use flatland_protocol::ResourceNodeState;
1175        let building = BuildingView {
1176            id: "broker_hut".into(),
1177            label: "Broker's Hut".into(),
1178            x: 148.0,
1179            y: 118.0,
1180            width_m: 8.0,
1181            depth_m: 6.0,
1182            interior_blueprint: None,
1183            tags: vec![],
1184        };
1185        let mut state = state_with_building(building);
1186        state.entities = vec![EntityState {
1187            id: 1,
1188            label: "You".into(),
1189            transform: Transform {
1190                position: WorldCoord::surface(128.0, 128.0),
1191                yaw: 0.0,
1192                velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
1193            },
1194            vitals: Some(PlayerVitals::default()),
1195            attributes: Some(PrimaryAttributes::default()),
1196            skills: Some(flatland_protocol::PlayerSkills::default()),
1197            inside_building: Some("broker_hut".into()),
1198            tile_id: None,
1199            presentation_state: None,
1200            sprite_mode: None,
1201            progression_xp: None,
1202        }];
1203        state.player = state.entities.first().cloned();
1204        state
1205            .resource_nodes
1206            .push(flatland_protocol::ResourceNodeView {
1207                id: "oak".into(),
1208                label: "Oak".into(),
1209                x: 126.0,
1210                y: 134.0,
1211                z: 0.0,
1212                item_template: "oak_log".into(),
1213                state: ResourceNodeState::Available,
1214                blocking: true,
1215                blocking_radius_m: 0.8,
1216                tile_id: None,
1217                sprite_mode: None,
1218                presentation_state: None,
1219            });
1220        let view = WorldView::build_with_target(&state, 25, 15, None);
1221        assert_eq!(
1222            view.inside_building.as_deref(),
1223            Some("broker_hut"),
1224            "server inside flag is authoritative"
1225        );
1226        let flat = view.cells.join("");
1227        let oak = map_presentation::resource_for(&flatland_protocol::ResourceNodeView {
1228            id: "oak".into(),
1229            label: "Oak".into(),
1230            x: 0.0,
1231            y: 0.0,
1232            z: 0.0,
1233            item_template: "oak_log".into(),
1234            state: flatland_protocol::ResourceNodeState::Available,
1235            blocking: true,
1236            blocking_radius_m: 0.8,
1237            tile_id: None,
1238            sprite_mode: None,
1239            presentation_state: None,
1240        });
1241        assert!(
1242            flat.contains(&oak.glyph),
1243            "expected nearby tree ({:?}): {flat}",
1244            oak.glyph
1245        );
1246        assert!(flat.contains('@'), "expected player: {flat}");
1247    }
1248
1249    #[test]
1250    fn inside_building_flag_selects_active_instance() {
1251        let town = BuildingView {
1252            id: "town_hall".into(),
1253            label: "Town Hall".into(),
1254            x: 160.0,
1255            y: 136.0,
1256            width_m: 20.0,
1257            depth_m: 10.0,
1258            interior_blueprint: Some("town_hall".into()),
1259            tags: vec![],
1260        };
1261        let guild = BuildingView {
1262            id: "guild_hall".into(),
1263            label: "Guild Hall".into(),
1264            x: 164.0,
1265            y: 152.0,
1266            width_m: 20.0,
1267            depth_m: 14.0,
1268            interior_blueprint: Some("guild_hall".into()),
1269            tags: vec![],
1270        };
1271        let mut state = state_with_building(town);
1272        state.buildings.push(guild);
1273        state.entities = vec![EntityState {
1274            id: 1,
1275            label: "You".into(),
1276            transform: Transform {
1277                position: WorldCoord::surface(4.0, 3.0),
1278                yaw: 0.0,
1279                velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
1280            },
1281            vitals: Some(PlayerVitals::default()),
1282            attributes: Some(PrimaryAttributes::default()),
1283            skills: Some(flatland_protocol::PlayerSkills::default()),
1284            inside_building: Some("guild_hall".into()),
1285            tile_id: None,
1286            presentation_state: None,
1287            sprite_mode: None,
1288            progression_xp: None,
1289        }];
1290        state.player = state.entities.first().cloned();
1291        state.world_width_m = 256.0;
1292        state.world_height_m = 256.0;
1293
1294        let view = WorldView::build_with_target(&state, 25, 15, None);
1295        assert_eq!(view.inside_building.as_deref(), Some("guild_hall"));
1296    }
1297
1298    #[test]
1299    fn combat_target_marks_creature_cell() {
1300        let building = BuildingView {
1301            id: "x".into(),
1302            label: "X".into(),
1303            x: 128.0,
1304            y: 128.0,
1305            width_m: 1.0,
1306            depth_m: 1.0,
1307            interior_blueprint: None,
1308            tags: vec![],
1309        };
1310        let mut state = state_with_building(building);
1311        state.entities = vec![
1312            EntityState {
1313                id: 1,
1314                label: "You".into(),
1315                transform: Transform {
1316                    position: WorldCoord::surface(100.0, 100.0),
1317                    yaw: 0.0,
1318                    velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
1319                },
1320                vitals: Some(PlayerVitals::default()),
1321                attributes: Some(PrimaryAttributes::default()),
1322                skills: Some(flatland_protocol::PlayerSkills::default()),
1323                inside_building: None,
1324                tile_id: None,
1325                presentation_state: None,
1326                sprite_mode: None,
1327                progression_xp: None,
1328            },
1329            EntityState {
1330                id: 42,
1331                label: "Rabbit".into(),
1332                transform: Transform {
1333                    position: WorldCoord::surface(103.0, 100.0),
1334                    yaw: 0.0,
1335                    velocity: flatland_protocol::Velocity2D { vx: 0.0, vy: 0.0 },
1336                },
1337                vitals: None,
1338                attributes: None,
1339                skills: None,
1340                inside_building: None,
1341                tile_id: None,
1342                presentation_state: None,
1343                sprite_mode: None,
1344                progression_xp: None,
1345            },
1346        ];
1347        state.player = state.entities.first().cloned();
1348        state.combat_target = Some(42);
1349        state.combat_target_label = Some("Rabbit".into());
1350
1351        let view = WorldView::build_with_target(&state, 25, 15, None);
1352        let marked: usize = view
1353            .target_t1_cells
1354            .iter()
1355            .chain(view.target_t2_cells.iter())
1356            .filter(|b| **b)
1357            .count();
1358        assert_eq!(marked, 1, "exactly one targeted cell");
1359        let idx = view
1360            .target_t1_cells
1361            .iter()
1362            .chain(view.target_t2_cells.iter())
1363            .position(|b| *b)
1364            .expect("target cell");
1365        assert_eq!(view.cells[idx], "R");
1366    }
1367
1368    #[test]
1369    fn grid_to_world_roundtrips_center() {
1370        let px = 10.0;
1371        let py = 20.0;
1372        let view_w = 11;
1373        let view_h = 11;
1374        let half_w = (view_w / 2) as i32;
1375        let half_h = (view_h / 2) as i32;
1376        let (gx, gy) =
1377            world_to_grid(12.0, 18.0, px, py, half_w, half_h, view_w, view_h).expect("in view");
1378        let (wx, wy) = grid_to_world(gx, gy, px, py, view_w, view_h).expect("inverse");
1379        assert!((wx - 12.0).abs() < 0.01);
1380        assert!((wy - 18.0).abs() < 0.01);
1381    }
1382
1383    #[test]
1384    fn vertical_axis_quantizes_to_one_meter() {
1385        let px = 0.0;
1386        let py = 0.0;
1387        let view_w = 21;
1388        let view_h = 21;
1389        let half_w = (view_w / 2) as i32;
1390        let half_h = (view_h / 2) as i32;
1391        let (gx, gy) =
1392            world_to_grid(3.0, 3.0, px, py, half_w, half_h, view_w, view_h).expect("in view");
1393        let (wx, wy) = grid_to_world(gx, gy, px, py, view_w, view_h).expect("inverse");
1394        assert!(
1395            (wx - 3.0).abs() < 0.01,
1396            "x should stay exact to 1m: got {wx}"
1397        );
1398        assert!(
1399            (wy - 3.0).abs() < 0.01,
1400            "y should stay exact to 1m: got {wy}"
1401        );
1402    }
1403
1404    #[test]
1405    fn square_extent_spans_equal_rows_and_columns() {
1406        let px = 0.0;
1407        let py = 0.0;
1408        let half_w = 50;
1409        let half_h = 50;
1410        let width = 101;
1411        let height = 101;
1412        let (gx0, gy0) =
1413            world_to_grid(-4.0, -4.0, px, py, half_w, half_h, width, height).expect("in view");
1414        let (gx1, gy1) =
1415            world_to_grid(4.0, 4.0, px, py, half_w, half_h, width, height).expect("in view");
1416        let cols_spanned = (gx1 as i32 - gx0 as i32).unsigned_abs();
1417        let rows_spanned = (gy1 as i32 - gy0 as i32).unsigned_abs();
1418        assert_eq!(cols_spanned, 8, "8m wide should span 8 columns");
1419        assert_eq!(rows_spanned, 8, "8m tall should span 8 rows");
1420    }
1421
1422    #[test]
1423    fn resource_paints_on_terrain_cell_for_same_world_coords() {
1424        use flatland_protocol::{ResourceNodeState, ResourceNodeView, TerrainZoneView};
1425
1426        let px = 128.0;
1427        let py = 128.0;
1428        let rx = 131.0;
1429        let ry = 132.0;
1430        let mut state = state_with_building(BuildingView {
1431            id: "x".into(),
1432            label: "X".into(),
1433            x: 128.0,
1434            y: 128.0,
1435            width_m: 1.0,
1436            depth_m: 1.0,
1437            interior_blueprint: None,
1438            tags: vec![],
1439        });
1440        state.terrain_zones.push(TerrainZoneView {
1441            id: "pond".into(),
1442            x0: rx,
1443            y0: ry,
1444            x1: rx + 1.0,
1445            y1: ry + 1.0,
1446            kind: TerrainKindView::ShallowWater,
1447            elevation: -0.5,
1448            glyph: None,
1449            color: None,
1450            tile_id: None,
1451            z_order: 0,
1452        });
1453        state.resource_nodes.push(ResourceNodeView {
1454            id: "oak".into(),
1455            label: "Oak".into(),
1456            x: rx,
1457            y: ry,
1458            z: 0.0,
1459            item_template: "oak_log".into(),
1460            state: ResourceNodeState::Available,
1461            blocking: true,
1462            blocking_radius_m: 0.8,
1463            tile_id: None,
1464            sprite_mode: None,
1465            presentation_state: None,
1466        });
1467        state.entities[0].transform.position = WorldCoord::surface(px, py);
1468        state.player = state.entities.first().cloned();
1469
1470        let view = WorldView::build_with_target(&state, 25, 15, None);
1471        let half_w = (view.width / 2) as i32;
1472        let half_h = (view.height / 2) as i32;
1473        let (gx, gy) = world_to_grid(rx, ry, px, py, half_w, half_h, view.width, view.height)
1474            .expect("resource in view");
1475        let idx = gy * view.width + gx;
1476        let oak = map_presentation::resource_for(&state.resource_nodes[0]);
1477        assert_eq!(
1478            view.cells[idx], oak.glyph,
1479            "resource should paint on the grid cell for its world coords"
1480        );
1481        let (wx, wy) = grid_to_world(gx, gy, px, py, view.width, view.height).expect("inverse");
1482        assert!(
1483            (wx - rx).abs() < 0.01 && (wy - ry).abs() < 0.01,
1484            "resource grid cell should sample terrain at ({wx}, {wy}), expected ({rx}, {ry})"
1485        );
1486    }
1487
1488    #[test]
1489    fn chest_and_loot_paint_on_non_grass_terrain() {
1490        use flatland_protocol::{GroundDropView, PlacedContainerView, TerrainZoneView};
1491
1492        let px = 50.0;
1493        let py = 50.0;
1494        let cx = 53.0;
1495        let cy = 52.0;
1496        let lx = 54.0;
1497        let ly = 52.0;
1498        let mut state = state_with_building(BuildingView {
1499            id: "x".into(),
1500            label: "X".into(),
1501            x: 50.0,
1502            y: 50.0,
1503            width_m: 1.0,
1504            depth_m: 1.0,
1505            interior_blueprint: None,
1506            tags: vec![],
1507        });
1508        state.terrain_zones.push(TerrainZoneView {
1509            id: "trail".into(),
1510            x0: 52.0,
1511            y0: 51.0,
1512            x1: 56.0,
1513            y1: 54.0,
1514            kind: TerrainKindView::Trail,
1515            elevation: 0.0,
1516            glyph: None,
1517            color: None,
1518            tile_id: None,
1519            z_order: 0,
1520        });
1521        state.placed_containers.push(PlacedContainerView {
1522            id: "chest_1".into(),
1523            template_id: "wood_chest".into(),
1524            display_name: "Storage".into(),
1525            x: cx,
1526            y: cy,
1527            z: 0.0,
1528            locked: false,
1529            accessible: true,
1530            owner_character_id: None,
1531            contents: vec![],
1532            lock_id: None,
1533            capacity_volume: Some(40.0),
1534            item_instance_id: None,
1535            tile_id: None,
1536            worker_lodging_capacity: None,
1537        });
1538        state.ground_drops.push(GroundDropView {
1539            id: "drop_1".into(),
1540            template_id: "lumber".into(),
1541            quantity: 2,
1542            x: lx,
1543            y: ly,
1544            z: 0.0,
1545            tile_id: None,
1546        });
1547        state.entities[0].transform.position = WorldCoord::surface(px, py);
1548        state.player = state.entities.first().cloned();
1549
1550        let view = WorldView::build_with_target(&state, 25, 15, None);
1551        let half_w = (view.width / 2) as i32;
1552        let half_h = (view.height / 2) as i32;
1553        let (gx, gy) =
1554            world_to_grid(cx, cy, px, py, half_w, half_h, view.width, view.height).expect("chest");
1555        let chest = map_presentation::chest_presentation(false);
1556        assert_eq!(
1557            view.cells[gy * view.width + gx],
1558            chest.glyph,
1559            "chest must paint on trail/non-grass cells"
1560        );
1561        let (gx2, gy2) =
1562            world_to_grid(lx, ly, px, py, half_w, half_h, view.width, view.height).expect("loot");
1563        let loot = map_presentation::loot_presentation();
1564        assert_eq!(
1565            view.cells[gy2 * view.width + gx2],
1566            loot.glyph,
1567            "ground loot must paint on trail/non-grass cells"
1568        );
1569    }
1570
1571    #[test]
1572    fn build_with_anchor_sets_view_origin() {
1573        let mut state = state_with_building(BuildingView {
1574            id: "x".into(),
1575            label: "X".into(),
1576            x: 128.0,
1577            y: 128.0,
1578            width_m: 1.0,
1579            depth_m: 1.0,
1580            interior_blueprint: None,
1581            tags: vec![],
1582        });
1583        state.entities[0].transform.position = WorldCoord::surface(100.0, 200.0);
1584        state.player = state.entities.first().cloned();
1585        let view = WorldView::build_with_anchor(
1586            &state,
1587            21,
1588            15,
1589            12.3,
1590            40.7,
1591            None,
1592            WorldViewOptions::terrain_only(),
1593        );
1594        assert!((view.origin_x - 12.3).abs() < 0.01);
1595        assert!((view.origin_y - 40.7).abs() < 0.01);
1596    }
1597
1598    #[test]
1599    fn skip_local_player_glyph_when_paint_local_player_false() {
1600        let mut state = state_with_building(BuildingView {
1601            id: "x".into(),
1602            label: "X".into(),
1603            x: 10.0,
1604            y: 10.0,
1605            width_m: 1.0,
1606            depth_m: 1.0,
1607            interior_blueprint: None,
1608            tags: vec![],
1609        });
1610        state.entities[0].transform.position = WorldCoord::surface(128.0, 128.0);
1611        state.player = state.entities.first().cloned();
1612        let player_glyph = map_presentation::player_presentation().glyph;
1613
1614        let with_player =
1615            WorldView::build_with_options(&state, 21, 15, None, WorldViewOptions::default());
1616        let cx = with_player.width / 2;
1617        let cy = with_player.height / 2;
1618        assert_eq!(
1619            with_player.cells[cy * with_player.width + cx],
1620            player_glyph,
1621            "default build paints @"
1622        );
1623
1624        let without =
1625            WorldView::build_with_options(&state, 21, 15, None, WorldViewOptions::terrain_only());
1626        assert_ne!(
1627            without.cells[cy * without.width + cx],
1628            player_glyph,
1629            "gfx sprite mode must not paint local player @"
1630        );
1631    }
1632}