@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/organisms/std-puzzle-app.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-puzzle-app",
   "version": "1.0.0",
-  "description": "Puzzle game organism. Composes: stdPuzzleGame(PuzzleLevel) + stdScoreBoard(PuzzleScore)",
+  "description": "std-puzzle-app as a Function",
   "orbitals": [
     {
       "name": "PuzzleLevelOrbital",
@@ -17,17 +17,17 @@
           {
             "name": "level",
             "type": "number",
-            "default": 1
+            "default": 1.0
           },
           {
             "name": "score",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "moves",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "completed",
@@ -37,45 +37,78 @@
           {
             "name": "highScore",
             "type": "number",
-            "default": 0,
-            "min": 0,
-            "max": 9999
+            "default": 0.0
           },
           {
             "name": "combo",
             "type": "number",
-            "default": 0,
-            "min": 0,
-            "max": 99
+            "default": 0.0
           },
           {
             "name": "multiplier",
             "type": "number",
-            "default": 1,
-            "min": 1,
-            "max": 10
-          }
-        ],
-        "instances": [
-          {
-            "id": "puzzle-1",
-            "name": "Puzzle Board",
-            "description": "Active puzzle",
-            "status": "active",
-            "score": 0,
-            "highScore": 0,
-            "combo": 0,
-            "multiplier": 1,
-            "level": 1,
-            "moves": 0
+            "default": 1.0
           }
         ]
       },
       "traits": [
         {
           "name": "PuzzleLevelPuzzleFlow",
-          "linkedEntity": "PuzzleLevel",
           "category": "interaction",
+          "linkedEntity": "PuzzleLevel",
+          "emits": [
+            {
+              "event": "PuzzleLevelLoaded",
+              "description": "Fired when PuzzleLevel finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "level",
+                  "type": "number"
+                },
+                {
+                  "name": "score",
+                  "type": "number"
+                },
+                {
+                  "name": "moves",
+                  "type": "number"
+                },
+                {
+                  "name": "completed",
+                  "type": "boolean"
+                },
+                {
+                  "name": "highScore",
+                  "type": "number"
+                },
+                {
+                  "name": "combo",
+                  "type": "number"
+                },
+                {
+                  "name": "multiplier",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "PuzzleLevelLoadFailed",
+              "description": "Fired when PuzzleLevel fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -99,39 +132,53 @@
               },
               {
                 "key": "START",
-                "name": "Start Puzzle"
+                "name": "Start"
+              },
+              {
+                "key": "NAVIGATE",
+                "name": "Navigate"
               },
               {
                 "key": "MOVE",
-                "name": "Make Move"
+                "name": "Move"
               },
               {
                 "key": "HINT",
-                "name": "Show Hint"
+                "name": "Hint"
               },
               {
                 "key": "PAUSE",
                 "name": "Pause"
               },
+              {
+                "key": "GAME_OVER",
+                "name": "Game Over"
+              },
               {
                 "key": "RESUME",
                 "name": "Resume"
               },
               {
-                "key": "GAME_OVER",
-                "name": "Puzzle Complete"
+                "key": "CLOSE",
+                "name": "Close"
               },
               {
                 "key": "RESTART",
                 "name": "Restart"
               },
               {
-                "key": "CLOSE",
-                "name": "Close"
+                "key": "PuzzleLevelLoaded",
+                "name": "PuzzleLevel loaded"
               },
               {
-                "key": "NAVIGATE",
-                "name": "Navigate"
+                "key": "PuzzleLevelLoadFailed",
+                "name": "PuzzleLevel load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -142,29 +189,35 @@
                 "effects": [
                   [
                     "fetch",
-                    "PuzzleLevel"
+                    "PuzzleLevel",
+                    {
+                      "emit": {
+                        "success": "PuzzleLevelLoaded",
+                        "failure": "PuzzleLevelLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
-                      "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
                           "type": "game-menu",
                           "title": "Puzzle Challenge",
-                          "subtitle": "Puzzle Challenge",
                           "menuItems": [
                             {
-                              "label": "Start Puzzle",
+                              "variant": "primary",
                               "event": "START",
-                              "variant": "primary"
+                              "label": "Start Puzzle"
                             }
-                          ]
+                          ],
+                          "subtitle": "Puzzle Challenge"
                         }
-                      ]
+                      ],
+                      "appName": "Puzzle App",
+                      "type": "game-shell",
+                      "showTopBar": true
                     }
                   ]
                 ]
@@ -178,21 +231,26 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
                       "appName": "Puzzle App",
-                      "showTopBar": true,
+                      "type": "game-shell",
                       "children": [
                         {
+                          "width": 800.0,
                           "type": "game-canvas-2d",
-                          "width": 800,
-                          "height": 600,
-                          "fps": 60
+                          "height": 600.0,
+                          "fps": 60.0
                         }
-                      ]
+                      ],
+                      "showTopBar": true
                     }
                   ]
                 ]
               },
