@underverse-ui/underverse 1.0.95 → 1.0.97

package/api-reference.json

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

package/dist/index.cjs

@@ -6793,7 +6793,40 @@ var variantStyles5 = {
     inactiveTab: "text-muted-foreground hover:text-foreground"
   }
 };
+function normalizeTabsId(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+  return normalized || "default";
+}
+function getTabsBaseId(tabs, id, fallbackId) {
+  if (id) return `tabs-${normalizeTabsId(id)}`;
+  if (fallbackId) return `tabs-${normalizeTabsId(fallbackId)}`;
+  const key = tabs.map((t) => t.value).join("-");
+  return `tabs-${normalizeTabsId(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 = ({
+  id,
   tabs,
   defaultValue,
   className,
@@ -6810,14 +6843,34 @@ 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 autoId = React22.useId();
+  const baseId = React22.useMemo(() => getTabsBaseId(tabs, id, autoId), [autoId, id, 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);
@@ -6831,6 +6884,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",
@@ -6853,59 +6918,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