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

package/dist/esm/components/tabpanel/Tab.js

@@ -13,14 +13,41 @@ import { jsx, jsxs } from 'react/jsx-runtime';
 import '../../hotkeys/HotKeyWrapper.js';
 import { Tooltip } from '../../overlays/tooltip/Tooltip.js';
 import { getBadgeProps, Badge } from '../badge/Badge.js';
-import { Icon } from '../icon/Icon.js';
-import '../../types/icons.js';
+import { Icon, getIconProps } from '../icon/Icon.js';
 import { DropdownTool } from '../dropdown/DropdownTool.js';
-import classes from './TabPanel.module.css';
 
-var _excluded = ["ref", "as", "id", "className", "label", "icon", "iconBg", "iconColor", "rtlFlip", "badge", "disabled", "onClose", "active", "minimal", "onClick", "tabFlex", "color", "actions", "tooltip", "activeClassName"];
+var _excluded = ["ref", "as", "id", "className", "label", "icon", "badge", "disabled", "onClose", "active", "onClick", "tabFlex", "color", "actions", "tooltip", "activeClassName"];
 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 represents a tab in a tabbed interface. It can display an icon, label, badge, and actions.
+ * It supports polymorphic rendering, allowing it to be rendered as different HTML elements.
+ * It also supports tooltips, active states, and click handling.
+ *
+ * @param {TabProps} props - The properties for the Tab component.
+ * @returns {JSX.Element} The rendered Tab component.
+ *
+ * @example
+ * ```jsx
+ * <Tab
+ *   id="tab1"
+ *   label="Tab 1"
+ *   icon="home"
+ *   badge="New"
+ *   onClick={(id) => console.log(`Tab clicked: ${id}`)}
+ *   onClose={() => console.log("Tab closed")}
+ *   active={true}
+ *   actions={<button>Action</button>}
+ *   color="primary"
+ *   tooltip="This is a tab"
+ *   activeClassName="bg-blue-100"
+ * />
+ * // Renders a tab with label "Tab 1", home icon, blue background, white text, badge "New",
+ * // and an action button. The tab is active and has a tooltip.
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-tabpanel--docs} for more details.
+ */
 var Tab = function Tab(_ref) {
   var ref = _ref.ref,
     as = _ref.as,
@@ -28,14 +55,10 @@ var Tab = function Tab(_ref) {
     className = _ref.className,
     label = _ref.label,
     icon = _ref.icon,
-    iconBg = _ref.iconBg,
-    iconColor = _ref.iconColor,
-    rtlFlip = _ref.rtlFlip,
     badge = _ref.badge,
     disabled = _ref.disabled,
     onClose = _ref.onClose,
     active = _ref.active,
-    minimal = _ref.minimal,
     _onClick = _ref.onClick,
     tabFlex = _ref.tabFlex,
     color = _ref.color,
@@ -46,6 +69,9 @@ var Tab = function Tab(_ref) {
   var badgeProps = useMemo(function () {
     return getBadgeProps(badge);
   }, [badge]);
+  var minimal = useMemo(function () {
+    return !label;
+  }, [label]);
   var tooltipProps = useMemo(function () {
     if (isString(tooltip)) return {
       content: tooltip
@@ -59,26 +85,23 @@ var Tab = function Tab(_ref) {
       "data-id": id,
       disabled: disabled,
       "data-color": color,
-      className: classNames(classes.tabButton, className, active && "active pointer-events-none", active && activeClassName, disabled && "text-tint-500 pointer-events-none", tabFlex ? "flex-1" : "flex-initial max-w-36 min-w-24", "flex items-center justify-center px-1 rounded overflow-hidden"),
+      "data-inner-clickable": true,
+      className: classNames("fabric-tabButton", className, active && "active pointer-events-none", active && activeClassName, disabled && "text-tint-500 pointer-events-none", tabFlex ? "flex-1" : "flex-initial max-w-36", minimal ? "min-w-6 rounded" : "rounded-capped", "flex items-center justify-center overflow-hidden cursor-pointer"),
       onClick: function onClick() {
         return !active && (_onClick === null || _onClick === void 0 ? void 0 : _onClick(id));
       },
       ref: ref
     }, aria), {}, {
-      children: [icon && /*#__PURE__*/jsx(Icon, {
-        icon: icon,
-        bg: iconBg,
-        color: iconColor,
-        rtlFlip: rtlFlip,
-        className: "flex-content"
-      }), !minimal && /*#__PURE__*/jsx("label", {
+      children: [icon && /*#__PURE__*/jsx(Icon, _objectSpread({
+        className: "flex-content p-2"
+      }, getIconProps(icon))), !minimal && /*#__PURE__*/jsx("label", {
         className: "flex-initial truncate text-center px-1 py-1",
         children: label
       }), badge && /*#__PURE__*/jsx(Badge, _objectSpread(_objectSpread({}, badgeProps), {}, {
         placement: minimal ? "end" : "",
         className: classNames("me-1", badgeProps.className)
       })), actions && active && /*#__PURE__*/jsx(DropdownTool, {
-        className: "bg-base/20 me-1 z-5",
+        className: "bg-tint-50/20 me-1 z-5",
         children: actions
       }), onClose && /*#__PURE__*/jsx("span", {
         role: "none",

package/dist/esm/components/tabpanel/TabPanel.js

@@ -3,23 +3,59 @@
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import classNames from 'classnames';
 import { useState, useMemo, Children, useEffect, useCallback, cloneElement } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
 import '@react-fabric/utilities';
 import { nodeCheck } from '../../utils/nodeCheck.js';
 import { Tab } from './Tab.js';
-import classes from './TabPanel.module.css';
-import { jsxs, jsx } from 'react/jsx-runtime';
 
 // TODO: implement append/prepend tab-bar items
 
+/**
+ * A component that provides a tabbed interface for displaying content.
+ * It allows users to switch between different tabs, each containing its own content.
+ * It supports various orientations, justify options, and variants for the tab header.
+ * It also provides hooks for handling tab changes before and after they occur.
+ * This component is useful for organizing content into separate sections that can be easily navigated by the user.
+ * It can be customized with different styles and behaviors to fit the needs of the application.
+ *
+ * @param {TabPanelProps} props - The properties for the TabPanel component.
+ * @returns {JSX.Element} The rendered TabPanel component.
+ *
+ * @example
+ * ```jsx
+ * <TabPanel
+ *   orientation="top"
+ *   activeTab="tab1"
+ *   justify="start"
+ *   variant="solid"
+ *   tabFlex={true}
+ *   onBeforeChange={(nextTab, currentTab) => {
+ *     console.log(`Switching from ${currentTab} to ${nextTab}`);
+ *     return true; // or false to prevent change
+ *   }}
+ *   onChange={(id) => console.log(`Active tab changed to: ${id}`)}
+ * >
+ *   <Tab id="tab1" label="Tab 1">Content for Tab 1</Tab>
+ *   <Tab id="tab2" label="Tab 2">Content for Tab 2</Tab>
+ *   <Tab id="tab3" label="Tab 3">Content for Tab 3</Tab>
+ * </TabPanel>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-tabpanel--docs} for more details.
+ */
 var TabPanel = function TabPanel(_ref) {
   var children = _ref.children,
     headerClassName = _ref.headerClassName,
     _ref$orientation = _ref.orientation,
     orientation = _ref$orientation === void 0 ? "top" : _ref$orientation,
     activeTab = _ref.activeTab,
+    activeClassName = _ref.activeClassName,
     justify = _ref.justify,
     variant = _ref.variant,
     tabFlex = _ref.tabFlex,
+    append = _ref.append,
+    prepend = _ref.prepend,
+    tabRotate = _ref.tabRotate,
     gap = _ref.gap,
     onBeforeChange = _ref.onBeforeChange,
     onChange = _ref.onChange;
@@ -54,22 +90,26 @@ var TabPanel = function TabPanel(_ref) {
     });
   }, [onBeforeChange, onChange, active]);
   return /*#__PURE__*/jsxs("div", {
-    className: classNames(classes.tabPanel, "area-content grid bg-base overflow-hidden"),
+    className: classNames("fabric-tabPanel", "area-content grid bg-base overflow-hidden"),
     "data-orientation": orientation,
     "data-variant": variant !== null && variant !== void 0 ? variant : "default",
-    children: [/*#__PURE__*/jsx("div", {
-      className: classNames(classes.tabList, headerClassName, justify && "justify-".concat(justify), ["start", "end"].includes(orientation) && "flex-col", "flex flex-nowrap overflow-auto scroll-thin"),
-      style: {
-        gap: gap
-      },
-      children: tabs.map(function (node) {
-        var _node$props$tabFlex;
-        return /*#__PURE__*/cloneElement(node, {
-          tabFlex: (_node$props$tabFlex = node.props.tabFlex) !== null && _node$props$tabFlex !== void 0 ? _node$props$tabFlex : tabFlex,
-          onClick: handleClick,
-          active: node.props.id === active
-        });
-      })
+    children: [/*#__PURE__*/jsxs("div", {
+      className: classNames("fabric-tabHeader", headerClassName, tabRotate && "tab-rotate", justify && "justify-".concat(justify), ["start", "end"].includes(orientation) && "flex-col", "flex flex-nowrap overflow-hidden items-center"),
+      children: [prepend, /*#__PURE__*/jsx("div", {
+        className: classNames("fabric-tabList", justify && "justify-".concat(justify), ["start", "end"].includes(orientation) && "flex-col", ["bottom", "end"].includes(orientation) ? "self-start" : "self-end", "flex flex-1 flex-nowrap overflow-auto scroll-thin"),
+        style: {
+          gap: gap
+        },
+        children: tabs.map(function (node) {
+          var _node$props$tabFlex, _node$props$activeCla;
+          return /*#__PURE__*/cloneElement(node, {
+            tabFlex: (_node$props$tabFlex = node.props.tabFlex) !== null && _node$props$tabFlex !== void 0 ? _node$props$tabFlex : tabFlex,
+            activeClassName: (_node$props$activeCla = node.props.activeClassName) !== null && _node$props$activeCla !== void 0 ? _node$props$activeCla : activeClassName,
+            onClick: handleClick,
+            active: node.props.id === active
+          });
+        })
+      }), append]
     }), rest, activeTabPanel]
   });
 };

package/dist/esm/context/Global.js

@@ -68,6 +68,9 @@ var ApplicationProvider = function ApplicationProvider(_ref3) {
     _useState8 = _slicedToArray(_useState7, 2),
     locale = _useState8[0],
     setLocale = _useState8[1];
+  useEffect(function () {
+    defaultColorScheme && setColorScheme(defaultColorScheme);
+  }, [defaultColorScheme]);
 
   /** ***************** set initial theme and locale dir  *******************/
   useEffect(function () {
@@ -148,7 +151,15 @@ var useGlobals = function useGlobals() {
 };
 
 /**
- * global application context
+ * Hook to access the global application context.
+ * This hook provides access to the global context values, including the current locale, calendar, and color scheme.
+ *
+ * @returns {GlobalContextType} The global context values excluding the error element.
+ *
+ * @example
+ * ```jsx
+ * const { changeLocale, currentLocale, toggleColorScheme } = useApplicationContext();
+ * ```
  */
 var useApplicationContext = function useApplicationContext() {
   var _useContext = useContext(GlobalContext);
@@ -156,6 +167,22 @@ var useApplicationContext = function useApplicationContext() {
     var rest = _objectWithoutProperties(_useContext, _excluded);
   return rest;
 };
+
+/**
+ * Hook to access the notification manager from the global context.
+ * This hook provides methods to show alerts, errors, messages, and toasts.
+ * It returns a reference to the notification manager, which can be used to display notifications in the application.
+ *
+ * @returns {NotificationManagerRef} The notification manager reference.
+ *
+ * @example
+ * ```jsx
+ * const notificationService = useNotificationService();
+ * notificationService.showMessage("Hello World");
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/core-components-notifications--notifications} for more details on available methods.
+ */
 var useNotificationService = function useNotificationService() {
   var _useContext2 = useContext(GlobalContext),
     notificationManager = _useContext2.notificationManager;

package/dist/esm/context/NotificationCenter.js

@@ -221,7 +221,7 @@ var NotificationManager = function NotificationManager(_ref) {
       style: {
         zIndex: "var(--z-overlay)"
       },
-      className: "ruf-container__overlays pointer-events-none fixed inset-0 p-4 bg-transparent",
+      className: "fabric-container__overlays pointer-events-none fixed inset-0 p-4 bg-transparent",
       children: Object.values(alerts).map(function (_ref7) {
         var _ref8 = _slicedToArray(_ref7, 1),
           el = _ref8[0];
@@ -231,7 +231,7 @@ var NotificationManager = function NotificationManager(_ref) {
       style: {
         zIndex: "var(--z-notifications)"
       },
-      className: "ruf-container__notifs flex flex-nowrap pointer-events-none fixed inset-0 p-2 bg-transparent flex-col-reverse items-center justify-end",
+      className: "fabric-container__notifs flex flex-nowrap pointer-events-none fixed inset-0 p-2 bg-transparent flex-col-reverse items-center justify-end",
       children: Object.values(messages).map(function (_ref9) {
         var _ref10 = _slicedToArray(_ref9, 1),
           el = _ref10[0];
@@ -241,7 +241,7 @@ var NotificationManager = function NotificationManager(_ref) {
       style: {
         zIndex: "var(--z-notifications)"
       },
-      className: "ruf-container__toasts flex flex-nowrap pointer-events-none fixed inset-0 p-4 bg-transparent flex-col items-end justify-end overflow-auto scroll-hide",
+      className: "fabric-container__toasts flex flex-nowrap pointer-events-none fixed inset-0 p-4 bg-transparent flex-col items-end justify-end overflow-auto scroll-hide",
       children: Object.values(toasts).map(function (_ref11) {
         var _ref12 = _slicedToArray(_ref11, 1),
           el = _ref12[0];

package/dist/esm/core/aside/Aside.js

@@ -4,28 +4,58 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import classNames from 'classnames';
 import { useRef, useState, useEffect, useCallback, useMemo } from 'react';
-import { Loading } from '../../components/animations/Animations.js';
-import { Icon } from '../../components/icon/Icon.js';
+import { LoadingLine } from '../../components/animations/Animations.js';
+import { Icon, getIconProps } from '../../components/icon/Icon.js';
 import { useLayoutEffectDebugger } from '../../hooks/useEffectDebugger.js';
 import { usePropToggle } from '../../hooks/usePropToggle.js';
 import { useResize } from '../../hooks/useResize.js';
-import { CoreIcons } from '../../types/icons.js';
 import { ErrorBoundary } from '../boundary/ErrorBoundary.js';
-import classes from './Aside.module.css';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 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; }
 /**
- * Side panel
+ * A sidebar component that can be collapsed, resized, and has a flyout feature.
+ * It supports a title, icon, actions, and loading state.
+ * It can be aligned to the start or end of the page.
+ *
+ * @param {AsideProps} props - The properties for the Aside component.
+ * @returns {JSX.Element} The rendered Aside component.
+ *
+ * @example
+ * ```jsx
+ * <Aside
+ *   title="Sidebar Title"
+ *   icon=icon-[mdi--menu]
+ *   rtlFlip={true}
+ *   className="custom-aside"
+ *   bodyClassName="custom-aside-body"
+ *   headerClassName="custom-aside-header"
+ *   resizeable={true}
+ *   flyout={true}
+ *   onFlyout={() => console.log("Flyout triggered")}
+ *   collapsed={false}
+ *   collapsable={true}
+ *   onCollapse={() => console.log("Collapsed toggled")}
+ *   actions={<button>Action</button>}
+ *   loading={false}
+ *   align="start"
+ *   width="20rem"
+ *   minWidth="2rem"
+ *   maxWidth="30vw"
+ *   data-testid="aside-test"
+ *   data-test-value="aside-value"
+ * >
+ *   <Content>This is the content of the aside.</Content>
+ * </Aside>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-application--aside} for more details.
  */
 var Aside = function Aside(_ref) {
   var children = _ref.children,
     title = _ref.title,
     icon = _ref.icon,
-    iconBg = _ref.iconBg,
-    iconColor = _ref.iconColor,
-    rtlFlip = _ref.rtlFlip,
     className = _ref.className,
     bodyClassName = _ref.bodyClassName,
     headerClassName = _ref.headerClassName,
@@ -103,7 +133,7 @@ var Aside = function Aside(_ref) {
     };
   }, [width, minWidth, maxWidth]);
   return /*#__PURE__*/jsxs("aside", {
-    className: classNames(classes.aside, className, "overflow-hidden grid"),
+    className: classNames("fabric-aside", className, "overflow-hidden grid"),
     "data-align": align,
     "data-flyout": peek,
     "data-loading": loading,
@@ -112,44 +142,39 @@ var Aside = function Aside(_ref) {
     "data-testid": testId,
     "data-test-value": testValue,
     children: [/*#__PURE__*/jsxs("header", {
-      className: classNames(classes.asideHeader, headerClassName, "grid area-head items-center"),
-      "data-testid": "aside-header",
+      className: classNames("fabric-asideHeader", headerClassName, "grid area-head items-center"),
+      "data-ref": "asideHeader",
       children: [title && /*#__PURE__*/jsx("div", {
-        className: classNames(classes.asideTitle, "truncate py-0.5 px-1 select-none pointer-events-none"),
+        className: classNames("fabric-asideTitle", "truncate py-0.5 px-1 select-none pointer-events-none"),
         children: title
       }), collapsable && /*#__PURE__*/jsx(Icon, {
         "aria-label": isCollapsed ? "expand" : "collapse",
-        className: classNames(classes.asideCollapse, "p-2 select-none"),
-        icon: CoreIcons.chevronLeft,
+        className: classNames("fabric-asideCollapse", "p-2 select-none"),
+        icon: "icon-[mdi--chevron-left]",
         rtlFlip: true,
         onClick: toggleCollapse,
         "data-ref": "asideToggle"
-      }), icon && /*#__PURE__*/jsx(Icon, {
-        icon: icon,
-        bg: iconBg,
-        color: iconColor,
-        rtlFlip: rtlFlip,
-        className: classNames(classes.asideIcon, "p-1 text-lg select-none pointer-events-none")
-      }), actions && /*#__PURE__*/jsx("div", {
-        className: classes.asideActions,
+      }), icon && /*#__PURE__*/jsx(Icon, _objectSpread({
+        className: classNames("fabric-asideIcon", "p-1 text-lg select-none pointer-events-none")
+      }, getIconProps(icon))), actions && /*#__PURE__*/jsx("div", {
+        className: "fabric-asideActions",
         children: actions
       })]
-    }), loading && /*#__PURE__*/jsx(Loading, {}), isCollapsed && /*#__PURE__*/jsx("div", {
+    }), loading && /*#__PURE__*/jsx(LoadingLine, {}), isCollapsed && /*#__PURE__*/jsx("div", {
       role: "none",
       onClick: tryPeek,
       "data-ref": "asidePlaceholder",
-      className: classes.asidePlaceholder
+      className: "fabric-asidePlaceholder"
     }), /*#__PURE__*/jsx("section", {
       ref: elementRef,
       "data-ref": "asideBody",
-      className: classNames(classes.asideBody, bodyClassName, "overflow-hidden grid"),
+      className: classNames("fabric-asideBody", bodyClassName, "overflow-hidden grid"),
       style: isCollapsed ? widthStyles : undefined,
-      "data-testid": "aside-body",
       children: /*#__PURE__*/jsx(ErrorBoundary, {
         children: children
       })
     }), resizeable && /*#__PURE__*/jsx("div", _objectSpread(_objectSpread({}, resizeHandleProps), {}, {
-      className: classNames(classes.asideResizer, "before:absolute before:inset-0 before:w-1 before:top-1/2 before:-translate-y-1/2 before:transition-all")
+      className: classNames("fabric-asideResizer", "before:absolute before:inset-0 before:w-1 before:top-1/2 before:-translate-y-1/2 before:transition-all before:delay-150")
     }))]
   });
 };

package/dist/esm/core/boundary/ErrorBoundary.js

@@ -13,7 +13,6 @@ import { useTranslation } from 'react-i18next';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { useMemoDebugger } from '../../hooks/useEffectDebugger.js';
 import { usePropToggle } from '../../hooks/usePropToggle.js';
-import classes from './ErrorBoundary.module.css';
 import { ErrorIcon } from './ErrorIcon.js';
 import { useGlobals } from '../../context/Global.js';
 
@@ -43,7 +42,7 @@ var ErrorMessage = function ErrorMessage(_ref2) {
   }, [], "ErrorBoundary element");
   return /*#__PURE__*/jsxs(Fragment, {
     children: [/*#__PURE__*/jsx(ErrorIcon, {}), /*#__PURE__*/jsx("div", {
-      className: classNames(classes.boundaryMessage, "p-2"),
+      className: classNames("fabric-boundaryMessage", "p-2"),
       children: /*#__PURE__*/jsx(EE, {
         error: error
       })
@@ -59,9 +58,9 @@ var ErrorStack = function ErrorStack(_ref4) {
     toggleShow = _usePropToggle2[1];
   useLogger().error(error, {}, stack);
   return /*#__PURE__*/jsxs("div", {
-    className: classNames(classes.boundaryDetail, "overflow-hidden grid"),
+    className: classNames("fabric-boundaryDetail", "overflow-hidden grid"),
     children: [/*#__PURE__*/jsx("div", {
-      className: classNames(classes.boundaryLink, "px-2 py-1 text-xs text-end"),
+      className: classNames("fabric-boundaryLink", "px-2 py-1 text-xs text-end"),
       children: /*#__PURE__*/jsx("span", {
         role: "link",
         tabIndex: 0,
@@ -70,7 +69,7 @@ var ErrorStack = function ErrorStack(_ref4) {
         children: show ? "Hide Detail" : "Show Detail"
       })
     }), show && /*#__PURE__*/jsx("div", {
-      className: classNames(classes.boundaryStack, "overflow-auto p-2 text-xs border-t"),
+      className: classNames("fabric-boundaryStack", "overflow-auto p-2 text-xs border-t"),
       children: /*#__PURE__*/jsx("pre", {
         className: "whitespace-pre-wrap",
         children: stack
@@ -80,7 +79,23 @@ var ErrorStack = function ErrorStack(_ref4) {
 };
 
 /**
- * An error boundary wrapper higher-order component designed to provide consistent error display across the application will trap runtime errors
+ * ErrorBoundary component to catch JavaScript errors anywhere in the child component tree,
+ * log those errors, and display a fallback UI.
+ * It can also display a custom error element if provided.
+ * This component is useful for preventing the entire application from crashing
+ * when an error occurs in a part of the component tree.
+ * It can be used to wrap any part of the application.
+ * It supports custom error display components and provides a default error message.
+ * It also conditionally displays the error stack trace in development mode.
+ *
+ * @example
+ * ```jsx
+ * <ErrorBoundary errorElement={CustomErrorComponent}>
+ *   <YourComponent />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/story/core-application--error-boundary}
  */
 var ErrorBoundary = /*#__PURE__*/function (_Component) {
   function ErrorBoundary(props) {
@@ -102,6 +117,8 @@ var ErrorBoundary = /*#__PURE__*/function (_Component) {
         stack: error.stack
       });
     }
+
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
   }, {
     key: "render",
     value: function render() {
@@ -110,9 +127,9 @@ var ErrorBoundary = /*#__PURE__*/function (_Component) {
         var E = this.props.errorElement;
         // You can render any custom fallback UI
         return /*#__PURE__*/jsx("div", {
-          className: classNames(classes.errorBoundary, "grid grid-rows-1 overflow-hidden p-0.5 rounded-capped"),
+          className: classNames("fabric-errorBoundary", "grid grid-rows-1 overflow-hidden p-0.5 rounded-capped"),
           children: /*#__PURE__*/jsxs("div", {
-            className: classNames(classes.boundaryContent, "overflow-hidden grid rounded-capped"),
+            className: classNames("fabric-boundaryContent", "overflow-hidden grid rounded-capped"),
             children: [/*#__PURE__*/jsx(ErrorMessage, {
               error: this.state.error,
               errorElement: E

package/dist/esm/core/boundary/ErrorIcon.js

@@ -1,7 +1,6 @@
 'use client';
 
 import classNames from 'classnames';
-import classes from './ErrorBoundary.module.css';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 /*
@@ -31,7 +30,7 @@ var ErrorIcon = function ErrorIcon() {
   return /*#__PURE__*/jsxs("svg", {
     xmlns: "http://www.w3.org/2000/svg",
     viewBox: "0 0 64 64",
-    className: classNames(classes.boundaryIcon, "size-6 m-2"),
+    className: classNames("fabric-boundaryIcon", "size-6 m-2"),
     children: [/*#__PURE__*/jsx("path", {
       fill: "#808080",
       d: "M64 32c0 17.673-14.327 32-32 32s-32-14.327-32-32 14.327-32 32-32 32 14.327 32 32z"

package/dist/esm/core/content/Content.js

@@ -5,7 +5,6 @@ import { useImperativeHandle } from 'react';
 import { useDebounce } from '../../hooks/useDebounce.js';
 import { useResizeObserver } from '../../hooks/useResizeObserver.js';
 import { ErrorBoundary } from '../boundary/ErrorBoundary.js';
-import classes from './Content.module.css';
 import { jsx } from 'react/jsx-runtime';
 
 /*
@@ -32,7 +31,12 @@ import { jsx } from 'react/jsx-runtime';
  */
 
 /**
- * Scrollable content element
+ * Content component that wraps children in a section element.
+ * It uses a resize observer to handle resizing and a debounced scroll handler.
+ * It also includes an error boundary to catch any errors in the children.
+ *
+ * @param {ContentProps} props - The properties for the Content component.
+ * @returns A section element containing the children wrapped in an error boundary.
  */
 var Content = function Content(_ref) {
   var ref = _ref.ref,
@@ -63,7 +67,7 @@ var Content = function Content(_ref) {
     "data-test-value": testValue,
     ref: resizeHandle,
     onScroll: scrollHandler,
-    className: classNames(classes.content, "area-content", className),
+    className: classNames("fabric-content", "area-content", className),
     children: /*#__PURE__*/jsx(ErrorBoundary, {
       children: children
     })

package/dist/esm/core/headfoot/HeadFoot.js

@@ -3,21 +3,15 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
-import { useMemoDebugger } from '../../hooks/useEffectDebugger.js';
-import { getColor, getBgClass, getColorClass } from '../../utils/getColor.js';
-import '@react-fabric/utilities';
-import classes from './HeadFoot.module.css';
 import { jsx } from 'react/jsx-runtime';
 
-var _excluded = ["as", "children", "className", "bg", "color", "flex", "area", "dir", "align", "justify"];
+var _excluded = ["as", "children", "className", "flex", "area", "dir", "align", "justify"];
 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 HeadFoot = function HeadFoot(_ref) {
   var E = _ref.as,
     children = _ref.children,
     className = _ref.className,
-    bg = _ref.bg,
-    color = _ref.color,
     flex = _ref.flex,
     area = _ref.area,
     dir = _ref.dir,
@@ -26,35 +20,67 @@ var HeadFoot = function HeadFoot(_ref) {
     _ref$justify = _ref.justify,
     justify = _ref$justify === void 0 ? "start" : _ref$justify,
     aria = _objectWithoutProperties(_ref, _excluded);
-  /** ***************** style map *******************/
-  var styles = useMemoDebugger(function () {
-    var s = {};
-    if (bg) {
-      s.backgroundColor = getColor(bg);
-    }
-    if (color) {
-      s.color = getColor(color);
-    }
-    return s;
-  }, [bg], "HeadFoot styles");
   return /*#__PURE__*/jsx(E, _objectSpread(_objectSpread({
     dir: dir,
-    className: classNames(classes.headfoot, className, bg && getBgClass(bg), color && getColorClass(color), area === "head" ? "area-head" : "area-foot", "leading-none", flex && "flex flex-nowrap gap-px", align && "items-".concat(align), justify && "justify-".concat(justify)),
-    style: styles
+    className: classNames("fabric-headfoot", className, area === "head" ? "area-head" : "area-foot", "leading-none", flex && "flex flex-nowrap", align && "items-".concat(align), justify && "justify-".concat(justify))
   }, aria), {}, {
     children: children
   }));
 };
+
+/**
+ * Header component that wraps children in a header element.
+ * It uses the HeadFoot component to handle layout and styling.
+ * It accepts properties for direction, alignment, and justification,
+ * allowing for flexible layout configurations.
+ * The `as` prop is set to "header" to render the element as a header.
+ * The `area` prop is set to "head" to indicate that this is a header area.
+ * It can be used to create a consistent header layout across an application.
+ *
+ * @param {HeadFootProps} props - The properties for the Header component.
+ * @returns A header element containing the children wrapped in the HeadFoot component.
+ *
+ * @example
+ * ```jsx
+ * <Header className="custom-header" dir="ltr">
+ *   <h1>Header content goes here</h1>
+ * </Header>
+ * ```
+ */
 var Header = function Header(props) {
   return /*#__PURE__*/jsx(HeadFoot, _objectSpread({
     as: "header",
-    area: "head"
+    area: "head",
+    "data-ref": "header"
   }, props));
 };
+
+/**
+ * Footer component that wraps children in a footer element.
+ * It uses the HeadFoot component to handle layout and styling.
+ * It accepts properties for direction, alignment, and justification,
+ * allowing for flexible layout configurations.
+ * The `as` prop is set to "footer" to render the element as a footer.
+ * The `area` prop is set to "foot" to indicate that this is a footer area.
+ * It can be used to create a consistent footer layout across an application.
+ * * The Footer component is designed to be flexible and can be styled with custom classes.
+ * It supports both default and flex layouts, allowing for alignment and justification of its children.
+ *
+ * @param {HeadFootProps} props - The properties for the Footer component.
+ * @returns A footer element containing the children wrapped in the HeadFoot component.
+ *
+ * @example
+ * ```jsx
+ * <Footer className="custom-footer" dir="ltr">
+ *   <p>Footer content goes here</p>
+ * </Footer>
+ * ```
+ */
 var Footer = function Footer(props) {
   return /*#__PURE__*/jsx(HeadFoot, _objectSpread({
     as: "footer",
-    area: "foot"
+    area: "foot",
+    "data-ref": "footer"
   }, props));
 };