@almadar/core 10.45.0 → 10.47.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-30T11:18:57.838Z",
+  exportedAt: "2026-07-31T07:15:07.239Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -35178,6 +35178,12 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Solid backdrop colour (drawn when no `backgroundImage`)."
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Declarative JSX drawable children (`<DrawShape .../>` composed in paint order). When `drawables` is empty, each child registers its descriptor via the drawable registry context and the host paints them."
         }
       },
       drawable: true,
@@ -39332,7 +39338,7 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Fine nudge from the anchor point in world units."
+          description: "Fine nudge in world units \u2014 applies to every shape kind except `cell` (rect/ellipse from their anchor point; poly/path from the projected top-left)."
         },
         offsetY: {
           types: [
@@ -39363,6 +39369,103 @@ var patterns_registry_default = {
           ],
           description: "fill prop"
         },
+        gradient: {
+          types: [
+            "object"
+          ],
+          description: "Gradient fill in world units; overrides `fill` when present.",
+          properties: {
+            kind: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "linear",
+                "radial",
+                "conic"
+              ]
+            },
+            from: {
+              types: [
+                "object"
+              ]
+            },
+            to: {
+              types: [
+                "object"
+              ]
+            },
+            center: {
+              types: [
+                "object"
+              ]
+            },
+            radius: {
+              types: [
+                "number"
+              ]
+            },
+            angle: {
+              types: [
+                "number"
+              ]
+            },
+            stops: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ]
+              }
+            }
+          },
+          propertyRequired: [
+            "kind",
+            "stops"
+          ]
+        },
+        fillPattern: {
+          types: [
+            "object"
+          ],
+          description: "Repeating texture painted over the fill (grain / tiling image).",
+          properties: {
+            kind: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "noise",
+                "image"
+              ]
+            },
+            url: {
+              types: [
+                "string"
+              ]
+            },
+            scale: {
+              types: [
+                "number"
+              ]
+            },
+            alpha: {
+              types: [
+                "number"
+              ]
+            },
+            color: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "kind"
+          ]
+        },
         stroke: {
           types: [
             "string"
@@ -39375,6 +39478,277 @@ var patterns_registry_default = {
           ],
           description: "strokeWidth prop"
         },
+        strokeGradient: {
+          types: [
+            "object"
+          ],
+          description: "Gradient stroke in world units; overrides `stroke` when present.",
+          properties: {
+            kind: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "linear",
+                "radial",
+                "conic"
+              ]
+            },
+            from: {
+              types: [
+                "object"
+              ]
+            },
+            to: {
+              types: [
+                "object"
+              ]
+            },
+            center: {
+              types: [
+                "object"
+              ]
+            },
+            radius: {
+              types: [
+                "number"
+              ]
+            },
+            angle: {
+              types: [
+                "number"
+              ]
+            },
+            stops: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ]
+              }
+            }
+          },
+          propertyRequired: [
+            "kind",
+            "stops"
+          ]
+        },
+        strokeDash: {
+          types: [
+            "array"
+          ],
+          description: "Dash pattern in painter-px (constant under group scale, like `strokeWidth`).",
+          items: {
+            types: [
+              "number"
+            ]
+          }
+        },
+        strokeDashOffset: {
+          types: [
+            "number"
+          ],
+          description: "Dash phase offset in painter-px; animatable (marching ants)."
+        },
+        blendMode: {
+          types: [
+            "string"
+          ],
+          description: "Composite/blend mode for this shape's draws (`lighter`, `multiply`, `screen`, \u2026).",
+          enumValues: [
+            "source-over",
+            "lighter",
+            "multiply",
+            "screen",
+            "overlay",
+            "darken",
+            "lighten",
+            "color-dodge",
+            "color-burn",
+            "hard-light",
+            "soft-light",
+            "difference",
+            "exclusion",
+            "hue",
+            "saturation",
+            "color",
+            "luminosity",
+            "source-atop",
+            "destination-over",
+            "destination-out",
+            "xor"
+          ]
+        },
+        blur: {
+          types: [
+            "number"
+          ],
+          description: "Gaussian blur in painter-px. Expensive \u2014 forces an intermediate raster; use sparingly."
+        },
+        rotate: {
+          types: [
+            "number"
+          ],
+          description: "Rotation in radians (painter units, same as `draw-group`), about `pivot`."
+        },
+        pivot: {
+          types: [
+            "object"
+          ],
+          description: "Rotation pivot in world units relative to the cell's projected top-left; default `{x:0.5, y:0.5}` (cell center)."
+        },
+        shadow: {
+          types: [
+            "object"
+          ],
+          description: "Soft glow / drop-shadow behind the shape; `blur` in world units.",
+          properties: {
+            color: {
+              types: [
+                "string"
+              ]
+            },
+            blur: {
+              types: [
+                "number"
+              ]
+            }
+          },
+          propertyRequired: [
+            "color",
+            "blur"
+          ]
+        },
+        animation: {
+          types: [
+            "object"
+          ],
+          description: "Keyframe animation over this shape's props; the host runs a paint clock while present.",
+          properties: {
+            durationMs: {
+              types: [
+                "number"
+              ]
+            },
+            loop: {
+              types: [
+                "boolean"
+              ]
+            },
+            keyframes: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  at: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  offsetX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  offsetY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  rotate: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  opacity: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  radiusX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  radiusY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  width: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  height: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  strokeWidth: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  strokeDashOffset: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  blur: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  fill: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  stroke: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  shadow: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      color: {
+                        types: [
+                          "string"
+                        ]
+                      },
+                      blur: {
+                        types: [
+                          "number"
+                        ]
+                      }
+                    },
+                    required: [
+                      "color",
+                      "blur"
+                    ]
+                  }
+                },
+                required: [
+                  "at"
+                ]
+              }
+            }
+          },
+          propertyRequired: [
+            "durationMs",
+            "keyframes"
+          ]
+        },
         opacity: {
           types: [
             "number"
@@ -39843,6 +40217,101 @@ var patterns_registry_default = {
                   "string"
                 ]
               },
+              gradient: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  kind: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "linear",
+                      "radial",
+                      "conic"
+                    ]
+                  },
+                  from: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  center: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  radius: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  angle: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  stops: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ]
+                    }
+                  }
+                },
+                required: [
+                  "kind",
+                  "stops"
+                ]
+              },
+              fillPattern: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  kind: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "noise",
+                      "image"
+                    ]
+                  },
+                  url: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  scale: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  alpha: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  color: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "kind"
+                ]
+              },
               stroke: {
                 types: [
                   "string"
@@ -39853,6 +40322,268 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              strokeGradient: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  kind: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "linear",
+                      "radial",
+                      "conic"
+                    ]
+                  },
+                  from: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  center: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  radius: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  angle: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  stops: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ]
+                    }
+                  }
+                },
+                required: [
+                  "kind",
+                  "stops"
+                ]
+              },
+              strokeDash: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "number"
+                  ]
+                }
+              },
+              strokeDashOffset: {
+                types: [
+                  "number"
+                ]
+              },
+              blendMode: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "source-over",
+                  "lighter",
+                  "multiply",
+                  "screen",
+                  "overlay",
+                  "darken",
+                  "lighten",
+                  "color-dodge",
+                  "color-burn",
+                  "hard-light",
+                  "soft-light",
+                  "difference",
+                  "exclusion",
+                  "hue",
+                  "saturation",
+                  "color",
+                  "luminosity",
+                  "source-atop",
+                  "destination-over",
+                  "destination-out",
+                  "xor"
+                ]
+              },
+              blur: {
+                types: [
+                  "number"
+                ]
+              },
+              rotate: {
+                types: [
+                  "number"
+                ]
+              },
+              pivot: {
+                types: [
+                  "object"
+                ]
+              },
+              shadow: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  color: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  blur: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "color",
+                  "blur"
+                ]
+              },
+              animation: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  durationMs: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  loop: {
+                    types: [
+                      "boolean"
+                    ]
+                  },
+                  keyframes: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ],
+                      properties: {
+                        at: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        offsetX: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        offsetY: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        rotate: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        opacity: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        radiusX: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        radiusY: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        width: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        height: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        strokeWidth: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        strokeDashOffset: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        blur: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        fill: {
+                          types: [
+                            "string"
+                          ]
+                        },
+                        stroke: {
+                          types: [
+                            "string"
+                          ]
+                        },
+                        shadow: {
+                          types: [
+                            "object"
+                          ],
+                          properties: {
+                            color: {
+                              types: [
+                                "string"
+                              ]
+                            },
+                            blur: {
+                              types: [
+                                "number"
+                              ]
+                            }
+                          },
+                          required: [
+                            "color",
+                            "blur"
+                          ]
+                        }
+                      },
+                      required: [
+                        "at"
+                      ]
+                    }
+                  }
+                },
+                required: [
+                  "durationMs",
+                  "keyframes"
+                ]
+              },
               opacity: {
                 types: [
                   "number"
@@ -40571,6 +41302,12 @@ var patterns_registry_default = {
               "string"
             ]
           }
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Declarative JSX drawable children (`<DrawShape .../>` composed in paint order). Forwarded to the 2D host, which collects them via drawable registry context."
         }
       },
       drawHost: true
@@ -41070,6 +41807,12 @@ var patterns_registry_default = {
           ],
           description: "0..1 opacity."
         },
+        clip: {
+          types: [
+            "string"
+          ],
+          description: "Clip the group's items to an SVG path (`d` syntax) in world units relative to the group origin \u2014 masked reveals, meters, portraits."
+        },
         items: {
           types: [
             "array"
@@ -42061,7 +42804,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-30T11:18:57.838Z",
+  exportedAt: "2026-07-31T07:15:07.239Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43451,7 +44194,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-30T11:18:57.838Z",
+  exportedAt: "2026-07-31T07:15:07.239Z",
   contracts: {
     form: {
       emits: [