+              {
+                "from": "menu",
+                "to": "menu",
+                "event": "NAVIGATE"
+              },
               {
                 "from": "playing",
                 "to": "playing",
@@ -204,7 +262,7 @@
                     [
                       "+",
                       "@entity.moves",
-                      1
+                      1.0
                     ]
                   ],
                   [
@@ -213,15 +271,15 @@
                     {
                       "type": "game-shell",
                       "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
+                          "width": 800.0,
                           "type": "game-canvas-2d",
-                          "width": 800,
-                          "height": 600,
-                          "fps": 60
+                          "height": 600.0,
+                          "fps": 60.0
                         }
-                      ]
+                      ],
+                      "showTopBar": true
                     }
                   ]
                 ]
@@ -229,20 +287,7 @@
               {
                 "from": "playing",
                 "to": "playing",
-                "event": "HINT",
-                "effects": []
-              },
-              {
-                "from": "menu",
-                "to": "menu",
-                "event": "NAVIGATE",
-                "effects": []
-              },
-              {
-                "from": "paused",
-                "to": "paused",
-                "event": "NAVIGATE",
-                "effects": []
+                "event": "HINT"
               },
               {
                 "from": "playing",
@@ -257,14 +302,14 @@
                       "title": "Paused",
                       "menuItems": [
                         {
-                          "label": "Resume",
                           "event": "RESUME",
+                          "label": "Resume",
                           "variant": "primary"
                         },
                         {
+                          "variant": "ghost",
                           "label": "Quit",
-                          "event": "RESTART",
-                          "variant": "ghost"
+                          "event": "RESTART"
                         }
                       ]
                     }
@@ -272,38 +317,58 @@
                 ]
               },
               {
-                "from": "paused",
-                "to": "playing",
-                "event": "RESUME",
+                "from": "playing",
+                "to": "gameover",
+                "event": "GAME_OVER",
                 "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
                       "appName": "Puzzle App",
                       "showTopBar": true,
                       "children": [
                         {
-                          "type": "game-canvas-2d",
-                          "width": 800,
-                          "height": 600,
-                          "fps": 60
+                          "title": "Puzzle Complete",
+                          "stats": [
+                            {
+                              "label": "Score",
+                              "value": "@entity.score"
+                            },
+                            {
+                              "label": "Moves",
+                              "value": "@entity.moves"
+                            }
+                          ],
+                          "type": "game-over-screen",
+                          "menuItems": [
+                            {
+                              "label": "Play Again",
+                              "variant": "primary",
+                              "event": "RESTART"
+                            },
+                            {
+                              "label": "Main Menu",
+                              "event": "RESTART",
+                              "variant": "secondary"
+                            }
+                          ]
                         }
-                      ]
+                      ],
+                      "type": "game-shell"
                     }
                   ]
                 ]
               },
