@almadar/patterns 2.30.8 → 2.30.10

package/dist/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-05-22T01:35:31.064Z",
+  "exportedAt": "2026-05-22T09:19:11.577Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -15,15 +15,15 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -252,15 +252,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -434,15 +429,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -687,15 +677,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -4007,15 +3992,15 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -9027,15 +9012,15 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -10488,15 +10473,15 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -11776,15 +11761,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -16494,15 +16474,59 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "title": {
+                "types": [
+                  "string"
+                ]
+              },
+              "description": {
+                "types": [
+                  "string"
+                ]
+              },
+              "category": {
+                "types": [
+                  "string"
+                ]
+              },
+              "categoryColor": {
+                "types": [
+                  "string"
+                ]
+              },
+              "href": {
+                "types": [
+                  "string"
+                ]
+              },
+              "linkLabel": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "description",
+              "category",
+              "href"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -16599,15 +16623,52 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "icon": {
+                "types": [
+                  "string"
+                ]
+              },
+              "title": {
+                "types": [
+                  "string"
+                ]
+              },
+              "description": {
+                "types": [
+                  "string"
+                ]
+              },
+              "href": {
+                "types": [
+                  "string"
+                ]
+              },
+              "linkLabel": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "description"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -16710,113 +16771,155 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
-            "array"
-          ],
-          "description": "Data array provided by the trait via render-ui"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional CSS classes"
-        },
-        "isLoading": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Loading state indicator",
-          "default": false
-        },
-        "error": {
-          "types": [
-            "object"
-          ],
-          "description": "Error state"
-        },
-        "sortBy": {
-          "types": [
-            "string"
-          ],
-          "description": "Current sort field"
-        },
-        "sortDirection": {
-          "types": [
-            "string"
-          ],
-          "description": "Current sort direction"
-        },
-        "searchValue": {
-          "types": [
-            "string"
-          ],
-          "description": "Current search query value"
-        },
-        "page": {
-          "types": [
-            "number"
-          ],
-          "description": "Current page number"
-        },
-        "pageSize": {
-          "types": [
-            "number"
-          ],
-          "description": "Number of items per page"
-        },
-        "totalCount": {
-          "types": [
-            "number"
-          ],
-          "description": "Total number of items"
-        },
-        "activeFilters": {
-          "types": [
-            "object"
-          ],
-          "description": "Active filters"
-        },
-        "selectedIds": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Currently selected item IDs"
-        },
-        "children": {
-          "types": [
-            "node"
-          ],
-          "description": "children prop"
-        }
-      }
-    },
-    "pricing-organism": {
-      "type": "pricing-organism",
-      "category": "display",
-      "description": "PricingOrganism component",
-      "suggestedFor": [
-        "pricing",
-        "organism",
-        "pricing organism"
-      ],
-      "typicalSize": "large",
-      "propsSchema": {
-        "entity": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
-            "array"
-          ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "tag": {
+                "types": [
+                  "string"
+                ]
+              },
+              "title": {
+                "types": [
+                  "string"
+                ]
+              },
+              "titleAccent": {
+                "types": [
+                  "string"
+                ]
+              },
+              "subtitle": {
+                "types": [
+                  "string"
+                ]
+              },
+              "primaryAction": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "label": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "href": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "variant": {
+                    "types": [
+                      "string"
+                    ],
+                    "enumValues": [
+                      "primary",
+                      "secondary",
+                      "ghost"
+                    ]
+                  }
+                },
+                "required": [
+                  "label",
+                  "href"
+                ]
+              },
+              "secondaryAction": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "label": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "href": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "variant": {
+                    "types": [
+                      "string"
+                    ],
+                    "enumValues": [
+                      "primary",
+                      "secondary",
+                      "ghost"
+                    ]
+                  }
+                },
+                "required": [
+                  "label",
+                  "href"
+                ]
+              },
+              "installCommand": {
+                "types": [
+                  "string"
+                ]
+              },
+              "image": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "src": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "alt": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "src",
+                  "alt"
+                ]
+              },
+              "imagePosition": {
+                "types": [
+                  "string"
+                ],
+                "enumValues": [
+                  "below",
+                  "right",
+                  "background"
+                ]
+              },
+              "background": {
+                "types": [
+                  "string"
+                ],
+                "enumValues": [
+                  "dark",
+                  "gradient",
+                  "subtle"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "subtitle"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -16885,42 +16988,96 @@
           ],
           "description": "Currently selected item IDs"
         },
