@almadar/std 16.201.0 → 16.202.0

package/behaviors/lolo/ui/core/molecules/ui-command-palette.lolo

@@ -0,0 +1,116 @@
+app ui-command-palette "1.0.0"
+"CommandPalette — UI factory (1:1 with the @almadar/ui command-palette pattern)."
+orbital CommandPaletteOrbital {
+  type CommandPaletteCommandsItem = {
+    id : string!
+    label : string!
+    icon : icon
+    shortcut : string
+    keywords : [string]
+    group : string
+    disabled : boolean
+    event : string
+    action : string
+    actionPayload : Map string scalar
+  }
+  type CommandPaletteSELECTCommand = {
+    id : string!
+    label : string!
+    icon : icon
+    shortcut : string
+    keywords : [string]
+    group : string
+    disabled : boolean
+    event : string
+    action : string
+    actionPayload : Map string scalar
+  }
+
+  entity CommandPaletteItem [runtime] {
+    id : string!
+    open : boolean = false
+  }
+
+  trait CommandPaletteRender -> @rebindable CommandPaletteItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (set @entity.open @config.open)
+        (render-ui main {
+          open: @entity.open
+          onOpenChange: @config.onOpenChange
+          commands: @config.commands
+          onSelect: @config.onSelect
+          placeholder: @config.placeholder
+          emptyLabel: @config.emptyLabel
+          className: @config.className
+          type: command-palette
+        })
+      OPEN_CHANGE -> idle
+        (set @entity.open ?open)
+        (render-ui main {
+          open: @entity.open
+          onOpenChange: @config.onOpenChange
+          commands: @config.commands
+          onSelect: @config.onSelect
+          placeholder: @config.placeholder
+          emptyLabel: @config.emptyLabel
+          className: @config.className
+          type: command-palette
+        })
+    }
+
+    emits {
+      @config.onOpenChange -> external {
+        open : boolean
+      }
+        @description "Called to open/close the overlay (Escape, overlay click, or a selection)"
+        @tier "essential"
+      @config.onSelect -> external {
+        command : CommandPaletteSELECTCommand
+      }
+        @description "Called with the selected command (click, or Enter on the highlighted row)"
+        @tier "essential"
+    }
+
+    listens {
+      OPEN_CHANGE {
+        open : boolean
+      }
+    }
+
+    config {
+      open : boolean = false
+        @label "Open"
+        @description "Whether the palette overlay is open"
+        @tier "presentation"
+      onOpenChange : event = "OPEN_CHANGE"
+        @label "On Open Change"
+        @description "Called to open/close the overlay (Escape, overlay click, or a selection)"
+        @tier "presentation"
+      commands : [CommandPaletteCommandsItem] = [{ id: "Id", label: "Label", icon: "circle", shortcut: "Shortcut", keywords: ["Item", "Item 2"], group: "Group", disabled: false, action: "Action" }, { id: "Id 2", label: "Label 2", icon: "circle", shortcut: "Shortcut 2", keywords: ["Item", "Item 2"], group: "Group 2", disabled: true, action: "Action 2" }]
+        @label "Commands"
+        @description "Commands listed in the palette, filtered as the user types"
+        @tier "presentation"
+      onSelect : event = "SELECT"
+        @label "On Select"
+        @description "Called with the selected command (click, or Enter on the highlighted row)"
+        @tier "presentation"
+      placeholder : string = "Type a command..."
+        @label "Placeholder"
+        @description "Search field placeholder. Consumers own i18n — plain string prop, no package-internal translation (matches FloatingToolbar's convention)."
+        @tier "presentation"
+      emptyLabel : string = "No matching commands"
+        @label "Empty Label"
+        @description "Label shown when no command matches the query"
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "Additional CSS classes on the overlay's dialog"
+        @tier "presentation"
+    }
+  }
+
+  page "/command-palette" as CommandPalettePage -> CommandPaletteRender
+}

package/behaviors/lolo/ui/core/molecules/ui-floating-toolbar.lolo

