@almadar/std 16.242.0 → 16.244.0

package/behaviors/lolo/ui/learning/atoms/std-learn-derivation.lolo

@@ -29,6 +29,8 @@ orbital LearnDerivationOrbital {
   entity LearnDerivationScene [runtime] {
     id : string!
     active : boolean = false
+    premises : [LearnDerivationLine]
+    candidates : [LearnDerivationCandidate]
     title : string
     lines : [LearnDerivationLine]
     feedback : string
@@ -43,7 +45,9 @@ orbital LearnDerivationOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
+        (set @entity.premises @config.premises)
+        (set @entity.candidates @config.candidates)
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.feedback "")
@@ -51,7 +55,7 @@ orbital LearnDerivationOrbital {
         (set @entity.goalReached false)
         (set @entity.running @config.autoRun)
         (set @entity.elapsedMs 0)
-        (set @entity.lines @config.premises)
+        (set @entity.lines @entity.premises)
         (set @entity.renderChildren [
           { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
               { type: stack, direction: vertical, gap: xs, children: [
@@ -67,7 +71,7 @@ orbital LearnDerivationOrbital {
                   { type: typography, variant: body, content: @line.label }
                 ] }
             )) },
-          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
           { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
               (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
               { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
@@ -89,7 +93,9 @@ orbital LearnDerivationOrbital {
         (set @entity.running false)
         (render-ui main null)
 
-      MODE_SELECTED -> idle when (== ?mode @config.matchMode)
+      MODE_SELECTED -> idle when (and (== ?mode @config.matchMode) (== @config.rosterSource "config"))
+        (set @entity.premises @config.premises)
+        (set @entity.candidates @config.candidates)
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.feedback "")
@@ -97,7 +103,7 @@ orbital LearnDerivationOrbital {
         (set @entity.goalReached false)
         (set @entity.running @config.autoRun)
         (set @entity.elapsedMs 0)
-        (set @entity.lines @config.premises)
+        (set @entity.lines @entity.premises)
         (set @entity.renderChildren [
           { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
               { type: stack, direction: vertical, gap: xs, children: [
@@ -113,7 +119,7 @@ orbital LearnDerivationOrbital {
                   { type: typography, variant: body, content: @line.label }
                 ] }
             )) },
-          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
           { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
               (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
               { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
@@ -130,9 +136,57 @@ orbital LearnDerivationOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (and (> (array/len ?premises) 0) (> (array/len ?candidates) 0))))
+        (set @entity.premises ?premises)
+        (set @entity.candidates ?candidates)
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.feedback "")
+        (set @entity.narration "")
+        (set @entity.goalReached false)
+        (set @entity.running @config.autoRun)
+        (set @entity.elapsedMs 0)
+        (set @entity.lines @entity.premises)
+        (set @entity.renderChildren [
+          { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+              { type: stack, direction: vertical, gap: xs, children: [
+                  { type: typography, variant: h4, content: @entity.title },
+                  (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                ] },
+              { type: badge, label: (if @entity.goalReached "Goal reached" (if @entity.running "Auto-stepping" "In progress")), variant: (if @entity.goalReached "success" (if @entity.running "primary" "neutral")) }
+            ] },
+          { type: typography, variant: body, content: (str/concat @config.goalPrefix @config.goalLabel) },
+          { type: stack, direction: vertical, gap: xs, style: { maxHeight: (str/concat @config.height "px"), overflowY: "auto" }, children: (array/map @entity.lines (fn line
+              { type: stack, direction: horizontal, align: center, gap: sm, children: [
+                  { type: badge, label: @line.badgeLabel, variant: @line.badgeVariant },
+                  { type: typography, variant: body, content: @line.label }
+                ] }
+            )) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+              (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
+              { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
+              { type: typography, variant: caption, color: muted, content: (str/concat (array/len @entity.lines) " lines") }
+            ] },
+          { type: typography, variant: body, content: (if @entity.goalReached @config.goalReachedMessage @entity.narration) }
+        ])
+        (render-ui main {
+          type: box
+          padding: md
+          maxWidth: (str/concat @config.width "px")
+          children: [
+            { type: stack, direction: vertical, gap: md, children: @entity.renderChildren }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (set @entity.running false)
+        (render-ui main null)
+
       APPLY_STEP -> idle when (== @entity.active true)
         (let (
-            (candidate (array/first (array/filter @config.candidates (fn c (== @c.key ?candidateKey)))))
+            (candidate (array/first (array/filter @entity.candidates (fn c (== @c.key ?candidateKey)))))
             (links (array/filter @entity.lines (fn l (== @l.kind "link"))))
             (facts (array/filter @entity.lines (fn l (== @l.kind "fact"))))
             (wantLeft (== @candidate.matchSide "left"))
@@ -181,7 +235,7 @@ orbital LearnDerivationOrbital {
                   { type: typography, variant: body, content: @line.label }
                 ] }
             )) },
-          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
           { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
               (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
               { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
@@ -218,7 +272,7 @@ orbital LearnDerivationOrbital {
                   { type: typography, variant: body, content: @line.label }
                 ] }
             )) },
-          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
           { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
               (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
               { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
@@ -237,7 +291,7 @@ orbital LearnDerivationOrbital {
         (emit DERIVATION_UPDATED { feedback: @entity.feedback, goalReached: @entity.goalReached, lineCount: (array/len @entity.lines), narration: @entity.narration })
 
       RESET -> idle when (== @entity.active true)
-        (set @entity.lines @config.premises)
+        (set @entity.lines @entity.premises)
         (set @entity.feedback "")
         (set @entity.narration "")
         (set @entity.goalReached false)
@@ -258,7 +312,7 @@ orbital LearnDerivationOrbital {
                   { type: typography, variant: body, content: @line.label }
                 ] }
             )) },
-          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+          { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
           { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
               (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
               { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
@@ -287,7 +341,7 @@ orbital LearnDerivationOrbital {
             (let (
                 (links (array/filter @entity.lines (fn l (== @l.kind "link"))))
                 (facts (array/filter @entity.lines (fn l (== @l.kind "fact"))))
-                (evaluated (array/map @config.candidates (fn c (let (
+                (evaluated (array/map @entity.candidates (fn c (let (
                       (wantLeft (== @c.matchSide "left"))
                       (matchSense (== @c.matchNegationMode "same"))
                       (activeLink (array/first (array/filter @links (fn l (let (
@@ -336,7 +390,7 @@ orbital LearnDerivationOrbital {
                       { type: typography, variant: body, content: @line.label }
                     ] }
                 )) },
-              { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
+              { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.candidates (fn c { type: button, action: APPLY_STEP, actionPayload: { candidateKey: @c.key }, label: @c.label, variant: secondary, size: lg, disabled: @entity.goalReached })) },
               { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                   (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Run", icon: "play", variant: primary, aria-pressed: "false", disabled: @entity.goalReached }),
                   { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
@@ -362,6 +416,13 @@ orbital LearnDerivationOrbital {
       }
         @description "Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null."
         @tier "domain"
+      ROSTER_LOADED {
+        mode : string!
+        premises : [LearnDerivationLine]!
+        candidates : [LearnDerivationCandidate]!
+      }
+        @description "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone), premises are the starting lines and candidates the offered derivation steps; a matching instrument re-initialises from them exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       APPLY_STEP {
         candidateKey : string
       }
@@ -417,6 +478,10 @@ orbital LearnDerivationOrbital {
         @label "Auto-Apply Interval (ms)"
         @description "Milliseconds of running clock per automatic candidate application — the 32ms base tick accumulates elapsed time and applies the first applicable candidate each time this interval elapses."
         @tier "domain"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the roster comes from: config reads the premises/candidates knob(s) at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       premises : [LearnDerivationLine] = [
         { id: "given-a", label: "A", kind: "fact", subject: "A", negated: false, badgeLabel: "GIVEN", badgeVariant: "neutral" },
         { id: "given-a-implies-b", label: "A → B", kind: "link", leftSubject: "A", leftNegated: false, rightSubject: "B", rightNegated: false, badgeLabel: "RULE", badgeVariant: "info" }

package/behaviors/lolo/ui/learning/atoms/std-learn-diagram.lolo

@@ -36,7 +36,7 @@ orbital LearnDiagramOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.parts @config.parts)
@@ -81,7 +81,7 @@ orbital LearnDiagramOrbital {
         (set @entity.active false)
         (render-ui main null)
 
-      MODE_SELECTED -> idle when (== ?mode @config.matchMode)
+      MODE_SELECTED -> idle when (and (== ?mode @config.matchMode) (== @config.rosterSource "config"))
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.parts @config.parts)
@@ -122,6 +122,51 @@ orbital LearnDiagramOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?parts) 0)))
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.parts ?parts)
+        (set @entity.links ?links)
+        (set @entity.selectedId "")
+        (set @entity.selectedIndex -1)
+        (set @entity.captionText @config.overviewText)
+        (set @entity.readoutText "")
+        (let (
+            (buttons (array/map @entity.parts (fn p { type: button, action: SELECT_PART, actionPayload: { partId: (object/get @p id) }, label: (object/get @p label), variant: (if (== @entity.selectedId (object/get @p id)) "primary" "secondary"), size: sm })))
+            (clearButton { type: button, action: CLEAR_PART, label: @config.clearLabel, variant: ghost, size: sm })
+          )
+          (do
+            (set @entity.partButtons (array/append @buttons @clearButton))
+            (set @entity.captionChildren (if (!= @entity.readoutText "") [ { type: typography, variant: caption, color: muted, content: @entity.readoutText }, { type: typography, variant: body, content: @entity.captionText } ] [ { type: typography, variant: body, content: @entity.captionText } ]))
+          )
+        )
+        (render-ui main {
+          type: box
+          padding: md
+          children: [
+            { type: stack, direction: vertical, gap: md, children: [
+                { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: h4, content: @entity.title },
+                        (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                      ] },
+                    { type: badge, label: (if (== @entity.selectedId "") "Overview" (str/concat "Part " (str/concat "" (+ @entity.selectedIndex 1)) " of " (str/concat "" (array/len @entity.parts)))), variant: (if (== @entity.selectedId "") "neutral" "primary") }
+                  ] },
+                { type: stack, direction: horizontal, align: center, gap: xs, wrap: true, children: @entity.partButtons },
+                { type: biology-canvas, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor,
+                  nodes: (array/map @entity.parts (fn p { id: (object/get @p id), x: (object/get @p x), y: (object/get @p y), radius: (if (== (object/get @p id) @entity.selectedId) (* (object/get @p radius) 1.4) (object/get @p radius)), color: (object/get @p color), label: (object/get @p label) })),
+                  edges: @entity.links,
+                  shapes: (if (== @entity.selectedId "") [] [ { type: circle, x: (object/get (array/nth @entity.parts @entity.selectedIndex) x), y: (object/get (array/nth @entity.parts @entity.selectedIndex) y), radius: (+ (object/get (array/nth @entity.parts @entity.selectedIndex) radius) 10), color: @config.highlightColor, stroke: bold } ])
+                },
+                { type: card, variant: bordered, padding: md, children: @entity.captionChildren }
+              ] }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (render-ui main null)
+
       SELECT_PART -> idle when (== @entity.active true)
         (let (
             (idx (array/first (array/filter (array/range (array/len @entity.parts)) (fn i (== (object/get (array/nth @entity.parts @i) id) ?partId)))))
@@ -212,6 +257,13 @@ orbital LearnDiagramOrbital {
       }
         @description "Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null."
         @tier "domain"
+      ROSTER_LOADED {
+        mode : string!
+        parts : [LearnDiagramPart]!
+        links : [LearnDiagramLink]!
+      }
+        @description "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone), parts is the labeled-part roster and links the connector list; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       SELECT_PART {
         partId : string
       }
@@ -242,6 +294,10 @@ orbital LearnDiagramOrbital {
         @label "Match Mode"
         @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the parts and links roster comes from: config reads the parts and links knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       title : string = "System Diagram"
         @label "Title"
         @description "Title shown above the diagram."

package/behaviors/lolo/ui/learning/atoms/std-learn-doser.lolo

@@ -40,22 +40,24 @@ orbital LearnDoserOrbital {
     containers : [DoserContainer]
     readouts : [DoserReadout]
     doseSeries : [DoserTracePoint]
+    bands : [DoserBand]
   }
 
   trait LearnDoserSim -> @rebindable DoserScene [interaction, instance] {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
         (set @entity.active true)
         (set @entity.title @config.title)
+        (set @entity.bands @config.bands)
         (set @entity.dose 0)
         (set @entity.done false)
         (set @entity.running @config.autoDrip)
         (set @entity.elapsedMs 0)
         (let (
-            (matched (array/filter @config.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
-            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @config.bands (- (array/len @config.bands) 1))))
+            (matched (array/filter @entity.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
+            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @entity.bands (- (array/len @entity.bands) 1))))
           )
           (do
             (set @entity.bandLabel (object/get @band label))
@@ -127,16 +129,17 @@ orbital LearnDoserOrbital {
         (set @entity.running false)
         (render-ui main null)
 
-      MODE_SELECTED -> idle when (== ?mode @config.matchMode)
+      MODE_SELECTED -> idle when (and (== ?mode @config.matchMode) (== @config.rosterSource "config"))
         (set @entity.active true)
         (set @entity.title @config.title)
+        (set @entity.bands @config.bands)
         (set @entity.dose 0)
         (set @entity.done false)
         (set @entity.running @config.autoDrip)
         (set @entity.elapsedMs 0)
         (let (
-            (matched (array/filter @config.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
-            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @config.bands (- (array/len @config.bands) 1))))
+            (matched (array/filter @entity.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
+            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @entity.bands (- (array/len @entity.bands) 1))))
           )
           (do
             (set @entity.bandLabel (object/get @band label))
@@ -203,11 +206,93 @@ orbital LearnDoserOrbital {
           }))
         (emit DOSER_UPDATED { running: @entity.running, dose: @entity.dose, bandLabel: @entity.bandLabel, done: @entity.done })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?bands) 0)))
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.bands ?bands)
+        (set @entity.dose 0)
+        (set @entity.done false)
+        (set @entity.running @config.autoDrip)
+        (set @entity.elapsedMs 0)
+        (let (
+            (matched (array/filter @entity.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
+            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @entity.bands (- (array/len @entity.bands) 1))))
+          )
+          (do
+            (set @entity.bandLabel (object/get @band label))
+            (set @entity.bandColor (object/get @band color))
+            (set @entity.done (if (object/get @band terminal false) true @entity.done))
+          )
+        )
+        (set @entity.containers [
+          { x: (* @config.width 0.12), y: (* @config.height 0.3), width: (* @config.width 0.28), height: (* @config.height 0.6), divider: "none", level: (math/clamp (/ @entity.dose @config.capacity) 0 1), levelColor: @entity.bandColor, label: @config.reservoirLabel },
+          { x: (* @config.width 0.58), y: (* @config.height 0.05), width: (* @config.width 0.06), height: (* @config.height 0.55), divider: "none", level: (math/clamp (/ (- @config.capacity @entity.dose) @config.capacity) 0 1), levelColor: @config.sourceColor, label: @config.sourceLabel }
+        ])
+        (set @entity.readouts [
+          { label: @config.quantityLabel, value: (str/concat "" (math/round @entity.dose 2)) },
+          { label: @config.zoneReadoutLabel, value: @entity.bandLabel }
+        ])
+        (set @entity.doseSeries [{ x: 0, y: @entity.dose }])
+        (set @entity.narration (str/concat @config.quantityLabel (str/concat " at " (str/concat (str/concat "" (math/round @entity.dose 2)) (str/concat " — " @entity.bandLabel)))))
+        (if @config.showCanvas
+          (render-ui main {
+            type: box
+            padding: md
+            children: [
+              { type: stack, direction: vertical, gap: md, children: [
+                  { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+                      { type: stack, direction: vertical, gap: xs, children: [
+                          { type: typography, variant: h4, content: @entity.title },
+                          (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                        ] },
+                      { type: badge, label: (if @entity.done "Locked" (if @entity.running "Auto-dosing" "Ready")), variant: (if @entity.done "warning" (if @entity.running "primary" "neutral")) }
+                    ] },
+                  { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                      { type: button, action: ADD_SMALL, label: (str/concat "Add " (str/concat (str/concat "" @config.stepSmall) (if (== @config.unit "") "" (str/concat " " @config.unit)))), icon: "plus", variant: primary, disabled: @entity.done },
+                      { type: button, action: ADD_LARGE, label: (str/concat "Add " (str/concat (str/concat "" @config.stepLarge) (if (== @config.unit "") "" (str/concat " " @config.unit)))), icon: "plus", variant: secondary, disabled: @entity.done },
+                      (if @entity.running { type: button, action: TOGGLE_DRIP, label: "Pause", icon: "pause", variant: secondary, aria-pressed: "true" } { type: button, action: TOGGLE_DRIP, label: "Auto-dose", icon: "play", variant: secondary, aria-pressed: "false", disabled: @entity.done }),
+                      { type: button, action: RESET, label: "Reset", icon: "rotate-ccw", variant: ghost },
+                      { type: typography, variant: caption, color: muted, content: (str/concat @config.quantityLabel (str/concat " " (str/concat (str/concat "" (math/round @entity.dose 2)) (str/concat " of " (str/concat (str/concat "" @config.capacity) (if (== @config.unit "") "" (str/concat " " @config.unit))))))) }
+                    ] },
+                  { type: chemistry-canvas, series: @config.series, keyMap: { Space: TOGGLE_DRIP, KeyR: RESET }, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, containers: @entity.containers, readouts: @entity.readouts, traces: [ { series: [ { samples: @entity.doseSeries, label: @config.quantityLabel } ], xLabel: "step", yLabel: @config.quantityLabel } ] },
+                  { type: typography, variant: body, content: @entity.narration }
+                ] }
+            ]
+          })
+          (render-ui main {
+            type: box
+            padding: md
+            children: [
+              { type: stack, direction: vertical, gap: md, children: [
+                  { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+                      { type: stack, direction: vertical, gap: xs, children: [
+                          { type: typography, variant: h4, content: @entity.title },
+                          (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                        ] },
+                      { type: badge, label: (if @entity.done "Locked" (if @entity.running "Auto-dosing" "Ready")), variant: (if @entity.done "warning" (if @entity.running "primary" "neutral")) }
+                    ] },
+                  { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                      { type: button, action: ADD_SMALL, label: (str/concat "Add " (str/concat (str/concat "" @config.stepSmall) (if (== @config.unit "") "" (str/concat " " @config.unit)))), icon: "plus", variant: primary, disabled: @entity.done },
+                      { type: button, action: ADD_LARGE, label: (str/concat "Add " (str/concat (str/concat "" @config.stepLarge) (if (== @config.unit "") "" (str/concat " " @config.unit)))), icon: "plus", variant: secondary, disabled: @entity.done },
+                      (if @entity.running { type: button, action: TOGGLE_DRIP, label: "Pause", icon: "pause", variant: secondary, aria-pressed: "true" } { type: button, action: TOGGLE_DRIP, label: "Auto-dose", icon: "play", variant: secondary, aria-pressed: "false", disabled: @entity.done }),
+                      { type: button, action: RESET, label: "Reset", icon: "rotate-ccw", variant: ghost },
+                      { type: typography, variant: caption, color: muted, content: (str/concat @config.quantityLabel (str/concat " " (str/concat (str/concat "" (math/round @entity.dose 2)) (str/concat " of " (str/concat (str/concat "" @config.capacity) (if (== @config.unit "") "" (str/concat " " @config.unit))))))) }
+                    ] }
+                ] }
+            ]
+          }))
+        (emit DOSER_UPDATED { running: @entity.running, dose: @entity.dose, bandLabel: @entity.bandLabel, done: @entity.done })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (set @entity.running false)
+        (render-ui main null)
+
       ADD_SMALL -> idle when (and (== @entity.active true) (== @entity.done false))
         (set @entity.dose (math/min (+ @entity.dose @config.stepSmall) @config.capacity))
         (let (
-            (matched (array/filter @config.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
-            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @config.bands (- (array/len @config.bands) 1))))
+            (matched (array/filter @entity.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
+            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @entity.bands (- (array/len @entity.bands) 1))))
           )
           (do
             (set @entity.bandLabel (object/get @band label))
@@ -278,8 +363,8 @@ orbital LearnDoserOrbital {
       ADD_LARGE -> idle when (and (== @entity.active true) (== @entity.done false))
         (set @entity.dose (math/min (+ @entity.dose @config.stepLarge) @config.capacity))
         (let (
-            (matched (array/filter @config.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
-            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @config.bands (- (array/len @config.bands) 1))))
+            (matched (array/filter @entity.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
+            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @entity.bands (- (array/len @entity.bands) 1))))
           )
           (do
             (set @entity.bandLabel (object/get @band label))
@@ -406,8 +491,8 @@ orbital LearnDoserOrbital {
         (set @entity.running @config.autoDrip)
         (set @entity.elapsedMs 0)
         (let (
-            (matched (array/filter @config.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
-            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @config.bands (- (array/len @config.bands) 1))))
+            (matched (array/filter @entity.bands (fn b (<= @entity.dose (object/get @b upperBound)))))
+            (band (if (> (array/len @matched) 0) (array/first @matched) (array/nth @entity.bands (- (array/len @entity.bands) 1))))
           )
           (do
             (set @entity.bandLabel (object/get @band label))
@@ -492,6 +577,12 @@ orbital LearnDoserOrbital {
       }
         @description "Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null."
         @tier "domain"
+      ROSTER_LOADED {
+        mode : string!
+        bands : [DoserBand]!
+      }
+        @description "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone) and bands is the band roster; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
     }
 
     emits {
@@ -597,6 +688,10 @@ orbital LearnDoserOrbital {
         @label "Dose History"
         @description "Maximum points kept in the dose-history trace; older points drop off once exceeded."
         @tier "domain"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the band roster comes from: config reads the bands knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       bands : [DoserBand] = [
         { upperBound: 50, label: "Low", color: "muted", terminal: false },
         { upperBound: 999999999, label: "High", color: "success", terminal: true }