Compare commits
21 Commits
level-7
...
db124eeb97
| Author | SHA1 | Date | |
|---|---|---|---|
| db124eeb97 | |||
| cb326d432f | |||
| cd3d3395c5 | |||
| 250c326c92 | |||
| abc0fa7784 | |||
| 9b2f6d4731 | |||
| 2bf412e65b | |||
| 5bbf7ca107 | |||
| bcdd487eec | |||
| 736c6bd564 | |||
| 3f8ea45ef7 | |||
| a8b91f1645 | |||
| 040bec6c80 | |||
| 9f8e5caaa8 | |||
| 424ef3e8fd | |||
| b2f9f24b68 | |||
| f0a7992626 | |||
| 4d06100300 | |||
| c0e89ca1a1 | |||
| b805a49aaa | |||
| 07f82a7086 |
BIN
screenshot.png
BIN
screenshot.png
Binary file not shown.
|
Before Width: | Height: | Size: 101 KiB After Width: | Height: | Size: 72 KiB |
71
src/levels/l04_list.rs
Normal file
71
src/levels/l04_list.rs
Normal file
@@ -0,0 +1,71 @@
|
||||
//! Level 4 — lists. A chest of loot lies open before you.
|
||||
//!
|
||||
//! Paired design note: `l04.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 List;
|
||||
|
||||
const ITEMS: &[&str] = &[
|
||||
"sword", "torch", "rope", "bread", "dagger", "scroll", "gem", "coin", "potion", "shield",
|
||||
];
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct DescCtx {
|
||||
items: Vec<String>,
|
||||
}
|
||||
|
||||
impl Level for List {
|
||||
fn id(&self) -> u8 {
|
||||
4
|
||||
}
|
||||
|
||||
fn name(&self) -> &'static str {
|
||||
"The Chest"
|
||||
}
|
||||
|
||||
fn generate(&self, seed: u64) -> Generated {
|
||||
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_0004);
|
||||
let n = rng.gen_range(3..=5);
|
||||
let items: Vec<&'static str> = ITEMS.choose_multiple(&mut rng, n).copied().collect();
|
||||
|
||||
let seq: Sequence = items
|
||||
.iter()
|
||||
.map(|i| Value::String((*i).to_string()))
|
||||
.collect();
|
||||
|
||||
let mut top = Mapping::new();
|
||||
top.insert(Value::String("chest".to_string()), Value::Sequence(seq));
|
||||
let target_yaml =
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let mut d = Describer::new();
|
||||
d.register(
|
||||
"l04",
|
||||
"A chest lies open. Inside:\n{% for it in items %}- {{ it }}\n{% endfor %}\n💡 Wrap the items as a YAML list under a `chest:` key.",
|
||||
)
|
||||
.expect("register template");
|
||||
let description = d
|
||||
.render(
|
||||
"l04",
|
||||
&DescCtx {
|
||||
items: items.iter().map(|s| s.to_string()).collect(),
|
||||
},
|
||||
)
|
||||
.expect("render template");
|
||||
|
||||
Generated {
|
||||
target_yaml,
|
||||
description,
|
||||
flavor: "📦 A chest of loot lies open before you.".to_string(),
|
||||
}
|
||||
}
|
||||
}
|
||||
120
src/levels/l05_dict_list.rs
Normal file
120
src/levels/l05_dict_list.rs
Normal file
@@ -0,0 +1,120 @@
|
||||
//! Level 5 — dictionaries AND lists. Each chamber keeps its own inventory.
|
||||
//!
|
||||
//! Paired design note: `l05.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 DictList;
|
||||
|
||||
const CHAMBERS: &[&str] = &[
|
||||
"armory", "pantry", "library", "vault", "kitchen", "cellar",
|
||||
];
|
||||
const ITEMS: &[&str] = &[
|
||||
"sword", "shield", "bread", "water", "tome", "scroll", "gem", "coin", "dagger", "potion",
|
||||
];
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct DescCtx {
|
||||
sentences: Vec<String>,
|
||||
}
|
||||
|
||||
/// Pick "a" or "an" based on the first letter — keeps the prose reading
|
||||
/// naturally without giving away that chamber names are YAML keys.
|
||||
fn article(word: &str) -> &'static str {
|
||||
let first = word.chars().next().map(|c| c.to_ascii_lowercase());
|
||||
if matches!(first, Some('a') | Some('e') | Some('i') | Some('o') | Some('u')) {
|
||||
"an"
|
||||
} else {
|
||||
"a"
|
||||
}
|
||||
}
|
||||
|
||||
/// Join the item list as English: `a sword`, `a sword and a shield`,
|
||||
/// `a sword, a shield, and a potion` (Oxford comma for 3+).
|
||||
fn join_items(items: &[&str]) -> String {
|
||||
let parts: Vec<String> = items
|
||||
.iter()
|
||||
.map(|i| format!("{} {}", article(i), i))
|
||||
.collect();
|
||||
match parts.as_slice() {
|
||||
[] => String::new(),
|
||||
[one] => one.clone(),
|
||||
[a, b] => format!("{a} and {b}"),
|
||||
rest => {
|
||||
let (last, head) = rest.split_last().unwrap();
|
||||
format!("{}, and {}", head.join(", "), last)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl Level for DictList {
|
||||
fn id(&self) -> u8 {
|
||||
5
|
||||
}
|
||||
|
||||
fn name(&self) -> &'static str {
|
||||
"Chambers"
|
||||
}
|
||||
|
||||
fn generate(&self, seed: u64) -> Generated {
|
||||
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_0005);
|
||||
let n = rng.gen_range(2..=3);
|
||||
let chamber_names: Vec<&'static str> =
|
||||
CHAMBERS.choose_multiple(&mut rng, n).copied().collect();
|
||||
|
||||
let mut inner = Mapping::new();
|
||||
let mut sentences = Vec::new();
|
||||
for name in &chamber_names {
|
||||
let item_n = rng.gen_range(2..=3);
|
||||
let items: Vec<&'static str> =
|
||||
ITEMS.choose_multiple(&mut rng, item_n).copied().collect();
|
||||
let seq: Sequence = items
|
||||
.iter()
|
||||
.map(|i| Value::String((*i).to_string()))
|
||||
.collect();
|
||||
inner.insert(Value::String((*name).to_string()), Value::Sequence(seq));
|
||||
|
||||
let be = if items.len() == 1 { "is" } else { "are" };
|
||||
sentences.push(format!(
|
||||
"There {be} {} inside {} {name}.",
|
||||
join_items(&items),
|
||||
article(name),
|
||||
));
|
||||
}
|
||||
|
||||
let mut top = Mapping::new();
|
||||
top.insert(
|
||||
Value::String("chambers".to_string()),
|
||||
Value::Mapping(inner),
|
||||
);
|
||||
|
||||
let target_yaml =
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let mut d = Describer::new();
|
||||
d.register(
|
||||
"l05",
|
||||
"Several chambers branch off, each with its own contents:\n\
|
||||
{% for s in sentences %}\n {{ s }}{% endfor %}\n\n\
|
||||
💡 Wrap the whole tree under a `chambers:` key — a dict of lists.",
|
||||
)
|
||||
.expect("register template");
|
||||
let description = d
|
||||
.render("l05", &DescCtx { sentences })
|
||||
.expect("render template");
|
||||
|
||||
Generated {
|
||||
target_yaml,
|
||||
description,
|
||||
flavor: "🏛 You enter a hall. Doors lead to many chambers.".to_string(),
|
||||
}
|
||||
}
|
||||
}
|
||||
113
src/levels/l06_anchors.rs
Normal file
113
src/levels/l06_anchors.rs
Normal 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(),
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -112,14 +112,16 @@ impl Level for Complex {
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let mut d = Describer::new();
|
||||
// No tab characters: ratatui's Paragraph renders tabs unevenly,
|
||||
// which combined with the typewriter's progressive reveal can
|
||||
// produce overlapping characters. Use plain spaces for indents.
|
||||
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\
|
||||
"Floor {{ floor }}.\n\n\
|
||||
{% for r in rooms %}{{ r.name }} — a {{ r.kind }} (locked: {{ r.locked }})\n\
|
||||
exits: {% for e in r.exits %}{{ e }}{% if not loop.last %}, {% endif %}{% endfor %}\n\
|
||||
contents: {% for c in r.contents %}{{ c }}{% if not loop.last %}, {% endif %}{% endfor %}\n\n\
|
||||
{% endfor %}\
|
||||
💡 Combine maps, lists, and scalars — `floor:` is an int, each room is a dict with two lists.",
|
||||
)
|
||||
.expect("register template");
|
||||
|
||||
111
src/levels/l08_tags.rs
Normal file
111
src/levels/l08_tags.rs
Normal file
@@ -0,0 +1,111 @@
|
||||
//! Level 8 — tags and newlines. The scroll preserves its lines and
|
||||
//! demands explicit types.
|
||||
//!
|
||||
//! Paired design note: `l08.md`.
|
||||
//!
|
||||
//! The target value uses:
|
||||
//! - a multi-line string for `scroll:` (block scalar `|` round-trips through
|
||||
//! serde_yaml as a `Value::String` with embedded newlines),
|
||||
//! - a fractional float for `weight:` (forces float type without needing the
|
||||
//! `!!float` tag in the target text — but the player can use either),
|
||||
//! - a string of digits for `title:` (player needs quotes or `!!str` to
|
||||
//! avoid the integer interpretation).
|
||||
|
||||
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 Tags;
|
||||
|
||||
const VERBS: &[&str] = &["Beware", "Avoid", "Heed", "Mark"];
|
||||
const NOUNS: &[&str] = &[
|
||||
"the path that turns twice",
|
||||
"the third spring",
|
||||
"the silent statue",
|
||||
"the moonlit door",
|
||||
];
|
||||
const TITLES: &[&str] = &["1024", "2048", "4096", "8192"];
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct DescCtx {
|
||||
scroll_lines: Vec<String>,
|
||||
weight: f64,
|
||||
title: String,
|
||||
}
|
||||
|
||||
impl Level for Tags {
|
||||
fn id(&self) -> u8 {
|
||||
8
|
||||
}
|
||||
|
||||
fn name(&self) -> &'static str {
|
||||
"Scroll of Tags"
|
||||
}
|
||||
|
||||
fn generate(&self, seed: u64) -> Generated {
|
||||
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_0008);
|
||||
|
||||
let line_n = 2;
|
||||
let scroll_lines: Vec<String> = (0..line_n)
|
||||
.map(|_| {
|
||||
let v = VERBS.choose(&mut rng).unwrap();
|
||||
let n = NOUNS.choose(&mut rng).unwrap();
|
||||
format!("{v} {n}.")
|
||||
})
|
||||
.collect();
|
||||
// Block scalar `|` produces a string ending in `\n` after the last line.
|
||||
let scroll_text = format!("{}\n", scroll_lines.join("\n"));
|
||||
|
||||
// Fractional weight so serde_yaml's float serialisation keeps the
|
||||
// `.5` and matches the player's submission unambiguously.
|
||||
let weight = rng.gen_range(1..=20) as f64 + 0.5;
|
||||
let title = TITLES.choose(&mut rng).unwrap().to_string();
|
||||
|
||||
let mut top = Mapping::new();
|
||||
top.insert(
|
||||
Value::String("scroll".to_string()),
|
||||
Value::String(scroll_text),
|
||||
);
|
||||
top.insert(Value::String("weight".to_string()), Value::from(weight));
|
||||
top.insert(
|
||||
Value::String("title".to_string()),
|
||||
Value::String(title.clone()),
|
||||
);
|
||||
|
||||
let target_yaml =
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let mut d = Describer::new();
|
||||
d.register(
|
||||
"l08",
|
||||
"A scroll demands its types. Match exactly:\n\
|
||||
scroll: multi-line text{% for line in scroll_lines %}\n {{ line }}{% endfor %}\n\
|
||||
weight: must parse as the float {{ weight }}\n\
|
||||
title: must parse as the string \"{{ title }}\"\n\
|
||||
💡 Block scalar `|` preserves newlines; `!!str` (or quotes) forces a digit-only string.",
|
||||
)
|
||||
.expect("register template");
|
||||
let description = d
|
||||
.render(
|
||||
"l08",
|
||||
&DescCtx {
|
||||
scroll_lines,
|
||||
weight,
|
||||
title,
|
||||
},
|
||||
)
|
||||
.expect("render template");
|
||||
|
||||
Generated {
|
||||
target_yaml,
|
||||
description,
|
||||
flavor: "📜 An ancient scroll insists on its precise form.".to_string(),
|
||||
}
|
||||
}
|
||||
}
|
||||
135
src/levels/l09_operators.rs
Normal file
135
src/levels/l09_operators.rs
Normal file
@@ -0,0 +1,135 @@
|
||||
//! Level 9 — special operators. The merge key (`<<`) lets a door
|
||||
//! inherit a template and override one field.
|
||||
//!
|
||||
//! Paired design note: `l09.md`.
|
||||
//!
|
||||
//! `serde_yaml` treats `<<` as a literal mapping key (it does NOT
|
||||
//! perform YAML 1.1 merge-key resolution). The target therefore carries
|
||||
//! a `<<` key whose value is the defaults dict, exactly as the player's
|
||||
//! `<<: *defaults` parses.
|
||||
|
||||
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 Operators;
|
||||
|
||||
const MATERIALS: &[&str] = &["oak", "iron", "stone", "silver", "bone"];
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct DescCtx {
|
||||
default_material: String,
|
||||
default_locked: bool,
|
||||
north_locked: bool,
|
||||
south_material: String,
|
||||
}
|
||||
|
||||
impl Level for Operators {
|
||||
fn id(&self) -> u8 {
|
||||
9
|
||||
}
|
||||
|
||||
fn name(&self) -> &'static str {
|
||||
"Merge Keys"
|
||||
}
|
||||
|
||||
fn generate(&self, seed: u64) -> Generated {
|
||||
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_0009);
|
||||
let default_material = (*MATERIALS.choose(&mut rng).unwrap()).to_string();
|
||||
let default_locked = rng.gen_bool(0.5);
|
||||
// The north door overrides locked; choose the opposite so the
|
||||
// override is meaningful.
|
||||
let north_locked = !default_locked;
|
||||
// The south door overrides material; pick anything but default.
|
||||
let other_materials: Vec<&str> = MATERIALS
|
||||
.iter()
|
||||
.filter(|m| **m != default_material)
|
||||
.copied()
|
||||
.collect();
|
||||
let south_material = (*other_materials.choose(&mut rng).unwrap()).to_string();
|
||||
|
||||
// Build the defaults mapping (referenced by all doors).
|
||||
let mut defaults = Mapping::new();
|
||||
defaults.insert(
|
||||
Value::String("material".to_string()),
|
||||
Value::String(default_material.clone()),
|
||||
);
|
||||
defaults.insert(
|
||||
Value::String("locked".to_string()),
|
||||
Value::Bool(default_locked),
|
||||
);
|
||||
|
||||
let mut north_door = Mapping::new();
|
||||
north_door.insert(
|
||||
Value::String("<<".to_string()),
|
||||
Value::Mapping(defaults.clone()),
|
||||
);
|
||||
north_door.insert(
|
||||
Value::String("locked".to_string()),
|
||||
Value::Bool(north_locked),
|
||||
);
|
||||
|
||||
let mut south_door = Mapping::new();
|
||||
south_door.insert(
|
||||
Value::String("<<".to_string()),
|
||||
Value::Mapping(defaults.clone()),
|
||||
);
|
||||
south_door.insert(
|
||||
Value::String("material".to_string()),
|
||||
Value::String(south_material.clone()),
|
||||
);
|
||||
|
||||
let mut top = Mapping::new();
|
||||
top.insert(
|
||||
Value::String("door_defaults".to_string()),
|
||||
Value::Mapping(defaults),
|
||||
);
|
||||
top.insert(
|
||||
Value::String("north_door".to_string()),
|
||||
Value::Mapping(north_door),
|
||||
);
|
||||
top.insert(
|
||||
Value::String("south_door".to_string()),
|
||||
Value::Mapping(south_door),
|
||||
);
|
||||
|
||||
let target_yaml =
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let mut d = Describer::new();
|
||||
d.register(
|
||||
"l09",
|
||||
"Two doors share a template:\n\
|
||||
default material: {{ default_material }}\n\
|
||||
default locked: {{ default_locked }}\n\
|
||||
\n\
|
||||
north_door overrides locked → {{ north_locked }}\n\
|
||||
south_door overrides material → {{ south_material }}\n\
|
||||
💡 Anchor the defaults (`door_defaults: &name`) and merge with `<<: *name` in each door.",
|
||||
)
|
||||
.expect("register template");
|
||||
let description = d
|
||||
.render(
|
||||
"l09",
|
||||
&DescCtx {
|
||||
default_material,
|
||||
default_locked,
|
||||
north_locked,
|
||||
south_material,
|
||||
},
|
||||
)
|
||||
.expect("render template");
|
||||
|
||||
Generated {
|
||||
target_yaml,
|
||||
description,
|
||||
flavor: "🚪 Two doors echo a single template.".to_string(),
|
||||
}
|
||||
}
|
||||
}
|
||||
101
src/levels/l10_dynamic.rs
Normal file
101
src/levels/l10_dynamic.rs
Normal file
@@ -0,0 +1,101 @@
|
||||
//! Level 10 — dynamic values. The vault ledger accepts numbers and
|
||||
//! dates in many forms.
|
||||
//!
|
||||
//! Paired design note: `l10.md`.
|
||||
//!
|
||||
//! The target is canonical (decimal ints, decimal float, ISO date
|
||||
//! string). The lesson is that the player can write equivalent values
|
||||
//! in hex / octal / exponent forms — all parse to the same number.
|
||||
|
||||
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 Dynamic;
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct DescCtx {
|
||||
gold_dec: i64,
|
||||
gold_hex: String,
|
||||
silver_dec: i64,
|
||||
silver_oct: String,
|
||||
experience: f64,
|
||||
date: String,
|
||||
}
|
||||
|
||||
impl Level for Dynamic {
|
||||
fn id(&self) -> u8 {
|
||||
10
|
||||
}
|
||||
|
||||
fn name(&self) -> &'static str {
|
||||
"Vault Ledger"
|
||||
}
|
||||
|
||||
fn generate(&self, seed: u64) -> Generated {
|
||||
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_000A);
|
||||
|
||||
let gold = rng.gen_range(0x100..=0xFFFi64);
|
||||
let silver = rng.gen_range(0o100..=0o777i64);
|
||||
// Fractional float so the canonical serialisation keeps the `.5`.
|
||||
let experience = rng.gen_range(10..=99) as f64 + 0.5;
|
||||
let year = rng.gen_range(1100..=2050i64);
|
||||
let month = rng.gen_range(1..=12i64);
|
||||
let day = rng.gen_range(1..=28i64);
|
||||
let date = format!("{year:04}-{month:02}-{day:02}");
|
||||
|
||||
let mut vault = Mapping::new();
|
||||
vault.insert(Value::String("gold".to_string()), Value::from(gold));
|
||||
vault.insert(Value::String("silver".to_string()), Value::from(silver));
|
||||
vault.insert(
|
||||
Value::String("experience".to_string()),
|
||||
Value::from(experience),
|
||||
);
|
||||
vault.insert(
|
||||
Value::String("date".to_string()),
|
||||
Value::String(date.clone()),
|
||||
);
|
||||
|
||||
let mut top = Mapping::new();
|
||||
top.insert(Value::String("vault".to_string()), Value::Mapping(vault));
|
||||
|
||||
let target_yaml =
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let mut d = Describer::new();
|
||||
d.register(
|
||||
"l10",
|
||||
"The vault ledger demands its values:\n\
|
||||
gold: {{ gold_dec }} (try hex: 0x{{ gold_hex }})\n\
|
||||
silver: {{ silver_dec }} (try octal: 0o{{ silver_oct }})\n\
|
||||
experience: {{ experience }} (any equivalent float form passes)\n\
|
||||
date: {{ date }} (an ISO-8601 date string)\n\
|
||||
💡 Any equivalent numeric form passes — what matters is the parsed value.",
|
||||
)
|
||||
.expect("register template");
|
||||
let description = d
|
||||
.render(
|
||||
"l10",
|
||||
&DescCtx {
|
||||
gold_dec: gold,
|
||||
gold_hex: format!("{:X}", gold),
|
||||
silver_dec: silver,
|
||||
silver_oct: format!("{:o}", silver),
|
||||
experience,
|
||||
date,
|
||||
},
|
||||
)
|
||||
.expect("render template");
|
||||
|
||||
Generated {
|
||||
target_yaml,
|
||||
description,
|
||||
flavor: "🪙 A vault ledger awaits in many ciphers.".to_string(),
|
||||
}
|
||||
}
|
||||
}
|
||||
141
src/levels/l11_adv_anchors.rs
Normal file
141
src/levels/l11_adv_anchors.rs
Normal file
@@ -0,0 +1,141 @@
|
||||
//! Level 11 — advanced anchors. Anchor shapes inside a list, alias
|
||||
//! them elsewhere.
|
||||
//!
|
||||
//! Paired design note: `l11.md`.
|
||||
//!
|
||||
//! Like L6, serde_yaml expands aliases on parse, so the emitted target
|
||||
//! is the fully-inlined form. Players who use `&anchor` / `*alias`
|
||||
//! produce the same `Value` and pass via the semantic short-circuit.
|
||||
|
||||
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 AdvAnchors;
|
||||
|
||||
const SHAPES: &[(&str, i64)] = &[
|
||||
("triangle", 3),
|
||||
("square", 4),
|
||||
("pentagon", 5),
|
||||
("hexagon", 6),
|
||||
("heptagon", 7),
|
||||
("octagon", 8),
|
||||
];
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct DescCtx {
|
||||
shapes: Vec<ShapeDesc>,
|
||||
copies: Vec<String>,
|
||||
}
|
||||
|
||||
#[derive(Serialize)]
|
||||
struct ShapeDesc {
|
||||
name: String,
|
||||
sides: i64,
|
||||
interior_angle_sum: i64,
|
||||
}
|
||||
|
||||
fn shape_value(name: &str, sides: i64) -> Value {
|
||||
let mut m = Mapping::new();
|
||||
m.insert(
|
||||
Value::String("name".to_string()),
|
||||
Value::String(name.to_string()),
|
||||
);
|
||||
m.insert(Value::String("sides".to_string()), Value::from(sides));
|
||||
m.insert(
|
||||
Value::String("interior".to_string()),
|
||||
Value::from((sides - 2) * 180),
|
||||
);
|
||||
Value::Mapping(m)
|
||||
}
|
||||
|
||||
impl Level for AdvAnchors {
|
||||
fn id(&self) -> u8 {
|
||||
11
|
||||
}
|
||||
|
||||
fn name(&self) -> &'static str {
|
||||
"Advanced Anchors"
|
||||
}
|
||||
|
||||
fn generate(&self, seed: u64) -> Generated {
|
||||
let mut rng = ChaCha8Rng::seed_from_u64(seed ^ 0x0000_0000_0000_000B);
|
||||
|
||||
let n = rng.gen_range(2..=3);
|
||||
let picked: Vec<(&'static str, i64)> = SHAPES
|
||||
.choose_multiple(&mut rng, n)
|
||||
.copied()
|
||||
.collect();
|
||||
|
||||
// The defining `shapes:` list.
|
||||
let shapes_seq: Sequence = picked
|
||||
.iter()
|
||||
.map(|(name, sides)| shape_value(name, *sides))
|
||||
.collect();
|
||||
|
||||
// `copies:` — random selections with possible repetition.
|
||||
let m = rng.gen_range(3..=4);
|
||||
let mut copies_seq = Sequence::new();
|
||||
let mut copy_names = Vec::new();
|
||||
for _ in 0..m {
|
||||
let (name, sides) = picked.choose(&mut rng).unwrap();
|
||||
copies_seq.push(shape_value(name, *sides));
|
||||
copy_names.push((*name).to_string());
|
||||
}
|
||||
|
||||
let mut top = Mapping::new();
|
||||
top.insert(
|
||||
Value::String("shapes".to_string()),
|
||||
Value::Sequence(shapes_seq),
|
||||
);
|
||||
top.insert(
|
||||
Value::String("copies".to_string()),
|
||||
Value::Sequence(copies_seq),
|
||||
);
|
||||
|
||||
let target_yaml =
|
||||
serde_yaml::to_string(&Value::Mapping(top)).expect("serialise mapping");
|
||||
|
||||
let shape_descs: Vec<ShapeDesc> = picked
|
||||
.iter()
|
||||
.map(|(name, sides)| ShapeDesc {
|
||||
name: (*name).to_string(),
|
||||
sides: *sides,
|
||||
interior_angle_sum: (sides - 2) * 180,
|
||||
})
|
||||
.collect();
|
||||
|
||||
let mut d = Describer::new();
|
||||
d.register(
|
||||
"l11",
|
||||
"Shapes are defined once and reused.\n\
|
||||
Definitions:\n\
|
||||
{% for s in shapes %}- {{ s.name }}: sides={{ s.sides }}, interior={{ s.interior_angle_sum }}\n\
|
||||
{% endfor %}\n\
|
||||
Copies, in order: {% for c in copies %}{{ c }}{% if not loop.last %}, {% endif %}{% endfor %}\n\
|
||||
💡 Anchor each shape in the list with `- &name`, then alias by `*name` in copies.",
|
||||
)
|
||||
.expect("register template");
|
||||
let description = d
|
||||
.render(
|
||||
"l11",
|
||||
&DescCtx {
|
||||
shapes: shape_descs,
|
||||
copies: copy_names,
|
||||
},
|
||||
)
|
||||
.expect("render template");
|
||||
|
||||
Generated {
|
||||
target_yaml,
|
||||
description,
|
||||
flavor: "🔺 The geometry chamber repeats its forms.".to_string(),
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -13,7 +13,14 @@
|
||||
pub mod l01_minimum;
|
||||
pub mod l02_kv;
|
||||
pub mod l03_dict;
|
||||
pub mod l04_list;
|
||||
pub mod l05_dict_list;
|
||||
pub mod l06_anchors;
|
||||
pub mod l07_complex;
|
||||
pub mod l08_tags;
|
||||
pub mod l09_operators;
|
||||
pub mod l10_dynamic;
|
||||
pub mod l11_adv_anchors;
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
|
||||
@@ -84,5 +91,13 @@ pub fn registry() -> Vec<Box<dyn Level>> {
|
||||
Box::new(l01_minimum::Minimum),
|
||||
Box::new(l02_kv::KeyValue),
|
||||
Box::new(l03_dict::Dict),
|
||||
Box::new(l04_list::List),
|
||||
Box::new(l05_dict_list::DictList),
|
||||
Box::new(l06_anchors::Anchors),
|
||||
Box::new(l07_complex::Complex),
|
||||
Box::new(l08_tags::Tags),
|
||||
Box::new(l09_operators::Operators),
|
||||
Box::new(l10_dynamic::Dynamic),
|
||||
Box::new(l11_adv_anchors::AdvAnchors),
|
||||
]
|
||||
}
|
||||
|
||||
216
src/lib.rs
216
src/lib.rs
@@ -84,7 +84,38 @@ mod smoke {
|
||||
#[test]
|
||||
fn levels_generate_canonical_yaml() {
|
||||
let registry = levels::registry();
|
||||
assert_eq!(registry.len(), 3);
|
||||
assert_eq!(registry.len(), 11, "all 11 levels must be registered");
|
||||
|
||||
// Invariants every level must satisfy, regardless of how it generates.
|
||||
for (i, level) in registry.iter().enumerate() {
|
||||
let want_id = i as u8 + 1;
|
||||
assert_eq!(
|
||||
level.id(),
|
||||
want_id,
|
||||
"level at registry index {i} must report id {want_id}"
|
||||
);
|
||||
|
||||
let seed = 0x5EED_0000 + i as u64;
|
||||
let g = level.generate(seed);
|
||||
|
||||
// The target must be valid YAML.
|
||||
serde_yaml::from_str::<serde_yaml::Value>(&g.target_yaml)
|
||||
.unwrap_or_else(|e| panic!("level {want_id} target is not valid YAML: {e}"));
|
||||
|
||||
// Generation is deterministic for a given seed.
|
||||
let again = level.generate(seed);
|
||||
assert_eq!(
|
||||
g.target_yaml, again.target_yaml,
|
||||
"level {want_id} must be deterministic for a given seed"
|
||||
);
|
||||
|
||||
// The canonical target must be a perfect match against itself.
|
||||
assert_eq!(
|
||||
similarity::semantic_or_textual(&g.target_yaml, &g.target_yaml),
|
||||
1.0,
|
||||
"level {want_id} target must score 1.0 against itself"
|
||||
);
|
||||
}
|
||||
|
||||
// Level 1: any null-equivalent passes via the semantic short-circuit.
|
||||
let g1 = registry[0].generate(0);
|
||||
@@ -95,24 +126,17 @@ mod smoke {
|
||||
1.0,
|
||||
"`---` should be accepted as the minimum YAML"
|
||||
);
|
||||
assert_eq!(
|
||||
similarity::semantic_or_textual(&g1.target_yaml, "null"),
|
||||
1.0
|
||||
);
|
||||
assert_eq!(similarity::semantic_or_textual(&g1.target_yaml, "null"), 1.0);
|
||||
|
||||
// Level 2: deterministic per seed, non-empty mapping.
|
||||
// Level 2: non-empty mapping.
|
||||
let g2 = registry[1].generate(42);
|
||||
let v2: serde_yaml::Value = serde_yaml::from_str(&g2.target_yaml).unwrap();
|
||||
let m = v2.as_mapping().expect("level 2 produces a mapping");
|
||||
assert!(!m.is_empty());
|
||||
let g2_again = registry[1].generate(42);
|
||||
assert_eq!(
|
||||
g2.target_yaml, g2_again.target_yaml,
|
||||
"same seed should produce the same target"
|
||||
);
|
||||
assert!(!v2
|
||||
.as_mapping()
|
||||
.expect("level 2 produces a mapping")
|
||||
.is_empty());
|
||||
|
||||
// Level 3: deterministic per seed; produces a mapping of mappings,
|
||||
// each inner mapping has a `type` key.
|
||||
// Level 3: a mapping of mappings; each inner mapping has a `type` key.
|
||||
let g3 = registry[2].generate(123);
|
||||
let v3: serde_yaml::Value = serde_yaml::from_str(&g3.target_yaml).unwrap();
|
||||
let m3 = v3.as_mapping().expect("level 3 produces a mapping");
|
||||
@@ -124,7 +148,165 @@ mod smoke {
|
||||
"each direction must carry a `type` key"
|
||||
);
|
||||
}
|
||||
let g3_again = registry[2].generate(123);
|
||||
assert_eq!(g3.target_yaml, g3_again.target_yaml);
|
||||
}
|
||||
|
||||
// ---- Per-level shape checks -------------------------------------
|
||||
//
|
||||
// One test per level. Each pins the *shape* its design note promises
|
||||
// and, where it is the whole lesson, the semantic forgiveness. The
|
||||
// generic invariants (valid YAML, determinism, self-similarity, id
|
||||
// ordering) are covered once for every level by
|
||||
// `levels_generate_canonical_yaml` above.
|
||||
|
||||
/// Look up a string key in a YAML mapping, panicking with a clear
|
||||
/// message if it is missing — keeps the per-level assertions terse.
|
||||
fn field<'a>(v: &'a Value, key: &str) -> &'a Value {
|
||||
v.get(key)
|
||||
.unwrap_or_else(|| panic!("expected key `{key}` in {v:?}"))
|
||||
}
|
||||
|
||||
/// Generate level `index` (0-based) with the given seed.
|
||||
fn gen_level(index: usize, seed: u64) -> levels::Generated {
|
||||
levels::registry()[index].generate(seed)
|
||||
}
|
||||
|
||||
/// Parse a target YAML string, asserting it is well-formed.
|
||||
fn parse(yaml: &str) -> Value {
|
||||
serde_yaml::from_str(yaml).expect("target is valid YAML")
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_04_chest_is_a_list() {
|
||||
// `chest:` is a list of 3–5 item strings.
|
||||
let v = parse(&gen_level(3, 4).target_yaml);
|
||||
let chest = field(&v, "chest").as_sequence().expect("chest is a list");
|
||||
assert!((3..=5).contains(&chest.len()), "chest holds 3–5 items");
|
||||
assert!(chest.iter().all(Value::is_string), "every item is a string");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_05_chambers_is_a_dict_of_lists() {
|
||||
// `chambers:` is a dict of 2–3 lists, 2–3 items each.
|
||||
let v = parse(&gen_level(4, 5).target_yaml);
|
||||
let chambers = field(&v, "chambers")
|
||||
.as_mapping()
|
||||
.expect("chambers is a dict");
|
||||
assert!((2..=3).contains(&chambers.len()), "2–3 chambers");
|
||||
for (_name, items) in chambers {
|
||||
let items = items.as_sequence().expect("each chamber holds a list");
|
||||
assert!((2..=3).contains(&items.len()), "2–3 items per chamber");
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_06_trap_repeats_in_every_room() {
|
||||
// `trap:` is defined once; every room repeats it verbatim, so a
|
||||
// player using `&anchor`/`*alias` parses to the same Value.
|
||||
let v = parse(&gen_level(5, 6).target_yaml);
|
||||
let trap = field(&v, "trap");
|
||||
for key in ["type", "depth", "spikes"] {
|
||||
assert!(trap.get(key).is_some(), "trap carries `{key}`");
|
||||
}
|
||||
let rooms = field(&v, "rooms").as_mapping().expect("rooms is a dict");
|
||||
assert!(!rooms.is_empty(), "at least one room");
|
||||
for (_room, payload) in rooms {
|
||||
assert_eq!(payload, trap, "every room repeats the trap definition");
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_07_floor_map_nests_maps_and_lists() {
|
||||
// `floor:` int + `rooms:` dict; each room nests two lists.
|
||||
let v = parse(&gen_level(6, 7).target_yaml);
|
||||
assert!(field(&v, "floor").is_i64(), "floor is an integer");
|
||||
let rooms = field(&v, "rooms").as_mapping().expect("rooms is a dict");
|
||||
assert!(!rooms.is_empty(), "at least one room");
|
||||
for (_name, room) in rooms {
|
||||
assert!(field(room, "type").is_string(), "room.type is a string");
|
||||
assert!(field(room, "locked").is_bool(), "room.locked is a bool");
|
||||
assert!(field(room, "exits").is_sequence(), "room.exits is a list");
|
||||
assert!(
|
||||
field(room, "contents").is_sequence(),
|
||||
"room.contents is a list"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_08_scroll_keeps_explicit_types() {
|
||||
// Explicit types: a multi-line string, a float, and a digit-only
|
||||
// string that must NOT collapse to an integer.
|
||||
let v = parse(&gen_level(7, 8).target_yaml);
|
||||
let scroll = field(&v, "scroll").as_str().expect("scroll is a string");
|
||||
assert!(scroll.contains('\n'), "scroll preserves its newlines");
|
||||
assert!(field(&v, "weight").is_f64(), "weight is a float");
|
||||
let title = field(&v, "title");
|
||||
assert!(title.is_string(), "title stays a string, not an int");
|
||||
assert!(
|
||||
title.as_str().unwrap().chars().all(|c| c.is_ascii_digit()),
|
||||
"title is digit-only — the point of the `!!str` lesson"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_09_doors_merge_shared_defaults() {
|
||||
// Merge keys: each door carries a literal `<<` whose value is the
|
||||
// shared defaults dict, plus its own override.
|
||||
let v = parse(&gen_level(8, 9).target_yaml);
|
||||
let defaults = field(&v, "door_defaults");
|
||||
for door in ["north_door", "south_door"] {
|
||||
assert_eq!(
|
||||
field(field(&v, door), "<<"),
|
||||
defaults,
|
||||
"{door} merges the shared defaults via `<<`"
|
||||
);
|
||||
}
|
||||
assert!(field(field(&v, "north_door"), "locked").is_bool());
|
||||
assert!(field(field(&v, "south_door"), "material").is_string());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_10_ledger_forgives_numeric_forms() {
|
||||
// The ledger: int gold/silver, float experience, ISO date. The
|
||||
// lesson is numeric forgiveness, so hex must score a perfect match.
|
||||
let g = gen_level(9, 10);
|
||||
let v = parse(&g.target_yaml);
|
||||
let vault = field(&v, "vault");
|
||||
let gold = field(vault, "gold").as_i64().expect("gold is an integer");
|
||||
assert!(field(vault, "silver").is_i64(), "silver is an integer");
|
||||
assert!(field(vault, "experience").is_f64(), "experience is a float");
|
||||
assert!(field(vault, "date").is_string(), "date is an ISO string");
|
||||
let hex_candidate = g
|
||||
.target_yaml
|
||||
.replace(&format!("gold: {gold}"), &format!("gold: 0x{gold:X}"));
|
||||
assert_ne!(hex_candidate, g.target_yaml, "hex rewrite must apply");
|
||||
assert_eq!(
|
||||
similarity::semantic_or_textual(&g.target_yaml, &hex_candidate),
|
||||
1.0,
|
||||
"writing gold in hex must still score a perfect match"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_11_copies_alias_defined_shapes() {
|
||||
// `shapes:` defines polygons; `copies:` reuses them, so each copy
|
||||
// is structurally identical to one of the definitions.
|
||||
let v = parse(&gen_level(10, 11).target_yaml);
|
||||
let shapes = field(&v, "shapes").as_sequence().expect("shapes is a list");
|
||||
assert!((2..=3).contains(&shapes.len()), "2–3 defined shapes");
|
||||
for s in shapes {
|
||||
assert!(field(s, "name").is_string(), "shape.name is a string");
|
||||
let sides = field(s, "sides").as_i64().expect("shape.sides is an int");
|
||||
assert_eq!(
|
||||
field(s, "interior").as_i64().expect("shape.interior is an int"),
|
||||
(sides - 2) * 180,
|
||||
"interior angle sum follows (n-2)·180"
|
||||
);
|
||||
}
|
||||
let copies = field(&v, "copies").as_sequence().expect("copies is a list");
|
||||
assert!((3..=4).contains(&copies.len()), "3–4 copies");
|
||||
for c in copies {
|
||||
assert!(shapes.contains(c), "every copy aliases a defined shape");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user