@almadar/std 16.196.0 → 16.198.0

package/behaviors/lolo/ui/game/atoms/ui-trait-slot.lolo

@@ -8,7 +8,7 @@ orbital TraitSlotOrbital {
     description : string
     iconEmoji : string
     iconUrl : TraitSlotEquippedItemIconUrl
-    stateMachine : object
+    stateMachine : TraitSlotEquippedItemStateMachine
   }
   type TraitSlotEquippedItemIconUrl = {
     url : asset!
@@ -24,6 +24,19 @@ orbital TraitSlotOrbital {
     name : string
     thumbnailUrl : string
   }
+  type TraitSlotEquippedItemStateMachine = {
+    name : string!
+    states : [string]!
+    currentState : string!
+    transitions : [TraitSlotEquippedItemStateMachineTransitionsItem]!
+    description : string
+  }
+  type TraitSlotEquippedItemStateMachineTransitionsItem = {
+    from : string!
+    to : string!
+    event : string!
+    guardHint : string
+  }
   type TraitSlotCategoryColorsValue = {
     bg : string!
     border : string!
@@ -55,7 +68,7 @@ orbital TraitSlotOrbital {
     description : string
     iconEmoji : string
     iconUrl : TraitSlotITEMDROPItemIconUrl
-    stateMachine : object
+    stateMachine : TraitSlotITEMDROPItemStateMachine
   }
   type TraitSlotITEMDROPItemIconUrl = {
     url : asset!
@@ -71,6 +84,19 @@ orbital TraitSlotOrbital {
     name : string
     thumbnailUrl : string
   }
+  type TraitSlotITEMDROPItemStateMachine = {
+    name : string!
+    states : [string]!
+    currentState : string!
+    transitions : [TraitSlotITEMDROPItemStateMachineTransitionsItem]!
+    description : string
+  }
+  type TraitSlotITEMDROPItemStateMachineTransitionsItem = {
+    from : string!
+    to : string!
+    event : string!
+    guardHint : string
+  }
   type TraitSlotDRAGSTARTItem = {
     id : string!
     name : string!
@@ -78,7 +104,7 @@ orbital TraitSlotOrbital {
     description : string
     iconEmoji : string
     iconUrl : TraitSlotDRAGSTARTItemIconUrl
-    stateMachine : object
+    stateMachine : TraitSlotDRAGSTARTItemStateMachine
   }
   type TraitSlotDRAGSTARTItemIconUrl = {
     url : asset!
@@ -94,6 +120,19 @@ orbital TraitSlotOrbital {
     name : string
     thumbnailUrl : string
   }
+  type TraitSlotDRAGSTARTItemStateMachine = {
+    name : string!
+    states : [string]!
+    currentState : string!
+    transitions : [TraitSlotDRAGSTARTItemStateMachineTransitionsItem]!
+    description : string
+  }
+  type TraitSlotDRAGSTARTItemStateMachineTransitionsItem = {
+    from : string!
+    to : string!
+    event : string!
+    guardHint : string
+  }
 
   entity TraitSlotItem [runtime] {
     id : string!

package/behaviors/lolo/ui/game/organisms/std-tactics-board-2d.lolo

@@ -138,7 +138,7 @@ orbital TacticsBoard2DOrbital {
     animTicksLeft : number = 0
     animAttackerId : string = ""
     animAtkTicksLeft : number = 0
-    svgAssetArt : json = {}
+    svgAssetArt : Map string Map string [node] = {}
   }
 
   trait TacticsAuthority = Tactics.traits.GridTactics -> GameState {

package/behaviors/lolo/ui/game/organisms/std-tactics-board-3d.lolo

@@ -144,7 +144,7 @@ orbital TacticsBoard3DOrbital {
     attackTargets : [ValidMove] = []
     uiPhase : string = "observation"
     turn : number = 0
-    meshAssetArt : json = {}
+    meshAssetArt : Map string Map string [node] = {}
   }
 
   trait TacticsAuthority = Tactics.traits.GridTactics -> GameState {

package/behaviors/lolo/ui/game/templates/ui-game-shell.lolo

@@ -97,9 +97,9 @@ orbital GameShellOrbital {
         @label "Hud Background Asset"
         @description "Per-call-site 9-sliced panel override. Chrome normally comes from the active theme (see the theme config knob); most callers leave this unset."
         @tier "presentation"
-      fontFamily : string = future
+      fontFamily : string = ""
         @label "Font Family"
-        @description "Game display-font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme."
+        @description "Game display-font key (pixel | fredoka | future | future-narrow | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme. Empty = the active theme's font-family-display token decides."
         @tier "presentation"
       theme : string = ""
         @label "Theme"

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

@@ -28,8 +28,8 @@ orbital LearnDiagramOrbital {
     selectedIndex : number = -1
     captionText : string
     readoutText : string
-    captionChildren : [json]
-    partButtons : [json]
+    captionChildren : [node]
+    partButtons : [node]
   }
 
   trait LearnDiagramSim -> @rebindable LearnDiagramScene [interaction, instance] {

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

@@ -66,7 +66,7 @@ orbital LearnStepperOrbital {
     tallyItems : [LearnStepperTallyItem]
     visibleThreadNote : string
     shapes : [LearnStepperShape]
-    filterButtons : [json]
+    filterButtons : [node]
   }
 
   trait LearnStepperSim -> @rebindable LearnStepperScene [interaction, instance] {

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

@@ -1,6 +1,68 @@
 app ui-biology-canvas "1.0.0"
 "BiologyCanvas — UI factory (1:1 with the @almadar/ui biology-canvas pattern)."
 orbital BiologyCanvasOrbital {
+  type BiologyCanvasCamera = {
+    pos : BiologyCanvasCameraPos
+    target : BiologyCanvasCameraTarget
+    zoom : number
+    fov : number
+    mode : "isometric" | "perspective" | "top-down" | "front" | "follow" | "chase"
+    azimuth : number
+    elevation : number
+  }
+  type BiologyCanvasCameraPos = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type BiologyCanvasCameraTarget = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type BiologyCanvasLighting = {
+    ambient : BiologyCanvasLightingAmbient
+    directional : BiologyCanvasLightingDirectional
+    hemisphere : BiologyCanvasLightingHemisphere
+    points : [BiologyCanvasLightingPointsItem]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type BiologyCanvasLightingAmbient = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type BiologyCanvasLightingDirectional = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type BiologyCanvasLightingHemisphere = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type BiologyCanvasLightingPointsItem = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type BiologyCanvasPost = {
+    bloom : BiologyCanvasPostBloom
+    vignette : BiologyCanvasPostVignette
+  }
+  type BiologyCanvasPostBloom = {
+    intensity : number
+    threshold : number
+    smoothing : number
+  }
+  type BiologyCanvasPostVignette = {
+    offset : number
+    darkness : number
+  }
   type BiologyCanvasNodesItem = {
     id : string
     x : number!
@@ -275,15 +337,15 @@ orbital BiologyCanvasOrbital {
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
         @tier "presentation"
-      camera : json = {}
+      camera : BiologyCanvasCamera
         @label "Camera"
         @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
         @tier "presentation"
-      lighting : object = {}
+      lighting : BiologyCanvasLighting
         @label "Lighting"
         @description "3D only: scene light rig as data."
         @tier "presentation"
-      post : object = {}
+      post : BiologyCanvasPost
         @label "Post"
         @description "3D only: post-processing stack (bloom/vignette)."
         @tier "presentation"

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

@@ -1,6 +1,68 @@
 app ui-chemistry-canvas "1.0.0"
 "ChemistryCanvas — UI factory (1:1 with the @almadar/ui chemistry-canvas pattern)."
 orbital ChemistryCanvasOrbital {
+  type ChemistryCanvasCamera = {
+    pos : ChemistryCanvasCameraPos
+    target : ChemistryCanvasCameraTarget
+    zoom : number
+    fov : number
+    mode : "isometric" | "perspective" | "top-down" | "front" | "follow" | "chase"
+    azimuth : number
+    elevation : number
+  }
+  type ChemistryCanvasCameraPos = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type ChemistryCanvasCameraTarget = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type ChemistryCanvasLighting = {
+    ambient : ChemistryCanvasLightingAmbient
+    directional : ChemistryCanvasLightingDirectional
+    hemisphere : ChemistryCanvasLightingHemisphere
+    points : [ChemistryCanvasLightingPointsItem]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type ChemistryCanvasLightingAmbient = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type ChemistryCanvasLightingDirectional = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type ChemistryCanvasLightingHemisphere = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type ChemistryCanvasLightingPointsItem = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type ChemistryCanvasPost = {
+    bloom : ChemistryCanvasPostBloom
+    vignette : ChemistryCanvasPostVignette
+  }
+  type ChemistryCanvasPostBloom = {
+    intensity : number
+    threshold : number
+    smoothing : number
+  }
+  type ChemistryCanvasPostVignette = {
+    offset : number
+    darkness : number
+  }
   type ChemistryCanvasAtomsItem = {
     id : string
     x : number!
@@ -271,15 +333,15 @@ orbital ChemistryCanvasOrbital {
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
         @tier "presentation"
-      camera : json = {}
+      camera : ChemistryCanvasCamera
         @label "Camera"
         @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
         @tier "presentation"
-      lighting : object = {}
+      lighting : ChemistryCanvasLighting
         @label "Lighting"
         @description "3D only: scene light rig as data."
         @tier "presentation"
-      post : object = {}
+      post : ChemistryCanvasPost
         @label "Post"
         @description "3D only: post-processing stack (bloom/vignette)."
         @tier "presentation"

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

@@ -37,6 +37,13 @@ orbital LearningCanvasOrbital {
     x : number!
     y : number!
   }
+  type LearningCanvasProjector = {
+    tileWidth : number!
+    floorHeight : number!
+    diamondTopY : number!
+    squareGrid : boolean!
+    worldPixelDirect : boolean!
+  }
   type LearningCanvasReadoutsItem = {
     label : string!
     value : string!
@@ -95,6 +102,8 @@ orbital LearningCanvasOrbital {
           height: @config.height
           backgroundColor: @config.backgroundColor
           shapes: @config.shapes
+          drawables: @config.drawables
+          projector: @config.projector
           readouts: @config.readouts
           traces: @config.traces
           interactive: @config.interactive
@@ -112,6 +121,8 @@ orbital LearningCanvasOrbital {
           height: @config.height
           backgroundColor: @config.backgroundColor
           shapes: @payload.shapes
+          drawables: @payload.drawables
+          projector: @config.projector
           readouts: @payload.readouts
           traces: @payload.traces
           interactive: @config.interactive
@@ -140,6 +151,7 @@ orbital LearningCanvasOrbital {
     listens {
       UPDATE {
         shapes : [LearningCanvasShapesItem]
+        drawables : [node]
         readouts : [LearningCanvasReadoutsItem]
         traces : [LearningCanvasTracesItem]
       }
@@ -169,6 +181,14 @@ orbital LearningCanvasOrbital {
         @label "Shapes"
         @description "Declarative shapes to draw."
         @tier "presentation"
+      drawables : [node] = []
+        @label "Drawables"
+        @description "Neutral game-canvas drawables (e.g. `draw-sprite`, `draw-fx-layer`) painted in world coordinates via the supplied `projector`. This lets the learning canvas reuse the game drawable vocabulary without reimplementing sprites/FX."
+        @tier "presentation"
+      projector : LearningCanvasProjector
+        @label "Projector"
+        @description "World-to-pixel projector for `drawables`. When absent, `drawables` are ignored."
+        @tier "presentation"
       readouts : [LearningCanvasReadoutsItem] = []
         @label "Readouts"
         @description "Top-right status chip row (live measurements, scores, counters)."

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

@@ -182,6 +182,7 @@ orbital MathCanvasOrbital {
           angles: @config.angles
           hops: @config.hops
           shapes: @config.shapes
+          drawables: @config.drawables
           readouts: @config.readouts
           traces: @config.traces
           interactive: @config.interactive
@@ -220,6 +221,7 @@ orbital MathCanvasOrbital {
           angles: @payload.angles
           hops: @payload.hops
           shapes: @payload.shapes
+          drawables: @payload.drawables
           readouts: @payload.readouts
           traces: @payload.traces
           interactive: @config.interactive
@@ -252,6 +254,7 @@ orbital MathCanvasOrbital {
         angles : [MathCanvasAnglesItem]
         hops : [MathCanvasHopsItem]
         shapes : [MathCanvasShapesItem]
+        drawables : [node]
         readouts : [MathCanvasReadoutsItem]
         traces : [MathCanvasTracesItem]
       }
@@ -361,6 +364,10 @@ orbital MathCanvasOrbital {
         @label "Shapes"
         @description "Extra declarative shapes in canvas pixel coordinates."
         @tier "presentation"
+      drawables : [node] = []
+        @label "Drawables"
+        @description "Game-canvas drawables painted in math world coordinates (e.g. `draw-sprite` for a character sprite on the graph). The canvas maps their `ScenePos` through the same x/y world→pixel transform used for curves/points."
+        @tier "presentation"
       readouts : [MathCanvasReadoutsItem] = []
         @label "Readouts"
         @description "Top-right status chips, forwarded verbatim to LearningCanvas."

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

@@ -1,6 +1,68 @@
 app ui-physics-canvas "1.0.0"
 "PhysicsCanvas — UI factory (1:1 with the @almadar/ui physics-canvas pattern)."
 orbital PhysicsCanvasOrbital {
+  type PhysicsCanvasCamera = {
+    pos : PhysicsCanvasCameraPos
+    target : PhysicsCanvasCameraTarget
+    zoom : number
+    fov : number
+    mode : "isometric" | "perspective" | "top-down" | "front" | "follow" | "chase"
+    azimuth : number
+    elevation : number
+  }
+  type PhysicsCanvasCameraPos = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type PhysicsCanvasCameraTarget = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type PhysicsCanvasLighting = {
+    ambient : PhysicsCanvasLightingAmbient
+    directional : PhysicsCanvasLightingDirectional
+    hemisphere : PhysicsCanvasLightingHemisphere
+    points : [PhysicsCanvasLightingPointsItem]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type PhysicsCanvasLightingAmbient = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type PhysicsCanvasLightingDirectional = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type PhysicsCanvasLightingHemisphere = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type PhysicsCanvasLightingPointsItem = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type PhysicsCanvasPost = {
+    bloom : PhysicsCanvasPostBloom
+    vignette : PhysicsCanvasPostVignette
+  }
+  type PhysicsCanvasPostBloom = {
+    intensity : number
+    threshold : number
+    smoothing : number
+  }
+  type PhysicsCanvasPostVignette = {
+    offset : number
+    darkness : number
+  }
   type PhysicsCanvasBodiesItem = {
     id : string
     x : number!
@@ -326,15 +388,15 @@ orbital PhysicsCanvasOrbital {
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
         @tier "presentation"
-      camera : json = {}
+      camera : PhysicsCanvasCamera
         @label "Camera"
         @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
         @tier "presentation"
-      lighting : object = {}
+      lighting : PhysicsCanvasLighting
         @label "Lighting"
         @description "3D only: scene light rig as data."
         @tier "presentation"
-      post : object = {}
+      post : PhysicsCanvasPost
         @label "Post"
         @description "3D only: post-processing stack (bloom/vignette)."
         @tier "presentation"

package/behaviors/registry/agent/atoms/std-agent-tool-call.orb

@@ -143,7 +143,7 @@
                 },
                 "toolCalls": {
                   "items": {
-                    "type": "object"
+                    "type": "opaque"
                   },
                   "name": "toolCalls",
                   "required": false,
@@ -172,7 +172,7 @@
                 "schema": {
                   "name": "schema",
                   "required": false,
-                  "type": "object"
+                  "type": "opaque"
                 }
               },
               "type": "object"
@@ -269,7 +269,7 @@
                       },
                       {
                         "name": "toolCalls",
-                        "type": "[object]"
+                        "type": "[opaque]"
                       },
                       {
                         "name": "toolCallId",
@@ -294,7 +294,7 @@
                       },
                       {
                         "name": "schema",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "required": true,

package/behaviors/registry/agent/atoms/std-agent-tool-loop.orb

@@ -179,7 +179,7 @@
                 },
                 "toolCalls": {
                   "items": {
-                    "type": "object"
+                    "type": "opaque"
                   },
                   "name": "toolCalls",
                   "required": false,
@@ -208,7 +208,7 @@
                 "schema": {
                   "name": "schema",
                   "required": false,
-                  "type": "object"
+                  "type": "opaque"
                 }
               },
               "type": "object"
@@ -338,7 +338,7 @@
                       },
                       {
                         "name": "toolCalls",
-                        "type": "[object]"
+                        "type": "[opaque]"
                       },
                       {
                         "name": "toolCallId",
@@ -363,7 +363,7 @@
                       },
                       {
                         "name": "schema",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "required": true,

package/behaviors/registry/infra/atoms/std-approval-gate.orb

@@ -354,7 +354,7 @@
             "description": "The held data of the gated action, replayed by the downstream listener when the request is granted.",
             "name": "payload",
             "synonyms": "request data, held payload, pending data, gated data",
-            "type": "object"
+            "type": "opaque"
           }
         ],
         "id": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
@@ -698,7 +698,7 @@
                     },
                     {
                       "name": "payload",
-                      "type": "object"
+                      "type": "opaque"
                     }
                   ],
                   "type": "object"
@@ -771,7 +771,7 @@
                     },
                     {
                       "name": "payload",
-                      "type": "object"
+                      "type": "opaque"
                     }
                   ],
                   "type": "object"
@@ -852,7 +852,7 @@
                 },
                 {
                   "name": "payload",
-                  "type": "object"
+                  "type": "opaque"
                 }
               ],
               "scope": "external",
@@ -1110,7 +1110,7 @@
                       },
                       {
                         "name": "payload",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "type": "object"
@@ -1184,7 +1184,7 @@
                       },
                       {
                         "name": "payload",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "type": "object"
@@ -1293,7 +1293,7 @@
                   },
                   {
                     "name": "payload",
-                    "type": "object"
+                    "type": "opaque"
                   }
                 ],
                 "synonyms": "approved, authorized, confirmed, validated",

package/behaviors/registry/infra/atoms/std-audit-capture.orb

@@ -99,14 +99,14 @@
             "description": "The state of the entity prior to the modification.",
             "name": "before",
             "synonyms": "previous, original, old value",
-            "type": "object"
+            "type": "opaque"
           },
           {
             "default": {},
             "description": "The state of the entity after a modification.",
             "name": "after",
             "synonyms": "new, updated, post, subsequent",
-            "type": "object"
+            "type": "opaque"
           },
           {
             "default": 0.0,
@@ -254,7 +254,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "object"
+                    "type": "@entity(captureEntity)"
                   }
                 ]
               },

package/behaviors/registry/infra/atoms/std-cascade-on-delete.orb

@@ -226,7 +226,7 @@
               "payloadSchema": [
                 {
                   "name": "data",
-                  "type": "[object]"
+                  "type": "[@entity(dependentEntity)]"
                 }
               ]
             },
@@ -277,7 +277,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "object"
+                    "type": "@entity(parentEntity)"
                   }
                 ]
               },
@@ -288,7 +288,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "[object]"
+                    "type": "[@entity(dependentEntity)]"
                   }
                 ]
               },