@almadar/core 10.47.0 → 10.49.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-31T07:15:07.239Z",
+  exportedAt: "2026-08-01T09:06:41.875Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -41197,6 +41197,18 @@ var patterns_registry_default = {
             }
           }
         },
+        lighting: {
+          types: [
+            "object"
+          ],
+          description: "3D scene light rig as data \u2014 ambient/directional/hemisphere/point lights + optional 'room' environment for PBR reflections. Omitted \u2192 the standard fixed rig."
+        },
+        post: {
+          types: [
+            "object"
+          ],
+          description: "3D post-processing stack \u2014 bloom (emissive glow / neon) and vignette. Omitted \u2192 no post pass."
+        },
         tileClickEvent: {
           types: [
             "string"
@@ -41801,6 +41813,126 @@ var patterns_registry_default = {
           ],
           description: "Rotation in radians (painter units)."
         },
+        rotation: {
+          types: [
+            "array"
+          ],
+          description: "Euler rotation `[x, y, z]` in radians (world axes) \u2014 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 \u2014 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`) \u2014 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"
@@ -41883,6 +42015,459 @@ var patterns_registry_default = {
           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 \u2014 the host indexes the drawable's ScenePos\u2192id so a pointer/raycast at that cell resolves to this id (unit/entity click). No id \u2192 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\u20138 + `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 \u2212min(z) and `center` applies no offset \u2014 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: [
@@ -42804,7 +43389,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-31T07:15:07.239Z",
+  exportedAt: "2026-08-01T09:06:41.875Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -44187,6 +44772,11 @@ var component_mapping_default = {
       component: "EmojiPicker",
       importPath: "@/components/core/molecules/EmojiPicker",
       category: "component"
+    },
+    "draw-mesh": {
+      component: "DrawMesh",
+      importPath: "@/components/game/atoms/DrawMesh",
+      category: "game"
     }
   }
 };
@@ -44194,7 +44784,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-31T07:15:07.239Z",
+  exportedAt: "2026-08-01T09:06:41.875Z",
   contracts: {
     form: {
       emits: [
@@ -45425,6 +46015,7 @@ var PATTERN_TYPES = [
   "doc-toc",
   "document-viewer",
   "draw-group",
+  "draw-mesh",
   "draw-shape",
   "draw-shape-layer",
   "draw-sprite",