@@ -10,6 +10,7 @@ orbital FloatingToolbarOrbital {
     actionPayload : Map string scalar
     active : boolean
     disabled : boolean
+    testId : string
   }
 
   entity FloatingToolbarItem [runtime] {
@@ -31,7 +32,7 @@ orbital FloatingToolbarOrbital {
     }
 
     config {
-      items : [FloatingToolbarItemsItem] = [{ id: "Id", icon: "circle", label: "Label", action: "Action", active: false, disabled: false }, { id: "Id 2", icon: "circle", label: "Label 2", action: "Action 2", active: true, disabled: true }]
+      items : [FloatingToolbarItemsItem] = [{ id: "Id", icon: "circle", label: "Label", action: "Action", active: false, disabled: false, testId: "Test Id" }, { id: "Id 2", icon: "circle", label: "Label 2", action: "Action 2", active: true, disabled: true, testId: "Test Id 2" }]
         @label "Items"
         @description "Tool items rendered as icon buttons"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/std-audio-cue.lolo

@@ -0,0 +1,138 @@
+app std-audio-cue "1.0.0"
+"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."
+orbital AudioCueOrbital {
+  type SoundEntry = {
+    path : string
+    volume : number
+    loop : boolean
+    poolSize : number
+    autostart : boolean
+    crossfade : boolean
+    crossfadeDurationMs : number
+  }
+
+  entity AudioState [runtime, shared] {
+    id : string!
+    cue : string = ""
+    cueSeq : number = 0
+    music : string = ""
+    muted : boolean = false
+    volume : number = 1
+  }
+
+  trait AudioCue -> @rebindable AudioState [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.cue "")
+        (set @entity.cueSeq 0)
+        (set @entity.music @config.initialMusic)
+        (set @entity.muted @config.initialMuted)
+        (set @entity.volume @config.initialVolume)
+        (render-ui main {
+          cue: @entity.cue
+          cueSeq: @entity.cueSeq
+          music: @entity.music
+          muted: @entity.muted
+          volume: @entity.volume
+          manifest: @config.manifest
+          baseUrl: @config.baseUrl
+          type: game-audio-cue
+        })
+
+      CUE -> active
+        (set @entity.cue ?key)
+        (set @entity.cueSeq (+ @entity.cueSeq 1))
+
+      MUSIC -> active
+        (set @entity.music ?key)
+
+      STOP_MUSIC -> active
+        (set @entity.music "")
+
+      MUTE -> active
+        (set @entity.muted true)
+        (emit AUDIO_MUTED { muted: true })
+
+      UNMUTE -> active
+        (set @entity.muted false)
+        (emit AUDIO_MUTED { muted: false })
+
+      TOGGLE_MUTE -> active
+        (set @entity.muted (not @entity.muted))
+        (emit AUDIO_MUTED { muted: @entity.muted })
+
+      SET_VOLUME -> active
+        (set @entity.volume ?volume)
+
+      RESTART -> active
+        (set @entity.cue "")
+        (set @entity.cueSeq 0)
+        (set @entity.music @config.initialMusic)
+        (set @entity.muted @config.initialMuted)
+        (set @entity.volume @config.initialVolume)
+    }
+
+    emits {
+      AUDIO_MUTED -> external {
+        muted : boolean!
+      }
+        @description "Mute state changed via MUTE/UNMUTE/TOGGLE_MUTE."
+        @synonyms "mute-changed, sound-toggled"
+        @tier "domain"
+    }
+
+    listens {
+      CUE { key : string! }
+        @description "Play a one-shot SFX by manifest key; re-fires even when key repeats."
+        @tier "domain"
+      MUSIC { key : string! }
+        @description "Crossfade to a looping background track by manifest key."
+        @tier "domain"
+      STOP_MUSIC
+        @description "Fade out and stop the current music."
+        @tier "domain"
+      MUTE
+        @description "Mute all playback."
+        @tier "domain"
+      UNMUTE
+        @description "Unmute playback."
+        @tier "domain"
+      TOGGLE_MUTE
+        @description "Flip the current mute state."
+        @tier "domain"
+      SET_VOLUME { volume : number! }
+        @description "Set master volume 0-1."
+        @tier "domain"
+      RESTART
+        @description "Reseed cue/music/muted/volume from config."
+        @tier "domain"
+    }
+
+    config {
+      manifest : Map string SoundEntry = {}
+        @label "Manifest"
+        @description "Sound definitions keyed by logical name — path(s), volume, loop, pooling, autostart, crossfade."
+        @tier "domain"
+      baseUrl : string = ""
+        @label "Base Url"
+        @description "Prefix prepended to every manifest path."
+        @tier "infra"
+      initialMuted : boolean = false
+        @label "Initial Muted"
+        @description "Muted state seeded on INIT/RESTART."
+        @tier "presentation"
+      initialVolume : number = 1
+        @label "Initial Volume"
+        @description "Master volume 0-1 seeded on INIT/RESTART."
+        @tier "presentation"
+      initialMusic : string = ""
+        @label "Initial Music"
+        @description "Manifest key auto-played as looping music on INIT/RESTART; empty plays none."
+        @tier "presentation"
+    }
+  }
+
+  page "/audio-cue" as AudioCuePage -> AudioCue
+}

