@almadar/std 16.178.0 → 16.180.0

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."

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

@@ -51,6 +51,32 @@ orbital TacticsBoard2DOrbital {
     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 = {
@@ -188,10 +214,9 @@ orbital TacticsBoard2DOrbital {
             { type: draw-shape-layer, items: (array/map (array/filter @entity.units (fn u (> (object/get @u health) 0))) (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/filter @entity.units (fn u (> (object/get @u health) 0))) (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/filter @entity.units (fn u (> (object/get @u health) 0))) (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-sprite-layer, items: (array/filter (array/map (array/filter @entity.fx (fn f (not (object/get @entity.svgAssetArt (object/get @f type))))) (fn f { type: draw-sprite, position: { x: (object/get @f x), y: (object/get @f z) }, asset: (object/get (object/get @config.assetManifest effects) (object/get @f type)), anchor: "center", width: 0.6, height: 0.6 })) (fn s (object/get (object/get @s asset) url))) }
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets, art: @entity.svgAssetArt, sprites: (object/get @config.assetManifest effects) }
           ] (array/concat
-            (array/map (array/filter @entity.fx (fn f (object/get @entity.svgAssetArt (object/get @f type)))) (fn f { type: draw-group, position: { x: (object/get @f x), y: (object/get @f z) }, items: (object/get (object/get @entity.svgAssetArt (object/get @f type)) "idle") }))
+            []
           [
             { type: draw-sprite-layer, items: (array/map (array/filter (array/flatten (array/map @entity.units (fn u (array/flatten (array/map [ ["idle", 4], ["walk", 2], ["attack", 1], ["hit", 1], ["death", 1] ] (fn st (array/map (array/range 0 (array/nth @st 1)) (fn i (if (and (object/get (object/get @u modelUrl) url) (str/includes (object/get (object/get @u modelUrl) url) ".svg")) (str/concat (array/nth (str/split (object/get (object/get @u modelUrl) url) ".svg") 0) (str/concat "." (str/concat (array/nth @st 0) (str/concat "-" (str/concat @i ".svg"))))) ""))))))))) (fn w (!= @w ""))) (fn warmUrl { type: draw-sprite, position: { x: 0, y: 0 }, asset: { url: @warmUrl }, opacity: 0, width: 0.5, height: 0.5 })) }
           ])))))))) } ]
@@ -285,9 +310,8 @@ orbital TacticsBoard2DOrbital {
             { type: draw-shape-layer, items: (array/map (array/filter @entity.units (fn u (> (object/get @u health) 0))) (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/filter @entity.units (fn u (> (object/get @u health) 0))) (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/filter @entity.units (fn u (> (object/get @u health) 0))) (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-sprite-layer, items: (array/filter (array/map (array/filter @entity.fx (fn f (not (object/get @entity.svgAssetArt (object/get @f type))))) (fn f { type: draw-sprite, position: { x: (object/get @f x), y: (object/get @f z) }, asset: (object/get (object/get @config.assetManifest effects) (object/get @f type)), anchor: "center", width: 0.6, height: 0.6 })) (fn s (object/get (object/get @s asset) url))) }
-          ] (array/map (array/filter @entity.fx (fn f (object/get @entity.svgAssetArt (object/get @f type)))) (fn f { type: draw-group, position: { x: (object/get @f x), y: (object/get @f z) }, items: (object/get (object/get @entity.svgAssetArt (object/get @f type)) "idle") }))))))))) } ]
+            { type: draw-fx-layer, items: @entity.fx, tickMs: 500, presets: @config.fxPresets, art: @entity.svgAssetArt, sprites: (object/get @config.assetManifest effects) }
+          ] []))))))) } ]
         })
     }
 
