@almadar/std 16.199.0 → 16.201.0

package/behaviors/registry/ui/game/atoms/std-fx-narrative.orb

@@ -0,0 +1,695 @@
+{
+  "description": "Headless pedagogy→fx translator for game boards and learning shells: turns high-level narrative events into big transient screen-space or world-space text effects consumed by std-fx-particles / fx-overlay. Levels emit NARRATE { text, style } and get a correctly styled, centered (or positioned) floating text burst without hand-rolling particle structs. Tutorials emit TUTORIAL_SHOW and the atom forwards SHOW to a composed std-tutorial-overlay trait. Renders nothing; centralizes the FX vocabulary so every level's teaching text looks and behaves the same.",
+  "ledger": {
+    "entries": {
+      "ent_01M1GXD11PARSZADDZ8Y7G9B7Q": {
+        "bakedName": "FxNarrativeData",
+        "curName": "FxNarrativeData",
+        "id": "ent_01M1GXD11PARSZADDZ8Y7G9B7Q",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M1GXD11P275CVD12BTSMGHMG": {
+        "bakedName": "NARRATE",
+        "curName": "NARRATE",
+        "id": "evt_01M1GXD11P275CVD12BTSMGHMG",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+        "renames": []
+      },
+      "evt_01M1GXD11P8DQ245DKKYT5PENS": {
+        "bakedName": "BURST",
+        "curName": "BURST",
+        "id": "evt_01M1GXD11P8DQ245DKKYT5PENS",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+        "renames": []
+      },
+      "evt_01M1GXD11PGZF578SKEZRCW4NE": {
+        "bakedName": "TUTORIAL_SHOW",
+        "curName": "TUTORIAL_SHOW",
+        "id": "evt_01M1GXD11PGZF578SKEZRCW4NE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+        "renames": []
+      },
+      "evt_01M1GXD11PWM4ZD15AH71VK0R6": {
+        "bakedName": "SHOW",
+        "curName": "SHOW",
+        "id": "evt_01M1GXD11PWM4ZD15AH71VK0R6",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+        "renames": []
+      },
+      "evt_01M1GXD11PWRTBNZR8C3CFD49B": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M1GXD11PWRTBNZR8C3CFD49B",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+        "renames": []
+      },
+      "orb_01M1GXD11PPXNETYN7PNPAC16B": {
+        "bakedName": "FxNarrativeOrbital",
+        "curName": "FxNarrativeOrbital",
+        "id": "orb_01M1GXD11PPXNETYN7PNPAC16B",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M1GXD11P21C9P7AF9WQ68WS9": {
+        "bakedName": "FxNarrativePage",
+        "curName": "FxNarrativePage",
+        "id": "pag_01M1GXD11P21C9P7AF9WQ68WS9",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M1GXD11PQRAWJ148RYZKMP89": {
+        "bakedName": "FxNarrative",
+        "curName": "FxNarrative",
+        "id": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-fx-narrative",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "name": "seq",
+            "type": "number"
+          },
+          {
+            "default": "",
+            "name": "lastText",
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M1GXD11PARSZADDZ8Y7G9B7Q",
+        "name": "FxNarrativeData",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M1GXD11PPXNETYN7PNPAC16B",
+      "name": "FxNarrativeOrbital",
+      "pages": [
+        {
+          "id": "pag_01M1GXD11P21C9P7AF9WQ68WS9",
+          "name": "FxNarrativePage",
+          "path": "/fx-narrative",
+          "traits": [
+            {
+              "ref": "FxNarrative",
+              "refId": "trt_01M1GXD11PQRAWJ148RYZKMP89"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "running": {
+              "default": true,
+              "description": "When false all narrative events are ignored.",
+              "label": "Running",
+              "tier": "domain",
+              "type": "boolean"
+            },
+            "styles": {
+              "default": {
+                "celebrate": {
+                  "color": "#facc15",
+                  "effect": "sparkle",
+                  "size": 0.9,
+                  "ttl": 3.0
+                },
+                "fact": {
+                  "color": "#38bdf8",
+                  "effect": "float-text",
+                  "size": 0.7,
+                  "ttl": 3.0
+                },
+                "hint": {
+                  "color": "#a78bfa",
+                  "effect": "float-text",
+                  "size": 0.6,
+                  "ttl": 2.0
+                },
+                "warn": {
+                  "color": "#f87171",
+                  "effect": "shake",
+                  "size": 0.6,
+                  "ttl": 1.5
+                }
+              },
+              "description": "Map of narrative style to color, size, ttl, and effect. Override per game theme.",
+              "items": {
+                "properties": {
+                  "color": {
+                    "name": "color",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "effect": {
+                    "name": "effect",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "size": {
+                    "name": "size",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "ttl": {
+                    "name": "ttl",
+                    "required": true,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Styles",
+              "tier": "presentation",
+              "type": "Map<string,StyleDef>"
+            }
+          },
+          "emits": [
+            {
+              "description": "Styled floating-text particle batch for std-fx-particles / fx-overlay.",
+              "event": "BURST",
+              "eventId": "evt_01M1GXD11P8DQ245DKKYT5PENS",
+              "payloadSchema": [
+                {
+                  "name": "particles",
+                  "type": "[FxParticle]"
+                }
+              ],
+              "scope": "external",
+              "tier": "domain"
+            },
+            {
+              "description": "Forwarded to a composed std-tutorial-overlay to open the tutorial modal.",
+              "event": "SHOW",
+              "eventId": "evt_01M1GXD11PWM4ZD15AH71VK0R6",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "lastText",
+              "seq"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "FxNarrativeData": "ent_01M1GXD11PARSZADDZ8Y7G9B7Q"
+          },
+          "id": "trt_01M1GXD11PQRAWJ148RYZKMP89",
+          "linkedEntity": "FxNarrativeData",
+          "linkedEntityId": "ent_01M1GXD11PARSZADDZ8Y7G9B7Q",
+          "name": "FxNarrative",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M1GXD11PWRTBNZR8C3CFD49B",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M1GXD11P275CVD12BTSMGHMG",
+                "key": "NARRATE",
+                "name": "Narrate",
+                "payloadSchema": [
+                  {
+                    "name": "text",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "style",
+                    "type": "string"
+                  },
+                  {
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "type": "number"
+                  },
+                  {
+                    "name": "ttl",
+                    "type": "number"
+                  },
+                  {
+                    "name": "space",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M1GXD11PGZF578SKEZRCW4NE",
+                "key": "TUTORIAL_SHOW",
+                "name": "Tutorial Show",
+                "payloadSchema": [
+                  {
+                    "name": "text",
+                    "type": "string"
+                  },
+                  {
+                    "name": "title",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "Styled floating-text particle batch for std-fx-particles / fx-overlay.",
+                "id": "evt_01M1GXD11P8DQ245DKKYT5PENS",
+                "key": "BURST",
+                "name": "Burst",
+                "payloadSchema": [
+                  {
+                    "name": "particles",
+                    "type": "[FxParticle]"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "description": "Forwarded to a composed std-tutorial-overlay to open the tutorial modal.",
+                "id": "evt_01M1GXD11PWM4ZD15AH71VK0R6",
+                "key": "SHOW",
+                "name": "Show",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "active"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.seq",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.lastText",
+                    ""
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M1GXD11PWRTBNZR8C3CFD49B",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "let",
+                    [
+                      [
+                        "styleKey",
+                        [
+                          "if",
+                          [
+                            "==",
+                            [
+                              "object/get",
+                              "@payload",
+                              "style"
+                            ],
+                            null
+                          ],
+                          "fact",
+                          [
+                            "object/get",
+                            "@payload",
+                            "style"
+                          ]
+                        ]
+                      ],
+                      [
+                        "styleDef",
+                        [
+                          "object/get",
+                          "@config.styles",
+                          "@styleKey"
+                        ]
+                      ],
+                      [
+                        "ttl",
+                        [
+                          "if",
+                          [
+                            "==",
+                            [
+                              "object/get",
+                              "@payload",
+                              "ttl"
+                            ],
+                            null
+                          ],
+                          [
+                            "object/get",
+                            "@styleDef",
+                            "ttl"
+                          ],
+                          [
+                            "object/get",
+                            "@payload",
+                            "ttl"
+                          ]
+                        ]
+                      ],
+                      [
+                        "x",
+                        [
+                          "if",
+                          [
+                            "==",
+                            [
+                              "object/get",
+                              "@payload",
+                              "x"
+                            ],
+                            null
+                          ],
+                          0.5,
+                          [
+                            "object/get",
+                            "@payload",
+                            "x"
+                          ]
+                        ]
+                      ],
+                      [
+                        "y",
+                        [
+                          "if",
+                          [
+                            "==",
+                            [
+                              "object/get",
+                              "@payload",
+                              "y"
+                            ],
+                            null
+                          ],
+                          0.25,
+                          [
+                            "object/get",
+                            "@payload",
+                            "y"
+                          ]
+                        ]
+                      ],
+                      [
+                        "space",
+                        [
+                          "if",
+                          [
+                            "==",
+                            [
+                              "object/get",
+                              "@payload",
+                              "space"
+                            ],
+                            null
+                          ],
+                          "world",
+                          [
+                            "object/get",
+                            "@payload",
+                            "space"
+                          ]
+                        ]
+                      ],
+                      [
+                        "text",
+                        [
+                          "object/get",
+                          "@payload",
+                          "text"
+                        ]
+                      ]
+                    ],
+                    [
+                      "do",
+                      [
+                        "set",
+                        "@entity.seq",
+                        [
+                          "+",
+                          "@entity.seq",
+                          1.0
+                        ]
+                      ],
+                      [
+                        "set",
+                        "@entity.lastText",
+                        "@text"
+                      ],
+                      [
+                        "emit",
+                        "BURST",
+                        {
+                          "particles": [
+                            {
+                              "bornAt": [
+                                "time/now"
+                              ],
+                              "color": [
+                                "object/get",
+                                "@styleDef",
+                                "color"
+                              ],
+                              "effect": [
+                                "object/get",
+                                "@styleDef",
+                                "effect"
+                              ],
+                              "id": [
+                                "str/concat",
+                                "narrative-",
+                                "@entity.seq"
+                              ],
+                              "maxTtl": "@ttl",
+                              "message": "@text",
+                              "particleCount": 1.0,
+                              "size": [
+                                "object/get",
+                                "@styleDef",
+                                "size"
+                              ],
+                              "space": "@space",
+                              "ttl": "@ttl",
+                              "type": "narrative",
+                              "vx": 0.0,
+                              "vy": 0.0,
+                              "vz": 0.0,
+                              "x": "@x",
+                              "y": 0.0,
+                              "z": "@y"
+                            }
+                          ]
+                        }
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "NARRATE",
+                "eventId": "evt_01M1GXD11P275CVD12BTSMGHMG",
+                "from": "active",
+                "guard": "@config.running",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "SHOW",
+                    {
+                      "id": "tutorial"
+                    }
+                  ]
+                ],
+                "event": "TUTORIAL_SHOW",
+                "eventId": "evt_01M1GXD11PGZF578SKEZRCW4NE",
+                "from": "active",
+                "guard": "@config.running",
+                "to": "active"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "FxParticle": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "x",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "z",
+            "type": "number"
+          },
+          {
+            "name": "y",
+            "type": "number"
+          },
+          {
+            "name": "message",
+            "type": "string"
+          },
+          {
+            "name": "ttl",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "maxTtl",
+            "type": "number"
+          },
+          {
+            "name": "bornAt",
+            "type": "number"
+          },
+          {
+            "name": "space",
+            "type": "string"
+          },
+          {
+            "name": "effect",
+            "type": "string"
+          },
+          {
+            "name": "color",
+            "type": "string"
+          },
+          {
+            "name": "size",
+            "type": "number"
+          },
+          {
+            "name": "vx",
+            "type": "number"
+          },
+          {
+            "name": "vy",
+            "type": "number"
+          },
+          {
+            "name": "vz",
+            "type": "number"
+          },
+          {
+            "name": "particleCount",
+            "type": "number"
+          }
+        ],
+        "NarrativeCue": [
+          {
+            "name": "text",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "style",
+            "type": "string"
+          },
+          {
+            "name": "x",
+            "type": "number"
+          },
+          {
+            "name": "y",
+            "type": "number"
+          },
+          {
+            "name": "ttl",
+            "type": "number"
+          },
+          {
+            "name": "space",
+            "type": "string"
+          }
+        ],
+        "StyleDef": [
+          {
+            "name": "color",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "size",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "ttl",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "effect",
+            "required": true,
+            "type": "string"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}