@almadar/patterns 2.0.0 → 2.0.3

package/dist/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-02-23T07:59:54.575Z",
+  "exportedAt": "2026-03-05T06:51:24.222Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -445,7 +445,7 @@
           "types": [
             "node"
           ],
-          "description": "Children elements (cards) - optional when using entity/data props"
+          "description": "Children elements (cards) - optional when using entity prop"
         },
         "fields": {
           "types": [
@@ -476,6 +476,18 @@
             "boolean"
           ],
           "description": "Show total count in pagination"
+        },
+        "showAvatar": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Show avatar/image field on cards"
+        },
+        "variant": {
+          "types": [
+            "string"
+          ],
+          "description": "Visual variant for the card grid"
         }
       }
     },
@@ -490,6 +502,84 @@
       ],
       "typicalSize": "medium",
       "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"
+        },
+        "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"
+        },
         "title": {
           "types": [
             "string"
@@ -550,13 +640,6 @@
           ],
           "description": "Alias for fields - backwards compatibility"
         },
-        "data": {
-          "types": [
-            "object",
-            "unknown"
-          ],
-          "description": "Data object provided by the trait via render-ui"
-        },
         "initialData": {
           "types": [
             "object",
@@ -581,6 +664,24 @@
             "string"
           ],
           "description": "Panel width (CSS value, e.g., '400px', '50%')"
+        },
+        "entityId": {
+          "types": [
+            "string"
+          ],
+          "description": "Entity ID for fetching specific entity"
+        },
+        "displayFields": {
+          "types": [
+            "unknown"
+          ],
+          "description": "Display fields (alias for fields)"
+        },
+        "showActions": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Show actions flag"
         }
       }
     },
@@ -740,7 +841,8 @@
         },
         "entity": {
           "types": [
-            "string"
+            "string",
+            "orbitalentity"
           ],
           "description": "Schema-based props"
         },
@@ -926,7 +1028,8 @@
         },
         "entity": {
           "types": [
-            "string"
+            "string",
+            "orbitalentity"
           ],
           "description": "Schema-based props"
         },
@@ -1898,6 +2001,84 @@
       ],
       "typicalSize": "small",
       "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"
+        },
+        "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"
+        },
         "label": {
           "types": [
             "string"
@@ -1979,41 +2160,17 @@
           ],
           "description": "Action button"
         },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "className prop"
-        },
-        "entity": {
-          "types": [
-            "string"
-          ],
-          "description": "Schema-based props"
-        },
         "metrics": {
           "types": [
             "unknown"
           ],
           "description": "Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays"
         },
-        "data": {
-          "types": [
-            "unknown"
-          ],
-          "description": "Data to calculate stats from - accepts readonly for compatibility with generated const arrays"
-        },
-        "isLoading": {
+        "compact": {
           "types": [
             "boolean"
           ],
-          "description": "Loading state indicator"
-        },
-        "error": {
-          "types": [
-            "error"
-          ],
-          "description": "Error state"
+          "description": "Compact display mode"
         }
       }
     },