package/behaviors/lolo/ui/game/atoms/std-camera-rig.lolo

@@ -0,0 +1,158 @@
+app std-camera-rig "1.0.0"
+"Headless camera authority: the SOLE writer of camX/camY/camZoom on side-view and top-down boards. Every 33ms camera tick it eases camX/camY toward (camTargetX + camLead, camTargetY) — a dead-zone camera: inside deadzoneX/deadzoneY the axis holds, outside it lerps by stiffness — clamps the result to bounds, eases camZoom toward camTargetZoom the same way, and decays camShake toward 0 by shakeDecay. Intents: FOLLOW retargets from a moving body's x/y/vx (vx feeds camLead, the horizontal look-ahead), CUT snaps position+target instantly (no ease, for teleports/cutscenes), SET_ZOOM retargets zoom (clamped to minZoom/maxZoom), SHAKE sets camShake for a consumer to jitter with at bind time — this atom never writes shake into camX/camY itself, RESTART reseeds from config. Emits CAMERA_MOVED every tick. Renders nothing — a board binds its own canvas camera prop straight to camX/camY/camZoom."
+orbital CameraRigOrbital {
+  type CameraPos = {
+    x : number!
+    y : number!
+  }
+  type CameraBounds = {
+    xMin : number!
+    xMax : number!
+    yMin : number!
+    yMax : number!
+  }
+
+  entity CameraState [runtime, shared] {
+    id : string!
+    camX : number = 0
+    camY : number = 0
+    camZoom : number = 1
+    camTargetX : number = 0
+    camTargetY : number = 0
+    camTargetZoom : number = 1
+    camLead : number = 0
+    camShake : number = 0
+  }
+
+  trait CameraRig -> @rebindable CameraState [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.camX @config.start.x)
+        (set @entity.camY @config.start.y)
+        (set @entity.camZoom @config.zoom)
+        (set @entity.camTargetX @config.start.x)
+        (set @entity.camTargetY @config.start.y)
+        (set @entity.camTargetZoom @config.zoom)
+        (set @entity.camLead 0)
+        (set @entity.camShake 0)
+
+      FOLLOW -> active
+        (set @entity.camTargetX ?x)
+        (set @entity.camTargetY ?y)
+        (set @entity.camLead (* ?vx @config.lead))
+
+      CUT -> active
+        (set @entity.camX ?x)
+        (set @entity.camY ?y)
+        (set @entity.camTargetX ?x)
+        (set @entity.camTargetY ?y)
+        (set @entity.camLead 0)
+
+      SET_ZOOM -> active
+        (set @entity.camTargetZoom (math/clamp ?zoom @config.minZoom @config.maxZoom))
+
+      SHAKE -> active
+        (set @entity.camShake ?magnitude)
+
+      RESTART -> active
+        (set @entity.camX @config.start.x)
+        (set @entity.camY @config.start.y)
+        (set @entity.camZoom @config.zoom)
+        (set @entity.camTargetX @config.start.x)
+        (set @entity.camTargetY @config.start.y)
+        (set @entity.camTargetZoom @config.zoom)
+        (set @entity.camLead 0)
+        (set @entity.camShake 0)
+    }
+
+    ticks {
+      camTick every 33ms
+        when @config.running
+        (do
+          (set @entity.camX (math/clamp (if (> (math/abs (- (+ @entity.camTargetX @entity.camLead) @entity.camX)) @config.deadzoneX) (math/lerp @entity.camX (+ @entity.camTargetX @entity.camLead) @config.stiffness) @entity.camX) @config.bounds.xMin @config.bounds.xMax))
+          (set @entity.camY (math/clamp (if (> (math/abs (- @entity.camTargetY @entity.camY)) @config.deadzoneY) (math/lerp @entity.camY @entity.camTargetY @config.stiffness) @entity.camY) @config.bounds.yMin @config.bounds.yMax))
+          (set @entity.camZoom (math/clamp (math/lerp @entity.camZoom @entity.camTargetZoom @config.stiffness) @config.minZoom @config.maxZoom))
+          (set @entity.camShake (math/max 0 (- @entity.camShake @config.shakeDecay))))
+        (emit CAMERA_MOVED { x: @entity.camX, y: @entity.camY, zoom: @entity.camZoom })
+    }
+
+    emits {
+      CAMERA_MOVED -> external {
+        x : number!
+        y : number!
+        zoom : number!
+      }
+        @description "Eased camera position/zoom after this tick."
+        @tier "domain"
+    }
+
+    listens {
+      FOLLOW { x : number!, y : number!, vx : number! }
+        @description "Retarget from a moving body's position and horizontal velocity (vx drives camLead)."
+        @tier "domain"
+      CUT { x : number!, y : number! }
+        @description "Snap position and target instantly, no ease — teleports and cutscenes."
+        @tier "domain"
+      SET_ZOOM { zoom : number! }
+        @description "Retarget zoom, clamped to minZoom/maxZoom."
+        @tier "domain"
+      SHAKE { magnitude : number! }
+        @description "Set camShake; a consumer jitters camX/camY with it at bind time — this atom never writes shake into position."
+        @tier "domain"
+      RESTART
+        @description "Reseed position/zoom/lead/shake from config."
+        @tier "domain"
+    }
+
+    config {
+      running : boolean = true
+        @label "Running"
+        @description "When true the 33ms camera tick eases toward target; toggle to freeze the camera"
+        @tier "domain"
+      start : CameraPos = { x: 0, y: 0 }
+        @label "Start Position"
+        @description "Initial and RESTART camera position/target"
+        @tier "domain"
+      zoom : number = 1
+        @label "Zoom"
+        @description "Initial and RESTART zoom level"
+        @tier "domain"
+      minZoom : number = 0.5
+        @label "Min Zoom"
+        @description "Lower clamp for SET_ZOOM and the eased zoom"
+        @tier "presentation"
+      maxZoom : number = 3
+        @label "Max Zoom"
+        @description "Upper clamp for SET_ZOOM and the eased zoom"
+        @tier "presentation"
+      stiffness : number = 0.1
+        @label "Stiffness"
+        @description "Per-tick lerp factor easing position/zoom toward target (0-1, higher = snappier)"
+        @tier "presentation"
+      deadzoneX : number = 0
+        @label "Dead Zone X"
+        @description "Horizontal distance from target the camera tolerates without easing"
+        @tier "presentation"
+      deadzoneY : number = 0
+        @label "Dead Zone Y"
+        @description "Vertical distance from target the camera tolerates without easing"
+        @tier "presentation"
+      lead : number = 0
+        @label "Lead"
+        @description "Horizontal look-ahead multiplier applied to FOLLOW's vx"
+        @tier "presentation"
+      bounds : CameraBounds = { xMin: -1000000, xMax: 1000000, yMin: -1000000, yMax: 1000000 }
+        @label "Bounds"
+        @description "World-space clamp applied to the eased camera position every tick"
+        @tier "presentation"
+      shakeDecay : number = 0.1
+        @label "Shake Decay"
+        @description "Amount camShake reduces toward 0 every tick"
+        @tier "presentation"
+    }
+  }
+
+  page "/camera-rig" as CameraRigPage -> CameraRig
+}

