@almadar/std 16.188.0 → 16.189.0

package/behaviors/lolo/ui/core/molecules/ui-document-details.lolo

@@ -0,0 +1,80 @@
+app ui-document-details "1.0.0"
+"DocumentDetails — the document's metadata as a compact settings card for the rail beside a DocumentPanel, each property committing in place. — UI factory (1:1 with the @almadar/ui document-details pattern)."
+;; @capabilities "document settings, page details, post settings sidebar, metadata panel, document properties, publish settings"
+orbital DocumentDetailsOrbital {
+    type DocumentDetailsLoaded = Event { data : [DocumentDetailsItem] } "DocumentDetails rows finished loading; payload.data holds the collection"
+  type DocumentDetailsFieldsItem = {
+    name : string
+    key : string
+    label : string
+    header : string
+    icon : icon
+    kind : "text" | "boolean" | "select" | "readonly"
+    options : [string]
+    format : "date" | "currency" | "number" | "boolean" | "percent"
+  }
+
+  entity DocumentDetailsItem [runtime] {
+    id : string!
+  }
+
+  trait DocumentDetailsRender -> @rebindable DocumentDetailsItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (fetch DocumentDetailsItem { emit: { success: DocumentDetailsLoaded } })
+        (render-ui main {
+          entity: @entity
+          fields: @config.fields
+          metaCommitEvent: @config.metaCommitEvent
+          title: @config.title
+          className: @config.className
+          type: document-details
+        })
+      DocumentDetailsLoaded -> idle
+        (render-ui main {
+          entity: @payload.data
+          fields: @config.fields
+          metaCommitEvent: @config.metaCommitEvent
+          title: @config.title
+          className: @config.className
+          type: document-details
+        })
+    }
+
+    emits {
+      @config.metaCommitEvent -> external {
+        id : string!
+        patch : object!
+      }
+        @description "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update."
+        @tier "essential"
+      DocumentDetailsLoaded
+        @description "DocumentDetails rows finished loading; payload.data holds the collection."
+        @synonyms "loaded, fetched, retrieved"
+        @tier "essential"
+    }
+
+    config {
+      fields : [DocumentDetailsFieldsItem] = []
+        @label "Fields"
+        @description "The properties shown; empty renders nothing."
+        @tier "presentation"
+      metaCommitEvent : string = "META_COMMIT"
+        @label "Meta Commit Event"
+        @description "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update."
+        @tier "presentation"
+      title : string
+        @label "Title"
+        @description "Card heading (defaults to the localized 'Details')"
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/document-details" as DocumentDetailsPage -> DocumentDetailsRender
+}

package/behaviors/lolo/ui/core/molecules/ui-document-panel.lolo

