@react-fabric/core 1.0.0-beta.6 → 1.0.0-beta.60

package/dist/esm/components/button/ConfirmButton.js

@@ -16,7 +16,28 @@ var _excluded = ["ref", "message", "color", "okLabel", "cancelLabel", "onClick",
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /**
- * Button with confirmation dropdown
+ * A button that shows a confirmation dialog when clicked, allowing the user to confirm or cancel an action.
+ * It supports custom messages, labels, and loading states.
+ * This component is useful for actions that require user confirmation, such as deleting items or submitting forms.
+ * It uses the Floating UI library to manage the positioning of the confirmation dialog, ensuring it appears correctly relative to the button.
+ * It also supports custom placement of the dialog, and can display an action message when the action is completed.
+ *
+ * @param {ConfirmButtonProps} props - The properties for the ConfirmButton component.
+ * @returns {JSX.Element} The rendered ConfirmButton component.
+ *
+ * @example
+ * ```jsx
+ * <ConfirmButton
+ *   message="Are you sure you want to delete this item?"
+ *   onClick={(confirmed) => {
+ *     if (confirmed) {
+ *       // Perform action
+ *     }
+ *   }}
+ * />
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-confirmbutton--docs} for more details.
  */
 var ConfirmButton = function ConfirmButton(_ref) {
   var ref = _ref.ref,
@@ -125,18 +146,22 @@ var ConfirmButton = function ConfirmButton(_ref) {
           "data-color": color,
           className: classNames("select-none not-italic rounded-capped shadow-lg outline outline-muted bg-base"),
           ref: refs.setFloating,
-          style: floatingStyles
+          style: _objectSpread({
+            zIndex: "var(--z-popover)"
+          }, floatingStyles)
         }, getFloatingProps()), {}, {
           children: [/*#__PURE__*/jsxs("div", {
             className: "font-medium ",
             children: [/*#__PURE__*/jsx("p", {
               className: "py-2 px-4",
+              "data-ref": "confirmMessage",
               children: message
             }), /*#__PURE__*/jsxs("div", {
               className: "flex justify-end py-2 px-4 gap-2",
               children: [/*#__PURE__*/jsx(Button, {
                 size: "sm",
                 variant: "link",
+                "data-ref": "confirmCancel",
                 color: color,
                 onClick: function onClick() {
                   return [clickHandler(false), setIsOpen(false)];
@@ -147,6 +172,7 @@ var ConfirmButton = function ConfirmButton(_ref) {
                 variant: "solid",
                 color: color,
                 autoFocus: true,
+                "data-ref": "confirmOk",
                 onClick: function onClick() {
                   return [clickHandler(true), setIsOpen(false)];
                 },

package/dist/esm/components/button/ToggleButtonGroup.js

@@ -5,14 +5,42 @@ import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import { isArray, EMPTY_ARRAY } from '@react-fabric/utilities';
 import classNames from 'classnames';
-import { useMemo, useCallback, Children, cloneElement } from 'react';
+import { useCallback, cloneElement } from 'react';
 import { useControlledValue } from '../../hooks/useControlledValue.js';
-import classes from './Button.module.css';
+import { cloneChildren } from '../../utils/cloneElement.js';
 import { jsx } from 'react/jsx-runtime';
 
 var _excluded = ["vertical", "className", "children", "variant", "rounded", "disabled", "fullWidth", "color", "size", "value", "onChange"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/**
+ * A component that groups toggle buttons together, allowing for consistent styling and behavior across multiple toggle buttons.
+ * It supports vertical orientation, various button styles, and can handle properties like size, color, and disabled state.
+ * This component is useful for creating toggle button groups that maintain a uniform appearance and functionality,
+ * such as toggle switches, selection groups, or multi-select options.
+ *
+ * @param {ToggleButtonGroupProps} props - The properties for the ToggleButtonGroup component.
+ * @returns {JSX.Element} The rendered ToggleButtonGroup component.
+ *
+ * @example
+ * ```jsx
+ * <ToggleButtonGroup
+ *   value={selectedValues}
+ *   onChange={(newValues) => setSelectedValues(newValues)}
+ *   variant="outline"
+ *   color="primary"
+ *   size="md"
+ *   rounded
+ *   fullWidth
+ * >
+ *   <Button value="option1">Option 1</Button>
+ *   <Button value="option2">Option 2</Button>
+ *   <Button value="option3">Option 3</Button>
+ * </ToggleButtonGroup>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-togglebuttongroup--docs} for more details.
+ */
 var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
   var vertical = _ref.vertical,
     className = _ref.className,
@@ -26,19 +54,18 @@ var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
     value = _ref.value,
     onChange = _ref.onChange,
     aria = _objectWithoutProperties(_ref, _excluded);
-  var isMultiple = useMemo(function () {
-    return isArray(value);
-  }, [value]);
-  var _useControlledValue = useControlledValue(value, isArray(value) ? EMPTY_ARRAY : ""),
+  var _useControlledValue = useControlledValue(value, isArray(value) ? EMPTY_ARRAY : null),
     currentValue = _useControlledValue.currentValue,
     updateValue = _useControlledValue.updateValue;
-  var clickHandler = useCallback(function (cb) {
+  var clickHandler = useCallback(function (cb, childValue) {
     return function (e) {
-      var newValue = "".concat(e.currentTarget.dataset.value);
+      var newValue;
       if (isArray(currentValue)) {
-        if (currentValue.includes(newValue)) newValue = currentValue.filter(function (v) {
-          return v !== newValue;
-        });else newValue = [].concat(_toConsumableArray(currentValue), [newValue]);
+        if (currentValue.includes(childValue)) newValue = currentValue.filter(function (v) {
+          return v !== childValue;
+        });else newValue = [].concat(_toConsumableArray(currentValue), [childValue]);
+      } else {
+        newValue = childValue;
       }
       updateValue(newValue);
       onChange === null || onChange === void 0 || onChange(newValue);
@@ -46,9 +73,9 @@ var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
     };
   }, [currentValue, onChange]);
   return /*#__PURE__*/jsx("div", _objectSpread(_objectSpread({
-    className: classNames(classes.buttonGroup, className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle", vertical && classes.vertical, vertical && "flex-col")
+    className: classNames("fabric-buttonGroup", className, fullWidth ? "flex" : "inline-flex", "flex-nowrap align-middle", vertical && "vertical", vertical && "flex-col")
   }, aria), {}, {
-    children: Children.map(children, function (child) {
+    children: cloneChildren(children, function (child) {
       return /*#__PURE__*/cloneElement(child, _objectSpread(_objectSpread({
         color: color,
         size: size,
@@ -57,9 +84,8 @@ var ToggleButtonGroup = function ToggleButtonGroup(_ref) {
         rounded: rounded,
         fullWidth: fullWidth
       }, child.props), {}, {
-        onClick: clickHandler(child.props.onClick),
-        "data-value": child.props.value,
-        "data-checked": isMultiple ? currentValue.includes(child.props.value) : currentValue === child.props.value
+        onClick: clickHandler(child.props.onClick, child.props.value),
+        "data-checked": isArray(currentValue) ? currentValue === null || currentValue === void 0 ? void 0 : currentValue.includes(child.props.value) : currentValue === child.props.value
       }));
     })
   }));

package/dist/esm/components/callout/Callout.js

@@ -4,14 +4,50 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
 import { CoreIcons } from '../../types/icons.js';
-import { getBgClass, getColorClass, getBorderClass } from '../../utils/getColor.js';
-import '@react-fabric/utilities';
 import { Icon } from '../icon/Icon.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 var _excluded = ["children", "color", "legend", "title", "icon", "border", "onClose", "className"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+// colors for different callout types
+var colors = {
+  none: "bg-base text-tint-900 border-tint-100",
+  tint: "bg-tint-50/50 text-tint-800 border-tint-300",
+  primary: "bg-primary-50/50 text-primary-800 border-primary-300",
+  accent: "bg-accent-50/50 text-accent-800 border-accent-300",
+  info: "bg-info-50/50 text-info-800 border-info-300",
+  danger: "bg-danger-50/50 text-danger-800 border-danger-300",
+  success: "bg-success-50/50 text-success-800 border-success-300",
+  warning: "bg-warning-50/50 text-warning-800 border-warning-300"
+};
+
+/**
+ * A component that displays a callout box with an optional title, icon, and legend.
+ * It can be used to highlight important information, warnings, or notices.
+ * The callout can be styled with different colors and border styles, and it supports a close action.
+ * This component is useful for drawing attention to specific content within a page or application,
+ * such as alerts, notifications, or important messages.
+ *
+ * @param {CalloutProps} props - The properties for the Callout component.
+ * @returns {JSX.Element} The rendered Callout component.
+ *
+ * @example
+ * ```jsx
+ * <Callout
+ *   color="primary"
+ *   legend="Important Notice"
+ *   title="Attention Required"
+ *   icon="info"
+ *   onClose={() => console.log("Callout closed")}
+ * >
+ *   This is an important message that requires your attention.
+ * </Callout>
+ * // Renders a callout box with a primary color, an icon, a title, and a close button.
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-components-callout--docs} for more details.
+ */
 var Callout = function Callout(_ref) {
   var children = _ref.children,
     _ref$color = _ref.color,
@@ -24,19 +60,22 @@ var Callout = function Callout(_ref) {
     className = _ref.className,
     aria = _objectWithoutProperties(_ref, _excluded);
   return /*#__PURE__*/jsxs("fieldset", _objectSpread(_objectSpread({
-    className: classNames(className, "block rounded-capped border max-w-full relative overflow-hidden mb-4", getBgClass(color + "-50"), getColorClass(color + "-700"), getBorderClass(color + "-300"), border === "dashed" && "border-dashed", border === "dotted" && "border-dotted")
+    className: classNames("block rounded-capped border max-w-full relative overflow-hidden mb-4", colors[color], className, border === "dashed" && "border-dashed", border === "dotted" && "border-dotted")
   }, aria), {}, {
     children: [legend && /*#__PURE__*/jsx("legend", {
       className: "px-2 mx-4 font-medium",
+      "data-ref": "calloutLegend",
       children: legend
     }), /*#__PURE__*/jsxs("div", {
       className: classNames("break-words whitespace-break-spaces p-2"),
       children: [/*#__PURE__*/jsxs("div", {
         className: "flex flex-nowrap items-center text-xl pe-4 gap-2 mb-4 empty:mb-0",
         children: [icon && /*#__PURE__*/jsx(Icon, {
-          icon: icon
+          icon: icon,
+          "data-ref": "calloutIcon"
         }), title && /*#__PURE__*/jsx("p", {
           className: "flex-1",
+          "data-ref": "calloutTitle",
           children: title
         })]
       }), /*#__PURE__*/jsx("div", {
@@ -45,6 +84,7 @@ var Callout = function Callout(_ref) {
       })]
     }), onClose && /*#__PURE__*/jsx(Icon, {
       size: "md",
+      "data-ref": "calloutClose",
       className: classNames("absolute end-2", legend ? "top-0" : "top-2"),
       icon: CoreIcons.close,
       onClick: onClose

package/dist/esm/components/card/Card.js

@@ -4,17 +4,50 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
-import { useMemo, Children } from 'react';
+import { useMemo, Children, useCallback } from 'react';
 import { ErrorBoundary } from '../../core/boundary/ErrorBoundary.js';
 import { Header, Footer } from '../../core/headfoot/HeadFoot.js';
+import { jsx, jsxs } from 'react/jsx-runtime';
 import '@react-fabric/utilities';
 import { nodeCheck } from '../../utils/nodeCheck.js';
-import classes from './Card.module.css';
-import { jsx, jsxs } from 'react/jsx-runtime';
 
-var _excluded = ["children", "className", "bodyClassName", "selected", "selectedRibbon", "onClick", "flex", "draggable", "dragKey", "dragData", "ref"];
+var _excluded = ["children", "className", "bodyClassName", "selected", "selectedRibbon", "onClick", "onDragStart", "flex", "draggable", "dragKey", "dragData", "ref", "as"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/**
+ * A component that displays a card with a header, body, and footer. It can be used to display content in a structured format.
+ * It supports various features such as click handling, drag-and-drop functionality, and customizable styles.
+ * The Card component is designed to be flexible and can be used in various contexts, such as displaying user profiles, product information, or any other content that benefits from a card layout.
+ * The component accepts children that can include a Header, body content, and a Footer.
+ * It also supports additional properties for styling, accessibility, and interaction.
+ * It can be styled with custom CSS classes and supports features like selection indication and drag-and-drop functionality.
+ *
+ * @param {CardProps} props - The properties for the Card component.
+ * @returns {JSX.Element} The rendered Card component.
+ *
+ * @example
+ * ```jsx
+ * <Card
+ *   className="my-custom-class"
+ *   bodyClassName="my-body-class"
+ *   selected={true}
+ *   selectedRibbon={true}
+ *   onClick={() => console.log("Card clicked")}
+ *   onDragStart={(event, key, data) => console.log("Drag started", key, data)}
+ *   flex={true}
+ *   draggable={true}
+ *   dragKey="my-drag-key"
+ *   dragData={{ id: 1, name: "Card Data" }}
+ *   aria-label="My Card"
+ * >
+ *   <Header>Card Header</Header>
+ *   <div>Card Body Content</div>
+ *   <Footer>Card Footer</Footer>
+ * </Card>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-card--docs} for more details.
+ */
 var Card = function Card(_ref) {
   var children = _ref.children,
     className = _ref.className,
@@ -22,11 +55,13 @@ var Card = function Card(_ref) {
     selected = _ref.selected,
     selectedRibbon = _ref.selectedRibbon,
     onClick = _ref.onClick,
+    onDragStart = _ref.onDragStart,
     flex = _ref.flex,
     draggable = _ref.draggable,
     dragKey = _ref.dragKey,
     dragData = _ref.dragData,
     ref = _ref.ref,
+    as = _ref.as,
     aria = _objectWithoutProperties(_ref, _excluded);
   var _useMemo = useMemo(function () {
       return Children.toArray(children).reduce(function (ret, node) {
@@ -38,25 +73,32 @@ var Card = function Card(_ref) {
     header = _useMemo2[0],
     body = _useMemo2[1],
     footer = _useMemo2[2];
+  var handleDragStart = useCallback(function (event) {
+    var _event$dataTransfer;
+    dragKey && ((_event$dataTransfer = event.dataTransfer) === null || _event$dataTransfer === void 0 ? void 0 : _event$dataTransfer.setData(dragKey, JSON.stringify(dragData)));
+    dragKey && (onDragStart === null || onDragStart === void 0 ? void 0 : onDragStart(event, dragKey, dragData));
+  }, [onDragStart, dragKey, dragData]);
+  var E = as !== null && as !== void 0 ? as : "div";
   return /*#__PURE__*/jsx("div", {
-    className: classNames(classes.cardWrapper, "rounded-capped relative grid", flex && "flex-1", selected && selectedRibbon && classes.selected, selected && "outline outline-2 outline-accent-500 outline-offset-2"),
+    className: classNames("fabric-cardWrapper", "rounded-capped relative grid", flex && "flex-1", selected && selectedRibbon && "selected", selected && "outline-1 outline-accent-500 outline-offset-2"),
     children: /*#__PURE__*/jsx(ErrorBoundary, {
-      children: /*#__PURE__*/jsxs("div", _objectSpread(_objectSpread({
-        className: classNames(classes.card, className, "rounded-capped flex flex-col flex-nowrap overflow-hidden", onClick && classes.clickable),
+      children: /*#__PURE__*/jsxs("div", {
+        className: classNames("fabric-card", className, "rounded-capped relative flex flex-col flex-nowrap overflow-hidden", "href" in aria && "clickable", "to" in aria && "clickable", onClick && "clickable"),
         draggable: draggable,
-        onDragStart: !draggable ? undefined : function (e) {
-          var _e$dataTransfer;
-          return dragKey && ((_e$dataTransfer = e.dataTransfer) === null || _e$dataTransfer === void 0 ? void 0 : _e$dataTransfer.setData(dragKey, JSON.stringify(dragData)));
-        },
-        ref: ref
-      }, aria), {}, {
-        children: [header, /*#__PURE__*/jsx("div", {
+        onDragStart: !draggable ? undefined : handleDragStart,
+        ref: ref,
+        children: [header, /*#__PURE__*/jsx(E, _objectSpread(_objectSpread({
           role: "none",
-          className: classNames(classes.cardBody, bodyClassName, "flex-1"),
-          onClick: onClick,
-          children: body
-        }), footer]
-      }))
+          onClick: onClick
+        }, aria), {}, {
+          className: "contents",
+          children: body && /*#__PURE__*/jsx("object", {
+            type: "none",
+            className: classNames("fabric-cardBody", bodyClassName, "flex-1"),
+            children: body
+          })
+        })), footer]
+      })
     })
   });
 };

package/dist/esm/components/card/CardCover.js

@@ -5,15 +5,45 @@ import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
 import { useMemo, Children } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
 import '@react-fabric/utilities';
 import { nodeCheck } from '../../utils/nodeCheck.js';
 import { Image, Video } from '../media/Media.js';
-import classes from './Card.module.css';
-import { jsxs, jsx } from 'react/jsx-runtime';
 
 var _excluded = ["className", "children", "height", "justify", "colorScheme"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var scheme = {
+  inheritScheme: "inheritScheme",
+  light: "light",
+  dark: "dark"
+};
+
+/**
+ * A cover component for cards that can contain media and content.
+ * It allows for flexible layout options and supports different color schemes.
+ * It can be used to create visually appealing card layouts with media content.
+ *
+ * @param {CardCoverProps} props - The properties for the CardCover component.
+ * @returns {JSX.Element} The rendered CardCover component.
+ *
+ * @example
+ * ```jsx
+ * <CardCover
+ *   height={200}
+ *   colorScheme="light"
+ *   justify="center"
+ *   className="my-custom-class"
+ *   aria-label="Card Cover"
+ * >
+ *   <Image src="image.jpg" alt="Card Image" />
+ *   <div>Card Content</div>
+ * </CardCover>
+ * // Renders a card cover with a height of 200px, light color scheme, centered content, and a custom class name.
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-components-card--docs} for more details.
+ */
 var CardCover = function CardCover(_ref) {
   var className = _ref.className,
     children = _ref.children,
@@ -21,7 +51,8 @@ var CardCover = function CardCover(_ref) {
     height = _ref$height === void 0 ? 120 : _ref$height,
     _ref$justify = _ref.justify,
     justify = _ref$justify === void 0 ? "end" : _ref$justify,
-    colorScheme = _ref.colorScheme,
+    _ref$colorScheme = _ref.colorScheme,
+    colorScheme = _ref$colorScheme === void 0 ? "inheritScheme" : _ref$colorScheme,
     aria = _objectWithoutProperties(_ref, _excluded);
   var _useMemo = useMemo(function () {
       return Children.toArray(children).reduce(function (ret, node) {
@@ -36,10 +67,10 @@ var CardCover = function CardCover(_ref) {
     style: {
       height: height
     },
-    className: classNames(classes.cardCover, classes[colorScheme !== null && colorScheme !== void 0 ? colorScheme : "inheritScheme"], "relative z-0")
+    className: classNames("fabric-cardCover", scheme[colorScheme], "relative z-0")
   }, aria), {}, {
     children: [media, /*#__PURE__*/jsx("div", {
-      className: classNames(classes.cardCoverContent, "relative pointer-events-none z-1 flex flex-col flex-nowrap p-4 h-full", className, "justify-".concat(justify), className),
+      className: classNames("fabric-cardCoverContent", "relative pointer-events-none z-1 flex flex-col flex-nowrap p-4 h-full", "justify-".concat(justify), className),
       children: body
     })]
   }));

package/dist/esm/components/card/FlipContent.js

@@ -0,0 +1,56 @@
+'use client';
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import classNames from 'classnames';
+import { useState, useImperativeHandle, Children, isValidElement, cloneElement } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+/**
+ * A component that allows flipping between front and back content.
+ * It uses a ref to control the flipping action, which toggles the visibility of the front and back content.
+ * The component accepts children elements, which should be valid React elements representing the front and back content.
+ * The front content is expected to be the first child, and the back content is expected to be the second child.
+ * The component applies specific classes to the children based on their position (front or back) and manages the flipping state internally.
+ * The `flipCard` method can be called to toggle the visibility of the back content.
+ *
+ * @param {Props} props - The properties for the FlipContent component.
+ * @returns {JSX.Element} The rendered FlipContent component.
+ *
+ * @example
+ * ```jsx
+ * <FlipContent ref={flipRef}>
+ *   <div className="front">Front Content</div>
+ *   <div className="back">Back Content</div>
+ * </FlipContent>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-flipcontent--docs}
+ */
+var FlipContent = function FlipContent(_ref) {
+  var ref = _ref.ref,
+    children = _ref.children;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    showBack = _useState2[0],
+    setShowBack = _useState2[1];
+  useImperativeHandle(ref, function () {
+    return {
+      flipCard: function flipCard() {
+        return setShowBack(!showBack);
+      }
+    };
+  }, [showBack]);
+  return /*#__PURE__*/jsx("div", {
+    className: "relative flex-1",
+    "data-card-flip": showBack,
+    children: Children.map(children, function (child, idx) {
+      var _child$props$classNam, _child$props;
+      return /*#__PURE__*/isValidElement(child) && /*#__PURE__*/cloneElement(child, {
+        className: classNames((_child$props$classNam = (_child$props = child.props) === null || _child$props === void 0 ? void 0 : _child$props.className) !== null && _child$props$classNam !== void 0 ? _child$props$classNam : "", idx === 0 ? "bg-base relative" : "bg-base absolute inset-0"),
+        "data-card-flip-face": idx === 0 ? "front" : "back"
+      });
+    })
+  });
+};
+
+export { FlipContent };

package/dist/esm/components/chip/Chip.js

@@ -5,13 +5,12 @@ import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProper
 import classNames from 'classnames';
 import { useCallback } from 'react';
 import { useMemoDebugger } from '../../hooks/useEffectDebugger.js';
-import { getColor, getColorClass } from '../../utils/getColor.js';
-import '@react-fabric/utilities';
-import { Icon } from '../icon/Icon.js';
-import classes from './Chip.module.css';
 import { jsxs, jsx } from 'react/jsx-runtime';
+import { getColor } from '../../utils/getColor.js';
+import '@react-fabric/utilities';
+import { Icon, getIconProps } from '../icon/Icon.js';
 
-var _excluded = ["ref", "children", "className", "size", "color", "variant", "icon", "iconBg", "iconColor", "rtlFlip", "disabled", "onClick", "onIconClick", "onRemove", "rounded", "stopPropagation", "as"];
+var _excluded = ["ref", "children", "className", "size", "color", "variant", "icon", "disabled", "onClick", "onIconClick", "onRemove", "rounded", "preventDefault", "stopPropagation", "as"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var SizeMap = {
@@ -21,6 +20,27 @@ var SizeMap = {
   lg: "1.5rem",
   xl: "2rem"
 };
+
+/**
+ * A component that represents a small block of information, often used for tags, categories, or actions.
+ * It allows customization of size, color, variant, and includes optional icon and remove functionality.
+ * It supports various properties for styling and interaction, including click handlers and disabled state.
+ * It can be used in various contexts, such as filtering options, displaying tags, or representing user actions.
+ * It can be styled with custom CSS classes and supports features like rounded edges and click handling.
+ * It can also include an icon and a remove button, making it versatile for different use cases.
+ *
+ * @param {ChipProps} props - The properties for the Chip component.
+ * @returns {JSX.Element} The rendered Chip component.
+ *
+ * @example
+ * ```jsx
+ * <Chip color="primary" size="md" className="my-chip">
+ *   Example Chip
+ * </Chip>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-chip--docs} for more details.
+ */
 var Chip = function Chip(_ref) {
   var ref = _ref.ref,
     children = _ref.children,
@@ -29,14 +49,12 @@ var Chip = function Chip(_ref) {
     color = _ref.color,
     variant = _ref.variant,
     icon = _ref.icon,
-    iconBg = _ref.iconBg,
-    iconColor = _ref.iconColor,
-    rtlFlip = _ref.rtlFlip,
     disabled = _ref.disabled,
     onClick = _ref.onClick,
     onIconClick = _ref.onIconClick,
     onRemove = _ref.onRemove,
     rounded = _ref.rounded,
+    preventDefault = _ref.preventDefault,
     stopPropagation = _ref.stopPropagation,
     as = _ref.as,
     aria = _objectWithoutProperties(_ref, _excluded);
@@ -55,9 +73,10 @@ var Chip = function Chip(_ref) {
     return s;
   }, [color, size], "Chip styles");
   var clickHandler = useCallback(function (e) {
-    if (stopPropagation) e.stopPropagation();
+    preventDefault && e.preventDefault();
+    stopPropagation && e.stopPropagation();
     onClick === null || onClick === void 0 || onClick(e);
-  }, [onClick, stopPropagation]);
+  }, [onClick, preventDefault, stopPropagation]);
   var removeHandler = useCallback(function (e) {
     if (stopPropagation) e.stopPropagation();
     onRemove === null || onRemove === void 0 || onRemove(e);
@@ -66,25 +85,26 @@ var Chip = function Chip(_ref) {
   return /*#__PURE__*/jsxs(E, _objectSpread(_objectSpread({
     ref: ref,
     role: "term",
-    className: classNames(classes.chip, className, color && getColorClass(color), "select-none inline-flex flex-nowrap items-center max-w-72 text-sm rounded", rounded && "rounded-full", !!onClick && classes.clickable, disabled && classes.disabled),
+    "data-ref": "chip",
+    className: classNames("fabric-chip", className, "select-none inline-flex flex-nowrap items-center align-middle max-w-72 rounded", rounded && "rounded-full", !!onClick && "clickable", disabled && "disabled"),
     style: styles,
     "data-variant": variant,
     "data-inner-clickable": !!onClick,
-    onClick: clickHandler
+    onClick: disabled ? undefined : clickHandler
   }, aria), {}, {
-    children: [icon && /*#__PURE__*/jsx(Icon, {
-      className: classNames(classes.chipIcon, "m-1"),
-      icon: icon,
-      bg: iconBg,
-      onClick: onIconClick,
-      color: iconColor,
-      rtlFlip: rtlFlip
-    }), children && /*#__PURE__*/jsx("label", {
-      className: classNames(classes.chipLabel, "truncate"),
+    children: [icon && /*#__PURE__*/jsx(Icon, _objectSpread({
+      "data-ref": "chipIcon",
+      className: classNames("fabric-chipIcon", "m-1 flex-content"),
+      onClick: onIconClick
+    }, getIconProps(icon))), children && /*#__PURE__*/jsx("label", {
+      "data-ref": "chipLabel",
+      className: classNames("fabric-chipLabel", "truncate flex-1"),
       children: children
     }), onRemove && /*#__PURE__*/jsx("span", {
       role: "none",
-      className: classNames(classes.chipRemove, "cursor-pointer pe-1 opacity-65 hover:opacity-90"),
+      "data-ref": "chipRemove",
+      "data-inner-cliackable": true,
+      className: classNames("fabric-chipRemove", "cursor-pointer pe-1 opacity-65 hover:opacity-90"),
       onClick: removeHandler,
       children: "\xD7"
     })]