-        "heading": {
-          "types": [
-            "string"
-          ],
-          "description": "heading prop"
-        },
-        "subtitle": {
+        "children": {
           "types": [
-            "string"
+            "node"
           ],
-          "description": "subtitle prop"
+          "description": "children prop"
         }
       }
     },
-    "showcase-organism": {
-      "type": "showcase-organism",
+    "pricing-organism": {
+      "type": "pricing-organism",
       "category": "display",
-      "description": "ShowcaseOrganism component",
+      "description": "PricingOrganism component",
       "suggestedFor": [
-        "showcase",
+        "pricing",
         "organism",
-        "showcase organism"
+        "pricing organism"
       ],
       "typicalSize": "large",
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "name": {
+                "types": [
+                  "string"
+                ]
+              },
+              "price": {
+                "types": [
+                  "string"
+                ]
+              },
+              "description": {
+                "types": [
+                  "string"
+                ]
+              },
+              "features": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "string"
+                  ]
+                }
+              },
+              "actionLabel": {
+                "types": [
+                  "string"
+                ]
+              },
+              "actionHref": {
+                "types": [
+                  "string"
+                ]
+              },
+              "highlighted": {
+                "types": [
+                  "boolean"
+                ]
+              },
+              "badge": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "price",
+              "features",
+              "actionLabel",
+              "actionHref"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -16989,13 +17146,6 @@
           ],
           "description": "Currently selected item IDs"
         },
-        "columns": {
-          "types": [
-            "number"
-          ],
-          "description": "columns prop",
-          "default": 3
-        },
         "heading": {
           "types": [
             "string"
@@ -17010,45 +17160,103 @@
         }
       }
     },
-    "stats-organism": {
-      "type": "stats-organism",
+    "showcase-organism": {
+      "type": "showcase-organism",
       "category": "display",
-      "description": "StatsOrganism component",
+      "description": "ShowcaseOrganism component",
       "suggestedFor": [
-        "stats",
+        "showcase",
         "organism",
-        "stats organism"
+        "showcase organism"
       ],
       "typicalSize": "large",
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional CSS classes"
-        },
-        "isLoading": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Loading state indicator",
-          "default": false
-        },
-        "error": {
-          "types": [
-            "object"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "title": {
+                "types": [
+                  "string"
+                ]
+              },
+              "description": {
+                "types": [
+                  "string"
+                ]
+              },
+              "image": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "src": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "alt": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "src",
+                  "alt"
+                ]
+              },
+              "href": {
+                "types": [
+                  "string"
+                ]
+              },
+              "badge": {
+                "types": [
+                  "string"
+                ]
+              },
+              "accentColor": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "image"
+            ]
+          }
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        },
+        "isLoading": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Loading state indicator",
+          "default": false
+        },
+        "error": {
+          "types": [
+            "object"
           ],
           "description": "Error state"
         },
@@ -17106,32 +17314,65 @@
           ],
           "description": "columns prop",
           "default": 3
+        },
+        "heading": {
+          "types": [
+            "string"
+          ],
+          "description": "heading prop"
+        },
+        "subtitle": {
+          "types": [
+            "string"
+          ],
+          "description": "subtitle prop"
         }
       }
     },
-    "step-flow-organism": {
-      "type": "step-flow-organism",
+    "stats-organism": {
+      "type": "stats-organism",
       "category": "display",
-      "description": "StepFlowOrganism component",
+      "description": "StatsOrganism component",
       "suggestedFor": [
-        "step",
-        "flow",
+        "stats",
         "organism",
-        "step flow organism"
+        "stats organism"
       ],
       "typicalSize": "large",
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "value": {
+                "types": [
+                  "string"
+                ]
+              },
+              "label": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "value",
+              "label"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -17200,60 +17441,70 @@
           ],
           "description": "Currently selected item IDs"
         },
-        "orientation": {
-          "types": [
-            "string"
-          ],
-          "description": "orientation prop",
-          "enumValues": [
-            "horizontal",
-            "vertical"
-          ],
-          "default": "horizontal"
-        },
-        "showConnectors": {
-          "types": [
-            "boolean"
-          ],
-          "description": "showConnectors prop",
-          "default": true
-        },
-        "heading": {
-          "types": [
-            "string"
-          ],
-          "description": "heading prop"
-        },
-        "subtitle": {
+        "columns": {
           "types": [
-            "string"
+            "number"
           ],
-          "description": "subtitle prop"
+          "description": "columns prop",
+          "default": 3
         }
       }
     },
