@almadar/std 16.183.0 → 16.184.0

package/behaviors/lolo/ui/core/atoms/std-tree.lolo

@@ -0,0 +1,247 @@
+app std-tree "1.0.0"
+"std-tree — generic hierarchical node browser. Fetches a flat TreeNode collection and renders it through file-tree's flat `items` mode (parentId-nested at render time by the component, not the .lolo); OPEN_NODE is the external handoff for a selected node's id. Rebindable: pass `fields` at the call site to retarget it at any parent-pointer entity (categories, org units, comment threads)."
+orbital TreeNodeOrbital {
+    type TreeNodeLoaded = Event { data : [TreeNode] } "Fired when the tree node collection finishes loading"
+
+    type TreeNodeLoadFailed = Event { error : string, code : string } "Fired when the tree node collection fails to load"
+
+  entity TreeNode [persistent: treenodes] {
+    id : string!
+    name : string! @description "The descriptive label for this node." @synonyms "label, title, text"
+    parentId : string @description "Reference to the parent node in the hierarchy; empty marks a root." @synonyms "parent, superior, ancestor" = ""
+    icon : string @description "Icon name shown beside the node." @synonyms "glyph, symbol, pictogram" = ""
+    createdAt : string
+  }
+
+  trait TreeBrowse -> @rebindable TreeNode [interaction, collection] {
+    initial: loading
+
+    state loading {
+      INIT -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading tree…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      TreeNodeLoaded -> browsing
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: list-tree, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h3
+            }, {
+              label: (array/len ?data)
+              size: sm
+              type: badge
+              variant: neutral
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, { type: divider }, {
+            items: (array/map ?data (fn row {
+              icon: @row.icon
+              id: @row.id
+              label: @row.name
+              parentId: @row.parentId
+            }))
+            onNodeSelect: OPEN_NODE
+            type: file-tree
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      TreeNodeLoadFailed -> error
+        (render-ui main {
+          align: center
+          children: [{
+            color: error
+            name: alert-triangle
+            type: icon
+          }, {
+            content: "Failed to load tree"
+            type: typography
+            variant: body
+          }, {
+            color: muted
+            content: ?error
+            type: typography
+            variant: caption
+          }, {
+            action: RETRY
+            icon: rotate-ccw
+            label: Retry
+            type: button
+            variant: ghost
+          }]
+          className: py-8
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+    }
+
+    state browsing {
+      INIT -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading tree…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      OPEN_NODE -> browsing
+        (set @entity.id ?id)
+      TreeNodeLoaded -> browsing
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: list-tree, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h3
+            }, {
+              label: (array/len ?data)
+              size: sm
+              type: badge
+              variant: neutral
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, { type: divider }, {
+            items: (array/map ?data (fn row {
+              icon: @row.icon
+              id: @row.id
+              label: @row.name
+              parentId: @row.parentId
+            }))
+            onNodeSelect: OPEN_NODE
+            type: file-tree
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      TreeNodeLoadFailed -> error
+        (render-ui main {
+          align: center
+          children: [{
+            color: error
+            name: alert-triangle
+            type: icon
+          }, {
+            content: "Failed to load tree"
+            type: typography
+            variant: body
+          }, {
+            color: muted
+            content: ?error
+            type: typography
+            variant: caption
+          }, {
+            action: RETRY
+            icon: rotate-ccw
+            label: Retry
+            type: button
+            variant: ghost
+          }]
+          className: py-8
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+    }
+
+    state error {
+      INIT -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main { type: spinner })
+      ;; the error screen's Retry button: INIT is lifecycle-only and the bus never
+      ;; delivers it, so the affordance must target a first-class user event
+      RETRY -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main { type: spinner })
+    }
+
+    emits {
+      OPEN_NODE {
+        id : string!
+      }
+        @description "Signals a tree node has been selected for external handoff."
+        @synonyms "select, choose, open, activate"
+        @tier "domain"
+      TreeNodeLoaded {
+        data : [TreeNode]
+      }
+        @description "Indicates the tree node collection has been successfully retrieved."
+        @synonyms "loaded, fetched, retrieved, ready"
+        @tier "domain"
+      TreeNodeLoadFailed {
+        error : string
+        code : string
+      }
+        @description "Indicates a failure to load the tree node collection."
+        @synonyms "error, failed, problem, unsuccessful"
+        @tier "internal"
+    }
+
+    listens {
+      OPEN_NODE {
+        id : string!
+      }
+        @description "A tree node was selected for external handoff."
+        @synonyms "select, choose, open, activate"
+        @tier "domain"
+      TreeNodeLoaded {
+        data : [TreeNode]
+      }
+        @description "Indicates the tree node collection has been successfully retrieved."
+        @synonyms "loaded, fetched, retrieved, ready"
+        @tier "domain"
+      TreeNodeLoadFailed {
+        error : string
+        code : string
+      }
+        @description "Indicates a failure to load the tree node collection."
+        @synonyms "error, failed, problem, unsuccessful"
+        @tier "internal"
+    }
+
+    config {
+      title : string = Tree
+        @label "Section title"
+        @description "Heading shown above the tree"
+        @tier "presentation"
+    }
+  }
+
+  page "/tree" as TreePage -> TreeBrowse
+}

package/behaviors/lolo/ui/core/atoms/std-version-history.lolo

@@ -1,5 +1,5 @@
 app std-version-history "1.0.0"
-"std-version-history — wiki/CMS revision history with diff + rollback. Browses revisions; opens detail in `viewing_single`; compares two revisions in `comparing` with intrinsic version-diff; persists rollback."
+"std-version-history — wiki/CMS revision history with diff + rollback. Browses revisions; opens detail in `viewing_single`; compares two revisions in `comparing` with intrinsic version-diff; persists rollback. `RevisionManage` is a rebindable single-entity trait: a consumer rebinds it to its own entity via `linkedEntity`. `config.scopeField` names the Revision field holding the parent document id; a page-mounted `{id}` route param scopes INIT's own fetch, and a consumer forwards SHOW_HISTORY { key } (via a `listens` override) to rescope the feed to one document — empty scopeField (default) or no id keeps today's unfiltered global feed. Rollback and retry refetches stay scoped."
 orbital RevisionOrbital {
     type RevisionLoaded = Event { data : [Revision] } "Fired when the revision collection finishes loading"
 
@@ -20,14 +20,17 @@ orbital RevisionOrbital {
     summary : string @description "A brief explanation of the revision's changes." @synonyms "description, note, comment, explanation"
     searchTerm : string @description "The current search query the user submitted." @synonyms "query, term, q" = ""
     createdAt : string
+    scopeKey : string @intrinsic @description "The parent document id the feed is currently scoped to, set by SHOW_HISTORY. Empty when browsing the unfiltered global feed." @synonyms "scope, filter key, document scope" = ""
   }
 
-  trait RevisionManage -> Revision [interaction, collection] {
+  trait RevisionManage -> @rebindable Revision [interaction, collection] {
     initial: loading
 
     state loading {
       INIT -> loading
+        (set @entity.scopeKey (str/default ?id ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (str/default ?id ""), ""] ["=", (object/get @entity @config.scopeField), ?id])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
@@ -95,7 +98,9 @@ orbital RevisionOrbital {
           type: stack
         })
       RevisionRolledBack -> loading
+        (set @entity.scopeKey (object/get ?row @config.scopeField ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (object/get ?row @config.scopeField ""), ""] ["=", (object/get @entity @config.scopeField), (object/get ?row @config.scopeField "")])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
       RevisionRollbackFailed -> error
@@ -110,11 +115,32 @@ orbital RevisionOrbital {
           type: alert
           variant: error
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state browsing {
       INIT -> loading
+        (set @entity.scopeKey (str/default ?id ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (str/default ?id ""), ""] ["=", (object/get @entity @config.scopeField), ?id])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
@@ -270,6 +296,25 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state viewing_single {
@@ -350,6 +395,25 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state comparing {
@@ -388,11 +452,39 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state error {
       INIT -> loading
+        (set @entity.scopeKey (str/default ?id ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (str/default ?id ""), ""] ["=", (object/get @entity @config.scopeField), ?id])
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main { size: sm, type: spinner })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main { size: sm, type: spinner })
@@ -454,6 +546,12 @@ orbital RevisionOrbital {
     }
 
     listens {
+      INIT {
+        id : string
+      }
+        @description "Optional route param delivered on mount (e.g. an :id page segment); scopes INIT's own fetch to rows whose scopeField equals id. Absent id or empty scopeField config keeps the unfiltered global feed."
+        @synonyms "route id, deep link, initial scope"
+        @tier "domain"
       OPEN_REVISION {
         id : string!
         row : Revision
@@ -506,6 +604,12 @@ orbital RevisionOrbital {
         @description "Indicates that a revision rollback operation has failed."
         @synonyms "rollback error, revert failure, undo failed"
         @tier "internal"
+      SHOW_HISTORY {
+        key : string!
+      }
+        @description "Requests the revision feed scoped to one parent document; stores the key and refetches filtered by config.scopeField."
+        @synonyms "view history, doc history, filter revisions"
+        @tier "domain"
     }
 
     config {
@@ -521,6 +625,10 @@ orbital RevisionOrbital {
         @label "Stat display look"
         @description "Layer 2 visual treatment for stat / KPI cards."
         @tier "presentation"
+      scopeField : string = ""
+        @label "Scope field"
+        @description "Revision entity field holding the parent document's id. When set, a page-mounted {id} route param scopes INIT's fetch, and a SHOW_HISTORY { key } event rescopes the feed, to rows whose scopeField equals the id/key; rollback and retry refetches stay scoped too. Empty (default) or no id = unfiltered global feed, unchanged from prior behavior."
+        @tier "domain"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-file-tree.lolo

@@ -9,6 +9,12 @@ orbital FileTreeOrbital {
     size : number
     language : string
   }
+  type FileTreeItemsItem = {
+    id : string!
+    label : string!
+    parentId : string
+    icon : string
+  }
 
   entity FileTreeItem [runtime] {
     id : string!
@@ -21,8 +27,10 @@ orbital FileTreeOrbital {
       INIT -> idle
         (render-ui main {
           tree: @config.tree
+          items: @config.items
           selectedPath: @config.selectedPath
           onFileSelect: @config.onFileSelect
+          onNodeSelect: @config.onNodeSelect
           className: @config.className
           indent: @config.indent
           type: file-tree
@@ -38,9 +46,13 @@ orbital FileTreeOrbital {
     }
 
     config {
-      tree : [FileTreeTreeItem] = [{ name: "Name", path: "Path", type: file, children: [], size: 1, language: "Language" }, { name: "Name 2", path: "Path 2", type: dir, children: [], size: 2, language: "Language 2" }]
+      tree : [FileTreeTreeItem] = []
         @label "Tree"
-        @description "The tree data"
+        @description "The tree data (pre-nested). Ignored when `items` is provided."
+        @tier "presentation"
+      items : [FileTreeItemsItem] = []
+        @label "Items"
+        @description "Flat node list, nested by `parentId` at render time — takes precedence over `tree` when provided. A `parentId` with no matching row renders that node as a root rather than dropping it."
         @tier "presentation"
       selectedPath : string
         @label "Selected Path"
@@ -50,6 +62,10 @@ orbital FileTreeOrbital {
         @label "On File Select"
         @description "Called when a file is clicked"
         @tier "presentation"
+      onNodeSelect : string = ""
+        @label "On Node Select"
+        @description "Called when a node is clicked, in flat `items` mode; carries the selected node's id. Presence-gated: binding this prop is what turns on the click-to-select affordance, mirroring Badge's `onRemove`."
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "CSS class"

package/behaviors/lolo/ui/core/organisms/ui-detail-panel.lolo

@@ -41,7 +41,11 @@ orbital DetailPanelOrbital {
     header : string
     type : string
     values : [string]
-    relation : string
+    relation : DetailPanelFieldsItemRelation
+  }
+  type DetailPanelFieldsItemRelation = {
+    entity : string!
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type DetailPanelRelationsDataValueItem = {
     value : string!
@@ -224,7 +228,7 @@ orbital DetailPanelOrbital {
         @label "Slide Over"
         @description "slideOver prop"
         @tier "presentation"
-      fields : [DetailPanelFieldsItem] = [{ key: "Key", header: "Header", type: "Type", values: ["Item", "Item 2"], relation: "Relation" }, { key: "Key 2", header: "Header 2", type: "Type 2", values: ["Item", "Item 2"], relation: "Relation 2" }]
+      fields : [DetailPanelFieldsItem] = [{ key: "Key", header: "Header", type: "Type", values: ["Item", "Item 2"], relation: { entity: "Entity", cardinality: one } }, { key: "Key 2", header: "Header 2", type: "Type 2", values: ["Item", "Item 2"], relation: { entity: "Entity 2", cardinality: many } }]
         @label "Fields"
         @description "Fields to display - accepts string[], {key, header}[], or DetailField[]"
         @tier "presentation"

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

@@ -29,7 +29,7 @@ orbital FormSectionOrbital {
   type FormSectionFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormSectionFieldsItemValidation = {
     enum : [string]
@@ -108,7 +108,7 @@ orbital FormSectionOrbital {
   type FormSectionSectionsItemFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormSectionSectionsItemFieldsItemValidation = {
     enum : [string]

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

@@ -29,7 +29,7 @@ orbital FormOrbital {
   type FormFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormFieldsItemValidation = {
     enum : [string]
@@ -108,7 +108,7 @@ orbital FormOrbital {
   type FormSectionsItemFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormSectionsItemFieldsItemValidation = {
     enum : [string]

package/behaviors/lolo/ui/game/atoms/std-tutorial-autodemo.lolo

@@ -0,0 +1,136 @@
+app std-tutorial-autodemo "1.0.0"
+"Generic scripted input-replay atom: the demo half of a tutorial. Holds one or more named cue scripts (each an ordered list of { at, event, arg } rows where at is a millisecond offset and event is LEFT/RIGHT/JUMP/STOP); listens for TUTORIAL_DEMO_START { demoId } (from std-tutorial-overlay's demoId step) and plays the matching script on a 32ms clock, emitting the semantic DEMO_LEFT / DEMO_RIGHT / DEMO_JUMP / DEMO_STOP events the host board maps onto its own movement. TUTORIAL_DEMO_STOP, DEMO_CANCEL (real user input), or exhausting the cue list end the demo and emit DEMO_STOP so the character stops moving. Renders a small Demo badge while playing. Domain-agnostic: the demo never emits board events (OW_*, etc.) — the organism maps DEMO_* to its own steering, so a demo cannot self-cancel through the board's input path."
+orbital TutorialAutoDemoOrbital {
+  type DemoCue = {
+    at : number!
+    event : string!
+    arg : number
+  }
+  type DemoScript = {
+    id : string!
+    cues : [DemoCue]!
+  }
+
+  entity AutoDemoData [runtime] {
+    id : string!
+    playing : boolean = false
+    scriptId : string = ""
+    elapsed : number = 0
+    cueIndex : number = 0
+  }
+
+  trait AutoDemo -> @rebindable AutoDemoData [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui hud-top null)
+
+      TUTORIAL_DEMO_START -> playing
+        (set @entity.scriptId @payload.demoId)
+        (set @entity.elapsed 0)
+        (set @entity.cueIndex 0)
+        (set @entity.playing true)
+        (render-ui hud-top {
+          type: badge
+          label: "Demo"
+          variant: "info"
+        })
+
+      TUTORIAL_DEMO_STOP -> idle
+        (render-ui hud-top null)
+
+      DEMO_CANCEL -> idle
+        (render-ui hud-top null)
+    }
+
+    state playing {
+      TUTORIAL_DEMO_START -> playing
+        (set @entity.scriptId @payload.demoId)
+        (set @entity.elapsed 0)
+        (set @entity.cueIndex 0)
+        (render-ui hud-top {
+          type: badge
+          label: "Demo"
+          variant: "info"
+        })
+
+      TUTORIAL_DEMO_STOP -> idle
+        (set @entity.playing false)
+        (render-ui hud-top null)
+        (emit DEMO_STOP {})
+
+      DEMO_CANCEL -> idle
+        (set @entity.playing false)
+        (render-ui hud-top null)
+        (emit DEMO_STOP {})
+    }
+
+    ticks {
+      demoTick every 32ms when (== @entity.playing true)
+        (set @entity.elapsed (+ @entity.elapsed 32))
+        (let ((scriptMatch (array/filter @config.scripts (fn s (== (object/get @s id) @entity.scriptId)))))
+        (let ((cueList (if (> (array/len @scriptMatch) 0) (object/get (array/first @scriptMatch) cues []) [])))
+        (let ((cue (if (< @entity.cueIndex (array/len @cueList)) (array/nth @cueList @entity.cueIndex) { at: 999999, event: "" })))
+        (do
+          (if (<= (object/get @cue at 0) @entity.elapsed)
+            (do
+              (set @entity.cueIndex (+ @entity.cueIndex 1))
+              (if (== (object/get @cue event "") "LEFT") (emit DEMO_LEFT {}) null)
+              (if (== (object/get @cue event "") "RIGHT") (emit DEMO_RIGHT {}) null)
+              (if (== (object/get @cue event "") "JUMP") (emit DEMO_JUMP {}) null)
+              (if (== (object/get @cue event "") "STOP") (emit DEMO_STOP {}) null))
+            null)
+          (if (>= @entity.cueIndex (array/len @cueList))
+            (do
+              (set @entity.playing false)
+              (render-ui hud-top null)
+              (emit DEMO_STOP {}))
+            null)))))
+    }
+
+    listens {
+      TUTORIAL_DEMO_START {
+        demoId : string!
+      }
+        @description "A tutorial step carrying a demoId was shown (std-tutorial-overlay); begin playing the cue script whose id matches demoId."
+        @tier "domain"
+      TUTORIAL_DEMO_STOP {
+      }
+        @description "The tutorial left a demo step or was dismissed; stop the demo and release control."
+        @tier "domain"
+      DEMO_CANCEL {
+      }
+        @description "Real user input was received by the host board; stop the demo immediately and hand control back to the player."
+        @tier "domain"
+    }
+
+    emits {
+      DEMO_LEFT -> external {
+      }
+        @description "Scripted run-left cue; the host board maps this to its own steer-left."
+        @tier "domain"
+      DEMO_RIGHT -> external {
+      }
+        @description "Scripted run-right cue; the host board maps this to its own steer-right."
+        @tier "domain"
+      DEMO_JUMP -> external {
+      }
+        @description "Scripted jump cue; the host board maps this to its own jump."
+        @tier "domain"
+      DEMO_STOP -> external {
+      }
+        @description "Scripted stop cue (or demo end/cancel); the host board maps this to stop movement."
+        @tier "domain"
+    }
+
+    config {
+      scripts : [DemoScript] = []
+        @label "Scripts"
+        @description "Named cue scripts keyed by the tutorial step's demoId; each cue fires its event after `at` milliseconds of the demo clock."
+        @tier "domain"
+    }
+  }
+
+  page "/tutorial-autodemo" as TutorialAutoDemoPage -> AutoDemo
+}