@react-fabric/core 1.0.0-beta.9 → 1.0.2

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

@@ -1,25 +1,62 @@
 'use client';
 
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
-import classNames from 'classnames';
-import { useState, useMemo, Children, useEffect, useCallback, cloneElement } from 'react';
-import '@react-fabric/utilities';
+import { getValue, cn } from '@react-fabric/utilities';
+import { useState, useMemo, Children, useEffect, cloneElement } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
 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
 
-var TabPanel = function TabPanel(_ref) {
+function getFirstTab(tabs) {
+  var _tabs$find;
+  return ((_tabs$find = tabs.find(function (tab) {
+    return !tab.props.disabled;
+  })) === null || _tabs$find === void 0 ? void 0 : _tabs$find.props.id) || null;
+}
+
+/**
+ * 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.
+ *
+ * @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>
+ * ```
+ */
+function TabPanel(_ref) {
   var children = _ref.children,
-    headerClassName = _ref.headerClassName,
+    className = _ref.className,
+    classNames = _ref.classNames,
     _ref$orientation = _ref.orientation,
     orientation = _ref$orientation === void 0 ? "top" : _ref$orientation,
     activeTab = _ref.activeTab,
     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;
@@ -28,8 +65,9 @@ var TabPanel = function TabPanel(_ref) {
     active = _useState2[0],
     setActive = _useState2[1];
   var _useMemo = useMemo(function () {
+      // eslint-disable-next-line @eslint-react/no-children-to-array
       return Children.toArray(children).reduce(function (ret, node) {
-        nodeCheck(node, Tab) ? ret[0].push(node) : ret[1].push(node);
+        if (nodeCheck(node, Tab)) ret[0].push(node);else ret[1].push(node);
         return ret;
       }, [[], []]);
     }, [children]),
@@ -37,41 +75,49 @@ var TabPanel = function TabPanel(_ref) {
     tabs = _useMemo2[0],
     rest = _useMemo2[1];
   useEffect(function () {
-    setActive(activeTab);
+    // eslint-disable-next-line @eslint-react/set-state-in-effect
+    setActive(getValue("".concat(activeTab !== null && activeTab !== void 0 ? activeTab : getFirstTab(tabs))));
+    // eslint-disable-next-line @eslint-react/exhaustive-deps
   }, [activeTab]);
   var activeTabPanel = useMemo(function () {
-    var _tabs$find;
-    return (_tabs$find = tabs.find(function (tab) {
+    var _tabs$find2;
+    return (_tabs$find2 = tabs.find(function (tab) {
       return tab.props.id === active;
-    })) === null || _tabs$find === void 0 ? void 0 : _tabs$find.props.children;
+    })) === null || _tabs$find2 === void 0 ? void 0 : _tabs$find2.props.children;
   }, [tabs, active]);
-  var handleClick = useCallback(function (id) {
+  var handleClick = function handleClick(id) {
     void Promise.resolve(onBeforeChange === null || onBeforeChange === void 0 ? void 0 : onBeforeChange(id, active)).then(function (ret) {
       if (ret !== false) {
         setActive(id);
         onChange === null || onChange === void 0 || onChange(id);
       }
     });
-  }, [onBeforeChange, onChange, active]);
+  };
   return /*#__PURE__*/jsxs("div", {
-    className: classNames(classes.tabPanel, "area-content grid bg-base overflow-hidden"),
+    className: cn("fabric-tabPanel", className, classNames === null || classNames === void 0 ? void 0 : classNames.root, "area-content grid bg-default 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: cn("fabric-tabHeader", classNames === null || classNames === void 0 ? void 0 : classNames.header, 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: cn("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;
+          return /*#__PURE__*/cloneElement(node, {
+            tabFlex: (_node$props$tabFlex = node.props.tabFlex) !== null && _node$props$tabFlex !== void 0 ? _node$props$tabFlex : tabFlex,
+            classNames: Object.assign({
+              active: classNames === null || classNames === void 0 ? void 0 : classNames.active
+            }, node.props.classNames),
+            onClick: handleClick,
+            active: node.props.id === active
+          });
+        })
+      }), append]
     }), rest, activeTabPanel]
   });