-    "team-organism": {
-      "type": "team-organism",
+    "step-flow-organism": {
+      "type": "step-flow-organism",
       "category": "display",
-      "description": "TeamOrganism component",
+      "description": "StepFlowOrganism component",
       "suggestedFor": [
-        "team",
+        "step",
+        "flow",
         "organism",
-        "team organism"
+        "step flow organism"
       ],
       "typicalSize": "large",
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "number": {
+                "types": [
+                  "number"
+                ]
+              },
+              "title": {
+                "types": [
+                  "string"
+                ]
+              },
+              "description": {
+                "types": [
+                  "string"
+                ]
+              },
+              "icon": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "description"
+            ]
+          }
         },
         "className": {
           "types": [
@@ -17322,6 +17573,24 @@
           ],
           "description": "Currently selected item IDs"
         },
+        "orientation": {
+          "types": [
+            "string"
+          ],
+          "description": "orientation prop",
+          "enumValues": [
+            "horizontal",
+            "vertical"
+          ],
+          "default": "horizontal"
+        },
+        "showConnectors": {
+          "types": [
+            "boolean"
+          ],
+          "description": "showConnectors prop",
+          "default": true
+        },
         "heading": {
           "types": [
             "string"
@@ -17336,27 +17605,169 @@
         }
       }
     },
-    "about-page-template": {
-      "type": "about-page-template",
-      "category": "template",
-      "description": "AboutPageTemplate  An about/company page template with hero, articles, team grid, case studies, and CTA. Pure function: no hooks, no callbacks, no local state.",
+    "team-organism": {
+      "type": "team-organism",
+      "category": "display",
+      "description": "TeamOrganism component",
       "suggestedFor": [
-        "about",
-        "page",
-        "template",
-        "about page template"
+        "team",
+        "organism",
+        "team organism"
       ],
-      "typicalSize": "full",
+      "typicalSize": "large",
       "propsSchema": {
         "entity": {
           "types": [
-            "object"
+            "object",
+            "array"
           ],
-          "description": "Entity data, the sole source of runtime state",
-          "required": true
-        },
-        "className": {
-          "types": [
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "name": {
+                "types": [
+                  "string"
+                ]
+              },
+              "nameAr": {
+                "types": [
+                  "string"
+                ]
+              },
+              "role": {
+                "types": [
+                  "string"
+                ]
+              },
+              "bio": {
+                "types": [
+                  "string"
+                ]
+              },
+              "avatar": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "role",
+              "bio"
+            ]
+          }
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        },
+        "isLoading": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Loading state indicator",
+          "default": false
+        },
+        "error": {
+          "types": [
+            "object"
+          ],
+          "description": "Error state"
+        },
+        "sortBy": {
+          "types": [
+            "string"
+          ],
+          "description": "Current sort field"
+        },
+        "sortDirection": {
+          "types": [
+            "string"
+          ],
+          "description": "Current sort direction"
+        },
+        "searchValue": {
+          "types": [
+            "string"
+          ],
+          "description": "Current search query value"
+        },
+        "page": {
+          "types": [
+            "number"
+          ],
+          "description": "Current page number"
+        },
+        "pageSize": {
+          "types": [
+            "number"
+          ],
+          "description": "Number of items per page"
+        },
+        "totalCount": {
+          "types": [
+            "number"
+          ],
+          "description": "Total number of items"
+        },
+        "activeFilters": {
+          "types": [
+            "object"
+          ],
+          "description": "Active filters"
+        },
+        "selectedIds": {
+          "types": [
+            "array"
+          ],
+          "description": "Currently selected item IDs"
+        },
+        "heading": {
+          "types": [
+            "string"
+          ],
+          "description": "heading prop"
+        },
+        "subtitle": {
+          "types": [
+            "string"
+          ],
+          "description": "subtitle prop"
+        }
+      }
+    },
+    "about-page-template": {
+      "type": "about-page-template",
+      "category": "template",
+      "description": "AboutPageTemplate  An about/company page template with hero, articles, team grid, case studies, and CTA. Pure function: no hooks, no callbacks, no local state.",
+      "suggestedFor": [
+        "about",
+        "page",
+        "template",
+        "about page template"
+      ],
+      "typicalSize": "full",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
             "string"
           ],
           "description": "External styling override"
