@underverse-ui/underverse 1.0.96 → 1.0.98

package/api-reference.json

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

package/dist/index.cjs

@@ -6793,9 +6793,15 @@ var variantStyles5 = {
     inactiveTab: "text-muted-foreground hover:text-foreground"
   }
 };
-function getTabsBaseId(tabs) {
+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-${key || "default"}`;
+  return `tabs-${normalizeTabsId(key || "default")}`;
 }
 function getTabTriggerId(baseId, index) {
   return `${baseId}-tab-${index}`;
@@ -6820,6 +6826,7 @@ function shouldHandleTabClickLocally(event, target) {
   return !(event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || target === "_blank");
 }
 var Tabs = ({
+  id,
   tabs,
   defaultValue,
   className,
@@ -6836,7 +6843,8 @@ var Tabs = ({
   const [active, setActive] = React22.useState(defaultValue || tabs[0]?.value);
   const [underlineStyle, setUnderlineStyle] = React22.useState({});
   const tabRefs = React22.useRef([]);
-  const baseId = React22.useMemo(() => getTabsBaseId(tabs), [tabs]);
+  const autoId = React22.useId();
+  const baseId = React22.useMemo(() => getTabsBaseId(tabs, id, autoId), [autoId, id, tabs]);
   const handleTabChange = (value) => {
     setActive(value);
     onTabChange?.(value);
@@ -17111,15 +17119,47 @@ var TREE_NODE_INDENT_REM = 1;
 var TREE_BRANCH_OFFSET_CLASS = "ml-1.5 pl-1.5";
 var TREE_NODE_GAP_CLASS = "gap-1.5";
 var TREE_EXPANDER_PLACEHOLDER_CLASS = "w-5";
-function getInitialExpandedNodes(categories, defaultExpanded, viewOnly, inline) {
-  if (!(viewOnly || inline) || !defaultExpanded) return /* @__PURE__ */ new Set();
-  const parentIds = /* @__PURE__ */ new Set();
-  for (const category of categories) {
-    if (typeof category.parent_id === "number") {
-      parentIds.add(category.parent_id);
+function getAncestorPathIds(categories, targetId) {
+  const byId = new Map(categories.map((category) => [category.id, category]));
+  const expanded = /* @__PURE__ */ new Set();
+  let current = byId.get(targetId);
+  let guard = 0;
+  while (current && guard++ < categories.length) {
+    expanded.add(current.id);
+    if (typeof current.parent_id !== "number") break;
+    current = byId.get(current.parent_id);
+  }
+  return expanded;
+}
+function getInitialExpandedNodes(categories, {
+  defaultExpanded,
+  defaultExpandedIds,
+  expandToId,
+  viewOnly,
+  inline
+}) {
+  const expanded = /* @__PURE__ */ new Set();
+  if ((viewOnly || inline) && defaultExpanded) {
+    for (const category of categories) {
+      if (typeof category.parent_id === "number") {
+        expanded.add(category.parent_id);
+      }
+    }
+  }
+  for (const id of defaultExpandedIds ?? []) {
+    if (typeof id === "number") {
+      expanded.add(id);
+    }
+  }
+  if (typeof expandToId === "number") {
+    for (const id of getAncestorPathIds(categories, expandToId)) {
+      expanded.add(id);
     }
   }
-  return parentIds;
+  return expanded;
+}
+function getExpandedNodesState(expandedIds, uncontrolledExpandedNodes) {
+  return expandedIds !== void 0 ? new Set(expandedIds) : uncontrolledExpandedNodes;
 }
 function CategoryTreeSelect(props) {
   const tv = useSmartTranslations("ValidationInput");
@@ -17138,6 +17178,10 @@ function CategoryTreeSelect(props) {
     helperText,
     viewOnly = false,
     defaultExpanded = false,
+    defaultExpandedIds,
+    expandToId = null,
+    expandedIds,
+    onExpandedChange,
     enableSearch,
     labels,
     inline = false,
@@ -17148,7 +17192,9 @@ function CategoryTreeSelect(props) {
     singleSelect = false
   } = props;
   const [isOpen, setIsOpen] = (0, import_react22.useState)(false);
-  const [expandedNodes, setExpandedNodes] = (0, import_react22.useState)(() => getInitialExpandedNodes(categories, defaultExpanded, viewOnly, inline));
+  const [expandedNodes, setExpandedNodes] = (0, import_react22.useState)(
+    () => getInitialExpandedNodes(categories, { defaultExpanded, defaultExpandedIds, expandToId, viewOnly, inline })
+  );
   const [query, setQuery] = (0, import_react22.useState)("");
   const [localRequiredError, setLocalRequiredError] = (0, import_react22.useState)();
   const searchInputRef = (0, import_react22.useRef)(null);
@@ -17185,6 +17231,7 @@ function CategoryTreeSelect(props) {
   const isSearchEnabled = (0, import_react22.useMemo)(() => enableSearch ?? categories.length > 10, [enableSearch, categories.length]);
   const normalizedQuery = (0, import_react22.useMemo)(() => query.trim().toLowerCase(), [query]);
   const isSearchMode = isSearchEnabled && normalizedQuery.length > 0;
+  const effectiveExpandedNodes = (0, import_react22.useMemo)(() => getExpandedNodesState(expandedIds, expandedNodes), [expandedIds, expandedNodes]);
   const visibleIds = (0, import_react22.useMemo)(() => {
     if (!isSearchMode) return null;
     const matches = categories.filter((c) => c.name.toLowerCase().includes(normalizedQuery));
@@ -17237,13 +17284,16 @@ function CategoryTreeSelect(props) {
   }, [disabled, required, valueArray.length]);
   const toggleExpand = (id2) => {
     if (isSearchMode) return;
-    const newExpanded = new Set(expandedNodes);
+    const newExpanded = new Set(effectiveExpandedNodes);
     if (newExpanded.has(id2)) {
       newExpanded.delete(id2);
     } else {
       newExpanded.add(id2);
     }
-    setExpandedNodes(newExpanded);
+    if (expandedIds === void 0) {
+      setExpandedNodes(newExpanded);
+    }
+    onExpandedChange?.(Array.from(newExpanded));
   };
   const handleSelect = (categoryId, category) => {
     if (viewOnly) return;
@@ -17285,7 +17335,7 @@ function CategoryTreeSelect(props) {
   const renderCategory = (category, level = 0) => {
     const children = effectiveChildrenMap.get(category.id) || [];
     const hasChildren = children.length > 0;
-    const isExpanded = hasChildren && (isSearchMode || expandedNodes.has(category.id));
+    const isExpanded = hasChildren && (isSearchMode || effectiveExpandedNodes.has(category.id));
     const isSelected = selectedIds.has(category.id);
     const isSelectable = !viewOnly && (!leafOnlySelect || !hasChildren);
     return /* @__PURE__ */ (0, import_jsx_runtime49.jsxs)(