@almadar/core 10.89.0 → 10.91.0

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-09-08T23:56:00.442Z",
+  "exportedAt": "2026-09-12T07:27:39.835Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -4301,7 +4301,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -4461,7 +4464,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -7495,6 +7501,7 @@
     "button": {
       "type": "button",
       "category": "component",
+      "sourceFile": "components/core/atoms/Button.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Clickable button that emits events",
@@ -7639,7 +7646,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -7681,7 +7691,8 @@
             "object"
           ],
           "description": "Payload to include with the action event",
-          "payloadFor": "action"
+          "payloadFor": "action",
+          "eventPayloadBrand": true
         },
         "label": {
           "types": [
@@ -7706,6 +7717,7 @@
     "badge": {
       "type": "badge",
       "category": "component",
+      "sourceFile": "components/core/atoms/Badge.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Small label for status or count",
@@ -7837,7 +7849,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -8337,6 +8352,7 @@
     "input": {
       "type": "input",
       "category": "component",
+      "sourceFile": "components/core/atoms/Input.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Text input field",
@@ -8505,7 +8521,15 @@
             "function",
             "string"
           ],
-          "description": "onChange handler or declarative event key for trait dispatch"
+          "description": "onChange handler or declarative event key for trait dispatch",
+          "kind": "event-ref",
+          "emitPayloadSchema": [
+            {
+              "name": "_payload",
+              "type": "object",
+              "required": false
+            }
+          ]
         }
       }
     },
@@ -8558,13 +8582,22 @@
             "function",
             "string"
           ],
-          "description": "onChange handler or declarative event key for trait dispatch"
+          "description": "onChange handler or declarative event key for trait dispatch",
+          "kind": "event-ref",
+          "emitPayloadSchema": [
+            {
+              "name": "value",
+              "type": "string",
+              "required": true
+            }
+          ]
         }
       }
     },
     "select": {
       "type": "select",
       "category": "component",
+      "sourceFile": "components/core/atoms/Select.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Dropdown select input",
@@ -8728,14 +8761,52 @@
             "function",
             "string"
           ],
-          "description": "onChange handler (native ChangeEvent) or declarative event key for trait dispatch"
+          "description": "onChange handler (native ChangeEvent) or declarative event key for trait dispatch",
+          "kind": "event-ref",
+          "emitPayloadSchema": [
+            {
+              "name": "value",
+              "type": "string",
+              "required": true,
+              "schema": {
+                "types": [
+                  "string",
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "string"
+                  ]
+                }
+              }
+            }
+          ]
         },
         "onValueChange": {
           "types": [
             "function",
             "string"
           ],
-          "description": "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
+          "description": "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback.",
+          "kind": "event-ref",
+          "emitPayloadSchema": [
+            {
+              "name": "value",
+              "type": "string",
+              "required": true,
+              "schema": {
+                "types": [
+                  "string",
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "string"
+                  ]
+                }
+              }
+            }
+          ]
         }
       }
     },
@@ -8781,7 +8852,15 @@
             "function",
             "string"
           ],
-          "description": "onChange handler or declarative event key for trait dispatch"
+          "description": "onChange handler or declarative event key for trait dispatch",
+          "kind": "event-ref",
+          "emitPayloadSchema": [
+            {
+              "name": "checked",
+              "type": "boolean",
+              "required": true
+            }
+          ]
         }
       }
     },
@@ -11282,6 +11361,7 @@
     "input-group": {
       "type": "input-group",
       "category": "form",
+      "sourceFile": "components/core/molecules/InputGroup.tsx",
       "tier": "molecules",
       "family": "core",
       "description": "InputGroup Molecule Component  A component for grouping input with addons (icons, buttons, text). Uses Input, Button, Icon, and Typography atoms.",
@@ -11442,7 +11522,15 @@
             "function",
             "string"
           ],
