@almadar/std 16.199.0 → 16.200.0

package/behaviors/lolo/ui/core/organisms/ui-form.lolo

@@ -10,7 +10,7 @@ orbital FormOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : opaque
+    defaultValue : ControlValue
     options : [FormFieldsItemOptionsItem]
     values : [string]
     relation : FormFieldsItemRelation
@@ -22,6 +22,13 @@ orbital FormOrbital {
     disabled : boolean
     hint : string
   }
+  type ControlValue = string | number | boolean | [string] | FileValue
+  type FileValue = {
+    name : string!
+    url : string!
+    mimeType : string!
+    sizeBytes : number!
+  }
   type FormFieldsItemOptionsItem = {
     value : string!
     label : string!
@@ -69,10 +76,10 @@ orbital FormOrbital {
     message : string!
   }
   type FormEvaluationContext = {
-    formValues : Map string opaque!
-    globalVariables : Map string opaque!
-    localVariables : Map string opaque
-    entity : Map string opaque
+    formValues : Map string ControlValue!
+    globalVariables : Map string ControlValue!
+    localVariables : Map string ControlValue
+    entity : Map string ControlValue
   }
   type FormSectionsItem = {
     id : string!
@@ -89,7 +96,7 @@ orbital FormOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : opaque
+    defaultValue : ControlValue
     options : [FormSectionsItemFieldsItemOptionsItem]
     values : [string]
     relation : FormSectionsItemFieldsItemRelation
@@ -116,7 +123,7 @@ orbital FormOrbital {
   type FormFIELDCHANGEChange = {
     fieldId : string!
     value : string | number | boolean | [string] | FormFIELDCHANGEChangeValue!
-    formValues : Map string opaque!
+    formValues : Map string ControlValue!
   }
   type FormFIELDCHANGEChangeValue = {
     name : string!
@@ -283,7 +290,7 @@ orbital FormOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @tier "presentation"
-      mode : "create" | "edit" = create
+      mode : string
         @label "Mode"
         @description "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-stat-card.lolo

@@ -18,7 +18,7 @@ orbital StatCardOrbital {
     label : string!
     value : string
     icon : icon
-    format : "currency" | "percent" | "number"
+    format : string
   }
 
   entity StatCardItem [runtime] {

package/behaviors/lolo/ui/core/organisms/ui-subagent-trace-panel.lolo

@@ -114,7 +114,7 @@ orbital SubagentTracePanelOrbital {
         @label "Selected Ids"
         @description "Currently selected item IDs"
         @tier "presentation"
-      subagents : [opaque] = []
+      subagents : [Map string scalar] = []
         @label "Subagents"
         @description "All known subagents from the runner."
         @tier "presentation"
@@ -134,11 +134,11 @@ orbital SubagentTracePanelOrbital {
         @label "On Close"
         @description "Optional dismiss handler."
         @tier "presentation"
-      coordinatorActivities : [opaque] = []
+      coordinatorActivities : [Map string scalar] = []
         @label "Coordinator Activities"
         @description "Full coordinator activities (tool calls, results, messages, errors)."
         @tier "presentation"
-      coordinatorMessages : [opaque] = []
+      coordinatorMessages : [Map string scalar] = []
         @label "Coordinator Messages"
         @description "Canonical Coordinator conversation — same shape live and on reload. When present, takes precedence over `coordinatorActivities` for the Coordinator section."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/std-fx-narrative.lolo

@@ -0,0 +1,126 @@
+app std-fx-narrative "1.0.0"
+"Headless pedagogy→fx translator for game boards and learning shells: turns high-level narrative events into big transient screen-space or world-space text effects consumed by std-fx-particles / fx-overlay. Levels emit NARRATE { text, style } and get a correctly styled, centered (or positioned) floating text burst without hand-rolling particle structs. Tutorials emit TUTORIAL_SHOW and the atom forwards SHOW to a composed std-tutorial-overlay trait. Renders nothing; centralizes the FX vocabulary so every level's teaching text looks and behaves the same."
+
+orbital FxNarrativeOrbital {
+  type NarrativeCue = {
+    text : string!
+    style : "hint" | "fact" | "warn" | "celebrate"
+    x : number
+    y : number
+    ttl : number
+    space : "screen" | "world"
+  }
+
+  type FxParticle = {
+    id : string!
+    type : string!
+    x : number!
+    z : number
+    y : number
+    message : string
+    ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+  }
+
+  type StyleDef = {
+    color : string!
+    size : number!
+    ttl : number!
+    effect : string!
+  }
+
+  entity FxNarrativeData [runtime, shared] {
+    id : string!
+    seq : number = 0
+    lastText : string = ""
+  }
+
+  trait FxNarrative -> @rebindable FxNarrativeData [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.seq 0)
+        (set @entity.lastText "")
+
+      NARRATE -> active when @config.running
+        (let ((styleKey (if (== (object/get @payload style) null) "fact" (object/get @payload style)))
+              (styleDef (object/get @config.styles @styleKey))
+              (ttl (if (== (object/get @payload ttl) null) (object/get @styleDef ttl) (object/get @payload ttl)))
+              (x (if (== (object/get @payload x) null) 0.5 (object/get @payload x)))
+              (y (if (== (object/get @payload y) null) 0.25 (object/get @payload y)))
+              (space (if (== (object/get @payload space) null) "world" (object/get @payload space)))
+              (text (object/get @payload text)))
+          (do
+            (set @entity.seq (+ @entity.seq 1))
+            (set @entity.lastText @text)
+            (emit BURST { particles: [ {
+              id: (str/concat "narrative-" @entity.seq),
+              type: "narrative",
+              x: @x,
+              z: @y,
+              y: 0,
+              message: @text,
+              ttl: @ttl,
+              maxTtl: @ttl,
+              bornAt: (time/now),
+              space: @space,
+              effect: (object/get @styleDef effect),
+              color: (object/get @styleDef color),
+              size: (object/get @styleDef size),
+              vx: 0,
+              vy: 0,
+              vz: 0,
+              particleCount: 1
+            } ] })))
+
+      TUTORIAL_SHOW -> active when @config.running
+        (emit SHOW { id: "tutorial" })
+    }
+
+    emits {
+      BURST -> external {
+        particles : [FxParticle]
+      }
+        @description "Styled floating-text particle batch for std-fx-particles / fx-overlay."
+        @tier "domain"
+      SHOW -> external {
+        id : string
+      }
+        @description "Forwarded to a composed std-tutorial-overlay to open the tutorial modal."
+        @tier "domain"
+    }
+
+    listens {
+      NARRATE { text : string!, style : "hint" | "fact" | "warn" | "celebrate", x : number, y : number, ttl : number, space : "screen" | "world" }
+      TUTORIAL_SHOW { text : string, title : string }
+    }
+
+    config {
+      running : boolean = true
+        @label "Running"
+        @description "When false all narrative events are ignored."
+        @tier "domain"
+      styles : Map string StyleDef = {
+        "fact": { color: "#38bdf8", size: 0.7, ttl: 3, effect: "float-text" },
+        "hint": { color: "#a78bfa", size: 0.6, ttl: 2, effect: "float-text" },
+        "warn": { color: "#f87171", size: 0.6, ttl: 1.5, effect: "shake" },
+        "celebrate": { color: "#facc15", size: 0.9, ttl: 3, effect: "sparkle" }
+      }
+        @label "Styles"
+        @description "Map of narrative style to color, size, ttl, and effect. Override per game theme."
+        @tier "presentation"
+    }
+  }
+
+  page "/fx-narrative" as FxNarrativePage -> FxNarrative
+}

package/behaviors/lolo/ui/game/atoms/std-pickup.lolo

@@ -0,0 +1,104 @@
+app std-pickup "1.0.0"
+"Headless side-view collectible authority — the platformer twin of grid std-gather. Listens BODY_MOVED and, when the player touches an uncollected feature (|dx| <= reachX, |dy| <= reachY of the feature center — the coef-pad touch idiom minus the grounded requirement, so airborne pickups work), stamps it collected on the shared entity and emits PICKED once per item (id, kind, position, glyph, message) plus COLLECT{total} with the running count (the event std-gate-lock already consumes). When every feature is collected it emits PICKUP_SET_COMPLETED once. RESTART re-arms every feature and zeroes the count. kind is board-defined vocabulary (star, boost, …) — this atom reports, boards judge. Renders nothing; boards draw the features and read collected from the shared entity."
+orbital PickupOrbital {
+  type PickupFeature = {
+    id : string!
+    x : number!
+    y : number!
+    kind : string!
+    glyph : string
+    message : string
+    collected : boolean
+  }
+
+  entity PickupData [runtime, shared] {
+    id : string!
+    pickups : [PickupFeature] = []
+    pickupCompleted : boolean = false
+    total : number = 0
+  }
+
+  trait Pickup -> @rebindable PickupData [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.pickups (array/map @config.features (fn f (object/merge @f { collected: false }))))
+        (set @entity.pickupCompleted false)
+        (set @entity.total 0)
+
+      BODY_MOVED -> active when @config.running
+        (let ((touch (array/filter @entity.pickups (fn f
+          (and (== (object/get @f collected) false)
+            (and (<= (math/abs (- @payload.x (object/get @f x))) @config.reachX)
+              (<= (math/abs (- @payload.y (object/get @f y))) @config.reachY)))))))
+        (if (> (array/len @touch) 0)
+          (let ((f (array/first @touch)))
+          (let ((remaining (array/len (array/filter @entity.pickups (fn c (and (== (object/get @c collected) false) (!= (object/get @c id) (object/get @f id))))))))
+          (do
+            (set @entity.pickups (array/map @entity.pickups (fn c (if (== (object/get @c id) (object/get @f id)) (object/merge @c { collected: true }) @c))))
+            (set @entity.total (+ @entity.total 1))
+            (emit PICKED { id: (object/get @f id), kind: (object/get @f kind), x: (object/get @f x), y: (object/get @f y), glyph: (object/get @f glyph), message: (object/get @f message) })
+            (emit COLLECT { total: @entity.total })
+            (if (and (== @entity.pickupCompleted false) (== @remaining 0))
+              (do
+                (set @entity.pickupCompleted true)
+                (emit PICKUP_SET_COMPLETED {}))
+              null))))
+          null))
+
+      RESTART -> active
+        (set @entity.pickups (array/map @config.features (fn f (object/merge @f { collected: false }))))
+        (set @entity.pickupCompleted false)
+        (set @entity.total 0)
+    }
+
+    emits {
+      PICKED -> external {
+        id : string!
+        kind : string!
+        x : number!
+        y : number!
+        glyph : string
+        message : string
+      }
+        @description "The player touched an uncollected feature; carries the feature identity, board-defined kind (star, boost, …), position and display glyph/message. Fires once per feature per run."
+        @tier "domain"
+      COLLECT -> external {
+        total : number!
+      }
+        @description "Running count of collected features after this pickup — the event std-gate-lock consumes to count openings."
+        @tier "domain"
+      PICKUP_SET_COMPLETED -> external {
+      }
+        @description "Every feature in the set is collected; fires once per run."
+        @tier "domain"
+    }
+
+    listens {
+      BODY_MOVED { x : number!, y : number!, vx : number!, vy : number!, grounded : boolean!, skating : boolean!, speed : number! }
+      RESTART { id : string }
+    }
+
+    config {
+      running : boolean = true
+        @label "Running"
+        @description "When true, BODY_MOVED collects touched features; toggle to freeze the set as-is."
+        @tier "domain"
+      features : [PickupFeature] = []
+        @label "Features"
+        @description "One row per collectible: id, center (x, y in world units), board-defined kind (star, boost, …), display glyph and message floated on pickup. collected is stamped at runtime."
+        @tier "domain"
+      reachX : number = 0.7
+        @label "Reach X"
+        @description "Horizontal tolerance (world units) around a feature's center when testing player contact."
+        @tier "domain"
+      reachY : number = 1.2
+        @label "Reach Y"
+        @description "Vertical tolerance (world units) around a feature's center when testing player contact; generous values catch fly-through pickups."
+        @tier "domain"
+    }
+  }
+
+  page "/pickup" as PickupPage -> Pickup
+}

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

@@ -39,6 +39,11 @@ orbital PlatformerBodyOrbital {
     h : number!
     k : number!
   }
+  type PlatformerTuning = {
+    jumpStrength : number
+    moveSpeed : number
+    gravity : number
+  }
 
   entity PlatformerBodyData [runtime, shared] {
     id : string!
@@ -48,6 +53,7 @@ orbital PlatformerBodyOrbital {
     curveMods : [CurveMod] = []
     goalId : string = ""
     skating : boolean = false
+    tuning : PlatformerTuning = {}
   }
 
   trait PlatformerBody -> @rebindable PlatformerBodyData [lifecycle] {
@@ -62,10 +68,10 @@ orbital PlatformerBodyOrbital {
         (set @entity.skating false)
 
       STEER -> active when @config.running
-        (set @entity.body (object/merge @entity.body { vx: (* @payload.dir @config.moveSpeed), facingRight: (if (!= @payload.dir 0) (> @payload.dir 0) @entity.body.facingRight) }))
+        (set @entity.body (object/merge @entity.body { vx: (* @payload.dir (if (== (object/get @entity.tuning moveSpeed null) null) @config.moveSpeed (object/get @entity.tuning moveSpeed null))), facingRight: (if (!= @payload.dir 0) (> @payload.dir 0) @entity.body.facingRight) }))
 
       JUMP -> active when (and @config.running (== @entity.body.grounded true))
-        (set @entity.body (object/merge @entity.body { vy: (if (> @config.gravity 0) (- 0 @config.jumpStrength) @config.jumpStrength), grounded: false }))
+        (set @entity.body (object/merge @entity.body { vy: (if (> (if (== (object/get @entity.tuning gravity null) null) @config.gravity (object/get @entity.tuning gravity null)) 0) (- 0 (if (== (object/get @entity.tuning jumpStrength null) null) @config.jumpStrength (object/get @entity.tuning jumpStrength null))) (if (== (object/get @entity.tuning jumpStrength null) null) @config.jumpStrength (object/get @entity.tuning jumpStrength null))), grounded: false }))
         (emit BODY_JUMPED { x: @entity.body.x, y: @entity.body.y })
 
       PLACE -> active
@@ -77,6 +83,11 @@ orbital PlatformerBodyOrbital {
       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_TUNING -> active
+        (set @entity.tuning (object/merge @entity.tuning (if (== @payload.jumpStrength null) {} { jumpStrength: @payload.jumpStrength })))
+        (set @entity.tuning (object/merge @entity.tuning (if (== @payload.moveSpeed null) {} { moveSpeed: @payload.moveSpeed })))
+        (set @entity.tuning (object/merge @entity.tuning (if (== @payload.gravity null) {} { gravity: @payload.gravity })))
+
       RESTART -> active
         (set @entity.body @config.spawn)
         (set @entity.curveMods [])
@@ -84,16 +95,18 @@ orbital PlatformerBodyOrbital {
         (set @entity.hazardId "")
         (set @entity.goalId "")
         (set @entity.skating false)
+        (set @entity.tuning {})
     }
 
     ticks {
       physicsTick every 33ms
         when (and @config.running (> @entity.body.width 0))
-        (let ((gdir (if (> @config.gravity 0) 1 -1)))
+        (let ((eg (if (== (object/get @entity.tuning gravity null) null) @config.gravity (object/get @entity.tuning gravity null))))
+        (let ((gdir (if (> @eg 0) 1 -1)))
         (let ((bcx (+ (object/get @entity.body x) (/ (object/get @entity.body width) 2))) (bcy (+ (object/get @entity.body y) (/ (object/get @entity.body height) 2))))
         (let ((drift (array/find @config.driftRegions (fn r (and (>= @bcx (object/get @r x0)) (and (<= @bcx (object/get @r x1)) (and (>= @bcy (object/get @r y0)) (<= @bcy (object/get @r y1)))))))))
         (let ((dax (if (== @drift null) 0 (object/get @drift ax))) (day (if (== @drift null) 0 (object/get @drift ay))))
-        (let ((vy1 (math/clamp (+ @entity.body.vy (* (+ @config.gravity @day) 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed)))
+        (let ((vy1 (math/clamp (+ @entity.body.vy (* (+ @eg @day) 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed)))
         (let ((bw (object/get @entity.body width)) (bh (object/get @entity.body height)))
         (let ((nx (math/clamp (+ @entity.body.x (* @entity.body.vx 0.033)) @config.xMin @config.xMax)))
         (let ((ny (+ @entity.body.y (* @vy1 0.033))))
@@ -108,18 +121,24 @@ orbital PlatformerBodyOrbital {
         (let ((slope (if @inRange (/ (- (object/get @rightSamp y) (object/get @leftSamp y)) (- (object/get @rightSamp x) (object/get @leftSamp x))) 0)))
         (let ((curveY (if @inRange (+ (object/get @leftSamp y) (* @slope (- @cx (object/get @leftSamp x)))) 0)))
         (let ((gapBreak (and (> @config.skateMaxGap 0) (> (- (object/get @rightSamp x) (object/get @leftSamp x)) @config.skateMaxGap))))
-        (let ((curveMod (if (and @config.curveModsEnabled @inRange) (array/find @entity.curveMods (fn m (and (>= @cx (object/get @m x0)) (<= @cx (object/get @m x1))))) null)))
-        (let ((modX (if (== @curveMod null) @cx (- @cx (object/get @curveMod h)))))
-        (let ((modInRange (and (!= @curveMod null) (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)))) @leftSamp)))
-        (let ((modRight (if @modInRange (array/first (array/filter @config.skateCurve (fn s (> (object/get @s x) @modX)))) @rightSamp)))
-        (let ((modSlope (if @modInRange (/ (- (object/get @modRight y) (object/get @modLeft y)) (- (object/get @modRight x) (object/get @modLeft x))) @slope)))
-        (let ((modCurveY (if @modInRange (+ (object/get @modLeft y) (* @modSlope (- @modX (object/get @modLeft x)))) @curveY)))
-        (let ((slope (if (== @curveMod null) @slope (* (object/get @curveMod a) @modSlope))))
-        (let ((curveY (if (== @curveMod null) @curveY (+ (* (object/get @curveMod a) @modCurveY) (object/get @curveMod k)))))
+        (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 ((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)))
+          (let ((modOK (and @modInRange (and (!= @modLeft null) (!= @modRight null)))))
+          (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)) }
+            @acc))))))))))))
+        (let ((slope (object/get @modded s)))
+        (let ((curveY (object/get @modded y)))
+        (let ((aboveCurve (< (* (- @ny2 @curveY) @gdir) 0)))
         (let ((movingUp (< (* @vy1 @gdir) -0.01)))
-        (let ((skateNow (and @inRange (and (not @gapBreak) (and (<= (math/abs (- @ny2 @curveY)) @config.skateSnap) (and (or @landed @entity.skating) (or @entity.body.grounded (not @movingUp))))))))
-        (let ((vx2 (if @skateNow (math/clamp (+ @entity.body.vx (* (/ (* @config.gravity @slope) (+ 1 (* @slope @slope))) 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed) @entity.body.vx)))
+        (let ((skateNow (and @inRange (and (not @gapBreak) (and (<= (math/abs (- @ny2 @curveY)) @config.skateSnap) (and (or @landed (or @entity.skating (and (not @movingUp) @aboveCurve))) (or @entity.body.grounded (not @movingUp))))))))
+        (let ((vx2 (if @skateNow (math/clamp (+ @entity.body.vx (* (/ (* @eg @slope) (+ 1 (* @slope @slope))) 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed) @entity.body.vx)))
         (let ((vx3 (if (== @drift null) @vx2 (math/clamp (+ @vx2 (* @dax 0.033)) (- 0 @config.maxFallSpeed) @config.maxFallSpeed))))
         (let ((fy (if @skateNow @curveY @ny2)) (fvy (if @skateNow (* (* @vx2 (math/cos (math/atan @slope))) (math/sin (math/atan @slope))) @vy2)) (fgrounded (or @landed @skateNow)))
         (let ((hazardHit (array/find @config.platforms (fn p (and (== (object/get @p type) "hazard") (geo/aabb-overlap @rect { x: @p.x, y: @p.y, w: @p.width, h: @p.height }))))))
@@ -156,7 +175,7 @@ orbital PlatformerBodyOrbital {
                 (set @entity.fell true)
                 (emit BODY_FELL { x: @nx, y: @fy }))
               null)
-            (emit BODY_MOVED { x: @nx, y: @fy, vx: @entity.body.vx, vy: @fvy, grounded: @fgrounded, skating: @skateNow, speed: (math/hypot @entity.body.vx @fvy) }))))))))))))))))))))))))))))))))))))))
+            (emit BODY_MOVED { x: @nx, y: @fy, vx: @entity.body.vx, vy: @fvy, grounded: @fgrounded, skating: @skateNow, speed: (math/hypot @entity.body.vx @fvy) })))))))))))))))))))))))))))))))))))
     }
 
     emits {
@@ -176,7 +195,7 @@ orbital PlatformerBodyOrbital {
         y : number!
         slope : number!
       }
-        @description "Body engaged curve skating this tick (grounded within skateSnap of the skateCurve surface); slope is the local dy/dx — boards layer fx and equation readouts"
+        @description "Body engaged curve skating this tick (grounded, landing, or falling within skateSnap above the skateCurve surface); slope is the local dy/dx — boards layer fx and equation readouts"
         @tier "domain"
       BODY_SKATE_END -> external {
         x : number!
@@ -224,6 +243,7 @@ orbital PlatformerBodyOrbital {
       JUMP { id : string }
       PLACE { x : number!, y : number! }
       CURVE_MOD_ADD { x0 : number!, x1 : number!, a : number!, h : number!, k : number! }
+      SET_TUNING { jumpStrength : number, moveSpeed : number, gravity : number }
       RESTART { id : string }
     }
 
@@ -246,7 +266,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. 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 (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."
         @tier "domain"
       jumpStrength : number = 11
         @label "Jump Strength"
@@ -274,7 +294,7 @@ orbital PlatformerBodyOrbital {
         @tier "domain"
       skate : boolean = false
         @label "Curve Skating"
-        @description "When true, a grounded body within skateSnap of the skateCurve surface rides the curve: y snaps to the interpolated surface and tangential gravity (g·slope/(1+slope²)) accelerates vx, so the body slides downhill along the graph and launches off its ends; JUMP kicks free"
+        @description "When true, a grounded body within skateSnap of the skateCurve surface rides the curve: y snaps to the interpolated surface and tangential gravity (g·slope/(1+slope²)) accelerates vx, so the body slides downhill along the graph and launches off its ends; JUMP kicks free. Engages when grounded, when landing on a tile, or when a falling (not rising) body passes within skateSnap above the surface."
         @tier "domain"
       skateCurve : [PlatformerCurveSample] = []
         @label "Skate Curve"

package/behaviors/lolo/ui/game/atoms/ui-control-button.lolo

@@ -65,15 +65,15 @@ orbital ControlButtonOrbital {
         @label "Icon"
         @description "Icon component or emoji"
         @tier "presentation"
-      size : "sm" | "md" | "lg" | "xl" = md
+      size : string = md
         @label "Size"
         @description "Size variant"
         @tier "presentation"
-      shape : "circle" | "rounded" | "square" = circle
+      shape : string = circle
         @label "Shape"
         @description "Shape variant"
         @tier "presentation"
-      variant : "primary" | "secondary" | "ghost" = secondary
+      variant : string = secondary
         @label "Variant"
         @description "Visual variant"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-control-grid.lolo

@@ -6,7 +6,7 @@ orbital ControlGridOrbital {
     label : string
     icon : icon
     assetUrl : ControlGridButtonsItemAssetUrl
-    variant : "primary" | "secondary" | "ghost"
+    variant : string
   }
   type ControlGridButtonsItemAssetUrl = {
     url : asset!

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

@@ -58,7 +58,7 @@ orbital GameHudOrbital {
     }
 
     config {
-      position : "top" | "bottom" | "corners" = top
+      position : string
         @label "Position"
         @description "Position of the HUD"
         @tier "presentation"

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

@@ -6,7 +6,7 @@ orbital GameMenuOrbital {
     label : string!
     event : event
     navigatesTo : string
-    variant : "primary" | "secondary" | "ghost"
+    variant : string
     disabled : boolean
     subLabel : string
   }
@@ -15,7 +15,7 @@ orbital GameMenuOrbital {
     label : string!
     event : event
     navigatesTo : string
-    variant : "primary" | "secondary" | "ghost"
+    variant : string
     disabled : boolean
     subLabel : string
   }
@@ -38,7 +38,7 @@ orbital GameMenuOrbital {
     label : string!
     event : string
     navigatesTo : string
-    variant : "primary" | "secondary" | "ghost"
+    variant : string
     disabled : boolean
     subLabel : string
   }

package/behaviors/lolo/ui/game/atoms/ui-stat-badge.lolo

@@ -85,7 +85,7 @@ orbital StatBadgeOrbital {
         @label "Field"
         @description "Field name in the source (for schema config)"
         @tier "presentation"
-      format : "number" | "hearts" | "bar" | "text" = number
+      format : string = number
         @label "Format"
         @description "Display format"
         @tier "presentation"
@@ -93,11 +93,11 @@ orbital StatBadgeOrbital {
         @label "Icon"
         @description "Icon component or emoji"
         @tier "presentation"
-      size : "sm" | "md" | "lg" = md
+      size : string = md
         @label "Size"
         @description "Size variant"
         @tier "presentation"
-      variant : "default" | "primary" | "success" | "warning" | "danger" = default
+      variant : string = default
         @label "Variant"
         @description "Visual variant"
         @tier "presentation"