@almadar/std 16.178.0 → 16.179.0

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 {

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

@@ -146,6 +146,7 @@ orbital LearnDerivationOrbital {
                 @candidate.noMatchFeedback)))
             (set @entity.goalReached (if @canDerive (== @derivedLabel @config.goalLabel) @entity.goalReached))
             (set @entity.narration @entity.feedback)
+            (if (and @canDerive (== @derivedLabel @config.goalLabel)) (emit LEARN_ROUND_COMPLETE { score: 1, total: 1 }) null)
           )
         )
         (set @entity.renderChildren [
@@ -345,6 +346,13 @@ orbital LearnDerivationOrbital {
         @description "The derivation state after each learner action — a composed listener (readout, grader) can subscribe; a harmless no-op when the atom runs standalone."
         @synonyms "derivation update, proof step, derived line, candidate applied, goal reached"
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the step that derives the goal fact lands — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion, goal reached"
+        @tier "domain"
     }
 
     config {

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

@@ -226,6 +226,7 @@ orbital LearnDoserOrbital {
             ]
           }))
         (emit DOSE_ADDED { dose: @entity.dose, bandLabel: @entity.bandLabel, bandColor: @entity.bandColor, done: @entity.done })
+        (if @entity.done (emit LEARN_ROUND_COMPLETE { score: 1, total: 1 }) null)
 
       ADD_LARGE -> idle when (and (== @entity.active true) (== @entity.done false))
         (set @entity.dose (math/min (+ @entity.dose @config.stepLarge) @config.capacity))
@@ -283,6 +284,7 @@ orbital LearnDoserOrbital {
             ]
           }))
         (emit DOSE_ADDED { dose: @entity.dose, bandLabel: @entity.bandLabel, bandColor: @entity.bandColor, done: @entity.done })
+        (if @entity.done (emit LEARN_ROUND_COMPLETE { score: 1, total: 1 }) null)
 
       TOGGLE_DRIP -> idle when (== @entity.active true)
         (set @entity.running (not @entity.running))
