@almadar/std 16.200.0 → 16.202.0

package/behaviors/registry/ui/game/atoms/ui-canvas.orb

@@ -64,6 +64,24 @@
         "parent": "trt_01M055GNZBYF6V29GQASHPYTJ3",
         "renames": []
       },
+      "evt_01M1M6SDSRE5Q4V2Z05HN5VR38": {
+        "bakedName": "@config.onSelect",
+        "curName": "@config.onSelect",
+        "id": "evt_01M1M6SDSRE5Q4V2Z05HN5VR38",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M055GNZBYF6V29GQASHPYTJ3",
+        "renames": []
+      },
+      "evt_01M1M6SDSREJ1C37CFD3JB8Y1T": {
+        "bakedName": "@config.onMove",
+        "curName": "@config.onMove",
+        "id": "evt_01M1M6SDSREJ1C37CFD3JB8Y1T",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M055GNZBYF6V29GQASHPYTJ3",
+        "renames": []
+      },
       "orb_01M055GNZBJ6RE4D91MS5SX557": {
         "bakedName": "CanvasOrbital",
         "curName": "CanvasOrbital",
@@ -244,6 +262,12 @@
               "tier": "presentation",
               "type": "[node]"
             },
+            "editable": {
+              "description": "--- Scene-edit mode (a game studio selecting/dragging drawables). Purely",
+              "label": "Editable",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "featureClickEvent": {
               "default": "FEATURE_CLICK",
               "description": "Feature-click event (3D only).",
@@ -447,6 +471,27 @@
                 "3d"
               ]
             },
+            "moveEvent": {
+              "default": "MOVE",
+              "description": "Declarative move event, `UI:{moveEvent} { id, x, y }` — fired once on drop.",
+              "label": "Move Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onMove": {
+              "default": "MOVE",
+              "description": "Fired once per drag gesture, on drop — before `moveEvent`.",
+              "label": "On Move",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onSelect": {
+              "default": "SELECT",
+              "description": "Fired on a click that changes selection — before `selectEvent`.",
+              "label": "On Select",
+              "tier": "presentation",
+              "type": "event"
+            },
             "pixelsPerUnit": {
               "description": "3D world-unit → pixel scale (perspective/side depth). 3D only.",
               "label": "Pixels Per Unit",
@@ -514,6 +559,19 @@
                 "side"
               ]
             },
+            "selectEvent": {
+              "default": "SELECT",
+              "description": "Declarative selection event, `UI:{selectEvent} { id }`.",
+              "label": "Select Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "selectedId": {
+              "description": "The currently-selected drawable id (controlled); `null`/undefined = none.",
+              "label": "Selected Id",
+              "tier": "presentation",
+              "type": "string"
+            },
             "shadows": {
               "description": "shadows prop",
               "label": "Shadows",
@@ -708,6 +766,42 @@
               ],
               "scope": "external",
               "tier": "essential"
+            },
+            {
+              "definerKnob": "onSelect",
+              "description": "Fired on a click that changes selection — before `selectEvent`.",
+              "event": "@config.onSelect",
+              "eventId": "evt_01M1M6SDSRE5Q4V2Z05HN5VR38",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "onMove",
+              "description": "Fired once per drag gesture, on drop — before `moveEvent`.",
+              "event": "@config.onMove",
+              "eventId": "evt_01M1M6SDSREJ1C37CFD3JB8Y1T",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "x",
+                  "type": "number"
+                },
+                {
+                  "name": "y",
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
             }
           ],
           "entityContract": {
@@ -835,6 +929,40 @@
                   }
                 ],
                 "tier": "essential"
