@almadar/std 16.210.0 → 16.212.0

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

@@ -0,0 +1,697 @@
+{
+  "description": "DrawSkinnedMesh — UI factory (1:1 with the @almadar/ui draw-skinned-mesh pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M2588YN3SJQ43YMGR99EG2WJ": {
+        "bakedName": "DrawSkinnedMeshItem",
+        "curName": "DrawSkinnedMeshItem",
+        "id": "ent_01M2588YN3SJQ43YMGR99EG2WJ",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M2588YN32G1WRQJ0GKMNAZZZ": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M2588YN32G1WRQJ0GKMNAZZZ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M2588YN3VK31Q6BRRDYMD5VQ",
+        "renames": []
+      },
+      "orb_01M2588YN3PSME7CJ2R3W0KFEW": {
+        "bakedName": "DrawSkinnedMeshOrbital",
+        "curName": "DrawSkinnedMeshOrbital",
+        "id": "orb_01M2588YN3PSME7CJ2R3W0KFEW",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M2588YN3N02BWRR8EP9RCTDH": {
+        "bakedName": "DrawSkinnedMeshPage",
+        "curName": "DrawSkinnedMeshPage",
+        "id": "pag_01M2588YN3N02BWRR8EP9RCTDH",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M2588YN3VK31Q6BRRDYMD5VQ": {
+        "bakedName": "DrawSkinnedMeshRender",
+        "curName": "DrawSkinnedMeshRender",
+        "id": "trt_01M2588YN3VK31Q6BRRDYMD5VQ",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-draw-skinned-mesh",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M2588YN3SJQ43YMGR99EG2WJ",
+        "name": "DrawSkinnedMeshItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M2588YN3PSME7CJ2R3W0KFEW",
+      "name": "DrawSkinnedMeshOrbital",
+      "pages": [
+        {
+          "id": "pag_01M2588YN3N02BWRR8EP9RCTDH",
+          "name": "DrawSkinnedMeshPage",
+          "path": "/draw-skinned-mesh",
+          "traits": [
+            {
+              "ref": "DrawSkinnedMeshRender",
+              "refId": "trt_01M2588YN3VK31Q6BRRDYMD5VQ"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "asset": {
+              "description": "The texture the mesh UVs cut into.",
+              "label": "Asset",
+              "properties": {
+                "animations": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "animations",
+                  "required": false,
+                  "type": "array"
+                },
+                "aspect": {
+                  "name": "aspect",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "1:1",
+                    "16:9",
+                    "5:7",
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
+                  ]
+                },
+                "atlas": {
+                  "name": "atlas",
+                  "required": false,
+                  "type": "string"
+                },
+                "category": {
+                  "name": "category",
+                  "required": true,
+                  "type": "string"
+                },
+                "dimension": {
+                  "name": "dimension",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "2d",
+                    "3d"
+                  ]
+                },
+                "name": {
+                  "name": "name",
+                  "required": false,
+                  "type": "string"
+                },
+                "role": {
+                  "name": "role",
+                  "required": true,
+                  "type": "string"
+                },
+                "sprite": {
+                  "name": "sprite",
+                  "required": false,
+                  "type": "string"
+                },
+                "style": {
+                  "name": "style",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "pixel",
+                    "vector",
+                    "hd",
+                    "1-bit",
+                    "isometric"
+                  ]
+                },
+                "thumbnailUrl": {
+                  "name": "thumbnailUrl",
+                  "required": false,
+                  "type": "string"
+                },
+                "url": {
+                  "name": "url",
+                  "required": true,
+                  "type": "string"
+                },
+                "variant": {
+                  "name": "variant",
+                  "required": false,
+                  "type": "string"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawSkinnedMeshAsset"
+            },
+            "bones": {
+              "default": [
+                {
+                  "name": "Name",
+                  "parent": "Parent",
+                  "pivot": [
+                    1.0,
+                    2.0
+                  ],
+                  "tip": [
+                    1.0,
+                    2.0
+                  ]
+                },
+                {
+                  "name": "Name 2",
+                  "parent": "Parent 2",
+                  "pivot": [
+                    1.0,
+                    2.0
+                  ],
+                  "tip": [
+                    1.0,
+                    2.0
+                  ]
+                }
+              ],
+              "description": "The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty.",
+              "items": {
+                "properties": {
+                  "name": {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "parent": {
+                    "name": "parent",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "pivot": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "name": "pivot",
+                    "required": true,
+                    "type": "array"
+                  },
+                  "tip": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "name": "tip",
+                    "required": true,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Bones",
+              "tier": "presentation",
+              "type": "[DrawSkinnedMeshBonesItem]"
+            },
+            "clip": {
+              "description": "Pose animation clip; with `frame`, pose = `frames[frame % frames.length]`.",
+              "label": "Clip",
+              "properties": {
+                "frames": {
+                  "items": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "type": "object"
+                  },
+                  "name": "frames",
+                  "required": true,
+                  "type": "array"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawSkinnedMeshClip"
+            },
+            "clipName": {
+              "description": "Named clip inside the rigbundle at `meshUrl` (`clips[clipName].frames`); used when `clip` is absent. Empty/unknown = no clip.",
+              "label": "Clip Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "frame": {
+              "description": "Clip frame counter (host-driven paint clock frame).",
+              "label": "Frame",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "ghost": {
+              "description": "Onion skin: render the mesh at this clip frame underneath, at this opacity.",
+              "label": "Ghost",
+              "properties": {
+                "frame": {
+                  "name": "frame",
+                  "required": true,
+                  "type": "number"
+                },
+                "opacity": {
+                  "name": "opacity",
+                  "required": true,
+                  "type": "number"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawSkinnedMeshGhost"
+            },
+            "mesh": {
+              "description": "Inline bind mesh; wins over `meshUrl`.",
+              "label": "Mesh",
+              "properties": {
+                "triangles": {
+                  "items": {
+                    "items": {
+                      "type": "number"
+                    },
+                    "type": "array"
+                  },
+                  "name": "triangles",
+                  "required": true,
+                  "type": "array"
+                },
+                "vertices": {
+                  "items": {
+                    "properties": {
+                      "u": {
+                        "name": "u",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "v": {
+                        "name": "v",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "weights": {
+                        "items": {
+                          "properties": {
+                            "bone": {
+                              "name": "bone",
+                              "required": true,
+                              "type": "number"
+                            },
+                            "w": {
+                              "name": "w",
+                              "required": true,
+                              "type": "number"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "name": "weights",
+                        "required": true,
+                        "type": "array"
+                      },
+                      "x": {
+                        "name": "x",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "y": {
+                        "name": "y",
+                        "required": true,
+                        "type": "number"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "vertices",
+                  "required": true,
+                  "type": "array"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawSkinnedMeshMesh"
+            },
+            "meshUrl": {
+              "description": "URL of a JSON `SkinMesh` (fetched + cached); used when `mesh` is absent.",
+              "label": "Mesh Url",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "opacity": {
+              "description": "0..1 opacity.",
+              "label": "Opacity",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "pose": {
+              "default": {
+                "item": 1.0
+              },
+              "description": "Static pose (bone name → degrees relative to bind). Overridden by `clip` + `frame`.",
+              "items": {
+                "type": "number"
+              },
+              "label": "Pose",
+              "tier": "presentation",
+              "type": "Map<string,number>"
+            },
+            "position": {
+              "default": {
+                "x": 1.0,
+                "y": 1.0,
+                "z": 1.0
+              },
+              "description": "Logical scene position; mesh local coords are world units relative to its projected top-left.",
+              "label": "Position",
+              "properties": {
+                "x": {
+                  "name": "x",
+                  "required": true,
+                  "type": "number"
+                },
+                "y": {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                },
+                "z": {
+                  "name": "z",
+                  "required": false,
+                  "type": "number"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawSkinnedMeshPosition"
+            },
+            "weightsOverlay": {
+              "description": "Paint per-triangle dominant-bone colors instead of the texture (rig inspection).",
+              "label": "Weights Overlay",
+              "tier": "presentation",
+              "type": "boolean"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DrawSkinnedMeshItem": "ent_01M2588YN3SJQ43YMGR99EG2WJ"
+          },
+          "id": "trt_01M2588YN3VK31Q6BRRDYMD5VQ",
+          "linkedEntity": "DrawSkinnedMeshItem",
+          "linkedEntityId": "ent_01M2588YN3SJQ43YMGR99EG2WJ",
+          "name": "DrawSkinnedMeshRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M2588YN32G1WRQJ0GKMNAZZZ",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "asset": "@config.asset",
+                      "bones": "@config.bones",
+                      "clip": "@config.clip",
+                      "clipName": "@config.clipName",
+                      "frame": "@config.frame",
+                      "ghost": "@config.ghost",
+                      "mesh": "@config.mesh",
+                      "meshUrl": "@config.meshUrl",
+                      "opacity": "@config.opacity",
+                      "pose": "@config.pose",
+                      "position": "@config.position",
+                      "type": "draw-skinned-mesh",
+                      "weightsOverlay": "@config.weightsOverlay"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M2588YN32G1WRQJ0GKMNAZZZ",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "DrawSkinnedMeshAsset": [
+          {
+            "name": "url",
+            "required": true,
+            "type": "asset"
+          },
+          {
+            "name": "role",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "category",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "animations",
+            "type": "[string]"
+          },
+          {
+            "name": "style",
+            "type": "string"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "dimension",
+            "type": "string"
+          },
+          {
+            "name": "aspect",
+            "type": "string"
+          },
+          {
+            "name": "atlas",
+            "type": "asset"
+          },
+          {
+            "name": "sprite",
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "type": "string"
+          },
+          {
+            "name": "thumbnailUrl",
+            "type": "string"
+          }
+        ],
+        "DrawSkinnedMeshBonesItem": [
+          {
+            "name": "name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "parent",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "pivot",
+            "required": true,
+            "type": "[number]"
+          },
+          {
+            "name": "tip",
+            "required": true,
+            "type": "[number]"
+          }
+        ],
+        "DrawSkinnedMeshClip": [
+          {
+            "name": "frames",
+            "required": true,
+            "type": "[Map<string,number>]"
+          }
+        ],
+        "DrawSkinnedMeshGhost": [
+          {
+            "name": "frame",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "opacity",
+            "required": true,
+            "type": "number"
+          }
+        ],
+        "DrawSkinnedMeshMesh": [
+          {
+            "name": "vertices",
+            "properties": [
+              {
+                "name": "x",
+                "required": true,
+                "type": "number"
+              },
+              {
+                "name": "y",
+                "required": true,
+                "type": "number"
+              },
+              {
+                "name": "u",
+                "required": true,
+                "type": "number"
+              },
+              {
+                "name": "v",
+                "required": true,
+                "type": "number"
+              },
+              {
+                "name": "weights",
+                "properties": [
+                  {
+                    "name": "bone",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "w",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "required": true,
+                "type": "[object]"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          },
+          {
+            "name": "triangles",
+            "required": true,
+            "type": "[[number]]"
+          }
+        ],
+        "DrawSkinnedMeshMeshVerticesItem": [
+          {
+            "name": "x",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "y",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "u",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "v",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "weights",
+            "properties": [
+              {
+                "name": "bone",
+                "required": true,
+                "type": "number"
+              },
+              {
+                "name": "w",
+                "required": true,
+                "type": "number"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          }
+        ],
+        "DrawSkinnedMeshMeshVerticesItemWeightsItem": [
+          {
+            "name": "bone",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "w",
+            "required": true,
+            "type": "number"
+          }
+        ],
+        "DrawSkinnedMeshPosition": [
+          {
+            "name": "x",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "y",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "z",
+            "type": "number"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}