@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-game-canvas3d.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-game-canvas3d",
   "version": "1.0.0",
-  "description": "3D game canvas atom using the `game-canvas-3d` pattern. Renders tiles, units, and features in a 3D scene with configurable orientation, camera mode, grid, shadows, and background color.",
+  "description": "std-game-canvas3d as a Function",
   "orbitals": [
     {
       "name": "Canvas3dSceneOrbital",
@@ -38,62 +38,86 @@
           {
             "name": "tiles",
             "type": "array",
-            "default": []
+            "default": [],
+            "items": {
+              "type": "string"
+            }
           },
           {
             "name": "units",
             "type": "array",
-            "default": []
+            "default": [],
+            "items": {
+              "type": "string"
+            }
           },
           {
             "name": "features",
             "type": "array",
-            "default": []
-          }
-        ],
-        "instances": [
-          {
-            "id": "scene-1",
-            "name": "Battle Arena",
-            "description": "A 3D battle arena",
-            "status": "active",
-            "createdAt": "2026-01-01",
-            "tiles": [
-              {
-                "x": 0,
-                "y": 0,
-                "z": 0,
-                "type": "grass"
-              },
-              {
-                "x": 1,
-                "y": 0,
-                "z": 0,
-                "type": "grass"
-              },
-              {
-                "x": 0,
-                "y": 0,
-                "z": 1,
-                "type": "stone"
-              },
-              {
-                "x": 1,
-                "y": 0,
-                "z": 1,
-                "type": "water"
-              }
-            ],
-            "units": [],
-            "features": []
+            "default": [],
+            "items": {
+              "type": "string"
+            }
           }
         ]
       },
       "traits": [
         {
           "name": "Canvas3dSceneGameCanvas3d",
-          "linkedEntity": "Canvas3dScene",
           "category": "interaction",
+          "linkedEntity": "Canvas3dScene",
+          "emits": [
+            {
+              "event": "Canvas3dSceneLoaded",
+              "description": "Fired when Canvas3dScene 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": "tiles",
+                  "type": "[string]"
+                },
+                {
+                  "name": "units",
+                  "type": "[string]"
+                },
+                {
+                  "name": "features",
+                  "type": "[string]"
+                }
+              ]
+            },
+            {
+              "event": "Canvas3dSceneLoadFailed",
+              "description": "Fired when Canvas3dScene fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -134,6 +158,20 @@
               {
                 "key": "CAMERA_CHANGE",
                 "name": "Camera Change"
+              },
+              {
+                "key": "Canvas3dSceneLoaded",
+                "name": "Canvas3dScene loaded"
+              },
+              {
+                "key": "Canvas3dSceneLoadFailed",
+                "name": "Canvas3dScene load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -144,13 +182,18 @@
                 "effects": [
                   [
                     "fetch",
-                    "Canvas3dScene"
+                    "Canvas3dScene",
+                    {
+                      "emit": {
+                        "failure": "Canvas3dSceneLoadFailed",
+                        "success": "Canvas3dSceneLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "game-canvas-3d",
                       "tiles": [
                         "object/get",
                         [
@@ -159,29 +202,30 @@
                         ],
                         "tiles"
                       ],
-                      "units": [
+                      "features": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "units"
+                        "features"
                       ],
-                      "features": [
+                      "showGrid": true,
+                      "type": "game-canvas-3d",
+                      "units": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "features"
+                        "units"
                       ],
-                      "orientation": "isometric",
+                      "unitClickEvent": "UNIT_CLICK",
+                      "backgroundColor": "#1a1a2e",
                       "cameraMode": "orbital",
-                      "showGrid": true,
                       "shadows": true,
-                      "backgroundColor": "#1a1a2e",
-                      "tileClickEvent": "TILE_CLICK",
-                      "unitClickEvent": "UNIT_CLICK"
+                      "orientation": "isometric",
+                      "tileClickEvent": "TILE_CLICK"
                     }
                   ]
                 ]
@@ -195,7 +239,9 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-canvas-3d",
+                      "cameraMode": "orbital",
+                      "backgroundColor": "#1a1a2e",
+                      "showGrid": true,
                       "tiles": [
                         "object/get",
                         [
@@ -204,6 +250,9 @@
                         ],
                         "tiles"
                       ],
+                      "orientation": "isometric",
+                      "tileClickEvent": "TILE_CLICK",
+                      "shadows": true,
                       "units": [
                         "object/get",
                         [
@@ -212,6 +261,8 @@
                         ],
                         "units"
                       ],
+                      "unitClickEvent": "UNIT_CLICK",
+                      "type": "game-canvas-3d",
                       "features": [
                         "object/get",
                         [
@@ -219,14 +270,7 @@
                           "@Canvas3dScene"
                         ],
                         "features"
-                      ],
-                      "orientation": "isometric",
-                      "cameraMode": "orbital",
-                      "showGrid": true,
-                      "shadows": true,
-                      "backgroundColor": "#1a1a2e",
-                      "tileClickEvent": "TILE_CLICK",
-                      "unitClickEvent": "UNIT_CLICK"
+                      ]
                     }
                   ]
                 ]
@@ -241,41 +285,46 @@
                     "main",
                     {
                       "type": "game-canvas-3d",
-                      "tiles": [
+                      "orientation": "isometric",
+                      "features": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "tiles"
+                        "features"
                       ],
-                      "units": [
+                      "shadows": true,
+                      "unitClickEvent": "UNIT_CLICK",
+                      "cameraMode": "orbital",
+                      "tiles": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "units"
+                        "tiles"
                       ],
-                      "features": [
+                      "units": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "features"
+                        "units"
                       ],
-                      "orientation": "isometric",
-                      "cameraMode": "orbital",
-                      "showGrid": true,
-                      "shadows": true,
                       "backgroundColor": "#1a1a2e",
                       "tileClickEvent": "TILE_CLICK",
-                      "unitClickEvent": "UNIT_CLICK"
+                      "showGrid": true
                     }
                   ]
                 ]
               },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "CAMERA_CHANGE"
