@almadar/std 17.0.3 → 17.1.0

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

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

package/behaviors/registry/ui/game/organisms/std-arcade-board-3d.orb

@@ -2075,18 +2075,25 @@
                   "color2": "#ff6b35",
                   "count": 7.0,
                   "glow": 0.16,
+                  "gravity": 0.0,
                   "shape": "spark",
                   "size": 0.55,
                   "type": "score",
-                  "vy": -0.3
+                  "vx": 0.0,
+                  "vy": -0.3,
+                  "vz": 0.0
                 },
                 {
                   "color": "#38bdf8",
                   "color2": "#0c4a6e",
                   "count": 4.0,
+                  "gravity": 0.0,
                   "shape": "puff",
                   "size": 0.4,
-                  "type": "info"
+                  "type": "info",
+                  "vx": 0.0,
+                  "vy": 0.0,
+                  "vz": 0.0
                 }
               ],
               "description": "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark.",
@@ -2129,7 +2136,7 @@
                   "gravity": {
                     "name": "gravity",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "particleCount": {
@@ -2165,19 +2172,19 @@
                   "vx": {
                     "name": "vx",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vy": {
                     "name": "vy",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vz": {
                     "name": "vz",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   }
                 },
@@ -2512,7 +2519,7 @@
           "linkedEntityId": "ent_48KYCZH137GHKS6TE1YND0QQBW",
           "name": "ArcadeIntent",
           "sourceDeclaration": {
-            "fingerprint": "79de914a4037ff3f46e141e6e57f20b2a89e0fa7c170f9ac740c386050d5cbc2",
+            "fingerprint": "ec8b0f9e183474b740cf9635d49588fca0cb514b081cbdfab886a878d7b13e60",
             "traitId": "trt_BVK0G4R2MT1AD5N25PCAJD8NDK"
           },
           "stateMachine": {
@@ -2962,10 +2969,9 @@
                                       ]
                                     },
                                     "radiusX": 0.5,
-                                    "radiusY": 0.2,
+                                    "radiusY": 0.5,
                                     "shape": "ellipse",
                                     "stroke": "rgba(0,200,255,0.8)",
-                                    "strokeWidth": 3.0,
                                     "type": "draw-shape"
                                   }
                                 ]
@@ -3361,7 +3367,6 @@
                                   "u",
                                   {
                                     "color": "#ffffff",
-                                    "offsetY": -0.85,
                                     "position": {
                                       "x": [
                                         "object/get",
@@ -4286,10 +4291,9 @@
                                     ]
                                   },
                                   "radiusX": 0.5,
-                                  "radiusY": 0.2,
+                                  "radiusY": 0.5,
                                   "shape": "ellipse",
                                   "stroke": "rgba(0,200,255,0.8)",
-                                  "strokeWidth": 3.0,
                                   "type": "draw-shape"
                                 }
                               ]
