@almadar/std 16.178.0 → 16.179.0

package/behaviors/lolo/ui/game/organisms/std-dungeon-board-2d.lolo

@@ -60,6 +60,32 @@ orbital DungeonBoard2DOrbital {
     y : number
     message : string
     ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+  }
+  type FxPreset = {
+    type : string!
+    color : string
+    color2 : string
+    size : number
+    shape : string
+    count : number
+    glow : number
+    gravity : number
+    vx : number
+    vy : number
+    vz : number
+    space : string
+    effect : string
+    particleCount : number
   }
   type DirectionAssets = {
     up : Asset
@@ -203,7 +229,7 @@ orbital DungeonBoard2DOrbital {
             { type: draw-shape-layer, items: (array/map (array/concat @entity.units @entity.enemies) (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), anchor: "ground", offsetX: -0.25, offsetY: -0.6, width: 0.5, height: 0.12, fill: "rgba(0,0,0,0.6)" })) }
             { type: draw-shape-layer, items: (array/map (array/concat @entity.units @entity.enemies) (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), anchor: "ground", offsetX: -0.25, offsetY: -0.6, width: (* 0.5 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) }
             { type: draw-text-layer, items: (array/map (array/concat @entity.units @entity.enemies) (fn u { type: draw-text, text: (object/get @u name), position: (object/get @u position), offsetY: -0.85, color: "#ffffff" })) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f z) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets, sprites: (object/get @config.assetManifest effects) }
           ] } ]
         })
 
@@ -269,7 +295,7 @@ orbital DungeonBoard2DOrbital {
             { type: draw-shape-layer, items: (array/map (array/concat @entity.units @entity.enemies) (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), anchor: "ground", offsetX: -0.25, offsetY: -0.6, width: 0.5, height: 0.12, fill: "rgba(0,0,0,0.6)" })) }
             { type: draw-shape-layer, items: (array/map (array/concat @entity.units @entity.enemies) (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), anchor: "ground", offsetX: -0.25, offsetY: -0.6, width: (* 0.5 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) }
             { type: draw-text-layer, items: (array/map (array/concat @entity.units @entity.enemies) (fn u { type: draw-text, text: (object/get @u name), position: (object/get @u position), offsetY: -0.85, color: "#ffffff" })) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f z) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets, sprites: (object/get @config.assetManifest effects) }
           ] } ]
         })
 
@@ -345,6 +371,10 @@ orbital DungeonBoard2DOrbital {
         @label "Font Family"
         @description "game-shell font family (e.g. pixel)."
         @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "explosion", color: "#fb923c", color2: "#7c2d12", shape: "ring", size: 0.85, count: 8, glow: 0.2, gravity: 0.4 }, { type: "pickup", color: "#ffe066", color2: "#fff4cc", shape: "spark", size: 0.4, count: 5, glow: 0.1, vy: -0.5 } ]
+        @label "Fx Presets"
+        @description "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark."
+        @tier "presentation"
       assetManifest : AssetManifest = { terrains: {}, units: {}, features: {}, effects: {} }
         @label "Asset Manifest"
         @description "Terrain/unit/feature/effect sprite manifest."

package/behaviors/lolo/ui/game/organisms/std-market-board-3d.lolo

@@ -59,6 +59,32 @@ orbital MarketBoard3DOrbital {
     y : number
     message : string
     ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+  }
