@almadar/std 16.227.0 → 16.228.0

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

@@ -166,6 +166,14 @@ orbital MarketBoard3DOrbital {
         { id: "t-3-3", x: 3, y: 3, z: 0, terrain: "grass", passable: true, modelUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-tactics-demo-2d/default/terrain/grass/grass.png", role: "tile", category: "terrain", animations: ["static"], style: "vector", dimension: "2d", aspect: "1:1", name: "grass", thumbnailUrl: "" } }
       ]
     }
+
+    listens {
+      MOVE { unitId : string, x : number, y : number }
+      WANDER { tick : number }
+      RESTART { id : string }
+      MarketIntent.MOVE -> MOVE
+      MarketIntent.RESTART -> RESTART
+    }
   }
 
   trait Patience = Svc.traits.Patience -> GameState {
@@ -176,14 +184,35 @@ orbital MarketBoard3DOrbital {
         { id: "cust-1", position: { x: 2, y: 2 }, patience: 10, maxPatience: 10, unitType: "customer", name: "Customer", team: "customer", modelUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-tactics-demo-2d/default/units/soldier/soldier.png", role: "customer", category: "customer", animations: ["idle"], style: "vector", dimension: "2d", aspect: "1:1", name: "customer", thumbnailUrl: "" } }
       ]
     }
+
+    listens {
+      HERO_STEPPED { unitId : string, x : number, z : number, movesLeft : number }
+      RESTART { id : string }
+      HeroAuthority.HERO_STEPPED -> HERO_STEPPED
+      MarketIntent.RESTART -> RESTART
+    }
   }
 
   trait FxDecay = Particles.traits.FxParticles -> GameState {
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      MarketIntent.RESTART -> RESTART
+      Patience.BURST -> BURST
+    }
   }
 
   trait RoundGate = Flow.traits.MarketFlow -> GameState {
     config { running: true, targetServed: 10, maxLost: 3 }
+
+    listens {
+      SERVICE_CHANGED { served : number, pending : number, lost : number }
+      RESTART { id : string }
+      MarketIntent.RESTART -> RESTART
+      Patience.SERVICE_CHANGED -> SERVICE_CHANGED
+    }
   }
 
   trait MarketIntent -> GameState [interaction, instance] {

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

@@ -159,6 +159,15 @@ orbital ObjectiveBoard3DOrbital {
         { id: "t-3-3", x: 3, y: 3, z: 0, terrain: "grass", passable: true, modelUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-tactics-demo-2d/default/terrain/grass/grass.png", role: "tile", category: "terrain", animations: ["static"], style: "vector", variant: "", dimension: "2d", aspect: "1:1", name: "grass", thumbnailUrl: "" } }
       ]
     }
+
+    listens {
+      MOVE { unitId : string, x : number, y : number }
+      WANDER { tick : number }
+      RESTART { id : string }
+      HeroIntent.MOVE -> MOVE
+      HeroIntent.RESTART -> RESTART
+      HeroIntent.WANDER -> WANDER
+    }
   }
 
   trait Collector = Objective.traits.ObjectiveReach -> GameState {
@@ -168,14 +177,35 @@ orbital ObjectiveBoard3DOrbital {
       pointsPerTarget: 1
       removeOnReach: true
     }
+
+    listens {
+      HERO_STEPPED { unitId : string, x : number, z : number, movesLeft : number }
+      RESTART { id : string }
+      HeroAuthority.HERO_STEPPED -> HERO_STEPPED
+      HeroIntent.RESTART -> RESTART
+    }
   }
 
   trait FxDecay = Particles.traits.FxParticles -> GameState {
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      Collector.BURST -> BURST
+      HeroIntent.RESTART -> RESTART
+    }
   }
 
   trait RoundGate = Gate.traits.ObjectiveFlow -> GameState {
     config { running: true }
+
+    listens {
+      PROGRESS { objectivesLeft : number, movesLeft : number }
+      RESTART { id : string }
+      Collector.PROGRESS -> PROGRESS
+      HeroIntent.RESTART -> RESTART
+    }
   }
 
   trait HeroIntent -> GameState [interaction, instance] {

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

@@ -134,14 +134,46 @@ orbital PlatformerBoard2DOrbital {
       xMax: 768
       killY: 460
     }
+
+    listens {
+      STEER { dir : number! }
+      JUMP { id : string }
+      PLACE { x : number!, y : number! }
+      CURVE_MOD_ADD { x0 : number!, x1 : number!, a : number!, b : number, h : number!, k : number! }
+      CURVE_MOD_CLEAR { }
+      CURVE_MOD_CLEAR_RANGE { x0 : number!, x1 : number! }
+      SET_TUNING { jumpStrength : number, moveSpeed : number, gravity : number }
+      SET_PLATFORMS { platforms : [PlatformerPlatform]! }
+      SET_SKATE_CURVE { curve : [PlatformerCurveSample]! }
+      SET_DRIFT_REGIONS { regions : [BodyDriftRegion]! }
+      RESTART { id : string }
+      PlatformerIntent.PLAT_JUMP -> PLAT_JUMP
+      PlatformerIntent.PLAT_PLACE -> PLAT_PLACE
+      PlatformerIntent.PLAT_STEER -> PLAT_STEER
+      PlatformerIntent.RESTART -> RESTART
+    }
   }
 
   trait FxDecay = Particles.traits.FxParticles -> GameState {
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      PlatformerIntent.BURST -> BURST
+      PlatformerIntent.RESTART -> RESTART
+    }
   }
 
   trait RoundGate = Gate.traits.ObjectiveFlow -> GameState {
     config { running: true }
+
+    listens {
+      PROGRESS { objectivesLeft : number, movesLeft : number }
+      RESTART { id : string }
+      PlatformerIntent.PROGRESS -> PROGRESS
+      PlatformerIntent.RESTART -> RESTART
+    }
   }
 
   trait PlatformerIntent -> GameState [interaction, instance] {
@@ -394,6 +426,13 @@ orbital PlatformerBoard2DOrbital {
         @description "D-pad direction icon sprites"
         @tier "presentation"
     }
+
+    listens {
+      BodyAuthority.PLAT_FELL -> PLAT_FELL
+      BodyAuthority.PLAT_GOAL -> PLAT_GOAL
+      BodyAuthority.PLAT_HAZARD -> PLAT_HAZARD
+      RoundGate.GAME_END -> GAME_END
+    }
   }
 
   page "/platformer-board-2d" as PlatformerBoard2DPage -> BodyAuthority, FxDecay, RoundGate, PlatformerIntent

