@almadar/std 16.182.0 → 16.184.0

package/behaviors/lolo/ui/learning/atoms/std-learn-slope-probe.lolo

@@ -0,0 +1,117 @@
+app std-learn-slope-probe "1.0.0"
+"Headless derivative probe for graph-riding learning boards: while the body authority's BODY_MOVED reports its `skating` flag (body riding the curve), it brackets the configured curve around the body's x and derives the local calculus readout — the slope dy/dx, a tangent-line segment of half-width `window` centered on the contact point, a rise-over-run triangle (run `triRun`, rise slope·run), and the glow window of curve samples around the contact — all written to a [runtime, shared] entity so the board renders the math the player is physically riding. Emits the sparse SLOPE_CHANGED signal only when the slope crosses a 0.5 bucket boundary, so fx and HUD meters react to *changes* in steepness without paying a per-tick event. The curve is the same sample table the body skates and the canvas draws — one source, three views. Renders nothing."
+orbital LearnSlopeProbeOrbital {
+  type ProbeSample = {
+    x : number!
+    y : number!
+  }
+
+  entity SlopeProbeState [runtime, shared] {
+    id : string!
+    probing : boolean = false
+    x : number = 0
+    y : number = 0
+    slope : number = 0
+    tax : number = 0
+    tay : number = 0
+    tbx : number = 0
+    tby : number = 0
+    triAx : number = 0
+    triAy : number = 0
+    triBx : number = 0
+    triBy : number = 0
+    triCx : number = 0
+    triCy : number = 0
+    segment : [ProbeSample] = []
+    bucket : number = 9999
+  }
+
+  trait LearnSlopeProbe -> @rebindable SlopeProbeState [lifecycle] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (set @entity.probing false)
+        (set @entity.segment [])
+        (set @entity.bucket 9999)
+
+      BODY_MOVED -> idle when @config.running
+        (let ((on (and @payload.skating (> (array/len @config.curve) 1))))
+        (let ((inRange (and @on (and (>= @payload.x (object/get (array/first @config.curve) x)) (<= @payload.x (object/get (array/last @config.curve) x))))))
+        (if @inRange
+          (let ((leftSamp (array/last (array/filter @config.curve (fn s (<= (object/get @s x) @payload.x)))))
+                (rightSamp (array/first (array/filter @config.curve (fn s (> (object/get @s x) @payload.x))))))
+          (let ((slope (if (== @rightSamp null) 0 (/ (- (object/get @rightSamp y) (object/get @leftSamp y)) (- (object/get @rightSamp x) (object/get @leftSamp x))))))
+          (let ((curveY (if (== @rightSamp null) (object/get @leftSamp y) (+ (object/get @leftSamp y) (* @slope (- @payload.x (object/get @leftSamp x)))))))
+          (let ((norm (math/sqrt (+ 1 (* @slope @slope)))))
+          (let ((dx (/ @config.window @norm)) (dy (/ (* @slope @config.window) @norm)))
+          (let ((newBucket (* (math/round (* @slope 2) 0) 0.5)))
+            (do
+              (set @entity.probing true)
+              (set @entity.x @payload.x)
+              (set @entity.y @curveY)
+              (set @entity.slope @slope)
+              (set @entity.tax (- @payload.x @dx))
+              (set @entity.tay (- @curveY @dy))
+              (set @entity.tbx (+ @payload.x @dx))
+              (set @entity.tby (+ @curveY @dy))
+              (set @entity.triAx @payload.x)
+              (set @entity.triAy @curveY)
+              (set @entity.triBx (+ @payload.x @config.triRun))
+              (set @entity.triBy @curveY)
+              (set @entity.triCx (+ @payload.x @config.triRun))
+              (set @entity.triCy (+ @curveY (* @slope @config.triRun)))
+              (set @entity.segment (array/filter @config.curve (fn s (and (>= (object/get @s x) (- @payload.x @config.window)) (<= (object/get @s x) (+ @payload.x @config.window))))))
+              (if (!= @newBucket @entity.bucket)
+                (do
+                  (set @entity.bucket @newBucket)
+                  (emit SLOPE_CHANGED { slope: @slope, bucket: @newBucket }))
+                null))))))))
+          (if @entity.probing
+            (do
+              (set @entity.probing false)
+              (set @entity.segment []))
+            null))))
+
+      RESTART -> idle
+        (set @entity.probing false)
+        (set @entity.segment [])
+        (set @entity.bucket 9999)
+    }
+
+    emits {
+      SLOPE_CHANGED -> external {
+        slope : number!
+        bucket : number!
+      }
+        @description "The local dy/dx crossed a 0.5 bucket boundary while the probe was active; slope is exact, bucket is the rounded step — fx/HUD scale with steepness without paying per-tick events."
+        @tier "domain"
+    }
+
+    listens {
+      BODY_MOVED { x : number!, y : number!, vx : number!, vy : number!, grounded : boolean!, skating : boolean!, speed : number! }
+      RESTART { id : string }
+    }
+
+    config {
+      running : boolean = true
+        @label "Running"
+        @description "When true the probe derives the readout off BODY_MOVED; toggle to freeze it (the board hides the tangent overlays when probing goes stale)."
+        @tier "domain"
+      curve : [ProbeSample] = []
+        @label "Curve"
+        @description "Surface samples (x strictly increasing) of the graph being ridden — the same table the body skates and the canvas draws, so the readout matches what is underfoot."
+        @tier "domain"
+      window : number = 1.5
+        @label "Tangent Window"
+        @description "Half-length (world units along the tangent) of the tangent segment and of the glow sample window around the contact point."
+        @tier "presentation"
+      triRun : number = 1
+        @label "Triangle Run"
+        @description "Horizontal leg of the rise-over-run triangle; the vertical leg is slope × triRun, so triRun = 1 reads the slope directly."
+        @tier "presentation"
+    }
+  }
+
+  page "/learn-slope-probe" as LearnSlopeProbePage -> LearnSlopeProbe
+}

