@almadar/core 10.48.0 → 10.49.0

package/dist/patterns/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-31T10:02:24.207Z",
+  "exportedAt": "2026-08-01T09:06:41.875Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-31T10:02:24.207Z",
+  "exportedAt": "2026-08-01T09:06:41.875Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/patterns/index.d.ts

@@ -1,10 +1,10 @@
-import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, aY as PatternType } from '../effect-DiHGegt9.js';
-export { aR as PATTERN_TYPES, aV as PatternConfig, aW as PatternProps, aX as PatternPropsMap, cL as isValidPatternType } from '../effect-DiHGegt9.js';
+import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, aY as PatternType } from '../effect-DjMRX8sI.js';
+export { aR as PATTERN_TYPES, aV as PatternConfig, aW as PatternProps, aX as PatternPropsMap, cL as isValidPatternType } from '../effect-DjMRX8sI.js';
 import { d as EventPayloadValue, a as EventPayload, J as JsonValue } from '../expression-Yf7qvvOs.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-07-31T10:02:24.207Z";
+var exportedAt$3 = "2026-08-01T09:06:41.875Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -41920,6 +41920,126 @@ var patterns = {
 				],
 				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"
@@ -42043,7 +42163,8 @@ var patterns = {
 					"cone",
 					"torus",
 					"plane",
-					"circle"
+					"circle",
+					"polyhedron"
 				]
 			},
 			position: {
@@ -42123,6 +42244,107 @@ var patterns = {
 				],
 				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"
@@ -42138,7 +42360,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				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.",
 				enumValues: [
 					"bottom",
 					"center"
@@ -43280,7 +43502,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-07-31T10:02:24.207Z";
+var exportedAt$1 = "2026-08-01T09:06:41.875Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -44677,7 +44899,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-07-31T10:02:24.207Z";
+var exportedAt = "2026-08-01T09:06:41.875Z";
 var contracts = {
 	form: {
 		emits: [
@@ -71975,6 +72197,79 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                rotation: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                    };
+                };
+                bone: {
+                    types: string[];
+                    description: string;
+                };
+                skeleton: {
+                    types: string[];
+                    description: string;
+                };
+                animation: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        durationMs: {
+                            types: string[];
+                        };
+                        loop: {
+                            types: string[];
+                        };
+                        keyframes: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                properties: {
+                                    at: {
+                                        types: string[];
+                                    };
+                                    offsetX: {
+                                        types: string[];
+                                    };
+                                    offsetY: {
+                                        types: string[];
+                                    };
+                                    offsetZ: {
+                                        types: string[];
+                                    };
+                                    rotateX: {
+                                        types: string[];
+                                    };
+                                    rotateY: {
+                                        types: string[];
+                                    };
+                                    rotateZ: {
+                                        types: string[];
+                                    };
+                                    scale: {
+                                        types: string[];
+                                    };
+                                    opacity: {
+                                        types: string[];
+                                    };
+                                    emissiveIntensity: {
+                                        types: string[];
+                                    };
+                                    color: {
+                                        types: string[];
+                                    };
+                                    emissive: {
+                                        types: string[];
+                                    };
+                                };
+                                required: string[];
+                            };
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 opacity: {
                     types: string[];
                     description: string;
@@ -72106,6 +72401,66 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                vertices: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                        };
+                    };
+                };
+                faces: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                        };
+                    };
+                };
+                skin: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        bones: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                            };
+                        };
+                        inverseBindMatrices: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                        };
+                        indices: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                        };
+                        weights: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 rotation: {
                     types: string[];
                     description: string;
@@ -97815,6 +98170,79 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                rotation: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                    };
+                };
+                bone: {
+                    types: string[];
+                    description: string;
+                };
+                skeleton: {
+                    types: string[];
+                    description: string;
+                };
+                animation: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        durationMs: {
+                            types: string[];
+                        };
+                        loop: {
+                            types: string[];
+                        };
+                        keyframes: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                properties: {
+                                    at: {
+                                        types: string[];
+                                    };
+                                    offsetX: {
+                                        types: string[];
+                                    };
+                                    offsetY: {
+                                        types: string[];
+                                    };
+                                    offsetZ: {
+                                        types: string[];
+                                    };
+                                    rotateX: {
+                                        types: string[];
+                                    };
+                                    rotateY: {
+                                        types: string[];
+                                    };
+                                    rotateZ: {
+                                        types: string[];
+                                    };
+                                    scale: {
+                                        types: string[];
+                                    };
+                                    opacity: {
+                                        types: string[];
+                                    };
+                                    emissiveIntensity: {
+                                        types: string[];
+                                    };
+                                    color: {
+                                        types: string[];
+                                    };
+                                    emissive: {
+                                        types: string[];
+                                    };
+                                };
+                                required: string[];
+                            };
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 opacity: {
                     types: string[];
                     description: string;
@@ -97946,6 +98374,66 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                vertices: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                        };
+                    };
+                };
+                faces: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                        };
+                    };
+                };
+                skin: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        bones: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                            };
+                        };
+                        inverseBindMatrices: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                        };
+                        indices: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                        };
+                        weights: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 rotation: {
                     types: string[];
                     description: string;