@underverse-ui/underverse 1.0.94 → 1.0.96

package/api-reference.json

@@ -1,6 +1,6 @@
 {
   "package": "@underverse-ui/underverse",
-  "version": "1.0.94",
+  "version": "1.0.96",
   "sourceEntry": "src/index.ts",
   "totalExports": 225,
   "exports": [

package/dist/index.cjs

@@ -2930,20 +2930,10 @@ function useHydrated() {
   return (0, import_react5.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
 }
 
-// src/components/Tooltip.tsx
-var import_jsx_runtime10 = require("react/jsx-runtime");
-var variantStyles2 = {
-  default: "bg-popover text-popover-foreground border-border/50",
-  info: "bg-info text-info-foreground border-info/20",
-  warning: "bg-warning text-warning-foreground border-warning/20",
-  error: "bg-destructive text-destructive-foreground border-destructive/20",
-  success: "bg-success text-success-foreground border-success/20"
-};
-var clamp = (value, min, max) => Math.max(min, Math.min(max, value));
-function composeEventHandlers(theirHandler, ourHandler) {
+// src/utils/react-compose.ts
+function chainEventHandlers(...handlers) {
   return (event) => {
-    theirHandler?.(event);
-    ourHandler(event);
+    handlers.forEach((handler) => handler?.(event));
   };
 }
 function setRefValue(ref, value) {
@@ -2959,6 +2949,17 @@ function mergeRefs(...refs) {
     refs.forEach((ref) => setRefValue(ref, value));
   };
 }
+
+// src/components/Tooltip.tsx
+var import_jsx_runtime10 = require("react/jsx-runtime");
+var variantStyles2 = {
+  default: "bg-popover text-popover-foreground border-border/50",
+  info: "bg-info text-info-foreground border-info/20",
+  warning: "bg-warning text-warning-foreground border-warning/20",
+  error: "bg-destructive text-destructive-foreground border-destructive/20",
+  success: "bg-success text-success-foreground border-success/20"
+};
+var clamp = (value, min, max) => Math.max(min, Math.min(max, value));
 function getTransformOrigin(side) {
   switch (side) {
     case "top":
@@ -3003,7 +3004,7 @@ function computeTooltipPosition(args) {
   top = clamp(top, padding, viewport.height - contentSize.height - padding);
   return { top, left, side };
 }
-var Tooltip = ({
+var Tooltip = React9.forwardRef(({
   children,
   content,
   placement = "top",
@@ -3011,8 +3012,9 @@ var Tooltip = ({
   className,
   disabled = false,
   variant = "default",
-  asChild = true
-}) => {
+  asChild = true,
+  ...triggerPassthroughProps
+}, forwardedRef) => {
   const [isOpen, setIsOpen] = React9.useState(false);
   const isMounted = useHydrated();
   const triggerRef = React9.useRef(null);
@@ -3127,31 +3129,53 @@ var Tooltip = ({
     if (panelRef.current) ro.observe(panelRef.current);
     return () => ro.disconnect();
   }, [isOpen, updatePosition]);
+  const childProps = children.props;
+  const childRef = childProps.ref;
+  const passthroughRef = mergeRefs(forwardedRef, childRef, (node) => {
+    triggerRef.current = node;
+  });
   if (disabled || !content) {
-    return children;
+    if (!asChild) return children;
+    return React9.cloneElement(children, {
+      ...triggerPassthroughProps,
+      ref: passthroughRef
+    });
   }
-  const childProps = children.props;
-  const childRef = children.ref ?? childProps.ref;
   const triggerProps = {
-    ref: mergeRefs(childRef, (node) => {
-      triggerRef.current = node;
-    }),
+    ...triggerPassthroughProps,
+    ref: passthroughRef,
     "data-underverse-tooltip-trigger": triggerSelector,
-    onMouseEnter: composeEventHandlers(childProps.onMouseEnter, (e) => {
-      triggerRef.current = e.currentTarget;
-      handleMouseEnter();
-    }),
-    onMouseLeave: composeEventHandlers(childProps.onMouseLeave, (e) => {
-      triggerRef.current = e.currentTarget;
-      handleMouseLeave();
-    }),
-    onFocus: composeEventHandlers(childProps.onFocus, (e) => {
-      triggerRef.current = e.currentTarget;
-      handleFocus();
-    }),
-    onBlur: composeEventHandlers(childProps.onBlur, () => {
-      handleBlur();
-    })
+    onMouseEnter: chainEventHandlers(
+      triggerPassthroughProps.onMouseEnter,
+      childProps.onMouseEnter,
+      (e) => {
+        triggerRef.current = e.currentTarget;
+        handleMouseEnter();
+      }
+    ),
+    onMouseLeave: chainEventHandlers(
+      triggerPassthroughProps.onMouseLeave,
+      childProps.onMouseLeave,
+      (e) => {
+        triggerRef.current = e.currentTarget;
+        handleMouseLeave();
+      }
+    ),
+    onFocus: chainEventHandlers(
+      triggerPassthroughProps.onFocus,
+      childProps.onFocus,
+      (e) => {
+        triggerRef.current = e.currentTarget;
+        handleFocus();
+      }
+    ),
+    onBlur: chainEventHandlers(
+      triggerPassthroughProps.onBlur,
+      childProps.onBlur,
+      (e) => {
+        handleBlur();
+      }
+    )
   };
   const trigger = asChild ? React9.cloneElement(children, triggerProps) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { ...triggerProps, children });
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(import_jsx_runtime10.Fragment, { children: [
@@ -3195,7 +3219,8 @@ var Tooltip = ({
       document.body
     )
   ] });
-};
+});
+Tooltip.displayName = "Tooltip";
 
 // src/components/emoji-ui.tsx
 var import_jsx_runtime11 = require("react/jsx-runtime");
@@ -6120,36 +6145,32 @@ var Popover = ({
   ) : null;
   return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(import_jsx_runtime22.Fragment, { children: [
     (() => {
-      const TriggerComponent = trigger.type;
       const triggerProps = trigger.props;
-      return /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
-        TriggerComponent,
-        {
-          ...triggerProps,
-          "data-underverse-popover-trigger": triggerSelector,
-          onClick: (e) => {
+      const childRef = triggerProps.ref;
+      return React18.cloneElement(trigger, {
+        ...triggerProps,
+        ref: mergeRefs(childRef, (node) => {
+          triggerRef.current = node;
+        }),
+        "data-underverse-popover-trigger": triggerSelector,
+        onClick: chainEventHandlers(
+          (e) => {
             triggerRef.current = e.currentTarget;
             e.preventDefault();
             e.stopPropagation();
             handleTriggerClick();
-            if (typeof triggerProps.onClick === "function") {
-              triggerProps.onClick(e);
-            }
           },
-          onFocus: (e) => {
+          triggerProps.onClick
+        ),
+        onFocus: chainEventHandlers(
+          (e) => {
             triggerRef.current = e.currentTarget;
-            if (typeof triggerProps.onFocus === "function") {
-              triggerProps.onFocus(e);
-            }
           },
-          "aria-expanded": isOpen,
-          "aria-haspopup": triggerProps["aria-haspopup"] ?? "dialog",
-          className: cn(
-            triggerProps.className,
-            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
-          )
-        }
-      );
+          triggerProps.onFocus
+        ),
+        "aria-expanded": isOpen,
+        "aria-haspopup": triggerProps["aria-haspopup"] ?? "dialog"
+      });
     })(),
     popoverContent
   ] });
@@ -6772,6 +6793,32 @@ var variantStyles5 = {
     inactiveTab: "text-muted-foreground hover:text-foreground"
   }
 };
+function getTabsBaseId(tabs) {
+  const key = tabs.map((t) => t.value).join("-");
+  return `tabs-${key || "default"}`;
+}
+function getTabTriggerId(baseId, index) {
+  return `${baseId}-tab-${index}`;
+}
+function getTabPanelId(baseId, index) {
+  return `${baseId}-panel-${index}`;
+}
+function getTabHref(tab, panelId) {
+  return tab.href ?? `#${panelId}`;
+}
+function resolveTabValueFromHash(hash, tabs, baseId) {
+  const normalizedHash = hash.replace(/^#/, "");
+  if (!normalizedHash) return null;
+  const matchIndex = tabs.findIndex((tab, index) => {
+    const tabId = getTabTriggerId(baseId, index);
+    const panelId = getTabPanelId(baseId, index);
+    return normalizedHash === tabId || normalizedHash === panelId;
+  });
+  return matchIndex >= 0 ? tabs[matchIndex]?.value ?? null : null;
+}
+function shouldHandleTabClickLocally(event, target) {
+  return !(event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || target === "_blank");
+}
 var Tabs = ({
   tabs,
   defaultValue,
@@ -6789,14 +6836,33 @@ var Tabs = ({
   const [active, setActive] = React22.useState(defaultValue || tabs[0]?.value);
   const [underlineStyle, setUnderlineStyle] = React22.useState({});
   const tabRefs = React22.useRef([]);
-  const baseId = React22.useMemo(() => {
-    const key = tabs.map((t) => t.value).join("-");
-    return `tabs-${key || "default"}`;
-  }, [tabs]);
+  const baseId = React22.useMemo(() => getTabsBaseId(tabs), [tabs]);
   const handleTabChange = (value) => {
     setActive(value);
     onTabChange?.(value);
   };
+  const handleTabKeyDown = (event) => {
+    const count = tabs.length;
+    const idx = tabs.findIndex((t) => t.value === active);
+    let next = idx;
+    if (orientation === "horizontal") {
+      if (event.key === "ArrowRight") next = (idx + 1) % count;
+      if (event.key === "ArrowLeft") next = (idx - 1 + count) % count;
+    } else {
+      if (event.key === "ArrowDown") next = (idx + 1) % count;
+      if (event.key === "ArrowUp") next = (idx - 1 + count) % count;
+    }
+    if (event.key === "Home") next = 0;
+    if (event.key === "End") next = count - 1;
+    if (next !== idx) {
+      event.preventDefault();
+      const nextTab = tabs[next];
+      if (!nextTab?.disabled) {
+        handleTabChange(nextTab.value);
+      }
+      tabRefs.current[next]?.focus();
+    }
+  };
   React22.useEffect(() => {
     if (variant === "underline" && orientation === "horizontal") {
       const activeIndex2 = tabs.findIndex((tab) => tab.value === active);
@@ -6810,6 +6876,18 @@ var Tabs = ({
       }
     }
   }, [active, variant, orientation, tabs]);
+  React22.useEffect(() => {
+    if (typeof window === "undefined") return;
+    const syncFromHash = () => {
+      const nextValue = resolveTabValueFromHash(window.location.hash, tabs, baseId);
+      if (nextValue) {
+        setActive(nextValue);
+      }
+    };
+    syncFromHash();
+    window.addEventListener("hashchange", syncFromHash);
+    return () => window.removeEventListener("hashchange", syncFromHash);
+  }, [baseId, tabs]);
   const containerClasses = cn(
     "relative",
     orientation === "horizontal" ? "w-full flex space-x-1 overflow-x-auto" : "flex flex-col space-y-1 shrink-0",
@@ -6832,59 +6910,69 @@ var Tabs = ({
       tabs.map((tab, index) => {
         const isActive = active === tab.value;
         const Icon = tab.icon;
-        const tabId2 = `${baseId}-tab-${index}`;
-        const panelId2 = `${baseId}-panel-${index}`;
+        const tabId2 = getTabTriggerId(baseId, index);
+        const panelId2 = getTabPanelId(baseId, index);
+        const tabHref = getTabHref(tab, panelId2);
+        const sharedClassName = cn(
+          "font-medium transition-all duration-200 cursor-pointer flex items-center gap-2",
+          "focus:outline-none focus-visible:outline-none",
+          "disabled:opacity-50 disabled:cursor-not-allowed",
+          sizeStyles6[size].tab,
+          variantStyles5[variant].tab,
+          isActive ? variantStyles5[variant].activeTab : variantStyles5[variant].inactiveTab,
+          orientation === "vertical" && "justify-start w-full",
+          stretch && orientation === "horizontal" && "flex-1 justify-center",
+          tab.href && tab.disabled && "pointer-events-none cursor-not-allowed opacity-50"
+        );
+        const sharedStyle = {
+          boxShadow: "none",
+          transform: "none",
+          outline: "none",
+          border: "none"
+        };
+        const sharedProps = {
+          ref: (el) => {
+            tabRefs.current[index] = el;
+          },
+          id: tabId2,
+          role: "tab",
+          "aria-selected": isActive,
+          "aria-controls": panelId2,
+          tabIndex: isActive ? 0 : -1,
+          className: sharedClassName,
+          style: sharedStyle,
+          onKeyDown: handleTabKeyDown
+        };
+        if (!tab.disabled) {
+          return /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)(
+            "a",
+            {
+              ...sharedProps,
+              href: tabHref,
+              target: tab.target,
+              rel: tab.rel,
+              onClick: (event) => {
+                if (shouldHandleTabClickLocally(event, tab.target)) {
+                  event.preventDefault();
+                  handleTabChange(tab.value);
+                }
+              },
+              className: cn(sharedClassName, "no-underline"),
+              children: [
+                Icon && /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(Icon, { className: "h-4 w-4" }),
+                tab.label
+              ]
+            },
+            tab.value
+          );
+        }
         return /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)(
           "button",
           {
-            ref: (el) => {
-              tabRefs.current[index] = el;
-            },
+            ...sharedProps,
             onClick: () => !tab.disabled && handleTabChange(tab.value),
             disabled: tab.disabled,
-            style: {
-              boxShadow: "none",
-              transform: "none",
-              outline: "none",
-              border: "none"
-            },
-            className: cn(
-              "font-medium transition-all duration-200 cursor-pointer flex items-center gap-2",
-              "focus:outline-none focus-visible:outline-none",
-              "disabled:opacity-50 disabled:cursor-not-allowed",
-              "border-0 bg-transparent outline-none",
-              // Reset button default styles
-              sizeStyles6[size].tab,
-              variantStyles5[variant].tab,
-              isActive ? variantStyles5[variant].activeTab : variantStyles5[variant].inactiveTab,
-              orientation === "vertical" && "justify-start w-full",
-              stretch && orientation === "horizontal" && "flex-1 justify-center"
-            ),
-            role: "tab",
-            id: tabId2,
-            "aria-selected": isActive,
-            "aria-controls": panelId2,
-            tabIndex: isActive ? 0 : -1,
-            onKeyDown: (e) => {
-              const count = tabs.length;
-              const idx = tabs.findIndex((t) => t.value === active);
-              let next = idx;
-              if (orientation === "horizontal") {
-                if (e.key === "ArrowRight") next = (idx + 1) % count;
-                if (e.key === "ArrowLeft") next = (idx - 1 + count) % count;
-              } else {
-                if (e.key === "ArrowDown") next = (idx + 1) % count;
-                if (e.key === "ArrowUp") next = (idx - 1 + count) % count;
-              }
-              if (e.key === "Home") next = 0;
-              if (e.key === "End") next = count - 1;
-              if (next !== idx) {
-                e.preventDefault();
-                const nextVal = tabs[next].value;
-                handleTabChange(nextVal);
-                tabRefs.current[next]?.focus();
-              }
-            },
+            className: cn(sharedClassName, "border-0 bg-transparent outline-none"),
             children: [
               Icon && /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(Icon, { className: "h-4 w-4" }),
               tab.label
@@ -7028,17 +7116,18 @@ var DropdownMenu = ({
       index
     );
   }) : children });
-  const TriggerComponent = trigger.type;
   const triggerProps = trigger.props;
-  const enhancedTrigger = /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
-    TriggerComponent,
-    {
-      ...triggerProps,
-      "aria-haspopup": "menu",
-      "aria-expanded": open,
-      onKeyDown: (e) => {
-        triggerRef.current = e.currentTarget;
-        if (disabled) return;
+  const childRef = triggerProps.ref;
+  const enhancedTrigger = import_react14.default.cloneElement(trigger, {
+    ...triggerProps,
+    ref: mergeRefs(childRef, (node) => {
+      triggerRef.current = node;
+    }),
+    "aria-haspopup": "menu",
+    "aria-expanded": open,
+    onKeyDown: chainEventHandlers((e) => {
+      triggerRef.current = e.currentTarget;
+      if (!disabled) {
         if (e.key === "ArrowDown") {
           e.preventDefault();
           setOpen(true);
@@ -7054,22 +7143,12 @@ var DropdownMenu = ({
           e.preventDefault();
           setOpen(false);
         }
-        if (typeof triggerProps.onKeyDown === "function") {
-          triggerProps.onKeyDown(e);
-        }
-      },
-      onFocus: (e) => {
-        triggerRef.current = e.currentTarget;
-        if (typeof triggerProps.onFocus === "function") {
-          triggerProps.onFocus(e);
-        }
-      },
-      className: cn(
-        triggerProps.className,
-        "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
-      )
-    }
-  );
+      }
+    }, triggerProps.onKeyDown),
+    onFocus: chainEventHandlers((e) => {
+      triggerRef.current = e.currentTarget;
+    }, triggerProps.onFocus)
+  });
   return /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
     Popover,
     {