@@ -2028,57 +2185,129 @@
       ],
       "typicalSize": "large",
       "propsSchema": {
-        "columns": {
-          "types": [
-            "number"
-          ],
-          "description": "Number of columns"
-        },
-        "gap": {
+        "entity": {
           "types": [
             "string"
           ],
-          "description": "Gap between cells"
+          "description": "Entity name for schema-driven integration"
         },
-        "cells": {
+        "data": {
           "types": [
             "array"
           ],
-          "description": "Cell definitions",
-          "required": true
+          "description": "Data array provided by the trait via render-ui"
         },
         "className": {
           "types": [
             "string"
           ],
           "description": "Additional CSS classes"
-        }
-      }
-    },
-    "modal": {
-      "type": "modal",
-      "category": "container",
-      "description": "Modal dialog overlay",
-      "suggestedFor": [
-        "dialogs",
-        "confirmations",
-        "forms"
-      ],
-      "typicalSize": "medium",
-      "propsSchema": {
-        "isOpen": {
+        },
+        "isLoading": {
           "types": [
             "boolean"
           ],
-          "description": "Whether the modal is open (defaults to true when rendered by slot wrapper)"
+          "description": "Loading state indicator"
         },
-        "onClose": {
+        "error": {
           "types": [
-            "function"
+            "object"
           ],
-          "description": "Callback when modal should close (injected by slot wrapper)"
+          "description": "Error state"
         },
-        "title": {
+        "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"
+        },
+        "columns": {
+          "types": [
+            "number"
+          ],
+          "description": "Number of columns"
+        },
+        "gap": {
+          "types": [
+            "string"
+          ],
+          "description": "Gap between cells"
+        },
+        "cells": {
+          "types": [
+            "array"
+          ],
+          "description": "Cell definitions",
+          "required": true
+        }
+      }
+    },
+    "modal": {
+      "type": "modal",
+      "category": "container",
+      "description": "Modal dialog overlay",
+      "suggestedFor": [
+        "dialogs",
+        "confirmations",
+        "forms"
+      ],
+      "typicalSize": "medium",
+      "propsSchema": {
+        "isOpen": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether the modal is open (defaults to true when rendered by slot wrapper)"
+        },
+        "onClose": {
+          "types": [
+            "function"
+          ],
+          "description": "Callback when modal should close (injected by slot wrapper)"
+        },
+        "title": {
           "types": [
             "string"
           ],
@@ -3251,6 +3480,12 @@
             "badgesize"
           ],
           "description": "size prop"
+        },
+        "amount": {
+          "types": [
+            "number"
+          ],
+          "description": "Numeric count or amount to display in badge"
         }
       }
     },
@@ -3459,6 +3694,30 @@
             "string"
           ],
           "description": "Declarative event name — emits UI:{action} via eventBus on card click"
+        },
+        "isSelected": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether the card is selected (highlighted state)"
+        },
+        "name": {
+          "types": [
+            "string"
+          ],
+          "description": "Card name (alias for title)"
+        },
+        "level": {
+          "types": [
+            "number"
+          ],
+          "description": "Level indicator"
+        },
+        "maxLevel": {
+          "types": [
+            "number"
+          ],
+          "description": "Maximum level"
         }
       }
     },
@@ -6532,6 +6791,84 @@
       ],
       "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"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        },
+        "isLoading": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Loading state indicator"
+        },
+        "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"
+        },
         "logo": {
           "types": [
             "node"
@@ -6581,11 +6918,11 @@
           ],
           "description": "Default collapsed state"
         },
-        "onCollapseChange": {
+        "collapseChangeEvent": {
           "types": [
-            "function"
+            "string"
           ],
-          "description": "Callback when collapse state changes"
+          "description": "Event emitted when collapse state changes, payload: { collapsed: boolean }"
         },
         "hideCollapseButton": {
           "types": [
@@ -6599,41 +6936,17 @@
           ],
           "description": "Show a close button (for mobile)"
         },
-        "onClose": {
-          "types": [
-            "function"
-          ],
-          "description": "Callback when close button is clicked"
-        },
-        "onLogoClick": {
-          "types": [
-            "function"
-          ],
-          "description": "Callback when logo/brand is clicked"
-        },
-        "className": {
+        "closeEvent": {
           "types": [
             "string"
           ],
-          "description": "Additional CSS classes"
-        },
-        "isLoading": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Loading state indicator"
-        },
-        "error": {
-          "types": [
-            "error"
-          ],
-          "description": "Error state"
+          "description": "Event emitted when close button is clicked"
         },
-        "entity": {
+        "logoClickEvent": {
           "types": [
             "string"
           ],
-          "description": "Entity name for schema-driven auto-fetch"
+          "description": "Event emitted when logo/brand is clicked"
         }
       }
     },
@@ -7281,6 +7594,12 @@
             "function"
           ],
           "description": "Callback when user clicks sign out (optional - uses auth context signOut if not provided)"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Page content rendered inside the main area"
         }
       }
     },
@@ -7426,6 +7745,12 @@
             "boolean"
           ],
           "description": "Whether to show the minimal top bar (default: true)"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Game content rendered inside the full-screen area"
         }
       }
     },
