@almadar/core 10.28.0 → 10.30.0

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-09T14:00:32.936Z",
+  "exportedAt": "2026-07-16T19:33:37.203Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -705,7 +705,7 @@
           "types": [
             "function"
           ],
-          "description": "renderItem prop",
+          "description": "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -875,15 +875,6 @@
       ],
       "typicalSize": "medium",
       "propsSchema": {
-        "entity": {
-          "types": [
-            "object",
-            "array"
-          ],
-          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
-          "kind": "entity",
-          "cardinality": "collection"
-        },
         "className": {
           "types": [
             "string"
@@ -987,6 +978,15 @@
             ]
           }
         },
+        "entity": {
+          "types": [
+            "object",
+            "array"
+          ],
+          "description": "Entity data (single record or collection).",
+          "kind": "entity",
+          "cardinality": "collection"
+        },
         "minCardWidth": {
           "types": [
             "number"
@@ -4222,7 +4222,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }",
+          "description": "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }. Setting it requires declaring that event (with a `{ stepIndex }` payload) and a transition handling it in the same trait; omit this prop for non-clickable progress indicators.",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -7671,7 +7671,7 @@
           "types": [
             "string"
           ],
-          "description": "Input type - supports 'select' and 'textarea' in addition to standard types",
+          "description": "Input type — selects the field's data mode. Use 'password' for masked credentials / secret / passphrase entry (there is no separate password pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time' for their respective values; and 'select' / 'textarea' for choice and multi-line entry in addition to the standard single-line types.",
           "enumValues": [
             "text",
             "email",
@@ -8949,7 +8949,7 @@
           "types": [
             "function"
           ],
-          "description": "Render function for each item",
+          "description": "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "required": true,
           "kind": "callback",
           "callbackArgs": [
@@ -10349,6 +10349,144 @@
       ],
       "typicalSize": "medium",
       "propsSchema": {
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        },
+        "placeholder": {
+          "types": [
+            "string"
+          ],
+          "description": "Placeholder text"
+        },
+        "value": {
+          "types": [
+            "string",
+            "number"
+          ],
+          "description": "Current value"
+        },
+        "disabled": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether input is disabled"
+        },
+        "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name for trait dispatch",
+          "kind": "event"
+        },
+        "inputType": {
+          "types": [
+            "string"
+          ],
+          "description": "Input type — selects the field's data mode. Use 'password' for masked credentials / secret / passphrase entry (there is no separate password pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time' for their respective values; and 'select' / 'textarea' for choice and multi-line entry in addition to the standard single-line types.",
+          "enumValues": [
+            "text",
+            "email",
+            "password",
+            "number",
+            "tel",
+            "url",
+            "search",
+            "date",
+            "datetime-local",
+            "time",
+            "checkbox",
+            "select",
+            "textarea"
+          ]
+        },
+        "label": {
+          "types": [
+            "string"
+          ],
+          "description": "label prop"
+        },
+        "helperText": {
+          "types": [
+            "string"
+          ],
+          "description": "helperText prop"
+        },
+        "error": {
+          "types": [
+            "string"
+          ],
+          "description": "error prop"
+        },
+        "leftIcon": {
+          "types": [
+            "icon",
+            "string"
+          ],
+          "description": "leftIcon prop"
+        },
+        "rightIcon": {
+          "types": [
+            "icon",
+            "string"
+          ],
+          "description": "rightIcon prop"
+        },
+        "clearable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Show clear button when input has value"
+        },
+        "onClear": {
+          "types": [
+            "function",
+            "string"
+          ],
+          "description": "Callback or declarative event key when clear button is clicked"
+        },
+        "options": {
+          "types": [
+            "array"
+          ],
+          "description": "Options for select type",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "value": {
+                "types": [
+                  "string"
+                ]
+              },
+              "label": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "value",
+              "label"
+            ]
+          }
+        },
+        "rows": {
+          "types": [
+            "number"
+          ],
+          "description": "Rows for textarea type"
+        },
+        "onChange": {
+          "types": [
+            "function",
+            "string"
+          ],
+          "description": "onChange handler or declarative event key for trait dispatch"
+        },
         "leftAddon": {
           "types": [
             "node",
@@ -10362,12 +10500,6 @@
             "icon"
           ],
           "description": "Right addon (icon, button, or text)"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional CSS classes"
         }
       }
     },
@@ -14356,6 +14488,11 @@
                   "number"
                 ]
               },
+              "badge": {
+                "types": [
+                  "number"
+                ]
+              },
               "x": {
                 "types": [
                   "number"
@@ -14376,7 +14513,7 @@
           "types": [
             "array"
           ],
-          "description": "Graph edges",
+          "description": "Graph edges (the only rendered links)",
           "items": {
             "types": [
               "object"
@@ -14414,6 +14551,39 @@
             ]
           }
         },
+        "similarity": {
+          "types": [
+            "array"
+          ],
+          "description": "All-pairs similarity (cosine 0–1) used ONLY for layout, never drawn. It is the secondary macro-layout: non-connected pairs get a weak spring (higher cosine ⇒ closer) so clusters arrange relative to each other; drawn `edges` stay the primary tight structure. When omitted, edges alone drive the layout.",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "source": {
+                "types": [
+                  "string"
+                ]
+              },
+              "target": {
+                "types": [
+                  "string"
+                ]
+              },
+              "weight": {
+                "types": [
+                  "number"
+                ]
+              }
+            },
+            "required": [
+              "source",
+              "target",
+              "weight"
+            ]
+          }
+        },
         "height": {
           "types": [
             "number"
@@ -14523,6 +14693,11 @@
                       "number"
                     ]
                   },