+  type FxPreset = {
+    type : string!
+    color : string
+    color2 : string
+    size : number
+    shape : string
+    count : number
+    glow : number
+    gravity : number
+    vx : number
+    vy : number
+    vz : number
+    space : string
+    effect : string
+    particleCount : number
   }
   type ValidMove = { x : number!  z : number! }
   type Feature = {
@@ -182,7 +208,7 @@ orbital MarketBoard3DOrbital {
             { type: draw-shape-layer, items: (array/concat (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: { x: (object/get (object/get @u position) x), y: (object/get (object/get @u position) y), z: (object/get @u z) }, offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" })) (array/map @entity.customers (fn c { type: draw-shape, shape: "rect", position: (object/get @c position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" }))) }
             { type: draw-shape-layer, items: (array/concat (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: { x: (object/get (object/get @u position) x), y: (object/get (object/get @u position) y), z: (object/get @u z) }, offsetY: -0.6, width: (* 0.8 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) (array/map @entity.customers (fn c { type: draw-shape, shape: "rect", position: (object/get @c position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "#22c55e" }))) }
             { type: draw-text-layer, items: (array/concat (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: { x: (object/get (object/get @u position) x), y: (object/get (object/get @u position) y), z: (object/get @u z) }, offsetY: -0.85, color: "#ffffff" })) (array/map @entity.customers (fn c { type: draw-text, text: (object/get @c name), position: (object/get @c position), offsetY: -0.85, color: "#ffffff" }))) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f y), z: (object/get @f z) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
           ] } ]
         })
 
@@ -225,7 +251,7 @@ orbital MarketBoard3DOrbital {
             { type: draw-shape-layer, items: (array/concat (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: { x: (object/get (object/get @u position) x), y: (object/get (object/get @u position) y), z: (object/get @u z) }, offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" })) (array/map @entity.customers (fn c { type: draw-shape, shape: "rect", position: (object/get @c position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" }))) }
             { type: draw-shape-layer, items: (array/concat (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: { x: (object/get (object/get @u position) x), y: (object/get (object/get @u position) y), z: (object/get @u z) }, offsetY: -0.6, width: (* 0.8 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) (array/map @entity.customers (fn c { type: draw-shape, shape: "rect", position: (object/get @c position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "#22c55e" }))) }
             { type: draw-text-layer, items: (array/concat (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: { x: (object/get (object/get @u position) x), y: (object/get (object/get @u position) y), z: (object/get @u z) }, offsetY: -0.85, color: "#ffffff" })) (array/map @entity.customers (fn c { type: draw-text, text: (object/get @c name), position: (object/get @c position), offsetY: -0.85, color: "#ffffff" }))) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f y), z: (object/get @f z) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
           ] } ]
         })
     }
@@ -317,6 +343,10 @@ orbital MarketBoard3DOrbital {
         @label "Features"
         @description "Static decorative props (shelves/freezers/checkout/etc); never mutated by any mechanic."
         @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "score", color: "#fbbf24", color2: "#fde68a", size: 0.45, shape: "spark", count: 6, glow: 0.1, vy: -0.3 }, { type: "damage", color: "#ef4444", color2: "#450a0a", size: 0.5, shape: "puff", count: 4, gravity: 0.3 } ]
+        @label "Fx Presets"
+        @description "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark."
+        @tier "presentation"
       assetManifest : AssetManifest = { terrains: {}, units: {}, features: {}, effects: {} }
         @label "Asset Manifest"
         @description "Per-role model manifest resolving tile models by terrain key."

package/behaviors/lolo/ui/game/organisms/std-objective-board-3d.lolo

@@ -50,6 +50,32 @@ orbital ObjectiveBoard3DOrbital {
     y : number
     message : string
     ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+  }
+  type FxPreset = {
+    type : string!
+    color : string
+    color2 : string
+    size : number
+    shape : string
+    count : number
+    glow : number
+    gravity : number
+    vx : number
+    vy : number
+    vz : number
+    space : string
+    effect : string
+    particleCount : number
   }
   type ValidMove = { x : number!  z : number! }
   type Feature = {
@@ -174,7 +200,7 @@ orbital ObjectiveBoard3DOrbital {
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" })) }
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: (* 0.8 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) }
             { type: draw-text-layer, items: (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: (object/get @u position), offsetY: -0.85, color: "#ffffff" })) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f y) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
           ] } ]
         })
 