+              },
               {
                 "from": "active",
                 "to": "active",
@@ -285,22 +334,29 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-canvas-3d",
-                      "tiles": [
+                      "shadows": true,
+                      "orientation": "isometric",
+                      "tileClickEvent": "TILE_CLICK",
+                      "units": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "tiles"
+                        "units"
                       ],
-                      "units": [
+                      "type": "game-canvas-3d",
+                      "cameraMode": "orbital",
+                      "unitClickEvent": "UNIT_CLICK",
+                      "showGrid": true,
+                      "backgroundColor": "#1a1a2e",
+                      "tiles": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "units"
+                        "tiles"
                       ],
                       "features": [
                         "object/get",
@@ -309,14 +365,7 @@
                           "@Canvas3dScene"
                         ],
                         "features"
-                      ],
-                      "orientation": "isometric",
-                      "cameraMode": "orbital",
-                      "showGrid": true,
-                      "shadows": true,
-                      "backgroundColor": "#1a1a2e",
-                      "tileClickEvent": "TILE_CLICK",
-                      "unitClickEvent": "UNIT_CLICK"
+                      ]
                     }
                   ]
                 ]
@@ -330,38 +379,38 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "game-canvas-3d",
-                      "tiles": [
+                      "units": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "tiles"
+                        "units"
                       ],
-                      "units": [
+                      "cameraMode": "orbital",
+                      "features": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "units"
+                        "features"
                       ],
-                      "features": [
+                      "tiles": [
                         "object/get",
                         [
                           "array/first",
                           "@Canvas3dScene"
                         ],
-                        "features"
+                        "tiles"
                       ],
+                      "tileClickEvent": "TILE_CLICK",
                       "orientation": "isometric",
-                      "cameraMode": "orbital",
-                      "showGrid": true,
+                      "unitClickEvent": "UNIT_CLICK",
                       "shadows": true,
                       "backgroundColor": "#1a1a2e",
-                      "tileClickEvent": "TILE_CLICK",
-                      "unitClickEvent": "UNIT_CLICK"
+                      "showGrid": true,
+                      "type": "game-canvas-3d"
                     }
                   ]
                 ]
@@ -369,17 +418,11 @@
               {
                 "from": "active",
                 "to": "active",
-                "event": "CAMERA_CHANGE",
-                "effects": []
-              },
-              {
-                "from": "idle",
-                "to": "idle",
-                "event": "CAMERA_CHANGE",
-                "effects": []
+                "event": "CAMERA_CHANGE"
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -395,4 +438,4 @@
       ]
     }
   ]
-}
+}

package/behaviors/registry/atoms/std-game-hud.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-game-hud",
   "version": "1.0.0",
-  "description": "Heads-up display atom. Renders the `game-hud` pattern showing health, score, lives, and other stats.",
+  "description": "std-game-hud as a Function",
   "orbitals": [
     {
       "name": "HudStateOrbital",
@@ -40,8 +40,48 @@
       "traits": [
         {
           "name": "HudStateHud",
-          "linkedEntity": "HudState",
           "category": "interaction",
+          "linkedEntity": "HudState",
+          "emits": [
+            {
+              "event": "HudStateLoaded",
+              "description": "Fired when HudState 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"
+                }
+              ]
+            },
+            {
+              "event": "HudStateLoadFailed",
+              "description": "Fired when HudState fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -57,6 +97,20 @@
               {
                 "key": "REFRESH",
                 "name": "Refresh"
+              },
+              {
+                "key": "HudStateLoaded",
+                "name": "HudState loaded"
+              },
+              {
+                "key": "HudStateLoadFailed",
+                "name": "HudState load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -67,28 +121,34 @@
                 "effects": [
                   [
                     "fetch",
-                    "HudState"
+                    "HudState",
+                    {
+                      "emit": {
+                        "failure": "HudStateLoadFailed",
+                        "success": "HudStateLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
+                      "transparent": false,
                       "type": "game-hud",
-                      "position": "top-left",
                       "size": "md",
-                      "transparent": false,
+                      "position": "top-left",
                       "stats": [
                         {
                           "label": "Name",
                           "value": "@entity.name"
                         },
                         {
-                          "label": "Description",
-                          "value": "@entity.description"
+                          "value": "@entity.description",
+                          "label": "Description"
                         },
                         {
-                          "label": "Status",
-                          "value": "@entity.status"
+                          "value": "@entity.status",
+                          "label": "Status"
                         },
                         {
                           "label": "CreatedAt",
@@ -106,40 +166,47 @@
                 "effects": [
                   [
                     "fetch",
-                    "HudState"
+                    "HudState",
+                    {
+                      "emit": {
+                        "success": "HudStateLoaded",
+                        "failure": "HudStateLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-hud",
-                      "position": "top-left",
-                      "size": "md",
-                      "transparent": false,
                       "stats": [
                         {
                           "label": "Name",
                           "value": "@entity.name"
                         },
                         {
-                          "label": "Description",
-                          "value": "@entity.description"
+                          "value": "@entity.description",
+                          "label": "Description"
                         },
                         {
                           "label": "Status",
                           "value": "@entity.status"
                         },
                         {
-                          "label": "CreatedAt",
-                          "value": "@entity.createdAt"
+                          "value": "@entity.createdAt",
+                          "label": "CreatedAt"
                         }
-                      ]
+                      ],
+                      "transparent": false,
+                      "size": "md",
+                      "position": "top-left"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -155,4 +222,4 @@
       ]
     }
   ]
-}
+}