@almadar/patterns 2.17.2 → 2.18.1

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-22T03:26:00.903Z",
+  exportedAt: "2026-04-25T12:02:50.943Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -700,12 +700,6 @@ var patterns_registry_default = {
           ],
           description: "Panel width (CSS value, e.g., '400px', '50%')"
         },
-        entityId: {
-          types: [
-            "string"
-          ],
-          description: "Entity ID for fetching specific entity"
-        },
         displayFields: {
           types: [
             "array"
@@ -896,11 +890,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Form mode - 'create' for new records, 'edit' for updating existing",
-          enumValues: [
-            "create",
-            "edit"
-          ]
+          description: "Form mode \u2014 '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: [
@@ -966,12 +956,6 @@ var patterns_registry_default = {
           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"
@@ -1106,11 +1090,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Form mode - 'create' for new records, 'edit' for updating existing",
-          enumValues: [
-            "create",
-            "edit"
-          ]
+          description: "Form mode \u2014 '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: [
@@ -1176,12 +1156,6 @@ var patterns_registry_default = {
           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"
@@ -2110,188 +2084,36 @@ var patterns_registry_default = {
       ],
       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"
         }
       }
     },
@@ -4108,90 +3930,53 @@ var patterns_registry_default = {
       ],
       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 \u2014 emits UI:{action} via eventBus on card click",
-          kind: "event"
-        },
-        isSelected: {
-          types: [
-            "boolean"
-          ],
-          description: "Whether the card is selected (highlighted state)"
+          description: "Card title - renders in header if provided"
         },
-        name: {
+        subtitle: {
           types: [
             "string"
           ],
-          description: "Card name (alias for title)"
-        },
-        level: {
-          types: [
-            "number"
-          ],
-          description: "Level indicator"
-        },
-        maxLevel: {
-          types: [
-            "number"
-          ],
-          description: "Maximum level"
+          description: "Card subtitle - renders below title"
         },
-        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"
+          ]
         }
       }
     },
@@ -6352,34 +6137,41 @@ var patterns_registry_default = {
       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",
@@ -6388,6 +6180,12 @@ var patterns_registry_default = {
             "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"
@@ -7000,78 +6798,29 @@ var patterns_registry_default = {
       ],
       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 \u2014 maps to Button's `icon` (left) or `iconRight` (right).",
           enumValues: [
             "left",
             "right"
           ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
         }
       }
     },
@@ -8880,12 +8629,6 @@ var patterns_registry_default = {
           ],
           description: "Actions"
         },
-        entity: {
-          types: [
-            "string"
-          ],
-          description: "Entity name for schema-driven auto-fetch"
-        },
         isLoading: {
           types: [
             "boolean"
@@ -13516,10 +13259,10 @@ var patterns_registry_default = {
       propsSchema: {
         entity: {
           types: [
-            "unknown",
+            "object",
             "array"
           ],
-          description: "Entity data array",
+          description: "Schema entity data \u2014 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: {
@@ -13628,7 +13371,7 @@ var patterns_registry_default = {
           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: [
@@ -13657,10 +13400,10 @@ var patterns_registry_default = {
       propsSchema: {
         entity: {
           types: [
-            "unknown",
+            "object",
             "array"
           ],
-          description: "Entity data array",
+          description: "Schema entity data \u2014 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: {
@@ -14557,23 +14300,29 @@ var patterns_registry_default = {
       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: [
@@ -24724,7 +24473,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-22T03:26:00.903Z",
+  exportedAt: "2026-04-25T12:02:50.943Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -26535,7 +26284,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-22T03:26:00.903Z",
+  exportedAt: "2026-04-25T12:02:50.943Z",
   contracts: {
     form: {
       emits: [
@@ -27065,7 +26814,7 @@ var event_contracts_default = {
     stats: {
       emits: [],
       requires: [],
-      entityAware: true
+      entityAware: false
     },
     card: {
       emits: [
@@ -27844,6 +27593,26 @@ var event_contracts_default = {
       ],
       requires: [],
       entityAware: false
+    },
+    "ui-slot-renderer": {
+      emits: [
+        {
+          event: "CLOSE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "CANCEL",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
     }
   }
 };