@@ -0,0 +1,213 @@
+app ui-document-panel "1.0.0"
+"DocumentPanel — a record rendered as one continuous document: editable title over the rich-text body, editing controls tucked into the header corner. — UI factory (1:1 with the @almadar/ui document-panel pattern)."
+;; @capabilities "document page, note editor, wiki page, article editor, writing surface, rich text document, content editing canvas"
+orbital DocumentPanelOrbital {
+    type DocumentPanelLoaded = Event { data : [DocumentPanelItem] } "DocumentPanel rows finished loading; payload.data holds the collection"
+  type DocumentPanelActionsItem = {
+    label : string!
+    event : string
+    icon : icon
+    variant : "primary" | "secondary" | "ghost" | "danger"
+  }
+
+  entity DocumentPanelItem [runtime] {
+    id : string!
+    title : string
+    value : string
+  }
+
+  trait DocumentPanelRender -> @rebindable DocumentPanelItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (fetch DocumentPanelItem { emit: { success: DocumentPanelLoaded } })
+        (set @entity.title @config.title)
+        (set @entity.value @config.value)
+        (render-ui main {
+          entity: @entity
+          title: @entity.title
+          subtitle: @config.subtitle
+          value: @entity.value
+          actions: @config.actions
+          maxInlineActions: @config.maxInlineActions
+          editing: @config.editing
+          titleCommitEvent: @config.titleCommitEvent
+          contentChangeEvent: @config.contentChangeEvent
+          editEvent: @config.editEvent
+          doneEvent: @config.doneEvent
+          editLabel: @config.editLabel
+          doneLabel: @config.doneLabel
+          autosaveHint: @config.autosaveHint
+          placeholder: @config.placeholder
+          className: @config.className
+          type: document-panel
+        })
+      DocumentPanelLoaded -> idle
+        (render-ui main {
+          entity: @payload.data
+          title: @entity.title
+          subtitle: @config.subtitle
+          value: @entity.value
+          actions: @config.actions
+          maxInlineActions: @config.maxInlineActions
+          editing: @config.editing
+          titleCommitEvent: @config.titleCommitEvent
+          contentChangeEvent: @config.contentChangeEvent
+          editEvent: @config.editEvent
+          doneEvent: @config.doneEvent
+          editLabel: @config.editLabel
+          doneLabel: @config.doneLabel
+          autosaveHint: @config.autosaveHint
+          placeholder: @config.placeholder
+          className: @config.className
+          type: document-panel
+        })
+      TITLE_COMMIT -> idle
+        (set @entity.title ?title)
+        (render-ui main {
+          entity: @entity
+          title: @entity.title
+          subtitle: @config.subtitle
+          value: @entity.value
+          actions: @config.actions
+          maxInlineActions: @config.maxInlineActions
+          editing: @config.editing
+          titleCommitEvent: @config.titleCommitEvent
+          contentChangeEvent: @config.contentChangeEvent
+          editEvent: @config.editEvent
+          doneEvent: @config.doneEvent
+          editLabel: @config.editLabel
+          doneLabel: @config.doneLabel
+          autosaveHint: @config.autosaveHint
+          placeholder: @config.placeholder
+          className: @config.className
+          type: document-panel
+        })
+      CONTENT_CHANGE -> idle
+        (set @entity.value ?value)
+        (render-ui main {
+          entity: @entity
+          title: @entity.title
+          subtitle: @config.subtitle
+          value: @entity.value
+          actions: @config.actions
+          maxInlineActions: @config.maxInlineActions
+          editing: @config.editing
+          titleCommitEvent: @config.titleCommitEvent
+          contentChangeEvent: @config.contentChangeEvent
+          editEvent: @config.editEvent
+          doneEvent: @config.doneEvent
+          editLabel: @config.editLabel
+          doneLabel: @config.doneLabel
+          autosaveHint: @config.autosaveHint
+          placeholder: @config.placeholder
+          className: @config.className
+          type: document-panel
+        })
+    }
+
+    emits {
+      @config.titleCommitEvent -> external {
+        title : string!
+        id : string!
+      }
+        @description "Emitted when the title commits: { title, id }"
+        @tier "essential"
+      @config.contentChangeEvent -> external {
+        value : string!
+      }
+        @description "Forwarded to the embedded RichTextEditor's autosave stream: { value }"
+        @tier "essential"
+      @config.editEvent -> external {
+        id : string!
+      }
+        @description "Emitted by the header Edit affordance and a click on the read body: { id }"
+        @tier "essential"
+      @config.doneEvent -> external {
+        id : string!
+      }
+        @description "Emitted by the Done button that ends the editing session: { id }"
+        @tier "essential"
+      DocumentPanelLoaded
+        @description "DocumentPanel rows finished loading; payload.data holds the collection."
+        @synonyms "loaded, fetched, retrieved"
+        @tier "essential"
+    }
+
+    listens {
+      TITLE_COMMIT {
+        title : string!
+        id : string!
+      }
+      CONTENT_CHANGE {
+        value : string!
+      }
+    }
+
+    config {
+      title : string
+        @label "Title"
+        @description "Document title (falls back to 'Untitled' for a blank draft)"
+        @tier "presentation"
+      subtitle : string
+        @label "Subtitle"
+        @description "Muted byline under the title; hidden when empty"
+        @tier "presentation"
+      value : string
+        @label "Value"
+        @description "The document body as rich-text HTML"
+        @tier "presentation"
+      actions : [DocumentPanelActionsItem] = []
+        @label "Actions"
+        @description "Header actions (settings, history, …). At most one explicit primary stays inline; the rest live under a single '⋯' menu — the title owns its row."
+        @tier "presentation"
+      maxInlineActions : number
+        @label "Max Inline Actions"
+        @description "0 collapses even the primary action into the menu"
+        @tier "presentation"
+      editing : boolean = false
+        @label "Editing"
+        @description "false = read surface with click-to-edit body; true = live editor"
+        @tier "presentation"
+      titleCommitEvent : string = "TITLE_COMMIT"
+        @label "Title Commit Event"
+        @description "Emitted when the title commits: { title, id }"
+        @tier "presentation"
+      contentChangeEvent : string = "CONTENT_CHANGE"
+        @label "Content Change Event"
+        @description "Forwarded to the embedded RichTextEditor's autosave stream: { value }"
+        @tier "presentation"
+      editEvent : string = "EDIT"
+        @label "Edit Event"
+        @description "Emitted by the header Edit affordance and a click on the read body: { id }"
+        @tier "presentation"
+      doneEvent : string = "DONE"
+        @label "Done Event"
+        @description "Emitted by the Done button that ends the editing session: { id }"
+        @tier "presentation"
+      editLabel : string
+        @label "Edit Label"
+        @description "editLabel prop"
+        @tier "presentation"
+      doneLabel : string
+        @label "Done Label"
+        @description "doneLabel prop"
+        @tier "presentation"
+      autosaveHint : string
+        @label "Autosave Hint"
+        @description "Muted caption beside Done telling the author work persists on its own"
+        @tier "presentation"
+      placeholder : string
+        @label "Placeholder"
+        @description "Placeholder for an empty body"
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/document-panel" as DocumentPanelPage -> DocumentPanelRender
+}

