@almadar/core 10.47.0 → 10.49.0

package/dist/patterns/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-31T07:15:07.239Z",
+  "exportedAt": "2026-08-01T09:06:41.875Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -41194,6 +41194,18 @@
             }
           }
         },
+        "lighting": {
+          "types": [
+            "object"
+          ],
+          "description": "3D scene light rig as data — ambient/directional/hemisphere/point lights + optional 'room' environment for PBR reflections. Omitted → the standard fixed rig."
+        },
+        "post": {
+          "types": [
+            "object"
+          ],
+          "description": "3D post-processing stack — bloom (emissive glow / neon) and vignette. Omitted → no post pass."
+        },
         "tileClickEvent": {
           "types": [
             "string"
@@ -41798,6 +41810,126 @@
           ],
           "description": "Rotation in radians (painter units)."
         },
+        "rotation": {
+          "types": [
+            "array"
+          ],
+          "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": {
+            "types": [
+              "number"
+            ]
+          }
+        },
+        "bone": {
+          "types": [
+            "string"
+          ],
+          "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)."
+        },
+        "skeleton": {
+          "types": [
+            "boolean"
+          ],
+          "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."
+        },
+        "animation": {
+          "types": [
+            "object"
+          ],
+          "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.",
+          "properties": {
+            "durationMs": {
+              "types": [
+                "number"
+              ]
+            },
+            "loop": {
+              "types": [
+                "boolean"
+              ]
+            },
+            "keyframes": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "at": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "offsetX": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "offsetY": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "offsetZ": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "rotateX": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "rotateY": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "rotateZ": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "scale": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "opacity": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "emissiveIntensity": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "color": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "emissive": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "at"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "durationMs",
+            "keyframes"
+          ]
+        },
         "opacity": {
           "types": [
             "number"
@@ -41880,6 +42012,459 @@
           "description": "Additional CSS classes applied to the trigger button"
         }
       }
