@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-platformer-canvas.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-platformer-canvas",
   "version": "1.0.0",
-  "description": "Side-scrolling platformer atom using the `platformer-canvas` pattern. Renders player, platforms, and handles movement events.",
+  "description": "std-platformer-canvas as a Function",
   "orbitals": [
     {
       "name": "PlatformerWorldOrbital",
@@ -37,76 +37,70 @@
           },
           {
             "name": "platforms",
-            "type": "array"
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           },
           {
             "name": "player",
             "type": "object"
           }
-        ],
-        "instances": [
-          {
-            "id": "level",
-            "platforms": [
-              {
-                "x": 0,
-                "y": 350,
-                "width": 2400,
-                "height": 50
-              },
-              {
-                "x": 200,
-                "y": 250,
-                "width": 150,
-                "height": 20
-              },
-              {
-                "x": 500,
-                "y": 200,
-                "width": 120,
-                "height": 20
-              },
-              {
-                "x": 800,
-                "y": 280,
-                "width": 180,
-                "height": 20
-              },
-              {
-                "x": 1100,
-                "y": 180,
-                "width": 100,
-                "height": 20
-              },
-              {
-                "x": 1400,
-                "y": 230,
-                "width": 160,
-                "height": 20
-              },
-              {
-                "x": 1700,
-                "y": 150,
-                "width": 140,
-                "height": 20
-              }
-            ],
-            "player": {
-              "x": 50,
-              "y": 300,
-              "width": 30,
-              "height": 30,
-              "vx": 0,
-              "vy": 0
-            }
-          }
         ]
       },
       "traits": [
         {
           "name": "PlatformerWorldPlatformerCanvas",
-          "linkedEntity": "PlatformerWorld",
           "category": "interaction",
+          "linkedEntity": "PlatformerWorld",
+          "emits": [
+            {
+              "event": "PlatformerWorldLoaded",
+              "description": "Fired when PlatformerWorld 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": "platforms",
+                  "type": "[string]"
+                },
+                {
+                  "name": "player",
+                  "type": "object"
+                }
+              ]
+            },
+            {
+              "event": "PlatformerWorldLoadFailed",
+              "description": "Fired when PlatformerWorld fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -122,13 +116,17 @@
                 "key": "INIT",
                 "name": "Initialize"
               },
+              {
+                "key": "START",
+                "name": "Start"
+              },
               {
                 "key": "LEFT",
-                "name": "Move Left"
+                "name": "Left"
               },
               {
                 "key": "RIGHT",
-                "name": "Move Right"
+                "name": "Right"
               },
               {
                 "key": "JUMP",
@@ -139,8 +137,18 @@
                 "name": "Stop"
               },
               {
-                "key": "START",
-                "name": "Start"
+                "key": "PlatformerWorldLoaded",
+                "name": "PlatformerWorld loaded"
+              },
+              {
+                "key": "PlatformerWorldLoadFailed",
+                "name": "PlatformerWorld load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -151,25 +159,31 @@
                 "effects": [
                   [
                     "fetch",
-                    "PlatformerWorld"
+                    "PlatformerWorld",
+                    {
+                      "emit": {
+                        "success": "PlatformerWorldLoaded",
+                        "failure": "PlatformerWorldLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "platformer-canvas",
-                      "platforms": "@entity.platforms",
                       "player": "@entity.player",
-                      "canvasWidth": 800,
-                      "canvasHeight": 400,
-                      "worldWidth": 2400,
-                      "worldHeight": 400,
                       "followCamera": true,
                       "bgColor": "#1a1a2e",
+                      "jumpEvent": "JUMP",
                       "leftEvent": "LEFT",
+                      "worldWidth": 2400.0,
+                      "worldHeight": 400.0,
+                      "canvasWidth": 800.0,
                       "rightEvent": "RIGHT",
-                      "jumpEvent": "JUMP",
-                      "stopEvent": "STOP"
+                      "stopEvent": "STOP",
+                      "canvasHeight": 400.0,
+                      "platforms": "@entity.platforms"
                     }
                   ]
                 ]
@@ -183,19 +197,19 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "platformer-canvas",
-                      "platforms": "@entity.platforms",
-                      "player": "@entity.player",
-                      "canvasWidth": 800,
-                      "canvasHeight": 400,
-                      "worldWidth": 2400,
-                      "worldHeight": 400,
+                      "worldHeight": 400.0,
                       "followCamera": true,
+                      "player": "@entity.player",
+                      "canvasWidth": 800.0,
                       "bgColor": "#1a1a2e",
-                      "leftEvent": "LEFT",
+                      "platforms": "@entity.platforms",
+                      "canvasHeight": 400.0,
                       "rightEvent": "RIGHT",
                       "jumpEvent": "JUMP",
-                      "stopEvent": "STOP"
+                      "worldWidth": 2400.0,
+                      "stopEvent": "STOP",
+                      "leftEvent": "LEFT",
+                      "type": "platformer-canvas"
                     }
                   ]
                 ]