package/behaviors/lolo/ui/game/organisms/std-platformer-puzzle.lolo

@@ -206,6 +206,15 @@ orbital PlatformerPuzzleOrbital {
       BODY_MOVED: BODY_MOVED
     }
     config { running: true }
+
+    listens {
+      BODY_MOVED { x : number!, y : number!, vx : number!, vy : number!, grounded : boolean!, skating : boolean!, speed : number! }
+      SET_FEATURES { features : [PickupFeature]! }
+      ADD_FEATURES { features : [PickupFeature]! }
+      FEATURES_ACTIVE { updates : [PickupActiveUpdate]! }
+      RESTART { id : string }
+      PlatformerPuzzleBody.BODY_MOVED -> BODY_MOVED
+    }
   }
 
   trait PlatformerPuzzleObjective = Gate.traits.ObjectiveFlow -> PlatformerPuzzleData {
@@ -221,6 +230,13 @@ orbital PlatformerPuzzleOrbital {
       BODY_MOVED: BODY_MOVED
     }
     config { running: true }
+
+    listens {
+      BODY_MOVED { x : number!, y : number!, vx : number!, vy : number!, grounded : boolean!, skating : boolean!, speed : number! }
+      SET_GATES { gates : [ChoiceGate]! }
+      RESTART { id : string }
+      PlatformerPuzzleBody.BODY_MOVED -> BODY_MOVED
+    }
   }
 
   trait PlatformerPuzzleFx = Particles.traits.FxParticles -> PlatformerPuzzleData {
@@ -228,6 +244,12 @@ orbital PlatformerPuzzleOrbital {
       BURST: BURST
     }
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      PlatformerPuzzleNarrative.BURST -> BURST
+    }
   }
 
   trait PlatformerPuzzleNarrative = Narrative.traits.FxNarrative -> PlatformerPuzzleData {
@@ -244,6 +266,11 @@ orbital PlatformerPuzzleOrbital {
       TUTORIAL_DONE: TUTORIAL_DONE
     }
     config { autoShow: false, previewTrait: @trait.PlatformerPuzzleNoopPreview }
+
+    listens {
+      SHOW { id : string }
+      PlatformerPuzzleNarrative.SHOW -> SHOW
+    }
   }
 
   trait PlatformerPuzzleNoopPreview -> PlatformerPuzzleData [interaction, instance] {

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

@@ -134,6 +134,15 @@ orbital SurvivalBoard3DOrbital {
         { id: "t-1-1", x: 1, y: 1, z: 0, terrain: "grass", passable: true, modelUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-tactics-demo-2d/default/terrain/grass/grass.png", role: "tile", category: "terrain", animations: ["static"], style: "vector", variant: "", dimension: "2d", aspect: "1:1", name: "grass", thumbnailUrl: "" } }
       ]
     }
+
+    listens {
+      MOVE { unitId : string, x : number, y : number }
+      WANDER { tick : number }
+      RESTART { id : string }
+      SurvivalIntent.MOVE -> MOVE
+      SurvivalIntent.RESTART -> RESTART
+      SurvivalIntent.WANDER -> WANDER
+    }
   }
 
   trait Gather = Harvest.traits.Gather -> GameState {
@@ -143,14 +152,37 @@ orbital SurvivalBoard3DOrbital {
       stoneType: "rock"
       yieldPerNode: 1
     }
+
+    listens {
+      HERO_STEPPED { unitId : string, x : number, z : number, movesLeft : number }
+      RESTART { id : string }
+      HeroAuthority.HERO_STEPPED -> HERO_STEPPED
+      SurvivalIntent.RESTART -> RESTART
+    }
   }
 
   trait FxDecay = Particles.traits.FxParticles -> GameState {
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      Gather.BURST -> BURST
+      SurvivalIntent.RESTART -> RESTART
+    }
   }
 
   trait Flow = Survival.traits.SurvivalFlow -> GameState {
     config { running: true }
+
+    listens {
+      RESOURCES { wood : number, stone : number, movesLeft : number }
+      BUILD_CAMP { id : string }
+      RESTART { id : string }
+      Gather.RESOURCES -> RESOURCES
+      SurvivalIntent.BUILD_CAMP -> BUILD_CAMP
+      SurvivalIntent.RESTART -> RESTART
+    }
   }
 
   trait SurvivalIntent -> GameState [interaction, instance] {
@@ -163,7 +195,7 @@ orbital SurvivalBoard3DOrbital {
         (set @entity.phase "observation")
         (render-ui main {
           type: game-shell
-          hud: { type: stack, direction: horizontal, gap: md, justify: between, children: [ { type: game-hud, stats: (array/concat [ { label: "Wood", value: @entity.wood }, { label: "Stone", value: @entity.stone }, { label: "Energy", value: @entity.movesLeft }, { label: "Result", value: @entity.result } ] @config.extraStats) }, { type: button, action: BUILD_CAMP, label: "Build Camp", variant: primary } ] }
+          hud: { type: stack, direction: horizontal, gap: md, justify: between, children: [ { type: game-hud, stats: (array/concat [ { label: "Wood", value: @entity.wood }, { label: "Stone", value: @entity.stone }, { label: "Energy", value: @entity.movesLeft }, { label: "Result", value: @entity.result } ] @config.extraStats) }, { type: button, action: BUILD_CAMP_PRESS, label: "Build Camp", variant: primary } ] }
           addons: { type: stack, direction: vertical, gap: sm, children: [ { type: button, action: CANCEL, label: "Cancel", variant: secondary }, { type: button, action: PLAY_AGAIN, label: "Restart", variant: secondary } ] }
           overlay: (if (!= @entity.result "none") { type: stack, direction: vertical, gap: md, align: center, children: [ { type: game-hud, stats: [ { label: "Result", value: @entity.result } ] }, { type: button, action: PLAY_AGAIN, label: "Play Again", variant: primary } ] } null)
           children: [ { type: canvas, mode: "3d", camera: { mode: @config.cameraMode, zoom: @config.scale }, tileClickEvent: TILE_CLICK, unitClickEvent: UNIT_CLICK, unitScale: @config.unitScale, backgroundColor: @config.bgColor, children: [
@@ -195,7 +227,7 @@ orbital SurvivalBoard3DOrbital {
         (set @entity.validMoves [])
         (set @entity.phase "observation")
 
-      BUILD_CAMP -> playing when (and (== @entity.result "none") (and (>= @entity.wood @config.campWood) (>= @entity.stone @config.campStone)))
+      BUILD_CAMP_PRESS -> playing when (and (== @entity.result "none") (and (>= @entity.wood @config.campWood) (>= @entity.stone @config.campStone)))
         (emit BUILD_CAMP { id: "board" })
 
       PLAY_AGAIN -> playing
@@ -209,7 +241,7 @@ orbital SurvivalBoard3DOrbital {
       renderTick every 100ms
         (render-ui main {
           type: game-shell
-          hud: { type: stack, direction: horizontal, gap: md, justify: between, children: [ { type: game-hud, stats: (array/concat [ { label: "Wood", value: @entity.wood }, { label: "Stone", value: @entity.stone }, { label: "Energy", value: @entity.movesLeft }, { label: "Result", value: @entity.result } ] @config.extraStats) }, { type: button, action: BUILD_CAMP, label: "Build Camp", variant: primary } ] }
+          hud: { type: stack, direction: horizontal, gap: md, justify: between, children: [ { type: game-hud, stats: (array/concat [ { label: "Wood", value: @entity.wood }, { label: "Stone", value: @entity.stone }, { label: "Energy", value: @entity.movesLeft }, { label: "Result", value: @entity.result } ] @config.extraStats) }, { type: button, action: BUILD_CAMP_PRESS, label: "Build Camp", variant: primary } ] }
           addons: { type: stack, direction: vertical, gap: sm, children: [ { type: button, action: CANCEL, label: "Cancel", variant: secondary }, { type: button, action: PLAY_AGAIN, label: "Restart", variant: secondary } ] }
           overlay: (if (!= @entity.result "none") { type: stack, direction: vertical, gap: md, align: center, children: [ { type: game-hud, stats: [ { label: "Result", value: @entity.result } ] }, { type: button, action: PLAY_AGAIN, label: "Play Again", variant: primary } ] } null)
           children: [ { type: canvas, mode: "3d", camera: { mode: @config.cameraMode, zoom: @config.scale }, tileClickEvent: TILE_CLICK, unitClickEvent: UNIT_CLICK, unitScale: @config.unitScale, backgroundColor: @config.bgColor, children: [
@@ -266,6 +298,11 @@ orbital SurvivalBoard3DOrbital {
       }
         @description "Clears the current selection"
         @tier "domain"
+      BUILD_CAMP_PRESS -> external {
+        id : string
+      }
+        @description "Build Camp button pressed"
+        @tier "domain"
       BUILD_CAMP -> external {
         id : string
       }

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

@@ -158,18 +158,45 @@ orbital TacticsBoard2DOrbital {
         { id: "t-1-1", x: 1, y: 1, z: 0, terrain: "grass", passable: true, terrainSprite: { url: "https://almadar-kflow-assets.web.app/shared/ui-tactics-demo-2d/default/terrain/grass/grass.png", role: "tile", category: "terrain", animations: ["static"], style: "vector", dimension: "2d", aspect: "1:1", name: "grass", thumbnailUrl: "" } }
       ]
     }
+
+    listens {
+      PlayerIntent.ATTACK -> ATTACK
+      PlayerIntent.MOVE -> MOVE
+      MOVE { unitId : string, x : number, y : number }
+      ATTACK { targetId : string }
+      AI_TURN { turn : number }
+      SPAWN { id : string, x : number, y : number, team : string, health : number, maxHealth : number, unitType : string }
+      HEAL { team : string, amount : number }
+      PlayerIntent.AI_TURN -> AI_TURN
+    }
   }
 
   trait FxDecay = Particles.traits.FxParticles -> GameState {
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      TacticsAuthority.BURST -> BURST
+    }
   }
 
   trait RoundLogic = Round.traits.RoundFlow -> GameState {
     config { running: true }
+
+    listens {
+      UNITS_CHANGED { playersAlive : number, enemiesAlive : number }
+      TacticsAuthority.UNITS_CHANGED -> UNITS_CHANGED
+    }
   }
 
   trait ScoreKeeper = Score.traits.ScoreKeeper -> GameState {
     config { running: true, pointsPerKill: 10, startScore: 0, initialEnemies: 0 }
+
+    listens {
+      UNITS_CHANGED { playersAlive : number, enemiesAlive : number }
+      TacticsAuthority.UNITS_CHANGED -> UNITS_CHANGED
+    }
   }
 
   trait AnimClock = AnimTick.traits.AnimTick -> GameState {

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

@@ -164,14 +164,36 @@ orbital TacticsBoard3DOrbital {
         { id: "t-1-1", x: 1, y: 1, z: 0, terrain: "grass", passable: true, modelUrl: { url: "https://almadar-kflow-assets.web.app/shared/ui-tactics-demo-2d/default/terrain/grass/grass.png", role: "tile", category: "terrain", animations: ["static"], style: "vector", dimension: "2d", aspect: "1:1", name: "grass", thumbnailUrl: "" } }
       ]
     }
+
+    listens {
+      MOVE { unitId : string, x : number, y : number }
+      ATTACK { targetId : string }
+      AI_TURN { turn : number }
+      SPAWN { id : string, x : number, y : number, team : string, health : number, maxHealth : number, unitType : string }
+      HEAL { team : string, amount : number }
+      PlayerIntent.AI_TURN -> AI_TURN
+      PlayerIntent.ATTACK -> ATTACK
+      PlayerIntent.MOVE -> MOVE
+    }
   }
 
   trait FxDecay = Particles.traits.FxParticles -> GameState {
     config { running: true }
+
+    listens {
+      BURST { particles : [Fx] }
+      RESTART { }
+      TacticsAuthority.BURST -> BURST
+    }
   }
 
   trait RoundLogic = Round.traits.RoundFlow -> GameState {
     config { running: true }
+
+    listens {
+      UNITS_CHANGED { playersAlive : number, enemiesAlive : number }
+      TacticsAuthority.UNITS_CHANGED -> UNITS_CHANGED
+    }
   }
 
   trait VolumetricArt = MeshArt.traits.MeshAssetArtCollector -> GameState { }

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

@@ -119,14 +119,35 @@ orbital WorldMapBoard2DOrbital {
       ]
       tiles: []
     }
+
+    listens {
+      MOVE { unitId : string, x : number, y : number }
+      ATTACK { targetId : string }
+      AI_TURN { turn : number }
+      SPAWN { id : string, x : number, y : number, team : string, health : number, maxHealth : number, unitType : string }
+      HEAL { team : string, amount : number }
+      WorldMapIntent.ATTACK -> ATTACK
+      WorldMapIntent.MOVE -> MOVE
+    }
   }
 
   trait RoundLogic = Round.traits.RoundFlow -> GameState {
     config { running: true }
+
+    listens {
+      UNITS_CHANGED { playersAlive : number, enemiesAlive : number }
+      TacticsAuthority.UNITS_CHANGED -> UNITS_CHANGED
+    }
   }
 
   trait GoldAuthority = Gold.traits.GoldMine -> GameState {
     config { running: true, startGold: 0, yieldAmount: 25 }
+
+    listens {
+      MINE_HIT { id : string }
+      RESTART { id : string }
+      WorldMapIntent.MINE_HIT -> MINE_HIT
+    }
   }
 
   trait WorldMapIntent -> GameState [interaction, instance] {

package/behaviors/lolo/ui/learning/atoms/ui-algo-graph-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-algo-graph-canvas "1.0.0"
 "AlgoGraphCanvas — UI factory (1:1 with the @almadar/ui algo-graph-canvas pattern)."
+;; @pattern "algo-graph-canvas"
 orbital AlgoGraphCanvasOrbital {
   type AlgoGraphCanvasNodesItem = {
     id : string!

package/behaviors/lolo/ui/learning/atoms/ui-algorithm-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-algorithm-canvas "1.0.0"
 "AlgorithmCanvas — UI factory (1:1 with the @almadar/ui algorithm-canvas pattern)."
+;; @pattern "algorithm-canvas"
 orbital AlgorithmCanvasOrbital {
   type AlgorithmCanvasBarsItem = {
     value : number!

package/behaviors/lolo/ui/learning/atoms/ui-biology-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-biology-canvas "1.0.0"
 "BiologyCanvas — UI factory (1:1 with the @almadar/ui biology-canvas pattern)."
+;; @pattern "biology-canvas"
 orbital BiologyCanvasOrbital {
   type BiologyCanvasCamera = {
     pos : BiologyCanvasCameraPos

package/behaviors/lolo/ui/learning/atoms/ui-chemistry-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-chemistry-canvas "1.0.0"
 "ChemistryCanvas — UI factory (1:1 with the @almadar/ui chemistry-canvas pattern)."
+;; @pattern "chemistry-canvas"
 orbital ChemistryCanvasOrbital {
   type ChemistryCanvasCamera = {
     pos : ChemistryCanvasCameraPos

package/behaviors/lolo/ui/learning/atoms/ui-learning-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-learning-canvas "1.0.0"
 "LearningCanvas — UI factory (1:1 with the @almadar/ui learning-canvas pattern)."
+;; @pattern "learning-canvas"
 orbital LearningCanvasOrbital {
   type LearningCanvasShapesItem = {
     type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!

package/behaviors/lolo/ui/learning/atoms/ui-math-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-math-canvas "1.0.0"
 "MathCanvas — UI factory (1:1 with the @almadar/ui math-canvas pattern)."
+;; @pattern "math-canvas"
 orbital MathCanvasOrbital {
   type MathCanvasCurvesItem = {
     label : string

package/behaviors/lolo/ui/learning/atoms/ui-physics-canvas.lolo

@@ -1,5 +1,6 @@
 app ui-physics-canvas "1.0.0"
 "PhysicsCanvas — UI factory (1:1 with the @almadar/ui physics-canvas pattern)."
+;; @pattern "physics-canvas"
 orbital PhysicsCanvasOrbital {
   type PhysicsCanvasCamera = {
     pos : PhysicsCanvasCameraPos

package/behaviors/lolo/ui/marketing/atoms/std-marketing-cta.lolo

@@ -21,9 +21,9 @@ orbital CTAItemOrbital {
           title: @config.title
           type: cta-banner
         })
-      CTA_PRIMARY -> idle
+      PRIMARY_ACTION -> idle
         (emit CTA_PRIMARY { href: @config.primaryActionHref })
-      CTA_SECONDARY -> idle
+      SECONDARY_ACTION -> idle
         (emit CTA_SECONDARY { href: @config.secondaryActionHref })
     }
 
@@ -43,13 +43,13 @@ orbital CTAItemOrbital {
     }
 
     listens {
-      CTA_PRIMARY {
+      PRIMARY_ACTION {
         href : string
       }
         @description "Primary action button was clicked."
         @synonyms "click, select, submit, activate"
         @tier "domain"
-      CTA_SECONDARY {
+      SECONDARY_ACTION {
         href : string
       }
         @description "A secondary action button was clicked."

package/behaviors/lolo/ui/marketing/atoms/std-marketing-hero.lolo

@@ -29,9 +29,9 @@ orbital HeroItemOrbital {
           type: hero-section
           className: @config.className
         })
-      CTA_PRIMARY -> idle
+      PRIMARY_ACTION -> idle
         (emit CTA_PRIMARY { href: @config.primaryActionHref })
-      CTA_SECONDARY -> idle
+      SECONDARY_ACTION -> idle
         (emit CTA_SECONDARY { href: @config.secondaryActionHref })
     }
 
@@ -51,13 +51,13 @@ orbital HeroItemOrbital {
     }
 
     listens {
-      CTA_PRIMARY {
+      PRIMARY_ACTION {
         href : string
       }
         @description "A primary call to action has been triggered."
         @synonyms "click, select, submit, activate"
         @tier "domain"
-      CTA_SECONDARY {
+      SECONDARY_ACTION {
         href : string
       }
         @description "A secondary call to action has been triggered."

package/behaviors/lolo/ui/marketing/atoms/ui-animated-counter.lolo

@@ -1,5 +1,6 @@
 app ui-animated-counter "1.0.0"
 "AnimatedCounter — UI factory (1:1 with the @almadar/ui animated-counter pattern)."
+;; @pattern "animated-counter"
 orbital AnimatedCounterOrbital {
   entity AnimatedCounterItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-animated-graphic.lolo

@@ -1,5 +1,6 @@
 app ui-animated-graphic "1.0.0"
 "AnimatedGraphic — UI factory (1:1 with the @almadar/ui animated-graphic pattern)."
+;; @pattern "animated-graphic"
 orbital AnimatedGraphicOrbital {
   entity AnimatedGraphicItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-animated-reveal.lolo

@@ -1,5 +1,6 @@
 app ui-animated-reveal "1.0.0"
 "AnimatedReveal — UI factory (1:1 with the @almadar/ui animated-reveal pattern)."
+;; @pattern "animated-reveal"
 orbital AnimatedRevealOrbital {
   entity AnimatedRevealItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-article-section.lolo

@@ -1,5 +1,6 @@
 app ui-article-section "1.0.0"
 "ArticleSection — UI factory (1:1 with the @almadar/ui article-section pattern)."
+;; @pattern "article-section"
 orbital ArticleSectionOrbital {
   entity ArticleSectionItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-case-study-card.lolo

@@ -1,6 +1,7 @@
 app ui-case-study-card "1.0.0"
 "CaseStudyCard — a card summarizing a customer case study with logo, headline result, and link. — UI factory (1:1 with the @almadar/ui case-study-card pattern)."
 ;; @capabilities "customer story, success story, client story card, results showcase, proof-point card"
+;; @pattern "case-study-card"
 orbital CaseStudyCardOrbital {
   entity CaseStudyCardItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-community-links.lolo

@@ -1,5 +1,6 @@
 app ui-community-links "1.0.0"
 "CommunityLinks — UI factory (1:1 with the @almadar/ui community-links pattern)."
+;; @pattern "community-links"
 orbital CommunityLinksOrbital {
   type CommunityLinksGithub = {
     url : string!

package/behaviors/lolo/ui/marketing/atoms/ui-content-section.lolo

@@ -1,5 +1,6 @@
 app ui-content-section "1.0.0"
 "ContentSection — UI factory (1:1 with the @almadar/ui content-section pattern)."
+;; @pattern "content-section"
 orbital ContentSectionOrbital {
   entity ContentSectionItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-cta-banner.lolo

@@ -1,5 +1,6 @@
 app ui-cta-banner "1.0.0"
 "CtaBanner — UI factory (1:1 with the @almadar/ui cta-banner pattern)."
+;; @pattern "cta-banner"
 orbital CtaBannerOrbital {
   type CtaBannerPrimaryAction = {
     label : string!

package/behaviors/lolo/ui/marketing/atoms/ui-feature-card.lolo

@@ -1,6 +1,7 @@
 app ui-feature-card "1.0.0"
 "FeatureCard — an icon-led card pairing a title and description to call out a single product feature. — UI factory (1:1 with the @almadar/ui feature-card pattern)."
 ;; @capabilities "feature highlight, benefit callout, product capability card, feature-grid tile"
+;; @pattern "feature-card"
 orbital FeatureCardOrbital {
   entity FeatureCardItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-geometric-pattern.lolo

@@ -1,5 +1,6 @@
 app ui-geometric-pattern "1.0.0"
 "GeometricPattern — UI factory (1:1 with the @almadar/ui geometric-pattern pattern)."
+;; @pattern "geometric-pattern"
 orbital GeometricPatternOrbital {
   entity GeometricPatternItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-hero-section.lolo

@@ -1,5 +1,6 @@
 app ui-hero-section "1.0.0"
 "HeroSection — UI factory (1:1 with the @almadar/ui hero-section pattern)."
+;; @pattern "hero-section"
 orbital HeroSectionOrbital {
   type HeroSectionPrimaryAction = {
     label : string!

package/behaviors/lolo/ui/marketing/atoms/ui-install-box.lolo

@@ -1,5 +1,6 @@
 app ui-install-box "1.0.0"
 "InstallBox — UI factory (1:1 with the @almadar/ui install-box pattern)."
+;; @pattern "install-box"
 orbital InstallBoxOrbital {
   entity InstallBoxItem [runtime] {
     id : string!

package/behaviors/lolo/ui/marketing/atoms/ui-marketing-footer.lolo

@@ -1,5 +1,6 @@
 app ui-marketing-footer "1.0.0"
 "MarketingFooter — UI factory (1:1 with the @almadar/ui marketing-footer pattern)."
+;; @pattern "marketing-footer"
 orbital MarketingFooterOrbital {
   type MarketingFooterColumnsItem = {
     title : string!