@almadar/std 16.181.0 → 16.183.0

package/behaviors/registry/ui/game/atoms/std-patrol-hazard.orb

@@ -0,0 +1,768 @@
+{
+  "description": "Headless patrol-hazard mechanic for side-view boards: moves each configured patrol back and forth along its [x0, x1] beat at its own speed (33ms tick, ping-pong with clamped turnarounds), tracks the player position off the body authority's BODY_MOVED, and emits PATROL_HIT once per contact — a per-patrol hit flag re-arms only after the player separates, so damage rules stay sparse (when two patrols connect on the same tick the first reports; the other reports on the next tick). Patrols live on a [runtime, shared] entity for the render layer (boards draw them as markers/sprites); damage, lives, and respawn stay downstream (std-lives) — this atom simulates, it never judges. Renders nothing.",
+  "ledger": {
+    "entries": {
+      "ent_01M0PCAKKXX0TFABTMPC8BNH64": {
+        "bakedName": "PatrolState",
+        "curName": "PatrolState",
+        "id": "ent_01M0PCAKKXX0TFABTMPC8BNH64",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M0PCAKKX4Q8XWSYERBAF5HQ2": {
+        "bakedName": "RESTART",
+        "curName": "RESTART",
+        "id": "evt_01M0PCAKKX4Q8XWSYERBAF5HQ2",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6",
+        "renames": []
+      },
+      "evt_01M0PCAKKXFZTMW79Z96WV5A60": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M0PCAKKXFZTMW79Z96WV5A60",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6",
+        "renames": []
+      },
+      "evt_01M0PCAKKXG9B0VPZMP3H1B5F9": {
+        "bakedName": "PATROL_HIT",
+        "curName": "PATROL_HIT",
+        "id": "evt_01M0PCAKKXG9B0VPZMP3H1B5F9",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6",
+        "renames": []
+      },
+      "evt_01M0PCAKKXZGA2QS6J3G9MZTPJ": {
+        "bakedName": "BODY_MOVED",
+        "curName": "BODY_MOVED",
+        "id": "evt_01M0PCAKKXZGA2QS6J3G9MZTPJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6",
+        "renames": []
+      },
+      "orb_01M0PCAKKX0Z1Y4YYMHYN88XSB": {
+        "bakedName": "PatrolHazardOrbital",
+        "curName": "PatrolHazardOrbital",
+        "id": "orb_01M0PCAKKX0Z1Y4YYMHYN88XSB",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0PCAKKYG6SZ7JK2WYNR99H2": {
+        "bakedName": "PatrolHazardPage",
+        "curName": "PatrolHazardPage",
+        "id": "pag_01M0PCAKKYG6SZ7JK2WYNR99H2",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6": {
+        "bakedName": "PatrolHazard",
+        "curName": "PatrolHazard",
+        "id": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-patrol-hazard",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": [],
+            "items": {
+              "properties": {
+                "dir": {
+                  "name": "dir",
+                  "required": false,
+                  "type": "number"
+                },
+                "hit": {
+                  "name": "hit",
+                  "required": false,
+                  "type": "boolean"
+                },
+                "id": {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                "speed": {
+                  "name": "speed",
+                  "required": true,
+                  "type": "number"
+                },
+                "touching": {
+                  "name": "touching",
+                  "required": false,
+                  "type": "boolean"
+                },
+                "x": {
+                  "name": "x",
+                  "required": false,
+                  "type": "number"
+                },
+                "x0": {
+                  "name": "x0",
+                  "required": true,
+                  "type": "number"
+                },
+                "x1": {
+                  "name": "x1",
+                  "required": true,
+                  "type": "number"
+                },
+                "y": {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                }
+              },
+              "type": "object"
+            },
+            "name": "patrols",
+            "type": "array"
+          },
+          {
+            "default": 0.0,
+            "name": "px",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "name": "py",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01M0PCAKKXX0TFABTMPC8BNH64",
+        "name": "PatrolState",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M0PCAKKX0Z1Y4YYMHYN88XSB",
+      "name": "PatrolHazardOrbital",
+      "pages": [
+        {
+          "id": "pag_01M0PCAKKYG6SZ7JK2WYNR99H2",
+          "name": "PatrolHazardPage",
+          "path": "/patrol-hazard",
+          "traits": [
+            {
+              "ref": "PatrolHazard",
+              "refId": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "hitRadius": {
+              "default": 0.7,
+              "description": "Per-axis distance (world units) within which a patrol counts as touching the player; smaller values demand precise contact, larger values forgive.",
+              "label": "Hit Radius",
+              "tier": "domain",
+              "type": "number"
+            },
+            "patrols": {
+              "default": [],
+              "description": "One row per patroller: id, the [x0, x1] beat it walks, its fixed y, and its speed in units/s. Current x/dir/touching/hit are stamped at runtime.",
+              "items": {
+                "properties": {
+                  "dir": {
+                    "name": "dir",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "hit": {
+                    "name": "hit",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "speed": {
+                    "name": "speed",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "touching": {
+                    "name": "touching",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "x": {
+                    "name": "x",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "x0": {
+                    "name": "x0",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "x1": {
+                    "name": "x1",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "y": {
+                    "name": "y",
+                    "required": true,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Patrols",
+              "tier": "domain",
+              "type": "[Patrol]"
+            },
+            "playerSpawnX": {
+              "default": 0.0,
+              "description": "Player x assumed before the first BODY_MOVED arrives (match the body authority's spawn).",
+              "label": "Player Spawn X",
+              "tier": "domain",
+              "type": "number"
+            },
+            "playerSpawnY": {
+              "default": 0.0,
+              "description": "Player y assumed before the first BODY_MOVED arrives.",
+              "label": "Player Spawn Y",
+              "tier": "domain",
+              "type": "number"
+            },
+            "running": {
+              "default": true,
+              "description": "When true the 33ms tick moves patrols and tests contact; toggle to freeze every patrol in place.",
+              "label": "Running",
+              "tier": "domain",
+              "type": "boolean"
+            }
+          },
+          "emits": [
+            {
+              "description": "A patrol made contact with the player this tick; fires once per contact and re-arms only after separation — boards route it to their damage rule (std-lives DAMAGE).",
+              "event": "PATROL_HIT",
+              "eventId": "evt_01M0PCAKKXG9B0VPZMP3H1B5F9",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "x",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "patrols",
+              "px",
+              "py"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "PatrolState": "ent_01M0PCAKKXX0TFABTMPC8BNH64"
+          },
+          "id": "trt_01M0PCAKKXTHKSQ9FKTMSFDTQ6",
+          "linkedEntity": "PatrolState",
+          "linkedEntityId": "ent_01M0PCAKKXX0TFABTMPC8BNH64",
+          "name": "PatrolHazard",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0PCAKKXFZTMW79Z96WV5A60",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M0PCAKKXZGA2QS6J3G9MZTPJ",
+                "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_01M0PCAKKX4Q8XWSYERBAF5HQ2",
+                "key": "RESTART",
+                "name": "Restart",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "A patrol made contact with the player this tick; fires once per contact and re-arms only after separation — boards route it to their damage rule (std-lives DAMAGE).",
+                "id": "evt_01M0PCAKKXG9B0VPZMP3H1B5F9",
+                "key": "PATROL_HIT",
+                "name": "Patrol Hit",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "x",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "active"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.patrols",
+                    [
+                      "array/map",
+                      "@config.patrols",
+                      [
+                        "fn",
+                        "p",
+                        [
+                          "object/merge",
+                          "@p",
+                          {
+                            "dir": 1.0,
+                            "hit": false,
+                            "touching": false,
+                            "x": [
+                              "object/get",
+                              "@p",
+                              "x0"
+                            ]
+                          }
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.px",
+                    "@config.playerSpawnX"
+                  ],
+                  [
+                    "set",
+                    "@entity.py",
+                    "@config.playerSpawnY"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M0PCAKKXFZTMW79Z96WV5A60",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.px",
+                    "@payload.x"
+                  ],
+                  [
+                    "set",
+                    "@entity.py",
+                    "@payload.y"
+                  ]
+                ],
+                "event": "BODY_MOVED",
+                "eventId": "evt_01M0PCAKKXZGA2QS6J3G9MZTPJ",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.patrols",
+                    [
+                      "array/map",
+                      "@config.patrols",
+                      [
+                        "fn",
+                        "p",
+                        [
+                          "object/merge",
+                          "@p",
+                          {
+                            "dir": 1.0,
+                            "hit": false,
+                            "touching": false,
+                            "x": [
+                              "object/get",
+                              "@p",
+                              "x0"
+                            ]
+                          }
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "RESTART",
+                "eventId": "evt_01M0PCAKKX4Q8XWSYERBAF5HQ2",
+                "from": "active",
+                "to": "active"
+              }
+            ]
+          },
+          "ticks": [
+            {
+              "effects": [
+                [
+                  "set",
+                  "@entity.patrols",
+                  [
+                    "array/map",
+                    "@entity.patrols",
+                    [
+                      "fn",
+                      "p",
+                      [
+                        "let",
+                        [
+                          [
+                            "nx",
+                            [
+                              "+",
+                              [
+                                "object/get",
+                                "@p",
+                                "x"
+                              ],
+                              [
+                                "*",
+                                [
+                                  "*",
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "dir"
+                                  ],
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "speed"
+                                  ]
+                                ],
+                                0.033
+                              ]
+                            ]
+                          ]
+                        ],
+                        [
+                          "let",
+                          [
+                            [
+                              "overshoot",
+                              [
+                                ">",
+                                "@nx",
+                                [
+                                  "object/get",
+                                  "@p",
+                                  "x1"
+                                ]
+                              ]
+                            ],
+                            [
+                              "undershoot",
+                              [
+                                "<",
+                                "@nx",
+                                [
+                                  "object/get",
+                                  "@p",
+                                  "x0"
+                                ]
+                              ]
+                            ]
+                          ],
+                          [
+                            "let",
+                            [
+                              [
+                                "cx",
+                                [
+                                  "if",
+                                  "@overshoot",
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "x1"
+                                  ],
+                                  [
+                                    "if",
+                                    "@undershoot",
+                                    [
+                                      "object/get",
+                                      "@p",
+                                      "x0"
+                                    ],
+                                    "@nx"
+                                  ]
+                                ]
+                              ],
+                              [
+                                "cdir",
+                                [
+                                  "if",
+                                  "@overshoot",
+                                  -1.0,
+                                  [
+                                    "if",
+                                    "@undershoot",
+                                    1.0,
+                                    [
+                                      "object/get",
+                                      "@p",
+                                      "dir"
+                                    ]
+                                  ]
+                                ]
+                              ]
+                            ],
+                            [
+                              "let",
+                              [
+                                [
+                                  "near",
+                                  [
+                                    "and",
+                                    [
+                                      "<=",
+                                      [
+                                        "math/abs",
+                                        [
+                                          "-",
+                                          "@entity.px",
+                                          "@cx"
+                                        ]
+                                      ],
+                                      "@config.hitRadius"
+                                    ],
+                                    [
+                                      "<=",
+                                      [
+                                        "math/abs",
+                                        [
+                                          "-",
+                                          "@entity.py",
+                                          [
+                                            "object/get",
+                                            "@p",
+                                            "y"
+                                          ]
+                                        ]
+                                      ],
+                                      "@config.hitRadius"
+                                    ]
+                                  ]
+                                ]
+                              ],
+                              [
+                                "object/merge",
+                                "@p",
+                                {
+                                  "dir": "@cdir",
+                                  "hit": [
+                                    "and",
+                                    "@near",
+                                    [
+                                      "==",
+                                      [
+                                        "object/get",
+                                        "@p",
+                                        "touching"
+                                      ],
+                                      false
+                                    ]
+                                  ],
+                                  "touching": "@near",
+                                  "x": "@cx"
+                                }
+                              ]
+                            ]
+                          ]
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
+                [
+                  "let",
+                  [
+                    [
+                      "hits",
+                      [
+                        "array/filter",
+                        "@entity.patrols",
+                        [
+                          "fn",
+                          "p",
+                          [
+                            "==",
+                            [
+                              "object/get",
+                              "@p",
+                              "hit"
+                            ],
+                            true
+                          ]
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "if",
+                    [
+                      ">",
+                      [
+                        "array/len",
+                        "@hits"
+                      ],
+                      0.0
+                    ],
+                    [
+                      "emit",
+                      "PATROL_HIT",
+                      {
+                        "id": [
+                          "object/get",
+                          [
+                            "array/first",
+                            "@hits"
+                          ],
+                          "id"
+                        ],
+                        "x": [
+                          "object/get",
+                          [
+                            "array/first",
+                            "@hits"
+                          ],
+                          "x"
+                        ],
+                        "y": [
+                          "object/get",
+                          [
+                            "array/first",
+                            "@hits"
+                          ],
+                          "y"
+                        ]
+                      }
+                    ],
+                    null
+                  ]
+                ]
+              ],
+              "guard": [
+                "and",
+                "@config.running",
+                [
+                  ">",
+                  [
+                    "array/len",
+                    "@entity.patrols"
+                  ],
+                  0.0
+                ]
+              ],
+              "interval": 33.0,
+              "name": "patrolTick"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}