@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/molecules/std-turn-based-battle.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-turn-based-battle",
   "version": "1.0.0",
-  "description": "Turn-based strategy game molecule (Fire Emblem, XCOM style). Composes game atoms into a two-trait orbital:",
+  "description": "std-turn-based-battle as a Function",
   "orbitals": [
     {
       "name": "BattleUnitOrbital",
@@ -38,46 +38,68 @@
           {
             "name": "turn",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "score",
             "type": "number",
-            "default": 0
-          }
-        ],
-        "instances": [
-          {
-            "id": "unit-1",
-            "name": "Knight",
-            "description": "Armored warrior",
-            "status": "active",
-            "turn": 0,
-            "score": 0
-          },
-          {
-            "id": "unit-2",
-            "name": "Archer",
-            "description": "Ranged attacker",
-            "status": "active",
-            "turn": 0,
-            "score": 0
-          },
-          {
-            "id": "unit-3",
-            "name": "Mage",
-            "description": "Magic caster",
-            "status": "active",
-            "turn": 0,
-            "score": 0
+            "default": 0.0
           }
         ]
       },
       "traits": [
         {
           "name": "BattleUnitBattleFlow",
-          "linkedEntity": "BattleUnit",
           "category": "interaction",
+          "linkedEntity": "BattleUnit",
+          "emits": [
+            {
+              "event": "BattleUnitLoaded",
+              "description": "Fired when BattleUnit finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "turn",
+                  "type": "number"
+                },
+                {
+                  "name": "score",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "BattleUnitLoadFailed",
+              "description": "Fired when BattleUnit fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -101,7 +123,11 @@
               },
               {
                 "key": "START",
-                "name": "Start Battle"
+                "name": "Start"
+              },
+              {
+                "key": "NAVIGATE",
+                "name": "Navigate"
               },
               {
                 "key": "END_TURN",
@@ -111,25 +137,35 @@
                 "key": "PAUSE",
                 "name": "Pause"
               },
+              {
+                "key": "GAME_OVER",
+                "name": "Game Over"
+              },
               {
                 "key": "RESUME",
                 "name": "Resume"
               },
               {
-                "key": "GAME_OVER",
-                "name": "Game Over"
+                "key": "CLOSE",
+                "name": "Close"
               },
               {
                 "key": "RESTART",
                 "name": "Restart"
               },
               {
-                "key": "CLOSE",
-                "name": "Close"
+                "key": "BattleUnitLoaded",
+                "name": "BattleUnit loaded"
               },
               {
-                "key": "NAVIGATE",
-                "name": "Navigate"
+                "key": "BattleUnitLoadFailed",
+                "name": "BattleUnit load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -140,22 +176,28 @@
                 "effects": [
                   [
                     "fetch",
-                    "BattleUnit"
+                    "BattleUnit",
+                    {
+                      "emit": {
+                        "failure": "BattleUnitLoadFailed",
+                        "success": "BattleUnitLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-menu",
-                      "title": "Battle Arena",
-                      "subtitle": "Turn-Based Strategy",
                       "menuItems": [
                         {
                           "label": "Start Battle",
                           "event": "START",
                           "variant": "primary"
                         }
-                      ]
+                      ],
+                      "title": "Battle Arena",
+                      "subtitle": "Turn-Based Strategy",
+                      "type": "game-menu"
                     }
                   ]
                 ]
@@ -169,21 +211,26 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-hud",
                       "stats": [
                         {
                           "label": "Turn",
                           "value": "@entity.turn"
                         },
                         {
-                          "label": "Score",
-                          "value": "@entity.score"
+                          "value": "@entity.score",
+                          "label": "Score"
                         }
-                      ]
+                      ],
+                      "type": "game-hud"
                     }
                   ]
                 ]
               },
+              {
+                "from": "menu",
+                "to": "menu",
+                "event": "NAVIGATE"
+              },
               {
                 "from": "playing",
                 "to": "playing",
@@ -195,7 +242,7 @@
                     [
                       "+",
                       "@entity.turn",
-                      1
+                      1.0
                     ]
                   ],
                   [
@@ -205,8 +252,8 @@
                       "type": "game-hud",
                       "stats": [
                         {
-                          "label": "Turn",
-                          "value": "@entity.turn"
+                          "value": "@entity.turn",
+                          "label": "Turn"
                         },
                         {
                           "label": "Score",
@@ -217,18 +264,6 @@
                   ]
                 ]
               },
-              {
-                "from": "menu",
-                "to": "menu",
-                "event": "NAVIGATE",
-                "effects": []
-              },
-              {
-                "from": "paused",
-                "to": "paused",
-                "event": "NAVIGATE",
-                "effects": []
-              },
               {
                 "from": "playing",
                 "to": "paused",
@@ -238,57 +273,70 @@
                     "render-ui",
                     "modal",
                     {
-                      "type": "game-menu",
-                      "title": "Paused",
                       "menuItems": [
                         {
-                          "label": "Resume",
                           "event": "RESUME",
-                          "variant": "primary"
+                          "variant": "primary",
+                          "label": "Resume"
                         },
                         {
-                          "label": "Quit",
                           "event": "RESTART",
-                          "variant": "ghost"
+                          "variant": "ghost",
+                          "label": "Quit"
                         }
-                      ]
+                      ],
+                      "type": "game-menu",
+                      "title": "Paused"
                     }
                   ]
                 ]
               },
               {
-                "from": "paused",
-                "to": "playing",
-                "event": "RESUME",
+                "from": "playing",
+                "to": "gameover",
+                "event": "GAME_OVER",
                 "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-hud",
+                      "title": "Battle Over",
+                      "type": "game-over-screen",
                       "stats": [
                         {
-                          "label": "Turn",
+                          "label": "Turns",
                           "value": "@entity.turn"
                         },
                         {
-                          "label": "Score",
-                          "value": "@entity.score"
+                          "value": "@entity.score",
+                          "label": "Score"
+                        }
+                      ],
+                      "menuItems": [
+                        {
+                          "label": "Play Again",
+                          "variant": "primary",
+                          "event": "RESTART"
+                        },
+                        {
+                          "event": "RESTART",
+                          "variant": "secondary",
+                          "label": "Main Menu"
                         }
                       ]
                     }
                   ]
                 ]
               },