@@ -21874,122 +22285,518 @@
                 "types": [
                   "string"
                 ]
-              },
-              "level": {
+              },
+              "level": {
+                "types": [
+                  "number"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "label",
+              "level"
+            ]
+          }
+        },
+        "activeId": {
+          "types": [
+            "string"
+          ],
+          "description": "Currently active section id"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "gradient-divider": {
+      "type": "gradient-divider",
+      "category": "component",
+      "description": "GradientDivider component",
+      "suggestedFor": [
+        "gradient",
+        "divider",
+        "gradient divider"
+      ],
+      "typicalSize": "medium",
+      "propsSchema": {
+        "color": {
+          "types": [
+            "string"
+          ],
+          "description": "Override the center color (CSS value). Defaults to var(--color-primary)."
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional class names"
+        }
+      }
+    },
+    "pull-quote": {
+      "type": "pull-quote",
+      "category": "component",
+      "description": "PullQuote component",
+      "suggestedFor": [
+        "pull",
+        "quote",
+        "pull quote"
+      ],
+      "typicalSize": "medium",
+      "propsSchema": {
+        "children": {
+          "types": [
+            "string"
+          ],
+          "description": "The quote text",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional class names"
+        }
+      }
+    },
+    "behavior-view": {
+      "type": "behavior-view",
+      "category": "component",
+      "description": "BehaviorView component",
+      "suggestedFor": [
+        "behavior",
+        "view",
+        "behavior view"
+      ],
+      "typicalSize": "medium",
+      "propsSchema": {
+        "data": {
+          "types": [
+            "object"
+          ],
+          "description": "data prop",
+          "required": true,
+          "properties": {
+            "orbitalName": {
+              "types": [
+                "string"
+              ]
+            },
+            "entityName": {
+              "types": [
+                "string"
+              ]
+            },
+            "persistence": {
+              "types": [
+                "string"
+              ]
+            },
+            "fields": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "type": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "required": {
+                    "types": [
+                      "boolean"
+                    ]
+                  },
+                  "hasDefault": {
+                    "types": [
+                      "boolean"
+                    ]
+                  }
+                },
+                "required": [
+                  "name",
+                  "type",
+                  "required",
+                  "hasDefault"
+                ]
+              }
+            },
+            "traits": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "stateCount": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "eventCount": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "transitionCount": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "emits": {
+                    "types": [
+                      "array"
+                    ],
+                    "items": {
+                      "types": [
+                        "string"
+                      ]
+                    }
+                  },
+                  "listens": {
+                    "types": [
+                      "array"
+                    ],
+                    "items": {
+                      "types": [
+                        "string"
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "name",
+                  "stateCount",
+                  "eventCount",
+                  "transitionCount",
+                  "emits",
+                  "listens"
+                ]
+              }
+            },
+            "pages": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "route": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "name",
+                  "route"
+                ]
+              }
+            },
+            "traitDetails": {
+              "types": [
+                "object"
+              ]
+            },
+            "externalLinks": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "targetOrbital": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "eventName": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "direction": {
+                    "types": [
+                      "string"
+                    ],
+                    "enumValues": [
+                      "out",
+                      "in"
+                    ]
+                  },
+                  "traitName": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "targetOrbital",
+                  "eventName",
+                  "direction",
+                  "traitName"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "orbitalName",
+            "entityName",
+            "persistence",
+            "fields",
+            "traits",
+            "pages",
+            "traitDetails",
+            "externalLinks"
+          ]
+        }
+      }
+    },
+    "module-card": {
+      "type": "module-card",
+      "category": "display",
+      "description": "ModuleCard component",
+      "suggestedFor": [
+        "module",
+        "card",
+        "module card"
+      ],
+      "typicalSize": "medium",
+      "propsSchema": {
+        "data": {
+          "types": [
+            "object"
+          ],
+          "description": "data prop",
+          "required": true,
+          "properties": {
+            "orbitalName": {
+              "types": [
+                "string"
+              ]
+            },
+            "entityName": {
+              "types": [
+                "string"
+              ]
+            },
+            "persistence": {
+              "types": [
+                "string"
+              ]
+            },
+            "fields": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "type": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "required": {
+                    "types": [
+                      "boolean"
+                    ]
+                  },
+                  "hasDefault": {
+                    "types": [
+                      "boolean"
+                    ]
+                  }
+                },
+                "required": [
+                  "name",
+                  "type",
+                  "required",
+                  "hasDefault"
+                ]
+              }
+            },
+            "traits": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "stateCount": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "eventCount": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "transitionCount": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "emits": {
+                    "types": [
+                      "array"
+                    ],
+                    "items": {
+                      "types": [
+                        "string"
+                      ]
+                    }
+                  },
+                  "listens": {
+                    "types": [
+                      "array"
+                    ],
+                    "items": {
+                      "types": [
+                        "string"
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "name",
+                  "stateCount",
+                  "eventCount",
+                  "transitionCount",
+                  "emits",
+                  "listens"
+                ]
+              }
+            },
+            "pages": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "object"
+                ],
+                "properties": {
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "route": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "name",
+                  "route"
+                ]
+              }
+            },
+            "traitDetails": {
+              "types": [
+                "object"
+              ]
+            },
+            "externalLinks": {
+              "types": [
+                "array"
+              ],
+              "items": {
                 "types": [
-                  "number"
+                  "object"
+                ],
+                "properties": {
+                  "targetOrbital": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "eventName": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "direction": {
+                    "types": [
+                      "string"
+                    ],
+                    "enumValues": [
+                      "out",
+                      "in"
+                    ]
+                  },
+                  "traitName": {
+                    "types": [
+                      "string"
+                    ]
+                  }
+                },
+                "required": [
+                  "targetOrbital",
+                  "eventName",
+                  "direction",
+                  "traitName"
                 ]
               }
-            },
-            "required": [
-              "id",
-              "label",
-              "level"
-            ]
-          }
-        },
-        "activeId": {
-          "types": [
-            "string"
-          ],
-          "description": "Currently active section id"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional CSS classes"
-        }
-      }
-    },
-    "gradient-divider": {
-      "type": "gradient-divider",
-      "category": "component",
-      "description": "GradientDivider component",
-      "suggestedFor": [
-        "gradient",
-        "divider",
-        "gradient divider"
-      ],
-      "typicalSize": "medium",
-      "propsSchema": {
-        "color": {
-          "types": [
-            "string"
-          ],
-          "description": "Override the center color (CSS value). Defaults to var(--color-primary)."
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional class names"
-        }
-      }
-    },
-    "pull-quote": {
-      "type": "pull-quote",
-      "category": "component",
-      "description": "PullQuote component",
-      "suggestedFor": [
-        "pull",
-        "quote",
-        "pull quote"
-      ],
-      "typicalSize": "medium",
-      "propsSchema": {
-        "children": {
-          "types": [
-            "string"
-          ],
-          "description": "The quote text",
-          "required": true
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional class names"
-        }
-      }
-    },
-    "behavior-view": {
-      "type": "behavior-view",
-      "category": "component",
-      "description": "BehaviorView component",
-      "suggestedFor": [
-        "behavior",
-        "view",
-        "behavior view"
-      ],
-      "typicalSize": "medium",
-      "propsSchema": {
-        "data": {
-          "types": [
-            "object"
-          ],
-          "description": "data prop",
-          "required": true
-        }
-      }
-    },
-    "module-card": {
-      "type": "module-card",
-      "category": "display",
-      "description": "ModuleCard component",
-      "suggestedFor": [
-        "module",
-        "card",
-        "module card"
-      ],
-      "typicalSize": "medium",
-      "propsSchema": {
-        "data": {
-          "types": [
-            "object"
-          ],
-          "description": "data prop",
-          "required": true
+            }
+          },
+          "propertyRequired": [
+            "orbitalName",
+            "entityName",
+            "persistence",
+            "fields",
+            "traits",
+            "pages",
+            "traitDetails",
+            "externalLinks"
+          ]
         }
       }
     },
