@almadar/core 10.29.0 → 10.31.0

package/dist/patterns/index.js

@@ -1,7 +1,9 @@
+import { z } from 'zod';
+
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-13T15:27:57.365Z",
+  exportedAt: "2026-07-21T09:54:57.379Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -706,7 +708,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "renderItem prop",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           kind: "callback",
           callbackArgs: [
             {
@@ -876,15 +878,6 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
-        entity: {
-          types: [
-            "object",
-            "array"
-          ],
-          description: "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
-          kind: "entity",
-          cardinality: "collection"
-        },
         className: {
           types: [
             "string"
@@ -988,6 +981,15 @@ var patterns_registry_default = {
             ]
           }
         },
+        entity: {
+          types: [
+            "object",
+            "array"
+          ],
+          description: "Entity data (single record or collection).",
+          kind: "entity",
+          cardinality: "collection"
+        },
         minCardWidth: {
           types: [
             "number"
@@ -3521,7 +3523,8 @@ var patterns_registry_default = {
       category: "filter",
       tier: "molecules",
       family: "core",
-      description: "Multiple filter controls",
+      description: "FilterGroup \u2014 a panel of filter controls that narrows a collection by field values.",
+      capabilities: "search refinement panel, facet filters, admin list filters, records filter sidebar, filter chips panel",
       suggestedFor: [
         "list pages with filterable data"
       ],
@@ -3722,18 +3725,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -3763,6 +3754,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -3783,6 +3779,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -3795,7 +3801,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               badge: {
@@ -3874,18 +3882,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -3915,6 +3911,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -3935,6 +3936,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -3947,7 +3958,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               badge: {
@@ -4223,7 +4236,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }",
+          description: "Declarative step click event \u2014 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: [
             {
@@ -5385,6 +5398,13 @@ var patterns_registry_default = {
             "string"
           ],
           description: "className prop"
+        },
+        fullPage: {
+          types: [
+            "boolean"
+          ],
+          description: "Center over the whole viewport (fix: inset-0 overlay) instead of inline.",
+          default: false
         }
       }
     },
@@ -5576,6 +5596,14 @@ var patterns_registry_default = {
           kind: "callback",
           callbackArgs: []
         },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fires after the exit animation completes (the modal is about to unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
         title: {
           types: [
             "string"
@@ -6885,18 +6913,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -6926,6 +6942,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -6946,6 +6967,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -6958,7 +6989,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         action: {
@@ -7078,18 +7111,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -7119,6 +7140,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -7139,6 +7165,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -7151,7 +7187,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         onRemove: {
@@ -7672,7 +7710,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+          description: "Input type \u2014 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",
@@ -8892,7 +8930,8 @@ var patterns_registry_default = {
       category: "form",
       tier: "molecules",
       family: "core",
-      description: "Repeatable form section for multiple entries",
+      description: "RepeatableFormSection \u2014 a form section that repeats a fixed group of fields, letting the user add or remove entries.",
+      capabilities: "dynamic line items, repeatable field group, add/remove entry rows, multi-entry form block",
       suggestedFor: [
         "repeating fields",
         "dynamic forms",
@@ -8950,7 +8989,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render function for each item",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
           kind: "callback",
           callbackArgs: [
@@ -9792,133 +9831,184 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
-        className: {
+        children: {
           types: [
-            "string"
+            "node"
           ],
-          description: "Additional CSS classes"
+          description: "Button group content (Button components) - use this OR primary/secondary"
         },
-        isLoading: {
-          types: [
-            "boolean"
-          ],
-          description: "Loading state indicator"
-        },
-        error: {
+        primary: {
           types: [
             "object"
           ],
-          description: "Error state (UiError)",
+          description: "Primary action button config (for form-actions pattern) Accepts Readonly for compatibility with generated const objects",
           properties: {
-            message: {
+            label: {
               types: [
                 "string"
               ]
             },
-            name: {
+            actionType: {
               types: [
                 "string"
               ]
             },
-            code: {
+            event: {
               types: [
                 "string"
               ]
             },
-            stack: {
+            navigatesTo: {
+              types: [
+                "string"
+              ]
+            },
+            variant: {
               types: [
                 "string"
               ]
             }
           },
           propertyRequired: [
-            "message"
+            "label"
           ]
         },
-        sortBy: {
+        secondary: {
           types: [
-            "string"
+            "array"
           ],
-          description: "Current sort field"
+          description: "Secondary action buttons config (for form-actions pattern) Accepts readonly array for compatibility with generated const arrays",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              actionType: {
+                types: [
+                  "string"
+                ]
+              },
+              event: {
+                types: [
+                  "string"
+                ]
+              },
+              navigatesTo: {
+                types: [
+                  "string"
+                ]
+              },
+              variant: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "label"
+            ]
+          }
         },
-        sortDirection: {
+        variant: {
           types: [
             "string"
           ],
-          description: "Current sort direction",
+          description: "Visual variant",
           enumValues: [
-            "asc",
-            "desc"
-          ]
-        },
-        searchValue: {
-          types: [
-            "string"
+            "default",
+            "segmented",
+            "toggle"
           ],
-          description: "Current search query value"
+          default: "default"
         },
-        page: {
+        orientation: {
           types: [
-            "number"
+            "string"
           ],
-          description: "Current page number"
-        },
-        pageSize: {
-          types: [
-            "number"
+          description: "Orientation",
+          enumValues: [
+            "horizontal",
+            "vertical"
           ],
-          description: "Number of items per page"
+          default: "horizontal"
         },
-        totalCount: {
+        className: {
           types: [
-            "number"
+            "string"
           ],
-          description: "Total number of items"
+          description: "Additional CSS classes"
         },
-        activeFilters: {
+        entity: {
           types: [
-            "object"
+            "string"
           ],
-          description: "Active filters"
+          description: "Entity type for filter-group pattern (schema metadata)"
         },
-        selectedIds: {
+        filters: {
           types: [
             "array"
           ],
-          description: "Currently selected item IDs",
+          description: "Filter definitions for filter-group pattern",
           items: {
             types: [
-              "string",
-              "number"
+              "object"
+            ],
+            properties: {
+              field: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "checkbox",
+                  "select",
+                  "toggle"
+                ]
+              },
+              options: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              }
+            },
+            required: [
+              "field",
+              "label"
             ]
           }
         },
-        children: {
-          types: [
-            "node"
-          ],
-          description: "children prop",
-          required: true
-        },
-        sticky: {
-          types: [
-            "boolean"
-          ],
-          description: "Sticky at bottom",
-          default: false
-        },
-        align: {
+        look: {
           types: [
             "string"
           ],
-          description: "Alignment",
+          description: "Layer 2 visual treatment for the action-cluster (form-actions) pattern.",
           enumValues: [
-            "left",
-            "right",
-            "between",
-            "center"
+            "right-aligned-buttons",
+            "floating-bar",
+            "inline-row",
+            "dropdown-menu",
+            "command-palette-trigger"
           ],
-          default: "right"
+          default: "right-aligned-buttons"
         }
       }
     },
@@ -10386,7 +10476,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+          description: "Input type \u2014 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",
@@ -12859,18 +12949,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -12900,6 +12978,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -12920,6 +13003,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -12932,14 +13025,16 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         hudBackgroundAsset: {
           types: [
             "object"
           ],
-          description: "9-sliced panel skin for the HUD chips row + title chip.",
+          description: "Per-call-site 9-sliced panel override. Chrome normally comes from the active theme; most callers leave this unset.",
           properties: {
             url: {
               types: [
@@ -12949,18 +13044,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -12990,6 +13073,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -13010,6 +13098,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -13022,7 +13120,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fontFamily: {
@@ -13031,6 +13131,12 @@ var patterns_registry_default = {
           ],
           description: "Game font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family.",
           default: "future"
+        },
+        "data-theme": {
+          types: [
+            "string"
+          ],
+          description: 'Scopes an `@almadar/ui` theme (e.g. "game-sci-fi-dark") to this shell\'s subtree.'
         }
       }
     },
@@ -14084,7 +14190,8 @@ var patterns_registry_default = {
       category: "form",
       tier: "molecules",
       family: "core",
-      description: "Canvas-based signature capture pad with draw, clear, and confirm actions",
+      description: "SignaturePad \u2014 a draw-to-sign canvas that captures a handwritten signature or initials.",
+      capabilities: "e-signature capture, sign-here field, consent signature, initial-here field, wet-signature substitute",
       suggestedFor: [
         "form signing",
         "approval workflows",
@@ -14489,6 +14596,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              badge: {
+                types: [
+                  "number"
+                ]
+              },
               x: {
                 types: [
                   "number"
@@ -14509,7 +14621,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Graph edges",
+          description: "Graph edges (the only rendered links)",
           items: {
             types: [
               "object"
@@ -14547,6 +14659,39 @@ var patterns_registry_default = {
             ]
           }
         },
+        similarity: {
+          types: [
+            "array"
+          ],
+          description: "All-pairs similarity (cosine 0\u20131) used ONLY for layout, never drawn. It is the secondary macro-layout: non-connected pairs get a weak spring (higher cosine \u21D2 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"
@@ -14656,6 +14801,11 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -14714,6 +14864,74 @@ var patterns_registry_default = {
                       "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"
@@ -14950,7 +15168,8 @@ var patterns_registry_default = {
       category: "component",
       tier: "molecules",
       family: "core",
-      description: "QuizBlock Molecule Component  A collapsible Q&A block for embedded quiz questions in content. Shows the question with a reveal button for the answer.  Event Contract: - No events emitted (self-contained interaction) - entityAware: false",
+      description: "QuizBlock \u2014 a single quiz question with answer choices and submit/reveal feedback.",
+      capabilities: "multiple-choice quiz, test question, exam item, assessment question, knowledge check, trivia question",
       suggestedFor: [
         "quiz",
         "block",
@@ -16202,7 +16421,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "core",
-      description: "FlipCard component",
+      description: "FlipCard \u2014 flip card that reveals a hidden back face on tap or click, toggling between a front and back content slot.",
+      capabilities: "flashcard, study deck, spaced-repetition review card, memorization drill, quiz reveal card, question/answer card, before/after reveal, term-and-definition card",
       suggestedFor: [
         "flip",
         "card",
@@ -16659,7 +16879,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "core",
-      description: "DataGrid component",
+      description: "DataGrid \u2014 structured records grid rendering rows over configurable columns, with sort, select, and drag-reorder.",
+      capabilities: "admin table, records grid, user list, CRUD list, manage-records view, spreadsheet-style data grid, sortable columns",
       suggestedFor: [
         "data",
         "grid",
@@ -16729,7 +16950,7 @@ var patterns_registry_default = {
           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 \u2014 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 \u2014 both names resolve to the same shape here. Pass either.",
           items: {
             types: [
               "object"
@@ -17061,7 +17282,7 @@ var patterns_registry_default = {
           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 \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -17174,7 +17395,7 @@ var patterns_registry_default = {
           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 \u2014 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 \u2014 both names resolve to the same shape here. Pass either.",
           items: {
             types: [
               "object"
@@ -17578,7 +17799,7 @@ var patterns_registry_default = {
           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 \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -18608,6 +18829,12 @@ var patterns_registry_default = {
           ],
           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"
@@ -18794,7 +19021,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render function for each slide",
+          description: "Render function for each slide. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           kind: "callback",
           callbackArgs: [
             {
@@ -18945,7 +19172,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "core",
-      description: "SortableList component",
+      description: "SortableList \u2014 a drag-and-drop reorderable list of items.",
+      capabilities: "checklist, task list, to-do list, priority list, ranked list, drag-to-reorder queue",
       suggestedFor: [
         "sortable",
         "list",
@@ -18967,7 +19195,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "renderItem prop",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
           kind: "callback",
           callbackArgs: [
@@ -19552,7 +19780,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "marketing",
-      description: "CaseStudyCard component",
+      description: "CaseStudyCard \u2014 a card summarizing a customer case study with logo, headline result, and link.",
+      capabilities: "customer story, success story, client story card, results showcase, proof-point card",
       suggestedFor: [
         "case",
         "study",
@@ -19711,7 +19940,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "marketing",
-      description: "FeatureCard component",
+      description: "FeatureCard \u2014 an icon-led card pairing a title and description to call out a single product feature.",
+      capabilities: "feature highlight, benefit callout, product capability card, feature-grid tile",
       suggestedFor: [
         "feature",
         "card",
@@ -20119,7 +20349,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "marketing",
-      description: "PricingCard component",
+      description: "PricingCard \u2014 a single pricing-tier card with price, billing period, feature list, and call-to-action.",
+      capabilities: "pricing tier, plan card, subscription tier, plan comparison card, price plan",
       suggestedFor: [
         "pricing",
         "card",
@@ -25851,18 +26082,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -25892,6 +26111,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -25912,6 +26136,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -25924,7 +26158,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -26011,18 +26247,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26052,6 +26276,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26072,6 +26301,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26084,7 +26323,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -26229,18 +26470,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26270,6 +26499,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26290,6 +26524,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26302,7 +26546,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         position: {
@@ -26443,18 +26689,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26484,6 +26718,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26504,6 +26743,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26516,7 +26765,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fillAsset: {
@@ -26533,18 +26784,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26574,6 +26813,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26594,6 +26838,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26606,7 +26860,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -26638,18 +26894,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26679,6 +26923,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26699,6 +26948,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26711,7 +26970,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         value: {
@@ -26846,18 +27107,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26887,6 +27136,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26907,6 +27161,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26919,7 +27183,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -28453,7 +28719,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "avl",
-      description: "ModuleCard component",
+      description: "ModuleCard \u2014 a card summarizing one course module or lesson with progress and entry point.",
+      capabilities: "course module card, lesson card, curriculum unit card, learning-path step card",
       suggestedFor: [
         "module",
         "card",
@@ -28595,18 +28862,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -28636,6 +28891,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -28656,6 +28916,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -28668,7 +28938,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               format: {
@@ -28948,18 +29220,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28989,6 +29249,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29009,6 +29274,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29021,7 +29296,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -29059,18 +29336,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29100,6 +29365,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29120,6 +29390,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29132,7 +29412,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         iconUrl: {
@@ -29149,18 +29431,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29190,6 +29460,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29210,6 +29485,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29222,7 +29507,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -29815,18 +30102,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29856,6 +30131,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29876,6 +30156,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29888,7 +30178,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         offAsset: {
@@ -29905,18 +30197,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29946,6 +30226,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29966,6 +30251,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29978,7 +30273,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -30047,18 +30344,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -30088,6 +30373,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -30108,6 +30398,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -30120,7 +30420,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -30215,18 +30517,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -30256,6 +30546,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -30276,6 +30571,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30288,7 +30593,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -30387,18 +30694,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -30428,6 +30723,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -30448,6 +30748,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -30460,7 +30770,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -30538,18 +30850,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -30579,6 +30879,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -30599,6 +30904,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -30611,7 +30926,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -30766,18 +31083,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -30807,6 +31112,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -30827,6 +31137,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -30839,7 +31159,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -31086,18 +31408,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -31127,6 +31437,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -31147,6 +31462,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -31159,7 +31484,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -31284,18 +31611,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -31325,6 +31640,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -31345,6 +31665,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -31357,7 +31687,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -31437,18 +31769,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -31478,6 +31798,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -31498,6 +31823,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -31510,7 +31845,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -32300,7 +32637,8 @@ var patterns_registry_default = {
       category: "component",
       tier: "atoms",
       family: "core",
-      description: "Aside Atom Component  Semantic wrapper for the native `<aside>` landmark. Owns raw HTML so molecules (SidePanel, navigation rails, callouts) can compose the semantic-aside primitive without falling back to a raw element.",
+      description: "Aside \u2014 a secondary side panel that hosts navigation links or supplementary content alongside a main content area.",
+      capabilities: "settings navigation sidebar, preferences menu panel, account settings nav, secondary panel, side navigation rail",
       suggestedFor: [
         "aside"
       ],
@@ -32557,7 +32895,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "molecules",
       family: "core",
-      description: "TableView component",
+      description: "TableView \u2014 sortable, selectable data table rendering rows over configurable columns, with inline row actions and grouping.",
+      capabilities: "admin console table, records list, CRUD data table, user list, manage-users grid, sortable columns, row selection with bulk actions, grouped list view",
       suggestedFor: [
         "table",
         "view",
@@ -32989,7 +33328,7 @@ var patterns_registry_default = {
           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 \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -34237,18 +34576,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -34278,6 +34605,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -34298,6 +34630,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -34310,7 +34652,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         tileClickEvent: {
@@ -34550,18 +34894,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -34591,6 +34923,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -34611,6 +34948,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -34623,7 +34970,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               variant: {
@@ -34773,18 +35122,6 @@ var patterns_registry_default = {
               role: {
                 types: [
                   "string"
-                ],
-                enumValues: [
-                  "player",
-                  "enemy",
-                  "npc",
-                  "item",
-                  "tile",
-                  "projectile",
-                  "effect",
-                  "ui",
-                  "decoration",
-                  "vehicle"
                 ]
               },
               category: {
@@ -34814,6 +35151,11 @@ var patterns_registry_default = {
                   "isometric"
                 ]
               },
+              variant: {
+                types: [
+                  "string"
+                ]
+              },
               dimension: {
                 types: [
                   "string"
@@ -34834,6 +35176,16 @@ var patterns_registry_default = {
                   "8:1"
                 ]
               },
+              atlas: {
+                types: [
+                  "asset"
+                ]
+              },
+              sprite: {
+                types: [
+                  "string"
+                ]
+              },
               name: {
                 types: [
                   "string"
@@ -34846,7 +35198,9 @@ var patterns_registry_default = {
               }
             },
             required: [
-              "url"
+              "url",
+              "role",
+              "category"
             ]
           }
         },
@@ -34903,18 +35257,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -34944,6 +35286,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -34964,6 +35311,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -34976,7 +35333,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -37660,7 +38019,8 @@ var patterns_registry_default = {
       category: "display",
       tier: "atoms",
       family: "marketing",
-      description: "MarketingStatCard component",
+      description: "MarketingStatCard \u2014 a single number-highlight card pairing a large value with a label and trend delta.",
+      capabilities: "KPI card, metric tile, dashboard stat card, number card, big-number widget, stat highlight, key metric callout",
       suggestedFor: [
         "marketing",
         "stat",
@@ -38595,31 +38955,31 @@ var patterns_registry_default = {
           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 \u2192 `radiusX` (a circle)."
+          description: "Ellipse vertical radius in world units; omitted \u2192 `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: [
@@ -38631,7 +38991,7 @@ var patterns_registry_default = {
           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"
@@ -38735,18 +39095,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -38776,6 +39124,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -38796,6 +39149,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -38808,7 +39171,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         anchor: {
@@ -39222,18 +39587,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -39263,6 +39616,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -39283,6 +39641,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -39295,7 +39663,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               anchor: {
@@ -39574,18 +39944,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -39615,6 +39973,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -39635,6 +39998,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -39647,7 +40020,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         backgroundColor: {
@@ -39822,6 +40197,74 @@ var patterns_registry_default = {
         }
       },
       drawHost: true
+    },
+    presence: {
+      type: "presence",
+      category: "component",
+      tier: "atoms",
+      family: "core",
+      description: "Presence component",
+      suggestedFor: [
+        "presence"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        show: {
+          types: [
+            "boolean"
+          ],
+          description: "When false, the exit animation runs, then children unmount.",
+          required: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "children prop",
+          required: true
+        }
+      }
+    },
+    "page-transition": {
+      type: "page-transition",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "PageTransition component",
+      suggestedFor: [
+        "page",
+        "transition",
+        "page transition"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        locationKey: {
+          types: [
+            "string"
+          ],
+          description: "Value that changes on navigation (e.g. `location.pathname`).",
+          required: true
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "children prop",
+          required: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
     }
   },
   categories: [
@@ -40449,7 +40892,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-13T15:27:57.365Z",
+  exportedAt: "2026-07-21T09:54:57.379Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -40487,8 +40930,8 @@ var component_mapping_default = {
       category: "form"
     },
     "form-actions": {
-      component: "FormActions",
-      importPath: "@/components/core/molecules/FormSection",
+      component: "ButtonGroup",
+      importPath: "@/components/core/molecules/ButtonGroup",
       category: "form"
     },
     "filter-group": {
@@ -41797,6 +42240,16 @@ var component_mapping_default = {
       component: "Canvas",
       importPath: "@/components/game/molecules/Canvas",
       category: "game"
+    },
+    presence: {
+      component: "Presence",
+      importPath: "@/components/core/atoms/Presence",
+      category: "component"
+    },
+    "page-transition": {
+      component: "PageTransition",
+      importPath: "@/components/core/molecules/PageTransition",
+      category: "component"
     }
   }
 };
@@ -41804,7 +42257,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-13T15:27:57.365Z",
+  exportedAt: "2026-07-21T09:54:57.379Z",
   contracts: {
     form: {
       emits: [
@@ -41897,7 +42350,14 @@ var event_contracts_default = {
     "form-actions": {
       emits: [
         {
-          event: "TOGGLE_COLLAPSE",
+          event: "DISPATCH",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "NAVIGATE",
           trigger: "action",
           payload: {
             type: "object"
@@ -41905,7 +42365,7 @@ var event_contracts_default = {
         }
       ],
       requires: [],
-      entityAware: false,
+      entityAware: true,
       configDriven: true
     },
     "entity-table": {
@@ -43097,11 +43557,13 @@ var PATTERN_TYPES = [
   "orbital-visualization",
   "overlay",
   "page-header",
+  "page-transition",
   "pagination",
   "pattern-tile",
   "physics-canvas",
   "popover",
   "positioned-canvas",
+  "presence",
   "pricing-card",
   "pricing-grid",
   "pricing-organism",
@@ -43291,10 +43753,13 @@ var ORB_ALLOWED_ENTITY_PATTERNS = /* @__PURE__ */ new Set([
   "data-grid",
   "search-input",
   "form-section",
-  "meter"
+  "meter",
+  "table-view",
+  "filter-group",
+  "timeline",
+  "media-gallery"
 ]);
 var ORB_EXCLUDED_CATEGORIES = /* @__PURE__ */ new Set([
-  "game",
   "debug",
   "template"
 ]);
@@ -43374,6 +43839,41 @@ function getOrbAllowedPatternsFiltered(patternNames) {
   }
   return lines.join("\n");
 }
+var JsonValueSchema = z.lazy(
+  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
+);
+function isJsonObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonArray(value) {
+  return Array.isArray(value);
+}
+
+// src/patterns/helpers/render-ui-pattern-types.ts
+function collectPatternTypeTokens(node, out) {
+  if (!isJsonObject(node)) return;
+  const type = node["type"];
+  if (typeof type === "string" && !type.startsWith("@")) out.add(type);
+  const children = node["children"];
+  if (isJsonArray(children)) {
+    for (const child of children) collectPatternTypeTokens(child, out);
+  }
+}
+function collectRenderUiPatternTypes(ir, out) {
+  if (isJsonArray(ir)) {
+    if (ir.length >= 3 && ir[0] === "render-ui" && typeof ir[1] === "string") {
+      collectPatternTypeTokens(ir[2], out);
+    }
+    for (const item of ir) collectRenderUiPatternTypes(item, out);
+  } else if (isJsonObject(ir)) {
+    for (const value of Object.values(ir)) collectRenderUiPatternTypes(value, out);
+  }
+}
+function renderUiPatternTypesOf(ir) {
+  const out = /* @__PURE__ */ new Set();
+  collectRenderUiPatternTypes(ir, out);
+  return out;
+}
 
 // src/patterns/helpers/pattern-recommender.ts
 var DOMAIN_KEYWORDS = {
@@ -43628,6 +44128,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, component_mapping_default as componentMapping, event_contracts_default as eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map