@almadar/core 10.30.0 → 10.31.0

package/dist/index.js

@@ -146,6 +146,20 @@ var IdentityLedgerSchema = z.object({
   schemaVersion: z.literal(1),
   entries: z.record(LedgerEntrySchema)
 });
+var JsonValueSchema = z.lazy(
+  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
+);
+function isJsonPrimitive(value) {
+  return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function isJsonObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonArray(value) {
+  return Array.isArray(value);
+}
+
+// src/types/field.ts
 var FieldTypeSchema = z.enum([
   "string",
   "number",
@@ -209,7 +223,7 @@ var EntityFieldSchema = z.lazy(() => {
   const baseFieldShape = {
     name: z.string().min(1, "Field name is required").optional(),
     required: z.boolean().optional(),
-    default: z.unknown().optional(),
+    default: JsonValueSchema.optional(),
     format: FieldFormatSchema.optional(),
     min: z.number().optional(),
     max: z.number().optional(),
@@ -800,7 +814,7 @@ var TraitEntityFieldSchema = z.object({
     "enum"
   ]),
   required: z.boolean().optional(),
-  default: z.unknown().optional(),
+  default: TraitConfigValueSchema.optional(),
   values: z.array(z.string()).optional(),
   items: ConfigFieldItemsDeclarationSchema.optional(),
   properties: z.lazy(() => z.record(TraitEntityFieldSchema)).optional()
@@ -950,12 +964,11 @@ var TraitReferenceSchema = z.object({
   listens: z.array(z.unknown()).optional(),
   emitsScope: z.enum(["internal", "external"]).optional(),
   // Phase F.8: per-transition effects override. The keys are event
-  // names (the transition triggers AFTER renames). Values are arrays
-  // of SExpression-shaped data; the inliner validates the SExpression
-  // shape during application, so the schema accepts loose `unknown[]`.
+  // names (the transition triggers AFTER renames); values are SExpr
+  // effect tuples.
   effects: z.record(
     z.string().min(1, "effects override key (event name) must be non-empty"),
-    z.array(z.unknown())
+    z.array(SExprSchema)
   ).optional()
 }).refine(
   (ref2) => {
@@ -1975,7 +1988,7 @@ function getInteractionModelForDomain(domain) {
 // 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",
@@ -5495,7 +5508,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"
       ],
@@ -5696,18 +5710,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -5737,6 +5739,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -5757,6 +5764,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -5769,7 +5786,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               badge: {
@@ -5848,18 +5867,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -5889,6 +5896,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -5909,6 +5921,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -5921,7 +5943,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               badge: {
@@ -7359,6 +7383,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
         }
       }
     },
@@ -7550,6 +7581,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"
@@ -8859,18 +8898,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -8900,6 +8927,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -8920,6 +8952,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -8932,7 +8974,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         action: {
@@ -9052,18 +9096,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -9093,6 +9125,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -9113,6 +9150,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -9125,7 +9172,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         onRemove: {
@@ -10866,7 +10915,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",
@@ -11766,133 +11816,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"
         }
       }
     },
@@ -14833,18 +14934,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -14874,6 +14963,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -14894,6 +14988,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -14906,14 +15010,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: [
@@ -14923,18 +15029,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -14964,6 +15058,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -14984,6 +15083,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -14996,7 +15105,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fontFamily: {
@@ -15005,6 +15116,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.'
         }
       }
     },
@@ -16058,7 +16175,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",
@@ -17035,7 +17153,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",
@@ -18287,7 +18406,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",
@@ -18744,7 +18864,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",
@@ -21036,7 +21157,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",
@@ -21643,7 +21765,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",
@@ -21802,7 +21925,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",
@@ -22210,7 +22334,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",
@@ -27942,18 +28067,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -27983,6 +28096,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28003,6 +28121,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -28015,7 +28143,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -28102,18 +28232,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28143,6 +28261,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28163,6 +28286,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -28175,7 +28308,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -28320,18 +28455,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28361,6 +28484,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28381,6 +28509,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -28393,7 +28531,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         position: {
@@ -28534,18 +28674,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28575,6 +28703,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28595,6 +28728,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -28607,7 +28750,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         fillAsset: {
@@ -28624,18 +28769,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28665,6 +28798,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28685,6 +28823,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -28697,7 +28845,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -28729,18 +28879,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28770,6 +28908,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28790,6 +28933,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -28802,7 +28955,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         value: {
@@ -28937,18 +29092,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -28978,6 +29121,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -28998,6 +29146,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -29010,7 +29168,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -30544,7 +30704,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",
@@ -30686,18 +30847,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -30727,6 +30876,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -30747,6 +30901,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -30759,7 +30923,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               format: {
@@ -31039,18 +31205,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -31080,6 +31234,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -31100,6 +31259,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -31112,7 +31281,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -31150,18 +31321,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -31191,6 +31350,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -31211,6 +31375,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -31223,7 +31397,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         iconUrl: {
@@ -31240,18 +31416,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -31281,6 +31445,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -31301,6 +31470,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -31313,7 +31492,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         label: {
@@ -31906,18 +32087,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -31947,6 +32116,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -31967,6 +32141,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -31979,7 +32163,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         offAsset: {
@@ -31996,18 +32182,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -32037,6 +32211,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -32057,6 +32236,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -32069,7 +32258,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         }
       }
@@ -32138,18 +32329,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -32179,6 +32358,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -32199,6 +32383,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -32211,7 +32405,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -32306,18 +32502,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -32347,6 +32531,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -32367,6 +32556,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -32379,7 +32578,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         className: {
@@ -32478,18 +32679,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -32519,6 +32708,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -32539,6 +32733,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -32551,7 +32755,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -32629,18 +32835,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -32670,6 +32864,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -32690,6 +32889,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -32702,7 +32911,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -32857,18 +33068,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -32898,6 +33097,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -32918,6 +33122,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -32930,7 +33144,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -33177,18 +33393,6 @@ var patterns_registry_default = {
                 role: {
                   types: [
                     "string"
-                  ],
-                  enumValues: [
-                    "player",
-                    "enemy",
-                    "npc",
-                    "item",
-                    "tile",
-                    "projectile",
-                    "effect",
-                    "ui",
-                    "decoration",
-                    "vehicle"
                   ]
                 },
                 category: {
@@ -33218,6 +33422,11 @@ var patterns_registry_default = {
                     "isometric"
                   ]
                 },
+                variant: {
+                  types: [
+                    "string"
+                  ]
+                },
                 dimension: {
                   types: [
                     "string"
@@ -33238,6 +33447,16 @@ var patterns_registry_default = {
                     "8:1"
                   ]
                 },
+                atlas: {
+                  types: [
+                    "asset"
+                  ]
+                },
+                sprite: {
+                  types: [
+                    "string"
+                  ]
+                },
                 name: {
                   types: [
                     "string"
@@ -33250,7 +33469,9 @@ var patterns_registry_default = {
                 }
               },
               required: [
-                "url"
+                "url",
+                "role",
+                "category"
               ]
             },
             stateMachine: {
@@ -33375,18 +33596,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -33416,6 +33625,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -33436,6 +33650,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -33448,7 +33672,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               stateMachine: {
@@ -33528,18 +33754,6 @@ var patterns_registry_default = {
                       role: {
                         types: [
                           "string"
-                        ],
-                        enumValues: [
-                          "player",
-                          "enemy",
-                          "npc",
-                          "item",
-                          "tile",
-                          "projectile",
-                          "effect",
-                          "ui",
-                          "decoration",
-                          "vehicle"
                         ]
                       },
                       category: {
@@ -33569,6 +33783,11 @@ var patterns_registry_default = {
                           "isometric"
                         ]
                       },
+                      variant: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       dimension: {
                         types: [
                           "string"
@@ -33589,6 +33808,16 @@ var patterns_registry_default = {
                           "8:1"
                         ]
                       },
+                      atlas: {
+                        types: [
+                          "asset"
+                        ]
+                      },
+                      sprite: {
+                        types: [
+                          "string"
+                        ]
+                      },
                       name: {
                         types: [
                           "string"
@@ -33601,7 +33830,9 @@ var patterns_registry_default = {
                       }
                     },
                     required: [
-                      "url"
+                      "url",
+                      "role",
+                      "category"
                     ]
                   },
                   stateMachine: {
@@ -34391,7 +34622,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"
       ],
@@ -34648,7 +34880,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",
@@ -36328,18 +36561,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -36369,6 +36590,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -36389,6 +36615,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -36401,7 +36637,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         tileClickEvent: {
@@ -36641,18 +36879,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -36682,6 +36908,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -36702,6 +36933,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -36714,7 +36955,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               variant: {
@@ -36864,18 +37107,6 @@ var patterns_registry_default = {
               role: {
                 types: [
                   "string"
-                ],
-                enumValues: [
-                  "player",
-                  "enemy",
-                  "npc",
-                  "item",
-                  "tile",
-                  "projectile",
-                  "effect",
-                  "ui",
-                  "decoration",
-                  "vehicle"
                 ]
               },
               category: {
@@ -36905,6 +37136,11 @@ var patterns_registry_default = {
                   "isometric"
                 ]
               },
+              variant: {
+                types: [
+                  "string"
+                ]
+              },
               dimension: {
                 types: [
                   "string"
@@ -36925,6 +37161,16 @@ var patterns_registry_default = {
                   "8:1"
                 ]
               },
+              atlas: {
+                types: [
+                  "asset"
+                ]
+              },
+              sprite: {
+                types: [
+                  "string"
+                ]
+              },
               name: {
                 types: [
                   "string"
@@ -36937,7 +37183,9 @@ var patterns_registry_default = {
               }
             },
             required: [
-              "url"
+              "url",
+              "role",
+              "category"
             ]
           }
         },
@@ -36994,18 +37242,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -37035,6 +37271,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -37055,6 +37296,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -37067,7 +37318,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         icon: {
@@ -39751,7 +40004,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",
@@ -40826,18 +41080,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -40867,6 +41109,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -40887,6 +41134,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -40899,7 +41156,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         anchor: {
@@ -41313,18 +41572,6 @@ var patterns_registry_default = {
                   role: {
                     types: [
                       "string"
-                    ],
-                    enumValues: [
-                      "player",
-                      "enemy",
-                      "npc",
-                      "item",
-                      "tile",
-                      "projectile",
-                      "effect",
-                      "ui",
-                      "decoration",
-                      "vehicle"
                     ]
                   },
                   category: {
@@ -41354,6 +41601,11 @@ var patterns_registry_default = {
                       "isometric"
                     ]
                   },
+                  variant: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   dimension: {
                     types: [
                       "string"
@@ -41374,6 +41626,16 @@ var patterns_registry_default = {
                       "8:1"
                     ]
                   },
+                  atlas: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "string"
+                    ]
+                  },
                   name: {
                     types: [
                       "string"
@@ -41386,7 +41648,9 @@ var patterns_registry_default = {
                   }
                 },
                 required: [
-                  "url"
+                  "url",
+                  "role",
+                  "category"
                 ]
               },
               anchor: {
@@ -41665,18 +41929,6 @@ var patterns_registry_default = {
             role: {
               types: [
                 "string"
-              ],
-              enumValues: [
-                "player",
-                "enemy",
-                "npc",
-                "item",
-                "tile",
-                "projectile",
-                "effect",
-                "ui",
-                "decoration",
-                "vehicle"
               ]
             },
             category: {
@@ -41706,6 +41958,11 @@ var patterns_registry_default = {
                 "isometric"
               ]
             },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
             dimension: {
               types: [
                 "string"
@@ -41726,6 +41983,16 @@ var patterns_registry_default = {
                 "8:1"
               ]
             },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
             name: {
               types: [
                 "string"
@@ -41738,7 +42005,9 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "url"
+            "url",
+            "role",
+            "category"
           ]
         },
         backgroundColor: {
@@ -41913,6 +42182,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: [
@@ -42540,7 +42877,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",
@@ -42578,8 +42915,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": {
@@ -43888,6 +44225,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"
     }
   }
 };
@@ -43895,7 +44242,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: [
@@ -43988,7 +44335,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"
@@ -43996,7 +44350,7 @@ var event_contracts_default = {
         }
       ],
       requires: [],
-      entityAware: false,
+      entityAware: true,
       configDriven: true
     },
     "entity-table": {
@@ -45188,11 +45542,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",
@@ -45469,17 +45825,6 @@ function getOrbAllowedPatternsFiltered(patternNames) {
   return lines.join("\n");
 }
 
-// src/types/json.ts
-function isJsonPrimitive(value) {
-  return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
-}
-function isJsonObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function isJsonArray(value) {
-  return Array.isArray(value);
-}
-
 // src/patterns/helpers/render-ui-pattern-types.ts
 function collectPatternTypeTokens(node, out) {
   if (!isJsonObject(node)) return;