ingredient adjustments

ingredients/Detecting Collisions.ts

@@ -2,7 +2,21 @@ import { Behavior, Entity, EntityCollision } from "@dreamlab/engine";
 import HealthBar from "./health-bar.ts";
 import PlayerBehavior from "./player.ts";
 
-// Example of entity collision
+/*
+  Handling Collisions in Game Entities:
+
+  The `EntityCollision` signal in "@dreamlab/engine"
+  helps detect when two entities collide. This signal provides details like whether the collision
+  has just started and the other entity involved.
+
+  Key Points:
+  - **Listening for Collisions:** Use the `listen` method to react to collision events.
+  - **Collision Filtering:** Handle collisions only with specific entities by checking their properties.
+  - **Responding to Collisions:** For example, decrease health or destroy an entity when a collision occurs.
+
+  Below is an `EnemyBehavior` that reduces health when hit by a bullet and increases the player's score if the enemy is destroyed.
+*/
+
 export default class EnemyBehavior extends Behavior {
   private healthBar!: HealthBar;
 

ingredients/Handling Input.ts

@@ -1,4 +1,4 @@
-import { Behavior, BehaviorContext, Vector2 } from "@dreamlab/engine";
+import { Behavior, Vector2 } from "@dreamlab/engine";
 import PlayerBehavior from "./player.ts";
 
 /*
@@ -43,8 +43,7 @@ export default class Movement extends Behavior {
 
   velocity = Vector2.ZERO;
 
-  constructor(ctx: BehaviorContext) {
-    super(ctx);
+  onInitialize() {
     this.defineValues(Movement, "speed");
   }
 

ingredients/Handling Local State (values).ts

@@ -1,4 +1,4 @@
-import { Behavior, BehaviorContext, Vector2 } from "@dreamlab/engine";
+import { Behavior, Vector2 } from "@dreamlab/engine";
 
 /*
   Handling Values in Behaviors:
@@ -34,9 +34,7 @@ export default class PlayerMovement extends Behavior {
   #right = this.inputs.create("@movement/right", "Move Right", "KeyD");
   #boost = this.inputs.create("@movement/boost", "Speed Boost", "ShiftLeft");
 
-  constructor(ctx: BehaviorContext) {
-    super(ctx);
-
+  onInitialize() {
     /*
       Defining the `speed` value to be managed by the behavior.
       - The `defineValues` method is used to specify which properties should be treated as values.

ingredients/Moving Entities (scale, position, rotation).ts

@@ -1,6 +1,13 @@
 // Example of changing an entities position through a behavior. This one is more basic.
-import { Behavior, BehaviorContext, Vector2 } from "@dreamlab/engine";
+import { Behavior, Vector2 } from "@dreamlab/engine";
 
+/*
+  Key Points:
+  - **Basic Movement:** Calculate the new position by adding a direction vector to the current position.
+  - **Transform Properties:** Use properties like `position`, `rotation`, and `scale` to control entity movement and appearance.
+
+  This example moves an asteroid in a random direction at a constant speed.
+*/
 export default class AsteroidMovement extends Behavior {
   readonly #direction = new Vector2(
     Math.random() * 2 - 1,

ingredients/Rendering User Interfaces.ts

@@ -1,4 +1,4 @@
-import { Behavior, BehaviorContext, UILayer } from "@dreamlab/engine";
+import { Behavior, UILayer } from "@dreamlab/engine";
 import { element } from "@dreamlab/ui";
 import { spawnPlayer } from "./start-screen.ts";
 
@@ -44,8 +44,7 @@ export default class DeathScreen extends Behavior {
   #element!: HTMLDivElement;
   score: number = 0;
 
-  constructor(ctx: BehaviorContext) {
-    super(ctx);
+  onInitialize() {
     this.defineValues(DeathScreen, "score");
   }