@@ -203,20 +217,17 @@
               {
                 "from": "running",
                 "to": "running",
-                "event": "LEFT",
-                "effects": []
+                "event": "LEFT"
               },
               {
                 "from": "running",
                 "to": "running",
-                "event": "RIGHT",
-                "effects": []
+                "event": "RIGHT"
               },
               {
                 "from": "running",
                 "to": "running",
-                "event": "JUMP",
-                "effects": []
+                "event": "JUMP"
               },
               {
                 "from": "running",
@@ -227,25 +238,26 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "platformer-canvas",
-                      "platforms": "@entity.platforms",
+                      "rightEvent": "RIGHT",
+                      "canvasHeight": 400.0,
+                      "stopEvent": "STOP",
                       "player": "@entity.player",
-                      "canvasWidth": 800,
-                      "canvasHeight": 400,
-                      "worldWidth": 2400,
-                      "worldHeight": 400,
                       "followCamera": true,
-                      "bgColor": "#1a1a2e",
+                      "worldHeight": 400.0,
+                      "type": "platformer-canvas",
                       "leftEvent": "LEFT",
-                      "rightEvent": "RIGHT",
+                      "canvasWidth": 800.0,
+                      "worldWidth": 2400.0,
                       "jumpEvent": "JUMP",
-                      "stopEvent": "STOP"
+                      "platforms": "@entity.platforms",
+                      "bgColor": "#1a1a2e"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -261,4 +273,4 @@
       ]
     }
   ]
-}
+}

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

