@almadar/patterns 2.0.1 → 2.1.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-03T11:14:06.592Z",
+  exportedAt: "2026-03-06T07:07:47.853Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -477,6 +477,18 @@ var patterns_registry_default = {
             "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"
         }
       }
     },
@@ -2154,6 +2166,12 @@ var patterns_registry_default = {
             "unknown"
           ],
           description: "Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays"
+        },
+        compact: {
+          types: [
+            "boolean"
+          ],
+          description: "Compact display mode"
         }
       }
     },
@@ -2168,6 +2186,84 @@ var patterns_registry_default = {
       ],
       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"
@@ -2186,12 +2282,6 @@ var patterns_registry_default = {
           ],
           description: "Cell definitions",
           required: true
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
         }
       }
     },
@@ -3391,6 +3481,12 @@ var patterns_registry_default = {
             "badgesize"
           ],
           description: "size prop"
+        },
+        amount: {
+          types: [
+            "number"
+          ],
+          description: "Numeric count or amount to display in badge"
         }
       }
     },
@@ -3599,6 +3695,30 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Declarative event name \u2014 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"
         }
       }
     },
@@ -7373,6 +7493,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -7475,6 +7608,12 @@ var patterns_registry_default = {
             "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"
         }
       }
     },
@@ -7489,6 +7628,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -7525,12 +7677,6 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Game controls"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional class name"
         }
       }
     },
@@ -7546,6 +7692,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -7577,12 +7736,6 @@ var patterns_registry_default = {
             "node"
           ],
           description: "Footer content"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional class name"
         }
       }
     },
@@ -7620,6 +7773,12 @@ var patterns_registry_default = {
             "boolean"
           ],
           description: "Whether to show the minimal top bar (default: true)"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Game content rendered inside the full-screen area"
         }
       }
     },
@@ -8629,11 +8788,23 @@ var patterns_registry_default = {
       ],
       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: [
@@ -8643,21 +8814,63 @@ var patterns_registry_default = {
         },
         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: [
@@ -8699,25 +8912,25 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "--- Event handlers ---"
+          description: "--- Event handlers (legacy callbacks \u2014 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: [
@@ -8779,6 +8992,18 @@ var patterns_registry_default = {
           ],
           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"
@@ -8819,7 +9044,7 @@ var patterns_registry_default = {
           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: [
@@ -8852,13 +9077,26 @@ var patterns_registry_default = {
       ],
       typicalSize: "full",
       propsSchema: {
-        scale: {
+        entity: {
           types: [
-            "number"
+            "object"
           ],
-          description: "Canvas render scale"
+          description: "Entity data, the sole source of runtime state",
+          required: true
         },
-        unitScale: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "External styling override"
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        unitScale: {
           types: [
             "number"
           ],
@@ -8877,6 +9115,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -8897,6 +9148,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -9458,10 +9722,81 @@ var patterns_registry_default = {
       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: [
@@ -9588,12 +9923,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "resolveUnitFrame prop"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
         }
       }
     },
@@ -10343,6 +10672,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -10442,6 +10784,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -10536,6 +10891,19 @@ var patterns_registry_default = {
       ],
       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"
@@ -13955,7 +14323,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-03T11:14:06.592Z",
+  exportedAt: "2026-03-06T07:07:47.853Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -14911,7 +15279,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-03T11:14:06.592Z",
+  exportedAt: "2026-03-06T07:07:47.853Z",
   contracts: {
     form: {
       emits: [
@@ -15073,13 +15441,6 @@ var event_contracts_default = {
             type: "object"
           }
         },
-        {
-          event: "VIEW",
-          trigger: "action",
-          payload: {
-            type: "object"
-          }
-        },
         {
           event: "NAVIGATE",
           trigger: "action",
@@ -15114,13 +15475,6 @@ var event_contracts_default = {
           payload: {
             type: "object"
           }
-        },
-        {
-          event: "VIEW",
-          trigger: "action",
-          payload: {
-            type: "object"
-          }
         }
       ],
       requires: [],
@@ -15450,7 +15804,7 @@ var event_contracts_default = {
     "dashboard-grid": {
       emits: [],
       requires: [],
-      entityAware: false
+      entityAware: true
     },
     stats: {
       emits: [],
@@ -15538,19 +15892,25 @@ var event_contracts_default = {
     "dialogue-box": {
       emits: [
         {
-          event: "ADVANCE",
-          trigger: "click",
+          event: "COMPLETE",
+          trigger: "action",
           payload: {
-            type: "void"
+            type: "object"
           }
         },
         {
-          event: "CHOOSE",
-          trigger: "click",
+          event: "CHOICE",
+          trigger: "action",
           payload: {
-            type: "EntityRow"
-          },
-          optional: true
+            type: "object"
+          }
+        },
+        {
+          event: "ADVANCE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
         }
       ],
       requires: [],
@@ -15992,6 +16352,127 @@ var event_contracts_default = {
       ],
       requires: [],
       entityAware: true
+    },
+    "action-buttons": {
+      emits: [
+        {
+          event: "ACTION",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: false
+    },
+    "d-pad": {
+      emits: [
+        {
+          event: "DIRECTION",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: false
+    },
+    "isometric-canvas": {
+      emits: [
+        {
+          event: "TILE_CLICK",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "UNIT_CLICK",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "TILE_HOVER",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "TILE_LEAVE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
+    },
+    "trait-slot": {
+      emits: [
+        {
+          event: "CLICK",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "REMOVE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
+    },
+    "world-map-board": {
+      emits: [
+        {
+          event: "HERO_SELECT",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "HERO_MOVE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "BATTLE_ENCOUNTER",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "FEATURE_ENTER",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "TILE_CLICK",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
     }
   }
 };