@almadar/std 16.199.0 → 16.201.0

package/behaviors/lolo/ui/core/organisms/ui-dock-layout.lolo

@@ -0,0 +1,186 @@
+app ui-dock-layout "1.0.0"
+"DockLayout — UI factory (1:1 with the @almadar/ui dock-layout pattern)."
+orbital DockLayoutOrbital {
+  entity DockLayoutItem [runtime] {
+    id : string!
+  }
+
+  trait DockLayoutRender -> @rebindable DockLayoutItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          rail: @config.rail
+          sidebar: @config.sidebar
+          main: @config.main
+          bottomPanel: @config.bottomPanel
+          statusBar: @config.statusBar
+          secondarySidebar: @config.secondarySidebar
+          railWidth: @config.railWidth
+          secondarySidebarWidth: @config.secondarySidebarWidth
+          sidebarCollapsed: @config.sidebarCollapsed
+          onSidebarCollapsedChange: @config.onSidebarCollapsedChange
+          sidebarWidth: @config.sidebarWidth
+          onSidebarWidthChange: @config.onSidebarWidthChange
+          sidebarMinSize: @config.sidebarMinSize
+          bottomPanelCollapsed: @config.bottomPanelCollapsed
+          onBottomPanelCollapsedChange: @config.onBottomPanelCollapsedChange
+          bottomPanelHeight: @config.bottomPanelHeight
+          onBottomPanelHeightChange: @config.onBottomPanelHeightChange
+          bottomPanelMinSize: @config.bottomPanelMinSize
+          secondarySidebarCollapsed: @config.secondarySidebarCollapsed
+          onSecondarySidebarCollapsedChange: @config.onSecondarySidebarCollapsedChange
+          className: @config.className
+          railClassName: @config.railClassName
+          sidebarClassName: @config.sidebarClassName
+          mainClassName: @config.mainClassName
+          bottomPanelClassName: @config.bottomPanelClassName
+          statusBarClassName: @config.statusBarClassName
+          secondarySidebarClassName: @config.secondarySidebarClassName
+          type: dock-layout
+        })
+    }
+
+    emits {
+      @config.onSidebarCollapsedChange -> external {
+        collapsed : boolean
+      }
+        @description "onSidebarCollapsedChange prop"
+        @tier "essential"
+      @config.onSidebarWidthChange -> external {
+        width : number
+      }
+        @description "onSidebarWidthChange prop"
+        @tier "essential"
+      @config.onBottomPanelCollapsedChange -> external {
+        collapsed : boolean
+      }
+        @description "onBottomPanelCollapsedChange prop"
+        @tier "essential"
+      @config.onBottomPanelHeightChange -> external {
+        height : number
+      }
+        @description "onBottomPanelHeightChange prop"
+        @tier "essential"
+      @config.onSecondarySidebarCollapsedChange -> external {
+        collapsed : boolean
+      }
+        @description "onSecondarySidebarCollapsedChange prop"
+        @tier "essential"
+    }
+
+    config {
+      rail : node
+        @label "Rail"
+        @description "Fixed-width far-left vertical strip (e.g. an icon nav rail)."
+        @tier "presentation"
+      sidebar : node
+        @label "Sidebar"
+        @description "Collapsible, resizable left sidebar."
+        @tier "presentation"
+      main : node = []
+        @label "Main"
+        @description "Required center region."
+        @tier "presentation"
+      bottomPanel : node
+        @label "Bottom Panel"
+        @description "Collapsible, resizable-height bottom panel."
+        @tier "presentation"
+      statusBar : node
+        @label "Status Bar"
+        @description "Slim strip pinned to the bottom of the frame, below the bottom panel."
+        @tier "presentation"
+      secondarySidebar : node
+        @label "Secondary Sidebar"
+        @description "Collapsible right sidebar."
+        @tier "presentation"
+      railWidth : number = 56
+        @label "Rail Width"
+        @description "Width of `rail` in pixels. @default 56"
+        @tier "presentation"
+      secondarySidebarWidth : number = 280
+        @label "Secondary Sidebar Width"
+        @description "Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280"
+        @tier "presentation"
+      sidebarCollapsed : boolean = false
+        @label "Sidebar Collapsed"
+        @description "Whether `sidebar` is collapsed. @default false"
+        @tier "presentation"
+      onSidebarCollapsedChange : event = "SIDEBAR_COLLAPSED_CHANGE"
+        @label "On Sidebar Collapsed Change"
+        @description "onSidebarCollapsedChange prop"
+        @tier "presentation"
+      sidebarWidth : number = 20
+        @label "Sidebar Width"
+        @description "Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20"
+        @tier "presentation"
+      onSidebarWidthChange : event = "SIDEBAR_WIDTH_CHANGE"
+        @label "On Sidebar Width Change"
+        @description "onSidebarWidthChange prop"
+        @tier "presentation"
+      sidebarMinSize : number = 160
+        @label "Sidebar Min Size"
+        @description "Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160"
+        @tier "presentation"
+      bottomPanelCollapsed : boolean = false
+        @label "Bottom Panel Collapsed"
+        @description "Whether `bottomPanel` is collapsed. @default false"
+        @tier "presentation"
+      onBottomPanelCollapsedChange : event = "BOTTOM_PANEL_COLLAPSED_CHANGE"
+        @label "On Bottom Panel Collapsed Change"
+        @description "onBottomPanelCollapsedChange prop"
+        @tier "presentation"
+      bottomPanelHeight : number = 30
+        @label "Bottom Panel Height"
+        @description "Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30"
+        @tier "presentation"
+      onBottomPanelHeightChange : event = "BOTTOM_PANEL_HEIGHT_CHANGE"
+        @label "On Bottom Panel Height Change"
+        @description "onBottomPanelHeightChange prop"
+        @tier "presentation"
+      bottomPanelMinSize : number = 120
+        @label "Bottom Panel Min Size"
+        @description "Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120"
+        @tier "presentation"
+      secondarySidebarCollapsed : boolean = false
+        @label "Secondary Sidebar Collapsed"
+        @description "Whether `secondarySidebar` is collapsed. @default false"
+        @tier "presentation"
+      onSecondarySidebarCollapsedChange : event = "SECONDARY_SIDEBAR_COLLAPSED_CHANGE"
+        @label "On Secondary Sidebar Collapsed Change"
+        @description "onSecondarySidebarCollapsedChange prop"
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "Additional CSS classes on the root frame."
+        @tier "presentation"
+      railClassName : string
+        @label "Rail Class Name"
+        @description "railClassName prop"
+        @tier "presentation"
+      sidebarClassName : string
+        @label "Sidebar Class Name"
+        @description "sidebarClassName prop"
+        @tier "presentation"
+      mainClassName : string
+        @label "Main Class Name"
+        @description "mainClassName prop"
+        @tier "presentation"
+      bottomPanelClassName : string
+        @label "Bottom Panel Class Name"
+        @description "bottomPanelClassName prop"
+        @tier "presentation"
+      statusBarClassName : string
+        @label "Status Bar Class Name"
+        @description "statusBarClassName prop"
+        @tier "presentation"
+      secondarySidebarClassName : string
+        @label "Secondary Sidebar Class Name"
+        @description "secondarySidebarClassName prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/dock-layout" as DockLayoutPage -> DockLayoutRender
+}

