@almadar/std 16.200.0 → 16.202.0

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/std-coef-pad.lolo

@@ -5,6 +5,7 @@ orbital CoefPadOrbital {
     x0 : number!
     x1 : number!
     a : number!
+    b : number
     h : number!
     k : number!
   }
@@ -50,7 +51,7 @@ orbital CoefPadOrbital {
           (let ((remaining (array/len (array/filter @entity.coefPads (fn c (and (== (object/get @c applied) false) (!= (object/get @c id) (object/get @p id))))))))
           (do
             (set @entity.coefPads (array/map @entity.coefPads (fn c (if (== (object/get @c id) (object/get @p id)) (object/merge @c { applied: true }) @c))))
-            (emit COEF_PAD_APPLIED { id: (object/get @p id), x: (object/get @p x), y: (object/get @p y), x0: (object/get @m x0), x1: (object/get @m x1), a: (object/get @m a), h: (object/get @m h), k: (object/get @m k), hint: (object/get @p hint), hop: (object/get @p hop), samples: (object/get @p samples) })
+            (emit COEF_PAD_APPLIED { id: (object/get @p id), x: (object/get @p x), y: (object/get @p y), x0: (object/get @m x0), x1: (object/get @m x1), a: (object/get @m a), b: (if (== (object/get @m b) null) 1 (object/get @m b)), h: (object/get @m h), k: (object/get @m k), hint: (object/get @p hint), hop: (object/get @p hop), samples: (object/get @p samples) })
             (if (and (== @entity.coefCompleted false) (== @remaining 0))
               (do
                 (set @entity.coefCompleted true)
@@ -71,13 +72,14 @@ orbital CoefPadOrbital {
         x0 : number!
         x1 : number!
         a : number!
+        b : number
         h : number!
         k : number!
         hint : string
         hop : boolean
         samples : [CoefModSample]
       }
-        @description "The player stood on an unapplied coefficient pad; carries the pad position and the full mod (x0, x1, a, h, k) so the board appends it to the body authority's curveMods and hops the player onto the reshaped road. Fires once per pad per run."
+        @description "The player stood on an unapplied coefficient pad; carries the pad position and the full mod (x0, x1, a, b, h, k) so the board appends it to the body authority's curveMods and hops the player onto the reshaped road. Fires once per pad per run."
         @tier "domain"
       COEF_PAD_SET_COMPLETED -> external {
       }
@@ -97,7 +99,7 @@ orbital CoefPadOrbital {
         @tier "domain"
       coefPads : [CoefPad] = []
         @label "Coefficient Pads"
-        @description "One row per pad: id, center (x, y in world units), the mod applied to the road while inside x0..x1 (a scales slope+height, h shifts horizontally, k lifts), and the hint floated on apply, and hop (true = the board teleports the player onto the reshaped surface — use when the mod steps the road far from the pad; false = the skate snap carries the player, preserving speed). applied is stamped at runtime."
+        @description "One row per pad: id, center (x, y in world units), the mod applied to the road while inside x0..x1 (a scales slope+height, b compresses/stretch period, h shifts horizontally, k lifts), and the hint floated on apply, and hop (true = the board teleports the player onto the reshaped surface — use when the mod steps the road far from the pad; false = the skate snap carries the player, preserving speed). applied is stamped at runtime."
         @tier "domain"
       reachX : number = 0.7
         @label "Reach X"

package/behaviors/lolo/ui/game/atoms/std-platformer-body.lolo

@@ -36,6 +36,7 @@ orbital PlatformerBodyOrbital {
     x0 : number!
     x1 : number!
     a : number!
+    b : number!
     h : number!
     k : number!
   }
@@ -81,7 +82,10 @@ orbital PlatformerBodyOrbital {
         (set @entity.skating false)
 
       CURVE_MOD_ADD -> active when @config.curveModsEnabled
-        (set @entity.curveMods (array/append @entity.curveMods { x0: @payload.x0, x1: @payload.x1, a: @payload.a, h: @payload.h, k: @payload.k }))
+        (set @entity.curveMods (array/append @entity.curveMods { x0: @payload.x0, x1: @payload.x1, a: @payload.a, b: (if (== @payload.b null) 1 @payload.b), h: @payload.h, k: @payload.k }))
+
+      CURVE_MOD_CLEAR -> active when @config.curveModsEnabled
+        (set @entity.curveMods [])
 
       SET_TUNING -> active
         (set @entity.tuning (object/merge @entity.tuning (if (== @payload.jumpStrength null) {} { jumpStrength: @payload.jumpStrength })))
@@ -123,7 +127,7 @@ orbital PlatformerBodyOrbital {
         (let ((gapBreak (and (> @config.skateMaxGap 0) (> (- (object/get @rightSamp x) (object/get @leftSamp x)) @config.skateMaxGap))))
         (let ((mods (if (and @config.curveModsEnabled @inRange) (array/filter @entity.curveMods (fn m (and (>= @cx (object/get @m x0)) (<= @cx (object/get @m x1))))) [])))
         (let ((modded (array/reduce @mods { y: @curveY, s: @slope } (fn (acc m)
-          (let ((modX (- @cx (object/get @m h))))
+          (let ((modX (* (object/get @m b) (- @cx (object/get @m h)))))
           (let ((modInRange (and (>= @modX (object/get (array/first @config.skateCurve) x)) (< @modX (object/get (array/last @config.skateCurve) x)))))
           (let ((modLeft (if @modInRange (array/last (array/filter @config.skateCurve (fn s (<= (object/get @s x) @modX)))) null)))
           (let ((modRight (if @modInRange (array/first (array/filter @config.skateCurve (fn s (> (object/get @s x) @modX)))) null)))
@@ -131,7 +135,7 @@ orbital PlatformerBodyOrbital {
           (let ((modSlope (if @modOK (/ (- (object/get @modRight y) (object/get @modLeft y)) (- (object/get @modRight x) (object/get @modLeft x))) 0)))
           (let ((modCurveY (if @modOK (+ (object/get @modLeft y) (* @modSlope (- @modX (object/get @modLeft x)))) 0)))
           (if @modOK
-            { y: (+ (object/get @acc y) (- (+ (* (object/get @m a) @modCurveY) (object/get @m k)) @curveY)), s: (+ (object/get @acc s) (- (* (object/get @m a) @modSlope) @slope)) }
+            { y: (+ (object/get @acc y) (- (+ (* (object/get @m a) @modCurveY) (object/get @m k)) @curveY)), s: (+ (object/get @acc s) (- (* (* (object/get @m a) (object/get @m b)) @modSlope) @slope)) }
             @acc))))))))))))
         (let ((slope (object/get @modded s)))
         (let ((curveY (object/get @modded y)))
@@ -236,13 +240,18 @@ orbital PlatformerBodyOrbital {
       }
         @description "Body crossed killY in the gravity direction (pit fall); fires once per fall and re-arms on PLACE/RESTART, leaving the respawn rule to the board"
         @tier "domain"
+      CURVE_MOD_CLEAR -> external {
+      }
+        @description "Curve mods were cleared; the skate surface is back to the base skateCurve until a new mod is added."
+        @tier "domain"
     }
 
     listens {
       STEER { dir : number! }
       JUMP { id : string }
       PLACE { x : number!, y : number! }
-      CURVE_MOD_ADD { x0 : number!, x1 : number!, a : number!, h : number!, k : number! }
+      CURVE_MOD_ADD { x0 : number!, x1 : number!, a : number!, b : number, h : number!, k : number! }
+      CURVE_MOD_CLEAR { }
       SET_TUNING { jumpStrength : number, moveSpeed : number, gravity : number }
       RESTART { id : string }
     }
@@ -266,7 +275,7 @@ orbital PlatformerBodyOrbital {
         @tier "domain"
       curveModsEnabled : boolean = false
         @label "Curve Mods Enabled"
-        @description "When true, entity.curveMods reshape the skate surface inside each mod's x-range: the road samples the base curve at (x − h) and applies a·y + k (slope scales by a) — coefficient pads lift/tilt the segment the player is riding. Multiple overlapping mods stack by summing each mod's delta from the base surface; a mod whose shifted sample leaves the curve range is skipped. Default off: boards without coef pads pay nothing."
+        @description "When true, entity.curveMods reshape the skate surface inside each mod's x-range: the road samples the base curve at b·(x − h) and applies a·y + k (slope scales by a·b) — coefficient pads lift/tilt/compress the segment the player is riding. Multiple overlapping mods stack by summing each mod's delta from the base surface; a mod whose shifted sample leaves the curve range is skipped. Default off: boards without coef pads pay nothing."
         @tier "domain"
       jumpStrength : number = 11
         @label "Jump Strength"

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

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

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

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

@@ -18,6 +18,7 @@ orbital LearningCanvasOrbital {
     text : string
     label : string
     fontSize : number
+    fontFamily : string
     align : "left" | "center" | "right"
     axis : "x" | "y"
     min : number
@@ -101,6 +102,7 @@ orbital LearningCanvasOrbital {
           width: @config.width
           height: @config.height
           backgroundColor: @config.backgroundColor
+          fontFamily: @config.fontFamily
           shapes: @config.shapes
           drawables: @config.drawables
           projector: @config.projector
@@ -120,6 +122,7 @@ orbital LearningCanvasOrbital {
           width: @config.width
           height: @config.height
           backgroundColor: @config.backgroundColor
+          fontFamily: @config.fontFamily
           shapes: @payload.shapes
           drawables: @payload.drawables
           projector: @config.projector
@@ -177,6 +180,10 @@ orbital LearningCanvasOrbital {
         @label "Background Color"
         @description "Background color (default transparent)."
         @tier "presentation"
+      fontFamily : string
+        @label "Font Family"
+        @description "Canvas text font family. Falls back to the theme's --font-family-body."
+        @tier "presentation"
       shapes : [LearningCanvasShapesItem] = []
         @label "Shapes"
         @description "Declarative shapes to draw."

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

@@ -90,6 +90,7 @@ orbital MathCanvasOrbital {
     text : string
     label : string
     fontSize : number
+    fontFamily : string
     align : "left" | "center" | "right"
     axis : "x" | "y"
     min : number
@@ -172,6 +173,9 @@ orbital MathCanvasOrbital {
           gridColor: @config.gridColor
           axisColor: @config.axisColor
           showTickLabels: @config.showTickLabels
+          tickLabelFontSize: @config.tickLabelFontSize
+          labelFontSize: @config.labelFontSize
+          fontFamily: @config.fontFamily
           showCurveLabels: @config.showCurveLabels
           curves: @config.curves
           points: @config.points
@@ -211,6 +215,9 @@ orbital MathCanvasOrbital {
           gridColor: @config.gridColor
           axisColor: @config.axisColor
           showTickLabels: @config.showTickLabels
+          tickLabelFontSize: @config.tickLabelFontSize
+          labelFontSize: @config.labelFontSize
+          fontFamily: @config.fontFamily
           showCurveLabels: @config.showCurveLabels
           curves: @payload.curves
           points: @payload.points
@@ -324,6 +331,18 @@ orbital MathCanvasOrbital {
         @label "Show Tick Labels"
         @description "Draw numeric labels on grid lines (default false)."
         @tier "presentation"
+      tickLabelFontSize : number = 10
+        @label "Tick Label Font Size"
+        @description "Font size in px for axis tick labels (default 10)."
+        @tier "presentation"
+      labelFontSize : number = 12
+        @label "Label Font Size"
+        @description "Base font size in px for all other canvas annotations (points, vectors, guides, curves, regions, angles, hops; default 12)."
+        @tier "presentation"
+      fontFamily : string
+        @label "Font Family"
+        @description "Canvas text font family. Accepts a known game-font key (e.g. 'future-narrow') or a CSS font-family string."
+        @tier "presentation"
       showCurveLabels : boolean = false
         @label "Show Curve Labels"
         @description "Draw each curve's `label` at its last in-range sample (default false)."

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

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