package/behaviors/lolo/ui/game/atoms/ui-canvas-2d.lolo

@@ -40,6 +40,12 @@ orbital Canvas2dOrbital {
           tileLeaveEvent: @config.tileLeaveEvent
           keyMap: @config.keyMap
           keyUpMap: @config.keyUpMap
+          editable: @config.editable
+          selectedId: @config.selectedId
+          onSelect: @config.onSelect
+          onMove: @config.onMove
+          selectEvent: @config.selectEvent
+          moveEvent: @config.moveEvent
           camera: @config.camera
           scale: @config.scale
           tileWidth: @config.tileWidth
@@ -74,6 +80,18 @@ orbital Canvas2dOrbital {
       @config.tileLeaveEvent -> external { }
         @description "Emits UI:{tileLeaveEvent} with {} on pointer leave."
         @tier "essential"
+      @config.onSelect -> external {
+        id : string
+      }
+        @description "Fired on a click that changes selection — before `selectEvent`."
+        @tier "essential"
+      @config.onMove -> external {
+        id : string
+        x : number
+        y : number
+      }
+        @description "Fired once per drag gesture, on drop — before `moveEvent`."
+        @tier "essential"
     }
 
     config {
@@ -125,6 +143,30 @@ orbital Canvas2dOrbital {
         @label "Key Up Map"
         @description "Maps a keyup `e.code` → the board's SEMANTIC event."
         @tier "presentation"
+      editable : boolean = false
+        @label "Editable"
+        @description "--- Scene-edit mode (a game studio selecting/dragging drawables). Purely"
+        @tier "presentation"
+      selectedId : string
+        @label "Selected Id"
+        @description "The currently-selected drawable id (controlled); `null`/undefined = none."
+        @tier "presentation"
+      onSelect : event = "SELECT"
+        @label "On Select"
+        @description "Fired on a click that changes selection — before `selectEvent`."
+        @tier "presentation"
+      onMove : event = "MOVE"
+        @label "On Move"
+        @description "Fired once per drag gesture, on drop — before `moveEvent`."
+        @tier "presentation"
+      selectEvent : event = "SELECT"
+        @label "Select Event"
+        @description "Declarative selection event, `UI:{selectEvent} { id }`."
+        @tier "presentation"
+      moveEvent : event = "MOVE"
+        @label "Move Event"
+        @description "Declarative move event, `UI:{moveEvent} { id, x, y }` — fired once on drop."
+        @tier "presentation"
       camera : "pan-zoom" | "follow" | "fixed" = "pan-zoom"
         @label "Camera"
         @description "--- View config (pure render) ---"

package/behaviors/lolo/ui/game/atoms/ui-canvas.lolo

@@ -103,6 +103,12 @@ orbital CanvasOrbital {
           featureClickEvent: @config.featureClickEvent
           keyMap: @config.keyMap
           keyUpMap: @config.keyUpMap
+          editable: @config.editable
+          selectedId: @config.selectedId
+          onSelect: @config.onSelect
+          onMove: @config.onMove
+          selectEvent: @config.selectEvent
+          moveEvent: @config.moveEvent
           children: @config.children
           type: canvas
         })
@@ -143,6 +149,18 @@ orbital CanvasOrbital {
       }
         @description "Feature-click event (3D only)."
         @tier "essential"
+      @config.onSelect -> external {
+        id : string
+      }
+        @description "Fired on a click that changes selection — before `selectEvent`."
+        @tier "essential"
+      @config.onMove -> external {
+        id : string
+        x : number
+        y : number
+      }
+        @description "Fired once per drag gesture, on drop — before `moveEvent`."
+        @tier "essential"
     }
 
     config {
@@ -262,6 +280,30 @@ orbital CanvasOrbital {
         @label "Key Up Map"
         @description "keyUpMap prop"
         @tier "presentation"
+      editable : boolean
+        @label "Editable"
+        @description "--- Scene-edit mode (a game studio selecting/dragging drawables). Purely"
+        @tier "presentation"
+      selectedId : string
+        @label "Selected Id"
+        @description "The currently-selected drawable id (controlled); `null`/undefined = none."
+        @tier "presentation"
+      onSelect : event = "SELECT"
+        @label "On Select"
+        @description "Fired on a click that changes selection — before `selectEvent`."
+        @tier "presentation"
+      onMove : event = "MOVE"
+        @label "On Move"
+        @description "Fired once per drag gesture, on drop — before `moveEvent`."
+        @tier "presentation"
+      selectEvent : event = "SELECT"
+        @label "Select Event"
+        @description "Declarative selection event, `UI:{selectEvent} { id }`."
+        @tier "presentation"
+      moveEvent : event = "MOVE"
+        @label "Move Event"
+        @description "Declarative move event, `UI:{moveEvent} { id, x, y }` — fired once on drop."
+        @tier "presentation"
       children : node
         @label "Children"
         @description "Declarative JSX drawable children (`<DrawShape .../>` composed in paint order). Forwarded to the 2D host, which collects them via drawable registry context."

package/behaviors/lolo/ui/game/atoms/ui-game-audio-cue.lolo

@@ -0,0 +1,68 @@
+app ui-game-audio-cue "1.0.0"
+"GameAudioCue — UI factory (1:1 with the @almadar/ui game-audio-cue pattern)."
+orbital GameAudioCueOrbital {
+  type GameAudioCueManifestValue = {
+    path : string!
+    volume : number
+    loop : boolean
+    poolSize : number
+    autostart : boolean
+    crossfade : boolean
+    crossfadeDurationMs : number
+  }
+
+  entity GameAudioCueItem [runtime] {
+    id : string!
+  }
+
+  trait GameAudioCueRender -> @rebindable GameAudioCueItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          cue: @config.cue
+          cueSeq: @config.cueSeq
+          music: @config.music
+          muted: @config.muted
+          volume: @config.volume
+          manifest: @config.manifest
+          baseUrl: @config.baseUrl
+          type: game-audio-cue
+        })
+    }
+
+    config {
+      cue : string
+        @label "Cue"
+        @description "Manifest key played as a one-shot SFX each time `cueSeq` advances."
+        @tier "presentation"
+      cueSeq : number
+        @label "Cue Seq"
+        @description "Monotonically increasing counter — bumping it re-triggers `cue`."
+        @tier "presentation"
+      music : string
+        @label "Music"
+        @description "Manifest key to crossfade to as looping background music; unset/empty stops music."
+        @tier "presentation"
+      muted : boolean
+        @label "Muted"
+        @description "Muted state, owned externally and mirrored into the hook."
+        @tier "presentation"
+      volume : number
+        @label "Volume"
+        @description "Master volume 0-1, owned externally and mirrored into the hook."
+        @tier "presentation"
+      manifest : Map string GameAudioCueManifestValue = {}
+        @label "Manifest"
+        @description "Sound manifest — keys mapped to sound definitions (path, volume, loop, ...)."
+        @tier "presentation"
+      baseUrl : string
+        @label "Base Url"
+        @description "Base URL prepended to every manifest path."
+        @tier "presentation"
+    }
+  }
+
+  page "/game-audio-cue" as GameAudioCuePage -> GameAudioCueRender
+}

