@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-gameflow.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-gameflow",
   "version": "1.0.0",
-  "description": "Game state management behavior: menu, playing, paused, gameover. Uses game UI patterns per state: menu     -> game-menu (title, subtitle, Start Game button) playing  -> game-hud (score, level stats) paused   -> game-menu in modal (Resume, Quit buttons) gameover -> game-over-screen (score, Play Again, Main Menu)",
+  "description": "std-gameflow as a Function",
   "orbitals": [
     {
       "name": "GameSessionOrbital",
@@ -38,20 +38,68 @@
           {
             "name": "score",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "level",
             "type": "number",
-            "default": 1
+            "default": 1.0
           }
         ]
       },
       "traits": [
         {
           "name": "GameSessionGameflow",
-          "linkedEntity": "GameSession",
           "category": "interaction",
+          "linkedEntity": "GameSession",
+          "emits": [
+            {
+              "event": "GameSessionLoaded",
+              "description": "Fired when GameSession 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": "score",
+                  "type": "number"
+                },
+                {
+                  "name": "level",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "GameSessionLoadFailed",
+              "description": "Fired when GameSession fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -77,29 +125,43 @@
                 "key": "START",
                 "name": "Start"
               },
+              {
+                "key": "NAVIGATE",
+                "name": "Navigate"
+              },
               {
                 "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": "GameSessionLoaded",
+                "name": "GameSession loaded"
               },
               {
-                "key": "NAVIGATE",
-                "name": "Navigate"
+                "key": "GameSessionLoadFailed",
+                "name": "GameSession load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -110,22 +172,28 @@
                 "effects": [
                   [
                     "fetch",
-                    "GameSession"
+                    "GameSession",
+                    {
+                      "emit": {
+                        "success": "GameSessionLoaded",
+                        "failure": "GameSessionLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-menu",
-                      "title": "GameSession",
-                      "subtitle": "Main Menu",
                       "menuItems": [
                         {
                           "label": "Start Game",
                           "event": "START",
                           "variant": "primary"
                         }
-                      ]
+                      ],
+                      "subtitle": "Main Menu",
+                      "title": "GameSession",
+                      "type": "game-menu"
                     }
                   ]
                 ]
@@ -142,7 +210,6 @@
                       "type": "game-hud",
                       "stats": [
                         {
-                          "label": "Score",
                           "value": [
                             "object/get",
                             [
@@ -150,7 +217,8 @@
                               "@entity"
                             ],
                             "score"
-                          ]
+                          ],
+                          "label": "Score"
                         },
                         {
                           "label": "Level",
@@ -171,14 +239,7 @@
               {
                 "from": "menu",
                 "to": "menu",
-                "event": "NAVIGATE",
-                "effects": []
-              },
-              {
-                "from": "paused",
-                "to": "paused",
-                "event": "NAVIGATE",
-                "effects": []
+                "event": "NAVIGATE"
               },
               {
                 "from": "playing",
@@ -189,18 +250,18 @@
                     "render-ui",
                     "modal",
                     {
-                      "type": "game-menu",
                       "title": "Paused",
+                      "type": "game-menu",
                       "menuItems": [
                         {
-                          "label": "Resume",
                           "event": "RESUME",
-                          "variant": "primary"
+                          "variant": "primary",
+                          "label": "Resume"
                         },
                         {
+                          "variant": "ghost",
                           "label": "Quit",
-                          "event": "RESTART",
-                          "variant": "ghost"
+                          "event": "RESTART"
                         }
                       ]
                     }
@@ -208,20 +269,28 @@
                 ]
               },
               {
-                "from": "paused",
-                "to": "playing",
-                "event": "RESUME",
+                "from": "playing",
+                "to": "gameover",
+                "event": "GAME_OVER",
                 "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-hud",
+                      "type": "game-over-screen",
+                      "title": "Game Over",
+                      "menuItems": [
+                        {
+                          "variant": "primary",
+                          "label": "Play Again",
+                          "event": "RESTART"
+                        },
+                        {
+                          "label": "Main Menu",
+                          "variant": "secondary",
+                          "event": "RESTART"
+                        }
+                      ],
                       "stats": [
                         {
                           "label": "Score",
@@ -235,7 +304,6 @@
                           ]
                         },
                         {
-                          "label": "Level",
                           "value": [
                             "object/get",
                             [
@@ -243,17 +311,23 @@
                               "@entity"
                             ],
                             "level"
-                          ]
+                          ],
+                          "label": "Level"
                         }
                       ]
                     }
                   ]
                 ]
               },
+              {
+                "from": "paused",
+                "to": "paused",
+                "event": "NAVIGATE"
+              },
               {
                 "from": "paused",
                 "to": "playing",
-                "event": "CLOSE",
+                "event": "RESUME",
                 "effects": [
                   [
                     "render-ui",
@@ -278,7 +352,6 @@
                           ]
                         },
                         {
-                          "label": "Level",
                           "value": [
                             "object/get",
                             [
@@ -286,7 +359,8 @@
                               "@entity"
                             ],
                             "level"
-                          ]
+                          ],
+                          "label": "Level"
                         }
                       ]
                     }
@@ -294,16 +368,20 @@
                 ]
               },
               {
-                "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": "Game Over",
+                      "type": "game-hud",
                       "stats": [
                         {
                           "label": "Score",
@@ -317,7 +395,6 @@
                           ]
                         },
                         {
-                          "label": "Level",
                           "value": [
                             "object/get",
                             [
@@ -325,19 +402,8 @@
                               "@entity"
                             ],
                             "level"
-                          ]
-                        }
-                      ],
-                      "menuItems": [
-                        {
-                          "label": "Play Again",
-                          "event": "RESTART",
-                          "variant": "primary"
-                        },
-                        {
-                          "label": "Main Menu",
-                          "event": "RESTART",
-                          "variant": "secondary"
+                          ],
+                          "label": "Level"
                         }
                       ]
                     }
@@ -345,58 +411,59 @@
                 ]
               },
               {
-                "from": "gameover",
+                "from": "paused",
                 "to": "menu",
                 "event": "RESTART",
                 "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-menu",
-                      "title": "GameSession",
                       "subtitle": "Main Menu",
+                      "title": "GameSession",
                       "menuItems": [
                         {
                           "label": "Start Game",
-                          "event": "START",
-                          "variant": "primary"
+                          "variant": "primary",
+                          "event": "START"
                         }
-                      ]
+                      ],
+                      "type": "game-menu"
                     }
                   ]
                 ]
               },
               {
-                "from": "paused",
+                "from": "gameover",
                 "to": "menu",
                 "event": "RESTART",
                 "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-menu",
-                      "title": "GameSession",
                       "subtitle": "Main Menu",
+                      "title": "GameSession",
                       "menuItems": [
                         {
                           "label": "Start Game",
                           "event": "START",
                           "variant": "primary"
                         }
-                      ]
+                      ],
+                      "type": "game-menu"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -412,4 +479,4 @@
       ]
     }
   ]
-}
+}