+                  "badge": {
+                    "types": [
+                      "number"
+                    ]
+                  },
                   "x": {
                     "types": [
                       "number"
@@ -14581,6 +14756,74 @@
                       "number"
                     ]
                   },
+                  "badge": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "id"
+                ]
+              }
+            }
+          ]
+        },
+        "onBadgeClick": {
+          "types": [
+            "function"
+          ],
+          "description": "On node badge click (e.g. to expand a merged cluster).",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "node",
+              "type": "object",
+              "schema": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "id": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "label": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "group": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "color": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "size": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "badge": {
+                    "types": [
+                      "number"
+                    ]
+                  },
                   "x": {
                     "types": [
                       "number"
@@ -16596,7 +16839,7 @@
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
+          "description": "Field definitions for rendering each card. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
           "items": {
             "types": [
               "object"
@@ -16928,7 +17171,7 @@
           "types": [
             "function"
           ],
-          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop.",
+          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -17041,7 +17284,7 @@
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
+          "description": "Field definitions for rendering each row. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
           "items": {
             "types": [
               "object"
@@ -17445,7 +17688,7 @@
           "types": [
             "function"
           ],
-          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop.",
+          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -18475,6 +18718,12 @@
           ],
           "description": "Text to display after the number"
         },
+        "format": {
+          "types": [
+            "string"
+          ],
+          "description": "Display format: \"number\" (locale grouping), \"currency\" ($x.xx), \"percent\" (rounded %). Unset preserves the value's own decimals."
+        },
         "className": {
           "types": [
             "string"
@@ -18661,7 +18910,7 @@
           "types": [
             "function"
           ],
-          "description": "Render function for each slide",
+          "description": "Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -18834,7 +19083,7 @@
           "types": [
             "function"
           ],
-          "description": "renderItem prop",
+          "description": "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "required": true,
           "kind": "callback",
           "callbackArgs": [
@@ -32856,7 +33105,7 @@
           "types": [
             "function"
           ],
-          "description": "Per-row render function (schema alias). In .orb: [\"fn\",\"item\",{...}]. The compiler converts this to the children render prop.",
+          "description": "Per-row render function (schema alias). In .orb: [\"fn\",\"item\",{...}]. The compiler converts this to the children render prop. In .lolo, author the per-row renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -34892,7 +35141,159 @@
         "v stack"
       ],
       "typicalSize": "small",
-      "propsSchema": {}
+      "propsSchema": {
+        "gap": {
+          "types": [
+            "string"
+          ],
+          "description": "Gap between children",
+          "enumValues": [
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ],
+          "default": "md"
+        },
+        "align": {
+          "types": [
+            "string"
+          ],
+          "description": "Align items on the cross axis",
+          "enumValues": [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
+          "default": "stretch"
+        },
+        "justify": {
+          "types": [
+            "string"
+          ],
+          "description": "Justify items on the main axis",
+          "enumValues": [
+            "start",
+            "center",
+            "end",
+            "between",
+            "around",
+            "evenly"
+          ],
+          "default": "start"
+        },
+        "wrap": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Allow items to wrap",
+          "default": false
+        },
+        "reverse": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Reverse the order of children",
+          "default": false
+        },
+        "flex": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Fill available space (flex: 1)",
+          "default": false
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Custom class name"
+        },
+        "style": {
+          "types": [
+            "object"
+          ],
+          "description": "Inline styles"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Children elements"
+        },
+        "as": {
+          "types": [
+            "component"
+          ],
+          "description": "HTML element to render as"
+        },
+        "onClick": {
+          "types": [
+            "function"
+          ],
+          "description": "Click handler",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "e",
+              "type": "object"
+            }
+          ],
+          "nonEmittable": true
+        },
+        "onKeyDown": {
+          "types": [
+            "function"
+          ],
+          "description": "Keyboard handler",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "e",
+              "type": "object"
+            }
+          ],
+          "nonEmittable": true
+        },
+        "role": {
+          "types": [
+            "string"
+          ],
+          "description": "Role for accessibility"
+        },
+        "tabIndex": {
+          "types": [
+            "number"
+          ],
+          "description": "Tab index for focus management"
+        },
+        "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
+          "kind": "event"
+        },
+        "actionPayload": {
+          "types": [
+            "object"
+          ],
+          "description": "Payload to include with the action event",
+          "freeform": true
+        },
+        "responsive": {
+          "types": [
+            "boolean"
+          ],
+          "description": "When true, horizontal stacks flip to vertical below the md breakpoint (768px)",
+          "default": false
+        }
+      }
     },
     "hstack": {
       "type": "hstack",
@@ -34905,7 +35306,159 @@
         "h stack"
       ],
       "typicalSize": "small",