@@ -7638,59 +7963,107 @@
       ],
       "typicalSize": "medium",
       "propsSchema": {
-        "title": {
+        "entity": {
           "types": [
             "string"
           ],
-          "description": "Timeline title"
+          "description": "Entity name for schema-driven integration"
         },
-        "items": {
+        "data": {
           "types": [
-            "unknown"
+            "array"
           ],
-          "description": "Timeline items"
+          "description": "Data array provided by the trait via render-ui"
         },
-        "data": {
+        "className": {
           "types": [
-            "unknown"
+            "string"
           ],
-          "description": "Schema-driven data"
+          "description": "Additional CSS classes"
         },
-        "fields": {
+        "isLoading": {
           "types": [
-            "unknown"
+            "boolean"
           ],
-          "description": "Fields to display"
+          "description": "Loading state indicator"
         },
-        "itemActions": {
+        "error": {
           "types": [
-            "unknown"
+            "object"
           ],
-          "description": "Actions per item"
+          "description": "Error state"
         },
-        "entity": {
+        "sortBy": {
           "types": [
             "string"
           ],
-          "description": "Entity name for schema-driven auto-fetch"
+          "description": "Current sort field"
         },
-        "isLoading": {
+        "sortDirection": {
           "types": [
-            "boolean"
+            "string"
           ],
-          "description": "Loading state"
+          "description": "Current sort direction"
         },
-        "error": {
+        "searchValue": {
           "types": [
-            "error"
+            "string"
           ],
-          "description": "Error state"
+          "description": "Current search query value"
         },
-        "className": {
+        "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"
+        },
+        "title": {
           "types": [
             "string"
           ],
-          "description": "Additional CSS classes"
+          "description": "Timeline title"
+        },
+        "items": {
+          "types": [
+            "unknown"
+          ],
+          "description": "Timeline items"
+        },
+        "fields": {
+          "types": [
+            "unknown"
+          ],
+          "description": "Fields to display"
+        },
+        "itemActions": {
+          "types": [
+            "unknown"
+          ],
+          "description": "Actions per item"
         }
       }
     },
@@ -7706,6 +8079,84 @@
       ],
       "typicalSize": "medium",
       "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"
+        },
+        "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"
+        },
         "title": {
           "types": [
             "string"
@@ -7718,12 +8169,6 @@
           ],
           "description": "Media items"
         },
-        "data": {
-          "types": [
-            "unknown"
-          ],
-          "description": "Schema-driven data"
-        },
         "columns": {
           "types": [
             "number"
@@ -7742,11 +8187,11 @@
           ],
           "description": "Selected item IDs"
         },
-        "onSelectionChange": {
+        "selectionEvent": {
           "types": [
-            "function"
+            "string"
           ],
-          "description": "Selection change callback"
+          "description": "Event name emitted when selection changes (emitted as UI:{selectionEvent})"
         },
         "showUpload": {
           "types": [
@@ -7765,30 +8210,6 @@
             "string"
           ],
           "description": "Aspect ratio for thumbnails"
-        },
-        "entity": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven auto-fetch"
-        },
-        "isLoading": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Loading state"
-        },
-        "error": {
-          "types": [
-            "error"
-          ],
-          "description": "Error state"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional CSS classes"
         }
       }
     },
@@ -8339,11 +8760,23 @@
       ],
       "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"
