Signal-System mit Inky und KV-Store

src/game.rs

@@ -0,0 +1,63 @@
+//! Owner des dispatch-relevanten Spielzustands und der Borrow-View, durch
+//! die Signal-Actions und Ink-Story-Steps darauf zugreifen.
+//!
+//! `Game` hält die Slots, die Actions lesen oder mutieren dürfen.
+//! `ActionCtx` ist der schmale `&mut`-View; er wird über `Game::action_ctx()`
+//! konstruiert und durch die Dispatch-Pipeline gereicht.
+//!
+//! Verben, deren Ziel-Subsystem (Szene, Audio, Renderer) noch nicht
+//! existiert oder den Kern nichts angeht, produzieren [`Effect`]-Werte
+//! statt direkt zu wirken. Frontends konsumieren die Queue: die CLI druckt
+//! sie, die Engine führt sie später aus. So bleibt der Kern headless
+//! testbar und kennt keines der Subsysteme.
+
+use crate::ink;
+use crate::kv::Store;
+use crate::signals::Signals;
+
+/// Von Actions angeforderte Wirkung außerhalb des Kerns. Die Queue in
+/// `Game::effects` gehört nach jedem Dispatch geleert (konsumiert).
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum Effect {
+    /// Instance unsichtbar + kollisionslos + nicht mehr interagierbar machen.
+    HideObject(String),
+    /// WAV unter `assets/audio/<name>` als SFX abspielen.
+    PlaySound(String),
+    /// Palette/Farbschema unter `assets/palettes/<name>` laden.
+    LoadPalette(String),
+}
+
+pub struct Game {
+    pub kv:      Store,
+    pub signals: Signals,
+    pub story:   Option<ink::Story>,
+    pub effects: Vec<Effect>,
+}
+
+pub struct ActionCtx<'a> {
+    pub kv:      &'a mut Store,
+    pub signals: &'a Signals,
+    pub story:   &'a mut Option<ink::Story>,
+    pub effects: &'a mut Vec<Effect>,
+    /// Auslöser-Identifier: bei Objekt-Interaktion der volle Instance-Name
+    /// (mit Blender-Suffix, z.B. `Mushroom.005`). `$self` in Action-Args
+    /// wird damit substituiert. `None` bei Signalen ohne Quell-Instance
+    /// (z.B. `init`, Story-Tags).
+    pub instance_name: Option<String>,
+}
+
+impl Game {
+    pub fn new(signals: Signals) -> Self {
+        Self { kv: Store::new(), signals, story: None, effects: Vec::new() }
+    }
+
+    pub fn action_ctx(&mut self, instance_name: Option<String>) -> ActionCtx<'_> {
+        ActionCtx {
+            kv:      &mut self.kv,
+            signals: &self.signals,
+            story:   &mut self.story,
+            effects: &mut self.effects,
+            instance_name,
+        }
+    }
+}