@almadar/std 16.242.0 → 16.244.0

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

@@ -47,6 +47,7 @@ orbital LearnArrangementOrbital {
   entity LearnArrangementScene [runtime] {
     id : string!
     active : boolean = false
+    items : [LearnArrangementItem]
     title : string
     totalItems : number
     placedIds : [string]
@@ -60,10 +61,11 @@ orbital LearnArrangementOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
+        (set @entity.items @config.items)
         (set @entity.active true)
         (set @entity.title @config.title)
-        (set @entity.totalItems (array/len @config.items))
+        (set @entity.totalItems (array/len @entity.items))
         (set @entity.placedIds [])
         (set @entity.checked false)
         (set @entity.correctCount 0)
@@ -73,7 +75,7 @@ orbital LearnArrangementOrbital {
             (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
                     (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
                     (filled (!= @placedId ""))
-                    (item (if @filled (array/find @config.items (fn it (== (object/get @it id) @placedId))) null))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
                     (label (if @filled (object/get @item label) ""))
                     (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
                     (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
@@ -100,7 +102,7 @@ orbital LearnArrangementOrbital {
                     { type: badge, label: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
                   ] },
                 { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
-                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @config.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
                     { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
@@ -116,10 +118,11 @@ orbital LearnArrangementOrbital {
         (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.items @config.items)
         (set @entity.active true)
         (set @entity.title @config.title)
-        (set @entity.totalItems (array/len @config.items))
+        (set @entity.totalItems (array/len @entity.items))
         (set @entity.placedIds [])
         (set @entity.checked false)
         (set @entity.correctCount 0)
@@ -129,7 +132,7 @@ orbital LearnArrangementOrbital {
             (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
                     (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
                     (filled (!= @placedId ""))
-                    (item (if @filled (array/find @config.items (fn it (== (object/get @it id) @placedId))) null))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
                     (label (if @filled (object/get @item label) ""))
                     (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
                     (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
@@ -156,7 +159,7 @@ orbital LearnArrangementOrbital {
                     { type: badge, label: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
                   ] },
                 { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
-                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @config.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
                     { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
@@ -168,6 +171,63 @@ orbital LearnArrangementOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?items) 0)))
+        (set @entity.items ?items)
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.totalItems (array/len @entity.items))
+        (set @entity.placedIds [])
+        (set @entity.checked false)
+        (set @entity.correctCount 0)
+        (set @entity.verdict "")
+        (let (
+            (placedCount (array/len @entity.placedIds))
+            (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
+                    (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
+                    (filled (!= @placedId ""))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
+                    (label (if @filled (object/get @item label) ""))
+                    (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
+                    (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
+                    (bx (+ @config.slotLeft (* @i @config.slotSpacing)))
+                  )
+                  [
+                    { type: "rect", id: (str/concat "slot-" @i), x: @bx, y: @config.slotY, width: @config.slotWidth, height: @config.slotHeight, tone: @config.slotBorderColor, fillTone: @fillColor, fillStyle: "tint" },
+                    { type: "text", id: (str/concat "slot-label-" @i), x: (+ @bx (/ @config.slotWidth 2)), y: (+ @config.slotY (/ @config.slotHeight 2) 5), text: (if @filled @label (str/concat "" (+ @i 1))), textSize: @config.slotFontSize, align: "center", tone: @config.slotTextColor }
+                  ]
+                )))))
+          )
+          (set @entity.slotShapes @slotShapes)
+        )
+        (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.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
+                  ] },
+                { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                    { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
+                    { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
+                    { type: button, action: RETRY, label: @config.retryLabel, icon: "rotate-ccw", variant: ghost },
+                    { type: typography, variant: caption, color: muted, content: (str/concat "Placed " (array/len @entity.placedIds) " of " @entity.totalItems) }
+                  ] },
+                { type: typography, variant: body, content: (if @entity.checked @entity.verdict "Tap items to build the sequence in order, then press Check.") }
+              ] }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (render-ui main null)
+
       PLACE -> idle when (and (== @entity.active true) (< (array/len @entity.placedIds) @entity.totalItems))
         (set @entity.placedIds (array/append @entity.placedIds ?itemId))
         (set @entity.checked false)
@@ -178,7 +238,7 @@ orbital LearnArrangementOrbital {
             (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
                     (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
                     (filled (!= @placedId ""))
-                    (item (if @filled (array/find @config.items (fn it (== (object/get @it id) @placedId))) null))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
                     (label (if @filled (object/get @item label) ""))
                     (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
                     (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
@@ -205,7 +265,7 @@ orbital LearnArrangementOrbital {
                     { type: badge, label: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
                   ] },
                 { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
-                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @config.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
                     { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
@@ -227,7 +287,7 @@ orbital LearnArrangementOrbital {
             (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
                     (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
                     (filled (!= @placedId ""))
-                    (item (if @filled (array/find @config.items (fn it (== (object/get @it id) @placedId))) null))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
                     (label (if @filled (object/get @item label) ""))
                     (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
                     (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
@@ -254,7 +314,7 @@ orbital LearnArrangementOrbital {
                     { type: badge, label: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
                   ] },
                 { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
-                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @config.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
                     { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
@@ -270,7 +330,7 @@ orbital LearnArrangementOrbital {
         (let (
             (correctCount (array/reduce (array/range @entity.totalItems) 0 (fn acc i (let (
                     (placedId (array/nth @entity.placedIds @i))
-                    (item (array/find @config.items (fn it (== (object/get @it id) @placedId))))
+                    (item (array/find @entity.items (fn it (== (object/get @it id) @placedId))))
                   )
                   (if (== (object/get @item correctPosition) @i) (+ @acc 1) @acc)))))
             (verdictText (if (== @correctCount @entity.totalItems) "All correct — well done!" (str/concat @correctCount " of " @entity.totalItems " correct — review the highlighted slots.")))
@@ -286,7 +346,7 @@ orbital LearnArrangementOrbital {
             (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
                     (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
                     (filled (!= @placedId ""))
-                    (item (if @filled (array/find @config.items (fn it (== (object/get @it id) @placedId))) null))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
                     (label (if @filled (object/get @item label) ""))
                     (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
                     (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
@@ -313,7 +373,7 @@ orbital LearnArrangementOrbital {
                     { type: badge, label: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
                   ] },
                 { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
-                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @config.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
                     { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
@@ -337,7 +397,7 @@ orbital LearnArrangementOrbital {
             (slotShapes (array/flatten (array/map (array/range @entity.totalItems) (fn i (let (
                     (placedId (if (< @i @placedCount) (array/nth @entity.placedIds @i) ""))
                     (filled (!= @placedId ""))
-                    (item (if @filled (array/find @config.items (fn it (== (object/get @it id) @placedId))) null))
+                    (item (if @filled (array/find @entity.items (fn it (== (object/get @it id) @placedId))) null))
                     (label (if @filled (object/get @item label) ""))
                     (correctForSlot (if @filled (== (object/get @item correctPosition) @i) false))
                     (fillColor (if (not @filled) @config.emptySlotColor (if @entity.checked (if @correctForSlot @config.correctColor @config.incorrectColor) @config.pendingColor)))
@@ -364,7 +424,7 @@ orbital LearnArrangementOrbital {
                     { type: badge, label: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "Correct" (str/concat @entity.correctCount " / " @entity.totalItems " correct")) (str/concat (array/len @entity.placedIds) " / " @entity.totalItems " placed")), variant: (if @entity.checked (if (== @entity.correctCount @entity.totalItems) "success" "error") "neutral") }
                   ] },
                 { type: math-canvas, width: @config.width, height: @config.height, xMin: 0, xMax: @config.width, yMin: 0, yMax: @config.height, showAxes: false, showGrid: false, gridStep: 1, curves: [], points: [], vectors: [], shapes: @entity.slotShapes, interactive: @config.interactive, animate: @config.animate, keyMap: { Space: CHECK, Backspace: UNDO, KeyR: RETRY } },
-                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @config.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/filter @entity.items (fn it (not (array/includes @entity.placedIds (object/get @it id))))) (fn it { type: button, action: PLACE, actionPayload: { itemId: (object/get @it id) }, label: (if (!= (object/get @it hint "") "") (str/concat (object/get @it label) " — " (object/get @it hint "")) (object/get @it label)), variant: secondary, size: lg, disabled: @entity.checked })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: CHECK, label: @config.checkLabel, icon: "check", variant: primary, disabled: (if (>= (array/len @entity.placedIds) @entity.totalItems) false true) },
                     { type: button, action: UNDO, label: @config.undoLabel, icon: "chevron-left", variant: secondary, disabled: (if (> (array/len @entity.placedIds) 0) false true) },
@@ -384,6 +444,12 @@ orbital LearnArrangementOrbital {
       }
         @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!
+        items : [LearnArrangementItem]!
+      }
+        @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 items is the roster to order; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       PLACE {
         itemId : string
       }
@@ -454,6 +520,10 @@ orbital LearnArrangementOrbital {
         @label "Animate"
         @description "Enable continuous redraw loop."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the roster comes from: config reads the items knob(s) at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       items : [LearnArrangementItem] = [
         { id: "1", label: "Boil water in a kettle", correctPosition: 0, hint: "What has to happen before anything can be poured?" },
         { id: "2", label: "Place a tea bag in the cup", correctPosition: 1, hint: "The bag goes in before the water does." },