+              },
+              {
+                "description": "Fired on a click that changes selection — before `selectEvent`.",
+                "id": "evt_01M1M6SDSRE5Q4V2Z05HN5VR38",
+                "key": "@config.onSelect",
+                "name": "@config.on select",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Fired once per drag gesture, on drop — before `moveEvent`.",
+                "id": "evt_01M1M6SDSREJ1C37CFD3JB8Y1T",
+                "key": "@config.onMove",
+                "name": "@config.on move",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  },
+                  {
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "type": "number"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -856,6 +984,7 @@
                       "children": "@config.children",
                       "className": "@config.className",
                       "drawables": "@config.drawables",
+                      "editable": "@config.editable",
                       "featureClickEvent": "@config.featureClickEvent",
                       "fit": "@config.fit",
                       "fogOfWar": "@config.fogOfWar",
@@ -864,9 +993,14 @@
                       "keyUpMap": "@config.keyUpMap",
                       "lighting": "@config.lighting",
                       "mode": "@config.mode",
+                      "moveEvent": "@config.moveEvent",
+                      "onMove": "@config.onMove",
+                      "onSelect": "@config.onSelect",
                       "pixelsPerUnit": "@config.pixelsPerUnit",
                       "post": "@config.post",
                       "projection": "@config.projection",
+                      "selectEvent": "@config.selectEvent",
+                      "selectedId": "@config.selectedId",
                       "shadows": "@config.shadows",
                       "showCoordinates": "@config.showCoordinates",
                       "showGrid": "@config.showGrid",

package/behaviors/registry/ui/game/atoms/ui-game-audio-cue.orb

@@ -0,0 +1,258 @@
+{
+  "description": "GameAudioCue — UI factory (1:1 with the @almadar/ui game-audio-cue pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M1M6XD9Q0XN6S9N4DB4JK5DR": {
+        "bakedName": "GameAudioCueItem",
+        "curName": "GameAudioCueItem",
+        "id": "ent_01M1M6XD9Q0XN6S9N4DB4JK5DR",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M1M6XD9Q63KRQBAT3KWGAXK0": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M1M6XD9Q63KRQBAT3KWGAXK0",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6XD9QYB8Y5A3RVE2R6A4Z",
+        "renames": []
+      },
+      "orb_01M1M6XD9Q3YWGEKVXZTCB28ZQ": {
+        "bakedName": "GameAudioCueOrbital",
+        "curName": "GameAudioCueOrbital",
+        "id": "orb_01M1M6XD9Q3YWGEKVXZTCB28ZQ",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M1M6XD9Q4H97NNA0WX368CHA": {
+        "bakedName": "GameAudioCuePage",
+        "curName": "GameAudioCuePage",
+        "id": "pag_01M1M6XD9Q4H97NNA0WX368CHA",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M1M6XD9QYB8Y5A3RVE2R6A4Z": {
+        "bakedName": "GameAudioCueRender",
+        "curName": "GameAudioCueRender",
+        "id": "trt_01M1M6XD9QYB8Y5A3RVE2R6A4Z",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-game-audio-cue",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M1M6XD9Q0XN6S9N4DB4JK5DR",
+        "name": "GameAudioCueItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M1M6XD9Q3YWGEKVXZTCB28ZQ",
+      "name": "GameAudioCueOrbital",
+      "pages": [
+        {
+          "id": "pag_01M1M6XD9Q4H97NNA0WX368CHA",
+          "name": "GameAudioCuePage",
+          "path": "/game-audio-cue",
+          "traits": [
+            {
+              "ref": "GameAudioCueRender",
+              "refId": "trt_01M1M6XD9QYB8Y5A3RVE2R6A4Z"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "baseUrl": {
+              "description": "Base URL prepended to every manifest path.",
+              "label": "Base Url",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "cue": {
+              "description": "Manifest key played as a one-shot SFX each time `cueSeq` advances.",
+              "label": "Cue",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "cueSeq": {
+              "description": "Monotonically increasing counter — bumping it re-triggers `cue`.",
+              "label": "Cue Seq",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "manifest": {
+              "default": {},
+              "description": "Sound manifest — keys mapped to sound definitions (path, volume, loop, ...).",
+              "items": {
+                "properties": {
+                  "autostart": {
+                    "name": "autostart",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "crossfade": {
+                    "name": "crossfade",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "crossfadeDurationMs": {
+                    "name": "crossfadeDurationMs",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "loop": {
+                    "name": "loop",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "path": {
+                    "name": "path",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "poolSize": {
+                    "name": "poolSize",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "volume": {
+                    "name": "volume",
+                    "required": false,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Manifest",
+              "tier": "presentation",
+              "type": "Map<string,GameAudioCueManifestValue>"
+            },
+            "music": {
+              "description": "Manifest key to crossfade to as looping background music; unset/empty stops music.",
+              "label": "Music",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "muted": {
+              "description": "Muted state, owned externally and mirrored into the hook.",
+              "label": "Muted",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "volume": {
+              "description": "Master volume 0-1, owned externally and mirrored into the hook.",
+              "label": "Volume",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "GameAudioCueItem": "ent_01M1M6XD9Q0XN6S9N4DB4JK5DR"
+          },
+          "id": "trt_01M1M6XD9QYB8Y5A3RVE2R6A4Z",
+          "linkedEntity": "GameAudioCueItem",
+          "linkedEntityId": "ent_01M1M6XD9Q0XN6S9N4DB4JK5DR",
+          "name": "GameAudioCueRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M1M6XD9Q63KRQBAT3KWGAXK0",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "baseUrl": "@config.baseUrl",
+                      "cue": "@config.cue",
+                      "cueSeq": "@config.cueSeq",
+                      "manifest": "@config.manifest",
+                      "music": "@config.music",
+                      "muted": "@config.muted",
+                      "type": "game-audio-cue",
+                      "volume": "@config.volume"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M1M6XD9Q63KRQBAT3KWGAXK0",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "GameAudioCueManifestValue": [
+          {
+            "name": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "volume",
+            "type": "number"
+          },
+          {
+            "name": "loop",
+            "type": "boolean"
+          },
+          {
+            "name": "poolSize",
+            "type": "number"
+          },
+          {
+            "name": "autostart",
+            "type": "boolean"
+          },
+          {
+            "name": "crossfade",
+            "type": "boolean"
+          },
+          {
+            "name": "crossfadeDurationMs",
+            "type": "number"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/game/atoms/ui-game-audio-toggle.orb

@@ -19,6 +19,15 @@
         "parent": "trt_01KXG04V0MA4JSNNM3Q62KJSD9",
         "renames": []
       },
+      "evt_01M1M6SDZB7KSZHMVGHKYN2GKZ": {
+        "bakedName": "@config.toggleEvent",
+        "curName": "@config.toggleEvent",
+        "id": "evt_01M1M6SDZB7KSZHMVGHKYN2GKZ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04V0MA4JSNNM3Q62KJSD9",
+        "renames": []
+      },
       "orb_01KXG04V0MFKPFF4JATTZWY52G": {
         "bakedName": "GameAudioToggleOrbital",
         "curName": "GameAudioToggleOrbital",
@@ -307,8 +316,32 @@
                 "md",
                 "lg"
               ]
+            },
+            "toggleEvent": {
+              "default": "TOGGLE",
+              "description": "Event dispatched via event bus on toggle, carrying the new muted state.",
+              "label": "Toggle Event",
+              "tier": "presentation",
+              "type": "event"
             }
           },
+          "emits": [
+            {
+              "definerKnob": "toggleEvent",
+              "description": "Event dispatched via event bus on toggle, carrying the new muted state.",
+              "event": "@config.toggleEvent",
+              "eventId": "evt_01M1M6SDZB7KSZHMVGHKYN2GKZ",
+              "payloadSchema": [
+                {
+                  "name": "muted",
+                  "required": true,
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
             "provides": [],
             "requires": []
@@ -328,6 +361,20 @@
                 "id": "evt_01KXG04V0MCG8VV4QQQH3VB2H6",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "description": "Event dispatched via event bus on toggle, carrying the new muted state.",
+                "id": "evt_01M1M6SDZB7KSZHMVGHKYN2GKZ",
+                "key": "@config.toggleEvent",
+                "name": "@config.toggle event",
+                "payloadSchema": [
+                  {
+                    "name": "muted",
+                    "required": true,
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -349,6 +396,7 @@
                       "offAsset": "@config.offAsset",
                       "onAsset": "@config.onAsset",
                       "size": "@config.size",
+                      "toggleEvent": "@config.toggleEvent",
                       "type": "game-audio-toggle"
                     }
                   ]

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

@@ -1048,7 +1048,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "HeroAuthority",
-          "ref": "Nav.traits.HeroNav"
+          "ref": "Nav.traits.HeroNav",
+          "refId": "trt_01KXG04TJB91GE3PMCMF5EBAQX"
         },
         {
           "config": {
@@ -1077,7 +1078,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "PlayEconomy",
-          "ref": "Play.traits.ArcadePlay"
+          "ref": "Play.traits.ArcadePlay",
+          "refId": "trt_01KXG04TEBZRV5QJMA8KCC6X36"
         },
         {
           "config": {
@@ -1090,7 +1092,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "FxDecay",
-          "ref": "Particles.traits.FxParticles"
+          "ref": "Particles.traits.FxParticles",
+          "refId": "trt_01KXG04TFZQZVT3F7J3DTM2PXF"
         },
         {
           "config": {
@@ -1107,7 +1110,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPJVFMCX8W7J3V8B4GWF",
           "name": "RoundGate",
-          "ref": "Gate.traits.ArcadeFlow"
+          "ref": "Gate.traits.ArcadeFlow",
+          "refId": "trt_01KXG04TDX1HTTKS1GM6Q2593N"
         },
         {
           "category": "interaction",

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

@@ -836,7 +836,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPMKGAH9E4TGTCT7ZSJJ",
           "name": "CrewAuthority",
-          "ref": "Nav.traits.HeroNav"
+          "ref": "Nav.traits.HeroNav",
+          "refId": "trt_01KXG04TJB91GE3PMCMF5EBAQX"
         },
         {
           "config": {
@@ -849,7 +850,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPMKGAH9E4TGTCT7ZSJJ",
           "name": "FxDecay",
-          "ref": "Particles.traits.FxParticles"
+          "ref": "Particles.traits.FxParticles",
+          "refId": "trt_01KXG04TFZQZVT3F7J3DTM2PXF"
         },
         {
           "config": {
@@ -862,7 +864,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPMKGAH9E4TGTCT7ZSJJ",
           "name": "AnimClock",
-          "ref": "AnimTick.traits.AnimTick"
+          "ref": "AnimTick.traits.AnimTick",
+          "refId": "trt_01KXG04EVEQNTAB0NYX7ZC392F"
         },
         {
           "category": "interaction",

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

@@ -1733,7 +1733,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPPE3ESMZV57C91BH7S7",
           "name": "HeroAuthority",
-          "ref": "Nav.traits.HeroNav"
+          "ref": "Nav.traits.HeroNav",
+          "refId": "trt_01KXG04TJB91GE3PMCMF5EBAQX"
         },
         {
           "config": {
@@ -1802,7 +1803,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPPE3ESMZV57C91BH7S7",
           "name": "Enemies",
-          "ref": "Combat.traits.DungeonCombat"
+          "ref": "Combat.traits.DungeonCombat",
+          "refId": "trt_01KXG04TFH3K6EPQH6S4EGMMZ8"
         },
         {
           "config": {
@@ -1835,7 +1837,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPPE3ESMZV57C91BH7S7",
           "name": "Collector",
-          "ref": "Objective.traits.ObjectiveReach"
+          "ref": "Objective.traits.ObjectiveReach",
+          "refId": "trt_01KXG04TKVF4P1VR3W6BFJ78NH"
         },
         {
           "config": {
@@ -1848,7 +1851,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPPE3ESMZV57C91BH7S7",
           "name": "FxDecay",
-          "ref": "Particles.traits.FxParticles"
+          "ref": "Particles.traits.FxParticles",
+          "refId": "trt_01KXG04TFZQZVT3F7J3DTM2PXF"
         },
         {
           "config": {
@@ -1861,7 +1865,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPPE3ESMZV57C91BH7S7",
           "name": "RoundGate",
-          "ref": "Gate.traits.ObjectiveFlow"
+          "ref": "Gate.traits.ObjectiveFlow",
+          "refId": "trt_01KXG04TKBC6DPS2TWD1P0Z0K5"
         },
         {
           "category": "interaction",

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

@@ -1553,7 +1553,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPRJ0BSXSD77Y18WTTHD",
           "name": "HeroAuthority",
-          "ref": "Nav.traits.HeroNav"
+          "ref": "Nav.traits.HeroNav",
+          "refId": "trt_01KXG04TJB91GE3PMCMF5EBAQX"
         },
         {
           "config": {
@@ -1602,7 +1603,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPRJ0BSXSD77Y18WTTHD",
           "name": "Patience",
-          "ref": "Svc.traits.Patience"
+          "ref": "Svc.traits.Patience",
+          "refId": "trt_01KXG04TMD0MRDA57C85WD13VD"
         },
         {
           "config": {
@@ -1615,7 +1617,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPRJ0BSXSD77Y18WTTHD",
           "name": "FxDecay",
-          "ref": "Particles.traits.FxParticles"
+          "ref": "Particles.traits.FxParticles",
+          "refId": "trt_01KXG04TFZQZVT3F7J3DTM2PXF"
         },
         {
           "config": {
@@ -1636,7 +1639,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01M055GPRJ0BSXSD77Y18WTTHD",
           "name": "RoundGate",
-          "ref": "Flow.traits.MarketFlow"
+          "ref": "Flow.traits.MarketFlow",
+          "refId": "trt_01KXG04TJW9DXPV5MNGPMXCSRA"
         },
         {
           "category": "interaction",