@almadar/patterns 2.0.1 → 2.1.0

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-03-03T11:14:06.592Z",
+  "exportedAt": "2026-03-06T07:07:47.853Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -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"
         }
       }
     },
@@ -2153,6 +2165,12 @@
             "unknown"
           ],
           "description": "Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays"
+        },
+        "compact": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Compact display mode"
         }
       }
     },
@@ -2167,6 +2185,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"
+        },
         "columns": {
           "types": [
             "number"
@@ -2185,12 +2281,6 @@
           ],
           "description": "Cell definitions",
           "required": true
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional CSS classes"
         }
       }
     },
@@ -3390,6 +3480,12 @@
             "badgesize"
           ],
           "description": "size prop"
+        },
+        "amount": {
+          "types": [
+            "number"
+          ],
+          "description": "Numeric count or amount to display in badge"
         }
       }
     },
@@ -3598,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"
         }
       }
     },
@@ -7372,6 +7492,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "onIncrement": {
           "types": [
             "function"
@@ -7474,6 +7607,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"
         }
       }
     },
@@ -7488,6 +7627,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional class name"
+        },
         "title": {
           "types": [
             "string"
@@ -7524,12 +7676,6 @@
             "object"
           ],
           "description": "Game controls"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional class name"
         }
       }
     },
@@ -7545,6 +7691,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional class name"
+        },
         "title": {
           "types": [
             "string"
@@ -7576,12 +7735,6 @@
             "node"
           ],
           "description": "Footer content"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Additional class name"
         }
       }
     },
@@ -7619,6 +7772,12 @@
             "boolean"
           ],
           "description": "Whether to show the minimal top bar (default: true)"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Game content rendered inside the full-screen area"
         }
       }
     },
@@ -8628,11 +8787,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": [
@@ -8642,21 +8813,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": [
@@ -8698,25 +8911,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": [
@@ -8778,6 +8991,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"
@@ -8818,7 +9043,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": [
@@ -8851,6 +9076,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "scale": {
           "types": [
             "number"
@@ -8876,6 +9114,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "scale": {
           "types": [
             "number"
@@ -8896,6 +9147,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "scale": {
           "types": [
             "number"
@@ -9457,10 +9721,81 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "worldmapentity"
+            "string"
           ],
-          "description": "World map entity data",
-          "required": true
+          "description": "Entity name for schema-driven integration"
+        },
+        "data": {
+          "types": [
+            "array"
+          ],
+          "description": "Data array provided by the trait via render-ui"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "className prop"
+        },
+        "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"
         },
         "scale": {
           "types": [
@@ -9587,12 +9922,6 @@
             "function"
           ],
           "description": "resolveUnitFrame prop"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "className prop"
         }
       }
     },
@@ -10342,6 +10671,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "cameraMode": {
           "types": [
             "string"
@@ -10441,6 +10783,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "cameraMode": {
           "types": [
             "string"
@@ -10535,6 +10890,19 @@
       ],
       "typicalSize": "full",
       "propsSchema": {
+        "entity": {
+          "types": [
+            "object"
+          ],
+          "description": "Entity data, the sole source of runtime state",
+          "required": true
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "External styling override"
+        },
         "cameraMode": {
           "types": [
             "string"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/patterns",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Pattern registry and component mappings for Almadar",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,6 +24,9 @@
     "access": "public"
   },
   "devDependencies": {
+    "eslint": "10.0.0",
+    "@typescript-eslint/parser": "8.56.0",
+    "@almadar/eslint-plugin": ">=2.3.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^1.4.0"