@almadar/std 16.196.0 → 16.198.0

package/behaviors/registry/ui/learning/atoms/ui-learning-canvas.orb

@@ -126,6 +126,16 @@
               "tier": "presentation",
               "type": "string"
             },
+            "drawables": {
+              "default": [],
+              "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.",
+              "items": {
+                "type": "node"
+              },
+              "label": "Drawables",
+              "tier": "presentation",
+              "type": "[node]"
+            },
             "error": {
               "description": "Error state.",
               "label": "Error",
@@ -188,6 +198,39 @@
               "tier": "presentation",
               "type": "event"
             },
+            "projector": {
+              "description": "World-to-pixel projector for `drawables`. When absent, `drawables` are ignored.",
+              "label": "Projector",
+              "properties": {
+                "diamondTopY": {
+                  "name": "diamondTopY",
+                  "required": true,
+                  "type": "number"
+                },
+                "floorHeight": {
+                  "name": "floorHeight",
+                  "required": true,
+                  "type": "number"
+                },
+                "squareGrid": {
+                  "name": "squareGrid",
+                  "required": true,
+                  "type": "boolean"
+                },
+                "tileWidth": {
+                  "name": "tileWidth",
+                  "required": true,
+                  "type": "number"
+                },
+                "worldPixelDirect": {
+                  "name": "worldPixelDirect",
+                  "required": true,
+                  "type": "boolean"
+                }
+              },
+              "tier": "presentation",
+              "type": "LearningCanvasProjector"
+            },
             "readouts": {
               "default": [],
               "description": "Top-right status chip row (live measurements, scores, counters).",
@@ -533,6 +576,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onShapeClick",
               "description": "Clicked shape payload: { id?, type?, index }.",
               "event": "@config.onShapeClick",
               "eventId": "evt_01KXG052TZPXV2VEPJJ9J5T8MK",
@@ -561,6 +605,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onShapeHover",
               "description": "Hovered shape payload: { id?, type?, index }.",
               "event": "@config.onShapeHover",
               "eventId": "evt_01KXG052TZ4K38344BSHEHV9H7",
@@ -754,6 +799,10 @@
                     ],
                     "type": "[object]"
                   },
+                  {
+                    "name": "drawables",
+                    "type": "[node]"
+                  },
                   {
                     "name": "readouts",
                     "properties": [
@@ -925,12 +974,14 @@
                       "animate": "@config.animate",
                       "backgroundColor": "@config.backgroundColor",
                       "className": "@config.className",
+                      "drawables": "@config.drawables",
                       "error": "@config.error",
                       "height": "@config.height",
                       "interactive": "@config.interactive",
                       "isLoading": "@config.isLoading",
                       "onShapeClick": "@config.onShapeClick",
                       "onShapeHover": "@config.onShapeHover",
+                      "projector": "@config.projector",
                       "readouts": "@config.readouts",
                       "shapes": "@config.shapes",
                       "traces": "@config.traces",
@@ -953,12 +1004,14 @@
                       "animate": "@config.animate",
                       "backgroundColor": "@config.backgroundColor",
                       "className": "@config.className",
+                      "drawables": "@payload.drawables",
                       "error": "@config.error",
                       "height": "@config.height",
                       "interactive": "@config.interactive",
                       "isLoading": "@config.isLoading",
                       "onShapeClick": "@config.onShapeClick",
                       "onShapeHover": "@config.onShapeHover",
+                      "projector": "@config.projector",
                       "readouts": "@payload.readouts",
                       "shapes": "@payload.shapes",
                       "traces": "@payload.traces",

package/behaviors/registry/ui/learning/atoms/ui-math-canvas.orb

@@ -264,6 +264,16 @@
               "tier": "presentation",
               "type": "[MathCanvasCurvesItem]"
             },
+            "drawables": {
+              "default": [],
+              "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.",
+              "items": {
+                "type": "node"
+              },
+              "label": "Drawables",
+              "tier": "presentation",
+              "type": "[node]"
+            },
             "error": {
               "description": "error prop",
               "label": "Error",
@@ -999,6 +1009,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onShapeClick",
               "description": "onShapeClick prop",
               "event": "@config.onShapeClick",
               "eventId": "evt_01M0EX2TWN9ECF7VFCQV91PV0W",
@@ -1471,6 +1482,10 @@
                     ],
                     "type": "[object]"
                   },