+        },
         "className": {
           "types": [
             "string"
           ],
-          "description": "--- Closed-circuit props (MANDATORY) ---"
+          "description": "Additional CSS classes"
         },
         "isLoading": {
           "types": [
@@ -8353,21 +8786,63 @@
         },
         "error": {
           "types": [
-            "error"
+            "object"
           ],
           "description": "Error state"
         },
-        "entity": {
+        "sortBy": {
           "types": [
             "string"
           ],
-          "description": "Entity name for schema-driven auto-fetch"
+          "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"
         },
         "tiles": {
           "types": [
             "array"
           ],
-          "description": "--- Grid data ---"
+          "description": "EntityDisplayProps provides: className, isLoading, error, entity,"
         },
         "units": {
           "types": [
@@ -8409,25 +8884,25 @@
           "types": [
             "function"
           ],
-          "description": "--- Event handlers ---"
+          "description": "--- Event handlers (legacy callbacks — prefer declarative event string props below) ---"
         },
         "onUnitClick": {
           "types": [
             "function"
           ],
-          "description": "Unit click handler"
+          "description": "eslint-disable-next-line almadar/organism-no-callback-props"
         },
         "onTileHover": {
           "types": [
             "function"
           ],
-          "description": "Tile hover handler"
+          "description": "eslint-disable-next-line almadar/organism-no-callback-props"
         },
         "onTileLeave": {
           "types": [
             "function"
           ],
-          "description": "Tile leave handler"
+          "description": "eslint-disable-next-line almadar/organism-no-callback-props"
         },
         "tileClickEvent": {
           "types": [
@@ -8489,6 +8964,18 @@
           ],
           "description": "Extra scale multiplier for unit draw size. 1 = default."
         },
+        "boardWidth": {
+          "types": [
+            "number"
+          ],
+          "description": "Board width in tiles (overrides tile-derived size)"
+        },
+        "boardHeight": {
+          "types": [
+            "number"
+          ],
+          "description": "Board height in tiles (overrides tile-derived size)"
+        },
         "diamondTopY": {
           "types": [
             "number"
@@ -8529,7 +9016,7 @@
           "types": [
             "function"
           ],
-          "description": "Callback to draw canvas effects after units"
+          "description": "Callback to draw canvas effects after units (canvas-specific: cannot be declarative)"
         },
         "hasActiveEffects": {
           "types": [
@@ -9168,12 +9655,23 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "worldmapentity"
+            "string"
           ],
-          "description": "World map entity data",
-          "required": true
+          "description": "Entity name for schema-driven integration"
         },
-        "isLoading": {
+        "data": {
+          "types": [
+            "array"
+          ],
+          "description": "Data array provided by the trait via render-ui"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "className prop"
+        },
+        "isLoading": {
           "types": [
             "boolean"
           ],
@@ -9181,10 +9679,58 @@
         },
         "error": {
           "types": [
-            "error"
+            "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"
+        },
         "scale": {
           "types": [
             "number"
@@ -9310,12 +9856,6 @@
             "function"
           ],
           "description": "resolveUnitFrame prop"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "className prop"
         }
       }
     },
@@ -11835,9 +12375,10 @@
         },
         "fieldMap": {
           "types": [
-            "bookfieldmap"
+            "bookfieldmap",
+            "string"
           ],
-          "description": "Field name translation map for non-English entity schemas"
+          "description": "Field name translation map — a BookFieldMap object or locale key (\"ar\")"
         }
       }
     },
@@ -11867,6 +12408,999 @@
         }
       }
     },