@@ -357,6 +381,10 @@ orbital TacticsBoard2DOrbital {
         @label "Asset Manifest"
         @description "Terrain/unit/feature/effect sprite manifest."
         @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "hit", color: "#ff6b6b", color2: "#ffb347", shape: "spark", size: 0.45, count: 6, glow: 0.12, 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"
       projection : string = "flat"
         @label "Projection"
         @description "canvas-2d projection: flat or isometric."

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

@@ -80,6 +80,32 @@ orbital TacticsBoard3DOrbital {
     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 = {
@@ -184,9 +210,9 @@ orbital TacticsBoard3DOrbital {
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: { x: (object/get @u x), y: (object/get @u 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" })) }
             { type: draw-text-layer, items: (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: { x: (object/get @u x), y: (object/get @u y), z: (object/get @u z) }, offsetY: -0.85, color: "#ffffff" })) }
           ] (array/concat
-            (array/map (array/filter @entity.fx (fn f (object/get @entity.meshAssetArt (object/get @f type)))) (fn f { type: draw-group, position: { x: (object/get @f x), y: (object/get @f y), z: (object/get @f z) }, items: (object/get (object/get @entity.meshAssetArt (object/get @f type)) "idle") }))
+            []
           [
-            { 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, art: @entity.meshAssetArt }
           ])))))))) } ]
         })
 
@@ -252,9 +278,9 @@ orbital TacticsBoard3DOrbital {
             { type: draw-shape-layer, items: (array/map @entity.units (fn u { type: draw-shape, shape: "rect", position: { x: (object/get @u x), y: (object/get @u 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" })) }
             { type: draw-text-layer, items: (array/map @entity.units (fn u { type: draw-text, text: (object/get @u name), position: { x: (object/get @u x), y: (object/get @u y), z: (object/get @u z) }, offsetY: -0.85, color: "#ffffff" })) }
           ] (array/concat
-            (array/map (array/filter @entity.fx (fn f (object/get @entity.meshAssetArt (object/get @f type)))) (fn f { type: draw-group, position: { x: (object/get @f x), y: (object/get @f y), z: (object/get @f z) }, items: (object/get (object/get @entity.meshAssetArt (object/get @f type)) "idle") }))
+            []
           [
-            { 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, art: @entity.meshAssetArt }
           ])))))))) } ]
         })
     }
@@ -315,6 +341,10 @@ orbital TacticsBoard3DOrbital {
         @label "Features"
         @description "Decorative environment features drawn on the board."
         @tier "presentation"
+      fxPresets : [FxPreset] = [ { type: "hit", color: "#ff5252", color2: "#7a1010", size: 0.5, shape: "spark", count: 6, glow: 0.12, gravity: 0.6, 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 "Terrain/unit/feature/effect model manifest."

package/behaviors/lolo/ui/learning/atoms/std-learn-arrangement.lolo

@@ -301,6 +301,7 @@ orbital LearnArrangementOrbital {
           ]
         })
         (emit ARRANGEMENT_CHECKED { correctCount: @entity.correctCount, total: @entity.totalItems })
+        (if (== @entity.correctCount @entity.totalItems) (emit LEARN_ROUND_COMPLETE { score: @entity.correctCount, total: @entity.totalItems }) null)
 
       RETRY -> idle when (== @entity.active true)
         (set @entity.placedIds [])
@@ -388,6 +389,13 @@ orbital LearnArrangementOrbital {
         @description "Signals the arrangement was cleared back to empty by Retry — a composed listener can subscribe; a harmless no-op when the atom runs standalone."
         @synonyms "arrangement reset, retry, restart"
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired when a Check grades the arrangement fully correct — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion, all correct"
+        @tier "domain"
     }
 
     config {

package/behaviors/lolo/ui/learning/atoms/std-learn-classify.lolo

@@ -382,6 +382,7 @@ orbital LearnClassifyOrbital {
         (emit CLASSIFY_UPDATED { itemIndex: @entity.itemIndex, correctCount: @entity.correctCount, attemptedCount: @entity.attemptedCount, selectedCategory: @entity.selectedCategory, verdict: @entity.verdict, roundComplete: @entity.roundComplete })
 
       ADVANCE -> idle when (and (== @entity.active true) (== @entity.roundComplete false))
+        (if (and (not @config.loopRound) (>= (+ @entity.itemIndex @config.orderStride) @entity.totalItems)) (emit LEARN_ROUND_COMPLETE { score: @entity.correctCount, total: @entity.totalItems }) null)
         (let (
             (isLast (and (not @config.loopRound) (>= (+ @entity.itemIndex @config.orderStride) @entity.totalItems)))
           )
@@ -650,6 +651,13 @@ orbital LearnClassifyOrbital {
         @description "The classification state after each learner action — a composed listener (readout, grader) can subscribe; a harmless no-op when the atom runs standalone."
         @synonyms "classify update, pick result, score, running score, verdict"
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the round finishes (the advance past the final item) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion"
+        @tier "domain"
     }
 
     config {