@almadar/std 16.203.0 → 16.204.0

package/behaviors/registry/ui/game/atoms/std-game-design-sheet.orb

@@ -0,0 +1,527 @@
+{
+  "description": "Headless game-design metadata authority: every game or level in the std library MUST compose this atom and fill its design sheet before declaring mechanics. The sheet forces the author to state the core loop, challenge, goals, feedback, agency, mechanics, dynamics, engagement drivers, and rewards. The atom owns no rendering and no rules; it is the single source of truth for intent metadata. Domain-specific extensions (e.g., math target or grade level for an educational game) live in the consuming package, not here. Future game atoms (platformer-body, objective-flow, fx-narrative, pickup, gate-lock, etc.) correspond to fields here, and level organisms bind those atoms together while declaring how each field is realized.",
+  "ledger": {
+    "entries": {
+      "ent_01M1NKGE11AR2J7GEQPKDJRWMX": {
+        "bakedName": "GameDesignState",
+        "curName": "GameDesignState",
+        "id": "ent_01M1NKGE11AR2J7GEQPKDJRWMX",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M1NKGE119C8NKXKGJH8X4TMR": {
+        "bakedName": "DESIGN_DECLARED",
+        "curName": "DESIGN_DECLARED",
+        "id": "evt_01M1NKGE119C8NKXKGJH8X4TMR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1NKGE111XC08V7VSSVYSJB4",
+        "renames": []
+      },
+      "evt_01M1NKGE11CDYSFMFB4V6P8Y7P": {
+        "bakedName": "RESTART",
+        "curName": "RESTART",
+        "id": "evt_01M1NKGE11CDYSFMFB4V6P8Y7P",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1NKGE111XC08V7VSSVYSJB4",
+        "renames": []
+      },
+      "evt_01M1NKGE11QM4V8HX481NCVKQ0": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M1NKGE11QM4V8HX481NCVKQ0",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1NKGE111XC08V7VSSVYSJB4",
+        "renames": []
+      },
+      "orb_01M1NKGE11H9R1X869A8C6MF1G": {
+        "bakedName": "GameDesignSheetOrbital",
+        "curName": "GameDesignSheetOrbital",
+        "id": "orb_01M1NKGE11H9R1X869A8C6MF1G",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M1NKGE11QN9ZKQENH9WCNHWT": {
+        "bakedName": "GameDesignSheetPage",
+        "curName": "GameDesignSheetPage",
+        "id": "pag_01M1NKGE11QN9ZKQENH9WCNHWT",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M1NKGE111XC08V7VSSVYSJB4": {
+        "bakedName": "GameDesignSheet",
+        "curName": "GameDesignSheet",
+        "id": "trt_01M1NKGE111XC08V7VSSVYSJB4",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-game-design-sheet",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": {},
+            "name": "design",
+            "properties": {
+              "agency": {
+                "name": "agency",
+                "required": true,
+                "type": "string"
+              },
+              "challenge": {
+                "name": "challenge",
+                "required": true,
+                "type": "string"
+              },
+              "coreLoop": {
+                "name": "coreLoop",
+                "required": true,
+                "type": "string"
+              },
+              "dynamics": {
+                "items": {
+                  "type": "string"
+                },
+                "name": "dynamics",
+                "required": true,
+                "type": "array"
+              },
+              "engagement": {
+                "items": {
+                  "type": "string"
+                },
+                "name": "engagement",
+                "required": true,
+                "type": "array"
+              },
+              "feedback": {
+                "name": "feedback",
+                "required": true,
+                "type": "string"
+              },
+              "goals": {
+                "items": {
+                  "type": "string"
+                },
+                "name": "goals",
+                "required": true,
+                "type": "array"
+              },
+              "mechanics": {
+                "items": {
+                  "type": "string"
+                },
+                "name": "mechanics",
+                "required": true,
+                "type": "array"
+              },
+              "rewards": {
+                "items": {
+                  "type": "string"
+                },
+                "name": "rewards",
+                "required": true,
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "default": false,
+            "name": "declared",
+            "type": "boolean"
+          }
+        ],
+        "id": "ent_01M1NKGE11AR2J7GEQPKDJRWMX",
+        "name": "GameDesignState",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M1NKGE11H9R1X869A8C6MF1G",
+      "name": "GameDesignSheetOrbital",
+      "pages": [
+        {
+          "id": "pag_01M1NKGE11QN9ZKQENH9WCNHWT",
+          "name": "GameDesignSheetPage",
+          "path": "/game-design-sheet",
+          "traits": [
+            {
+              "ref": "GameDesignSheet",
+              "refId": "trt_01M1NKGE111XC08V7VSSVYSJB4"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "design": {
+              "default": {
+                "agency": "",
+                "challenge": "",
+                "coreLoop": "",
+                "dynamics": [],
+                "engagement": [],
+                "feedback": "",
+                "goals": [],
+                "mechanics": [],
+                "rewards": []
+              },
+              "description": "Required game-design metadata. All string/array fields must be non-empty for a finished level; empty defaults fail validation until the author fills them in.",
+              "label": "Design Sheet",
+              "properties": {
+                "agency": {
+                  "name": "agency",
+                  "required": true,
+                  "type": "string"
+                },
+                "challenge": {
+                  "name": "challenge",
+                  "required": true,
+                  "type": "string"
+                },
+                "coreLoop": {
+                  "name": "coreLoop",
+                  "required": true,
+                  "type": "string"
+                },
+                "dynamics": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "dynamics",
+                  "required": true,
+                  "type": "array"
+                },
+                "engagement": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "engagement",
+                  "required": true,
+                  "type": "array"
+                },
+                "feedback": {
+                  "name": "feedback",
+                  "required": true,
+                  "type": "string"
+                },
+                "goals": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "goals",
+                  "required": true,
+                  "type": "array"
+                },
+                "mechanics": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "mechanics",
+                  "required": true,
+                  "type": "array"
+                },
+                "rewards": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "rewards",
+                  "required": true,
+                  "type": "array"
+                }
+              },
+              "tier": "domain",
+              "type": "GameDesign"
+            }
+          },
+          "emits": [
+            {
+              "description": "The compiled game-design sheet is emitted once on INIT and again on RESTART so organism-level authorities, analytics, or tutorial overlays can react to it.",
+              "event": "DESIGN_DECLARED",
+              "eventId": "evt_01M1NKGE119C8NKXKGJH8X4TMR",
+              "payloadSchema": [
+                {
+                  "name": "design",
+                  "properties": [
+                    {
+                      "name": "coreLoop",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "challenge",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "goals",
+                      "required": true,
+                      "type": "[string]"
+                    },
+                    {
+                      "name": "feedback",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "agency",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "mechanics",
+                      "required": true,
+                      "type": "[string]"
+                    },
+                    {
+                      "name": "dynamics",
+                      "required": true,
+                      "type": "[string]"
+                    },
+                    {
+                      "name": "engagement",
+                      "required": true,
+                      "type": "[string]"
+                    },
+                    {
+                      "name": "rewards",
+                      "required": true,
+                      "type": "[string]"
+                    }
+                  ],
+                  "required": true,
+                  "type": "object"
+                }
+              ],
+              "scope": "external",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "declared",
+              "design"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "GameDesignState": "ent_01M1NKGE11AR2J7GEQPKDJRWMX"
+          },
+          "id": "trt_01M1NKGE111XC08V7VSSVYSJB4",
+          "linkedEntity": "GameDesignState",
+          "linkedEntityId": "ent_01M1NKGE11AR2J7GEQPKDJRWMX",
+          "name": "GameDesignSheet",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M1NKGE11QM4V8HX481NCVKQ0",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M1NKGE11CDYSFMFB4V6P8Y7P",
+                "key": "RESTART",
+                "name": "Restart",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "The compiled game-design sheet is emitted once on INIT and again on RESTART so organism-level authorities, analytics, or tutorial overlays can react to it.",
+                "id": "evt_01M1NKGE119C8NKXKGJH8X4TMR",
+                "key": "DESIGN_DECLARED",
+                "name": "Design Declared",
+                "payloadSchema": [
+                  {
+                    "name": "design",
+                    "properties": [
+                      {
+                        "name": "coreLoop",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "challenge",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "goals",
+                        "required": true,
+                        "type": "[string]"
+                      },
+                      {
+                        "name": "feedback",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "agency",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "mechanics",
+                        "required": true,
+                        "type": "[string]"
+                      },
+                      {
+                        "name": "dynamics",
+                        "required": true,
+                        "type": "[string]"
+                      },
+                      {
+                        "name": "engagement",
+                        "required": true,
+                        "type": "[string]"
+                      },
+                      {
+                        "name": "rewards",
+                        "required": true,
+                        "type": "[string]"
+                      }
+                    ],
+                    "required": true,
+                    "type": "object"
+                  }
+                ],
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "active"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.design",
+                    "@config.design"
+                  ],
+                  [
+                    "set",
+                    "@entity.declared",
+                    true
+                  ],
+                  [
+                    "emit",
+                    "DESIGN_DECLARED",
+                    {
+                      "design": "@entity.design"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M1NKGE11QM4V8HX481NCVKQ0",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.design",
+                    "@config.design"
+                  ],
+                  [
+                    "set",
+                    "@entity.declared",
+                    true
+                  ],
+                  [
+                    "emit",
+                    "DESIGN_DECLARED",
+                    {
+                      "design": "@entity.design"
+                    }
+                  ]
+                ],
+                "event": "RESTART",
+                "eventId": "evt_01M1NKGE11CDYSFMFB4V6P8Y7P",
+                "from": "active",
+                "to": "active"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "GameDesign": [
+          {
+            "name": "coreLoop",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "challenge",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "goals",
+            "required": true,
+            "type": "[string]"
+          },
+          {
+            "name": "feedback",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "agency",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "mechanics",
+            "required": true,
+            "type": "[string]"
+          },
+          {
+            "name": "dynamics",
+            "required": true,
+            "type": "[string]"
+          },
+          {
+            "name": "engagement",
+            "required": true,
+            "type": "[string]"
+          },
+          {
+            "name": "rewards",
+            "required": true,
+            "type": "[string]"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

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

@@ -1,5 +1,5 @@
 {
-  "description": "Headless collectible-gate mechanic: doors that stay shut until the player's collected total reaches their cost. Listens COLLECT (the board's running total — stars, coins, keys) and flips every door whose cost is met, stamping open on the shared door rows and emitting GATE_OPENED for the first newly opened door (the shared entity is the render authority for the rest). While a closed door's rect contains the player it emits GATE_BLOCKED once per approach — re-arming only after the player steps out — so the board can answer with a PLACE back and a locked fx. RESTART re-locks every door and zeroes the total. Renders nothing; boards draw closed doors as bars/walls and open ones as gaps.",
+  "description": "Headless collectible-gate mechanic: doors that stay shut until the player's collected total reaches their cost. Listens COLLECT (the board's running total — stars, coins, keys) and flips every door whose cost is met, stamping open on the shared door rows and emitting GATE_OPENED for the first newly opened door (the shared entity is the render authority for the rest). While a closed door's rect contains the player it emits GATE_BLOCKED once per approach — re-arming only after the player steps out — so the board can answer with a PLACE back and a locked fx. RESTART re-locks every door and zeroes the total. Renders nothing; boards draw closed doors as bars/walls and open ones as gaps. Corresponds to the design-sheet field(s): challenge, rewards.",
   "ledger": {
     "entries": {
       "ent_01M0PCAKPNCX4VB9ENH9KE7A6K": {
@@ -844,7 +844,53 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "Door": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "x",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "y",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "width",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "height",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "cost",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "open",
+            "type": "boolean"
+          },
+          {
+            "name": "touching",
+            "type": "boolean"
+          },
+          {
+            "name": "blocked",
+            "type": "boolean"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/game/atoms/std-lives.orb

@@ -1,5 +1,5 @@
 {
-  "description": "Headless lives + checkpoint authority for boards with stakes: owns lives, the current respawn point, and nothing else. DAMAGE (call sites rename their hazard sources — BODY_HAZARD, BODY_FELL, PATROL_HIT — onto it) costs one life, respecting an invulnerability window so overlapping hazards can't chain-drain; losing a life emits LIFE_LOST plus RESPAWN with the current checkpoint (boards route RESPAWN to the body authority's PLACE), and losing the last emits GAME_OVER instead. Checkpoints advance automatically: BODY_MOVED crossing a configured checkpoint's atX moves the respawn point forward and emits CHECKPOINT_REACHED once per checkpoint (tracked by furthest atX reached, so checkpoints are ordered along the run). RESTART reseeds lives and respawn to the spawn. Renders nothing — HUDs read lives off the shared entity.",
+  "description": "Headless lives + checkpoint authority for boards with stakes: owns lives, the current respawn point, and nothing else. DAMAGE (call sites rename their hazard sources — BODY_HAZARD, BODY_FELL, PATROL_HIT — onto it) costs one life, respecting an invulnerability window so overlapping hazards can't chain-drain; losing a life emits LIFE_LOST plus RESPAWN with the current checkpoint (boards route RESPAWN to the body authority's PLACE), and losing the last emits GAME_OVER instead. Checkpoints advance automatically: BODY_MOVED crossing a configured checkpoint's atX moves the respawn point forward and emits CHECKPOINT_REACHED once per checkpoint (tracked by furthest atX reached, so checkpoints are ordered along the run). RESTART reseeds lives and respawn to the spawn. Renders nothing — HUDs read lives off the shared entity. Corresponds to the design-sheet field(s): challenge, feedback.",
   "ledger": {
     "entries": {
       "ent_01M0PCAKN6E2Z14AYWA1MGF3TS": {
@@ -731,7 +731,31 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "Checkpoint": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "atX",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "x",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "y",
+            "required": true,
+            "type": "number"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,