@almadar/std 16.178.0 → 16.179.0

package/behaviors/registry/ui/game/atoms/ui-draw-fx-layer.orb

@@ -0,0 +1,523 @@
+{
+  "description": "DrawFxLayer — UI factory (1:1 with the @almadar/ui draw-fx-layer pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M0GQAHQ7FDHH2XQB7F4AD2GR": {
+        "bakedName": "DrawFxLayerItem",
+        "curName": "DrawFxLayerItem",
+        "id": "ent_01M0GQAHQ7FDHH2XQB7F4AD2GR",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M0GQAHQ7YBRBV4BAPRTR7M1X": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M0GQAHQ7YBRBV4BAPRTR7M1X",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0GQAHQ7T7JMMTJ03ZVF6T34",
+        "renames": []
+      },
+      "orb_01M0GQAHQ7FSQ7KS6EWTC5VSWT": {
+        "bakedName": "DrawFxLayerOrbital",
+        "curName": "DrawFxLayerOrbital",
+        "id": "orb_01M0GQAHQ7FSQ7KS6EWTC5VSWT",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0GQAHQ9QHZ6FDK2CZ2NM062": {
+        "bakedName": "DrawFxLayerPage",
+        "curName": "DrawFxLayerPage",
+        "id": "pag_01M0GQAHQ9QHZ6FDK2CZ2NM062",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0GQAHQ7T7JMMTJ03ZVF6T34": {
+        "bakedName": "DrawFxLayerRender",
+        "curName": "DrawFxLayerRender",
+        "id": "trt_01M0GQAHQ7T7JMMTJ03ZVF6T34",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-draw-fx-layer",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M0GQAHQ7FDHH2XQB7F4AD2GR",
+        "name": "DrawFxLayerItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M0GQAHQ7FSQ7KS6EWTC5VSWT",
+      "name": "DrawFxLayerOrbital",
+      "pages": [
+        {
+          "id": "pag_01M0GQAHQ9QHZ6FDK2CZ2NM062",
+          "name": "DrawFxLayerPage",
+          "path": "/draw-fx-layer",
+          "traits": [
+            {
+              "ref": "DrawFxLayerRender",
+              "refId": "trt_01M0GQAHQ7T7JMMTJ03ZVF6T34"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "art": {
+              "default": {
+                "item": {}
+              },
+              "description": "Vector art per fx type (an asset-art map: type → anim-state → drawables); a type's `idle` state wins over sprites/procedural.",
+              "items": {
+                "items": {
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "type": "object"
+              },
+              "label": "Art",
+              "tier": "presentation",
+              "type": "Map<string,Map<string,[object]>>"
+            },
+            "items": {
+              "default": [
+                {
+                  "id": "e1",
+                  "message": "Unit spawned",
+                  "type": "spawn",
+                  "x": 2.0,
+                  "y": 2.0
+                },
+                {
+                  "id": "e2",
+                  "message": "Attack landed",
+                  "type": "effect",
+                  "x": 3.0,
+                  "y": 1.0
+                }
+              ],
+              "description": "The live fx entries — the mechanic's `@entity.fx` list passed whole; `space: 'screen'` entries are skipped (the overlay owns those).",
+              "items": {
+                "properties": {
+                  "bornAt": {
+                    "name": "bornAt",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "color": {
+                    "name": "color",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "effect": {
+                    "name": "effect",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "confetti",
+                      "flash",
+                      "shake",
+                      "sparkle",
+                      "float-text",
+                      "streak-glow"
+                    ]
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "maxTtl": {
+                    "name": "maxTtl",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "message": {
+                    "name": "message",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "particleCount": {
+                    "name": "particleCount",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "position": {
+                    "name": "position",
+                    "properties": {
+                      "x": {
+                        "name": "x",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "y": {
+                        "name": "y",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "z": {
+                        "name": "z",
+                        "required": false,
+                        "type": "number"
+                      }
+                    },
+                    "required": false,
+                    "type": "object"
+                  },
+                  "size": {
+                    "name": "size",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "space": {
+                    "name": "space",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "world",
+                      "screen"
+                    ]
+                  },
+                  "ttl": {
+                    "name": "ttl",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "type": {
+                    "name": "type",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "vx": {
+                    "name": "vx",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "vy": {
+                    "name": "vy",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "vz": {
+                    "name": "vz",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "x": {
+                    "name": "x",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "y": {
+                    "name": "y",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "z": {
+                    "name": "z",
+                    "required": false,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Items",
+              "tier": "presentation",
+              "type": "[DrawFxLayerItemsItem]"
+            },
+            "presets": {
+              "default": [],
+              "description": "Consumer-declared effect vocabulary — one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst.",
+              "items": {
+                "properties": {
+                  "color": {
+                    "name": "color",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "color2": {
+                    "name": "color2",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "count": {
+                    "name": "count",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "effect": {
+                    "name": "effect",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "confetti",
+                      "flash",
+                      "shake",
+                      "sparkle",
+                      "float-text",
+                      "streak-glow"
+                    ]
+                  },
+                  "glow": {
+                    "name": "glow",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "gravity": {
+                    "name": "gravity",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "particleCount": {
+                    "name": "particleCount",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "shape": {
+                    "name": "shape",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "spark",
+                      "ring",
+                      "puff",
+                      "streak"
+                    ]
+                  },
+                  "size": {
+                    "name": "size",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "space": {
+                    "name": "space",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "world",
+                      "screen"
+                    ]
+                  },
+                  "type": {
+                    "name": "type",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "vx": {
+                    "name": "vx",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "vy": {
+                    "name": "vy",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "vz": {
+                    "name": "vz",
+                    "required": false,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Presets",
+              "tier": "presentation",
+              "type": "[DrawFxLayerPresetsItem]"
+            },
+            "sprites": {
+              "default": {
+                "item": {
+                  "animations": [
+                    "static"
+                  ],
+                  "aspect": "1:1",
+                  "category": "item",
+                  "dimension": "2d",
+                  "name": "item",
+                  "role": "item",
+                  "style": "pixel",
+                  "thumbnailUrl": "",
+                  "url": "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/features/sword.png"
+                }
+              },
+              "description": "Sprite asset per fx type (an asset-manifest effects map) — used when no vector art matches.",
+              "items": {
+                "properties": {
+                  "animations": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "animations",
+                    "required": false,
+                    "type": "array"
+                  },
+                  "aspect": {
+                    "name": "aspect",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "1:1",
+                      "16:9",
+                      "5:7",
+                      "8:1"
+                    ]
+                  },
+                  "atlas": {
+                    "name": "atlas",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "category": {
+                    "name": "category",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "dimension": {
+                    "name": "dimension",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "2d",
+                      "3d"
+                    ]
+                  },
+                  "name": {
+                    "name": "name",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "role": {
+                    "name": "role",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "sprite": {
+                    "name": "sprite",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "style": {
+                    "name": "style",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "pixel",
+                      "vector",
+                      "hd",
+                      "1-bit",
+                      "isometric"
+                    ]
+                  },
+                  "thumbnailUrl": {
+                    "name": "thumbnailUrl",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "url": {
+                    "name": "url",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Sprites",
+              "tier": "presentation",
+              "type": "Map<string,DrawFxLayerSpritesValue>"
+            },
+            "textColor": {
+              "description": "Floating-message text color when an item declares none. Default `#ffe066`.",
+              "label": "Text Color",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "tickMs": {
+              "description": "The fx mechanic's decay tick period in ms; lifetime = maxTtl × tickMs. Default 500.",
+              "label": "Tick Ms",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DrawFxLayerItem": "ent_01M0GQAHQ7FDHH2XQB7F4AD2GR"
+          },
+          "id": "trt_01M0GQAHQ7T7JMMTJ03ZVF6T34",
+          "linkedEntity": "DrawFxLayerItem",
+          "linkedEntityId": "ent_01M0GQAHQ7FDHH2XQB7F4AD2GR",
+          "name": "DrawFxLayerRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0GQAHQ7YBRBV4BAPRTR7M1X",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "art": "@config.art",
+                      "items": "@config.items",
+                      "presets": "@config.presets",
+                      "sprites": "@config.sprites",
+                      "textColor": "@config.textColor",
+                      "tickMs": "@config.tickMs",
+                      "type": "draw-fx-layer"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M0GQAHQ7YBRBV4BAPRTR7M1X",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}