package/behaviors/lolo/ui/core/molecules/{ui-rich-block-editor.lolo → ui-rich-text-editor.lolo}

@@ -1,56 +1,60 @@
-app ui-rich-block-editor "1.0.0"
-"RichBlockEditor — UI factory (1:1 with the @almadar/ui rich-block-editor pattern)."
-orbital RichBlockEditorOrbital {
-    type RichBlockEditorLoaded = Event { data : [RichBlockEditorItem] } "RichBlockEditor rows finished loading; payload.data holds the collection"
-
-  entity RichBlockEditorItem [runtime] {
+app ui-rich-text-editor "1.0.0"
+"RichTextEditor — UI factory (1:1 with the @almadar/ui rich-text-editor pattern)."
+orbital RichTextEditorOrbital {
+  entity RichTextEditorItem [runtime] {
     id : string!
+    value : string
   }
 
-  trait RichBlockEditorRender -> @rebindable RichBlockEditorItem [interaction, instance] {
+  trait RichTextEditorRender -> @rebindable RichTextEditorItem [interaction, instance] {
     initial: idle
 
     state idle {
       INIT -> idle
-        (fetch RichBlockEditorItem { emit: { success: RichBlockEditorLoaded } })
+        (set @entity.value @config.value)
         (render-ui main {
-          initialBlocks: @entity
+          value: @entity.value
           onChange: @config.onChange
           changeEvent: @config.changeEvent
           readOnly: @config.readOnly
           placeholder: @config.placeholder
-          enableBlocks: @config.enableBlocks
           showToolbar: @config.showToolbar
           className: @config.className
-          type: rich-block-editor
+          type: rich-text-editor
         })
-      RichBlockEditorLoaded -> idle
+      CHANGE -> idle
+        (set @entity.value ?value)
         (render-ui main {
-          initialBlocks: @payload.data
+          value: @entity.value
           onChange: @config.onChange
           changeEvent: @config.changeEvent
           readOnly: @config.readOnly
           placeholder: @config.placeholder
-          enableBlocks: @config.enableBlocks
           showToolbar: @config.showToolbar
           className: @config.className
-          type: rich-block-editor
+          type: rich-text-editor
         })
     }
 
     emits {
       @config.onChange -> external {
-        blocks : [object]
+        value : string
       }
         @description "onChange prop"
         @tier "essential"
-      RichBlockEditorLoaded
-        @description "RichBlockEditor rows finished loading; payload.data holds the collection."
-        @synonyms "loaded, fetched, retrieved"
-        @tier "essential"
+    }
+
+    listens {
+      CHANGE {
+        value : string
+      }
     }
 
     config {
+      value : string
+        @label "Value"
+        @description "The rich text content as HTML. Sanitized before rendering and on every change."
+        @tier "presentation"
       onChange : string = "CHANGE"
         @label "On Change"
         @description "onChange prop"
@@ -67,10 +71,6 @@ orbital RichBlockEditorOrbital {
         @label "Placeholder"
         @description "placeholder prop"
         @tier "presentation"
-      enableBlocks : boolean = true
-        @label "Enable Blocks"
-        @description "Opt-in to the Notion-style block authoring chrome (insert toolbar, per-row +/menu gutter, turn-into menu). Off by default: the editor renders as a plain rich text surface that edits block content inline without any add-block affordances."
-        @tier "presentation"
       showToolbar : boolean = true
         @label "Show Toolbar"
         @description "showToolbar prop"
@@ -82,5 +82,5 @@ orbital RichBlockEditorOrbital {
     }
   }
 
-  page "/rich-block-editor" as RichBlockEditorPage -> RichBlockEditorRender
+  page "/rich-text-editor" as RichTextEditorPage -> RichTextEditorRender
 }

package/behaviors/lolo/ui/game/atoms/std-choice-gate.lolo

@@ -0,0 +1,100 @@
+app std-choice-gate "1.0.0"
+"Headless choice-gate mechanic for side-view boards: a gate of N labeled option platforms where progress stops until the player commits to an answer. Listens BODY_MOVED and judges a gate when the player stands grounded on one of its option platforms (|dx| <= reachX of the option center, |dy| <= reachY of the gate's option plane — the pad-lock touch pattern): the correct option stamps the gate solved + chosen on the shared entity and emits CHOICE_CORRECT once (a solved gate never judges again, so the path stays open); a wrong option emits CHOICE_WRONG carrying the gate id, the chosen optionId, and the option's world position, so the board can bounce the player back and float the gate's hint (the board owns the bounce — the atom only reports). RESTART unsolves every gate. Renders nothing; boards draw the option platforms and labels from the shared entity (the render authority)."
+orbital ChoiceGateOrbital {
+  type ChoiceOption = {
+    id : string!
+    dx : number!
+    label : string!
+    correct : boolean!
+  }
+  type ChoiceGate = {
+    id : string!
+    x : number!
+    y : number!
+    hint : string
+    options : [ChoiceOption]!
+    solved : boolean
+    chosen : string
+  }
+
+  entity ChoiceGateData [runtime, shared] {
+    id : string!
+    choices : [ChoiceGate] = []
+  }
+
+  trait ChoiceGate -> @rebindable ChoiceGateData [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.choices (array/map @config.gates (fn g (object/merge @g { solved: false, chosen: "" }))))
+
+      BODY_MOVED -> active when @config.running
+        (let ((touch (array/filter @entity.choices (fn g
+          (and (== (object/get @g solved) false)
+            (> (array/len (array/filter (object/get @g options) (fn o
+              (and (== @payload.grounded true)
+                (and (<= (math/abs (- @payload.x (+ (object/get @g x) (object/get @o dx)))) @config.reachX)
+                  (<= (math/abs (- @payload.y (object/get @g y))) @config.reachY)))))) 0))))))
+        (if (> (array/len @touch) 0)
+          (let ((g (array/first @touch)))
+          (let ((o (array/first (array/filter (object/get @g options) (fn oo
+            (and (== @payload.grounded true)
+              (and (<= (math/abs (- @payload.x (+ (object/get @g x) (object/get @oo dx)))) @config.reachX)
+                (<= (math/abs (- @payload.y (object/get @g y))) @config.reachY))))))))
+          (if (== (object/get @o correct) true)
+            (do
+              (set @entity.choices (array/map @entity.choices (fn c (if (== (object/get @c id) (object/get @g id)) (object/merge @c { solved: true, chosen: (object/get @o id) }) @c))))
+              (emit CHOICE_CORRECT { id: (object/get @g id), x: (object/get @g x), y: (object/get @g y) }))
+            (emit CHOICE_WRONG { id: (object/get @g id), optionId: (object/get @o id), x: (+ (object/get @g x) (object/get @o dx)), y: (object/get @g y) }))))
+          null))
+
+      RESTART -> active
+        (set @entity.choices (array/map @config.gates (fn g (object/merge @g { solved: false, chosen: "" }))))
+    }
+
+    emits {
+      CHOICE_CORRECT -> external {
+        id : string!
+        x : number!
+        y : number!
+      }
+        @description "The player landed grounded on the gate's correct option; fires once per gate (solved gates stop judging). Carries the gate center so boards can burst the unlock there."
+        @tier "domain"
+      CHOICE_WRONG -> external {
+        id : string!
+        optionId : string!
+        x : number!
+        y : number!
+      }
+        @description "The player landed grounded on a wrong option; carries the gate id, the chosen optionId, and the option's world position so boards can bounce the player back to the approach and float the gate's hint."
+        @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 judges option landings; toggle to freeze every gate as-is."
+        @tier "domain"
+      gates : [ChoiceGate] = []
+        @label "Choice Gates"
+        @description "One row per gate: id, gate center (x, y — y is the option-platform surface the judge tests against), the hint floated on a wrong answer, and the options: id, dx offset from the gate center, the label drawn above the platform, and correct. solved/chosen are stamped at runtime."
+        @tier "domain"
+      reachX : number = 0.7
+        @label "Reach X"
+        @description "Horizontal tolerance (world units) around an option platform's center when testing a landing (approximates the body's half-width plus a step)."
+        @tier "domain"
+      reachY : number = 1.2
+        @label "Reach Y"
+        @description "Vertical tolerance (world units) around the gate's option plane when testing a landing (covers small hops onto the platform surface)."
+        @tier "domain"
+    }
+  }
+
+  page "/choice-gate" as ChoiceGatePage -> ChoiceGate
+}

package/behaviors/lolo/ui/game/atoms/std-coef-pad.lolo

@@ -0,0 +1,114 @@
+app std-coef-pad "1.0.0"
+"Headless coefficient-pad mechanic for graph-riding boards: floor pads that reshape the road the player is riding (y = a·f(x−h) + k). Listens BODY_MOVED and, when the player stands grounded on an unapplied pad (|dx| <= reachX, |dy| <= reachY of the pad center — the pad-lock touch pattern), stamps the pad applied on the shared entity and emits COEF_PAD_APPLIED carrying the pad position AND its mod (x0, x1, a, h, k), so the board can append the mod to the body authority's curveMods (std-platformer-body with curveModsEnabled) and hop the player onto the reshaped surface. When every pad is applied it emits COEF_PAD_SET_COMPLETED once. RESTART un-applies every pad (the board clears curveMods alongside — the pad reports, the board owns the road). Renders nothing; boards draw the pads and read applied from the shared entity (the render authority)."
+orbital CoefPadOrbital {
+  type CoefMod = {
+    x0 : number!
+    x1 : number!
+    a : number!
+    h : number!
+    k : number!
+  }
+  type CoefModSample = {
+    x : number!
+    y : number!
+  }
+  type CoefPad = {
+    id : string!
+    x : number!
+    y : number!
+    mod : CoefMod!
+    glyph : string
+    hint : string
+    hop : boolean
+    samples : [CoefModSample]
+    applied : boolean
+  }
+
+  entity CoefPadData [runtime, shared] {
+    id : string!
+    coefPads : [CoefPad] = []
+    coefCompleted : boolean = false
+  }
+
+  trait CoefPadLock -> @rebindable CoefPadData [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.coefPads (array/map @config.coefPads (fn p (object/merge @p { applied: false }))))
+        (set @entity.coefCompleted false)
+
+      BODY_MOVED -> active when @config.running
+        (let ((touch (array/filter @entity.coefPads (fn p
+          (and (== (object/get @p applied) false)
+            (and (== @payload.grounded true)
+              (and (<= (math/abs (- @payload.x (object/get @p x))) @config.reachX)
+                (<= (math/abs (- @payload.y (object/get @p y))) @config.reachY))))))))
+        (if (> (array/len @touch) 0)
+          (let ((p (array/first @touch)))
+          (let ((m (object/get @p mod)))
+          (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) })
+            (if (and (== @entity.coefCompleted false) (== @remaining 0))
+              (do
+                (set @entity.coefCompleted true)
+                (emit COEF_PAD_SET_COMPLETED {}))
+              null)))))
+          null))
+
+      RESTART -> active
+        (set @entity.coefPads (array/map @config.coefPads (fn p (object/merge @p { applied: false }))))
+        (set @entity.coefCompleted false)
+    }
+
+    emits {
+      COEF_PAD_APPLIED -> external {
+        id : string!
+        x : number!
+        y : number!
+        x0 : number!
+        x1 : number!
+        a : 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."
+        @tier "domain"
+      COEF_PAD_SET_COMPLETED -> external {
+      }
+        @description "Every coefficient pad in the set is applied; fires once per run. Boards layer the completion fx and dismiss the zone card."
+        @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 applies touched pads; toggle to freeze every pad as-is."
+        @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."
+        @tier "domain"
+      reachX : number = 0.7
+        @label "Reach X"
+        @description "Horizontal tolerance (world units) around a pad's center when testing player contact (approximates the body's half-width plus a step)."
+        @tier "domain"
+      reachY : number = 1.2
+        @label "Reach Y"
+        @description "Vertical tolerance (world units) around a pad's center when testing player contact (covers riding the surface the pad sits on)."
+        @tier "domain"
+    }
+  }
+
+  page "/coef-pad" as CoefPadPage -> CoefPadLock
+}

