@almadar/std 16.187.0 → 16.189.0

package/behaviors/registry/ui/game/atoms/std-zone-card.orb

@@ -0,0 +1,642 @@
+{
+  "description": "Headless zone-guidance mechanic for side-view boards: tracks which band of the world the player is in and holds up that zone's card — name, concept, objective — for a while after every crossing. Listens BODY_MOVED and, when the player's x crosses into a different config zone, stamps the shared entity (zoneId, card, enteredAt) and emits ZONE_CHANGED carrying the card fields; the card self-clears ttlTicks BODY_MOVED ticks later (a per-move tick counter on the entity, so pauses at speed zero still age it out) and boards clear it early via CARD_DISMISS (renamed to a board-scoped progress event) on any mechanic completion. RESTART clears the card and the clock. Renders nothing; boards draw the card from the shared entity (the render authority).",
+  "ledger": {
+    "entries": {
+      "ent_01M13F5J234QSGQ76PHXJYKKR2": {
+        "bakedName": "ZoneCardData",
+        "curName": "ZoneCardData",
+        "id": "ent_01M13F5J234QSGQ76PHXJYKKR2",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M13F5J23NF5QGD04W6TB144P": {
+        "bakedName": "ZONE_CHANGED",
+        "curName": "ZONE_CHANGED",
+        "id": "evt_01M13F5J23NF5QGD04W6TB144P",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13F5J235W797GNZ55CEQBCG",
+        "renames": []
+      },
+      "evt_01M13F5J23NT9KNCAEY39FD16W": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M13F5J23NT9KNCAEY39FD16W",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13F5J235W797GNZ55CEQBCG",
+        "renames": []
+      },
+      "evt_01M13F5J23ZMY1PJCV29YGCG70": {
+        "bakedName": "RESTART",
+        "curName": "RESTART",
+        "id": "evt_01M13F5J23ZMY1PJCV29YGCG70",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13F5J235W797GNZ55CEQBCG",
+        "renames": []
+      },
+      "evt_01M13FRCGNA69ENDSRTHG8GTH1": {
+        "bakedName": "CARD_DISMISS",
+        "curName": "CARD_DISMISS",
+        "id": "evt_01M13FRCGNA69ENDSRTHG8GTH1",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13F5J235W797GNZ55CEQBCG",
+        "renames": []
+      },
+      "evt_01M13QVB13ZYCR5X2PFDTARN56": {
+        "bakedName": "BODY_MOVED",
+        "curName": "BODY_MOVED",
+        "id": "evt_01M13QVB13ZYCR5X2PFDTARN56",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13F5J235W797GNZ55CEQBCG",
+        "renames": []
+      },
+      "orb_01M13F5J231AKTE9CGV2BQ1SCC": {
+        "bakedName": "ZoneCardOrbital",
+        "curName": "ZoneCardOrbital",
+        "id": "orb_01M13F5J231AKTE9CGV2BQ1SCC",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M13F5J23E0GVPBM36H7841BX": {
+        "bakedName": "ZoneCardPage",
+        "curName": "ZoneCardPage",
+        "id": "pag_01M13F5J23E0GVPBM36H7841BX",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M13F5J235W797GNZ55CEQBCG": {
+        "bakedName": "ZoneCard",
+        "curName": "ZoneCard",
+        "id": "trt_01M13F5J235W797GNZ55CEQBCG",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-zone-card",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "",
+            "name": "zoneId",
+            "type": "string"
+          },
+          {
+            "name": "card",
+            "properties": {
+              "concept": {
+                "name": "concept",
+                "required": false,
+                "type": "string"
+              },
+              "name": {
+                "name": "name",
+                "required": true,
+                "type": "string"
+              },
+              "objective": {
+                "name": "objective",
+                "required": false,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "default": 0.0,
+            "name": "enteredAt",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "name": "ticks",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01M13F5J234QSGQ76PHXJYKKR2",
+        "name": "ZoneCardData",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M13F5J231AKTE9CGV2BQ1SCC",
+      "name": "ZoneCardOrbital",
+      "pages": [
+        {
+          "id": "pag_01M13F5J23E0GVPBM36H7841BX",
+          "name": "ZoneCardPage",
+          "path": "/zone-card",
+          "traits": [
+            {
+              "ref": "ZoneCard",
+              "refId": "trt_01M13F5J235W797GNZ55CEQBCG"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "running": {
+              "default": true,
+              "description": "When true, BODY_MOVED tracks the current zone and ages the card; toggle to freeze the card as-is.",
+              "label": "Running",
+              "tier": "domain",
+              "type": "boolean"
+            },
+            "ttlTicks": {
+              "default": 120.0,
+              "description": "BODY_MOVED ticks the card stays up after a zone crossing (≈ 4s at 30 moves/s) before it clears itself.",
+              "label": "TTL Ticks",
+              "tier": "domain",
+              "type": "number"
+            },
+            "zones": {
+              "default": [],
+              "description": "One row per world band: id, display name, the one-line concept, the zone's objective text, and the x-range (x0..x1) the band covers.",
+              "items": {
+                "properties": {
+                  "concept": {
+                    "name": "concept",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "name": {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "objective": {
+                    "name": "objective",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "x0": {
+                    "name": "x0",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "x1": {
+                    "name": "x1",
+                    "required": true,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Zones",
+              "tier": "domain",
+              "type": "[ZoneCardZone]"
+            }
+          },
+          "emits": [
+            {
+              "description": "The player crossed into a different zone; carries the zone's card fields (name, concept, objective) so boards can swap banners/guides and hold the card up. Fires once per crossing.",
+              "event": "ZONE_CHANGED",
+              "eventId": "evt_01M13F5J23NF5QGD04W6TB144P",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "concept",
+                  "type": "string"
+                },
+                {
+                  "name": "objective",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "card",
+              "enteredAt",
+              "ticks",
+              "zoneId"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "ZoneCardData": "ent_01M13F5J234QSGQ76PHXJYKKR2"
+          },
+          "id": "trt_01M13F5J235W797GNZ55CEQBCG",
+          "linkedEntity": "ZoneCardData",
+          "linkedEntityId": "ent_01M13F5J234QSGQ76PHXJYKKR2",
+          "name": "ZoneCard",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M13F5J23NT9KNCAEY39FD16W",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M13QVB13ZYCR5X2PFDTARN56",
+                "key": "BODY_MOVED",
+                "name": "Body Moved",
+                "payloadSchema": [
+                  {
+                    "name": "x",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "vx",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "vy",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "grounded",
+                    "required": true,
+                    "type": "boolean"
+                  },
+                  {
+                    "name": "skating",
+                    "required": true,
+                    "type": "boolean"
+                  },
+                  {
+                    "name": "speed",
+                    "required": true,
+                    "type": "number"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M13FRCGNA69ENDSRTHG8GTH1",
+                "key": "CARD_DISMISS",
+                "name": "Card Dismiss",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M13F5J23ZMY1PJCV29YGCG70",
+                "key": "RESTART",
+                "name": "Restart",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "The player crossed into a different zone; carries the zone's card fields (name, concept, objective) so boards can swap banners/guides and hold the card up. Fires once per crossing.",
+                "id": "evt_01M13F5J23NF5QGD04W6TB144P",
+                "key": "ZONE_CHANGED",
+                "name": "Zone Changed",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "concept",
+                    "type": "string"
+                  },
+                  {
+                    "name": "objective",
+                    "type": "string"
+                  }
+                ],
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "active"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.zoneId",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.card",
+                    null
+                  ],
+                  [
+                    "set",
+                    "@entity.enteredAt",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.ticks",
+                    0.0
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M13F5J23NT9KNCAEY39FD16W",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.ticks",
+                    [
+                      "+",
+                      "@entity.ticks",
+                      1.0
+                    ]
+                  ],
+                  [
+                    "let",
+                    [
+                      [
+                        "zmatch",
+                        [
+                          "array/filter",
+                          "@config.zones",
+                          [
+                            "fn",
+                            "z",
+                            [
+                              "and",
+                              [
+                                ">=",
+                                "@payload.x",
+                                [
+                                  "object/get",
+                                  "@z",
+                                  "x0"
+                                ]
+                              ],
+                              [
+                                "<",
+                                "@payload.x",
+                                [
+                                  "object/get",
+                                  "@z",
+                                  "x1"
+                                ]
+                              ]
+                            ]
+                          ]
+                        ]
+                      ]
+                    ],
+                    [
+                      "do",
+                      [
+                        "if",
+                        [
+                          "and",
+                          [
+                            ">",
+                            [
+                              "array/len",
+                              "@zmatch"
+                            ],
+                            0.0
+                          ],
+                          [
+                            "!=",
+                            "@entity.zoneId",
+                            [
+                              "object/get",
+                              [
+                                "array/first",
+                                "@zmatch"
+                              ],
+                              "id"
+                            ]
+                          ]
+                        ],
+                        [
+                          "do",
+                          [
+                            "set",
+                            "@entity.zoneId",
+                            [
+                              "object/get",
+                              [
+                                "array/first",
+                                "@zmatch"
+                              ],
+                              "id"
+                            ]
+                          ],
+                          [
+                            "set",
+                            "@entity.card",
+                            {
+                              "concept": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "concept"
+                              ],
+                              "name": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "name"
+                              ],
+                              "objective": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "objective"
+                              ]
+                            }
+                          ],
+                          [
+                            "set",
+                            "@entity.enteredAt",
+                            "@entity.ticks"
+                          ],
+                          [
+                            "emit",
+                            "ZONE_CHANGED",
+                            {
+                              "concept": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "concept"
+                              ],
+                              "id": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "id"
+                              ],
+                              "name": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "name"
+                              ],
+                              "objective": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@zmatch"
+                                ],
+                                "objective"
+                              ]
+                            }
+                          ]
+                        ],
+                        null
+                      ],
+                      [
+                        "if",
+                        [
+                          "and",
+                          [
+                            "!=",
+                            "@entity.card",
+                            null
+                          ],
+                          [
+                            ">",
+                            [
+                              "-",
+                              "@entity.ticks",
+                              "@entity.enteredAt"
+                            ],
+                            "@config.ttlTicks"
+                          ]
+                        ],
+                        [
+                          "set",
+                          "@entity.card",
+                          null
+                        ],
+                        null
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "BODY_MOVED",
+                "eventId": "evt_01M13QVB13ZYCR5X2PFDTARN56",
+                "from": "active",
+                "guard": "@config.running",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.card",
+                    null
+                  ]
+                ],
+                "event": "CARD_DISMISS",
+                "eventId": "evt_01M13FRCGNA69ENDSRTHG8GTH1",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.zoneId",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.card",
+                    null
+                  ],
+                  [
+                    "set",
+                    "@entity.enteredAt",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.ticks",
+                    0.0
+                  ]
+                ],
+                "event": "RESTART",
+                "eventId": "evt_01M13F5J23ZMY1PJCV29YGCG70",
+                "from": "active",
+                "to": "active"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/game/organisms/std-arcade-board-3d.orb

@@ -1048,7 +1048,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "HeroAuthority",
-          "ref": "Nav.traits.HeroNav"
+          "ref": "Nav.traits.HeroNav",
+          "refId": "trt_01KXG04TJB91GE3PMCMF5EBAQX"
         },
         {
           "config": {
@@ -1077,7 +1078,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "PlayEconomy",
-          "ref": "Play.traits.ArcadePlay"
+          "ref": "Play.traits.ArcadePlay",
+          "refId": "trt_01KXG04TEBZRV5QJMA8KCC6X36"
         },
         {
           "config": {
@@ -1090,7 +1092,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "FxDecay",
-          "ref": "Particles.traits.FxParticles"
+          "ref": "Particles.traits.FxParticles",
+          "refId": "trt_01KXG04TFZQZVT3F7J3DTM2PXF"
         },
         {
           "config": {
@@ -1107,7 +1110,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "RoundGate",
-          "ref": "Gate.traits.ArcadeFlow"
+          "ref": "Gate.traits.ArcadeFlow",
+          "refId": "trt_01KXG04TDX1HTTKS1GM6Q2593N"
         },
         {
           "category": "interaction",