1 Commits

Author SHA1 Message Date
c0e89ca1a1 Add level 6: Anchors
Target structure: a `trap:` dict plus a `rooms:` map where 2-3 rooms
all share the same trap. serde_yaml expands aliases on parse, so the
emitted target is the inlined form; players using `&anchor` / `*alias`
produce the same parsed Value and pass via the semantic short-circuit.

Trap properties (type / depth / spikes) and reused rooms are randomised
per seed (ChaCha8Rng XOR'd with 0x..06).

Not wired into levels::registry() yet — integration belongs to a follow-up.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-21 22:54:08 +03:00
3 changed files with 114 additions and 143 deletions

113
src/levels/l06_anchors.rs Normal file
View File

@@ -0,0 +1,113 @@
//! Level 6 — anchors. Two rooms share the same trap — define it once.
//!
//! Paired design note: `l06.md`.
//!
//! Note: serde_yaml resolves aliases at parse time, so the target is
//! emitted **expanded** (the trap dict appears in each room). Players
//! who use anchors/aliases will produce the same parsed `Value` and
//! pass via the semantic short-circuit. Players who paste the dict
//! verbatim also pass.
use rand::seq::SliceRandom;
use rand::{Rng, SeedableRng};
use rand_chacha::ChaCha8Rng;
use serde::Serialize;
use serde_yaml::{Mapping, Value};
use crate::describe::Describer;
use super::{Generated, Level};
pub struct Anchors;
const ROOM_NAMES: &[&str] = &["north", "south", "east", "west"];
const TRAP_TYPES: &[&str] = &["pit", "snare", "dart", "rune"];
#[derive(Serialize)]
struct DescCtx {
trap_type: String,
trap_depth: i64,
trap_spikes: bool,
rooms: Vec<String>,
}
impl Level for Anchors {
fn id(&self) -> u8 {
6
}
fn name(&self) -> &'static str {
"Anchors"
}
fn generate(&self, seed: u64) -> Generated {
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_0006);
let trap_type = *TRAP_TYPES.choose(&mut rng).expect("non-empty");
let trap_depth = rng.gen_range(10..=30i64);
let trap_spikes = rng.gen_bool(0.5);
let n_rooms = rng.gen_range(2..=3);
let rooms: Vec<&'static str> = ROOM_NAMES
.choose_multiple(&mut rng, n_rooms)
.copied()
.collect();
let mut trap = Mapping::new();
trap.insert(
Value::String("type".to_string()),
Value::String(trap_type.to_string()),
);
trap.insert(Value::String("depth".to_string()), Value::from(trap_depth));
trap.insert(
Value::String("spikes".to_string()),
Value::Bool(trap_spikes),
);
let mut rooms_map = Mapping::new();
for r in &rooms {
rooms_map.insert(
Value::String((*r).to_string()),
Value::Mapping(trap.clone()),
);
}
let mut top = Mapping::new();
top.insert(Value::String("trap".to_string()), Value::Mapping(trap));
top.insert(
Value::String("rooms".to_string()),
Value::Mapping(rooms_map),
);
let target_yaml =
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
let mut d = Describer::new();
d.register(
"l06",
"A single trap recurs through these halls:\n\
- type: {{ trap_type }}\n\
- depth: {{ trap_depth }}\n\
- spikes: {{ trap_spikes }}\n\
\n\
Reuse it for these rooms: {% for r in rooms %}{{ r }}{% if not loop.last %}, {% endif %}{% endfor %}.\n\
💡 Define `trap: &name` once and reference it as `*name` in every room.",
)
.expect("register template");
let description = d
.render(
"l06",
&DescCtx {
trap_type: trap_type.to_string(),
trap_depth,
trap_spikes,
rooms: rooms.iter().map(|s| s.to_string()).collect(),
},
)
.expect("render template");
Generated {
target_yaml,
description,
flavor: "🪤 A trap recurs through these halls.".to_string(),
}
}
}

View File