+              {
+                "from": "paused",
+                "to": "paused",
+                "event": "NAVIGATE"
+              },
               {
                 "from": "paused",
                 "to": "playing",
-                "event": "CLOSE",
+                "event": "RESUME",
                 "effects": [
                   [
                     "render-ui",
@@ -299,52 +347,44 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-hud",
                       "stats": [
                         {
-                          "label": "Turn",
-                          "value": "@entity.turn"
+                          "value": "@entity.turn",
+                          "label": "Turn"
                         },
                         {
                           "label": "Score",
                           "value": "@entity.score"
                         }
-                      ]
+                      ],
+                      "type": "game-hud"
                     }
                   ]
                 ]
               },
               {
-                "from": "playing",
-                "to": "gameover",
-                "event": "GAME_OVER",
+                "from": "paused",
+                "to": "playing",
+                "event": "CLOSE",
                 "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-over-screen",
-                      "title": "Battle Over",
+                      "type": "game-hud",
                       "stats": [
                         {
-                          "label": "Turns",
-                          "value": "@entity.turn"
+                          "value": "@entity.turn",
+                          "label": "Turn"
                         },
                         {
-                          "label": "Score",
-                          "value": "@entity.score"
-                        }
-                      ],
-                      "menuItems": [
-                        {
-                          "label": "Play Again",
-                          "event": "RESTART",
-                          "variant": "primary"
-                        },
-                        {
-                          "label": "Main Menu",
-                          "event": "RESTART",
-                          "variant": "secondary"
+                          "value": "@entity.score",
+                          "label": "Score"
                         }
                       ]
                     }
@@ -352,63 +392,112 @@
                 ]
               },
               {
-                "from": "gameover",
+                "from": "paused",
                 "to": "menu",
                 "event": "RESTART",
                 "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-menu",
-                      "title": "Battle Arena",
-                      "subtitle": "Turn-Based Strategy",
                       "menuItems": [
                         {
-                          "label": "Start Battle",
                           "event": "START",
-                          "variant": "primary"
+                          "variant": "primary",
+                          "label": "Start Battle"
                         }
-                      ]
+                      ],
+                      "title": "Battle Arena",
+                      "subtitle": "Turn-Based Strategy"
                     }
                   ]
                 ]
               },
               {
-                "from": "paused",
+                "from": "gameover",
                 "to": "menu",
                 "event": "RESTART",
                 "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-menu",
-                      "title": "Battle Arena",
                       "subtitle": "Turn-Based Strategy",
                       "menuItems": [
                         {
-                          "label": "Start Battle",
+                          "variant": "primary",
                           "event": "START",
-                          "variant": "primary"
+                          "label": "Start Battle"
                         }
-                      ]
+                      ],
+                      "type": "game-menu",
+                      "title": "Battle Arena"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "BattleUnitCombatLog",
-          "linkedEntity": "BattleUnit",
           "category": "interaction",
+          "linkedEntity": "BattleUnit",
+          "emits": [
+            {
+              "event": "BattleUnitLoaded",
+              "description": "Fired when BattleUnit finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "turn",
+                  "type": "number"
+                },
+                {
+                  "name": "score",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "BattleUnitLoadFailed",
+              "description": "Fired when BattleUnit fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -435,6 +524,20 @@
               {
                 "key": "CLEAR",
                 "name": "Clear"
+              },
+              {
+                "key": "BattleUnitLoaded",
+                "name": "BattleUnit loaded"
+              },
+              {
+                "key": "BattleUnitLoadFailed",
+                "name": "BattleUnit load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -445,7 +548,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "BattleUnit"
+                    "BattleUnit",
+                    {
+                      "emit": {
+                        "failure": "BattleUnitLoadFailed",
+                        "success": "BattleUnitLoaded"
+                      }
+                    }
                   ]
                 ]
               },
@@ -458,12 +567,12 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "combat-log",
+                      "title": "Combat Log",
+                      "showTimestamps": true,
+                      "maxVisible": 10.0,
                       "events": "@BattleUnit",
-                      "maxVisible": 10,
                       "autoScroll": true,
-                      "showTimestamps": true,
-                      "title": "Combat Log"
+                      "type": "combat-log"
                     }
                   ]
                 ]
@@ -477,18 +586,19 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "combat-log",
-                      "events": "@BattleUnit",
-                      "maxVisible": 10,
+                      "maxVisible": 10.0,
                       "autoScroll": true,
-                      "showTimestamps": true,
-                      "title": "Combat Log"
+                      "title": "Combat Log",
+                      "events": "@BattleUnit",
+                      "type": "combat-log",
+                      "showTimestamps": true
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -507,4 +617,4 @@
       ]
     }
   ]
-}
+}