-          "description": "onChange handler or declarative event key for trait dispatch"
+          "description": "onChange handler or declarative event key for trait dispatch",
+          "kind": "event-ref",
+          "emitPayloadSchema": [
+            {
+              "name": "_payload",
+              "type": "object",
+              "required": false
+            }
+          ]
         },
         "leftAddon": {
           "types": [
@@ -13740,6 +13828,7 @@
     "game-shell": {
       "type": "game-shell",
       "category": "game",
+      "sourceFile": "components/game/templates/GameShell.tsx",
       "tier": "templates",
       "family": "game",
       "description": "GameShell  A full-screen layout wrapper for game applications. Replaces DashboardLayout for game clients — no sidebar nav, just full-viewport rendering with an optional HUD overlay bar.  Used as a React Router layout route element: <Route element={<GameShell appName=\"TraitWars\" />}> <Route index element={<WorldMapPage />} /> ... </Route>",
@@ -13865,7 +13954,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -13960,7 +14052,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28228,6 +28323,7 @@
     "choice-button": {
       "type": "choice-button",
       "category": "game",
+      "sourceFile": "components/game/atoms/ChoiceButton.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "ChoiceButton component",
@@ -28317,7 +28413,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28407,6 +28506,7 @@
     "control-button": {
       "type": "control-button",
       "category": "game",
+      "sourceFile": "components/game/atoms/ControlButton.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "ControlButton component",
@@ -28482,7 +28582,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28599,6 +28702,7 @@
     "dialogue-bubble": {
       "type": "dialogue-bubble",
       "category": "game",
+      "sourceFile": "components/game/atoms/DialogueBubble.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "DialogueBubble component",
@@ -28689,7 +28793,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28760,6 +28867,7 @@
     "health-bar": {
       "type": "health-bar",
       "category": "game",
+      "sourceFile": "components/game/atoms/HealthBar.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "HealthBar component",
@@ -28908,7 +29016,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -29003,7 +29114,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -29038,6 +29152,7 @@
     "score-display": {
       "type": "score-display",
       "category": "game",
+      "sourceFile": "components/game/atoms/ScoreDisplay.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "ScoreDisplay component",
@@ -29113,7 +29228,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -29200,6 +29318,7 @@
     "timer-display": {
       "type": "timer-display",
       "category": "game",
+      "sourceFile": "components/game/atoms/TimerDisplay.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "TimerDisplay component",
@@ -29326,7 +29445,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -31596,6 +31718,7 @@
     "game-hud": {
       "type": "game-hud",
       "category": "game",
+      "sourceFile": "components/game/molecules/GameHud.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "GameHud component",
@@ -31686,7 +31809,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -31780,7 +31906,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -31937,7 +32066,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32031,7 +32163,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32220,7 +32355,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32567,7 +32705,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -32608,6 +32749,7 @@
     "stat-badge": {
       "type": "stat-badge",
       "category": "game",
+      "sourceFile": "components/game/molecules/StatBadge.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "StatBadge component",
@@ -32683,7 +32825,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -32778,7 +32923,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -33304,6 +33452,7 @@
     "game-audio-toggle": {
       "type": "game-audio-toggle",
       "category": "game",
+      "sourceFile": "components/game/atoms/GameAudioToggle.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "GameAudioToggle component",
@@ -33435,7 +33584,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -33530,7 +33682,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -33579,6 +33734,7 @@
     "trait-slot": {
       "type": "trait-slot",
       "category": "game",
+      "sourceFile": "components/game/molecules/TraitSlot.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "Event Contract: Emits: UI:CLICK Emits: UI:REMOVE",
@@ -33691,7 +33847,10 @@
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 "atlas": {
@@ -33934,7 +34093,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -34111,7 +34273,10 @@
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       "atlas": {
@@ -34337,7 +34502,10 @@
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       "atlas": {
@@ -34532,6 +34700,7 @@
     "action-palette": {
       "type": "action-palette",
       "category": "game",
+      "sourceFile": "components/game/molecules/ActionPalette.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "ActionPalette Component  Grid of draggable ActionTile components for the Sequencer tier. Kids pick from these to build their sequence.",
@@ -34642,7 +34811,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -34830,6 +35002,7 @@
     "action-tile": {
       "type": "action-tile",
       "category": "game",
+      "sourceFile": "components/game/molecules/ActionTile.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "ActionTile Component  A draggable action tile for the Sequencer tier (ages 5-8). Kids drag these from the ActionPalette into SequenceBar slots. Sets SlotItemData on dataTransfer for TraitSlot compatibility.",
@@ -35042,7 +35215,10 @@
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 "atlas": {
@@ -35205,6 +35381,7 @@
     "sequence-bar": {
       "type": "sequence-bar",
       "category": "game",
+      "sourceFile": "components/game/molecules/SequenceBar.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "SequenceBar Component  A row of TraitSlot components forming the action sequence for the Sequencer tier (ages 5-8). Kids drag ActionTiles from the palette into these slots to build their sequence.",
@@ -35315,7 +35492,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -35543,7 +35723,10 @@
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       "atlas": {
@@ -38592,6 +38775,7 @@
     "canvas-2d": {
       "type": "canvas-2d",
       "category": "game",
+      "sourceFile": "components/game/molecules/Canvas2D.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "Canvas2D component",
@@ -38738,7 +38922,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -39050,6 +39237,7 @@
     "control-grid": {
       "type": "control-grid",
       "category": "game",
+      "sourceFile": "components/game/molecules/ControlGrid.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "ControlGrid component",
@@ -39161,7 +39349,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -39390,7 +39581,10 @@
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               "atlas": {
@@ -39461,6 +39655,7 @@
     "game-icon": {
       "type": "game-icon",
       "category": "game",
+      "sourceFile": "components/core/atoms/GameIcon.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "GameIcon component",
@@ -39536,7 +39731,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -47834,6 +48032,7 @@
     "draw-sprite": {
       "type": "draw-sprite",
       "category": "game",
+      "sourceFile": "components/game/atoms/DrawSprite.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "DrawSprite component",
@@ -47955,7 +48154,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -48939,6 +49141,7 @@
     "draw-sprite-layer": {
       "type": "draw-sprite-layer",
       "category": "game",
+      "sourceFile": "components/game/molecules/DrawSpriteLayer.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "DrawSpriteLayer component",
@@ -49081,7 +49284,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -49387,6 +49593,7 @@
     "canvas": {
       "type": "canvas",
       "category": "game",
+      "sourceFile": "components/game/molecules/Canvas.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "Canvas component",
@@ -49626,7 +49833,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -52059,6 +52269,7 @@
     "draw-fx-layer": {
       "type": "draw-fx-layer",
       "category": "game",
+      "sourceFile": "components/game/molecules/DrawFxLayer.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "DrawFxLayer component",
@@ -52434,7 +52645,10 @@
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               "atlas": {
@@ -53725,6 +53939,399 @@
           "default": "replace"
         }
       }
+    },
+    "draw-skinned-mesh": {
+      "type": "draw-skinned-mesh",
+      "category": "game",
+      "sourceFile": "components/game/atoms/DrawSkinnedMesh.tsx",
+      "tier": "atoms",
+      "family": "game",
+      "description": "DrawSkinnedMesh component",
+      "suggestedFor": [
+        "draw",
+        "skinned",
+        "mesh",
+        "draw skinned mesh"
+      ],
+      "typicalSize": "small",
+      "propsSchema": {
+        "id": {
+          "types": [
+            "string"
+          ],
+          "description": "Optional source-tagged hit-test handle — the host indexes the drawable's ScenePos→id so a pointer/raycast at that cell resolves to this id (unit/entity click). No id → the host emits only the coordinate (tile click)."
+        },
+        "type": {
+          "types": [
+            "string"
+          ],
+          "description": "type prop",
+          "required": true,
+          "enumValues": [
+            "draw-skinned-mesh"
+          ]
+        },
+        "position": {
+          "types": [
+            "object"
+          ],
+          "description": "Logical scene position; mesh local coords are world units relative to its projected top-left.",
+          "required": true,
+          "properties": {
+            "x": {
+              "types": [
+                "number"
+              ]
+            },
+            "y": {
+              "types": [
+                "number"
+              ]
+            },
+            "z": {
+              "types": [
+                "number"
+              ]
+            }
+          },
+          "propertyRequired": [
+            "x",
+            "y"
+          ],
+          "scenePos": true
+        },
+        "asset": {
+          "types": [
+            "object"
+          ],
+          "description": "The texture the mesh UVs cut into.",
+          "required": true,
+          "properties": {
+            "url": {
+              "types": [
+                "asset"
+              ]
+            },
+            "role": {
+              "types": [
+                "string"
+              ]
+            },
+            "category": {
+              "types": [
+                "string"
+              ]
+            },
+            "animations": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "style": {
+              "types": [
+                "string"
+              ],
+              "enumValues": [
+                "pixel",
+                "vector",
+                "hd",
+                "1-bit",
+                "isometric"
+              ]
+            },
+            "variant": {
+              "types": [
+                "string"
+              ]
+            },
+            "dimension": {
+              "types": [
+                "string"
+              ],
+              "enumValues": [
+                "2d",
+                "3d"
+              ]
+            },
+            "aspect": {
+              "types": [
+                "string"
+              ],
+              "enumValues": [
+                "1:1",
+                "16:9",
+                "5:7",
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
+              ]
+            },
+            "atlas": {
+              "types": [
+                "asset"
+              ]
+            },
+            "sprite": {
+              "types": [
+                "string"
+              ]
+            },
+            "name": {
+              "types": [
+                "string"
+              ]
+            },
+            "thumbnailUrl": {
+              "types": [
+                "string"
+              ]
+            }
+          },
+          "propertyRequired": [
+            "url",
+            "role",
+            "category"
+          ]
+        },
+        "mesh": {
+          "types": [
+            "object"
+          ],
+          "description": "Inline bind mesh; wins over `meshUrl`.",
+          "properties": {
+            "vertices": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "u": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "v": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "weights": {
+                    "types": [
+                      "array"
+                    ],
+                    "items": {
+                      "types": [
+                        "object"
+                      ],
+                      "properties": {
+                        "bone": {
+                          "types": [
+                            "number"
+                          ]
+                        },
+                        "w": {
+                          "types": [
+                            "number"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "bone",
+                        "w"
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "x",
+                  "y",
+                  "u",
+                  "v",
+                  "weights"
+                ]
+              }
+            },
+            "triangles": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              }
+            }
+          },
+          "propertyRequired": [
+            "vertices",
+            "triangles"
+          ]
+        },
+        "meshUrl": {
+          "types": [
+            "string"
+          ],
+          "description": "URL of a JSON `SkinMesh` (fetched + cached); used when `mesh` is absent."
+        },
+        "bones": {
+          "types": [
+            "array"
+          ],
+          "description": "The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty.",
+          "required": true,
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "name": {
+                "types": [
+                  "string"
+                ]
+              },
+              "parent": {
+                "types": [
+                  "string"
+                ]
+              },
+              "pivot": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              },
+              "tip": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              }
+            },
+            "required": [
+              "name",
+              "parent",
+              "pivot",
+              "tip"
+            ]
+          }
+        },
+        "pose": {
+          "types": [
+            "object"
+          ],
+          "description": "Static pose (bone name → degrees relative to bind). Overridden by `clip` + `frame`.",
+          "mapValue": {
+            "types": [
+              "number"
+            ]
+          }
+        },
+        "clip": {
+          "types": [
+            "object"
+          ],
+          "description": "Pose animation clip; with `frame`, pose = `frames[frame % frames.length]`.",
+          "properties": {
+            "frames": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "mapValue": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              }
+            }
+          },
+          "propertyRequired": [
+            "frames"
+          ]
+        },
+        "clipName": {
+          "types": [
+            "string"
+          ],
+          "description": "Named clip inside the rigbundle at `meshUrl` (`clips[clipName].frames`); used when `clip` is absent. Empty/unknown = no clip."
+        },
+        "frame": {
+          "types": [
+            "number"
+          ],
+          "description": "Clip frame counter (host-driven paint clock frame)."
+        },
+        "opacity": {
+          "types": [
+            "number"
+          ],
+          "description": "0..1 opacity."
+        },
+        "weightsOverlay": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Paint per-triangle dominant-bone colors instead of the texture (rig inspection)."
+        },
+        "ghost": {
+          "types": [
+            "object"
+          ],
+          "description": "Onion skin: render the mesh at this clip frame underneath, at this opacity.",
+          "properties": {
+            "frame": {
+              "types": [
+                "number"
+              ]
+            },
+            "opacity": {
+              "types": [
+                "number"
+              ]
+            }
+          },
+          "propertyRequired": [
+            "frame",
+            "opacity"
+          ]
+        }
+      },
+      "drawable": true
     }
   },
   "categories": [