package/behaviors/lolo/ui/learning/atoms/ui-math-canvas.lolo

@@ -168,6 +168,9 @@ orbital MathCanvasOrbital {
           showAxes: @config.showAxes
           showGrid: @config.showGrid
           gridStep: @config.gridStep
+          backgroundColor: @config.backgroundColor
+          gridColor: @config.gridColor
+          axisColor: @config.axisColor
           showTickLabels: @config.showTickLabels
           showCurveLabels: @config.showCurveLabels
           curves: @config.curves
@@ -203,6 +206,9 @@ orbital MathCanvasOrbital {
           showAxes: @config.showAxes
           showGrid: @config.showGrid
           gridStep: @config.gridStep
+          backgroundColor: @config.backgroundColor
+          gridColor: @config.gridColor
+          axisColor: @config.axisColor
           showTickLabels: @config.showTickLabels
           showCurveLabels: @config.showCurveLabels
           curves: @payload.curves
@@ -299,6 +305,18 @@ orbital MathCanvasOrbital {
         @label "Grid Step"
         @description "gridStep prop"
         @tier "presentation"
+      backgroundColor : string
+        @label "Background Color"
+        @description "Canvas fill color; `var(--token, fallback)` strings resolve against the active theme. Default transparent."
+        @tier "presentation"
+      gridColor : string = "var(--color-border, #9ca3af)"
+        @label "Grid Color"
+        @description "Grid line color; resolves theme tokens (default `var(--color-border, #9ca3af)`)."
+        @tier "presentation"
+      axisColor : string = "var(--color-muted-foreground, #374151)"
+        @label "Axis Color"
+        @description "Axis line color; resolves theme tokens (default `var(--color-muted-foreground, #374151)`)."
+        @tier "presentation"
       showTickLabels : boolean = false
         @label "Show Tick Labels"
         @description "Draw numeric labels on grid lines (default false)."

package/behaviors/registry/infra/atoms/std-migration-job.orb

@@ -335,11 +335,11 @@
           "config": {
             "connectionRef": {
               "default": "",
-              "description": "Secret-store / environment KEY holding the source credentials. The reference is stored; the secret itself never enters config, traces, or snapshots — the migration service resolves it at run time. (Typed `string` until the `secret` config-field type lands in the lolo language — tracked gap.)",
+              "description": "Secret-store / environment KEY holding the source credentials. The reference is stored; the secret itself never enters config, traces, or snapshots — the migration service resolves it at run time. (Typed `secret` — the config-field type that marks a credential reference; UI password-renders it and traces mask it.)",
               "label": "Connection reference",
               "synonyms": "credential key, connection string reference, secret name",
               "tier": "internal",
-              "type": "string"
+              "type": "secret"
             },
             "reviewSlot": {
               "default": "modal",

package/behaviors/registry/ui/core/atoms/std-browse.orb

@@ -945,6 +945,17 @@
               "tier": "internal",
               "type": "string"
             },
+            "include": {
+              "default": [],
+              "description": "Entity relation field names to hydrate on fetch (e.g. a `tag : Category` field named `tag`), so grid columns can use dot-paths like tag.name. Empty = no hydration, the default.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Which relation fields to hydrate?",
+              "synonyms": "relation hydration, populate relations, joined fields, hydrate relations",
+              "tier": "internal",
+              "type": "[string]"
+            },
             "initialFilterField": {
               "default": "",
               "description": "Name the field the INITIAL load filters on, paired with initialFilterValue. This is the detail half of a list-detail pair: a thread that must wait for a conversation to be picked sets the field to its parent key and leaves the value blank, so the first load matches nothing and the empty state shows instead of every record in the table. REFETCH_FILTER then supplies the real selection. Left blank the first load is unfiltered, which is the default.",
@@ -1727,6 +1738,7 @@
                           ]
                         ]
                       ],
+                      "include": "@config.include",
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -1888,6 +1900,7 @@
                           ]
                         ]
                       ],