@@ -217,7 +243,7 @@ orbital ObjectiveBoard3DOrbital {
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" })) }
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: (* 0.8 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) }
             { type: draw-text-layer, items: (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: (object/get @u position), offsetY: -0.85, color: "#ffffff" })) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f y) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
           ] } ]
         })
 
@@ -305,6 +331,10 @@ orbital ObjectiveBoard3DOrbital {
         @label "Bg Color"
         @description "Canvas background color."
         @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "pickup", color: "#ffe066", color2: "#ffffff", size: 0.5, shape: "spark", count: 6, glow: 0.14, vy: -0.3 } ]
+        @label "Fx Presets"
+        @description "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark."
+        @tier "presentation"
       assetManifest : AssetManifest = { terrains: {}, units: {}, features: {}, effects: {} }
         @label "Asset Manifest"
         @description "Per-role model manifest resolving tile/unit/feature models by terrain/category key."

package/behaviors/lolo/ui/game/organisms/std-platformer-board-2d.lolo

@@ -0,0 +1,391 @@
+app std-platformer-board-2d "1.0.0"
+"2D run/jump platformer board FRAME: composes platformer-body (run/jump physics, one-way AABB collision, hazard/goal/fall signals) + fx-particles + objective-flow (win/lose gate) onto one shared GameState with a side-view canvas render. The intent trait owns only game RULES — input forwarding (LEFT/RIGHT/STOP/JUMP → STEER/JUMP intents), goal scoring, hazard/pit lives with respawn, PLAY_AGAIN reset — physics, particles, and the win gate belong to the atoms. Games consume this organism and supply level geometry (platforms, in both BodyAuthority.platforms for collision and the render-side platforms knob), theme/assets, and physics feel via config/traitOverrides."
+orbital PlatformerBoard2DOrbital {
+  uses Body from "std/behaviors/std-platformer-body"
+  uses Particles from "std/behaviors/std-fx-particles"
+  uses Gate from "std/behaviors/std-objective-flow"
+
+  type Asset = {
+    url : asset
+    atlas : asset
+    sprite : string
+    role : string
+    category : string
+    animations : [string]
+    style : string
+    variant : string
+    dimension : string
+    aspect : string
+    name : string
+    thumbnailUrl : string
+  }
+  type PlatformerBody = {
+    x : number!
+    y : number!
+    width : number!
+    height : number!
+    vx : number
+    vy : number
+    grounded : boolean
+    facingRight : boolean
+  }
+  type PlatformerPlatform = {
+    id : string
+    x : number!
+    y : number!
+    width : number!
+    height : number!
+    type : "ground" | "platform" | "hazard" | "goal"
+  }
+  type Fx = {
+    id : string!
+    type : string!
+    x : number!
+    z : number
+    y : number
+    message : string
+    ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+  }
+  type FxPreset = {
+    type : string!
+    color : string
+    color2 : string
+    size : number
+    shape : string
+    count : number
+    glow : number
+    gravity : number
+    vx : number
+    vy : number
+    vz : number
+    space : string
+    effect : string
+    particleCount : number
+  }
+  type DirectionAssets = {
+    up : Asset
+    down : Asset
+    left : Asset
+    right : Asset
+  }
+
+  entity GameState [runtime, shared] {
+    id : string!
+    body : PlatformerBody = { x: 80, y: 320, width: 32, height: 48, vx: 0, vy: 0, grounded: false, facingRight: true }
+    fell : boolean = false
+    hazardId : string = ""
+    goalId : string = ""
+    skating : boolean = false
+    fx : [Fx] = []
+    result : string = "none"
+    score : number = 0
+    lives : number = 3
+    objectivesLeft : number = 1
+    frame : number = 0
+    celebrated : boolean = false
+  }
+
+  trait BodyAuthority = Body.traits.PlatformerBody -> GameState {
+    events {
+      STEER: PLAT_STEER
+      JUMP: PLAT_JUMP
+      PLACE: PLAT_PLACE
+      BODY_MOVED: PLAT_MOVED
+      BODY_JUMPED: PLAT_JUMPED
+      BODY_LANDED: PLAT_LANDED
+      BODY_HAZARD: PLAT_HAZARD
+      BODY_GOAL: PLAT_GOAL
+      BODY_FELL: PLAT_FELL
+    }
+    config {
+      running: true
+      spawn: { x: 80, y: 320, width: 32, height: 48, vx: 0, vy: 0, grounded: false, facingRight: true }
+      platforms: [
+        { id: "g0", x: 0, y: 368, width: 800, height: 32, type: "ground" }
+        { id: "p1", x: 150, y: 280, width: 160, height: 16, type: "platform" }
+        { id: "p2", x: 420, y: 220, width: 160, height: 16, type: "platform" }
+        { id: "h1", x: 580, y: 300, width: 80, height: 16, type: "hazard" }
+        { id: "goal", x: 700, y: 340, width: 64, height: 28, type: "goal" }
+      ]
+      gravity: 550
+      jumpStrength: 365
+      moveSpeed: 120
+      maxFallSpeed: 600
+      xMin: 0
+      xMax: 768
+      killY: 460
+    }
+  }
+
+  trait FxDecay = Particles.traits.FxParticles -> GameState {
+    config { running: true }
+  }
+
+  trait RoundGate = Gate.traits.ObjectiveFlow -> GameState {
+    config { running: true }
+  }
+
+  trait PlatformerIntent -> GameState [interaction, instance] {
+    initial: playing
+
+    state playing {
+      INIT -> playing
+        (set @entity.score 0)
+        (set @entity.lives @config.startLives)
+        (set @entity.objectivesLeft 1)
+        (set @entity.celebrated false)
+        (emit RESTART { id: "board" })
+        (render-ui main {
+          type: game-shell
+          backgroundAsset: @config.backgroundAsset
+          hudBackgroundAsset: @config.hudBackgroundAsset
+          hud: { type: stack, direction: horizontal, gap: md, justify: between, children: [ { type: game-hud, stats: [ { label: "Score", value: @entity.score }, { label: "Lives", value: @entity.lives } ] }, { type: control-grid, kind: "dpad", directionEvents: { left: "LEFT", right: "RIGHT", up: "JUMP" }, directionReleaseEvents: { left: "STOP", right: "STOP" }, directionAssets: @config.directionAssets } ] }
+          overlay: (if (== @entity.result "won") { type: game-menu, title: @config.clearTitle, subtitle: (str/concat "Score: " @entity.score), options: [ { id: "again", label: "Play Again", event: "PLAY_AGAIN", variant: "primary" } ] } (if (== @entity.result "lost") { type: game-menu, title: @config.lostTitle, subtitle: (str/concat "Score: " @entity.score), options: [ { id: "again", label: "Play Again", event: "PLAY_AGAIN", variant: "primary" } ] } null))
+          children: [ { type: canvas, camera: { mode: "follow", zoom: 1, pos: { x: (/ @config.worldWidth 2), y: (/ @config.worldHeight 2) }, target: { x: @entity.body.x, y: @entity.body.y } }, projection: "side", worldWidth: @config.worldWidth, worldHeight: @config.worldHeight, backgroundColor: @config.bgColor, backgroundImage: @config.backgroundImage, keyMap: { ArrowLeft: "LEFT", KeyA: "LEFT", ArrowRight: "RIGHT", KeyD: "RIGHT", ArrowUp: "JUMP", KeyW: "JUMP", Space: "JUMP" }, keyUpMap: { ArrowLeft: "STOP", KeyA: "STOP", ArrowRight: "STOP", KeyD: "STOP" }, drawables: [
+            { type: draw-sprite-layer, items: (array/map @config.platforms (fn p { type: draw-sprite, position: { x: (object/get @p x), y: (object/get @p y) }, width: (object/get @p width), height: (object/get @p height), asset: (object/get @config.tileSprites (object/get @p type)) })) }
+            { type: draw-sprite-layer, items: [ (object/merge { type: "draw-sprite", position: { x: @entity.body.x, y: @entity.body.y }, width: @entity.body.width, height: @entity.body.height, frame: @entity.frame, flipX: (not @entity.body.facingRight) } { asset: (object/merge @config.playerSprite { sprite: (if @entity.body.grounded (if (!= @entity.body.vx 0) (if (== (% @entity.frame 2) 0) "adventurer_walk1.png" "adventurer_walk2.png") "adventurer_idle.png") "adventurer_jump.png") }) }) ] }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
+          ] } ]
+        })
+
+      LEFT -> playing when (== @entity.result "none")
+        (emit PLAT_STEER { dir: -1 })
+
+      RIGHT -> playing when (== @entity.result "none")
+        (emit PLAT_STEER { dir: 1 })
+
+      STOP -> playing when (== @entity.result "none")
+        (emit PLAT_STEER { dir: 0 })
+
+      JUMP -> playing when (== @entity.result "none")
+        (emit PLAT_JUMP {})
+
+      PLAT_GOAL -> playing when (== @entity.result "none")
+        (set @entity.score (+ @entity.score @config.goalScore))
+        (set @entity.objectivesLeft 0)
+        (emit BURST { particles: (array/map (array/filter @config.platforms (fn p (== (object/get @p "id" "") @payload.id))) (fn p { id: (str/concat "fx-goal-" @payload.id), type: "score", x: @payload.x, z: @payload.y, message: (str/concat "+" @config.goalScore), ttl: 3 })) })
+        (emit PROGRESS { objectivesLeft: 0, movesLeft: @entity.lives })
+
+      PLAT_HAZARD -> playing when (== @entity.result "none")
+        (if (<= (- @entity.lives 1) 0)
+          (do
+            (set @entity.lives 0)
+            (emit PROGRESS { objectivesLeft: 1, movesLeft: 0 }))
+          (do
+            (set @entity.lives (- @entity.lives 1))
+            (emit BURST { particles: (array/map (array/filter @config.platforms (fn p (== (object/get @p "id" "") @payload.id))) (fn p { id: (str/concat "fx-hazard-" @payload.id), type: "damage", x: @payload.x, z: @payload.y, message: "-1", ttl: 3 })) })
+            (emit PLAT_PLACE { x: @config.respawnX, y: @config.respawnY })))
+
+      PLAT_FELL -> playing when (== @entity.result "none")
+        (if (<= (- @entity.lives 1) 0)
+          (do
+            (set @entity.lives 0)
+            (emit PROGRESS { objectivesLeft: 1, movesLeft: 0 }))
+          (do
+            (set @entity.lives (- @entity.lives 1))
+            (emit BURST { particles: (array/map [ "fx-fell" ] (fn fid { id: @fid, type: "damage", x: @payload.x, z: @config.worldHeight, message: "-1", ttl: 3 })) })
+            (emit PLAT_PLACE { x: @config.respawnX, y: @config.respawnY })))
+
+      GAME_END -> playing when (== @entity.celebrated false)
+        (set @entity.celebrated true)
+
+      PLAY_AGAIN -> playing
+        (set @entity.score 0)
+        (set @entity.lives @config.startLives)
+        (set @entity.objectivesLeft 1)
+        (set @entity.celebrated false)
+        (emit RESTART { id: "board" })
+    }
+
+    ticks {
+      renderTick every 100ms
+        (set @entity.frame (% (+ @entity.frame 1) 8))
+        (render-ui main {
+          type: game-shell
+          backgroundAsset: @config.backgroundAsset
+          hudBackgroundAsset: @config.hudBackgroundAsset
+          hud: { type: stack, direction: horizontal, gap: md, justify: between, children: [ { type: game-hud, stats: [ { label: "Score", value: @entity.score }, { label: "Lives", value: @entity.lives } ] }, { type: control-grid, kind: "dpad", directionEvents: { left: "LEFT", right: "RIGHT", up: "JUMP" }, directionReleaseEvents: { left: "STOP", right: "STOP" }, directionAssets: @config.directionAssets } ] }
+          overlay: (if (== @entity.result "won") { type: game-menu, title: @config.clearTitle, subtitle: (str/concat "Score: " @entity.score), options: [ { id: "again", label: "Play Again", event: "PLAY_AGAIN", variant: "primary" } ] } (if (== @entity.result "lost") { type: game-menu, title: @config.lostTitle, subtitle: (str/concat "Score: " @entity.score), options: [ { id: "again", label: "Play Again", event: "PLAY_AGAIN", variant: "primary" } ] } null))
+          children: [ { type: canvas, camera: { mode: "follow", zoom: 1, pos: { x: (/ @config.worldWidth 2), y: (/ @config.worldHeight 2) }, target: { x: @entity.body.x, y: @entity.body.y } }, projection: "side", worldWidth: @config.worldWidth, worldHeight: @config.worldHeight, backgroundColor: @config.bgColor, backgroundImage: @config.backgroundImage, keyMap: { ArrowLeft: "LEFT", KeyA: "LEFT", ArrowRight: "RIGHT", KeyD: "RIGHT", ArrowUp: "JUMP", KeyW: "JUMP", Space: "JUMP" }, keyUpMap: { ArrowLeft: "STOP", KeyA: "STOP", ArrowRight: "STOP", KeyD: "STOP" }, drawables: [
+            { type: draw-sprite-layer, items: (array/map @config.platforms (fn p { type: draw-sprite, position: { x: (object/get @p x), y: (object/get @p y) }, width: (object/get @p width), height: (object/get @p height), asset: (object/get @config.tileSprites (object/get @p type)) })) }
+            { type: draw-sprite-layer, items: [ (object/merge { type: "draw-sprite", position: { x: @entity.body.x, y: @entity.body.y }, width: @entity.body.width, height: @entity.body.height, frame: @entity.frame, flipX: (not @entity.body.facingRight) } { asset: (object/merge @config.playerSprite { sprite: (if @entity.body.grounded (if (!= @entity.body.vx 0) (if (== (% @entity.frame 2) 0) "adventurer_walk1.png" "adventurer_walk2.png") "adventurer_idle.png") "adventurer_jump.png") }) }) ] }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
+          ] } ]
+        })
+    }
+
+    emits {
+      LEFT -> external {
+        id : string
+      }
+        @description "Move-left intent from ArrowLeft/KeyA keydown or d-pad (forwarded to the body authority as STEER dir −1)"
+        @tier "domain"
+      RIGHT -> external {
+        id : string
+      }
+        @description "Move-right intent from ArrowRight/KeyD keydown or d-pad (forwarded to the body authority as STEER dir +1)"
+        @tier "domain"
+      STOP -> external {
+        id : string
+      }
+        @description "Horizontal key release (keyUpMap or d-pad directionReleaseEvents); forwarded as STEER dir 0 so the body stops"
+        @tier "domain"
+      JUMP -> external {
+        id : string
+      }
+        @description "Jump intent from Space/ArrowUp/KeyW or d-pad up; forwarded to the body authority, which accepts it only while grounded"
+        @tier "domain"
+      PLAT_STEER -> external {
+        dir : number!
+      }
+        @description "Renamed STEER consumed by the platformer-body authority: −1/0/+1 × moveSpeed horizontal velocity"
+        @tier "domain"
+      PLAT_JUMP -> external {
+        id : string
+      }
+        @description "Renamed JUMP consumed by the platformer-body authority (grounded-gated vertical kick)"
+        @tier "domain"
+      PLAT_PLACE -> external {
+        x : number!
+        y : number!
+      }
+        @description "Renamed PLACE consumed by the platformer-body authority; hazard/pit respawn teleport"
+        @tier "domain"
+      PLAT_GOAL -> external {
+        id : string!
+        x : number!
+        y : number!
+      }
+        @description "Goal-tile contact signal from the platformer-body authority (renamed BODY_GOAL); scores and trips the win gate"
+        @tier "domain"
+      PLAT_HAZARD -> external {
+        id : string!
+        x : number!
+        y : number!
+      }
+        @description "Hazard-tile contact signal from the platformer-body authority (renamed BODY_HAZARD); costs a life and respawns"
+        @tier "domain"
+      PLAT_FELL -> external {
+        x : number!
+        y : number!
+      }
+        @description "Pit-fall signal from the platformer-body authority (renamed BODY_FELL); costs a life and respawns"
+        @tier "domain"
+      BURST -> external {
+        particles : [Fx]
+      }
+        @description "Floating-text particle batch spawned on score/damage; fx-particles fades it"
+        @tier "domain"
+      PROGRESS -> external {
+        objectivesLeft : number!
+        movesLeft : number!
+      }
+        @description "Sparse win/lose signal consumed by the objective-flow gate: objectivesLeft 0 = won, movesLeft 0 = lost"
+        @tier "domain"
+      GAME_END -> external {
+        result : string!
+      }
+        @description "Win/lose resolution from the objective-flow gate; guarded by celebrated so it lands once"
+        @tier "domain"
+      RESTART -> external {
+        id : string
+      }
+        @description "Broadcast reset consumed by the platformer-body and objective-flow authorities on INIT/PLAY_AGAIN"
+        @tier "domain"
+      PLAY_AGAIN -> external {
+        id : string
+      }
+        @description "End-overlay restart button; reseeds score/lives/objectives and broadcasts RESTART"
+        @tier "domain"
+    }
+
+    config {
+      platforms : [PlatformerPlatform] = [
+        { id: "g0", x: 0, y: 368, width: 800, height: 32, type: "ground" }
+        { id: "p1", x: 150, y: 280, width: 160, height: 16, type: "platform" }
+        { id: "p2", x: 420, y: 220, width: 160, height: 16, type: "platform" }
+        { id: "h1", x: 580, y: 300, width: 80, height: 16, type: "hazard" }
+        { id: "goal", x: 700, y: 340, width: 64, height: 28, type: "goal" }
+      ]
+        @label "Platforms"
+        @description "Level geometry rendered by the canvas (must match BodyAuthority.platforms, which owns collision — override both together)"
+        @tier "domain"
+      respawnX : number = 80
+        @label "Respawn X"
+        @description "X the body teleports to after hazard/pit damage (matches BodyAuthority spawn.x)"
+        @tier "domain"
+      respawnY : number = 320
+        @label "Respawn Y"
+        @description "Y the body teleports to after hazard/pit damage (matches BodyAuthority spawn.y)"
+        @tier "domain"
+      goalScore : number = 100
+        @label "Goal Score"
+        @description "Points awarded when the body touches the goal tile"
+        @tier "domain"
+      startLives : number = 3
+        @label "Start Lives"
+        @description "Lives seeded on INIT/PLAY_AGAIN; hazard or pit contact costs one, zero loses the round"
+        @tier "domain"
+      worldWidth : number = 800
+        @label "World Width"
+        @description "World pixel width (camera + canvas bounds)"
+        @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "score", color: "#ffe066", color2: "#fff4cc", shape: "spark", size: 22, count: 6, glow: 0.15, vy: -35 }, { type: "damage", color: "#ef4444", color2: "#7f1d1d", shape: "spark", size: 20, count: 5, glow: 0.12, gravity: 40 } ]
+        @label "Fx Presets"
+        @description "This board's effect vocabulary — one look/recipe row per fx type its intent trait emits (goal score, hazard/fell damage)."
+        @tier "presentation"
+      worldHeight : number = 400
+        @label "World Height"
+        @description "World pixel height (camera + canvas bounds)"
+        @tier "presentation"
+      bgColor : string = "#5c94fc"
+        @label "Bg Color"
+        @description "Canvas background color"
+        @tier "presentation"
+      clearTitle : string = "YOU WIN!"
+        @label "Clear Title"
+        @description "Overlay title when the goal tile is reached"
+        @tier "presentation"
+      lostTitle : string = "GAME OVER"
+        @label "Lost Title"
+        @description "Overlay title when lives run out"
+        @tier "presentation"
+      playerSprite : Asset = {}
+        @label "Player Sprite"
+        @description "Player sprite Asset; its atlas must expose adventurer_idle/walk1/walk2/jump frames (or override the sprite-selection expression)"
+        @tier "presentation"
+      tileSprites : Map string Asset = {}
+        @label "Tile Sprites"
+        @description "Map of platform type (ground/platform/hazard/goal) to tile sprite Asset"
+        @tier "presentation"
+      backgroundImage : Asset = {}
+        @label "Background Image"
+        @description "Canvas background image Asset"
+        @tier "presentation"
+      backgroundAsset : Asset = {}
+        @label "Background Asset"
+        @description "Game-shell background panel sprite (theme chrome)"
+        @tier "presentation"
+      hudBackgroundAsset : Asset = {}
+        @label "HUD Background Asset"
+        @description "HUD panel background sprite (theme chrome)"
+        @tier "presentation"
+      directionAssets : DirectionAssets = {}
+        @label "Direction Assets"
+        @description "D-pad direction icon sprites"
+        @tier "presentation"
+    }
+  }
+
+  page "/platformer-board-2d" as PlatformerBoard2DPage -> BodyAuthority, FxDecay, RoundGate, PlatformerIntent
+}

