@almadar/patterns 2.17.2 → 2.18.2

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-04-22T03:26:00.903Z",
+  "exportedAt": "2026-04-25T12:02:50.943Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -699,12 +699,6 @@
           ],
           "description": "Panel width (CSS value, e.g., '400px', '50%')"
         },
-        "entityId": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity ID for fetching specific entity"
-        },
         "displayFields": {
           "types": [
             "array"
@@ -895,11 +889,7 @@
           "types": [
             "string"
           ],
-          "description": "Form mode - 'create' for new records, 'edit' for updating existing",
-          "enumValues": [
-            "create",
-            "edit"
-          ]
+          "description": "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         },
         "fields": {
           "types": [
@@ -965,12 +955,6 @@
           "description": "Event to dispatch on cancel (defaults to 'CANCEL')",
           "kind": "event"
         },
-        "entityId": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity ID binding for edit mode (triggers initialData from selectedEntity in compiled code)"
-        },
         "relationsData": {
           "types": [
             "object"
@@ -1105,11 +1089,7 @@
           "types": [
             "string"
           ],
-          "description": "Form mode - 'create' for new records, 'edit' for updating existing",
-          "enumValues": [
-            "create",
-            "edit"
-          ]
+          "description": "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         },
         "fields": {
           "types": [
@@ -1175,12 +1155,6 @@
           "description": "Event to dispatch on cancel (defaults to 'CANCEL')",
           "kind": "event"
         },
-        "entityId": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity ID binding for edit mode (triggers initialData from selectedEntity in compiled code)"
-        },
         "relationsData": {
           "types": [
             "object"
@@ -2109,188 +2083,36 @@
       ],
       "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": {
+        "value": {
           "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"
+          "description": "The stat value to display prominently",
+          "required": true
         },
         "label": {
           "types": [
             "string"
           ],
-          "description": "Main label"
-        },
-        "title": {
-          "types": [
-            "string"
-          ],
-          "description": "Title (alias for label)"
-        },
-        "value": {
-          "types": [
-            "string",
-            "number",
-            "array",
-            "unknown"
-          ],
-          "description": "Primary value - accepts array/unknown from generated code (will use first element or length)"
-        },
-        "previousValue": {
-          "types": [
-            "number"
-          ],
-          "description": "Previous value for comparison"
-        },
-        "currentValue": {
-          "types": [
-            "number"
-          ],
-          "description": "Current value as number for trend calculation"
-        },
-        "trend": {
-          "types": [
-            "number"
-          ],
-          "description": "Manual trend percentage (overrides calculation)"
+          "description": "Label describing the value",
+          "required": true
         },
-        "trendDirection": {
+        "size": {
           "types": [
             "string"
           ],
-          "description": "Trend direction (overrides calculation)",
+          "description": "Size of the value text",
           "enumValues": [
-            "up",
-            "down",
-            "neutral"
+            "sm",
+            "md",
+            "lg"
           ]
         },
-        "invertTrend": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Whether up is good (green) or bad (red)"
-        },
-        "icon": {
-          "types": [
-            "icon",
-            "string"
-          ],
-          "description": "Icon to display (Lucide component or icon name string)"
-        },
-        "iconBg": {
-          "types": [
-            "string"
-          ],
-          "description": "Icon background color"
-        },
-        "iconColor": {
-          "types": [
-            "string"
-          ],
-          "description": "Icon color"
-        },
-        "subtitle": {
+        "className": {
           "types": [
             "string"
           ],
-          "description": "Subtitle or description"
-        },
-        "action": {
-          "types": [
-            "object"
-          ],
-          "description": "Action button"
-        },
-        "metrics": {
-          "types": [
-            "array"
-          ],
-          "description": "Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays"
-        },
-        "compact": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Compact display mode"
-        },
-        "sparklineData": {
-          "types": [
-            "array"
-          ],
-          "description": "Sparkline data points for an inline trend chart"
+          "description": "Additional class names"
         }
       }
     },
@@ -4107,90 +3929,53 @@
       ],
       "typicalSize": "small",
       "propsSchema": {
-        "title": {
-          "types": [
-            "string"
-          ],
-          "description": "Card title"
-        },
-        "subtitle": {
-          "types": [
-            "string"
-          ],
-          "description": "Card subtitle or description"
-        },
-        "image": {
+        "variant": {
           "types": [
             "string"
           ],
-          "description": "Image URL to display at top of card"
-        },
-        "actions": {
-          "types": [
-            "array"
-          ],
-          "description": "Action buttons to display in card footer"
-        },
-        "children": {
-          "types": [
-            "node"
-          ],
-          "description": "Card content"
-        },
-        "onClick": {
-          "types": [
-            "function"
-          ],
-          "description": "Click handler for the entire card"
+          "description": "variant prop",
+          "enumValues": [
+            "default",
+            "bordered",
+            "elevated",
+            "interactive"
+          ]
         },
-        "className": {
+        "padding": {
           "types": [
             "string"
           ],
-          "description": "Additional CSS classes"
+          "description": "padding prop",
+          "enumValues": [
+            "none",
+            "sm",
+            "md",
+            "lg"
+          ]
         },
-        "action": {
+        "title": {
           "types": [
             "string"
           ],
-          "description": "Declarative event name — emits UI:{action} via eventBus on card click",
-          "kind": "event"
+          "description": "Card title - renders in header if provided"
         },
-        "isSelected": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Whether the card is selected (highlighted state)"
-        },
-        "name": {
+        "subtitle": {
           "types": [
             "string"
           ],
-          "description": "Card name (alias for title)"
-        },
-        "level": {
-          "types": [
-            "number"
-          ],
-          "description": "Level indicator"
+          "description": "Card subtitle - renders below title"
         },
-        "maxLevel": {
-          "types": [
-            "number"
-          ],
-          "description": "Maximum level"
-        },
-        "longPressEvent": {
+        "shadow": {
           "types": [
             "string"
           ],
-          "description": "Event emitted on long press: UI:{longPressEvent}"
-        },
-        "longPressPayload": {
-          "types": [
-            "object"
-          ],
-          "description": "Additional payload for long-press events"
+          "description": "Shadow size override",
+          "enumValues": [
+            "none",
+            "sm",
+            "md",
+            "lg"
+          ]
         }
       }
     },
@@ -6351,34 +6136,41 @@
       "typicalSize": "medium",
       "propsSchema": {
         "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name. When set, clicking the FAB emits `UI:{action}` via the event bus and (if also provided) calls `onClick`. Mirrors the Button atom's `action` prop so schemas can write `{ type: \"floating-action-button\", action: \"INIT\" }` uniformly.",
+          "kind": "event"
+        },
+        "actionPayload": {
           "types": [
             "object"
           ],
-          "description": "Single action (if only one action, button will directly trigger onClick)"
+          "description": "Payload to include with the dispatched action event."
         },
         "actions": {
           "types": [
             "array"
           ],
-          "description": "Multiple actions (if provided, button will expand to show all actions)"
+          "description": "Multiple actions. When provided, the button expands to show all of them."
         },
         "icon": {
           "types": [
             "string"
           ],
-          "description": "Icon name (simplified API for pattern compatibility)"
+          "description": "Icon name (resolves to a Lucide icon by PascalCase / kebab-case lookup)."
         },
         "onClick": {
           "types": [
             "function"
           ],
-          "description": "Click handler (simplified API for pattern compatibility)"
+          "description": "Optional direct click handler. Runs after the action emit when both are present."
         },
         "variant": {
           "types": [
             "string"
           ],
-          "description": "Variant (simplified API for pattern compatibility)",
+          "description": "Visual variant.",
           "enumValues": [
             "primary",
             "secondary",
@@ -6387,6 +6179,12 @@
             "warning"
           ]
         },
+        "label": {
+          "types": [
+            "string"
+          ],
+          "description": "Optional label shown via `aria-label` (visually hidden in single-action mode; rendered as a tooltip beside expanded actions in multi-action mode)."
+        },
         "position": {
           "types": [
             "string"
@@ -6999,78 +6797,29 @@
       ],
       "typicalSize": "large",
       "propsSchema": {
-        "label": {
-          "types": [
-            "string"
-          ],
-          "description": "label prop",
-          "required": true
-        },
-        "variant": {
-          "types": [
-            "string"
-          ],
-          "description": "variant prop",
-          "enumValues": [
-            "primary",
-            "secondary",
-            "ghost",
-            "danger",
-            "success",
-            "warning",
-            "default"
-          ]
-        },
-        "size": {
-          "types": [
-            "string"
-          ],
-          "description": "size prop",
-          "enumValues": [
-            "sm",
-            "md",
-            "lg"
-          ]
-        },
-        "disabled": {
-          "types": [
-            "boolean"
-          ],
-          "description": "disabled prop"
-        },
         "onClick": {
           "types": [
             "string"
           ],
-          "description": "onClick prop"
+          "description": "Legacy alias for {@link ButtonProps.action} (string event name).",
+          "kind": "event"
         },
         "event": {
           "types": [
             "string"
           ],
-          "description": "event prop"
-        },
-        "icon": {
-          "types": [
-            "string"
-          ],
-          "description": "icon prop"
+          "description": "Legacy alias for {@link ButtonProps.action}.",
+          "kind": "event"
         },
         "iconPosition": {
           "types": [
             "string"
           ],
-          "description": "iconPosition prop",
+          "description": "Icon placement — maps to Button's `icon` (left) or `iconRight` (right).",
           "enumValues": [
             "left",
             "right"
           ]
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "className prop"
         }
       }
     },
@@ -8879,12 +8628,6 @@
           ],
           "description": "Actions"
         },
-        "entity": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity name for schema-driven auto-fetch"
-        },
         "isLoading": {
           "types": [
             "boolean"
@@ -13515,10 +13258,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "unknown",
+            "object",
             "array"
           ],
-          "description": "Entity data array",
+          "description": "Schema entity data — single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive cards typed to that exact shape.",
           "required": true
         },
         "fields": {
@@ -13627,7 +13370,7 @@
           "types": [
             "function"
           ],
-          "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
+          "description": "Render prop for custom per-card content, typed to the grid's entity shape `T`. When provided, `fields` and `itemActions` are ignored."
         },
         "renderItem": {
           "types": [
@@ -13656,10 +13399,10 @@
       "propsSchema": {
         "entity": {
           "types": [
-            "unknown",
+            "object",
             "array"
           ],
-          "description": "Entity data array",
+          "description": "Schema entity data — single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive items of that exact shape.",
           "required": true
         },
         "fields": {
@@ -14556,23 +14299,29 @@
       "propsSchema": {
         "value": {
           "types": [
+            "number",
             "string"
           ],
-          "description": "Target value to count to (e.g. \"500+\", \"99.9%\", \"3x\")",
+          "description": "The target value to animate to. Strings are parsed numerically (e.g. \"500\", \"99.9\").",
           "required": true
         },
-        "label": {
+        "duration": {
+          "types": [
+            "number"
+          ],
+          "description": "Animation duration in milliseconds"
+        },
+        "prefix": {
           "types": [
             "string"
           ],
-          "description": "Label displayed below the number",
-          "required": true
+          "description": "Text to display before the number"
         },
-        "duration": {
+        "suffix": {
           "types": [
-            "number"
+            "string"
           ],
-          "description": "Animation duration in ms"
+          "description": "Text to display after the number"
         },
         "className": {
           "types": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/patterns",
-  "version": "2.17.2",
+  "version": "2.18.2",
   "description": "Pattern registry and component mappings for Almadar",
   "type": "module",
   "main": "./dist/index.js",