+                      "include": "@config.include",
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -1945,6 +1958,7 @@
                           ]
                         ]
                       ],
+                      "include": "@config.include",
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -2002,6 +2016,7 @@
                           ]
                         ]
                       ],
+                      "include": "@config.include",
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -2039,6 +2054,7 @@
                           "@user.id"
                         ]
                       ],
+                      "include": "@config.include",
                       "limit": "@config.pageSize",
                       "offset": [
                         "*",
@@ -2218,6 +2234,7 @@
                           ]
                         ]
                       ],
+                      "include": "@config.include",
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }

package/behaviors/registry/ui/core/atoms/std-related.orb

@@ -46,6 +46,24 @@
         "parent": "trt_01KXG04HAWB43BWZ07VSETQEW3",
         "renames": []
       },
+      "evt_01M0RY3YKG5AXYCBSMYMGG5B4E": {
+        "bakedName": "SHOW_RELATED",
+        "curName": "SHOW_RELATED",
+        "id": "evt_01M0RY3YKG5AXYCBSMYMGG5B4E",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HAWB43BWZ07VSETQEW3",
+        "renames": []
+      },
+      "evt_01M0RY3YKG814RWTP8NGJZCGG7": {
+        "bakedName": "SELECT_RELATED",
+        "curName": "SELECT_RELATED",
+        "id": "evt_01M0RY3YKG814RWTP8NGJZCGG7",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HAWB43BWZ07VSETQEW3",
+        "renames": []
+      },
       "orb_01KXG04HAW4F728HDBS2FDVGF1": {
         "bakedName": "RelatedItemOrbital",
         "curName": "RelatedItemOrbital",
@@ -114,6 +132,13 @@
         {
           "category": "interaction",
           "config": {
+            "relationField": {
+              "default": "",
+              "description": "RelatedItem field compared against SHOW_RELATED's key to scope the fetch to one parent document; empty renders the full unfiltered collection (default).",
+              "label": "Relation field",
+              "tier": "domain",
+              "type": "string"
+            },
             "tableLook": {
               "default": "dense",
               "description": "Layer 2 visual treatment for the data table rendered by this atom.",
@@ -127,6 +152,13 @@
                 "borderless",
                 "card-rows"
               ]
+            },
+            "title": {
+              "default": "Related",
+              "description": "Heading shown above the related list.",
+              "label": "Section title",
+              "tier": "presentation",
+              "type": "string"
             }
           },
           "emits": [
@@ -161,6 +193,25 @@
               "scope": "internal",
               "synonyms": "error, failure, problem, unsuccessful",
               "tier": "internal"
+            },
+            {
+              "description": "Signals a related item was selected to drive a detail view.",
+              "event": "SELECT_RELATED",
+              "eventId": "evt_01M0RY3YKG814RWTP8NGJZCGG7",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "select, choose, open, view",
+              "tier": "domain"
             }
           ],
           "entityContract": {
@@ -183,6 +234,21 @@
                 "key": "INIT",
                 "name": "Initialize"
               },