+              {
+                "from": "paused",
+                "to": "paused",
+                "event": "NAVIGATE"
+              },
               {
                 "from": "paused",
                 "to": "playing",
-                "event": "CLOSE",
+                "event": "RESUME",
                 "effects": [
                   [
                     "render-ui",
@@ -314,59 +379,44 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
-                      "appName": "Puzzle App",
                       "showTopBar": true,
+                      "type": "game-shell",
                       "children": [
                         {
-                          "type": "game-canvas-2d",
-                          "width": 800,
-                          "height": 600,
-                          "fps": 60
+                          "width": 800.0,
+                          "fps": 60.0,
+                          "height": 600.0,
+                          "type": "game-canvas-2d"
                         }
-                      ]
+                      ],
+                      "appName": "Puzzle App"
                     }
                   ]
                 ]
               },
               {
-                "from": "playing",
-                "to": "gameover",
-                "event": "GAME_OVER",
+                "from": "paused",
+                "to": "playing",
+                "event": "CLOSE",
                 "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-shell",
-                      "appName": "Puzzle App",
                       "showTopBar": true,
+                      "appName": "Puzzle App",
                       "children": [
                         {
-                          "type": "game-over-screen",
-                          "title": "Puzzle Complete",
-                          "stats": [
-                            {
-                              "label": "Score",
-                              "value": "@entity.score"
-                            },
-                            {
-                              "label": "Moves",
-                              "value": "@entity.moves"
-                            }
-                          ],
-                          "menuItems": [
-                            {
-                              "label": "Play Again",
-                              "event": "RESTART",
-                              "variant": "primary"
-                            },
-                            {
-                              "label": "Main Menu",
-                              "event": "RESTART",
-                              "variant": "secondary"
-                            }
-                          ]
+                          "type": "game-canvas-2d",
+                          "width": 800.0,
+                          "fps": 60.0,
+                          "height": 600.0
                         }
                       ]
                     }
@@ -374,51 +424,50 @@
                 ]
               },
               {
-                "from": "gameover",
+                "from": "paused",
                 "to": "menu",
                 "event": "RESTART",
                 "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-shell",
-                      "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
-                          "type": "game-menu",
                           "title": "Puzzle Challenge",
+                          "type": "game-menu",
                           "subtitle": "Puzzle Challenge",
                           "menuItems": [
                             {
+                              "variant": "primary",
                               "label": "Start Puzzle",
-                              "event": "START",
-                              "variant": "primary"
+                              "event": "START"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "showTopBar": true,
+                      "appName": "Puzzle App"
                     }
                   ]
                 ]
               },
               {
-                "from": "paused",
+                "from": "gameover",
                 "to": "menu",
                 "event": "RESTART",
                 "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-shell",
-                      "appName": "Puzzle App",
                       "showTopBar": true,
                       "children": [
                         {
@@ -427,24 +476,79 @@
                           "subtitle": "Puzzle Challenge",
                           "menuItems": [
                             {
+                              "variant": "primary",
                               "label": "Start Puzzle",
-                              "event": "START",
-                              "variant": "primary"
+                              "event": "START"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "appName": "Puzzle App"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "PuzzleLevelPuzzleScore",
-          "linkedEntity": "PuzzleLevel",
           "category": "interaction",
+          "linkedEntity": "PuzzleLevel",
+          "emits": [
+            {
+              "event": "PuzzleLevelLoaded",
+              "description": "Fired when PuzzleLevel finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "level",
+                  "type": "number"
+                },
+                {
+                  "name": "score",
+                  "type": "number"
+                },
+                {
+                  "name": "moves",
+                  "type": "number"
+                },
+                {
+                  "name": "completed",
+                  "type": "boolean"
+                },
+                {
+                  "name": "highScore",
+                  "type": "number"
+                },
+                {
+                  "name": "combo",
+                  "type": "number"
+                },
+                {
+                  "name": "multiplier",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "PuzzleLevelLoadFailed",
+              "description": "Fired when PuzzleLevel fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -482,6 +586,20 @@
               {
                 "key": "RESET",
                 "name": "Reset"
+              },
+              {
+                "key": "PuzzleLevelLoaded",
+                "name": "PuzzleLevel loaded"
+              },
+              {
+                "key": "PuzzleLevelLoadFailed",
+                "name": "PuzzleLevel load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -492,7 +610,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "PuzzleLevel"
+                    "PuzzleLevel",
+                    {
+                      "emit": {
+                        "success": "PuzzleLevelLoaded",
+                        "failure": "PuzzleLevelLoadFailed"
+                      }
+                    }
                   ]
                 ]
               },
@@ -516,7 +640,7 @@
                     [
                       "+",
                       "@entity.combo",
-                      1
+                      1.0
                     ]
                   ],
                   [
@@ -524,18 +648,18 @@
                     "main",
                     {
                       "type": "game-shell",
-                      "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
-                          "type": "score-board",
+                          "multiplier": "@entity.multiplier",
+                          "level": "@entity.level",
                           "score": "@entity.score",
                           "highScore": "@entity.highScore",
                           "combo": "@entity.combo",
-                          "multiplier": "@entity.multiplier",
-                          "level": "@entity.level"
+                          "type": "score-board"
                         }
-                      ]
+                      ],
+                      "showTopBar": true,
+                      "appName": "Puzzle App"
                     }
                   ]
                 ]
