@almadar/std 3.1.0 → 3.1.2

package/dist/exports/atoms/std-gameflow.orb

@@ -0,0 +1,319 @@
+{
+  "name": "ItemOrbital",
+  "orbitals": [
+    {
+      "name": "ItemOrbital",
+      "entity": {
+        "name": "Item",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "type": "string"
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "active"
+          },
+          {
+            "name": "createdAt",
+            "type": "string"
+          },
+          {
+            "name": "score",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "level",
+            "type": "number",
+            "default": 1
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "ItemGameflow",
+          "linkedEntity": "Item",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "menu",
+                "isInitial": true
+              },
+              {
+                "name": "playing"
+              },
+              {
+                "name": "paused"
+              },
+              {
+                "name": "gameover"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "START",
+                "name": "Start"
+              },
+              {
+                "key": "PAUSE",
+                "name": "Pause"
+              },
+              {
+                "key": "RESUME",
+                "name": "Resume"
+              },
+              {
+                "key": "GAME_OVER",
+                "name": "Game Over"
+              },
+              {
+                "key": "RESTART",
+                "name": "Restart"
+              },
+              {
+                "key": "CLOSE",
+                "name": "Close"
+              },
+              {
+                "key": "NAVIGATE",
+                "name": "Navigate"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "menu",
+                "to": "menu",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "Item"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "game-menu",
+                      "title": "Item",
+                      "subtitle": "Main Menu",
+                      "menuItems": [
+                        {
+                          "label": "Start Game",
+                          "event": "START",
+                          "variant": "primary"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "menu",
+                "to": "playing",
+                "event": "START",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "game-hud",
+                      "stats": [
+                        {
+                          "label": "Score",
+                          "value": "@entity.score"
+                        },
+                        {
+                          "label": "Level",
+                          "value": "@entity.level"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "menu",
+                "to": "menu",
+                "event": "NAVIGATE",
+                "effects": []
+              },
+              {
+                "from": "paused",
+                "to": "paused",
+                "event": "NAVIGATE",
+                "effects": []
+              },
+              {
+                "from": "playing",
+                "to": "paused",
+                "event": "PAUSE",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    {
+                      "type": "game-menu",
+                      "title": "Paused",
+                      "menuItems": [
+                        {
+                          "label": "Resume",
+                          "event": "RESUME",
+                          "variant": "primary"
+                        },
+                        {
+                          "label": "Quit",
+                          "event": "RESTART",
+                          "variant": "ghost"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "paused",
+                "to": "playing",
+                "event": "RESUME",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ]
+                ]
+              },
+              {
+                "from": "paused",
+                "to": "playing",
+                "event": "CLOSE",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ]
+                ]
+              },
+              {
+                "from": "playing",
+                "to": "gameover",
+                "event": "GAME_OVER",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "game-over-screen",
+                      "title": "Game Over",
+                      "stats": [
+                        {
+                          "label": "Score",
+                          "value": "@entity.score"
+                        },
+                        {
+                          "label": "Level",
+                          "value": "@entity.level"
+                        }
+                      ],
+                      "menuItems": [
+                        {
+                          "label": "Play Again",
+                          "event": "RESTART",
+                          "variant": "primary"
+                        },
+                        {
+                          "label": "Main Menu",
+                          "event": "RESTART",
+                          "variant": "secondary"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "gameover",
+                "to": "menu",
+                "event": "RESTART",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "game-menu",
+                      "title": "Item",
+                      "subtitle": "Main Menu",
+                      "menuItems": [
+                        {
+                          "label": "Start Game",
+                          "event": "START",
+                          "variant": "primary"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "paused",
+                "to": "menu",
+                "event": "RESTART",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "game-menu",
+                      "title": "Item",
+                      "subtitle": "Main Menu",
+                      "menuItems": [
+                        {
+                          "label": "Start Game",
+                          "event": "START",
+                          "variant": "primary"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "ItemPage",
+          "path": "/items",
+          "traits": [
+            {
+              "ref": "ItemGameflow"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "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) Pure function: params in, OrbitalDefinition out."
+}