+                  {
+                    "name": "drawables",
+                    "type": "[node]"
+                  },
                   {
                     "name": "readouts",
                     "properties": [
@@ -1618,6 +1633,7 @@
                       "bars": "@config.bars",
                       "className": "@config.className",
                       "curves": "@config.curves",
+                      "drawables": "@config.drawables",
                       "error": "@config.error",
                       "gridColor": "@config.gridColor",
                       "gridStep": "@config.gridStep",
@@ -1667,6 +1683,7 @@
                       "bars": "@payload.bars",
                       "className": "@config.className",
                       "curves": "@payload.curves",
+                      "drawables": "@payload.drawables",
                       "error": "@config.error",
                       "gridColor": "@config.gridColor",
                       "gridStep": "@config.gridStep",

package/behaviors/registry/ui/learning/atoms/ui-physics-canvas.orb

@@ -236,11 +236,89 @@
               "type": "[PhysicsCanvasBodiesItem]"
             },
             "camera": {
-              "default": {},
               "description": "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target }).",
               "label": "Camera",
+              "properties": {
+                "azimuth": {
+                  "name": "azimuth",
+                  "required": false,
+                  "type": "number"
+                },
+                "elevation": {
+                  "name": "elevation",
+                  "required": false,
+                  "type": "number"
+                },
+                "fov": {
+                  "name": "fov",
+                  "required": false,
+                  "type": "number"
+                },
+                "mode": {
+                  "name": "mode",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "isometric",
+                    "perspective",
+                    "top-down",
+                    "front",
+                    "follow",
+                    "chase"
+                  ]
+                },
+                "pos": {
+                  "name": "pos",
+                  "properties": {
+                    "x": {
+                      "name": "x",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "y": {
+                      "name": "y",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "z": {
+                      "name": "z",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "target": {
+                  "name": "target",
+                  "properties": {
+                    "x": {
+                      "name": "x",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "y": {
+                      "name": "y",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "z": {
+                      "name": "z",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "zoom": {
+                  "name": "zoom",
+                  "required": false,
+                  "type": "number"
+                }
+              },
               "tier": "presentation",
-              "type": "json"
+              "type": "PhysicsCanvasCamera"
             },
             "className": {
               "description": "className prop",
@@ -398,11 +476,140 @@
               "type": "boolean"
             },
             "lighting": {
-              "default": {},
               "description": "3D only: scene light rig as data.",
               "label": "Lighting",
+              "properties": {
+                "ambient": {
+                  "name": "ambient",
+                  "properties": {
+                    "color": {
+                      "name": "color",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "position": {
+                      "items": {
+                        "type": "number"
+                      },
+                      "name": "position",
+                      "required": false,
+                      "type": "array"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "directional": {
+                  "name": "directional",
+                  "properties": {
+                    "color": {
+                      "name": "color",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "position": {
+                      "items": {
+                        "type": "number"
+                      },
+                      "name": "position",
+                      "required": false,
+                      "type": "array"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "environment": {
+                  "name": "environment",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "room",
+                    "none"
+                  ]
+                },
+                "hemisphere": {
+                  "name": "hemisphere",
+                  "properties": {
+                    "color": {
+                      "name": "color",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "groundColor": {
+                      "name": "groundColor",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "points": {
+                  "items": {
+                    "properties": {
+                      "color": {
+                        "name": "color",
+                        "required": false,
+                        "type": "string"
+                      },
+                      "decay": {
+                        "name": "decay",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "distance": {
+                        "name": "distance",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "intensity": {
+                        "name": "intensity",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "position": {
+                        "items": {
+                          "type": "number"
+                        },
+                        "name": "position",
+                        "required": true,
+                        "type": "array"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "points",
+                  "required": false,
+                  "type": "array"
+                },
+                "toneMapping": {
+                  "name": "toneMapping",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "aces",
+                    "none"
+                  ]
+                }
+              },
               "tier": "presentation",
-              "type": "object"
+              "type": "PhysicsCanvasLighting"
             },
             "meters": {
               "default": [],
@@ -455,11 +662,51 @@
               "type": "event"
             },
             "post": {
-              "default": {},
               "description": "3D only: post-processing stack (bloom/vignette).",
               "label": "Post",
+              "properties": {
+                "bloom": {
+                  "name": "bloom",
+                  "properties": {
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "smoothing": {
+                      "name": "smoothing",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "threshold": {
+                      "name": "threshold",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "vignette": {
+                  "name": "vignette",
+                  "properties": {
+                    "darkness": {
+                      "name": "darkness",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "offset": {
+                      "name": "offset",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                }
+              },
               "tier": "presentation",
-              "type": "object"
+              "type": "PhysicsCanvasPost"
             },
             "readouts": {
               "default": [],
@@ -1190,6 +1437,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onShapeClick",
               "description": "onShapeClick prop",
               "event": "@config.onShapeClick",
               "eventId": "evt_01M055GQAA3XBD1GWQJE6F3DX1",