@flikk/ui 1.0.0-beta.10 → 1.0.0-beta.12

package/dist/components/ai/ApprovalCard/ApprovalCard.js

@@ -4,12 +4,13 @@ import { approvalCardTheme } from './ApprovalCard.theme.js';
 import { Card } from '../../core/Card/Card.js';
 import { Badge } from '../../core/Badge/Badge.js';
 import { Button } from '../../core/Button/Button.js';
+import 'react';
 import { cn } from '../../../utils/cn.js';
 
 const ApprovalCard = ({ title, subtitle, variant = "default", riskLevel = "medium", onApprove, onDeny, children, isApproving = false, className, }) => {
     const riskColor = approvalCardTheme.badgeColors[riskLevel];
     const riskIcon = riskLevel === "critical" || riskLevel === "high" ? (jsx(ExclamationTriangleIcon, { className: "" })) : (jsx(CheckCircleIcon, { className: "" }));
-    return (jsxs(Card, { className: cn(approvalCardTheme.baseStyle, approvalCardTheme.variants[variant], className), children: [jsx(Card.Header, { children: jsx("div", { className: "flex flex-col items-start", children: jsxs(Badge, { variant: "outline", color: riskColor, size: "sm", iconStart: riskIcon, className: "font-semibold shadow", children: [riskLevel.toUpperCase(), " RISK"] }) }) }), jsxs(Card.Content, { className: "space-y-3", children: [jsxs("div", { className: "space-y-1", children: [jsx(Card.Title, { className: "", children: title }), subtitle && (jsx("p", { className: "text-sm md:text-base text-[var(--color-text-secondary)]/80", children: subtitle }))] }), children && (jsx("div", { className: "bg-[var(--color-background-secondary)] rounded-md p-3 text-sm font-mono border border-[var(--color-border)] overflow-x-auto", children: children }))] }), jsxs(Card.Footer, { className: "justify-end gap-2 mt-3", children: [jsx(Button, { variant: "outline", color: "neutral", size: "sm", onClick: onDeny, children: "Deny" }), jsx(Button, { color: riskColor, size: "sm", state: isApproving ? "loading" : "default", onClick: onApprove, children: "Approve" })] })] }));
+    return (jsxs(Card, { className: cn(approvalCardTheme.baseStyle, approvalCardTheme.variants[variant], className), children: [jsx(Card.Header, { children: jsx("div", { className: "flex flex-col items-start", children: jsxs(Badge, { variant: "outline", color: riskColor, size: "sm", iconStart: riskIcon, className: "font-semibold shadow", children: [riskLevel.toUpperCase(), " RISK"] }) }) }), jsxs(Card.Body, { className: "space-y-3", children: [jsxs("div", { className: "space-y-1", children: [jsx(Card.Title, { className: "", children: title }), subtitle && (jsx("p", { className: "text-sm md:text-base text-[var(--color-text-secondary)]/80", children: subtitle }))] }), children && (jsx("div", { className: "bg-[var(--color-background-secondary)] rounded-md p-3 text-sm font-mono border border-[var(--color-border)] overflow-x-auto", children: children }))] }), jsxs(Card.Footer, { className: "justify-end gap-2 mt-3", children: [jsx(Button, { variant: "outline", color: "neutral", size: "sm", onClick: onDeny, children: "Deny" }), jsx(Button, { color: riskColor, size: "sm", state: isApproving ? "loading" : "default", onClick: onApprove, children: "Approve" })] })] }));
 };
 
 export { ApprovalCard };

package/dist/components/ai/MessageHistory/MessageHistory.js

@@ -3,6 +3,7 @@ import React__default, { useRef, useCallback, useEffect, useMemo } from 'react';
 import { messageHistoryTheme } from './MessageHistory.theme.js';
 import { Message } from '../../core/Message/Message.js';
 import '../../core/Message/TypeWriter.js';
+import '../../core/Message/MessageBody.js';
 import { cn } from '../../../utils/cn.js';
 
 /**

package/dist/components/ai/StreamingResponse/StreamingResponse.js

@@ -3,6 +3,7 @@ import { useRef, useEffect } from 'react';
 import { useStreamingSSE } from '../../../hooks/useStreamingSSE.js';
 import { Message } from '../../core/Message/Message.js';
 import { TypeWriter } from '../../core/Message/TypeWriter.js';
+import '../../core/Message/MessageBody.js';
 import { ErrorDisplay } from './ErrorDisplay.js';
 import { MarkdownRenderer } from './MarkdownRenderer.js';
 import { AnimatedText } from './AnimatedText.js';

package/dist/components/ai/index.js

@@ -1,6 +1,7 @@
 export { Message } from '../core/Message/Message.js';
 export { messageTheme } from '../core/Message/Message.theme.js';
 import '../core/Message/TypeWriter.js';
+import '../core/Message/MessageBody.js';
 export { MessageHistory } from './MessageHistory/MessageHistory.js';
 export { messageHistoryTheme } from './MessageHistory/MessageHistory.theme.js';
 export { PromptInput } from './PromptInput/PromptInput.js';

package/dist/components/core/Accordion/Accordion.animations.d.ts

@@ -1,8 +1,13 @@
-import { Variants } from 'motion/react';
+import type { Variants } from 'motion/react';
 /**
  * Accordion animation variants for smooth, staggered open/close transitions
  */
 export declare const accordionAnimations: Variants;