package/behaviors/lolo/ui/game/atoms/ui-game-audio-toggle.lolo

@@ -52,10 +52,19 @@ orbital GameAudioToggleOrbital {
           error: @config.error
           onAsset: @config.onAsset
           offAsset: @config.offAsset
+          toggleEvent: @config.toggleEvent
           type: game-audio-toggle
         })
     }
 
+    emits {
+      @config.toggleEvent -> external {
+        muted : boolean!
+      }
+        @description "Event dispatched via event bus on toggle, carrying the new muted state."
+        @tier "essential"
+    }
+
     config {
       size : "sm" | "md" | "lg" = sm
         @label "Size"
@@ -81,6 +90,10 @@ orbital GameAudioToggleOrbital {
         @label "Off Asset"
         @description "Asset rendered when sound is OFF (muted). Falls back to 🔇 emoji."
         @tier "presentation"
+      toggleEvent : event = "TOGGLE"
+        @label "Toggle Event"
+        @description "Event dispatched via event bus on toggle, carrying the new muted state."
+        @tier "presentation"
     }
   }
 

package/behaviors/lolo/ui/learning/atoms/ui-algo-graph-canvas.lolo

@@ -41,6 +41,7 @@ orbital AlgoGraphCanvasOrbital {
     text : string
     label : string
     fontSize : number
+    fontFamily : string
     align : "left" | "center" | "right"
     axis : "x" | "y"
     min : number

package/behaviors/lolo/ui/learning/atoms/ui-algorithm-canvas.lolo

@@ -84,6 +84,7 @@ orbital AlgorithmCanvasOrbital {
     text : string
     label : string
     fontSize : number
+    fontFamily : string
     align : "left" | "center" | "right"
     axis : "x" | "y"
     min : number

package/behaviors/lolo/ui/learning/atoms/ui-biology-canvas.lolo

@@ -159,6 +159,7 @@ orbital BiologyCanvasOrbital {
     text : string
     label : string
     fontSize : number
+    fontFamily : string
     align : "left" | "center" | "right"
     axis : "x" | "y"
     min : number