-      "propsSchema": {}
+      "propsSchema": {
+        "gap": {
+          "types": [
+            "string"
+          ],
+          "description": "Gap between children",
+          "enumValues": [
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ],
+          "default": "md"
+        },
+        "align": {
+          "types": [
+            "string"
+          ],
+          "description": "Align items on the cross axis",
+          "enumValues": [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
+          "default": "stretch"
+        },
+        "justify": {
+          "types": [
+            "string"
+          ],
+          "description": "Justify items on the main axis",
+          "enumValues": [
+            "start",
+            "center",
+            "end",
+            "between",
+            "around",
+            "evenly"
+          ],
+          "default": "start"
+        },
+        "wrap": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Allow items to wrap",
+          "default": false
+        },
+        "reverse": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Reverse the order of children",
+          "default": false
+        },
+        "flex": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Fill available space (flex: 1)",
+          "default": false
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Custom class name"
+        },
+        "style": {
+          "types": [
+            "object"
+          ],
+          "description": "Inline styles"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Children elements"
+        },
+        "as": {
+          "types": [
+            "component"
+          ],
+          "description": "HTML element to render as"
+        },
+        "onClick": {
+          "types": [
+            "function"
+          ],
+          "description": "Click handler",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "e",
+              "type": "object"
+            }
+          ],
+          "nonEmittable": true
+        },
+        "onKeyDown": {
+          "types": [
+            "function"
+          ],
+          "description": "Keyboard handler",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "e",
+              "type": "object"
+            }
+          ],
+          "nonEmittable": true
+        },
+        "role": {
+          "types": [
+            "string"
+          ],
+          "description": "Role for accessibility"
+        },
+        "tabIndex": {
+          "types": [
+            "number"
+          ],
+          "description": "Tab index for focus management"
+        },
+        "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
+          "kind": "event"
+        },
+        "actionPayload": {
+          "types": [
+            "object"
+          ],
+          "description": "Payload to include with the action event",
+          "freeform": true
+        },
+        "responsive": {
+          "types": [
+            "boolean"
+          ],
+          "description": "When true, horizontal stacks flip to vertical below the md breakpoint (768px)",
+          "default": false
+        }
+      }
     },
     "form-layout": {
       "type": "form-layout",
@@ -38158,31 +38711,31 @@
           "types": [
             "number"
           ],
-          "description": "Rect width in px."
+          "description": "Rect width in world units (fractions of `projector.tileWidth`)."
         },
         "height": {
           "types": [
             "number"
           ],
-          "description": "Rect height in px."
+          "description": "Rect height in world units (fractions of `projector.tileWidth`)."
         },
         "radiusX": {
           "types": [
             "number"
           ],
-          "description": "Ellipse horizontal radius in px."
+          "description": "Ellipse horizontal radius in world units (fractions of `projector.tileWidth`)."
         },
         "radiusY": {
           "types": [
             "number"
           ],
-          "description": "Ellipse vertical radius in px; omitted → `radiusX` (a circle)."
+          "description": "Ellipse vertical radius in world units; omitted → `radiusX` (a circle)."
         },
         "offsetX": {
           "types": [
             "number"
           ],
-          "description": "Fine px nudge from the anchor point (e.g. a disc drawn at `groundY - 8*scale`)."
+          "description": "Fine nudge from the anchor point in world units."
         },
         "offsetY": {
           "types": [
@@ -38194,7 +38747,7 @@
           "types": [
             "array"
           ],
-          "description": "Poly vertices as px offsets relative to the cell's projected top-left.",
+          "description": "Poly vertices as world-unit offsets relative to the cell's projected top-left.",
           "items": {
             "types": [
               "object"
@@ -38384,13 +38937,13 @@
           "types": [
             "number"
           ],
-          "description": "Draw width in px (2D) / world units (3D); omitted → resolved source width."
+          "description": "Draw width in world units (fractions of `projector.tileWidth`); omitted → resolved source width in px."
         },
         "height": {
           "types": [
             "number"
           ],
-          "description": "Draw height in px (2D) / world units (3D); omitted → resolved source height."
+          "description": "Draw height in world units (fractions of `projector.tileWidth`); omitted → resolved source height in px."
         },
         "frame": {
           "types": [
@@ -38398,6 +38951,12 @@
           ],
           "description": "Explicit atlas sub-rect override (px); omitted → resolved from `asset.atlas`/`asset.sprite`."
         },
+        "animation": {
+          "types": [
+            "string"
+          ],
+          "description": "Named GLB animation clip to play (3D backend only; the 2D painter animates via `frame`). Matched case-insensitively against the model's clips."
+        },
         "flipX": {
           "types": [
             "boolean"
@@ -38875,6 +39434,11 @@
                   "object"
                 ]
               },
+              "animation": {
+                "types": [
+                  "string"
+                ]
+              },
               "flipX": {
                 "types": [
                   "boolean"