@@ -1,7 +1,7 @@
 {
   "name": "std-push",
   "version": "1.0.0",
-  "description": "External-event subscription atom. Wraps os/watch-http with a lifecycle state machine (idle → subscribed ↔ reconnecting) using emit: config to turn incoming messages + failures into closed-circuit events.",
+  "description": "std-push as a Function",
   "orbitals": [
     {
       "name": "PushSubscriberOrbital",
@@ -27,10 +27,46 @@
           "linkedEntity": "PushSubscriber",
           "emits": [
             {
-              "event": "PUSH_RECEIVED"
+              "event": "PUSH_RECEIVED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "PUSH_DISCONNECTED"
+              "event": "PUSH_DISCONNECTED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "reason",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "PushReceived",
+              "description": "Fired on every incoming push frame",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "PushDisconnected",
+              "description": "Fired when the push connection drops",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "reason",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -39,6 +75,9 @@
                 "name": "idle",
                 "isInitial": true
               },
+              {
+                "name": "connecting"
+              },
               {
                 "name": "subscribed"
               },
@@ -48,50 +87,146 @@
             ],
             "events": [
               {
-                "key": "INIT"
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "PUSH_RECEIVED",
+                "name": "Push Received",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "PUSH_DISCONNECTED",
+                "name": "Push Disconnected",
+                "payload": [
+                  {
+                    "name": "reason",
+                    "type": "string"
+                  }
+                ]
               },
               {
-                "key": "PUSH_RECEIVED"
+                "key": "PushReceived",
+                "name": "Push received"
               },
               {
-                "key": "PUSH_DISCONNECTED"
+                "key": "PushDisconnected",
+                "name": "Push disconnected"
               }
             ],
             "transitions": [
               {
                 "from": "idle",
-                "to": "subscribed",
+                "to": "connecting",
                 "event": "INIT",
                 "effects": [
+                  [
+                    "fetch",
+                    "PushSubscriber"
+                  ],
                   [
                     "os/watch-http",
                     "wss://push.example.com",
                     {
                       "emit": {
-                        "on_message": "PUSH_RECEIVED",
-                        "failure": "PUSH_DISCONNECTED"
+                        "failure": "PUSH_DISCONNECTED",
+                        "on_message": "PUSH_RECEIVED"
                       }
                     }
                   ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "type": "spinner",
+                          "size": "sm"
+                        },
+                        {
+                          "variant": "caption",
+                          "type": "typography",
+                          "content": "Connecting…"
+                        }
+                      ],
+                      "gap": "sm",
+                      "type": "stack",
+                      "align": "center",
+                      "direction": "horizontal"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "connecting",
+                "to": "subscribed",
+                "event": "PUSH_RECEIVED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "subscribed"
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
                       "direction": "horizontal",
+                      "gap": "sm",
                       "align": "center",
                       "type": "stack",
                       "children": [
                         {
                           "name": "wifi",
+                          "type": "icon",
+                          "color": "success",
+                          "size": "sm"
+                        },
+                        {
+                          "content": "Connected",
+                          "variant": "caption",
+                          "type": "typography"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "connecting",
+                "to": "reconnecting",
+                "event": "PUSH_DISCONNECTED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "reconnecting"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "name": "wifi-off",
+                          "color": "warning",
                           "size": "sm",
                           "type": "icon"
                         },
                         {
-                          "type": "typography",
                           "variant": "caption",
-                          "content": "Connecting…"
+                          "type": "typography",
+                          "content": "Reconnecting…"
                         }
                       ],
+                      "align": "center",
+                      "type": "stack",
+                      "direction": "horizontal",
                       "gap": "sm"
                     }
                   ]
@@ -111,23 +246,23 @@
                     "render-ui",
                     "main",
                     {
+                      "gap": "sm",
                       "direction": "horizontal",
-                      "align": "center",
                       "children": [
                         {
+                          "type": "icon",
                           "size": "sm",
                           "name": "wifi",
-                          "color": "success",
-                          "type": "icon"
+                          "color": "success"
                         },
                         {
-                          "content": "Connected",
                           "variant": "caption",
-                          "type": "typography"
+                          "type": "typography",
+                          "content": "Connected"
                         }
                       ],
-                      "gap": "sm",
-                      "type": "stack"
+                      "type": "stack",
+                      "align": "center"
                     }
                   ]
                 ]
@@ -149,20 +284,20 @@
                       "align": "center",
                       "children": [
                         {
-                          "type": "icon",
+                          "size": "sm",
                           "name": "wifi-off",
                           "color": "warning",
-                          "size": "sm"
+                          "type": "icon"
                         },
                         {
+                          "content": "Reconnecting…",
                           "type": "typography",
-                          "variant": "caption",
-                          "content": "Reconnecting…"
+                          "variant": "caption"
                         }
                       ],
+                      "direction": "horizontal",
                       "type": "stack",
-                      "gap": "sm",
-                      "direction": "horizontal"
+                      "gap": "sm"
                     }
                   ]
                 ]
@@ -181,23 +316,23 @@
                     "render-ui",
                     "main",
                     {
-                      "gap": "sm",
-                      "direction": "horizontal",
                       "type": "stack",
+                      "gap": "sm",
                       "align": "center",
                       "children": [
                         {
                           "type": "icon",
-                          "size": "sm",
+                          "color": "success",
                           "name": "wifi",
-                          "color": "success"
+                          "size": "sm"
                         },
                         {
+                          "variant": "caption",
                           "type": "typography",
-                          "content": "Connected",
-                          "variant": "caption"
+                          "content": "Connected"
                         }
-                      ]
+                      ],
+                      "direction": "horizontal"
                     }
                   ]
                 ]
@@ -211,20 +346,20 @@
                     "render-ui",
                     "main",
                     {
+                      "type": "stack",
                       "gap": "sm",
                       "direction": "horizontal",
-                      "type": "stack",
                       "align": "center",
                       "children": [
                         {
+                          "type": "icon",
                           "size": "sm",
                           "name": "wifi-off",
-                          "type": "icon",
                           "color": "destructive"
                         },
                         {
-                          "variant": "caption",
                           "content": "Disconnected",
+                          "variant": "caption",
                           "type": "typography"
                         }
                       ]
@@ -233,7 +368,8 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -249,4 +385,4 @@
       ]
     }
   ]
-}
+}