+              {
+                "description": "Scopes the related fetch to rows whose relationField equals key.",
+                "id": "evt_01M0RY3YKG5AXYCBSMYMGG5B4E",
+                "key": "SHOW_RELATED",
+                "name": "Show Related",
+                "payloadSchema": [
+                  {
+                    "name": "key",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "scope, filter, focus, target",
+                "tier": "domain"
+              },
               {
                 "description": "Signals that related items have been successfully loaded.",
                 "id": "evt_01KXG04HB00F39QDW8TJMSKNJ9",
@@ -215,6 +281,25 @@
                 "synonyms": "error, failure, problem, unsuccessful",
                 "tier": "internal"
               },
+              {
+                "description": "Signals a related item was selected to drive a detail view.",
+                "id": "evt_01M0RY3YKG814RWTP8NGJZCGG7",
+                "key": "SELECT_RELATED",
+                "name": "Select Related",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "name",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "select, choose, open, view",
+                "tier": "domain"
+              },
               {
                 "id": "evt_01KYXKHATCCRC9NH1SPH7KH8BC",
                 "key": "RETRY",
@@ -274,6 +359,63 @@
                 "from": "loading",
                 "to": "loading"
               },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "RelatedItem",
+                    {
+                      "emit": {
+                        "failure": "RelatedItemLoadFailed",
+                        "success": "RelatedItemLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.relationField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.relationField"
+                          ],
+                          "@payload.key"
+                        ]
+                      ]
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading related…",
+                          "type": "typography",
+                          "variant": "caption"
+                        }
+                      ],
+                      "className": "py-8",
+                      "direction": "vertical",
+                      "gap": "sm",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "SHOW_RELATED",
+                "eventId": "evt_01M0RY3YKG5AXYCBSMYMGG5B4E",
+                "from": "loading",
+                "to": "loading"
+              },
               {
                 "effects": [
                   [
@@ -289,7 +431,7 @@
                               "type": "icon"
                             },
                             {
-                              "content": "Related",
+                              "content": "@config.title",
                               "type": "typography",
                               "variant": "h3"
                             }
@@ -309,15 +451,29 @@
                             "fn",
                             "item",
                             {
+                              "align": "center",
                               "children": [
                                 {
                                   "content": "@item.name",
                                   "type": "typography",
                                   "variant": "body"
+                                },
+                                {
+                                  "action": "SELECT_RELATED",
+                                  "actionPayload": {
+                                    "id": "@item.id",
+                                    "name": "@item.name"
+                                  },
+                                  "icon": "chevron-right",
+                                  "label": "Open",
+                                  "size": "sm",
+                                  "type": "button",
+                                  "variant": "ghost"
                                 }
                               ],
-                              "direction": "vertical",
+                              "direction": "horizontal",
                               "gap": "xs",
+                              "justify": "between",
                               "type": "stack"
                             }
                           ],
@@ -404,6 +560,61 @@
                 "from": "loaded",
                 "to": "loading"
               },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.id",
+                    "@payload.id"
+                  ]
+                ],
+                "event": "SELECT_RELATED",
+                "eventId": "evt_01M0RY3YKG814RWTP8NGJZCGG7",
+                "from": "loaded",
+                "to": "loaded"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "RelatedItem",
+                    {
+                      "emit": {
+                        "failure": "RelatedItemLoadFailed",
+                        "success": "RelatedItemLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.relationField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.relationField"
+                          ],
+                          "@payload.key"
+                        ]
+                      ]
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner"
+                    }
+                  ]
+                ],
+                "event": "SHOW_RELATED",
+                "eventId": "evt_01M0RY3YKG5AXYCBSMYMGG5B4E",
+                "from": "loaded",
+                "to": "loading"
+              },
               {
                 "effects": [
                   [
@@ -453,6 +664,48 @@
                 "eventId": "evt_01KYXKHATCCRC9NH1SPH7KH8BC",
                 "from": "error",
                 "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "RelatedItem",
+                    {
+                      "emit": {
+                        "failure": "RelatedItemLoadFailed",
+                        "success": "RelatedItemLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.relationField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.relationField"
+                          ],
+                          "@payload.key"
+                        ]
+                      ]
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner"
+                    }
+                  ]
+                ],
+                "event": "SHOW_RELATED",
+                "eventId": "evt_01M0RY3YKG5AXYCBSMYMGG5B4E",
+                "from": "error",
+                "to": "loading"
               }
             ]
           }
@@ -461,5 +714,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "1.0.0"
+  "version": "1.1.0"
 }