@@ -554,17 +678,17 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
                       "appName": "Puzzle App",
                       "showTopBar": true,
+                      "type": "game-shell",
                       "children": [
                         {
-                          "type": "score-board",
                           "score": "@entity.score",
+                          "type": "score-board",
                           "highScore": "@entity.highScore",
-                          "combo": "@entity.combo",
+                          "level": "@entity.level",
                           "multiplier": "@entity.multiplier",
-                          "level": "@entity.level"
+                          "combo": "@entity.combo"
                         }
                       ]
                     }
@@ -579,48 +703,48 @@
                   [
                     "set",
                     "@entity.score",
-                    0
+                    0.0
                   ],
                   [
                     "set",
                     "@entity.combo",
-                    0
+                    0.0
                   ],
                   [
                     "set",
                     "@entity.multiplier",
-                    1
+                    1.0
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
-                      "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
-                          "type": "score-board",
-                          "score": "@entity.score",
-                          "highScore": "@entity.highScore",
                           "combo": "@entity.combo",
+                          "type": "score-board",
                           "multiplier": "@entity.multiplier",
-                          "level": "@entity.level"
+                          "level": "@entity.level",
+                          "highScore": "@entity.highScore",
+                          "score": "@entity.score"
                         }
-                      ]
+                      ],
+                      "showTopBar": true,
+                      "type": "game-shell",
+                      "appName": "Puzzle App"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
         {
           "name": "PuzzlePage",
           "path": "/puzzle",
-          "isInitial": true,
           "traits": [
             {
               "ref": "PuzzleLevelPuzzleFlow"
@@ -651,38 +775,96 @@
           {
             "name": "score",
             "type": "number",
-            "required": true
+            "required": true,
+            "default": 0.0
           },
           {
             "name": "level",
-            "type": "number"
+            "type": "number",
+            "default": 1.0
           },
           {
             "name": "moves",
-            "type": "number"
+            "type": "number",
+            "default": 0.0
           },
           {
             "name": "highScore",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "combo",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "multiplier",
             "type": "number",
-            "default": 1
+            "default": 1.0
           }
         ]
       },
       "traits": [
         {
           "name": "PuzzleScoreScoreBoard",
-          "linkedEntity": "PuzzleScore",
           "category": "interaction",
+          "linkedEntity": "PuzzleScore",
+          "emits": [
+            {
+              "event": "PuzzleScoreLoaded",
+              "description": "Fired when PuzzleScore finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "playerName",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "score",
+                  "type": "number",
+                  "required": true
+                },
+                {
+                  "name": "level",
+                  "type": "number"
+                },
+                {
+                  "name": "moves",
+                  "type": "number"
+                },
+                {
+                  "name": "highScore",
+                  "type": "number"
+                },
+                {
+                  "name": "combo",
+                  "type": "number"
+                },
+                {
+                  "name": "multiplier",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "PuzzleScoreLoadFailed",
+              "description": "Fired when PuzzleScore fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -701,8 +883,7 @@
                 "payload": [
                   {
                     "name": "points",
-                    "type": "number",
-                    "required": true
+                    "type": "string"
                   }
                 ]
               },
@@ -712,14 +893,27 @@
                 "payload": [
                   {
                     "name": "multiplier",
-                    "type": "number",
-                    "required": true
+                    "type": "string"
                   }
                 ]
               },
               {
                 "key": "RESET",
                 "name": "Reset"
+              },
+              {
+                "key": "PuzzleScoreLoaded",
+                "name": "PuzzleScore loaded"
+              },
+              {
+                "key": "PuzzleScoreLoadFailed",
+                "name": "PuzzleScore load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -730,25 +924,31 @@
                 "effects": [
                   [
                     "fetch",
-                    "PuzzleScore"
+                    "PuzzleScore",
+                    {
+                      "emit": {
+                        "success": "PuzzleScoreLoaded",
+                        "failure": "PuzzleScoreLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-shell",
-                      "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
-                          "type": "score-board",
                           "score": "@entity.score",
-                          "highScore": "@entity.highScore",
                           "combo": "@entity.combo",
+                          "level": "@entity.level",
                           "multiplier": "@entity.multiplier",
-                          "level": "@entity.level"
+                          "type": "score-board",
+                          "highScore": "@entity.highScore"
                         }
-                      ]
+                      ],
+                      "showTopBar": true,
+                      "appName": "Puzzle App"
                     }
                   ]
                 ]
@@ -773,7 +973,7 @@
                     [
                       "+",
                       "@entity.combo",
-                      1
+                      1.0
                     ]
                   ],
                   [
@@ -782,17 +982,17 @@
                     {
                       "type": "game-shell",
                       "appName": "Puzzle App",
-                      "showTopBar": true,
                       "children": [
                         {
-                          "type": "score-board",
                           "score": "@entity.score",
+                          "level": "@entity.level",
+                          "multiplier": "@entity.multiplier",
                           "highScore": "@entity.highScore",
                           "combo": "@entity.combo",
-                          "multiplier": "@entity.multiplier",
-                          "level": "@entity.level"
+                          "type": "score-board"
                         }
-                      ]
+                      ],
+                      "showTopBar": true
                     }
                   ]
                 ]
