@almadar/ui 4.2.1 → 4.3.0

package/dist/avl/index.cjs

@@ -10859,21 +10859,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = React126.useState(false);
       const fabRef = React126.useRef(null);
       React126.useEffect(() => {

package/dist/avl/index.js

@@ -10813,21 +10813,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = useState(false);
       const fabRef = useRef(null);
       useEffect(() => {

package/dist/components/index.cjs

@@ -6112,21 +6112,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     exports.FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = React110.useState(false);
       const fabRef = React110.useRef(null);
       React110.useEffect(() => {

package/dist/components/index.js

@@ -6067,21 +6067,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = useState(false);
       const fabRef = useRef(null);
       useEffect(() => {

package/dist/components/molecules/FloatingActionButton.d.ts

@@ -3,9 +3,15 @@
  *
  * A floating action button that can expand into multiple actions vertically.
  * Uses Button atom.
+ *
+ * Props mirror Button's `action`/`actionPayload` convention so a schema can
+ * declare `{ type: "floating-action-button", action: "INIT", icon: "plus" }`
+ * and have the FAB emit `UI:INIT` via the event bus on click — same shape
+ * any other clickable surface uses.
  */
 import React from "react";
 import type { LucideIcon } from "lucide-react";
+import type { EventKey, EventPayload } from "@almadar/core";
 export interface FloatingAction {
     /**
      * Action ID
@@ -32,30 +38,38 @@ export interface FloatingAction {
 }
 export interface FloatingActionButtonProps {
     /**
-     * Single action (if only one action, button will directly trigger onClick)
+     * 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.
+     */
+    action?: EventKey;
+    /**
+     * Payload to include with the dispatched action event.
      */
-    action?: {
-        icon: LucideIcon;
-        onClick: () => void;
-        label?: string;
-        variant?: "primary" | "secondary" | "success" | "danger" | "warning";
-    };
+    actionPayload?: EventPayload;
     /**
-     * Multiple actions (if provided, button will expand to show all actions)
+     * Multiple actions. When provided, the button expands to show all of them.
      */
     actions?: FloatingAction[];
     /**
-     * Icon name (simplified API for pattern compatibility)
+     * Icon name (resolves to a Lucide icon by PascalCase / kebab-case lookup).
      */
     icon?: string;
     /**
-     * Click handler (simplified API for pattern compatibility)
+     * Optional direct click handler. Runs after the action emit when both are
+     * present.
      */
     onClick?: () => void;
     /**
-     * Variant (simplified API for pattern compatibility)
+     * Visual variant.
      */
     variant?: "primary" | "secondary" | "success" | "danger" | "warning";
+    /**
+     * Optional label shown via `aria-label` (visually hidden in single-action
+     * mode; rendered as a tooltip beside expanded actions in multi-action mode).
+     */
+    label?: string;
     /**
      * Button position
      * @default 'bottom-right'

package/dist/providers/index.cjs

@@ -7743,21 +7743,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = React115.useState(false);
       const fabRef = React115.useRef(null);
       React115.useEffect(() => {

package/dist/providers/index.js

@@ -7698,21 +7698,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = useState(false);
       const fabRef = useRef(null);
       useEffect(() => {

package/dist/runtime/index.cjs

@@ -7894,21 +7894,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = React115.useState(false);
       const fabRef = React115.useRef(null);
       React115.useEffect(() => {

package/dist/runtime/index.js

@@ -7849,21 +7849,26 @@ var init_FloatingActionButton = __esm({
     init_useTranslate();
     FloatingActionButton = ({
       action,
+      actionPayload,
       actions,
       icon,
       onClick,
       variant,
+      label,
       position = "bottom-right",
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const resolvedAction = action ?? (icon ? {
+      const resolvedAction = icon ? {
         icon: resolveIcon2(icon),
-        onClick: onClick ?? (() => {
-        }),
+        onClick: () => {
+          if (action) eventBus.emit(`UI:${action}`, actionPayload ?? {});
+          onClick?.();
+        },
+        label,
         variant
-      } : void 0);
+      } : void 0;
       const [isExpanded, setIsExpanded] = useState(false);
       const fabRef = useRef(null);
       useEffect(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.2.1",
+  "version": "4.3.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",