-};
+}
 
 export { TabPanel };

package/dist/esm/components/titlebar/Titlebar.js

@@ -0,0 +1,52 @@
+'use client';
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import { cn } from '@react-fabric/utilities';
+import { isValidElement, Fragment } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { getIconProps } from '../../utils/getIconProps.js';
+import { StyleEffect } from '../effect/StyleEffect.js';
+import { Icon } from '../icon/Icon.js';
+
+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), true).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; }
+/**
+ * Header bar with optional icon, title, and action elements.
+ * Renders as a semantic <header> element.
+ */
+function Titlebar(_ref) {
+  var title = _ref.title,
+    className = _ref.className,
+    classNames = _ref.classNames,
+    icon = _ref.icon,
+    actions = _ref.actions,
+    prepend = _ref.prepend,
+    onClick = _ref.onClick;
+  return /*#__PURE__*/jsxs("div", {
+    className: cn("fabric-titlebar", "empty:hidden not-empty:border-b border-soft", className, classNames === null || classNames === void 0 ? void 0 : classNames.root, "grid items-center rounded-t-[inherit] px-2 py-1 relative"),
+    "data-ref": "titlebar",
+    children: [/*#__PURE__*/jsx(StyleEffect, {
+      showBorder: false
+    }), /*#__PURE__*/isValidElement(title) ? title : /*#__PURE__*/jsxs(Fragment, {
+      children: [prepend && /*#__PURE__*/jsx("div", {
+        "data-ref": "titlebar-actions",
+        className: cn("fabric-titlebarActions", classNames === null || classNames === void 0 ? void 0 : classNames.prepend),
+        children: prepend
+      }), icon && /*#__PURE__*/jsx(Icon, _objectSpread({
+        className: cn("fabric-titlebarIcon", classNames === null || classNames === void 0 ? void 0 : classNames.icon, "p-1 text-lg select-none pointer-events-none")
+      }, getIconProps(icon))), title && /*#__PURE__*/jsx("div", {
+        role: "none",
+        "data-ref": "titlebar-title",
+        onClick: onClick,
+        className: cn("fabric-titlebarTitle", classNames === null || classNames === void 0 ? void 0 : classNames.title, "truncate py-0.5 px-1 select-none"),
+        children: title
+      }), actions && /*#__PURE__*/jsx("div", {
+        "data-ref": "titlebar-actions",
+        className: cn("fabric-titlebarActions flex gap-px", classNames === null || classNames === void 0 ? void 0 : classNames.actions),
+        children: actions
+      })]
+    })]
+  });
+}
+
+export { Titlebar };

package/dist/esm/components/tooltip/Tooltip.js

