Merge pull request 'Add level 4: The Chest (lists)' (#1) from level-4 into master

Reviewed-on: #1

src/levels/l04_list.rs

@@ -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(),
+        }
+    }
+}

src/levels/l08_tags.rs

@@ -1,111 +0,0 @@
-//! 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(),
-        }
-    }
-}

src/levels/mod.rs

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