+/**
+ * Factory for trigger icon rotation variants.
+ * @param rotation - Degrees to rotate when open (e.g. 45 for PlusIcon, 180 for chevron)
+ */
+export declare const createTriggerIconVariants: (rotation: number) => Variants;
 /**
  * Content animation variants for subtle slide-in effect after container expands
  */

package/dist/components/core/Accordion/Accordion.animations.js

@@ -19,6 +19,20 @@ const accordionAnimations = {
         }
     }
 };
+/**
+ * Factory for trigger icon rotation variants.
+ * @param rotation - Degrees to rotate when open (e.g. 45 for PlusIcon, 180 for chevron)
+ */
+const createTriggerIconVariants = (rotation) => ({
+    closed: {
+        rotate: 0,
+        transition: { duration: 0.2, ease: [0.4, 0.0, 0.2, 1] },
+    },
+    open: {
+        rotate: rotation,
+        transition: { duration: 0.2, ease: [0.4, 0.0, 0.2, 1] },
+    },
+});
 /**
  * Content animation variants for subtle slide-in effect after container expands
  */
@@ -42,4 +56,4 @@ const accordionContentAnimations = {
     }
 };
 
-export { accordionAnimations, accordionContentAnimations };
+export { accordionAnimations, accordionContentAnimations, createTriggerIconVariants };

package/dist/components/core/Accordion/Accordion.d.ts

@@ -7,5 +7,5 @@ export declare const Accordion: {
 } & {
     Item: React.ForwardRefExoticComponent<import("./Accordion.types").AccordionItemProps & React.RefAttributes<HTMLDivElement>>;
     Trigger: React.ForwardRefExoticComponent<import("./Accordion.types").AccordionTriggerProps & React.RefAttributes<HTMLButtonElement>>;
-    Content: React.ForwardRefExoticComponent<import("./Accordion.types").AccordionContentProps & React.RefAttributes<HTMLDivElement>>;
+    Body: React.ForwardRefExoticComponent<import("./Accordion.types").AccordionBodyProps & React.RefAttributes<HTMLDivElement>>;
 };

package/dist/components/core/Accordion/Accordion.js

@@ -3,7 +3,7 @@ import { useContext, createContext, useState, useCallback } from 'react';
 import { cn } from '../../../utils/cn.js';
 import { accordionTheme } from './Accordion.theme.js';
 import { AccordionTrigger } from './AccordionTrigger.js';
-import { AccordionContent } from './AccordionContent.js';
+import { AccordionBody } from './AccordionBody.js';
 import { AccordionItem } from './AccordionItem.js';
 
 // Create context for the main Accordion component
@@ -50,7 +50,7 @@ AccordionRoot.displayName = "Accordion";
 const Accordion = Object.assign(AccordionRoot, {
     Item: AccordionItem,
     Trigger: AccordionTrigger,
-    Content: AccordionContent,
+    Body: AccordionBody,
 });
 
 export { Accordion, useAccordionContext };

package/dist/components/core/Accordion/Accordion.theme.d.ts

@@ -2,8 +2,8 @@ export interface AccordionTheme {
     baseStyle: string;
     baseStyleStacked: string;
     triggerStyle: string;
-    contentStyle: string;
-    contentInnerStyle: string;
+    bodyStyle: string;
+    bodyInnerStyle: string;
     itemStyle: string;
     itemStyleStacked: string;
 }

package/dist/components/core/Accordion/Accordion.theme.js