+    "combat-log": {
+      "type": "combat-log",
+      "category": "game",
+      "description": "CombatLog Component  Scrollable log of combat events with icons and colors. Generalized from Trait Wars — removed asset manifest coupling.",
+      "suggestedFor": [
+        "combat",
+        "log",
+        "combat log"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "events": {
+          "types": [
+            "array"
+          ],
+          "description": "events prop",
+          "required": true
+        },
+        "maxVisible": {
+          "types": [
+            "number"
+          ],
+          "description": "maxVisible prop"
+        },
+        "autoScroll": {
+          "types": [
+            "boolean"
+          ],
+          "description": "autoScroll prop"
+        },
+        "showTimestamps": {
+          "types": [
+            "boolean"
+          ],
+          "description": "showTimestamps prop"
+        },
+        "title": {
+          "types": [
+            "string"
+          ],
+          "description": "title prop"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "className prop"
+        }
+      }
+    },
+    "simulation-canvas": {
+      "type": "simulation-canvas",
+      "category": "game",
+      "description": "SimulationCanvas  Self-contained 2D physics canvas for educational presets. Runs its own Euler integration loop — no external physics hook needed.",
+      "suggestedFor": [
+        "simulation",
+        "canvas",
+        "simulation canvas"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "preset": {
+          "types": [
+            "physicspreset"
+          ],
+          "description": "preset prop",
+          "required": true
+        },
+        "width": {
+          "types": [
+            "number"
+          ],
+          "description": "width prop"
+        },
+        "height": {
+          "types": [
+            "number"
+          ],
+          "description": "height prop"
+        },
+        "running": {
+          "types": [
+            "boolean"
+          ],
+          "description": "running prop",
+          "required": true
+        },
+        "speed": {
+          "types": [
+            "number"
+          ],
+          "description": "speed prop"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "className prop"
+        }
+      }
+    },
+    "simulation-controls": {
+      "type": "simulation-controls",
+      "category": "display",
+      "description": "SimulationControls  Play/pause/step/reset controls with speed and parameter sliders.",
+      "suggestedFor": [
+        "simulation",
+        "controls",
+        "simulation controls"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "running": {
+          "types": [
+            "boolean"
+          ],
+          "description": "running prop",
+          "required": true
+        },
+        "speed": {
+          "types": [
+            "number"
+          ],
+          "description": "speed prop",
+          "required": true
+        },
+        "parameters": {
+          "types": [
+            "object"
+          ],
+          "description": "parameters prop",
+          "required": true
+        },
+        "onPlay": {
+          "types": [
+            "function"
+          ],
+          "description": "onPlay prop",
+          "required": true
+        },
+        "onPause": {
+          "types": [
+            "function"
+          ],
+          "description": "onPause prop",
+          "required": true
+        },
+        "onStep": {
+          "types": [
+            "function"
+          ],
+          "description": "onStep prop",
+          "required": true
+        },
+        "onReset": {
+          "types": [
+            "function"
+          ],
+          "description": "onReset prop",
+          "required": true
+        },
+        "onSpeedChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onSpeedChange prop",
+          "required": true
+        },
+        "onParameterChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onParameterChange prop",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "className prop"
+        }
+      }
+    },
+    "simulation-graph": {
+      "type": "simulation-graph",
+      "category": "display",
+      "description": "SimulationGraph  Real-time measurement graph for physics simulations. Renders measurement data as a simple line chart on canvas.",
+      "suggestedFor": [
+        "simulation",
+        "graph",
+        "simulation graph"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "label": {
+          "types": [
+            "string"
+          ],
+          "description": "label prop",
+          "required": true
+        },
+        "unit": {
+          "types": [
+            "string"
+          ],
+          "description": "unit prop",
+          "required": true
+        },
+        "data": {
+          "types": [
+            "array"
+          ],
+          "description": "data prop",
+          "required": true
+        },
+        "maxPoints": {
+          "types": [
+            "number"
+          ],
+          "description": "maxPoints prop"
+        },
+        "width": {
+          "types": [
+            "number"
+          ],
+          "description": "width prop"
+        },
+        "height": {
+          "types": [
+            "number"
+          ],
+          "description": "height prop"
+        },
+        "color": {
+          "types": [
+            "string"
+          ],
+          "description": "color prop"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "className prop"
+        }
+      }
+    },
+    "builder-board": {
+      "type": "builder-board",
+      "category": "game",
+      "description": "BuilderBoard  Component-snapping game board. The player places components onto slots in a blueprint. Correct placement completes the build.  Good for: architecture, circuits, molecules, system design stories.  Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).",
+      "suggestedFor": [
+        "builder",
+        "board",
+        "builder board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "builderpuzzleentity"
+          ],
+          "description": "entity prop",
+          "required": true
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "completeEvent prop"
+        }
+      }
+    },
+    "classifier-board": {
+      "type": "classifier-board",
+      "category": "game",
+      "description": "ClassifierBoard  Drag-and-drop classification game. The player sorts items into the correct category buckets. All items must be correctly classified to win.  Good for: taxonomy, pattern recognition, sorting stories.  Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).",
+      "suggestedFor": [
+        "classifier",
+        "board",
+        "classifier board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "classifierpuzzleentity"
+          ],
+          "description": "entity prop",
+          "required": true
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "completeEvent prop"
+        }
+      }
+    },
+    "debugger-board": {
+      "type": "debugger-board",
+      "category": "game",
+      "description": "DebuggerBoard  Error-finding game board. The player reviews a code/system listing and identifies lines or elements that contain bugs.  Good for: programming, logic, troubleshooting stories.  Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).",
+      "suggestedFor": [
+        "debugger",
+        "board",
+        "debugger board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "debuggerpuzzleentity"
+          ],
+          "description": "entity prop",
+          "required": true
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "completeEvent prop"
+        }
+      }
+    },
+    "event-handler-board": {
+      "type": "event-handler-board",
+      "category": "game",
+      "description": "EventHandlerBoard Organism  Contains ALL game logic for the Event Handler tier (ages 9-12). Kids click on world objects, set WHEN/THEN rules, and watch event chains cascade during playback.  Encourages experimentation: on failure, resets to editing so the kid can try different rules. After 3 failures, shows a progressive hint.",
+      "suggestedFor": [
+        "event",
+        "handler",
+        "board",
+        "event handler board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "eventhandlerpuzzleentity"
+          ],
+          "description": "Puzzle data",
+          "required": true
+        },
+        "stepDurationMs": {
+          "types": [
+            "number"
+          ],
+          "description": "Playback speed in ms per event"
+        },
+        "playEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Emits UI:{playEvent}"
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Emits UI:{completeEvent} with { success }"
+        }
+      }
+    },
+    "event-log": {
+      "type": "event-log",
+      "category": "display",
+      "description": "EventLog Component  Scrolling log of events during playback in the Event Handler tier. Shows the chain reaction as events cascade through objects.",
+      "suggestedFor": [
+        "event",
+        "log",
+        "event log"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entries": {
+          "types": [
+            "array"
+          ],
+          "description": "Log entries",
+          "required": true
+        },
+        "maxHeight": {
+          "types": [
+            "number"
+          ],
+          "description": "Max visible height before scroll"
+        },
+        "label": {
+          "types": [
+            "string"
+          ],
+          "description": "Title label"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "object-rule-panel": {
+      "type": "object-rule-panel",
+      "category": "display",
+      "description": "ObjectRulePanel Component  Shows the rules panel for a selected world object in the Event Handler tier. Displays object info, its current state (via TraitStateViewer), and a list of WHEN/THEN rules the kid has set.",
+      "suggestedFor": [
+        "object",
+        "rule",
+        "panel",
+        "object rule panel"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "object": {
+          "types": [
+            "puzzleobjectdef"
+          ],
+          "description": "The selected object",
+          "required": true
+        },
+        "onRulesChange": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when rules change",
+          "required": true
+        },
+        "disabled": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether editing is disabled"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "rule-editor": {
+      "type": "rule-editor",
+      "category": "display",
+      "description": "RuleEditor Component  A single WHEN/THEN rule row for the Event Handler tier (ages 9-12). Kid picks an event trigger and an action from dropdowns.",
+      "suggestedFor": [
+        "rule",
+        "editor",
+        "rule editor"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "rule": {
+          "types": [
+            "ruledefinition"
+          ],
+          "description": "The current rule",
+          "required": true
+        },
+        "availableEvents": {
+          "types": [
+            "array"
+          ],
+          "description": "Available event triggers to listen for",
+          "required": true
+        },
+        "availableActions": {
+          "types": [
+            "array"
+          ],
+          "description": "Available actions to perform",
+          "required": true
+        },
+        "onChange": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when rule changes",
+          "required": true
+        },
+        "onRemove": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when rule is removed"
+        },
+        "disabled": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether editing is disabled (during playback)"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "negotiator-board": {
+      "type": "negotiator-board",
+      "category": "game",
+      "description": "NegotiatorBoard  Turn-based decision matrix game. The player makes choices over multiple rounds against an AI opponent. Each round both sides pick an action, and payoffs are determined by the combination.  Good for: ethics, business, game theory, economics stories.  Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).",
+      "suggestedFor": [
+        "negotiator",
+        "board",
+        "negotiator board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "negotiatorpuzzleentity"
+          ],
+          "description": "entity prop",
+          "required": true
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "completeEvent prop"
+        }
+      }
+    },
+    "action-palette": {
+      "type": "action-palette",
+      "category": "display",
+      "description": "ActionPalette Component  Grid of draggable ActionTile components for the Sequencer tier. Kids pick from these to build their sequence.",
+      "suggestedFor": [
+        "action",
+        "palette",
+        "action palette"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "actions": {
+          "types": [
+            "array"
+          ],
+          "description": "Available actions",
+          "required": true
+        },
+        "usedActionIds": {
+          "types": [
+            "array"
+          ],
+          "description": "IDs of actions that are already used (shown as disabled)"
+        },
+        "allowDuplicates": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether each action can be used multiple times"
+        },
+        "categoryColors": {
+          "types": [
+            "object"
+          ],
+          "description": "Category → color mapping"
+        },
+        "size": {
+          "types": [
+            "string"
+          ],
+          "description": "Size variant"
+        },
+        "label": {
+          "types": [
+            "string"
+          ],
+          "description": "Label above the palette"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "action-tile": {
+      "type": "action-tile",
+      "category": "game",
+      "description": "ActionTile Component  A draggable action tile for the Sequencer tier (ages 5-8). Kids drag these from the ActionPalette into SequenceBar slots. Sets SlotItemData on dataTransfer for TraitSlot compatibility.",
+      "suggestedFor": [
+        "action",
+        "tile",
+        "action tile"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "action": {
+          "types": [
+            "slotitemdata"
+          ],
+          "description": "The action data",
+          "required": true
+        },
+        "size": {
+          "types": [
+            "string"
+          ],
+          "description": "Size variant"
+        },
+        "disabled": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether the tile is disabled / already used"
+        },
+        "categoryColors": {
+          "types": [
+            "object"
+          ],
+          "description": "Category → color mapping"
+        }
+      }
+    },
+    "sequence-bar": {
+      "type": "sequence-bar",
+      "category": "display",
+      "description": "SequenceBar Component  A row of TraitSlot components forming the action sequence for the Sequencer tier (ages 5-8). Kids drag ActionTiles from the palette into these slots to build their sequence.",
+      "suggestedFor": [
+        "sequence",
+        "bar",
+        "sequence bar"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "slots": {
+          "types": [
+            "array"
+          ],
+          "description": "The current sequence (sparse — undefined means empty slot)",
+          "required": true
+        },
+        "maxSlots": {
+          "types": [
+            "number"
+          ],
+          "description": "Max number of slots",
+          "required": true
+        },
+        "onSlotDrop": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when an item is dropped into slot at index",
+          "required": true
+        },
+        "onSlotRemove": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when a slot is cleared",
+          "required": true
+        },
+        "playing": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether the sequence is currently playing (disable interaction)"
+        },
+        "currentStep": {
+          "types": [
+            "number"
+          ],
+          "description": "Current step index during playback (-1 = not playing)"
+        },
+        "categoryColors": {
+          "types": [
+            "object"
+          ],
+          "description": "Category → color mapping"
+        },
+        "slotFeedback": {
+          "types": [
+            "array"
+          ],
+          "description": "Per-slot correctness feedback shown after a failed attempt"
+        },
+        "size": {
+          "types": [
+            "string"
+          ],
+          "description": "Size variant"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "sequencer-board": {
+      "type": "sequencer-board",
+      "category": "game",
+      "description": "SequencerBoard Organism  Contains ALL game logic for the Sequencer tier (ages 5-8). Manages the action sequence, validates it, and animates Kekec executing each step on the puzzle scene.  Feedback-first UX: - On failure: slots stay in place, each slot gets a green or red ring showing exactly which steps are correct and which need to change. - Modifying a slot clears its individual feedback so the kid can re-try. - After 3 failures a persistent hint appears above the sequence bar. - \"Reset\" clears everything including attempts / hint.  TraitStateViewer states use indexed labels (\"1. Walk\", \"2. Jump\") so that repeated actions are correctly highlighted during playback.",
+      "suggestedFor": [
+        "sequencer",
+        "board",
+        "sequencer board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "sequencerpuzzleentity"
+          ],
+          "description": "Puzzle data",
+          "required": true
+        },
+        "categoryColors": {
+          "types": [
+            "object"
+          ],
+          "description": "Category → color mapping"
+        },
+        "stepDurationMs": {
+          "types": [
+            "number"
+          ],
+          "description": "Playback speed in ms per step"
+        },
+        "playEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Emits UI:{playEvent} with { sequence: string[] }"
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Emits UI:{completeEvent} with { success: boolean }"
+        }
+      }
+    },
+    "simulator-board": {
+      "type": "simulator-board",
+      "category": "game",
+      "description": "SimulatorBoard  Parameter-slider game board. The player adjusts parameters and observes real-time output. Correct parameter values must bring the output within a target range to win.  Good for: physics, economics, system design stories.  Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).",
+      "suggestedFor": [
+        "simulator",
+        "board",
+        "simulator board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "simulatorpuzzleentity"
+          ],
+          "description": "entity prop",
+          "required": true
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "completeEvent prop"
+        }
+      }
+    },
+    "code-view": {
+      "type": "code-view",
+      "category": "display",
+      "description": "CodeView Component  Shows the JSON code representation of a state machine. Toggle between visual and code view in State Architect tier.",
+      "suggestedFor": [
+        "code",
+        "view",
+        "code view"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "data": {
+          "types": [
+            "object"
+          ],
+          "description": "JSON data to display",
+          "required": true
+        },
+        "label": {
+          "types": [
+            "string"
+          ],
+          "description": "Label"
+        },
+        "defaultExpanded": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether the code is expanded by default"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "state-architect-board": {
+      "type": "state-architect-board",
+      "category": "display",
+      "description": "StateArchitectBoard Organism  Contains ALL game logic for the State Architect tier (ages 13+). Kids design state machines via a visual graph editor, then run them to see if the behavior matches the puzzle goal.",
+      "suggestedFor": [
+        "state",
+        "architect",
+        "board",
+        "state architect board"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entity": {
+          "types": [
+            "statearchitectpuzzleentity"
+          ],
+          "description": "Puzzle data",
+          "required": true
+        },
+        "stepDurationMs": {
+          "types": [
+            "number"
+          ],
+          "description": "Playback speed"
+        },
+        "testEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Emits UI:{testEvent}"
+        },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Emits UI:{completeEvent} with { success, passedTests }"
+        }
+      }
+    },
+    "state-node": {
+      "type": "state-node",
+      "category": "display",
+      "description": "StateNode Component  A draggable state circle for the graph editor in the State Architect tier (ages 13+). Shows state name, highlights when current, and supports click to select.",
+      "suggestedFor": [
+        "state",
+        "node",
+        "state node"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "name": {
+          "types": [
+            "string"
+          ],
+          "description": "State name",
+          "required": true
+        },
+        "isCurrent": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether this is the current active state"
+        },
+        "isSelected": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether this node is selected for editing"
+        },
+        "isInitial": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether this is the initial state"
+        },
+        "position": {
+          "types": [
+            "object"
+          ],
+          "description": "Position on the graph canvas",
+          "required": true
+        },
+        "onClick": {
+          "types": [
+            "function"
+          ],
+          "description": "Click handler"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
+    "transition-arrow": {
+      "type": "transition-arrow",
+      "category": "display",
+      "description": "TransitionArrow Component  An SVG arrow connecting two state nodes in the graph editor. Shows the event name as a label on the arrow.",
+      "suggestedFor": [
+        "transition",
+        "arrow",
+        "transition arrow"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "from": {
+          "types": [
+            "object"
+          ],
+          "description": "Start position (center of from-node)",
+          "required": true
+        },
+        "to": {
+          "types": [
+            "object"
+          ],
+          "description": "End position (center of to-node)",
+          "required": true
+        },
+        "eventLabel": {
+          "types": [
+            "string"
+          ],
+          "description": "Event label shown on the arrow",
+          "required": true
+        },
+        "guardHint": {
+          "types": [
+            "string"
+          ],
+          "description": "Guard hint shown below event"
+        },
+        "isActive": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether this transition is currently active"
+        },
+        "onClick": {
+          "types": [
+            "function"
+          ],
+          "description": "Click handler"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes for the SVG group"
+        }
+      }
+    },
+    "variable-panel": {
+      "type": "variable-panel",
+      "category": "display",
+      "description": "VariablePanel Component  Shows entity variables and their current values during State Architect playback.",
+      "suggestedFor": [
+        "variable",
+        "panel",
+        "variable panel"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "entityName": {
+          "types": [
+            "string"
+          ],
+          "description": "Entity name",
+          "required": true
+        },
+        "variables": {
+          "types": [
+            "array"
+          ],
+          "description": "Variables to display",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes"
+        }
+      }
+    },
     "heading": {
       "type": "heading",
       "category": "component",