package/behaviors/lolo/ui/game/organisms/std-survival-board-3d.lolo

@@ -50,6 +50,32 @@ orbital SurvivalBoard3DOrbital {
     y : number
     message : string
     ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+  }
+  type FxPreset = {
+    type : string!
+    color : string
+    color2 : string
+    size : number
+    shape : string
+    count : number
+    glow : number
+    gravity : number
+    vx : number
+    vy : number
+    vz : number
+    space : string
+    effect : string
+    particleCount : number
   }
   type ValidMove = { x : number!  z : number! }
   type Feature = {
@@ -149,7 +175,7 @@ orbital SurvivalBoard3DOrbital {
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" })) }
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: (* 0.8 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) }
             { type: draw-text-layer, items: (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: (object/get @u position), offsetY: -0.85, color: "#ffffff" })) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f y) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
           ] } ]
         })
 
@@ -195,7 +221,7 @@ orbital SurvivalBoard3DOrbital {
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: 0.8, height: 0.12, fill: "rgba(0,0,0,0.6)" })) }
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: (object/get @u position), offsetY: -0.6, width: (* 0.8 (/ (object/get @u health) (object/get @u maxHealth))), height: 0.12, fill: "#22c55e" })) }
             { type: draw-text-layer, items: (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: (object/get @u position), offsetY: -0.85, color: "#ffffff" })) }
-            { type: draw-text-layer, items: (array/map @entity.fx (fn f { type: draw-text, text: (object/get @f message), position: { x: (object/get @f x), y: (object/get @f y) }, color: "#ffe066" })) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets }
           ] } ]
         })
 
@@ -288,6 +314,10 @@ orbital SurvivalBoard3DOrbital {
         @label "Bg Color"
         @description "Canvas background color."
         @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "pickup", color: "#84a98c", color2: "#6b4226", size: 0.45, shape: "spark", count: 5, vy: -0.2 } ]
+        @label "Fx Presets"
+        @description "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark."
+        @tier "presentation"
       assetManifest : AssetManifest = { terrains: {}, units: {}, features: {}, effects: {} }
         @label "Asset Manifest"
         @description "Per-role model manifest resolving tile/unit/feature models by terrain/category key."