@@ -23463,6 +24270,67 @@
           "items": {
             "types": [
               "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "x": {
+                "types": [
+                  "number"
+                ]
+              },
+              "y": {
+                "types": [
+                  "number"
+                ]
+              },
+              "z": {
+                "types": [
+                  "number"
+                ]
+              },
+              "terrain": {
+                "types": [
+                  "string"
+                ]
+              },
+              "type": {
+                "types": [
+                  "string"
+                ]
+              },
+              "terrainSprite": {
+                "types": [
+                  "string"
+                ]
+              },
+              "passable": {
+                "types": [
+                  "boolean"
+                ]
+              },
+              "movementCost": {
+                "types": [
+                  "number"
+                ]
+              },
+              "tileType": {
+                "types": [
+                  "string"
+                ]
+              },
+              "elevation": {
+                "types": [
+                  "number"
+                ]
+              }
+            },
+            "required": [
+              "x",
+              "y"
             ]
           }
         },
@@ -23474,6 +24342,106 @@
           "items": {
             "types": [
               "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "position": {
+                "types": [
+                  "object"
+                ]
+              },
+              "x": {
+                "types": [
+                  "number"
+                ]
+              },
+              "y": {
+                "types": [
+                  "number"
+                ]
+              },
+              "z": {
+                "types": [
+                  "number"
+                ]
+              },
+              "sprite": {
+                "types": [
+                  "string"
+                ]
+              },
+              "unitType": {
+                "types": [
+                  "string"
+                ]
+              },
+              "heroId": {
+                "types": [
+                  "string"
+                ]
+              },
+              "name": {
+                "types": [
+                  "string"
+                ]
+              },
+              "team": {
+                "types": [
+                  "string"
+                ],
+                "enumValues": [
+                  "player",
+                  "enemy",
+                  "neutral"
+                ]
+              },
+              "faction": {
+                "types": [
+                  "string"
+                ],
+                "enumValues": [
+                  "player",
+                  "enemy",
+                  "neutral"
+                ]
+              },
+              "health": {
+                "types": [
+                  "number"
+                ]
+              },
+              "maxHealth": {
+                "types": [
+                  "number"
+                ]
+              },
+              "traits": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "object"
+                  ]
+                }
+              },
+              "previousPosition": {
+                "types": [
+                  "object"
+                ]
+              },
+              "elevation": {
+                "types": [
+                  "number"
+                ]
+              }
+            },
+            "required": [
+              "id"
             ]
           }
         },