@@ -4,15 +4,15 @@ const accordionTheme = {
     // Base container styles for stacked variant (unified card)
     baseStyleStacked: "w-full border border-[var(--color-border)] rounded-[var(--form-radius)] overflow-hidden",
     // Item styles for separated variant (individual cards with spacing)
-    itemStyle: "border border-[var(--color-border)] rounded-[var(--form-radius)] bg-white dark:bg-[var(--color-background-secondary)] overflow-hidden mb-2 last-of-type:mb-0 data-[state=open]:shadow-xs",
+    itemStyle: "border border-[var(--color-border)] rounded-[var(--form-radius)] bg-white dark:bg-[var(--color-background-secondary)] overflow-hidden mb-2 last-of-type:mb-0",
     // Item styles for stacked variant (shared borders, no spacing)
     itemStyleStacked: "bg-white border-t border-[var(--color-border)] first-of-type:border-t-0",
     // Trigger styles (shared across variants)
-    triggerStyle: "flex w-full gap-3 items-center justify-between px-4 py-2.5 text-left font-medium transition-all duration-200 cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-primary)] focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 text-[var(--color-text-primary)] [&[data-state=open]>svg]:rotate-180 cursor-pointer focus:outline-none transition-all flex justify-between",
-    // Content styles (shared across variants)
-    contentStyle: "data-[state=closed]:max-h-0 data-[state=open]:max-h-[500px] accordion-content overflow-hidden",
-    // Content inner wrapper styles
-    contentInnerStyle: "p-4 pb-2.5 pt-0",
+    triggerStyle: "flex w-full gap-3 items-center px-4 py-2.5 text-left font-medium transition-all duration-200 cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-primary)] focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 text-[var(--color-text-primary)]",
+    // Body styles (shared across variants)
+    bodyStyle: "data-[state=closed]:max-h-0 data-[state=open]:max-h-[320px] accordion-content overflow-hidden",
+    // Body inner wrapper styles
+    bodyInnerStyle: "p-4 pb-2.5 pt-0",
 };
 
 export { accordionTheme };

package/dist/components/core/Accordion/Accordion.types.d.ts

@@ -53,7 +53,8 @@ export interface AccordionContextValue {
     theme: AccordionThemeOverrides & {
         baseStyle: string;
         triggerStyle: string;
-        contentStyle: string;
+        bodyStyle: string;
+        bodyInnerStyle: string;
     };
 }
 /**
@@ -89,11 +90,39 @@ export interface AccordionItemContextValue {
 export interface AccordionTriggerProps extends React.HTMLAttributes<HTMLButtonElement> {
     children: React.ReactNode;
     className?: string;
+    /**
+     * Override the default indicator (chevron) icon.
+     * Set to `null` to hide it entirely — equivalent to `showChevron={false}`.
+     */
+    chevron?: React.ReactNode | null;
+    /**
+     * Rotation degrees applied to the chevron icon when open.
+     * Default: 45 (for PlusIcon). Use 180 for a chevron-down, 90 for a right-arrow, 0 for none.
+     */
+    chevronRotation?: number;
+    /**
+     * Position of the chevron icon.
+     * - `"right"` (default): pushed to the far right after children.
+     * - `"left"`: appears before children.
+     * No effect when `chevron` is explicitly provided.
+     * @default "right"
+     */
+    chevronPosition?: "left" | "right";
+    /**
+     * Set to `false` to hide the chevron icon entirely.
+     * Equivalent to passing `chevron={null}`.
+     * @default true
+     */
+    showChevron?: boolean;
+    /**
+     * @deprecated Use `chevronRotation` instead.
+     */
+    iconRotation?: number;
 }
 /**
- * Content props
+ * Body props
  */
-export interface AccordionContentProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface AccordionBodyProps extends React.HTMLAttributes<HTMLDivElement> {
     children: React.ReactNode;
     className?: string;
 }
@@ -104,7 +133,8 @@ export interface AccordionThemeOverrides {
     baseStyle?: string;
     baseStyleStacked?: string;
     triggerStyle?: string;
-    contentStyle?: string;
+    bodyStyle?: string;
+    bodyInnerStyle?: string;
     itemStyle?: string;
     itemStyleStacked?: string;
 }

package/dist/components/core/Accordion/AccordionBody.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import { AccordionBodyProps } from "./Accordion.types";
+export declare const AccordionBody: React.ForwardRefExoticComponent<AccordionBodyProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/core/Accordion/{AccordionContent.js → AccordionBody.js}

@@ -6,7 +6,7 @@ import { useAccordionItemContext } from './AccordionItem.js';
 import { useReducedMotion, AnimatePresence, motion } from 'motion/react';
 import { accordionAnimations, accordionContentAnimations } from './Accordion.animations.js';
 