package/behaviors/lolo/ui/game/atoms/std-curve-fog.lolo

@@ -0,0 +1,50 @@
+app std-curve-fog "1.0.0"
+"Headless prediction-fog mechanic for graph-riding boards: in configured world regions the road ahead is only partially REVEALED — the atom listens BODY_MOVED and stamps fogX (the reveal horizon = player x + the region's lookAhead) onto the shared entity, and the board's render layer clips or ghosts every road sample past it, so the player must commit to jumps before the landing is visible and internalize where the function GOES (blowup, flattening, slow growth, divergence). Outside every region fogX sits at a large sentinel, i.e. fully revealed. Physics is untouched: the collider keeps the whole curve — the fog is purely visual. Renders nothing; boards clip their own curve/region samples against @entity.fogX (the render authority)."
+orbital CurveFogOrbital {
+  type CurveFogRegion = {
+    x0 : number!
+    x1 : number!
+    lookAhead : number!
+  }
+
+  entity CurveFogData [runtime, shared] {
+    id : string!
+    fogX : number = 99999
+  }
+
+  trait CurveFog -> @rebindable CurveFogData [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.fogX 99999)
+
+      BODY_MOVED -> active when @config.running
+        (let ((rmatch (array/filter @config.regions (fn r (and (>= @payload.x (object/get @r x0)) (< @payload.x (object/get @r x1)))))))
+        (if (> (array/len @rmatch) 0)
+          (set @entity.fogX (+ @payload.x (object/get (array/first @rmatch) lookAhead)))
+          (set @entity.fogX 99999)))
+
+      RESTART -> active
+        (set @entity.fogX 99999)
+    }
+
+    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 tracks the reveal horizon; toggle to freeze the fog where it is."
+        @tier "domain"
+      regions : [CurveFogRegion] = []
+        @label "Fog Regions"
+        @description "One row per fogged world span: x-range (x0..x1) and lookAhead — how far past the player the road stays revealed while inside. Small values force prediction (blowups), large values suit slow tail lessons. Empty list = no fog anywhere."
+        @tier "domain"
+    }
+  }
+
+  page "/curve-fog" as CurveFogPage -> CurveFog
+}