package/behaviors/lolo/ui/core/organisms/ui-entity-cards.lolo

@@ -24,8 +24,8 @@ orbital EntityCardsOrbital {
     label : string!
     event : event
     navigatesTo : string
-    placement : "card" | "footer" | "row"
-    variant : "primary" | "secondary" | "ghost" | "danger"
+    placement : string
+    variant : string
   }
 
   entity EntityCardsItem [runtime] {

package/behaviors/lolo/ui/core/organisms/ui-entity-list.lolo

@@ -18,7 +18,7 @@ orbital EntityListOrbital {
     label : string!
     event : event
     navigatesTo : string
-    placement : "row" | "bulk" | "card" | "footer"
+    placement : string
     variant : "primary" | "secondary" | "ghost" | "danger" | "default"
   }
 

package/behaviors/lolo/ui/core/organisms/ui-entity-table.lolo

@@ -28,9 +28,9 @@ orbital EntityTableOrbital {
     label : string!
     event : event
     navigatesTo : string
-    placement : "row" | "bulk"
+    placement : string
     icon : icon
-    variant : "default" | "primary" | "secondary" | "ghost" | "danger"
+    variant : string
   }
   type EntityTableEmptyAction = {
     label : string!

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

@@ -10,7 +10,7 @@ orbital FormSectionOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : opaque
+    defaultValue : ControlValue
     options : [FormSectionFieldsItemOptionsItem]
     values : [string]
     relation : FormSectionFieldsItemRelation
@@ -22,6 +22,13 @@ orbital FormSectionOrbital {
     disabled : boolean
     hint : string
   }
+  type ControlValue = string | number | boolean | [string] | FileValue
+  type FileValue = {
+    name : string!
+    url : string!
+    mimeType : string!
+    sizeBytes : number!
+  }
   type FormSectionFieldsItemOptionsItem = {
     value : string!
     label : string!
@@ -69,10 +76,10 @@ orbital FormSectionOrbital {
     message : string!
   }
   type FormSectionEvaluationContext = {
-    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 FormSectionSectionsItem = {
     id : string!
@@ -89,7 +96,7 @@ orbital FormSectionOrbital {
     inputType : string
     placeholder : string
     required : boolean
-    defaultValue : opaque
+    defaultValue : ControlValue
     options : [FormSectionSectionsItemFieldsItemOptionsItem]
     values : [string]
     relation : FormSectionSectionsItemFieldsItemRelation
@@ -116,7 +123,7 @@ orbital FormSectionOrbital {
   type FormSectionFIELDCHANGEChange = {
     fieldId : string!
     value : string | number | boolean | [string] | FormSectionFIELDCHANGEChangeValue!
-    formValues : Map string opaque!
+    formValues : Map string ControlValue!
   }
   type FormSectionFIELDCHANGEChangeValue = {
     name : string!
@@ -283,7 +290,7 @@ orbital FormSectionOrbital {
         @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-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-split-pane.lolo

@@ -3,6 +3,7 @@ app ui-split-pane "1.0.0"
 orbital SplitPaneOrbital {
   entity SplitPaneItem [runtime] {
     id : string!
+    ratio : number
   }
 
   trait SplitPaneRender -> @rebindable SplitPaneItem [interaction, instance] {
@@ -10,9 +11,10 @@ orbital SplitPaneOrbital {
 
     state idle {
       INIT -> idle
+        (set @entity.ratio @config.ratio)
         (render-ui main {
           direction: @config.direction
-          ratio: @config.ratio
+          ratio: @entity.ratio
           minSize: @config.minSize
           resizable: @config.resizable
           left: @config.left
@@ -20,8 +22,38 @@ orbital SplitPaneOrbital {
           className: @config.className
           leftClassName: @config.leftClassName
           rightClassName: @config.rightClassName
+          onRatioChange: @config.onRatioChange
           type: split-pane
         })
+      RATIO_CHANGE -> idle
+        (set @entity.ratio ?ratio)
+        (render-ui main {
+          direction: @config.direction
+          ratio: @entity.ratio
+          minSize: @config.minSize
+          resizable: @config.resizable
+          left: @config.left
+          right: @config.right
+          className: @config.className
+          leftClassName: @config.leftClassName
+          rightClassName: @config.rightClassName
+          onRatioChange: @config.onRatioChange
+          type: split-pane
+        })
+    }
+
+    emits {
+      @config.onRatioChange -> external {
+        ratio : number
+      }
+        @description "Called with the new ratio while dragging. Providing this makes `ratio` controlled — the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior."
+        @tier "essential"
+    }
+
+    listens {
+      RATIO_CHANGE {
+        ratio : number
+      }
     }
 
     config {
@@ -61,6 +93,10 @@ orbital SplitPaneOrbital {
         @label "Right Class Name"
         @description "Class for right/bottom pane"
         @tier "presentation"
+      onRatioChange : event = "RATIO_CHANGE"
+        @label "On Ratio Change"
+        @description "Called with the new ratio while dragging. Providing this makes `ratio` controlled — the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior."
+        @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-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-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
+}