@almadar/core 10.30.0 → 10.32.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-23T14:32:35.644Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -3500,7 +3502,8 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component."
+          description: "Declarative search event \u2014 emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
+          kind: "event"
         },
         entity: {
           types: [
@@ -3521,7 +3524,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"
       ],
@@ -3658,6 +3662,20 @@ var patterns_registry_default = {
             "inline-column-header"
           ],
           default: "toolbar"
+        },
+        event: {
+          types: [
+            "string"
+          ],
+          description: "Declarative filter event \u2014 emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+          kind: "event"
+        },
+        clearEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative clear event \u2014 emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+          kind: "event"
         }
       }
     },
@@ -3722,18 +3740,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -3763,6 +3769,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -3783,6 +3794,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -3795,7 +3816,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               badge: {
@@ -3874,18 +3897,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -3915,6 +3926,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -3935,6 +3951,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -3947,7 +3973,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               badge: {
@@ -5385,6 +5413,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 +5611,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"
@@ -5696,9 +5739,9 @@ var patterns_registry_default = {
         },
         title: {
           types: [
-            "string"
+            "node"
           ],
-          description: "Drawer title"
+          description: "Drawer title (text or any node, e.g. a brand logo + name)."
         },
         children: {
           types: [
@@ -6885,18 +6928,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -6926,6 +6957,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -6946,6 +6982,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -6958,7 +7004,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         action: {
@@ -7078,18 +7126,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -7119,6 +7155,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -7139,6 +7180,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -7151,7 +7202,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         onRemove: {
@@ -8892,7 +8945,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",
@@ -9697,8 +9751,9 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Font weight override",
+          description: "Font weight override \u2014 `none` = no override, the variant's baked weight applies",
           enumValues: [
+            "none",
             "light",
             "normal",
             "medium",
@@ -9712,6 +9767,7 @@ var patterns_registry_default = {
           ],
           description: "Font size override",
           enumValues: [
+            "none",
             "xs",
             "sm",
             "md",
@@ -9792,133 +9848,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"
         }
       }
     },
@@ -12859,18 +12966,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -12900,6 +12995,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -12920,6 +13020,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -12932,14 +13042,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 +13061,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -12990,6 +13090,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -13010,6 +13115,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -13022,7 +13137,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fontFamily: {
@@ -13031,6 +13148,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 +14207,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 +15185,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",
@@ -15114,37 +15239,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Programming language for syntax highlighting",
-          enumValues: [
-            "text",
-            "json",
-            "javascript",
-            "js",
-            "typescript",
-            "ts",
-            "jsx",
-            "tsx",
-            "css",
-            "markdown",
-            "md",
-            "bash",
-            "shell",
-            "sh",
-            "yaml",
-            "yml",
-            "rust",
-            "python",
-            "py",
-            "sql",
-            "diff",
-            "toml",
-            "go",
-            "graphql",
-            "html",
-            "xml",
-            "orb",
-            "lolo"
-          ],
+          description: "Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered)",
           default: "text"
         },
         showCopyButton: {
@@ -15345,6 +15440,58 @@ var patterns_registry_default = {
                   "graphql",
                   "html",
                   "xml",
+                  "clojure",
+                  "clj",
+                  "edn",
+                  "haskell",
+                  "hs",
+                  "lisp",
+                  "scheme",
+                  "scala",
+                  "elixir",
+                  "ex",
+                  "exs",
+                  "erlang",
+                  "erl",
+                  "elm",
+                  "fsharp",
+                  "fs",
+                  "fsx",
+                  "ocaml",
+                  "ml",
+                  "java",
+                  "c",
+                  "cpp",
+                  "c++",
+                  "cc",
+                  "cxx",
+                  "hpp",
+                  "h",
+                  "csharp",
+                  "cs",
+                  "objectivec",
+                  "objc",
+                  "php",
+                  "ruby",
+                  "rb",
+                  "swift",
+                  "kotlin",
+                  "kt",
+                  "lua",
+                  "r",
+                  "dart",
+                  "julia",
+                  "fortran",
+                  "f90",
+                  "f95",
+                  "perl",
+                  "pl",
+                  "powershell",
+                  "ps1",
+                  "makefile",
+                  "make",
+                  "nginx",
+                  "ini",
                   "orb",
                   "lolo"
                 ]
@@ -16313,7 +16460,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 +16918,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",
@@ -16994,6 +17143,11 @@ var patterns_registry_default = {
                   "string"
                 ]
               },
+              navigatesTo: {
+                types: [
+                  "string"
+                ]
+              },
               icon: {
                 types: [
                   "icon",
@@ -17154,7 +17308,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render prop for custom per-card content. When provided, `fields` and `itemActions` are ignored.",
+          description: "Render prop for custom per-card content. When provided, `fields` are ignored; `itemActions` render as a footer beneath the custom content.",
           kind: "callback",
           callbackArgs: [
             {
@@ -19062,7 +19216,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 +19824,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 +19984,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 +20393,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 +26126,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26009,6 +26155,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26029,6 +26180,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26041,7 +26202,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -26128,18 +26291,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26169,6 +26320,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26189,6 +26345,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26201,7 +26367,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -26346,18 +26514,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26387,6 +26543,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26407,6 +26568,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26419,7 +26590,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         position: {
@@ -26560,18 +26733,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26601,6 +26762,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26621,6 +26787,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26633,7 +26809,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fillAsset: {
@@ -26650,18 +26828,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26691,6 +26857,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26711,6 +26882,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26723,7 +26904,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -26755,18 +26938,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -26796,6 +26967,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -26816,6 +26992,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -26828,7 +27014,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         value: {
@@ -26963,18 +27151,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -27004,6 +27180,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -27024,6 +27205,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -27036,7 +27227,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -28570,7 +28763,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 +28906,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -28753,6 +28935,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -28773,6 +28960,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -28785,7 +28982,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               format: {
@@ -29065,18 +29264,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29106,6 +29293,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29126,6 +29318,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29138,7 +29340,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -29176,18 +29380,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29217,6 +29409,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29237,6 +29434,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29249,7 +29456,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         iconUrl: {
@@ -29266,18 +29475,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29307,6 +29504,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29327,6 +29529,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29339,7 +29551,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -29932,18 +30146,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -29973,6 +30175,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -29993,6 +30200,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30005,7 +30222,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         offAsset: {
@@ -30022,18 +30241,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -30063,6 +30270,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -30083,6 +30295,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30095,7 +30317,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -30164,18 +30388,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -30205,6 +30417,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -30225,6 +30442,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -30237,7 +30464,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -30332,18 +30561,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -30373,6 +30590,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -30393,6 +30615,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -30405,7 +30637,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -30504,18 +30738,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -30545,6 +30767,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -30565,6 +30792,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -30577,7 +30814,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -30655,18 +30894,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -30696,6 +30923,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -30716,6 +30948,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -30728,7 +30970,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -30883,18 +31127,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -30924,6 +31156,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -30944,6 +31181,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -30956,7 +31203,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -31203,18 +31452,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -31244,6 +31481,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -31264,6 +31506,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -31276,7 +31528,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -31401,18 +31655,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -31442,6 +31684,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -31462,6 +31709,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -31474,7 +31731,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -31554,18 +31813,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -31595,6 +31842,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -31615,6 +31867,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -31627,7 +31889,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -32417,7 +32681,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 +32939,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",
@@ -33797,22 +34063,6 @@ var patterns_registry_default = {
           items: {
             types: [
               "object"
-            ],
-            properties: {
-              type: {
-                types: [
-                  "unknown"
-                ]
-              },
-              content: {
-                types: [
-                  "string"
-                ]
-              }
-            },
-            required: [
-              "type",
-              "content"
             ]
           }
         },
@@ -33832,34 +34082,7 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "User progress for restoring activation/reflection state",
-          properties: {
-            activationResponse: {
-              types: [
-                "string"
-              ]
-            },
-            reflectionNotes: {
-              types: [
-                "array"
-              ],
-              items: {
-                types: [
-                  "string"
-                ]
-              }
-            },
-            bloomAnswered: {
-              types: [
-                "object"
-              ],
-              mapValue: {
-                types: [
-                  "boolean"
-                ]
-              }
-            }
-          }
+          description: "User progress for restoring activation/reflection state"
         },
         onRunCodeSimulation: {
           types: [
@@ -33888,7 +34111,7 @@ var patterns_registry_default = {
           callbackArgs: [
             {
               name: "type",
-              type: "string"
+              type: "object"
             },
             {
               name: "description",
@@ -34354,18 +34577,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -34395,6 +34606,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -34415,6 +34631,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -34427,7 +34653,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         tileClickEvent: {
@@ -34667,18 +34895,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -34708,6 +34924,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -34728,6 +34949,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -34740,7 +34971,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               variant: {
@@ -34890,18 +35123,6 @@ var patterns_registry_default = {
               role: {
                 types: [
                   "string"
-                ],
-                enumValues: [
-                  "player",
-                  "enemy",
-                  "npc",
-                  "item",
-                  "tile",
-                  "projectile",
-                  "effect",
-                  "ui",
-                  "decoration",
-                  "vehicle"
                 ]
               },
               category: {
@@ -34931,6 +35152,11 @@ var patterns_registry_default = {
                   "isometric"
                 ]
               },
+              variant: {
+                types: [
+                  "string"
+                ]
+              },
               dimension: {
                 types: [
                   "string"
@@ -34951,6 +35177,16 @@ var patterns_registry_default = {
                   "8:1"
                 ]
               },
+              atlas: {
+                types: [
+                  "asset"
+                ]
+              },
+              sprite: {
+                types: [
+                  "string"
+                ]
+              },
               name: {
                 types: [
                   "string"
@@ -34963,7 +35199,9 @@ var patterns_registry_default = {
               }
             },
             required: [
-              "url"
+              "url",
+              "role",
+              "category"
             ]
           }
         },
@@ -35020,18 +35258,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -35061,6 +35287,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -35081,6 +35312,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -35093,7 +35334,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -37777,7 +38020,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 +39096,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -38893,6 +39125,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -38913,6 +39150,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -38925,7 +39172,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         anchor: {
@@ -39339,18 +39588,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -39380,6 +39617,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -39400,6 +39642,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -39412,7 +39664,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               anchor: {
@@ -39691,18 +39945,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -39732,6 +39974,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -39752,6 +39999,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -39764,7 +40021,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         backgroundColor: {
@@ -39939,6 +40198,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 +40893,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-23T14:32:35.644Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -40604,8 +40931,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 +42241,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 +42258,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-23T14:32:35.644Z",
   contracts: {
     form: {
       emits: [
@@ -42014,7 +42351,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 +42366,7 @@ var event_contracts_default = {
         }
       ],
       requires: [],
-      entityAware: false,
+      entityAware: true,
       configDriven: true
     },
     "entity-table": {
@@ -43051,6 +43395,19 @@ var event_contracts_default = {
       ],
       requires: [],
       entityAware: false
+    },
+    "data-grid": {
+      emits: [
+        {
+          event: "NAVIGATE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
     }
   }
 };
@@ -43214,11 +43571,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",
@@ -43323,6 +43682,22 @@ function isValidPatternType(type) {
   return PATTERN_TYPES.includes(type);
 }
 
+// src/patterns/content-grade.ts
+function isContentBodyPatternType(patternType) {
+  const entry = patterns_registry_default.patterns?.[patternType];
+  if (!entry?.propsSchema) return false;
+  return Object.values(entry.propsSchema).some((def) => def.kind === "entity");
+}
+function isContentBodyPattern(pattern) {
+  if (pattern === null) return false;
+  if (typeof pattern === "string") return true;
+  if ("children" in pattern && Array.isArray(pattern.children) && pattern.children.length > 0) return true;
+  return isContentBodyPatternType(pattern.type);
+}
+function isMainSlotRenderUi(effect) {
+  return Array.isArray(effect) && effect[0] === "render-ui" && effect[1] === "main";
+}
+
 // src/patterns/helpers/prompt-helpers.ts
 function getPatternsGroupedByCategory() {
   const patterns = patterns_registry_default.patterns || {};
@@ -43494,8 +43869,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);
 }
@@ -43782,6 +44158,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-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 };
+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, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map