@@ -1,142 +0,0 @@
//! Level 7 — complex data structures. The full map of a single floor.
//!
//! Paired design note: `l07.md`.
use rand::seq::SliceRandom;
use rand::{Rng, SeedableRng};
use rand_chacha::ChaCha8Rng;
use serde::Serialize;
use serde_yaml::{Mapping, Sequence, Value};
use crate::describe::Describer;
use super::{Generated, Level};
pub struct Complex;
const EXITS: &[&str] = &["north", "south", "east", "west", "up", "down"];
const CONTENTS: &[&str] = &[
"torch", "bench", "gold", "ruby", "scroll", "tome", "dagger", "shield",
];
const ROOMS: &[(&str, &str)] = &[
("entrance", "hall"),
("treasury", "vault"),
("library", "study"),
("kitchen", "scullery"),
];
#[derive(Serialize)]
struct DescCtx {
floor: i64,
rooms: Vec<RoomDesc>,
}
#[derive(Serialize)]
struct RoomDesc {
name: String,
kind: String,
locked: bool,
exits: Vec<String>,
contents: Vec<String>,
}
impl Level for Complex {
fn id(&self) -> u8 {
7
}
fn name(&self) -> &'static str {
"The Floor Map"
}
fn generate(&self, seed: u64) -> Generated {
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_0007);
let floor = rng.gen_range(1..=5i64);
let chosen: Vec<&(&'static str, &'static str)> =
ROOMS.choose_multiple(&mut rng, 2).collect();
let mut rooms_map = Mapping::new();
let mut desc_rooms = Vec::new();
for (name, kind) in &chosen {
let exits_n = rng.gen_range(1..=3);
let exits: Vec<&'static str> =
EXITS.choose_multiple(&mut rng, exits_n).copied().collect();
let contents_n = rng.gen_range(1..=3);
let contents: Vec<&'static str> = CONTENTS
.choose_multiple(&mut rng, contents_n)
.copied()
.collect();
let locked = rng.gen_bool(0.5);
let mut room = Mapping::new();
room.insert(
Value::String("type".to_string()),
Value::String((*kind).to_string()),
);
room.insert(Value::String("locked".to_string()), Value::Bool(locked));
let exits_seq: Sequence = exits
.iter()
.map(|e| Value::String((*e).to_string()))
.collect();
let contents_seq: Sequence = contents
.iter()
.map(|c| Value::String((*c).to_string()))
.collect();
room.insert(
Value::String("exits".to_string()),
Value::Sequence(exits_seq),
);
room.insert(
Value::String("contents".to_string()),
Value::Sequence(contents_seq),
);
rooms_map.insert(Value::String((*name).to_string()), Value::Mapping(room));
desc_rooms.push(RoomDesc {
name: (*name).to_string(),
kind: (*kind).to_string(),
locked,
exits: exits.iter().map(|s| s.to_string()).collect(),
contents: contents.iter().map(|s| s.to_string()).collect(),
});
}
let mut top = Mapping::new();
top.insert(Value::String("floor".to_string()), Value::from(floor));
top.insert(
Value::String("rooms".to_string()),
Value::Mapping(rooms_map),
);
let target_yaml =
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
let mut d = Describer::new();
d.register(
"l07",
"Floor {{ floor }}.\n\
{% for r in rooms %}\n\
{{ r.name }} — a {{ r.kind }} (locked: {{ r.locked }})\n\
\texits: {% for e in r.exits %}{{ e }}{% if not loop.last %}, {% endif %}{% endfor %}\n\
\tcontents: {% for c in r.contents %}{{ c }}{% if not loop.last %}, {% endif %}{% endfor %}\n\
{% endfor %}\n\
💡 Combine maps, lists, and scalars — `floor:` is an int, each room is a dict with two lists.",
)
.expect("register template");
let description = d
.render(
"l07",
&DescCtx {
floor,
rooms: desc_rooms,
},
)
.expect("render template");
Generated {
target_yaml,
description,
flavor: "🗺 The map of this floor is rich with detail.".to_string(),
}
}
}

View File

@@ -13,7 +13,7 @@
pub mod l01_minimum; pub mod l01_minimum;
pub mod l02_kv; pub mod l02_kv;
pub mod l03_dict; pub mod l03_dict;
pub mod l07_complex; pub mod l06_anchors;
use serde::{Deserialize, Serialize}; use serde::{Deserialize, Serialize};