@@ -427,6 +429,13 @@ orbital LearnDoserOrbital {
         @description "Fires on INIT/MODE_SELECTED/auto-drip toggle with the transport-level state — running flag, dose, current band, done — so a composed sibling trait can repaint its own shell. A harmless no-op when the atom runs standalone."
         @synonyms "drip toggle, running state, auto-dose"
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the dose crosses into a terminal band and latches done — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion, terminal band"
+        @tier "domain"
     }
 
     config {

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

@@ -206,6 +206,7 @@ orbital EstimateOrbital {
         (emit ESTIMATE_JUDGED { band: @entity.band, estimate: @entity.estimate, answer: @entity.answer, score: @entity.score })
 
       NEXT -> idle when (and (== @entity.active true) (and (== @entity.locked true) (== @entity.done false)))
+        (if (>= (+ @entity.promptIndex 1) (array/len @config.prompts)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @config.prompts) }) null)
         (let (
             (nextIndex (+ @entity.promptIndex 1))
             (finished (>= @nextIndex (array/len @config.prompts)))
@@ -355,6 +356,13 @@ orbital EstimateOrbital {
       }
         @description "The learner restarted the round from scratch."
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the round finishes (advancing past the final prompt) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion"
+        @tier "domain"
     }
 
     config {

package/behaviors/lolo/ui/learning/atoms/std-learn-fx-cues.lolo

@@ -0,0 +1,147 @@
+app std-learn-fx-cues "1.0.0"
+"Headless pedagogy→fx translator: rides the bare-event cascade of the graded learning instruments (ANSWER_JUDGED, TAP_JUDGED, ESTIMATE_JUDGED, CLASSIFY_UPDATED, ARRANGEMENT_CHECKED, GOAL_CHECKED, LEARN_ROUND_COMPLETE, TRACE_DONE) and emits BURST cues for std-fx-particles to hold and a composed fx-overlay to play — correct/wrong beats, streak glow at a threshold, and a celebration on completion. Cues are typed FxCue config values carrying their own style (position, ttl, screen effect, color), so a lab opts in with two `uses` lines plus an overlay node and restyles or disables any cue purely through config; the instruments never learn about visuals, and this atom never learns about subjects. A new judged event elsewhere in the substrate means a new arm here — this listens list is the closed extension point. Renders nothing."
+orbital LearnFxCuesOrbital {
+  type Fx = {
+    id : string!
+    type : string!
+    x : number!
+    z : number
+    y : number
+    message : string
+    ttl : number!
+    space : string
+    effect : string
+    color : string
+    size : number
+    particleCount : number
+  }
+  type FxCue = {
+    type : string!
+    x : number!
+    z : number
+    ttl : number!
+    space : string
+    effect : string
+    color : string
+    size : number
+    particleCount : number
+    message : string
+  }
+  type FxBandCue = {
+    band : string!
+    cue : FxCue!
+  }
+
+  entity LearnFxCuesScene [runtime, shared] {
+    id : string!
+    cueSeq : number = 0
+  }
+
+  trait LearnFxCues -> @rebindable LearnFxCuesScene [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.cueSeq 0)
+      ANSWER_JUDGED -> active when @config.running
+        (emit BURST { particles: (array/concat
+          [ (object/merge (if ?correct @config.correctCue @config.wrongCue) { id: (str/concat "cue-" (+ @entity.cueSeq 1)) }) ]
+          (if (and ?correct (>= ?streak @config.streakThreshold))
+            [ (object/merge @config.streakCue { id: (str/concat "streak-" (+ @entity.cueSeq 1)) }) ]
+            [])) })
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      TAP_JUDGED -> active when @config.running
+        (emit BURST { particles: (array/map [ (if ?correct @config.correctCue @config.wrongCue) ] (fn c { id: (str/concat "cue-" (+ @entity.cueSeq 1)), type: (object/get @c type), x: (object/get @c x), z: (object/get @c z), ttl: (object/get @c ttl), space: (object/get @c space), effect: (object/get @c effect), color: (object/get @c color), size: (object/get @c size), particleCount: (object/get @c particleCount), message: (object/get @c message) })) })
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      ESTIMATE_JUDGED -> active when @config.running
+        (let ((matched (array/filter @config.bandCues (fn b (== (object/get @b band) ?band)))))
+          (if (> (array/len @matched) 0)
+            (emit BURST { particles: [ (object/merge (object/get (array/first @matched) cue) { id: (str/concat "cue-" (+ @entity.cueSeq 1)) }) ] })
+            null))
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      CLASSIFY_UPDATED -> active when @config.running
+        (let ((matched (array/filter @config.verdictCues (fn v (== (object/get @v band) ?verdict)))))
+          (if (> (array/len @matched) 0)
+            (emit BURST { particles: [ (object/merge (object/get (array/first @matched) cue) { id: (str/concat "cue-" (+ @entity.cueSeq 1)) }) ] })
+            null))
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      ARRANGEMENT_CHECKED -> active when @config.running
+        (if (< ?correctCount ?total)
+          (emit BURST { particles: [ (object/merge @config.progressCue { id: (str/concat "cue-" (+ @entity.cueSeq 1)) }) ] })
+          null)
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      GOAL_CHECKED -> active when @config.running
+        (if (not ?matched)
+          (emit BURST { particles: [ (object/merge @config.wrongCue { id: (str/concat "cue-" (+ @entity.cueSeq 1)) }) ] })
+          null)
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      LEARN_ROUND_COMPLETE -> active when @config.running
+        (emit BURST { particles: (array/map [ @config.celebrationCue ] (fn c { id: (str/concat "cue-" (+ @entity.cueSeq 1)), type: (object/get @c type), x: (object/get @c x), z: (object/get @c z), ttl: (object/get @c ttl), space: (object/get @c space), effect: (object/get @c effect), color: (object/get @c color), size: (object/get @c size), particleCount: (object/get @c particleCount), message: (object/get @c message) })) })
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+      TRACE_DONE -> active when @config.running
+        (emit BURST { particles: (array/map [ @config.celebrationCue ] (fn c { id: (str/concat "cue-" (+ @entity.cueSeq 1)), type: (object/get @c type), x: (object/get @c x), z: (object/get @c z), ttl: (object/get @c ttl), space: (object/get @c space), effect: (object/get @c effect), color: (object/get @c color), size: (object/get @c size), particleCount: (object/get @c particleCount), message: (object/get @c message) })) })
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+    }
+
+    listens {
+      ANSWER_JUDGED { correct : boolean, timeLeftTenths : number, score : number, streak : number }
+      TAP_JUDGED { correct : boolean, promptIndex : number, tries : number }
+      ESTIMATE_JUDGED { band : string, estimate : number, answer : number, score : number }
+      CLASSIFY_UPDATED { itemIndex : number, correctCount : number, attemptedCount : number, selectedCategory : string, verdict : string, roundComplete : boolean }
+      ARRANGEMENT_CHECKED { correctCount : number, total : number }
+      GOAL_CHECKED { matched : boolean, distance : number, attempts : number }
+      LEARN_ROUND_COMPLETE { score : number, total : number }
+      TRACE_DONE { totalFrames : number }
+    }
+
+    emits {
+      BURST -> external {
+        particles : [Fx]
+      }
+        @description "Spawned fx cues for a composed std-fx-particles sink (and the fx-overlay reading its entity list) — the same BURST channel the game mechanics use."
+        @synonyms "fx, cue, celebration, feedback burst, confetti, shake"
+        @tier "domain"
+    }
+
+    config {
+      running : boolean = true
+        @label "Running"
+        @description "When false every cue arm is inert — visual feedback fully disabled without unmounting."
+        @tier "domain"
+      streakThreshold : number = 3
+        @label "Streak Threshold"
+        @description "Minimum ANSWER_JUDGED streak that adds the streak cue on top of the correct cue."
+        @tier "domain"
+      correctCue : FxCue = { type: "correct", x: 0.5, z: 0.35, ttl: 1.5, space: "screen", effect: "sparkle", color: "#4ade80", particleCount: 10 }
+        @label "Correct Cue"
+        @description "Cue spawned on a correct judged answer."
+        @tier "presentation"
+      wrongCue : FxCue = { type: "wrong", x: 0.5, z: 0.35, ttl: 1, space: "screen", effect: "shake", color: "#fda4af" }
+        @label "Wrong Cue"
+        @description "Cue spawned on a wrong judged answer (and an unmatched goal check)."
+        @tier "presentation"
+      streakCue : FxCue = { type: "streak", x: 0.5, z: 0.2, ttl: 2.5, space: "screen", effect: "streak-glow", color: "#fbbf24" }
+        @label "Streak Cue"
+        @description "Extra cue layered on the correct cue once the streak reaches the threshold."
+        @tier "presentation"
+      celebrationCue : FxCue = { type: "celebration", x: 0.5, z: 0.45, ttl: 5, space: "screen", effect: "confetti", color: "#facc15", particleCount: 40 }
+        @label "Celebration Cue"
+        @description "Cue spawned when a round completes (LEARN_ROUND_COMPLETE / TRACE_DONE)."
+        @tier "presentation"
+      progressCue : FxCue = { type: "progress", x: 0.5, z: 0.35, ttl: 1.5, space: "screen", effect: "sparkle", color: "#a5b4fc", particleCount: 4 }
+        @label "Progress Cue"
+        @description "Cue spawned on a partial arrangement check (some but not all slots correct)."
+        @tier "presentation"
+      bandCues : [FxBandCue] = []
+        @label "Band Cues"
+        @description "Per-band cues for ESTIMATE_JUDGED — one row per error band (exact/close/off); bands with no row spawn nothing."
+        @tier "presentation"
+      verdictCues : [FxBandCue] = []
+        @label "Verdict Cues"
+        @description "Per-verdict cues for CLASSIFY_UPDATED — one row per verdict string; verdicts with no row spawn nothing."
+        @tier "presentation"
+    }
+  }
+
+  page "/learn-fx-cues" as LearnFxCuesPage -> LearnFxCues
+}