@@ -23485,6 +24453,58 @@
           "items": {
             "types": [
               "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "x": {
+                "types": [
+                  "number"
+                ]
+              },
+              "y": {
+                "types": [
+                  "number"
+                ]
+              },
+              "z": {
+                "types": [
+                  "number"
+                ]
+              },
+              "type": {
+                "types": [
+                  "string"
+                ]
+              },
+              "sprite": {
+                "types": [
+                  "string"
+                ]
+              },
+              "assetUrl": {
+                "types": [
+                  "string"
+                ]
+              },
+              "color": {
+                "types": [
+                  "string"
+                ]
+              },
+              "elevation": {
+                "types": [
+                  "number"
+                ]
+              }
+            },
+            "required": [
+              "x",
+              "y",
+              "type"
             ]
           }
         },
@@ -24549,7 +25569,34 @@
             "object"
           ],
           "description": "chapter prop",
-          "required": true
+          "required": true,
+          "properties": {
+            "id": {
+              "types": [
+                "string"
+              ]
+            },
+            "title": {
+              "types": [
+                "string"
+              ]
+            },
+            "content": {
+              "types": [
+                "string"
+              ]
+            },
+            "orbitalSchema": {
+              "types": [
+                "object"
+              ]
+            }
+          },
+          "propertyRequired": [
+            "id",
+            "title",
+            "content"
+          ]
         },
         "direction": {
           "types": [
@@ -24695,6 +25742,54 @@
           "items": {
             "types": [
               "object"
+            ],
+            "properties": {
+              "title": {
+                "types": [
+                  "string"
+                ]
+              },
+              "chapters": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "object"
+                  ],
+                  "properties": {
+                    "id": {
+                      "types": [
+                        "string"
+                      ]
+                    },
+                    "title": {
+                      "types": [
+                        "string"
+                      ]
+                    },
+                    "content": {
+                      "types": [
+                        "string"
+                      ]
+                    },
+                    "orbitalSchema": {
+                      "types": [
+                        "object"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "title",
+                    "content"
+                  ]
+                }
+              }
+            },
+            "required": [
+              "title",
+              "chapters"
             ]
           }
         },
