@almadar/std 16.201.0 → 16.202.0

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

@@ -55,6 +55,24 @@
         "parent": "trt_01M055GNYNDBSMRP68BDSWWFFG",
         "renames": []
       },
+      "evt_01M1M6SDSA6W1GZA9YZJR17DHX": {
+        "bakedName": "@config.onSelect",
+        "curName": "@config.onSelect",
+        "id": "evt_01M1M6SDSA6W1GZA9YZJR17DHX",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M055GNYNDBSMRP68BDSWWFFG",
+        "renames": []
+      },
+      "evt_01M1M6SDSAXEXSM691C4WD5WP1": {
+        "bakedName": "@config.onMove",
+        "curName": "@config.onMove",
+        "id": "evt_01M1M6SDSAXEXSM691C4WD5WP1",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M055GNYNDBSMRP68BDSWWFFG",
+        "renames": []
+      },
       "orb_01M055GNYNB72EY2C3M49826C0": {
         "bakedName": "Canvas2dOrbital",
         "curName": "Canvas2dOrbital",
@@ -185,6 +203,13 @@
               "tier": "presentation",
               "type": "[node]"
             },
+            "editable": {
+              "default": false,
+              "description": "--- Scene-edit mode (a game studio selecting/dragging drawables). Purely",
+              "label": "Editable",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "error": {
               "description": "Error state",
               "label": "Error",
@@ -274,6 +299,27 @@
               "tier": "presentation",
               "type": "Map<string,string>"
             },
+            "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"
+            },
             "projection": {
               "default": "isometric",
               "description": "--- Projection ---",
@@ -295,6 +341,19 @@
               "tier": "presentation",
               "type": "number"
             },
+            "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"
+            },
             "showMinimap": {
               "default": true,
               "description": "Toggle minimap overlay.",
@@ -400,6 +459,42 @@
               "eventId": "evt_01M055GNYPQZ509HNQSND656XT",
               "scope": "external",
               "tier": "essential"
+            },
+            {
+              "definerKnob": "onSelect",
+              "description": "Fired on a click that changes selection — before `selectEvent`.",
+              "event": "@config.onSelect",
+              "eventId": "evt_01M1M6SDSA6W1GZA9YZJR17DHX",
+              "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_01M1M6SDSAXEXSM691C4WD5WP1",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "x",
+                  "type": "number"
+                },
+                {
+                  "name": "y",
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
             }
           ],
           "entityContract": {
@@ -480,6 +575,40 @@
                 "key": "@config.tileLeaveEvent",
                 "name": "@config.tile leave event",
                 "tier": "essential"
+              },
+              {
+                "description": "Fired on a click that changes selection — before `selectEvent`.",
+                "id": "evt_01M1M6SDSA6W1GZA9YZJR17DHX",
+                "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_01M1M6SDSAXEXSM691C4WD5WP1",
+                "key": "@config.onMove",
+                "name": "@config.on move",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  },
+                  {
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "type": "number"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -502,14 +631,20 @@
                       "children": "@config.children",
                       "className": "@config.className",
                       "drawables": "@config.drawables",
+                      "editable": "@config.editable",
                       "error": "@config.error",
                       "fit": "@config.fit",
                       "followTarget": "@config.followTarget",
                       "isLoading": "@config.isLoading",
                       "keyMap": "@config.keyMap",
                       "keyUpMap": "@config.keyUpMap",
+                      "moveEvent": "@config.moveEvent",
+                      "onMove": "@config.onMove",
+                      "onSelect": "@config.onSelect",
                       "projection": "@config.projection",
                       "scale": "@config.scale",
+                      "selectEvent": "@config.selectEvent",
+                      "selectedId": "@config.selectedId",
                       "showMinimap": "@config.showMinimap",
                       "tileClickEvent": "@config.tileClickEvent",
                       "tileHoverEvent": "@config.tileHoverEvent",

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"
+}