package/behaviors/lolo/ui/learning/atoms/std-learn-goal-seek.lolo

@@ -362,6 +362,7 @@ orbital GoalSeekOrbital {
           ]
         })
         (emit GOAL_CHECKED { matched: @entity.solved, distance: @entity.distance, attempts: @entity.attempts })
+        (if @entity.solved (emit LEARN_ROUND_COMPLETE { score: 1, total: 1 }) null)
 
       RESET -> idle when (== @entity.active true)
         (let (
@@ -478,6 +479,13 @@ orbital GoalSeekOrbital {
       }
         @description "The learner reset the instrument back to the default parameters."
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when a Check lands within tolerance (the goal is matched) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion, solved"
+        @tier "domain"
     }
 
     config {

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

@@ -207,6 +207,7 @@ orbital HotspotOrbital {
         (emit TAP_JUDGED { correct: @entity.found, promptIndex: @entity.promptIndex, tries: @entity.tries })
 
       NEXT -> idle when (and (== @entity.active true) (and (== @entity.found true) (== @entity.done false)))
+        (if (>= (+ @entity.promptIndex 1) (array/len @config.prompts)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @config.prompts) }) null)
         (let (
             (nextIndex (+ @entity.promptIndex 1))
             (finished (>= @nextIndex (array/len @config.prompts)))
@@ -343,6 +344,13 @@ orbital HotspotOrbital {
       }
         @description "The learner restarted the round from scratch."
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the round finishes (advancing past the final prompt) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion"
+        @tier "domain"
     }
 
     config {

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

@@ -174,6 +174,7 @@ orbital PredictOrbital {
         (emit PREDICTION_COMMITTED { scenarioIndex: @entity.scenarioIndex, chosenIndex: @entity.chosenIndex })
 
       NEXT -> idle when (and (== @entity.active true) (and (== @entity.phase "judged") (== @entity.done false)))
+        (if (>= (+ @entity.scenarioIndex 1) (array/len @config.scenarios)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @config.scenarios) }) null)
         (let (
             (nextIndex (+ @entity.scenarioIndex 1))
             (finished (>= @nextIndex (array/len @config.scenarios)))
@@ -341,6 +342,13 @@ orbital PredictOrbital {
       }
         @description "The learner restarted the round from scratch."
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the round finishes (advancing past the final scenario) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion"
+        @tier "domain"
     }
 
     config {

package/behaviors/lolo/ui/learning/atoms/std-learn-scatter-fit.lolo

@@ -211,6 +211,7 @@ orbital LearnScatterFitOrbital {
             (set @entity.curves (array/concat @baseCurves @residualCurves))
             (set @entity.done @nowDone)
             (set @entity.narration (str/concat @config.narrationAddedTemplate " " (str/concat "" @n) " — r = " (str/concat "" (math/round @newR 3)) ", R² = " (str/concat "" (math/round (* @newR @newR) 3)) (if @nowDone @config.narrationMaxReachedSuffix "")))
+            (if @nowDone (emit LEARN_ROUND_COMPLETE { score: @n, total: @config.maxPoints }) null)
           )
         )
         (render-ui main {
@@ -540,6 +541,7 @@ orbital LearnScatterFitOrbital {
             (set @entity.curves (array/concat @baseCurves @residualCurves))
             (set @entity.done @nowDone)
             (set @entity.narration (str/concat @config.narrationAddedTemplate " " (str/concat "" @n) " — r = " (str/concat "" (math/round @newR 3)) ", R² = " (str/concat "" (math/round (* @newR @newR) 3)) (if @nowDone @config.narrationMaxReachedSuffix "")))
+            (if @nowDone (emit LEARN_ROUND_COMPLETE { score: @n, total: @config.maxPoints }) null)
           )
         )
         (render-ui main {
@@ -600,6 +602,13 @@ orbital LearnScatterFitOrbital {
         @description "The least-squares fit and narration after each learner action, auto-add tick, or reset — a composed listener (readout, grader) can subscribe; a harmless no-op when the atom runs standalone."
         @synonyms "fit update, line of best fit, slope, intercept, correlation, r squared"
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the point that reaches maxPoints lands and the round latches done — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion, max points"
+        @tier "domain"
     }
 
     config {

package/behaviors/lolo/ui/learning/atoms/std-learn-speed-drill.lolo

@@ -144,6 +144,7 @@ orbital SpeedDrillOrbital {
         (emit ANSWER_JUDGED { correct: (== @entity.verdict "correct"), timeLeftTenths: @entity.remaining, score: @entity.score, streak: @entity.streak })
 
       NEXT -> idle when (and (== @entity.active true) (and (== @entity.running false) (and (!= @entity.verdict "") (== @entity.done false))))
+        (if (>= (+ @entity.itemIndex 1) (array/len @config.items)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @config.items) }) null)
         (let (
             (nextIndex (+ @entity.itemIndex 1))
             (finished (>= @nextIndex (array/len @config.items)))
@@ -292,6 +293,13 @@ orbital SpeedDrillOrbital {
       }
         @description "The learner restarted the round from scratch."
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the round finishes (advancing past the final prompt) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion"
+        @tier "domain"
     }
 
     config {

package/behaviors/lolo/ui/learning/atoms/std-learn-tour-3d.lolo

@@ -153,6 +153,7 @@ orbital LearnTour3DOrbital {
         (emit TOUR_3D_UPDATED { id: @entity.selectedId, name: (object/get (array/nth @entity.stations 0) name), caption: (object/get (array/nth @entity.stations 0) caption), visited: (array/len @entity.visitedIds), total: (array/len @entity.stations), tourComplete: false })
 
       TOUR -> idle when (== @entity.active true)
+        (if (and (not @entity.tourComplete) (== (if (array/includes @entity.visitedIds (object/get (array/nth @entity.stations (math/mod (+ @entity.selectedIndex 1) (array/len @entity.stations))) id)) (array/len @entity.visitedIds) (+ (array/len @entity.visitedIds) 1)) (array/len @entity.stations))) (emit LEARN_ROUND_COMPLETE { score: (array/len @entity.stations), total: (array/len @entity.stations) }) null)
         (set @entity.selectedIndex (math/mod (+ @entity.selectedIndex 1) (array/len @entity.stations)))
         (set @entity.selectedId (object/get (array/nth @entity.stations @entity.selectedIndex) id))
         (set @entity.visitedIds (if (array/includes @entity.visitedIds @entity.selectedId) @entity.visitedIds (array/append @entity.visitedIds @entity.selectedId)))
@@ -193,6 +194,7 @@ orbital LearnTour3DOrbital {
             (idx (if (>= @found 0) @found @entity.selectedIndex))
           )
           (do
+            (if (and (not @entity.tourComplete) (== (if (array/includes @entity.visitedIds (object/get (array/nth @entity.stations @idx) id)) (array/len @entity.visitedIds) (+ (array/len @entity.visitedIds) 1)) (array/len @entity.stations))) (emit LEARN_ROUND_COMPLETE { score: (array/len @entity.stations), total: (array/len @entity.stations) }) null)
             (set @entity.selectedIndex @idx)
             (set @entity.selectedId (object/get (array/nth @entity.stations @idx) id))
             (set @entity.visitedIds (if (array/includes @entity.visitedIds @entity.selectedId) @entity.visitedIds (array/append @entity.visitedIds @entity.selectedId)))
@@ -332,6 +334,13 @@ orbital LearnTour3DOrbital {
         @description "Fires on INIT/MODE_SELECTED/Tour/click/Reset with the currently selected station's id, name, and caption, plus visited/total progress and whether every station has now been visited — a composed listener (readout, quiz) can subscribe; a harmless no-op when the atom runs standalone."
         @synonyms "select, choose, station, explore, tour, flythrough, pick"
         @tier "domain"
+      LEARN_ROUND_COMPLETE -> external {
+        score : number
+        total : number
+      }
+        @description "Fired once when the visit that completes the tour lands (every station explored) — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides."
+        @synonyms "round complete, finished, done, completion, tour complete"
+        @tier "domain"
     }
 
     config {