+    },
+    "draw-mesh": {
+      "type": "draw-mesh",
+      "category": "game",
+      "tier": "atoms",
+      "family": "game",
+      "description": "DrawMesh component",
+      "suggestedFor": [
+        "draw",
+        "mesh",
+        "draw 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": [
+            "unknown"
+          ],
+          "description": "type prop",
+          "required": true
+        },
+        "shape": {
+          "types": [
+            "string"
+          ],
+          "description": "shape prop",
+          "required": true,
+          "enumValues": [
+            "box",
+            "sphere",
+            "capsule",
+            "cylinder",
+            "cone",
+            "torus",
+            "plane",
+            "circle",
+            "polyhedron"
+          ]
+        },
+        "position": {
+          "types": [
+            "object"
+          ],
+          "description": "Logical scene position; `z` is height in cells (projected to world Y).",
+          "required": true,
+          "properties": {
+            "x": {
+              "types": [
+                "number"
+              ]
+            },
+            "y": {
+              "types": [
+                "number"
+              ]
+            },
+            "z": {
+              "types": [
+                "number"
+              ]
+            }
+          },
+          "propertyRequired": [
+            "x",
+            "y"
+          ],
+          "scenePos": true
+        },
+        "width": {
+          "types": [
+            "number"
+          ],
+          "description": "Box/plane X extent in cells (default 1)."
+        },
+        "height": {
+          "types": [
+            "number"
+          ],
+          "description": "Box Y (height) extent / capsule-cylinder-cone length in cells (default 1)."
+        },
+        "depth": {
+          "types": [
+            "number"
+          ],
+          "description": "Box/plane Z extent in cells (default `width`)."
+        },
+        "radius": {
+          "types": [
+            "number"
+          ],
+          "description": "Sphere/capsule/cone/torus/circle radius in cells (default 0.4)."
+        },
+        "radiusTop": {
+          "types": [
+            "number"
+          ],
+          "description": "Cylinder top radius (default `radius`)."
+        },
+        "radiusBottom": {
+          "types": [
+            "number"
+          ],
+          "description": "Cylinder bottom radius (default `radius`)."
+        },
+        "tube": {
+          "types": [
+            "number"
+          ],
+          "description": "Torus tube radius in cells (default `radius` / 3)."
+        },
+        "segments": {
+          "types": [
+            "number"
+          ],
+          "description": "Curved-surface tessellation, clamped 3..64 (default 24). 4–8 + `flatShading` = low-poly."
+        },
+        "vertices": {
+          "types": [
+            "array"
+          ],
+          "description": "`polyhedron` only: raw vertices as scene-frame `[x, y, z]` triples in cells, `z` = up.",
+          "items": {
+            "types": [
+              "array"
+            ],
+            "items": {
+              "types": [
+                "number"
+              ]
+            }
+          }
+        },
+        "faces": {
+          "types": [
+            "array"
+          ],
+          "description": "`polyhedron` only: triangle index triples into `vertices`, wound counter-clockwise seen from OUTSIDE in the scene frame.",
+          "items": {
+            "types": [
+              "array"
+            ],
+            "items": {
+              "types": [
+                "number"
+              ]
+            }
+          }
+        },
+        "skin": {
+          "types": [
+            "object"
+          ],
+          "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.",
+          "properties": {
+            "bones": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "inverseBindMatrices": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              }
+            },
+            "indices": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              }
+            },
+            "weights": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "number"
+                  ]
+                }
+              }
+            }
+          },
+          "propertyRequired": [
+            "bones",
+            "inverseBindMatrices",
+            "indices",
+            "weights"
+          ]
+        },
+        "rotation": {
+          "types": [
+            "array"
+          ],
+          "description": "Euler rotation `[x, y, z]` in radians.",
+          "items": {
+            "types": [
+              "number"
+            ]
+          }
+        },
+        "pivot": {
+          "types": [
+            "string"
+          ],
+          "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.",
+          "enumValues": [
+            "bottom",
+            "center"
+          ]
+        },
+        "material": {
+          "types": [
+            "object"
+          ],
+          "description": "material prop",
+          "properties": {
+            "kind": {
+              "types": [
+                "string"
+              ],
+              "enumValues": [
+                "standard",
+                "physical",
+                "toon",
+                "basic"
+              ]
+            },
+            "color": {
+              "types": [
+                "string"
+              ]
+            },
+            "metalness": {
+              "types": [
+                "number"
+              ]
+            },
+            "roughness": {
+              "types": [
+                "number"
+              ]
+            },
+            "emissive": {
+              "types": [
+                "string"
+              ]
+            },
+            "emissiveIntensity": {
+              "types": [
+                "number"
+              ]
+            },
+            "opacity": {
+              "types": [
+                "number"
+              ]
+            },
+            "transmission": {
+              "types": [
+                "number"
+              ]
+            },
+            "ior": {
+              "types": [
+                "number"
+              ]
+            },
+            "flatShading": {
+              "types": [
+                "boolean"
+              ]
+            },
+            "side": {
+              "types": [
+                "string"
+              ],
+              "enumValues": [
+                "front",
+                "back",
+                "double"
+              ]
+            }
+          }
+        },
+        "outline": {
+          "types": [
+            "object"
+          ],
+          "description": "outline prop",
+          "properties": {
+            "color": {
+              "types": [
+                "string"
+              ]
+            },
+            "width": {
+              "types": [
+                "number"
+              ]
+            }
+          }
+        },
+        "castShadow": {
+          "types": [
+            "boolean"
+          ],
+          "description": "castShadow prop"
+        },
+        "receiveShadow": {
+          "types": [
+            "boolean"
+          ],
+          "description": "receiveShadow prop"
+        },
+        "animation": {
+          "types": [
+            "object"
+          ],
+          "description": "Keyframe animation over transform/material tracks; the 3D host runs it per frame.",
+          "properties": {
+            "durationMs": {
+              "types": [
+                "number"
+              ]
+            },
+            "loop": {
+              "types": [
+                "boolean"
+              ]
+            },
+            "keyframes": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "at": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "offsetX": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "offsetY": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "offsetZ": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "rotateX": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "rotateY": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "rotateZ": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "scale": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "opacity": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "emissiveIntensity": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "color": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "emissive": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "at"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "durationMs",
+            "keyframes"
+          ]
+        },
+        "opacity": {
+          "types": [
+            "number"
+          ],
+          "description": "0..1 opacity; multiplies the material and enclosing group opacity."
+        }
+      },
+      "drawable": true
     }
   },
   "categories": [