@almadar/std 16.201.0 → 16.202.0

package/behaviors/registry/ui/core/molecules/ui-floating-toolbar.orb

@@ -100,7 +100,8 @@
                   "disabled": false,
                   "icon": "circle",
                   "id": "Id",
-                  "label": "Label"
+                  "label": "Label",
+                  "testId": "Test Id"
                 },
                 {
                   "action": "Action 2",
@@ -108,7 +109,8 @@
                   "disabled": true,
                   "icon": "circle",
                   "id": "Id 2",
-                  "label": "Label 2"
+                  "label": "Label 2",
+                  "testId": "Test Id 2"
                 }
               ],
               "description": "Tool items rendered as icon buttons",
@@ -156,6 +158,11 @@
                     "name": "label",
                     "required": true,
                     "type": "string"
+                  },
+                  "testId": {
+                    "name": "testId",
+                    "required": false,
+                    "type": "string"
                   }
                 },
                 "type": "object"
@@ -264,6 +271,10 @@
           {
             "name": "disabled",
             "type": "boolean"
+          },
+          {
+            "name": "testId",
+            "type": "string"
           }
         ]
       }

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

@@ -0,0 +1,653 @@
+{
+  "description": "Headless-ish sound driver: the SOLE writer of cue/cueSeq/music/muted/volume, rendered through the game-audio-cue atom which mounts @almadar/ui's useGameAudio hook. Intents: CUE plays a one-shot SFX by manifest key (cueSeq increments so the same key can re-fire), MUSIC crossfades to a looping track by key, STOP_MUSIC fades it out, MUTE/UNMUTE/TOGGLE_MUTE flip playback and emit AUDIO_MUTED, SET_VOLUME sets master volume, RESTART reseeds from config. The manifest and baseUrl are config, not runtime state — swap them per game by rebinding this atom's config, never by hand-authoring a second audio layer.",
+  "ledger": {
+    "entries": {
+      "ent_01M1M6SDR1VN17FB43KGGYTXVH": {
+        "bakedName": "AudioState",
+        "curName": "AudioState",
+        "id": "ent_01M1M6SDR1VN17FB43KGGYTXVH",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M1M6SDR1825KS9GDK1GM6AX8": {
+        "bakedName": "SET_VOLUME",
+        "curName": "SET_VOLUME",
+        "id": "evt_01M1M6SDR1825KS9GDK1GM6AX8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1EKH269A77DW30YAT": {
+        "bakedName": "AUDIO_MUTED",
+        "curName": "AUDIO_MUTED",
+        "id": "evt_01M1M6SDR1EKH269A77DW30YAT",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1HS1H8QBV1HSFT1YY": {
+        "bakedName": "RESTART",
+        "curName": "RESTART",
+        "id": "evt_01M1M6SDR1HS1H8QBV1HSFT1YY",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1JZYH3CMHHCK2KNYM": {
+        "bakedName": "UNMUTE",
+        "curName": "UNMUTE",
+        "id": "evt_01M1M6SDR1JZYH3CMHHCK2KNYM",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1NY7S30XE4E1BV5TR": {
+        "bakedName": "TOGGLE_MUTE",
+        "curName": "TOGGLE_MUTE",
+        "id": "evt_01M1M6SDR1NY7S30XE4E1BV5TR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1P7929V9054ET6B9F": {
+        "bakedName": "CUE",
+        "curName": "CUE",
+        "id": "evt_01M1M6SDR1P7929V9054ET6B9F",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1PPFZ93F2SB68MCS2": {
+        "bakedName": "MUTE",
+        "curName": "MUTE",
+        "id": "evt_01M1M6SDR1PPFZ93F2SB68MCS2",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1PXHSQVVVQTTAE63K": {
+        "bakedName": "STOP_MUSIC",
+        "curName": "STOP_MUSIC",
+        "id": "evt_01M1M6SDR1PXHSQVVVQTTAE63K",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1XEYZMNRM1AGWSKWM": {
+        "bakedName": "MUSIC",
+        "curName": "MUSIC",
+        "id": "evt_01M1M6SDR1XEYZMNRM1AGWSKWM",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "evt_01M1M6SDR1YMP6C6YHG2E1VFGP": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M1M6SDR1YMP6C6YHG2E1VFGP",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "renames": []
+      },
+      "orb_01M1M6SDR1QN5S7HECR8C736YS": {
+        "bakedName": "AudioCueOrbital",
+        "curName": "AudioCueOrbital",
+        "id": "orb_01M1M6SDR1QN5S7HECR8C736YS",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M1M6SDR1ES3AJ842RWKX449Z": {
+        "bakedName": "AudioCuePage",
+        "curName": "AudioCuePage",
+        "id": "pag_01M1M6SDR1ES3AJ842RWKX449Z",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M1M6SDR1WFKAGWXR797EQYMY": {
+        "bakedName": "AudioCue",
+        "curName": "AudioCue",
+        "id": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-audio-cue",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "",
+            "name": "cue",
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "name": "cueSeq",
+            "type": "number"
+          },
+          {
+            "default": "",
+            "name": "music",
+            "type": "string"
+          },
+          {
+            "default": false,
+            "name": "muted",
+            "type": "boolean"
+          },
+          {
+            "default": 1.0,
+            "name": "volume",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01M1M6SDR1VN17FB43KGGYTXVH",
+        "name": "AudioState",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M1M6SDR1QN5S7HECR8C736YS",
+      "name": "AudioCueOrbital",
+      "pages": [
+        {
+          "id": "pag_01M1M6SDR1ES3AJ842RWKX449Z",
+          "name": "AudioCuePage",
+          "path": "/audio-cue",
+          "traits": [
+            {
+              "ref": "AudioCue",
+              "refId": "trt_01M1M6SDR1WFKAGWXR797EQYMY"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "baseUrl": {
+              "default": "",
+              "description": "Prefix prepended to every manifest path.",
+              "label": "Base Url",
+              "tier": "infra",
+              "type": "string"
+            },
+            "initialMusic": {
+              "default": "",
+              "description": "Manifest key auto-played as looping music on INIT/RESTART; empty plays none.",
+              "label": "Initial Music",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "initialMuted": {
+              "default": false,
+              "description": "Muted state seeded on INIT/RESTART.",
+              "label": "Initial Muted",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "initialVolume": {
+              "default": 1.0,
+              "description": "Master volume 0-1 seeded on INIT/RESTART.",
+              "label": "Initial Volume",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "manifest": {
+              "default": {},
+              "description": "Sound definitions keyed by logical name — path(s), volume, loop, pooling, autostart, crossfade.",
+              "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": false,
+                    "type": "string"
+                  },
+                  "poolSize": {
+                    "name": "poolSize",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "volume": {
+                    "name": "volume",
+                    "required": false,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Manifest",
+              "tier": "domain",
+              "type": "Map<string,SoundEntry>"
+            }
+          },
+          "emits": [
+            {
+              "description": "Mute state changed via MUTE/UNMUTE/TOGGLE_MUTE.",
+              "event": "AUDIO_MUTED",
+              "eventId": "evt_01M1M6SDR1EKH269A77DW30YAT",
+              "payloadSchema": [
+                {
+                  "name": "muted",
+                  "required": true,
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "mute-changed, sound-toggled",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "cue",
+              "cueSeq",
+              "music",
+              "muted",
+              "volume"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "AudioState": "ent_01M1M6SDR1VN17FB43KGGYTXVH"
+          },
+          "id": "trt_01M1M6SDR1WFKAGWXR797EQYMY",
+          "linkedEntity": "AudioState",
+          "linkedEntityId": "ent_01M1M6SDR1VN17FB43KGGYTXVH",
+          "name": "AudioCue",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M1M6SDR1YMP6C6YHG2E1VFGP",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Play a one-shot SFX by manifest key; re-fires even when key repeats.",
+                "id": "evt_01M1M6SDR1P7929V9054ET6B9F",
+                "key": "CUE",
+                "name": "Cue",
+                "payloadSchema": [
+                  {
+                    "name": "key",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "description": "Crossfade to a looping background track by manifest key.",
+                "id": "evt_01M1M6SDR1XEYZMNRM1AGWSKWM",
+                "key": "MUSIC",
+                "name": "Music",
+                "payloadSchema": [
+                  {
+                    "name": "key",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "description": "Fade out and stop the current music.",
+                "id": "evt_01M1M6SDR1PXHSQVVVQTTAE63K",
+                "key": "STOP_MUSIC",
+                "name": "Stop Music",
+                "tier": "domain"
+              },
+              {
+                "description": "Mute all playback.",
+                "id": "evt_01M1M6SDR1PPFZ93F2SB68MCS2",
+                "key": "MUTE",
+                "name": "Mute",
+                "tier": "domain"
+              },
+              {
+                "description": "Unmute playback.",
+                "id": "evt_01M1M6SDR1JZYH3CMHHCK2KNYM",
+                "key": "UNMUTE",
+                "name": "Unmute",
+                "tier": "domain"
+              },
+              {
+                "description": "Flip the current mute state.",
+                "id": "evt_01M1M6SDR1NY7S30XE4E1BV5TR",
+                "key": "TOGGLE_MUTE",
+                "name": "Toggle Mute",
+                "tier": "domain"
+              },
+              {
+                "description": "Set master volume 0-1.",
+                "id": "evt_01M1M6SDR1825KS9GDK1GM6AX8",
+                "key": "SET_VOLUME",
+                "name": "Set Volume",
+                "payloadSchema": [
+                  {
+                    "name": "volume",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "description": "Reseed cue/music/muted/volume from config.",
+                "id": "evt_01M1M6SDR1HS1H8QBV1HSFT1YY",
+                "key": "RESTART",
+                "name": "Restart",
+                "tier": "domain"
+              },
+              {
+                "description": "Mute state changed via MUTE/UNMUTE/TOGGLE_MUTE.",
+                "id": "evt_01M1M6SDR1EKH269A77DW30YAT",
+                "key": "AUDIO_MUTED",
+                "name": "Audio Muted",
+                "payloadSchema": [
+                  {
+                    "name": "muted",
+                    "required": true,
+                    "type": "boolean"
+                  }
+                ],
+                "synonyms": "mute-changed, sound-toggled",
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "active"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.cue",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.cueSeq",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.music",
+                    "@config.initialMusic"
+                  ],
+                  [
+                    "set",
+                    "@entity.muted",
+                    "@config.initialMuted"
+                  ],
+                  [
+                    "set",
+                    "@entity.volume",
+                    "@config.initialVolume"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "baseUrl": "@config.baseUrl",
+                      "cue": "@entity.cue",
+                      "cueSeq": "@entity.cueSeq",
+                      "manifest": "@config.manifest",
+                      "music": "@entity.music",
+                      "muted": "@entity.muted",
+                      "type": "game-audio-cue",
+                      "volume": "@entity.volume"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M1M6SDR1YMP6C6YHG2E1VFGP",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.cue",
+                    "@payload.key"
+                  ],
+                  [
+                    "set",
+                    "@entity.cueSeq",
+                    [
+                      "+",
+                      "@entity.cueSeq",
+                      1.0
+                    ]
+                  ]
+                ],
+                "event": "CUE",
+                "eventId": "evt_01M1M6SDR1P7929V9054ET6B9F",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.music",
+                    "@payload.key"
+                  ]
+                ],
+                "event": "MUSIC",
+                "eventId": "evt_01M1M6SDR1XEYZMNRM1AGWSKWM",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.music",
+                    ""
+                  ]
+                ],
+                "event": "STOP_MUSIC",
+                "eventId": "evt_01M1M6SDR1PXHSQVVVQTTAE63K",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.muted",
+                    true
+                  ],
+                  [
+                    "emit",
+                    "AUDIO_MUTED",
+                    {
+                      "muted": true
+                    }
+                  ]
+                ],
+                "event": "MUTE",
+                "eventId": "evt_01M1M6SDR1PPFZ93F2SB68MCS2",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.muted",
+                    false
+                  ],
+                  [
+                    "emit",
+                    "AUDIO_MUTED",
+                    {
+                      "muted": false
+                    }
+                  ]
+                ],
+                "event": "UNMUTE",
+                "eventId": "evt_01M1M6SDR1JZYH3CMHHCK2KNYM",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.muted",
+                    [
+                      "not",
+                      "@entity.muted"
+                    ]
+                  ],
+                  [
+                    "emit",
+                    "AUDIO_MUTED",
+                    {
+                      "muted": "@entity.muted"
+                    }
+                  ]
+                ],
+                "event": "TOGGLE_MUTE",
+                "eventId": "evt_01M1M6SDR1NY7S30XE4E1BV5TR",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.volume",
+                    "@payload.volume"
+                  ]
+                ],
+                "event": "SET_VOLUME",
+                "eventId": "evt_01M1M6SDR1825KS9GDK1GM6AX8",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.cue",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.cueSeq",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.music",
+                    "@config.initialMusic"
+                  ],
+                  [
+                    "set",
+                    "@entity.muted",
+                    "@config.initialMuted"
+                  ],
+                  [
+                    "set",
+                    "@entity.volume",
+                    "@config.initialVolume"
+                  ]
+                ],
+                "event": "RESTART",
+                "eventId": "evt_01M1M6SDR1HS1H8QBV1HSFT1YY",
+                "from": "active",
+                "to": "active"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "SoundEntry": [
+          {
+            "name": "path",
+            "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"
+}