@almadar/std 16.158.0 → 16.160.0

package/behaviors/registry/ui/game/atoms/ui-draw-group.orb

@@ -80,6 +80,100 @@
         {
           "category": "interaction",
           "config": {
+            "animation": {
+              "description": "Keyframe animation over the group TRANSFORM tracks (`offsetX/Y/Z` in cells, `rotateX/Y/Z` in radians, `scale`; the 2D painter also honors `opacity`) — children inherit it, so nested animated groups form a joint chain. Material tracks belong on leaf meshes.",
+              "label": "Animation",
+              "properties": {
+                "durationMs": {
+                  "name": "durationMs",
+                  "required": true,
+                  "type": "number"
+                },
+                "keyframes": {
+                  "items": {
+                    "properties": {
+                      "at": {
+                        "name": "at",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "color": {
+                        "name": "color",
+                        "required": false,
+                        "type": "string"
+                      },
+                      "emissive": {
+                        "name": "emissive",
+                        "required": false,
+                        "type": "string"
+                      },
+                      "emissiveIntensity": {
+                        "name": "emissiveIntensity",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "offsetX": {
+                        "name": "offsetX",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "offsetY": {
+                        "name": "offsetY",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "offsetZ": {
+                        "name": "offsetZ",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "opacity": {
+                        "name": "opacity",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "rotateX": {
+                        "name": "rotateX",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "rotateY": {
+                        "name": "rotateY",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "rotateZ": {
+                        "name": "rotateZ",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "scale": {
+                        "name": "scale",
+                        "required": false,
+                        "type": "number"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "keyframes",
+                  "required": true,
+                  "type": "array"
+                },
+                "loop": {
+                  "name": "loop",
+                  "required": false,
+                  "type": "boolean"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawGroupAnimation"
+            },
+            "bone": {
+              "description": "Skeleton bone name. A named group is addressable by a `draw-mesh` `skin` block (smooth skinning): the skinned mesh deforms with this group's animated transform. Names resolve within the nearest enclosing `skeleton: true` group (falling back to the canvas), so multiple instances of one rig never collide. Distinct from `id` (the hit-test handle).",
+              "label": "Bone",
+              "tier": "presentation",
+              "type": "string"
+            },
             "clip": {
               "description": "Clip the group's items to an SVG path (`d` syntax) in world units relative to the group origin — masked reveals, meters, portraits.",
               "label": "Clip",
@@ -136,11 +230,27 @@
               "tier": "presentation",
               "type": "number"
             },
+            "rotation": {
+              "default": [],
+              "description": "Euler rotation `[x, y, z]` in radians (world axes) — per-axis joint rotation for the 3D backend; a group placed at a joint with children authored joint-local IS a bone. The 2D painter applies only the in-plane `z` component, after `rotate`.",
+              "items": {
+                "type": "number"
+              },
+              "label": "Rotation",
+              "tier": "presentation",
+              "type": "[number]"
+            },
             "scale": {
               "description": "Uniform scale applied to the whole group.",
               "label": "Scale",
               "tier": "presentation",
               "type": "number"
+            },
+            "skeleton": {
+              "description": "Marks this group as a skeleton SCOPE: `bone` names and `skin` bindings in its subtree resolve against each other only — one scope per rig instance.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "boolean"
             }
           },
           "entityContract": {
@@ -177,12 +287,16 @@
                     "render-ui",
                     "main",
                     {
+                      "animation": "@config.animation",
+                      "bone": "@config.bone",
                       "clip": "@config.clip",
                       "items": "@config.items",
                       "opacity": "@config.opacity",
                       "position": "@config.position",
                       "rotate": "@config.rotate",
+                      "rotation": "@config.rotation",
                       "scale": "@config.scale",
+                      "skeleton": "@config.skeleton",
                       "type": "draw-group"
                     }
                   ]

package/behaviors/registry/ui/game/atoms/ui-draw-mesh.orb

@@ -180,6 +180,19 @@
               "tier": "presentation",
               "type": "number"
             },
+            "faces": {
+              "default": [],
+              "description": "`polyhedron` only: triangle index triples into `vertices`, wound counter-clockwise seen from OUTSIDE in the scene frame.",
+              "items": {
+                "items": {
+                  "type": "number"
+                },
+                "type": "array"
+              },
+              "label": "Faces",
+              "tier": "presentation",
+              "type": "[[number]]"
+            },
             "height": {
               "description": "Box Y (height) extent / capsule-cylinder-cone length in cells (default 1).",
               "label": "Height",
@@ -286,7 +299,7 @@
             },
             "pivot": {
               "default": "bottom",
-              "description": "`bottom` (default) rests the mesh on its position's ground plane; `center` centers it there.",
+              "description": "`bottom` (default) rests the mesh on its position's ground plane; `center` centers it there. For `polyhedron`, `bottom` lifts by −min(z) and `center` applies no offset — the vertices are authoritative.",
               "label": "Pivot",
               "tier": "presentation",
               "type": "string",
@@ -377,15 +390,78 @@
                 "cone",
                 "torus",
                 "plane",
-                "circle"
+                "circle",
+                "polyhedron"
               ]
             },
+            "skin": {
+              "description": "`polyhedron` only: smooth-skinning weights binding the vertices to named bone groups. Vertices must then be authored in BIND POSE model space; the bones' animated transforms deform them.",
+              "label": "Skin",
+              "properties": {
+                "bones": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "bones",
+                  "required": true,
+                  "type": "array"
+                },
+                "indices": {
+                  "items": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "type": "array"
+                  },
+                  "name": "indices",
+                  "required": true,
+                  "type": "array"
+                },
+                "inverseBindMatrices": {
+                  "items": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "type": "array"
+                  },
+                  "name": "inverseBindMatrices",
+                  "required": true,
+                  "type": "array"
+                },
+                "weights": {
+                  "items": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "type": "array"
+                  },
+                  "name": "weights",
+                  "required": true,
+                  "type": "array"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawMeshSkin"
+            },
             "tube": {
               "description": "Torus tube radius in cells (default `radius` / 3).",
               "label": "Tube",
               "tier": "presentation",
               "type": "number"
             },
+            "vertices": {
+              "default": [],
+              "description": "`polyhedron` only: raw vertices as scene-frame `[x, y, z]` triples in cells, `z` = up.",
+              "items": {
+                "items": {
+                  "type": "number"
+                },
+                "type": "array"
+              },
+              "label": "Vertices",
+              "tier": "presentation",
+              "type": "[[number]]"
+            },
             "width": {
               "description": "Box/plane X extent in cells (default 1).",
               "label": "Width",
@@ -430,6 +506,7 @@
                       "animation": "@config.animation",
                       "castShadow": "@config.castShadow",
                       "depth": "@config.depth",
+                      "faces": "@config.faces",
                       "height": "@config.height",
                       "material": "@config.material",
                       "opacity": "@config.opacity",
@@ -443,8 +520,10 @@
                       "rotation": "@config.rotation",
                       "segments": "@config.segments",
                       "shape": "@config.shape",
+                      "skin": "@config.skin",
                       "tube": "@config.tube",
                       "type": "draw-mesh",
+                      "vertices": "@config.vertices",
                       "width": "@config.width"
                     }
                   ]

package/behaviors/registry/ui/game/molecules/std-tactics-board-3d.orb

@@ -338,6 +338,11 @@
                   "required": false,
                   "type": "number"
                 },
+                "yaw": {
+                  "name": "yaw",
+                  "required": false,
+                  "type": "number"
+                },
                 "z": {
                   "name": "z",
                   "required": false,
@@ -2181,6 +2186,24 @@
                                                   "z"
                                                 ]
                                               },
+                                              "rotate": [
+                                                "-",
+                                                0.0,
+                                                [
+                                                  "if",
+                                                  [
+                                                    "object/get",
+                                                    "@u",
+                                                    "yaw"
+                                                  ],
+                                                  [
+                                                    "object/get",
+                                                    "@u",
+                                                    "yaw"
+                                                  ],
+                                                  0.0
+                                                ]
+                                              ],
                                               "scale": "@config.meshUnitScale",
                                               "type": "draw-group"
                                             }
@@ -3583,6 +3606,24 @@
                                                 "z"
                                               ]
                                             },
+                                            "rotate": [
+                                              "-",
+                                              0.0,
+                                              [
+                                                "if",
+                                                [
+                                                  "object/get",
+                                                  "@u",
+                                                  "yaw"
+                                                ],
+                                                [
+                                                  "object/get",
+                                                  "@u",
+                                                  "yaw"
+                                                ],
+                                                0.0
+                                              ]
+                                            ],
                                             "scale": "@config.meshUnitScale",
                                             "type": "draw-group"
                                           }