@@ -24729,15 +25824,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -24851,6 +25941,67 @@
               "items": {
                 "types": [
                   "object"
+                ],
+                "properties": {
+                  "id": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "z": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "terrain": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "type": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "terrainSprite": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "passable": {
+                    "types": [
+                      "boolean"
+                    ]
+                  },
+                  "movementCost": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "tileType": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "elevation": {
+                    "types": [
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "x",
+                  "y"
                 ]
               }
             },
@@ -24861,6 +26012,58 @@
               "items": {
                 "types": [
                   "object"
+                ],
+                "properties": {
+                  "id": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "z": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "type": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "sprite": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "assetUrl": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "color": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "elevation": {
+                    "types": [
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "x",
+                  "y",
+                  "type"
                 ]
               }
             },
@@ -25341,10 +26544,24 @@
       "propsSchema": {
         "actionType": {
           "types": [
-            "object"
+            "string"
           ],
           "description": "The type of combat action to visualise",
-          "required": true
+          "required": true,
+          "enumValues": [
+            "melee",
+            "ranged",
+            "magic",
+            "heal",
+            "defend",
+            "hit",
+            "death",
+            "buff",
+            "debuff",
+            "shield",
+            "aoe",
+            "critical"
+          ]
         },
         "x": {
           "types": [
@@ -25424,7 +26641,27 @@
           "types": [
             "object"
           ],
-          "description": "Full effect asset manifest for the sprite particle engine. When provided, enables the canvas-based particle system."
+          "description": "Full effect asset manifest for the sprite particle engine. When provided, enables the canvas-based particle system.",
+          "properties": {
+            "baseUrl": {
+              "types": [
+                "string"
+              ]
+            },
+            "particles": {
+              "types": [
+                "object"
+              ]
+            },
+            "animations": {
+              "types": [
+                "object"
+              ]
+            }
+          },
+          "propertyRequired": [
+            "baseUrl"
+          ]
         },
         "width": {
           "types": [
@@ -25472,6 +26709,67 @@
               "items": {
                 "types": [
                   "object"
+                ],
+                "properties": {
+                  "id": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "z": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "terrain": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "type": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "terrainSprite": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "passable": {
+                    "types": [
+                      "boolean"
+                    ]
+                  },
+                  "movementCost": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "tileType": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "elevation": {
+                    "types": [
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "x",
+                  "y"
                 ]
               }
             },
@@ -25482,6 +26780,58 @@
               "items": {
                 "types": [
                   "object"
+                ],
+                "properties": {
+                  "id": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "z": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "type": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "sprite": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "assetUrl": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "color": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "elevation": {
+                    "types": [
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "x",
+                  "y",
+                  "type"
                 ]
               }
             },
@@ -25492,6 +26842,106 @@
               "items": {
                 "types": [
                   "object"
+                ],
+                "properties": {
+                  "id": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "position": {
+                    "types": [
+                      "object"
+                    ]
+                  },
+                  "x": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "y": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "z": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "sprite": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "unitType": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "heroId": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "name": {
+                    "types": [
+                      "string"
+                    ]
+                  },
+                  "team": {
+                    "types": [
+                      "string"
+                    ],
+                    "enumValues": [
+                      "player",
+                      "enemy",
+                      "neutral"
+                    ]
+                  },
+                  "faction": {
+                    "types": [
+                      "string"
+                    ],
+                    "enumValues": [
+                      "player",
+                      "enemy",
+                      "neutral"
+                    ]
+                  },
+                  "health": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "maxHealth": {
+                    "types": [
+                      "number"
+                    ]
+                  },
+                  "traits": {
+                    "types": [
+                      "array"
+                    ],
+                    "items": {
+                      "types": [
+                        "object"
+                      ]
+                    }
+                  },
+                  "previousPosition": {
+                    "types": [
+                      "object"
+                    ]
+                  },
+                  "elevation": {
+                    "types": [
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "id"
                 ]
               }
             },
@@ -29549,6 +30999,58 @@
           "items": {
             "types": [
               "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "x": {
+                "types": [
+                  "number"
+                ]
+              },
+              "y": {
+                "types": [
+                  "number"
+                ]
+              },
+              "z": {
+                "types": [
+                  "number"
+                ]
+              },
+              "type": {
+                "types": [
+                  "string"
+                ]
+              },
+              "sprite": {
+                "types": [
+                  "string"
+                ]
+              },
+              "assetUrl": {
+                "types": [
+                  "string"
+                ]
+              },
+              "color": {
+                "types": [
+                  "string"
+                ]
+              },
+              "elevation": {
+                "types": [
+                  "number"
+                ]
+              }
+            },
+            "required": [
+              "x",
+              "y",
+              "type"
             ]
           }
         },
@@ -29632,15 +31134,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven integration"
-        },
-        "data": {
-          "types": [
+            "object",
             "array"
           ],
-          "description": "Data array provided by the trait via render-ui"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [