1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// 地形生成策略 trait 定义
// 提供统一的地形生成接口,支持多种策略实现
use crateTerrainConfig;
use cratePcgResult;
use crate;
use crateTerrain;
use crateStableRng;
/// 地形策略枚举 —— 静态派发替代 `Box<dyn TerrainStrategy>`
///
/// 每个变体对应一种地形生成策略。通过 [`generate`](TerrainStrategyKind::generate)
/// 方法统一派发到各具体策略结构体的实现,消除动态派发开销。
///
/// # 变体
///
/// | 变体 | 对应结构体 | 触发条件 |
/// |------|-----------|---------|
/// | `DefaultCarve` | [`DefaultCarveStrategy`] | 默认回退 |
/// | `OpenArena` | [`OpenArenaStrategy`] | Boss 房间 |
/// | `Maze` | [`MazeStrategy`] | Puzzle + maze 标签 |
/// | `Organic` | [`OrganicStrategy`] | organic / cave 标签 |
/// | `Pillar` | [`PillarStrategy`] | Combat/Elite + pillar 标签 |
/// 地形生成策略 trait
///
/// 定义统一的地形生成接口,所有地形策略(如开放式、柱状、迷宫式、有机式等)
/// 都必须实现此 trait。策略选择由房间类型、主题标签和模板引用共同决定。
///
/// # 设计原则
///
/// 1. **统一接口**:所有策略共享相同的输入输出签名
/// 2. **可组合**:策略可以独立实现和测试
/// 3. **确定性**:相同输入(含 RNG 状态)产生相同输出
/// 4. **可识别**:每个策略有唯一名称,便于调试和日志
///
/// # 示例
///
/// ```rust,ignore
/// use yang_pcg::terrain::strategy::TerrainStrategy;
///
/// struct MyCustomStrategy;
///
/// impl TerrainStrategy for MyCustomStrategy {
/// fn name(&self) -> &str {
/// "custom"
/// }
///
/// fn generate(
/// &self,
/// room: &Room,
/// anchors: &[DoorAnchor],
/// config: &TerrainConfig,
/// rng: &mut StableRng,
/// ) -> PcgResult<Terrain> {
/// // 自定义地形生成逻辑
/// todo!()
/// }
/// }
/// ```