@@ -812,15 +1012,15 @@
                     "main",
                     {
                       "type": "game-shell",
-                      "appName": "Puzzle App",
                       "showTopBar": true,
+                      "appName": "Puzzle App",
                       "children": [
                         {
-                          "type": "score-board",
-                          "score": "@entity.score",
-                          "highScore": "@entity.highScore",
                           "combo": "@entity.combo",
+                          "score": "@entity.score",
                           "multiplier": "@entity.multiplier",
+                          "type": "score-board",
+                          "highScore": "@entity.highScore",
                           "level": "@entity.level"
                         }
                       ]
@@ -836,32 +1036,32 @@
                   [
                     "set",
                     "@entity.score",
-                    0
+                    0.0
                   ],
                   [
                     "set",
                     "@entity.combo",
-                    0
+                    0.0
                   ],
                   [
                     "set",
                     "@entity.multiplier",
-                    1
+                    1.0
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-shell",
                       "appName": "Puzzle App",
                       "showTopBar": true,
+                      "type": "game-shell",
                       "children": [
                         {
-                          "type": "score-board",
-                          "score": "@entity.score",
                           "highScore": "@entity.highScore",
                           "combo": "@entity.combo",
+                          "score": "@entity.score",
                           "multiplier": "@entity.multiplier",
+                          "type": "score-board",
                           "level": "@entity.level"
                         }
                       ]
@@ -870,12 +1070,13 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
         {
-          "name": "ScoresPage",
+          "name": "Scores",
           "path": "/scores",
           "traits": [
             {
@@ -886,4 +1087,4 @@
       ]
     }
   ]
-}
+}