@almadar/ui 4.25.0 → 4.27.0

package/dist/components/templates/DashboardLayout.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { LucideIcon } from "lucide-react";
-import type { EventEmit } from "@almadar/core";
+import type { EventEmit, EventKey } from "@almadar/core";
 export interface NavItem {
     label: string;
     href: string;
@@ -20,6 +20,25 @@ export interface NotificationItem {
     /** Optional flag — bell badge counts items where read !== true. */
     read?: boolean;
 }
+/** A generic top-bar action button. Domain-agnostic — consumers wire any
+ *  combination (cart icon, profile, help, custom). Each entry renders as
+ *  an icon button between the search bar and the notifications bell;
+ *  click dispatches the configured event onto the bus. */
+export interface TopBarAction {
+    /** Lucide icon name (e.g. "shopping-cart", "user", "help-circle"). */
+    icon: string;
+    /** Optional aria-label / tooltip. Falls back to `icon`. */
+    label?: string;
+    /** Bus event fired on click. Dispatched as `UI:{event}` with empty payload.
+     *  Typed as `EventKey` so the pattern-sync detector marks `topBarActions`
+     *  as `event-list` and the validator checks references against trait
+     *  emit/listen sets. */
+    event: EventKey;
+    /** Optional badge — number or string rendered in the corner of the icon. */
+    badge?: number | string;
+    /** Visual variant. Default `"default"`. */
+    variant?: "default" | "primary" | "danger";
+}
 export interface DashboardLayoutProps {
     /** App name shown in sidebar */
     appName?: string;
@@ -49,6 +68,12 @@ export interface DashboardLayoutProps {
     /** React-side search submit callback. Used when the host wires the
      *  layout directly (not via render-ui pattern resolution). */
     onSearchSubmit?: (value: string) => void;
+    /** Generic top-bar action buttons rendered between the search bar and
+     *  the notifications bell. Each entry: `{icon, label?, event, badge?, variant?}`.
+     *  Domain-agnostic — consumers add a cart icon, profile button, help-bubble,
+     *  or any other top-bar action by appending entries. Empty array (default)
+     *  renders nothing. */
+    topBarActions?: TopBarAction[];
     /** Notification list. Pass an empty array to show the bell with no
      *  badge; omit / pass null to hide the bell entirely. */
     notifications?: NotificationItem[] | null;

package/dist/docs/index.cjs

@@ -27,7 +27,7 @@ function _interopNamespace(e) {
 var React5__default = /*#__PURE__*/_interopDefault(React5);
 var LucideIcons__namespace = /*#__PURE__*/_interopNamespace(LucideIcons);
 
-// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+// node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -42,7 +42,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/docs/index.js

@@ -3,7 +3,7 @@ import { jsx, jsxs } from 'react/jsx-runtime';
 import * as LucideIcons from 'lucide-react';
 import { Loader2, ChevronDown, X } from 'lucide-react';
 
-// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+// node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -18,7 +18,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/marketing/index.cjs

@@ -27,7 +27,7 @@ function _interopNamespace(e) {
 var React6__default = /*#__PURE__*/_interopDefault(React6);
 var LucideIcons__namespace = /*#__PURE__*/_interopNamespace(LucideIcons);
 
-// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+// node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -42,7 +42,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/marketing/index.js

@@ -3,7 +3,7 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import * as LucideIcons from 'lucide-react';
 import { Loader2, Check, User } from 'lucide-react';
 
-// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+// node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -18,7 +18,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);