@almadar/std 16.186.0 → 16.188.0

package/behaviors/registry/ui/game/atoms/std-loop-lock.orb

@@ -0,0 +1,785 @@
+{
+  "description": "Headless winding-lock mechanic: locks that open only after the player travels a full revolution around their anchor. Listens BODY_MOVED and, while the player stays within a radial band of a lock's ring, accumulates the wrapped angular delta of their position into swept (radians, signed — either direction counts); when |swept| reaches turns × 2π the lock flips unlocked and emits LOOP_UNLOCKED once. Entering the band reseeds the angle so leaving and returning never jumps the sweep; progress is kept across exits, so a revolution can be completed in stages. RESTART re-locks every lock. Renders nothing; boards draw the ring/chest and read swept from the shared entity (the render authority).",
+  "ledger": {
+    "entries": {
+      "ent_01M119MVXMDX7KPCDQRRYHABX8": {
+        "bakedName": "LoopLockData",
+        "curName": "LoopLockData",
+        "id": "ent_01M119MVXMDX7KPCDQRRYHABX8",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M119MVXMEK1Z3KT723H1BM95": {
+        "bakedName": "LOOP_UNLOCKED",
+        "curName": "LOOP_UNLOCKED",
+        "id": "evt_01M119MVXMEK1Z3KT723H1BM95",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M119MVXMETN5BG3SCSWD03ZZ",
+        "renames": []
+      },
+      "evt_01M119MVXMEM68Q7N4HQT3DPSC": {
+        "bakedName": "RESTART",
+        "curName": "RESTART",
+        "id": "evt_01M119MVXMEM68Q7N4HQT3DPSC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M119MVXMETN5BG3SCSWD03ZZ",
+        "renames": []
+      },
+      "evt_01M119MVXMJAZTPAEY07C7C9XC": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M119MVXMJAZTPAEY07C7C9XC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M119MVXMETN5BG3SCSWD03ZZ",
+        "renames": []
+      },
+      "evt_01M119MVXMZ1D551Q50N583X54": {
+        "bakedName": "BODY_MOVED",
+        "curName": "BODY_MOVED",
+        "id": "evt_01M119MVXMZ1D551Q50N583X54",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M119MVXMETN5BG3SCSWD03ZZ",
+        "renames": []
+      },
+      "orb_01M119MVXM55QAFWY6F0BTF8FT": {
+        "bakedName": "LoopLockOrbital",
+        "curName": "LoopLockOrbital",
+        "id": "orb_01M119MVXM55QAFWY6F0BTF8FT",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M119MVXMEKXSA909Q3ZW8ZE7": {
+        "bakedName": "LoopLockPage",
+        "curName": "LoopLockPage",
+        "id": "pag_01M119MVXMEKXSA909Q3ZW8ZE7",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M119MVXMETN5BG3SCSWD03ZZ": {
+        "bakedName": "LoopLock",
+        "curName": "LoopLock",
+        "id": "trt_01M119MVXMETN5BG3SCSWD03ZZ",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-loop-lock",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": [],
+            "items": {
+              "properties": {
+                "band": {
+                  "name": "band",
+                  "required": true,
+                  "type": "number"
+                },
+                "id": {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                "inside": {
+                  "name": "inside",
+                  "required": false,
+                  "type": "boolean"
+                },
+                "lastAngle": {
+                  "name": "lastAngle",
+                  "required": false,
+                  "type": "number"
+                },
+                "radius": {
+                  "name": "radius",
+                  "required": true,
+                  "type": "number"
+                },
+                "reported": {
+                  "name": "reported",
+                  "required": false,
+                  "type": "boolean"
+                },
+                "swept": {
+                  "name": "swept",
+                  "required": false,
+                  "type": "number"
+                },
+                "turns": {
+                  "name": "turns",
+                  "required": true,
+                  "type": "number"
+                },
+                "unlocked": {
+                  "name": "unlocked",
+                  "required": false,
+                  "type": "boolean"
+                },
+                "x": {
+                  "name": "x",
+                  "required": true,
+                  "type": "number"
+                },
+                "y": {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                }
+              },
+              "type": "object"
+            },
+            "name": "locks",
+            "type": "array"
+          }
+        ],
+        "id": "ent_01M119MVXMDX7KPCDQRRYHABX8",
+        "name": "LoopLockData",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M119MVXM55QAFWY6F0BTF8FT",
+      "name": "LoopLockOrbital",
+      "pages": [
+        {
+          "id": "pag_01M119MVXMEKXSA909Q3ZW8ZE7",
+          "name": "LoopLockPage",
+          "path": "/loop-lock",
+          "traits": [
+            {
+              "ref": "LoopLock",
+              "refId": "trt_01M119MVXMETN5BG3SCSWD03ZZ"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "locks": {
+              "default": [],
+              "description": "One row per winding lock: id, anchor (x, y in world units), ring radius, radial tolerance band, and revolutions required. swept/inside/unlocked are stamped at runtime.",
+              "items": {
+                "properties": {
+                  "band": {
+                    "name": "band",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "inside": {
+                    "name": "inside",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "lastAngle": {
+                    "name": "lastAngle",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "radius": {
+                    "name": "radius",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "reported": {
+                    "name": "reported",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "swept": {
+                    "name": "swept",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "turns": {
+                    "name": "turns",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "unlocked": {
+                    "name": "unlocked",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "x": {
+                    "name": "x",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "y": {
+                    "name": "y",
+                    "required": true,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Locks",
+              "tier": "domain",
+              "type": "[LoopLock]"
+            },
+            "running": {
+              "default": true,
+              "description": "When true, BODY_MOVED accumulates angular sweep and unlocks locks; toggle to freeze every lock as-is.",
+              "label": "Running",
+              "tier": "domain",
+              "type": "boolean"
+            }
+          },
+          "emits": [
+            {
+              "description": "A lock's angular sweep reached turns × 2π and it flipped unlocked; boards layer treasure fx and rewards. When several locks open on one move, the first reports and the shared entity carries the rest.",
+              "event": "LOOP_UNLOCKED",
+              "eventId": "evt_01M119MVXMEK1Z3KT723H1BM95",
+              "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": [
+              "locks"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "LoopLockData": "ent_01M119MVXMDX7KPCDQRRYHABX8"
+          },
+          "id": "trt_01M119MVXMETN5BG3SCSWD03ZZ",
+          "linkedEntity": "LoopLockData",
+          "linkedEntityId": "ent_01M119MVXMDX7KPCDQRRYHABX8",
+          "name": "LoopLock",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M119MVXMJAZTPAEY07C7C9XC",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M119MVXMZ1D551Q50N583X54",
+                "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_01M119MVXMEM68Q7N4HQT3DPSC",
+                "key": "RESTART",
+                "name": "Restart",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "A lock's angular sweep reached turns × 2π and it flipped unlocked; boards layer treasure fx and rewards. When several locks open on one move, the first reports and the shared entity carries the rest.",
+                "id": "evt_01M119MVXMEK1Z3KT723H1BM95",
+                "key": "LOOP_UNLOCKED",
+                "name": "Loop Unlocked",
+                "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.locks",
+                    [
+                      "array/map",
+                      "@config.locks",
+                      [
+                        "fn",
+                        "l",
+                        [
+                          "object/merge",
+                          "@l",
+                          {
+                            "inside": false,
+                            "lastAngle": 0.0,
+                            "reported": false,
+                            "swept": 0.0,
+                            "unlocked": false
+                          }
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M119MVXMJAZTPAEY07C7C9XC",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.locks",
+                    [
+                      "array/map",
+                      "@entity.locks",
+                      [
+                        "fn",
+                        "l",
+                        [
+                          "let",
+                          [
+                            [
+                              "dx",
+                              [
+                                "-",
+                                "@payload.x",
+                                [
+                                  "object/get",
+                                  "@l",
+                                  "x"
+                                ]
+                              ]
+                            ],
+                            [
+                              "dy",
+                              [
+                                "-",
+                                "@payload.y",
+                                [
+                                  "object/get",
+                                  "@l",
+                                  "y"
+                                ]
+                              ]
+                            ]
+                          ],
+                          [
+                            "let",
+                            [
+                              [
+                                "dist",
+                                [
+                                  "math/hypot",
+                                  "@dx",
+                                  "@dy"
+                                ]
+                              ],
+                              [
+                                "ang",
+                                [
+                                  "math/atan2",
+                                  "@dy",
+                                  "@dx"
+                                ]
+                              ]
+                            ],
+                            [
+                              "let",
+                              [
+                                [
+                                  "in",
+                                  [
+                                    "<=",
+                                    [
+                                      "math/abs",
+                                      [
+                                        "-",
+                                        "@dist",
+                                        [
+                                          "object/get",
+                                          "@l",
+                                          "radius"
+                                        ]
+                                      ]
+                                    ],
+                                    [
+                                      "object/get",
+                                      "@l",
+                                      "band"
+                                    ]
+                                  ]
+                                ]
+                              ],
+                              [
+                                "let",
+                                [
+                                  [
+                                    "d",
+                                    [
+                                      "if",
+                                      [
+                                        "and",
+                                        "@in",
+                                        [
+                                          "==",
+                                          [
+                                            "object/get",
+                                            "@l",
+                                            "inside"
+                                          ],
+                                          true
+                                        ]
+                                      ],
+                                      [
+                                        "math/atan2",
+                                        [
+                                          "math/sin",
+                                          [
+                                            "-",
+                                            "@ang",
+                                            [
+                                              "object/get",
+                                              "@l",
+                                              "lastAngle"
+                                            ]
+                                          ]
+                                        ],
+                                        [
+                                          "math/cos",
+                                          [
+                                            "-",
+                                            "@ang",
+                                            [
+                                              "object/get",
+                                              "@l",
+                                              "lastAngle"
+                                            ]
+                                          ]
+                                        ]
+                                      ],
+                                      0.0
+                                    ]
+                                  ]
+                                ],
+                                [
+                                  "let",
+                                  [
+                                    [
+                                      "swept",
+                                      [
+                                        "+",
+                                        [
+                                          "object/get",
+                                          "@l",
+                                          "swept"
+                                        ],
+                                        "@d"
+                                      ]
+                                    ]
+                                  ],
+                                  [
+                                    "object/merge",
+                                    "@l",
+                                    {
+                                      "inside": "@in",
+                                      "lastAngle": [
+                                        "if",
+                                        "@in",
+                                        "@ang",
+                                        [
+                                          "object/get",
+                                          "@l",
+                                          "lastAngle"
+                                        ]
+                                      ],
+                                      "swept": "@swept",
+                                      "unlocked": [
+                                        "or",
+                                        [
+                                          "object/get",
+                                          "@l",
+                                          "unlocked"
+                                        ],
+                                        [
+                                          ">=",
+                                          [
+                                            "math/abs",
+                                            "@swept"
+                                          ],
+                                          [
+                                            "*",
+                                            [
+                                              "object/get",
+                                              "@l",
+                                              "turns"
+                                            ],
+                                            6.283185307179586
+                                          ]
+                                        ]
+                                      ]
+                                    }
+                                  ]
+                                ]
+                              ]
+                            ]
+                          ]
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "let",
+                    [
+                      [
+                        "newly",
+                        [
+                          "array/filter",
+                          "@entity.locks",
+                          [
+                            "fn",
+                            "l",
+                            [
+                              "and",
+                              [
+                                "==",
+                                [
+                                  "object/get",
+                                  "@l",
+                                  "unlocked"
+                                ],
+                                true
+                              ],
+                              [
+                                "==",
+                                [
+                                  "object/get",
+                                  "@l",
+                                  "reported"
+                                ],
+                                false
+                              ]
+                            ]
+                          ]
+                        ]
+                      ]
+                    ],
+                    [
+                      "if",
+                      [
+                        ">",
+                        [
+                          "array/len",
+                          "@newly"
+                        ],
+                        0.0
+                      ],
+                      [
+                        "do",
+                        [
+                          "set",
+                          "@entity.locks",
+                          [
+                            "array/map",
+                            "@entity.locks",
+                            [
+                              "fn",
+                              "l",
+                              [
+                                "if",
+                                [
+                                  "==",
+                                  [
+                                    "object/get",
+                                    "@l",
+                                    "id"
+                                  ],
+                                  [
+                                    "object/get",
+                                    [
+                                      "array/first",
+                                      "@newly"
+                                    ],
+                                    "id"
+                                  ]
+                                ],
+                                [
+                                  "object/merge",
+                                  "@l",
+                                  {
+                                    "reported": true
+                                  }
+                                ],
+                                "@l"
+                              ]
+                            ]
+                          ]
+                        ],
+                        [
+                          "emit",
+                          "LOOP_UNLOCKED",
+                          {
+                            "id": [
+                              "object/get",
+                              [
+                                "array/first",
+                                "@newly"
+                              ],
+                              "id"
+                            ],
+                            "x": [
+                              "object/get",
+                              [
+                                "array/first",
+                                "@newly"
+                              ],
+                              "x"
+                            ],
+                            "y": [
+                              "object/get",
+                              [
+                                "array/first",
+                                "@newly"
+                              ],
+                              "y"
+                            ]
+                          }
+                        ]
+                      ],
+                      null
+                    ]
+                  ]
+                ],
+                "event": "BODY_MOVED",
+                "eventId": "evt_01M119MVXMZ1D551Q50N583X54",
+                "from": "active",
+                "guard": "@config.running",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.locks",
+                    [
+                      "array/map",
+                      "@config.locks",
+                      [
+                        "fn",
+                        "l",
+                        [
+                          "object/merge",
+                          "@l",
+                          {
+                            "inside": false,
+                            "lastAngle": 0.0,
+                            "reported": false,
+                            "swept": 0.0,
+                            "unlocked": false
+                          }
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "RESTART",
+                "eventId": "evt_01M119MVXMEM68Q7N4HQT3DPSC",
+                "from": "active",
+                "to": "active"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}