-const AccordionContent = React__default.forwardRef(({ children, className, ...rest }, ref) => {
+const AccordionBody = React__default.forwardRef(({ children, className, ...rest }, ref) => {
     const { theme } = useAccordionContext();
     const { isOpen, contentId, triggerId } = useAccordionItemContext();
     const shouldReduceMotion = useReducedMotion();
@@ -14,8 +14,8 @@ const AccordionContent = React__default.forwardRef(({ children, className, ...re
     const instantTransition = shouldReduceMotion ? { duration: 0 } : undefined;
     // Filter out conflicting props to avoid type issues
     const { onDrag, onDragEnd, onDragStart, onAnimationStart, onAnimationEnd, onTransitionEnd, onTransitionStart, ...safeProps } = rest;
-    return (jsx(AnimatePresence, { initial: false, children: isOpen && (jsx(motion.div, { ref: ref, id: contentId, role: "region", "aria-labelledby": triggerId, className: cn(theme === null || theme === void 0 ? void 0 : theme.contentStyle, className), "data-state": isOpen ? "open" : "closed", "aria-hidden": !isOpen, initial: "collapsed", animate: "open", exit: "collapsed", variants: accordionAnimations, transition: instantTransition, ...safeProps, children: jsx(motion.div, { className: "p-4 pt-0", variants: accordionContentAnimations, initial: "collapsed", animate: "open", exit: "collapsed", transition: instantTransition, children: children }) })) }));
+    return (jsx(AnimatePresence, { initial: false, children: isOpen && (jsx(motion.div, { ref: ref, id: contentId, role: "region", "aria-labelledby": triggerId, className: theme === null || theme === void 0 ? void 0 : theme.bodyStyle, "data-state": isOpen ? "open" : "closed", "aria-hidden": !isOpen, initial: "collapsed", animate: "open", exit: "collapsed", variants: accordionAnimations, transition: instantTransition, ...safeProps, children: jsx(motion.div, { className: cn(theme === null || theme === void 0 ? void 0 : theme.bodyInnerStyle, className), variants: accordionContentAnimations, initial: "collapsed", animate: "open", exit: "collapsed", transition: instantTransition, children: children }) })) }));
 });
-AccordionContent.displayName = "AccordionContent";
+AccordionBody.displayName = "Accordion.Body";
 
-export { AccordionContent };
+export { AccordionBody };

package/dist/components/core/Accordion/AccordionItem.js

@@ -9,7 +9,7 @@ const AccordionItemContext = createContext(undefined);
 const useAccordionItemContext = () => {
     const ctx = useContext(AccordionItemContext);
     if (!ctx)
-        throw new Error("Accordion.Trigger and Accordion.Content must be used within Accordion.Item");
+        throw new Error("Accordion.Trigger and Accordion.Body must be used within Accordion.Item");
     return ctx;
 };
 const AccordionItem = React__default.forwardRef(({ children, className, value, ...props }, ref) => {

package/dist/components/core/Accordion/AccordionTrigger.js

@@ -1,18 +1,32 @@
-import { jsxs, jsx } from 'react/jsx-runtime';
+import { jsx, jsxs } from 'react/jsx-runtime';
 import React__default from 'react';
 import { cn } from '../../../utils/cn.js';
 import { useAccordionContext } from './Accordion.js';
 import { useAccordionItemContext } from './AccordionItem.js';
 import { motion } from 'motion/react';
 import { PlusIcon } from '@heroicons/react/24/outline';
+import { createTriggerIconVariants } from './Accordion.animations.js';
 
-const AccordionTrigger = React__default.forwardRef(({ children, className, ...props }, ref) => {
+const AccordionTrigger = React__default.forwardRef(({ children, className, chevron, chevronRotation, iconRotation, chevronPosition = "right", showChevron = true, ...props }, ref) => {
+    var _a;
     const { theme } = useAccordionContext();
     const { isOpen, toggle, triggerId, contentId } = useAccordionItemContext();
-    return (jsxs("button", { ref: ref, type: "button", id: triggerId, className: cn(theme === null || theme === void 0 ? void 0 : theme.triggerStyle, className), "aria-expanded": isOpen, "aria-controls": contentId, "data-state": isOpen ? "open" : "closed", onClick: toggle, ...props, children: [children, jsx(motion.div, { animate: { rotate: isOpen ? 45 : 0 }, transition: {
-                    duration: 0.2,
-                    ease: [0.4, 0.0, 0.2, 1]
-                }, className: "flex items-center justify-center", children: jsx(PlusIcon, { className: "size-4", strokeWidth: 2 }) })] }));
+    const resolvedChevronRotation = (_a = chevronRotation !== null && chevronRotation !== void 0 ? chevronRotation : iconRotation) !== null && _a !== void 0 ? _a : 45;
+    // Resolve the indicator icon, respecting showChevron and chevron overrides
+    const defaultChevronIcon = jsx(PlusIcon, { className: "size-4", strokeWidth: 2 });
+    const resolvedChevron = !showChevron || chevron === null
+        ? null
+        : chevron !== undefined
+            ? chevron
+            : chevronPosition === "left"
+                ? null // rendered in the left slot instead
+                : defaultChevronIcon;
+    // When chevronPosition="left", render the default animated chevron before children
+    const useDefaultOnLeft = showChevron && chevron === null
+        ? false
+        : showChevron && chevronPosition === "left" && chevron === undefined;
+    const animatedChevron = (rotation, extraClass) => (jsx(motion.div, { initial: false, animate: isOpen ? "open" : "closed", variants: createTriggerIconVariants(rotation), className: cn("flex items-center justify-center shrink-0", extraClass), children: defaultChevronIcon }));
+    return (jsxs("button", { ref: ref, type: "button", id: triggerId, className: cn(theme === null || theme === void 0 ? void 0 : theme.triggerStyle, className), "aria-expanded": isOpen, "aria-controls": contentId, "data-state": isOpen ? "open" : "closed", onClick: toggle, ...props, children: [useDefaultOnLeft && animatedChevron(resolvedChevronRotation), children, resolvedChevron && (jsx(motion.div, { initial: false, animate: isOpen ? "open" : "closed", variants: createTriggerIconVariants(resolvedChevronRotation), className: "flex items-center justify-center shrink-0 ml-auto", children: resolvedChevron }))] }));
 });
 AccordionTrigger.displayName = "AccordionTrigger";
 

package/dist/components/core/Accordion/index.d.ts

@@ -1,4 +1,4 @@
 import { Accordion } from "./Accordion";
-import { AccordionProps, AccordionTriggerProps, AccordionContentProps, AccordionItemProps, AccordionContextValue, AccordionItemContextValue, AccordionThemeOverrides } from "./Accordion.types";
+import { AccordionProps, AccordionTriggerProps, AccordionBodyProps, AccordionItemProps, AccordionContextValue, AccordionItemContextValue, AccordionThemeOverrides } from "./Accordion.types";
 export { Accordion };
-export type { AccordionProps, AccordionItemProps, AccordionTriggerProps, AccordionContentProps, AccordionContextValue, AccordionItemContextValue, AccordionThemeOverrides, };
+export type { AccordionProps, AccordionItemProps, AccordionTriggerProps, AccordionBodyProps, AccordionContextValue, AccordionItemContextValue, AccordionThemeOverrides, };

package/dist/components/core/Alert/Alert.js

@@ -33,7 +33,11 @@ const Alert = React__default.forwardRef(({ variant = "default", color = "primary
         const IconComponent = defaultIcons[color];
         return (jsx("div", { className: "flex-shrink-0 w-6 h-6 mt-1", "aria-hidden": "true", children: jsx(IconComponent, { className: cn("w-6 h-6", iconColor) }) }));
     };
-    const alertNode = (jsxs("div", { ref: ref, className: cn(alertTheme.baseStyle, alertTheme.variants[variant], className), role: "alert", "aria-live": "assertive", "aria-atomic": "true", ...props, children: [renderIconOrAvatar(), jsxs("div", { className: `flex-1 min-w-0 ${showDismiss ? "mr-5" : ""}`, children: [title && (jsx("div", { className: cn("font-semibold text-[var(--color-text-primary)]"), children: title })), subtitle && (jsx("div", { className: "text-[var(--color-text-secondary)]/90 mt-1", children: subtitle })), children && jsx("div", { className: "mt-2", children: children }), actions && (jsx("div", { className: "flex items-center gap-2 mt-6", children: actions }))] }), showDismiss && (jsx(Button, { variant: "link", color: "neutral", size: "sm", iconOnly: true, onClick: handleDismiss, "aria-label": "Dismiss alert", className: "rounded-full absolute top-2 right-2 flex-shrink-0", children: jsx(XMarkIcon, { className: "size-4", strokeWidth: 2 }) }))] }));
+    const alertNode = (jsxs("div", { ref: ref, className: cn(alertTheme.baseStyle, alertTheme.variants[variant], className), role: "alert", "aria-live": "assertive", "aria-atomic": "true", ...props, children: [renderIconOrAvatar(), jsxs("div", { className: `flex-1 min-w-0 ${showDismiss ? "mr-5" : ""}`, children: [title && (typeof title === 'string'
+                        ? jsx("div", { className: cn("font-semibold text-[var(--color-text-primary)]"), children: title })
+                        : title), subtitle && (typeof subtitle === 'string'
+                        ? jsx("div", { className: "text-[var(--color-text-secondary)]/90 mt-1", children: subtitle })
+                        : subtitle), children && jsx("div", { className: "mt-2", children: children }), actions && (jsx("div", { className: "flex items-center gap-2 mt-6", children: actions }))] }), showDismiss && (jsx(Button, { variant: "link", color: "neutral", size: "sm", iconOnly: true, onClick: handleDismiss, "aria-label": "Dismiss alert", className: "rounded-full absolute top-2 right-2 flex-shrink-0", children: jsx(XMarkIcon, { className: "size-4", strokeWidth: 2 }) }))] }));
     if (darkMode) {
         return jsx("div", { className: "dark", children: alertNode });
     }

package/dist/components/core/Alert/Alert.types.d.ts

@@ -23,15 +23,15 @@ export interface AlertTheme {
         dismissible: string;
     };
 }
-export interface AlertProps extends HTMLAttributes<HTMLDivElement> {
+export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
     /** Visual variant */
     variant?: AlertVariant;
     /** Semantic color */
     color?: AlertColor;
     /** The main title/message of the alert */
-    title?: string;
+    title?: ReactNode;
     /** Additional subtitle text */
-    subtitle?: string;
+    subtitle?: ReactNode;
     /** Whether the alert can be dismissed */
     dismissible?: boolean;
     /**

package/dist/components/core/Badge/Badge.theme.js

@@ -63,8 +63,8 @@ const badgeTheme = {
     },
     // Flat size structure (no nested objects)
     sizes: {
-        sm: "text-xs md:text-sm px-1.5 py-0.5 gap-1",
-        md: "text-sm md:text-base px-2 py-0.5 gap-1",
+        sm: "text-sm px-1.5 py-0.5 gap-1",
+        md: "text-base px-2 py-0.5 gap-1",
     },
     // Border radius per size (using CSS variable)
     radiusSizes: {

package/dist/components/core/Breadcrumbs/Breadcrumbs.js

@@ -42,8 +42,10 @@ const Breadcrumbs = ({ items, separator, maxItems = 4, variant = "default", clas
     // Render individual breadcrumb item
     const renderItem = (item, index, isLast) => {
         const isCurrentPage = isLast || !item.href;
-        const itemContent = (jsxs(Fragment, { children: [showIcons && item.iconStart && (jsx("span", { className: "mr-1.5 flex-shrink-0", children: item.iconStart })), item.label] }));
-        return (jsx("span", { className: "flex items-center text-base", children: isCurrentPage ? (jsx("span", { className: cn("flex items-center", theme.current), "aria-current": "page", children: itemContent })) : (jsx("a", { href: item.href, className: cn("flex items-center", theme.link), "aria-label": `Navigate to ${item.label}`, children: itemContent })) }, `${item.label}-${index}`));
+        const itemContent = (jsxs(Fragment, { children: [showIcons && item.iconStart && (jsx("span", { className: "mr-1.5 flex-shrink-0", children: item.iconStart })), typeof item.label === 'string'
+                    ? jsx("span", { children: item.label })
+                    : item.label] }));
+        return (jsx("span", { className: "flex items-center text-base", children: isCurrentPage ? (jsx("span", { className: cn("flex items-center", theme.current), "aria-current": "page", children: itemContent })) : (jsx("a", { href: item.href, className: cn("flex items-center", theme.link), "aria-label": typeof item.label === 'string' ? `Navigate to ${item.label}` : undefined, children: itemContent })) }, `breadcrumb-${index}`));
     };
     // Render separator
     const renderSeparator = (index) => {
@@ -60,7 +62,9 @@ const Breadcrumbs = ({ items, separator, maxItems = 4, variant = "default", clas
                 window.location.href = selectedItem.href;
             }
         };
-        return (jsxs(Dropdown, { isOpen: isEllipsisOpen, onOpenChange: setIsEllipsisOpen, onAction: handleEllipsisAction, placement: "bottom-start", offset: 8, children: [jsx(Dropdown.Trigger, { children: jsx("button", { type: "button", className: cn(theme.ellipsis), "aria-label": `Navigate to one of ${hiddenItems.length} hidden breadcrumbs`, children: "..." }) }), jsx(Dropdown.Menu, { "aria-label": "Hidden breadcrumb items", children: hiddenItems.map((item, index) => (jsx(Dropdown.Item, { itemKey: `hidden-${index}`, startContent: showIcons && item.iconStart, children: item.label }, `hidden-${index}`))) })] }, "ellipsis"));
+        return (jsxs(Dropdown, { isOpen: isEllipsisOpen, onOpenChange: setIsEllipsisOpen, onAction: handleEllipsisAction, placement: "bottom-start", offset: 8, children: [jsx(Dropdown.Trigger, { children: jsx("button", { type: "button", className: cn(theme.ellipsis), "aria-label": `Navigate to one of ${hiddenItems.length} hidden breadcrumbs`, children: "..." }) }), jsx(Dropdown.Menu, { "aria-label": "Hidden breadcrumb items", children: hiddenItems.map((item, index) => (jsx(Dropdown.Item, { itemKey: `hidden-${index}`, startContent: showIcons && item.iconStart, children: typeof item.label === 'string'
+                            ? jsx("span", { children: item.label })
+                            : item.label }, `hidden-${index}`))) })] }, "ellipsis"));
     };
     // Build the breadcrumb elements
     const breadcrumbElements = [];

package/dist/components/core/Breadcrumbs/Breadcrumbs.types.d.ts

@@ -4,7 +4,7 @@ import React from "react";
  */
 export interface BreadcrumbItem {
     /** The display text for the breadcrumb item */
-    label: string;
+    label: React.ReactNode;
     /** Optional href for navigation. If not provided, item is treated as current page */
     href?: string;
     /** Optional icon to display at the start (before the label) */

package/dist/components/core/Button/Button.js

@@ -1,5 +1,5 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
-import React__default, { useCallback } from 'react';
+import React__default, { useCallback, useRef } from 'react';
 import { useReducedMotion, motion } from 'motion/react';
 import { buttonTheme } from './Button.theme.js';
 import { cn } from '../../../utils/cn.js';
@@ -18,7 +18,7 @@ const BUTTON_TAP_ANIMATION = {
         },
     },
 };
-const Button = React__default.forwardRef(({ children, className = "", iconOnly = false, state = "default", size = "md", color, variant, block = false, onClick, enableRipple = true, rippleEffect = "default", rippleClassName, rippleScale = 10, showReflection = true, darkMode = false, ...props }, ref) => {
+const Button = React__default.forwardRef(({ children, className = "", iconOnly = false, state = "default", size = "md", color, variant, block = false, onClick, enableRipple = true, rippleEffect = "default", rippleClassName, rippleScale = 10, showReflection = true, darkMode = false, disabled: disabledProp, "aria-label": ariaLabelProp, ...restProps }, ref) => {
     var _a, _b, _c, _d, _e, _f, _g;
     const shouldReduceMotion = useReducedMotion();
     const shouldDisableAnimations = !!shouldReduceMotion;
@@ -33,18 +33,18 @@ const Button = React__default.forwardRef(({ children, className = "", iconOnly =
     const resolvedVariant = variant || "filled";
     // Derived state flags (direct computation - faster than useMemo)
     const isLoading = state === "loading";
-    const isDisabled = state === "disabled" || state === "loading";
+    const isDisabled = state === "disabled" || state === "loading" || !!disabledProp;
     const isError = state === "error";
     // Dev-time a11y warning for iconOnly buttons without aria-label
     if (process.env.NODE_ENV !== "production") {
-        if (iconOnly && !props["aria-label"]) {
+        if (iconOnly && !ariaLabelProp) {
             // eslint-disable-next-line no-console
             console.warn("Button(iconOnly) requires 'aria-label' for accessibility.");
         }
     }
     // Safe onClick handler - respect both state="disabled" and disabled={true}
     const handleClick = useCallback((event) => {
-        if (isDisabled || props.disabled)
+        if (isDisabled)
             return;
         // Create ripple effect if enabled
         if (enableRipple && !shouldReduceMotion) {
@@ -59,19 +59,12 @@ const Button = React__default.forwardRef(({ children, className = "", iconOnly =
                 console.error("Error in button click handler:", error);
             }
         }
-    }, [
-        onClick,
-        isDisabled,
-        props.disabled,
-        enableRipple,
-        shouldReduceMotion,
-        createRipple,
-    ]);
+    }, [onClick, isDisabled, enableRipple, shouldReduceMotion, createRipple]);
     // Compute theme classes (direct computation - faster than useMemo)
     const sizeClasses = ((_b = (_a = buttonTheme.sizes) === null || _a === void 0 ? void 0 : _a[size]) === null || _b === void 0 ? void 0 : _b[iconOnly ? "iconOnly" : resolvedVariant === "link" ? "link" : "default"]) || "";
     const colorClasses = ((_c = buttonTheme.variantColors[resolvedVariant]) === null || _c === void 0 ? void 0 : _c[resolvedColor]) || "";
     const variantClasses = ((_d = buttonTheme.variantStyles) === null || _d === void 0 ? void 0 : _d[resolvedVariant]) || "";
-    const stateClasses = state === "disabled" || props.disabled
+    const stateClasses = isDisabled
         ? ((_e = buttonTheme.states) === null || _e === void 0 ? void 0 : _e.disabled) || ""
         : isError
             ? ((_f = buttonTheme.states) === null || _f === void 0 ? void 0 : _f.error) || ""
@@ -80,7 +73,7 @@ const Button = React__default.forwardRef(({ children, className = "", iconOnly =
                 : "";
     const blockStyle = block ? buttonTheme.blockStyle : "";
     // Generate default aria-label for icon-only buttons if not provided (fallback only)
-    const ariaLabel = iconOnly && !props["aria-label"] ? "Button" : props["aria-label"];
+    const ariaLabel = iconOnly && !ariaLabelProp ? "Button" : ariaLabelProp;
     // Determine animation props (user props will override due to spread order)
     const animationProps = shouldDisableAnimations
         ? {}
@@ -92,26 +85,30 @@ const Button = React__default.forwardRef(({ children, className = "", iconOnly =
     const spinnerClassName = resolvedVariant === "filled" && color !== "neutral"
         ? "border-t-white border-l-white"
         : "";
-    // Merge refs - use ripple's buttonRef if ripple is enabled, otherwise use forwarded ref
-    const mergedRef = React__default.useCallback((node) => {
+    // Track the latest forwarded ref to avoid mergedRef recreation on inline callback refs
+    const forwardedRef = useRef(ref);
+    forwardedRef.current = ref;
+    // Merge refs - stable callback that won't cause DOM detach/attach cycles
+    const mergedRef = useCallback((node) => {
         // Set ripple's buttonRef
         if (buttonRef) {
             buttonRef.current = node;
         }
         // Set forwarded ref
-        if (typeof ref === "function") {
-            ref(node);
+        const fRef = forwardedRef.current;
+        if (typeof fRef === "function") {
+            fRef(node);
         }
-        else if (ref) {
-            ref.current =
+        else if (fRef) {
+            fRef.current =
                 node;
         }
-    }, [ref, buttonRef]);
-    return (jsxs(motion.button, { ref: mergedRef, type: "button", className: cn(buttonTheme.baseStyle, colorClasses, variantClasses, sizeClasses, blockStyle, stateClasses, darkMode && "dark", className), disabled: isDisabled, "data-state": state, "data-color": resolvedColor, "data-variant": resolvedVariant, "data-size": size, "data-icon-only": iconOnly ? "true" : "false", "data-block": block ? "true" : "false", "aria-disabled": isDisabled || undefined, "aria-invalid": isError || undefined, "aria-label": ariaLabel, "aria-describedby": undefined, onClick: handleClick, ...animationProps, ...props, children: [showReflection &&
+    }, [buttonRef]);
+    return (jsxs(motion.button, { ...restProps /* React drag events conflict with motion drag events */, ...animationProps, ref: mergedRef, type: "button", className: cn(buttonTheme.baseStyle, colorClasses, variantClasses, sizeClasses, blockStyle, stateClasses, darkMode && "dark", className), disabled: isDisabled, "data-state": state, "data-color": resolvedColor, "data-variant": resolvedVariant, "data-size": size, "data-icon-only": iconOnly ? "true" : "false", "data-block": block ? "true" : "false", "aria-disabled": isDisabled || undefined, "aria-invalid": isError || undefined, "aria-label": ariaLabel, onClick: handleClick, children: [showReflection &&
                 resolvedVariant !== "link" &&
-                resolvedVariant !== "outline" && (jsx("div", { className: "absolute top-0.25 right-0.25 left-0.25 h-3 bg-gradient-to-b  border-t-[0.5px] border-white/40 rounded-t-[calc(var(--button-radius)-1.25px)] opacity-60" })), isLoading && (jsx("div", { className: "absolute inset-0 flex items-center justify-center", children: jsx(Spinner, { size: "sm", color: color, className: spinnerClassName }) })), jsx("span", { className: cn("inline-flex items-center gap-2 whitespace-nowrap", isLoading && "opacity-0"), children: children }), enableRipple &&
+                resolvedVariant !== "outline" && (jsx("div", { className: "absolute top-0.25 right-0.25 left-0.25 h-3 border-t-[0.5px] border-white/40 rounded-t-[calc(var(--button-radius)-1.25px)] opacity-60" })), isLoading && (jsx("div", { className: "absolute inset-0 flex items-center justify-center", children: jsx(Spinner, { size: "sm", color: color, className: spinnerClassName }) })), jsx("span", { className: cn("inline-flex items-center gap-2 whitespace-nowrap", isLoading && "opacity-0"), children: children }), enableRipple &&
                 ripples.map((ripple) => {
-                    const animation = getRippleAnimation(effect, ripple.layer || 1, rippleScale);
+                    const animation = getRippleAnimation(effect, ripple, rippleScale);
                     return (jsx(motion.span, { initial: animation.initial, animate: animation.animate, transition: animation.transition, className: cn("absolute rounded-full size-5 pointer-events-none ", animation.className, rippleClassName ||
                             getRippleColorClass(resolvedVariant, resolvedColor)), style: {
                             top: ripple.y - 10,

package/dist/components/core/Button/Button.ripple.d.ts

@@ -12,6 +12,10 @@ export interface Ripple {
     x: number;
     y: number;
     layer?: number;
+    /** Pre-computed random scale factor for particle effect (0-1 range) */
+    randomScale?: number;
+    /** Pre-computed random duration offset for particle effect (0-1 range) */
+    randomDuration?: number;
 }
 export interface RippleConfig {
     /** Scale multiplier for ripple expansion (default: 10) */
@@ -53,7 +57,7 @@ export declare function getRippleColorClass(variant?: string, color?: string): s
 /**
  * Get animation properties for specific ripple effect and layer
  */
-export declare function getRippleAnimation(effect: RippleEffectType, layer: number, baseScale: number): {
+export declare function getRippleAnimation(effect: RippleEffectType, ripple: Ripple, baseScale: number): {
     initial: {
         scale: number;
         opacity: number;