@@ -4685,7 +4689,6 @@
                                 "u",
                                 {
                                   "color": "#ffffff",
-                                  "offsetY": -0.85,
                                   "position": {
                                     "x": [
                                       "object/get",
@@ -5200,21 +5203,25 @@
           {
             "name": "gravity",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vx",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vy",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vz",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {

package/behaviors/registry/ui/game/organisms/std-crew-board-2d.orb

@@ -2076,7 +2076,7 @@
                   "gravity": {
                     "name": "gravity",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "particleCount": {
@@ -2112,19 +2112,19 @@
                   "vx": {
                     "name": "vx",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vy": {
                     "name": "vy",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vz": {
                     "name": "vz",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   }
                 },
@@ -2520,7 +2520,7 @@
           "linkedEntityId": "ent_V9A1T5AZ4NFJAVB7GT2T1PKQ99",
           "name": "CrewIntent",
           "sourceDeclaration": {
-            "fingerprint": "f03ada06ed9c3b905c39b302b95f4fa53b806f0eac0e8557903215c2b52b0032",
+            "fingerprint": "88760a677f598c7d82c88d0d3aef506ffa4636ff61893ebb883059d782f6352e",
             "traitId": "trt_1WDYRMCPTSBDCPHTNKF8Y0J0G4"
           },
           "stateMachine": {
@@ -5957,21 +5957,25 @@
           {
             "name": "gravity",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vx",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vy",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vz",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {

package/behaviors/registry/ui/game/organisms/std-dungeon-board-2d.orb

@@ -2845,17 +2845,23 @@
                   "gravity": 0.4,
                   "shape": "ring",
                   "size": 0.85,
-                  "type": "explosion"
+                  "type": "explosion",
+                  "vx": 0.0,
+                  "vy": 0.0,
+                  "vz": 0.0
                 },
                 {
                   "color": "#ffe066",
                   "color2": "#fff4cc",
                   "count": 5.0,
                   "glow": 0.1,
+                  "gravity": 0.0,
                   "shape": "spark",
                   "size": 0.4,
                   "type": "pickup",
-                  "vy": -0.5
+                  "vx": 0.0,
+                  "vy": -0.5,
+                  "vz": 0.0
                 }
               ],
               "description": "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark.",
@@ -2898,7 +2904,7 @@
                   "gravity": {
                     "name": "gravity",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "particleCount": {
@@ -2934,19 +2940,19 @@
                   "vx": {
                     "name": "vx",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vy": {
                     "name": "vy",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vz": {
                     "name": "vz",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   }
                 },
@@ -3285,7 +3291,7 @@
           "linkedEntityId": "ent_KZGDJXMWG5E82X3CZWX0PP5QMK",
           "name": "DungeonIntent",
           "sourceDeclaration": {
-            "fingerprint": "24adc4f3f8dfb0fbc2cf7e4d546ca81f804a684a58724e300a01ed853c125cae",
+            "fingerprint": "2e506b085b51fb7cf55d90c07ba3e42a3581c8eb0cab77b12248c6482de2a652",
             "traitId": "trt_C2D87NS5BCJNP8W41DQXBJVTPK"
           },
           "stateMachine": {
@@ -6424,21 +6430,25 @@
           {
             "name": "gravity",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vx",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vy",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vz",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {

package/behaviors/registry/ui/game/organisms/std-market-board-3d.orb

@@ -2469,10 +2469,13 @@
                   "color2": "#fde68a",
                   "count": 6.0,
                   "glow": 0.1,
+                  "gravity": 0.0,
                   "shape": "spark",
                   "size": 0.45,
                   "type": "score",
-                  "vy": -0.3
+                  "vx": 0.0,
+                  "vy": -0.3,
+                  "vz": 0.0
                 },
                 {
                   "color": "#ef4444",
@@ -2481,7 +2484,10 @@
                   "gravity": 0.3,
                   "shape": "puff",
                   "size": 0.5,
-                  "type": "damage"
+                  "type": "damage",
+                  "vx": 0.0,
+                  "vy": 0.0,
+                  "vz": 0.0
                 }
               ],
               "description": "This board's effect vocabulary — one look/recipe row per fx type its mechanics emit; unknown types fall back to a neutral spark.",
@@ -2524,7 +2530,7 @@
                   "gravity": {
                     "name": "gravity",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "particleCount": {
@@ -2560,19 +2566,19 @@
                   "vx": {
                     "name": "vx",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vy": {
                     "name": "vy",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   },
                   "vz": {
                     "name": "vz",
                     "nullable": false,
-                    "required": false,
+                    "required": true,
                     "type": "number"
                   }
                 },
@@ -2833,7 +2839,7 @@
           "linkedEntityId": "ent_T0R7Z5AQS0BWGDZHQP72D8RYB5",
           "name": "MarketIntent",
           "sourceDeclaration": {
-            "fingerprint": "9d0d644660969cc054ca3148435ffdc8fe055cbfcab85bef3a061dcf966856c2",
+            "fingerprint": "a096462a4f021779a68477ea0c796e9ce0e9983b8c53c94e6fa0ed03193d0ead",
             "traitId": "trt_5QG8WC3197GMKSE7T7XXWGB8QT"
           },
           "stateMachine": {
@@ -3340,10 +3346,9 @@
                                       ]
                                     },
                                     "radiusX": 0.5,
-                                    "radiusY": 0.2,
+                                    "radiusY": 0.5,
                                     "shape": "ellipse",
                                     "stroke": "rgba(0,200,255,0.8)",
-                                    "strokeWidth": 3.0,
                                     "type": "draw-shape"
                                   }
                                 ]
@@ -4015,7 +4020,6 @@
                                     "u",
                                     {
                                       "color": "#ffffff",
-                                      "offsetY": -0.85,
                                       "position": {
                                         "x": [
                                           "object/get",
@@ -4058,7 +4062,6 @@
                                     "c",
                                     {
                                       "color": "#ffffff",
-                                      "offsetY": -0.85,
                                       "position": [
                                         "object/get",
                                         "@c",
@@ -5117,10 +5120,9 @@
                                     ]
                                   },
                                   "radiusX": 0.5,
-                                  "radiusY": 0.2,
+                                  "radiusY": 0.5,
                                   "shape": "ellipse",
                                   "stroke": "rgba(0,200,255,0.8)",
-                                  "strokeWidth": 3.0,
                                   "type": "draw-shape"
                                 }
                               ]
@@ -5792,7 +5794,6 @@
                                   "u",
                                   {
                                     "color": "#ffffff",
-                                    "offsetY": -0.85,
                                     "position": {
                                       "x": [
                                         "object/get",
@@ -5835,7 +5836,6 @@
                                   "c",
                                   {
                                     "color": "#ffffff",
-                                    "offsetY": -0.85,
                                     "position": [
                                       "object/get",
                                       "@c",
@@ -6418,21 +6418,25 @@
           {
             "name": "gravity",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vx",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vy",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {
             "name": "vz",
             "nullable": false,
+            "required": true,
             "type": "number"
           },
           {