@@ -0,0 +1,180 @@
+'use client';
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
+import { useFloating, autoUpdate, shift, flip, offset, arrow, useHover, safePolygon, useInteractions, FloatingPortal, FloatingArrow } from '@floating-ui/react';
+import { mergeRefs, isString, cn } from '@react-fabric/utilities';
+import { useRef, useMemo, useEffect, Fragment, cloneElement, isValidElement } from 'react';
+import { Icon } from '../icon/Icon.js';
+import { useIsRtl } from '../../hooks/useIsRtl.js';
+import { usePropState } from '../../hooks/usePropState.js';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+var _excluded = ["children", "color", "content", "open", "copyContent", "disabled", "placement"];
+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), true).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 COLOR_MAP = {
+  "default": "bg-dimmed text-dimmed outline-default",
+  primary: "bg-primary-50 text-primary-700 outline-primary-100",
+  secondary: "bg-secondary-50 text-secondary-700 outline-secondary-100",
+  info: "bg-info-50 text-info-700 outline-info-100",
+  danger: "bg-danger-50 text-danger-700 outline-danger-100",
+  success: "bg-success-50 text-success-700 outline-success-100",
+  warning: "bg-warning-50 text-warning-700 outline-warning-100",
+  scarlet: "bg-scarlet-50 text-scarlet-700 outline-scarlet-100",
+  pumpkin: "bg-pumpkin-50 text-pumpkin-700 outline-pumpkin-100",
+  marigold: "bg-marigold-50 text-marigold-700 outline-marigold-100",
+  avacado: "bg-avacado-50 text-avacado-700 outline-avacado-100",
+  jade: "bg-jade-50 text-jade-700 outline-jade-100",
+  denim: "bg-denim-50 text-denim-700 outline-denim-100",
+  iris: "bg-iris-50 text-iris-700 outline-iris-100",
+  lilac: "bg-lilac-50 text-lilac-700 outline-lilac-100",
+  coral: "bg-coral-50 text-coral-700 outline-coral-100",
+  wood: "bg-wood-50 text-wood-700 outline-wood-100"
+};
+var ARROW_COLOR_MAP = {
+  "default": "fill-dimmed stroke-default",
+  primary: "fill-primary-50 stroke-primary-100",
+  secondary: "fill-secondary-50 stroke-secondary-100",
+  info: "fill-info-50 stroke-info-100",
+  danger: "fill-danger-50 stroke-danger-100",
+  success: "fill-success-50 stroke-success-100",
+  warning: "fill-warning-50 stroke-warning-100",
+  scarlet: "fill-scarlet-50 stroke-scarlet-100",
+  pumpkin: "fill-pumpkin-50 stroke-pumpkin-100",
+  marigold: "fill-marigold-50 stroke-marigold-100",
+  avacado: "fill-avacado-50 stroke-avacado-100",
+  jade: "fill-jade-50 stroke-jade-100",
+  denim: "fill-denim-50 stroke-denim-100",
+  iris: "fill-iris-50 stroke-iris-100",
+  lilac: "fill-lilac-50 stroke-lilac-100",
+  coral: "fill-coral-50 stroke-coral-100",
+  wood: "fill-wood-50 stroke-wood-100"
+};
+
+/**
+ * Floating tooltip that displays content on hover.
+ *
+ * Renders a tooltip using Floating UI with an arrow, positioned relative
+ * to its child element. Supports color theming, copy-to-clipboard action,
+ * and RTL-aware placement flipping.
+ *
+ * @example
+ * ```tsx
+ * import { Tooltip } from "@react-fabric/core";
+ *
+ * <Tooltip content="Hello world">
+ *   <button>Hover me</button>
+ * </Tooltip>
+ *
+ * <Tooltip content="Copy me" copyContent="Copy me">
+ *   <span>Copy this</span>
+ * </Tooltip>
+ * ```
+ */
+function Tooltip(_ref) {
+  var _refs$domReference$cu, _refs$domReference$cu2, _COLOR_MAP, _ARROW_COLOR_MAP;
+  var children = _ref.children,
+    color = _ref.color,
+    content = _ref.content,
+    open = _ref.open,
+    copyContent = _ref.copyContent,
+    disabled = _ref.disabled,
+    _placement = _ref.placement,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var arrowRef = useRef(null);
+  var isRtl = useIsRtl();
+  var _usePropState = usePropState(open),
+    _usePropState2 = _slicedToArray(_usePropState, 2),
+    isOpen = _usePropState2[0],
+    setIsOpen = _usePropState2[1];
+  var placement = useMemo(function () {
+    var _placement$replace;
+    if (isRtl) return _placement !== null && _placement !== void 0 && _placement.includes("left") ? _placement.replace("left", "right") : (_placement$replace = _placement === null || _placement === void 0 ? void 0 : _placement.replace("right", "left")) !== null && _placement$replace !== void 0 ? _placement$replace : "top";
+    return _placement !== null && _placement !== void 0 ? _placement : "top";
+  }, [_placement, isRtl]);
+  var _useFloating = useFloating({
+      open: isOpen,
+      strategy: "fixed",
+      onOpenChange: !!open || disabled ? undefined : setIsOpen,
+      whileElementsMounted: autoUpdate,
+      placement: placement,
+      middleware: [shift({
+        padding: 8
+      }), flip(), offset(9), arrow({
+        element: arrowRef
+      })]
+    }),
+    refs = _useFloating.refs,
+    floatingStyles = _useFloating.floatingStyles,
+    context = _useFloating.context;
+  var hover = useHover(context, {
+    restMs: 500,
+    delay: {
+      open: 1000
+    },
+    handleClose: copyContent ? safePolygon({
+      buffer: 1
+    }) : undefined
+  });
+  var _useInteractions = useInteractions([open ? undefined : hover]),
+    getReferenceProps = _useInteractions.getReferenceProps,
+    getFloatingProps = _useInteractions.getFloatingProps;
+  useEffect(function () {
+    context.update();
+    // eslint-disable-next-line @eslint-react/exhaustive-deps
+  }, [content]);
+  var innerRef = useMemo(function () {
+    return mergeRefs(children.props.ref, function (el) {
+      return refs.setReference(el);
+    });
+  }, [children.props.ref, refs]);
+  var copyEl = useMemo(function () {
+    if (copyContent) {
+      var copyText = isString(copyContent) ? copyContent : isString(content) ? content : "";
+      var handler = function handler(e) {
+        setIsOpen(false);
+        e.stopPropagation();
+        void navigator.clipboard.writeText(copyText);
+      };
+      return /*#__PURE__*/jsx("span", {
+        role: "none",
+        className: "ms-2 cursor-pointer text-dimmed flex-content opacity-75 hover:opacity-90 active:opacity-60",
+        onClick: handler,
+        children: /*#__PURE__*/jsx(Icon, {
+          icon: "icon-[mdi--content-copy]"
+        })
+      });
+    }
+    return null;
+    // eslint-disable-next-line @eslint-react/exhaustive-deps
+  }, [copyContent, content]);
+  return /*#__PURE__*/jsxs(Fragment, {
+    children: [/*#__PURE__*/cloneElement(children, _objectSpread({
+      ref: innerRef
+    }, open ? {} : getReferenceProps(rest))), isOpen && content && /*#__PURE__*/jsx(FloatingPortal, {
+      root: (_refs$domReference$cu = (_refs$domReference$cu2 = refs.domReference.current) === null || _refs$domReference$cu2 === void 0 ? void 0 : _refs$domReference$cu2.closest(".theme-base")) !== null && _refs$domReference$cu !== void 0 ? _refs$domReference$cu : undefined,
+      children: /*#__PURE__*/jsxs("dfn", _objectSpread(_objectSpread({
+        "data-ref": "tooltip",
+        className: cn("fabric-tooltip z-(--z-tooltip)", "select-none text-sm not-italic flex py-1 px-2 max-w-lg! rounded shadow-sm outline", (_COLOR_MAP = COLOR_MAP[color]) !== null && _COLOR_MAP !== void 0 ? _COLOR_MAP : COLOR_MAP["default"]),
+        ref: function ref(el) {
+          return refs.setFloating(el);
+        },
+        style: _objectSpread({}, floatingStyles)
+      }, getFloatingProps()), {}, {
+        children: [/*#__PURE__*/isValidElement(content) && content, isString(content) && /*#__PURE__*/jsx("span", {
+          className: cn("font-medium flex-1 break-all whitespace-pre-wrap mixed-lang"),
+          children: content
+        }), copyEl, /*#__PURE__*/jsx(FloatingArrow, {
+          ref: arrowRef,
+          context: context,
+          strokeWidth: 0.5,
+          className: cn((_ARROW_COLOR_MAP = ARROW_COLOR_MAP[color]) !== null && _ARROW_COLOR_MAP !== void 0 ? _ARROW_COLOR_MAP : ARROW_COLOR_MAP["default"])
+        })]
+      }))
+    })]
+  });
+}
+
+export { Tooltip };