@almadar/core 10.30.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-16T19:33:37.203Z",
+  exportedAt: "2026-07-21T09:54:57.379Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -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: {
@@ -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: {
@@ -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",
@@ -9792,133 +9831,184 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        isLoading: {
+        children: {
           types: [
-            "boolean"
+            "node"
           ],
-          description: "Loading state indicator"
+          description: "Button group content (Button components) - use this OR primary/secondary"
         },
-        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"
         }
       }
     },
@@ -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",
@@ -15061,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",
@@ -16313,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",
@@ -16770,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",
@@ -19062,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",
@@ -19669,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",
@@ -19828,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",
@@ -20236,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",
@@ -25968,18 +26082,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26009,6 +26111,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26029,6 +26136,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26041,7 +26158,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -26128,18 +26247,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26169,6 +26276,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26189,6 +26301,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26201,7 +26323,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -26346,18 +26470,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26387,6 +26499,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26407,6 +26524,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26419,7 +26546,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         position: {
@@ -26560,18 +26689,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26601,6 +26718,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26621,6 +26743,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26633,7 +26765,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fillAsset: {
@@ -26650,18 +26784,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26691,6 +26813,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26711,6 +26838,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26723,7 +26860,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -26755,18 +26894,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26796,6 +26923,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26816,6 +26948,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26828,7 +26970,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         value: {
@@ -26963,18 +27107,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -27004,6 +27136,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -27024,6 +27161,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -27036,7 +27183,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -28570,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",
@@ -28712,18 +28862,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -28753,6 +28891,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -28773,6 +28916,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -28785,7 +28938,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               format: {
@@ -29063,20 +29218,219 @@ var patterns_registry_default = {
               ]
             },
             role: {
+              types: [
+                "string"
+              ]
+            },
+            category: {
+              types: [
+                "string"
+              ]
+            },
+            animations: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            style: {
               types: [
                 "string"
               ],
               enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
+                "pixel",
+                "vector",
+                "hd",
+                "1-bit",
+                "isometric"
+              ]
+            },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
+            dimension: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "2d",
+                "3d"
+              ]
+            },
+            aspect: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "1:1",
+                "16:9",
+                "5:7",
+                "8:1"
+              ]
+            },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            thumbnailUrl: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "url",
+            "role",
+            "category"
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "stat-badge": {
+      type: "stat-badge",
+      category: "game",
+      tier: "molecules",
+      family: "game",
+      description: "StatBadge component",
+      suggestedFor: [
+        "stat",
+        "badge",
+        "stat badge"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        assetUrl: {
+          types: [
+            "object"
+          ],
+          description: "Sprite asset \u2014 takes precedence over icon when provided",
+          properties: {
+            url: {
+              types: [
+                "asset"
+              ]
+            },
+            role: {
+              types: [
+                "string"
+              ]
+            },
+            category: {
+              types: [
+                "string"
+              ]
+            },
+            animations: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            style: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "pixel",
+                "vector",
+                "hd",
+                "1-bit",
+                "isometric"
+              ]
+            },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
+            dimension: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "2d",
+                "3d"
+              ]
+            },
+            aspect: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "1:1",
+                "16:9",
+                "5:7",
+                "8:1"
+              ]
+            },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            thumbnailUrl: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "url",
+            "role",
+            "category"
+          ]
+        },
+        iconUrl: {
+          types: [
+            "object"
+          ],
+          description: "Asset image (board ui/ PNG); takes precedence over the Lucide icon.",
+          properties: {
+            url: {
+              types: [
+                "asset"
+              ]
+            },
+            role: {
+              types: [
+                "string"
               ]
             },
             category: {
@@ -29106,115 +29460,9 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
-            dimension: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "2d",
-                "3d"
-              ]
-            },
-            aspect: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "1:1",
-                "16:9",
-                "5:7",
-                "8:1"
-              ]
-            },
-            name: {
-              types: [
-                "string"
-              ]
-            },
-            thumbnailUrl: {
-              types: [
-                "string"
-              ]
-            }
-          },
-          propertyRequired: [
-            "url"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        }
-      }
-    },
-    "stat-badge": {
-      type: "stat-badge",
-      category: "game",
-      tier: "molecules",
-      family: "game",
-      description: "StatBadge component",
-      suggestedFor: [
-        "stat",
-        "badge",
-        "stat badge"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        assetUrl: {
-          types: [
-            "object"
-          ],
-          description: "Sprite asset \u2014 takes precedence over icon when provided",
-          properties: {
-            url: {
-              types: [
-                "asset"
-              ]
-            },
-            role: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
-              ]
-            },
-            category: {
-              types: [
-                "string"
-              ]
-            },
-            animations: {
-              types: [
-                "array"
-              ],
-              items: {
-                types: [
-                  "string"
-                ]
-              }
-            },
-            style: {
+            variant: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "pixel",
-                "vector",
-                "hd",
-                "1-bit",
-                "isometric"
               ]
             },
             dimension: {
@@ -29237,96 +29485,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
-            name: {
-              types: [
-                "string"
-              ]
-            },
-            thumbnailUrl: {
-              types: [
-                "string"
-              ]
-            }
-          },
-          propertyRequired: [
-            "url"
-          ]
-        },
-        iconUrl: {
-          types: [
-            "object"
-          ],
-          description: "Asset image (board ui/ PNG); takes precedence over the Lucide icon.",
-          properties: {
-            url: {
+            atlas: {
               types: [
                 "asset"
               ]
             },
-            role: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
-              ]
-            },
-            category: {
+            sprite: {
               types: [
                 "string"
               ]
             },
-            animations: {
-              types: [
-                "array"
-              ],
-              items: {
-                types: [
-                  "string"
-                ]
-              }
-            },
-            style: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "pixel",
-                "vector",
-                "hd",
-                "1-bit",
-                "isometric"
-              ]
-            },
-            dimension: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "2d",
-                "3d"
-              ]
-            },
-            aspect: {
-              types: [
-                "string"
-              ],
-              enumValues: [
-                "1:1",
-                "16:9",
-                "5:7",
-                "8:1"
-              ]
-            },
             name: {
               types: [
                 "string"
@@ -29339,7 +29507,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -29932,18 +30102,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29973,6 +30131,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29993,6 +30156,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30005,7 +30178,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         offAsset: {
@@ -30022,18 +30197,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -30063,6 +30226,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -30083,6 +30251,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30095,7 +30273,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -30164,18 +30344,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -30205,6 +30373,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -30225,6 +30398,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -30237,7 +30420,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -30332,18 +30517,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -30373,6 +30546,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -30393,6 +30571,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30405,7 +30593,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -30504,18 +30694,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -30545,6 +30723,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -30565,6 +30748,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -30577,7 +30770,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -30655,18 +30850,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -30696,6 +30879,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -30716,6 +30904,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -30728,7 +30926,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -30883,18 +31083,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -30924,6 +31112,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -30944,6 +31137,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -30956,7 +31159,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -31203,18 +31408,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -31244,6 +31437,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -31264,6 +31462,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -31276,7 +31484,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -31401,18 +31611,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -31442,6 +31640,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -31462,6 +31665,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -31474,7 +31687,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -31554,18 +31769,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -31595,6 +31798,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -31615,6 +31823,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -31627,7 +31845,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -32417,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"
       ],
@@ -32674,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",
@@ -34354,18 +34576,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -34395,6 +34605,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -34415,6 +34630,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -34427,7 +34652,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         tileClickEvent: {
@@ -34667,18 +34894,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -34708,6 +34923,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -34728,6 +34948,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -34740,7 +34970,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               variant: {
@@ -34890,18 +35122,6 @@ var patterns_registry_default = {
               role: {
                 types: [
                   "string"
-                ],
-                enumValues: [
-                  "player",
-                  "enemy",
-                  "npc",
-                  "item",
-                  "tile",
-                  "projectile",
-                  "effect",
-                  "ui",
-                  "decoration",
-                  "vehicle"
                 ]
               },
               category: {
@@ -34931,6 +35151,11 @@ var patterns_registry_default = {
                   "isometric"
                 ]
               },
+              variant: {
+                types: [
+                  "string"
+                ]
+              },
               dimension: {
                 types: [
                   "string"
@@ -34951,6 +35176,16 @@ var patterns_registry_default = {
                   "8:1"
                 ]
               },
+              atlas: {
+                types: [
+                  "asset"
+                ]
+              },
+              sprite: {
+                types: [
+                  "string"
+                ]
+              },
               name: {
                 types: [
                   "string"
@@ -34963,7 +35198,9 @@ var patterns_registry_default = {
               }
             },
             required: [
-              "url"
+              "url",
+              "role",
+              "category"
             ]
           }
         },
@@ -35020,18 +35257,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -35061,6 +35286,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -35081,6 +35311,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -35093,7 +35333,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -37777,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",
@@ -38852,18 +39095,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -38893,6 +39124,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -38913,6 +39149,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -38925,7 +39171,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         anchor: {
@@ -39339,18 +39587,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -39380,6 +39616,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -39400,6 +39641,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -39412,7 +39663,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               anchor: {
@@ -39691,18 +39944,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -39732,6 +39973,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -39752,6 +39998,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -39764,7 +40020,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         backgroundColor: {
@@ -39939,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: [
@@ -40566,7 +40892,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-16T19:33:37.203Z",
+  exportedAt: "2026-07-21T09:54:57.379Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -40604,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": {
@@ -41914,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"
     }
   }
 };
@@ -41921,7 +42257,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-16T19:33:37.203Z",
+  exportedAt: "2026-07-21T09:54:57.379Z",
   contracts: {
     form: {
       emits: [
@@ -42014,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"
@@ -42022,7 +42365,7 @@ var event_contracts_default = {
         }
       ],
       requires: [],
-      entityAware: false,
+      entityAware: true,
       configDriven: true
     },
     "entity-table": {
@@ -43214,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",
@@ -43494,8 +43839,9 @@ function getOrbAllowedPatternsFiltered(patternNames) {
   }
   return lines.join("\n");
 }
-
-// src/types/json.ts
+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);
 }