@aloudata/aloudata-design 3.1.6 → 3.2.0-beta.0

package/dist/MemberPicker/dialog/useMemberPickerDraft.d.ts

@@ -0,0 +1,27 @@
+import { EMemberPicker, TMemberPickerValue as MemberPickerValue } from '../interface.js';
+import { TUserGroupValue, TUserValue, TUser } from '../../ConfigProvider/getUserList.js';
+import { TMember, TMemberKey, TMemberPickerTab } from './types.js';
+export interface IUseMemberPickerDraftOptions {
+    value?: MemberPickerValue;
+    type?: EMemberPicker;
+    lockedIds?: Array<TUserValue | TUserGroupValue>;
+    onChange?: (members: TUser) => void;
+}
+export interface IMemberPickerDraftResult {
+    activeTab: TMemberPickerTab;
+    selectedMembers: TUser;
+    selectedByKey: Map<TMemberKey, TMember>;
+    hydrating: boolean;
+    setActiveTab: (tab: TMemberPickerTab) => void;
+    toggleMember: (member: TMember) => void;
+    toggleMembers: (members: readonly TMember[], selected: boolean) => void;
+    removeMember: (member: TMember) => void;
+    confirm: () => void;
+}
+/**
+ * 管理单次弹窗内的成员选择草稿。
+ *
+ * 外部 value 仅用于初始化，增删不会提前触发 onChange；弹窗取消时卸载本 hook，
+ * 只有 confirm 会按 Map 的稳定插入顺序一次性提交。
+ */
+export declare function useMemberPickerDraft({ value, type, lockedIds, onChange, }: IUseMemberPickerDraftOptions): IMemberPickerDraftResult;

package/dist/MemberPicker/dialog/useMemberPickerDraft.js

@@ -0,0 +1,95 @@
+import { EUserType } from "../../ConfigProvider/getUserList.js";
+import AldCustomConfigProvider from "../../ConfigProvider/index.js";
+import { EMemberPicker } from "../interface.js";
+import { addSelectedMember, createSelectedByKey, getMemberKey, isMemberLocked, removeSelectedMember, setMembersSelected } from "./helper.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+//#region src/MemberPicker/dialog/useMemberPickerDraft.ts
+var EMPTY_LOCKED_IDS = [];
+var toValueArray = (value) => {
+	if (!value) return [];
+	return Array.isArray(value) ? [...value] : [value];
+};
+/** 历史值可能只有 ID；占位名称保证不可见对象不会被静默丢弃。 */
+var toMemberPlaceholder = (value) => {
+	if (value.type === EUserType.USER) return {
+		...value,
+		type: EUserType.USER,
+		name: value.name ?? value.nickname ?? value.account ?? value.userId
+	};
+	return {
+		...value,
+		type: EUserType.USER_GROUP,
+		name: value.name ?? value.groupId,
+		parentId: value.parentId ?? null,
+		frontId: value.frontId ?? null
+	};
+};
+var needsHydration = (value) => {
+	if (value.type === EUserType.USER) return !value.name && !value.nickname && !value.account;
+	return !value.name;
+};
+/**
+* 管理单次弹窗内的成员选择草稿。
+*
+* 外部 value 仅用于初始化，增删不会提前触发 onChange；弹窗取消时卸载本 hook，
+* 只有 confirm 会按 Map 的稳定插入顺序一次性提交。
+*/
+function useMemberPickerDraft({ value, type = EMemberPicker.BOTH, lockedIds = EMPTY_LOCKED_IDS, onChange }) {
+	const { getUsersByIds } = AldCustomConfigProvider.useGetUserList();
+	const initialValuesRef = useRef(toValueArray(value));
+	const missingValuesRef = useRef(initialValuesRef.current.filter(needsHydration));
+	const [selectedByKey, setSelectedByKey] = useState(() => createSelectedByKey(initialValuesRef.current.map(toMemberPlaceholder)));
+	const [hydrating, setHydrating] = useState(missingValuesRef.current.length > 0 && Boolean(getUsersByIds));
+	const [activeTab, setActiveTabState] = useState(type === EMemberPicker.GROUP ? EMemberPicker.GROUP : EMemberPicker.USER);
+	useEffect(() => {
+		const missingValues = missingValuesRef.current;
+		if (!missingValues.length || !getUsersByIds) {
+			setHydrating(false);
+			return;
+		}
+		let active = true;
+		getUsersByIds(missingValues).then((hydratedMembers) => {
+			if (!active) return;
+			const hydratedByKey = createSelectedByKey(hydratedMembers.map((member) => toMemberPlaceholder(member)));
+			setSelectedByKey((currentSelected) => new Map(Array.from(currentSelected).map(([key, member_0]) => [key, hydratedByKey.get(key) ?? member_0])));
+		}).catch(() => void 0).finally(() => {
+			if (active) setHydrating(false);
+		});
+		return () => {
+			active = false;
+		};
+	}, [getUsersByIds]);
+	const setActiveTab = useCallback((tab) => {
+		if (type === EMemberPicker.BOTH) setActiveTabState(tab);
+	}, [type]);
+	const removeMember = useCallback((member_1) => {
+		setSelectedByKey((currentSelected_0) => removeSelectedMember(currentSelected_0, member_1, lockedIds));
+	}, [lockedIds]);
+	const toggleMember = useCallback((member_2) => {
+		if (isMemberLocked(member_2, lockedIds)) return;
+		setSelectedByKey((currentSelected_1) => {
+			const key_0 = getMemberKey(member_2);
+			return currentSelected_1.has(key_0) ? removeSelectedMember(currentSelected_1, member_2, lockedIds) : addSelectedMember(currentSelected_1, member_2);
+		});
+	}, [lockedIds]);
+	const toggleMembers = useCallback((members, selected) => {
+		setSelectedByKey((currentSelected_2) => setMembersSelected(currentSelected_2, members, selected, lockedIds));
+	}, [lockedIds]);
+	return {
+		activeTab,
+		selectedMembers: useMemo(() => Array.from(selectedByKey.values()), [selectedByKey]),
+		selectedByKey,
+		hydrating,
+		setActiveTab,
+		toggleMember,
+		toggleMembers,
+		removeMember,
+		confirm: useCallback(() => {
+			onChange?.(Array.from(selectedByKey.values()));
+		}, [onChange, selectedByKey])
+	};
+}
+//#endregion
+export { useMemberPickerDraft };
+
+//# sourceMappingURL=useMemberPickerDraft.js.map

package/dist/MemberPicker/dialog/useMemberPickerDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemberPickerDraft.js","names":["useCallback","useEffect","useMemo","useRef","useState","ConfigProvider","EMemberPicker","EUserType","TMemberPickerValue","MemberPickerValue","TUserGroupValue","TUserValue","TUser","addSelectedMember","createSelectedByKey","getMemberKey","isMemberLocked","removeSelectedMember","setMembersSelected","TMember","TMemberKey","TMemberPickerTab","EMPTY_LOCKED_IDS","Array","toValueArray","value","isArray","toMemberPlaceholder","type","USER","name","nickname","account","userId","USER_GROUP","groupId","parentId","frontId","needsHydration","IUseMemberPickerDraftOptions","lockedIds","onChange","members","IMemberPickerDraftResult","activeTab","selectedMembers","selectedByKey","Map","hydrating","setActiveTab","tab","toggleMember","member","toggleMembers","selected","removeMember","confirm","useMemberPickerDraft","BOTH","getUsersByIds","useGetUserList","initialValuesRef","missingValuesRef","current","filter","setSelectedByKey","map","setHydrating","length","Boolean","setActiveTabState","GROUP","missingValues","undefined","active","then","hydratedMembers","hydratedByKey","currentSelected","from","key","get","catch","finally","has","values"],"sources":["../../../src/MemberPicker/dialog/useMemberPickerDraft.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport ConfigProvider from '../../ConfigProvider';\nimport { EMemberPicker } from '../interface';\nimport { EUserType } from '../../ConfigProvider/getUserList';\nimport type { TMemberPickerValue as MemberPickerValue } from '../interface';\nimport type {\n  TUserGroupValue,\n  TUserValue,\n} from '../../ConfigProvider/getUserList';\nimport type { TUser } from '../../ConfigProvider/getUserList';\nimport {\n  addSelectedMember,\n  createSelectedByKey,\n  getMemberKey,\n  isMemberLocked,\n  removeSelectedMember,\n  setMembersSelected,\n} from './helper';\nimport type { TMember, TMemberKey, TMemberPickerTab } from './types';\n\nconst EMPTY_LOCKED_IDS: Array<TUserValue | TUserGroupValue> = [];\n\nconst toValueArray = (\n  value?: MemberPickerValue,\n): Array<TUserValue | TUserGroupValue> => {\n  if (!value) {\n    return [];\n  }\n  return Array.isArray(value) ? [...value] : [value];\n};\n\n/** 历史值可能只有 ID；占位名称保证不可见对象不会被静默丢弃。 */\nconst toMemberPlaceholder = (value: TUserValue | TUserGroupValue): TMember => {\n  if (value.type === EUserType.USER) {\n    return {\n      ...value,\n      type: EUserType.USER,\n      name: value.name ?? value.nickname ?? value.account ?? value.userId,\n    };\n  }\n  return {\n    ...value,\n    type: EUserType.USER_GROUP,\n    name: value.name ?? value.groupId,\n    parentId: value.parentId ?? null,\n    frontId: value.frontId ?? null,\n  };\n};\n\nconst needsHydration = (value: TUserValue | TUserGroupValue): boolean => {\n  if (value.type === EUserType.USER) {\n    return !value.name && !value.nickname && !value.account;\n  }\n  return !value.name;\n};\n\nexport interface IUseMemberPickerDraftOptions {\n  value?: MemberPickerValue;\n  type?: EMemberPicker;\n  lockedIds?: Array<TUserValue | TUserGroupValue>;\n  onChange?: (members: TUser) => void;\n}\n\nexport interface IMemberPickerDraftResult {\n  activeTab: TMemberPickerTab;\n  selectedMembers: TUser;\n  selectedByKey: Map<TMemberKey, TMember>;\n  hydrating: boolean;\n  setActiveTab: (tab: TMemberPickerTab) => void;\n  toggleMember: (member: TMember) => void;\n  toggleMembers: (members: readonly TMember[], selected: boolean) => void;\n  removeMember: (member: TMember) => void;\n  confirm: () => void;\n}\n\n/**\n * 管理单次弹窗内的成员选择草稿。\n *\n * 外部 value 仅用于初始化，增删不会提前触发 onChange；弹窗取消时卸载本 hook，\n * 只有 confirm 会按 Map 的稳定插入顺序一次性提交。\n */\nexport function useMemberPickerDraft({\n  value,\n  type = EMemberPicker.BOTH,\n  lockedIds = EMPTY_LOCKED_IDS,\n  onChange,\n}: IUseMemberPickerDraftOptions): IMemberPickerDraftResult {\n  const { getUsersByIds } = ConfigProvider.useGetUserList();\n  const initialValuesRef = useRef(toValueArray(value));\n  const missingValuesRef = useRef(\n    initialValuesRef.current.filter(needsHydration),\n  );\n  const [selectedByKey, setSelectedByKey] = useState(() =>\n    createSelectedByKey(initialValuesRef.current.map(toMemberPlaceholder)),\n  );\n  const [hydrating, setHydrating] = useState(\n    missingValuesRef.current.length > 0 && Boolean(getUsersByIds),\n  );\n  const [activeTab, setActiveTabState] = useState<TMemberPickerTab>(\n    type === EMemberPicker.GROUP ? EMemberPicker.GROUP : EMemberPicker.USER,\n  );\n\n  useEffect(() => {\n    const missingValues = missingValuesRef.current;\n    if (!missingValues.length || !getUsersByIds) {\n      setHydrating(false);\n      return undefined;\n    }\n\n    let active = true;\n    getUsersByIds(missingValues)\n      .then((hydratedMembers) => {\n        if (!active) {\n          return;\n        }\n        const hydratedByKey = createSelectedByKey(\n          hydratedMembers.map((member) => toMemberPlaceholder(member)),\n        );\n        setSelectedByKey(\n          (currentSelected) =>\n            new Map(\n              Array.from(currentSelected).map(([key, member]) => [\n                key,\n                hydratedByKey.get(key) ?? member,\n              ]),\n            ),\n        );\n      })\n      .catch(() => undefined)\n      .finally(() => {\n        if (active) {\n          setHydrating(false);\n        }\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [getUsersByIds]);\n\n  const setActiveTab = useCallback(\n    (tab: TMemberPickerTab) => {\n      if (type === EMemberPicker.BOTH) {\n        setActiveTabState(tab);\n      }\n    },\n    [type],\n  );\n\n  const removeMember = useCallback(\n    (member: TMember) => {\n      setSelectedByKey((currentSelected) =>\n        removeSelectedMember(currentSelected, member, lockedIds),\n      );\n    },\n    [lockedIds],\n  );\n\n  const toggleMember = useCallback(\n    (member: TMember) => {\n      if (isMemberLocked(member, lockedIds)) {\n        return;\n      }\n      setSelectedByKey((currentSelected) => {\n        const key = getMemberKey(member);\n        return currentSelected.has(key)\n          ? removeSelectedMember(currentSelected, member, lockedIds)\n          : addSelectedMember(currentSelected, member);\n      });\n    },\n    [lockedIds],\n  );\n\n  const toggleMembers = useCallback(\n    (members: readonly TMember[], selected: boolean) => {\n      setSelectedByKey((currentSelected) =>\n        setMembersSelected(currentSelected, members, selected, lockedIds),\n      );\n    },\n    [lockedIds],\n  );\n\n  const selectedMembers = useMemo<TUser>(\n    () => Array.from(selectedByKey.values()),\n    [selectedByKey],\n  );\n\n  const confirm = useCallback(() => {\n    onChange?.(Array.from(selectedByKey.values()));\n  }, [onChange, selectedByKey]);\n\n  return {\n    activeTab,\n    selectedMembers,\n    selectedByKey,\n    hydrating,\n    setActiveTab,\n    toggleMember,\n    toggleMembers,\n    removeMember,\n    confirm,\n  };\n}\n"],"mappings":"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"}

package/dist/MemberPicker/dialog/useUserGroupCandidates.d.ts

@@ -0,0 +1,29 @@
+import { IUserGroup } from '../../ConfigProvider/getUserList.js';
+export interface IUserGroupCandidatesResult {
+    breadcrumbPath: IUserGroup[];
+    items: IUserGroup[];
+    keyword: string;
+    pathWarningCode?: string | null;
+    truncated?: boolean;
+    loading: boolean;
+    loadingMore: boolean;
+    error: boolean;
+    loadMoreError: boolean;
+    hasMore: boolean;
+    /** 当前层已保存的滚动位置，供候选面板在层级切换后恢复。 */
+    scrollTop: number;
+    setKeyword: (keyword: string) => void;
+    enterGroup: (group: IUserGroup, scrollTop: number) => void;
+    returnToBreadcrumb: (index: number, scrollTop: number) => void;
+    loadMore: () => void;
+    retry: () => void;
+    retryLoadMore: () => void;
+    updateScrollTop: (scrollTop: number) => void;
+}
+/**
+ * 管理受限用户组树与跨层搜索。
+ *
+ * 树层级缓存和搜索结果分别持有；所有异步响应都受版本号保护，关闭弹窗、
+ * 换词、清空或切换层级后，旧响应只能结束自身，不能覆盖当前界面。
+ */
+export declare function useUserGroupCandidates(): IUserGroupCandidatesResult;

package/dist/MemberPicker/dialog/useUserGroupCandidates.js

@@ -0,0 +1,443 @@
+import AldCustomConfigProvider from "../../ConfigProvider/index.js";
+import useDialogLocale from "./useDialogLocale.js";
+import { hasMoreGroupPages, mergeGroupPages } from "./helper.js";
+import "./types.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+//#region src/MemberPicker/dialog/useUserGroupCandidates.ts
+var GROUP_PAGE_SIZE = 100;
+var SEARCH_DEBOUNCE_MS = 300;
+var ROOT_BREADCRUMB_INDEX = -1;
+var createEmptyLevel = (parentGroupId) => ({
+	parentGroupId,
+	items: [],
+	pageNumber: 0,
+	hasMore: false,
+	scrollTop: 0,
+	loadingMore: false,
+	loadMoreError: false
+});
+var createEmptySearchState = (keyword = "") => ({
+	keyword,
+	items: [],
+	pageNumber: 0,
+	hasMore: false,
+	loading: false,
+	loadingMore: false,
+	error: false,
+	loadMoreError: false
+});
+var getLevelKey = (parentGroupId) => parentGroupId ?? "__ROOT_GROUP__";
+/**
+* 管理受限用户组树与跨层搜索。
+*
+* 树层级缓存和搜索结果分别持有；所有异步响应都受版本号保护，关闭弹窗、
+* 换词、清空或切换层级后，旧响应只能结束自身，不能覆盖当前界面。
+*/
+function useUserGroupCandidates() {
+	const t = useDialogLocale();
+	const { getMemberPickerGroupPage, getNextLevelGroup, getNextLevelGroupWithMeta } = AldCustomConfigProvider.useGetUserList();
+	const queryUserGroupsPage = useCallback(async (request) => {
+		if (getMemberPickerGroupPage) return getMemberPickerGroupPage(request);
+		const params = {
+			parentGroupId: request.parentGroupId,
+			keyword: request.keyword ?? ""
+		};
+		if (getNextLevelGroupWithMeta) {
+			const result = await getNextLevelGroupWithMeta(params);
+			return {
+				data: result.items,
+				pageNumber: request.pager.pageNumber,
+				hasMore: false,
+				pathWarningCode: result.pathWarningCode,
+				truncated: result.hasMore
+			};
+		}
+		if (getNextLevelGroup) return {
+			data: await getNextLevelGroup(params),
+			pageNumber: request.pager.pageNumber,
+			hasMore: false
+		};
+		throw new Error(t.MemberPickerDialog.missingGroupSource);
+	}, [
+		getMemberPickerGroupPage,
+		getNextLevelGroup,
+		getNextLevelGroupWithMeta,
+		t.MemberPickerDialog.missingGroupSource
+	]);
+	const [breadcrumbPath, setBreadcrumbPath] = useState([]);
+	const breadcrumbPathRef = useRef([]);
+	const [levelsByParent, setLevelsByParent] = useState(/* @__PURE__ */ new Map());
+	const levelsByParentRef = useRef(levelsByParent);
+	const activeParentGroupIdRef = useRef(void 0);
+	const [treeLoading, setTreeLoading] = useState(true);
+	const [treeError, setTreeError] = useState(false);
+	const [keyword, setKeywordState] = useState("");
+	const keywordRef = useRef("");
+	const [searchState, setSearchState] = useState(() => createEmptySearchState());
+	const searchStateRef = useRef(searchState);
+	const requestVersionRef = useRef(0);
+	const mountedRef = useRef(true);
+	const searchEffectInitializedRef = useRef(false);
+	const updateLevels = useCallback((updater) => {
+		setLevelsByParent((currentLevels) => {
+			const nextLevels = updater(currentLevels);
+			levelsByParentRef.current = nextLevels;
+			return nextLevels;
+		});
+	}, []);
+	const cancelTreePagination = useCallback(() => {
+		updateLevels((levels) => new Map(Array.from(levels, ([key, level]) => [key, level.loadingMore ? {
+			...level,
+			loadingMore: false
+		} : level])));
+	}, [updateLevels]);
+	const updateSearchState = useCallback((updater_0) => {
+		setSearchState((currentState) => {
+			const nextState = updater_0(currentState);
+			searchStateRef.current = nextState;
+			return nextState;
+		});
+	}, []);
+	const isCurrentRequest = useCallback((version) => mountedRef.current && requestVersionRef.current === version, []);
+	const loadTreeFirstPage = useCallback((parentGroupId) => {
+		const version_0 = requestVersionRef.current + 1;
+		requestVersionRef.current = version_0;
+		setTreeLoading(true);
+		setTreeError(false);
+		queryUserGroupsPage({
+			parentGroupId,
+			keyword: void 0,
+			pager: {
+				pageNumber: 1,
+				pageSize: GROUP_PAGE_SIZE
+			}
+		}).then((page) => {
+			if (!isCurrentRequest(version_0)) return;
+			updateLevels((currentLevels_0) => {
+				const key_0 = getLevelKey(parentGroupId);
+				const previousLevel = currentLevels_0.get(key_0);
+				return new Map(currentLevels_0).set(key_0, {
+					parentGroupId,
+					items: [...page.data],
+					pageNumber: page.pageNumber,
+					hasMore: hasMoreGroupPages(page),
+					pathWarningCode: page.pathWarningCode,
+					truncated: page.truncated,
+					scrollTop: previousLevel?.scrollTop ?? 0,
+					loadingMore: false,
+					loadMoreError: false
+				});
+			});
+			setTreeLoading(false);
+		}).catch(() => {
+			if (!isCurrentRequest(version_0)) return;
+			setTreeLoading(false);
+			setTreeError(true);
+		});
+	}, [
+		isCurrentRequest,
+		queryUserGroupsPage,
+		updateLevels
+	]);
+	useEffect(() => {
+		mountedRef.current = true;
+		loadTreeFirstPage();
+		return () => {
+			mountedRef.current = false;
+			requestVersionRef.current += 1;
+		};
+	}, [loadTreeFirstPage]);
+	useEffect(() => {
+		if (!searchEffectInitializedRef.current) {
+			searchEffectInitializedRef.current = true;
+			return;
+		}
+		const normalizedKeyword = keyword.trim();
+		cancelTreePagination();
+		const version_1 = requestVersionRef.current + 1;
+		requestVersionRef.current = version_1;
+		if (!normalizedKeyword) {
+			updateSearchState(() => createEmptySearchState(keyword));
+			const activeKey = getLevelKey(activeParentGroupIdRef.current);
+			if (!levelsByParentRef.current.has(activeKey)) loadTreeFirstPage(activeParentGroupIdRef.current);
+			else {
+				setTreeLoading(false);
+				setTreeError(false);
+			}
+			return;
+		}
+		updateSearchState(() => ({
+			...createEmptySearchState(normalizedKeyword),
+			loading: true
+		}));
+		const timer = window.setTimeout(() => {
+			queryUserGroupsPage({
+				parentGroupId: void 0,
+				keyword: normalizedKeyword,
+				pager: {
+					pageNumber: 1,
+					pageSize: GROUP_PAGE_SIZE
+				}
+			}).then((page_0) => {
+				if (!isCurrentRequest(version_1)) return;
+				updateSearchState((currentState_0) => ({
+					...currentState_0,
+					keyword: normalizedKeyword,
+					items: [...page_0.data],
+					pageNumber: page_0.pageNumber,
+					hasMore: hasMoreGroupPages(page_0),
+					pathWarningCode: page_0.pathWarningCode,
+					truncated: page_0.truncated,
+					loading: false,
+					error: false
+				}));
+			}).catch(() => {
+				if (!isCurrentRequest(version_1)) return;
+				updateSearchState((currentState_1) => ({
+					...currentState_1,
+					loading: false,
+					error: true
+				}));
+			});
+		}, SEARCH_DEBOUNCE_MS);
+		return () => window.clearTimeout(timer);
+	}, [
+		cancelTreePagination,
+		isCurrentRequest,
+		keyword,
+		loadTreeFirstPage,
+		queryUserGroupsPage,
+		updateSearchState
+	]);
+	const updateCurrentLevel = useCallback((updater_1) => {
+		const parentGroupId_0 = activeParentGroupIdRef.current;
+		const key_1 = getLevelKey(parentGroupId_0);
+		updateLevels((currentLevels_1) => {
+			const level_0 = currentLevels_1.get(key_1) ?? createEmptyLevel(parentGroupId_0);
+			return new Map(currentLevels_1).set(key_1, updater_1(level_0));
+		});
+	}, [updateLevels]);
+	const updateScrollTop = useCallback((scrollTop) => {
+		updateCurrentLevel((level_1) => ({
+			...level_1,
+			scrollTop
+		}));
+	}, [updateCurrentLevel]);
+	const enterGroup = useCallback((group, scrollTop_0) => {
+		updateScrollTop(scrollTop_0);
+		cancelTreePagination();
+		const nextBreadcrumbPath = [...breadcrumbPathRef.current, group];
+		breadcrumbPathRef.current = nextBreadcrumbPath;
+		setBreadcrumbPath(nextBreadcrumbPath);
+		activeParentGroupIdRef.current = group.groupId;
+		const nextKey = getLevelKey(group.groupId);
+		requestVersionRef.current += 1;
+		if (levelsByParentRef.current.has(nextKey)) {
+			setTreeLoading(false);
+			setTreeError(false);
+			return;
+		}
+		loadTreeFirstPage(group.groupId);
+	}, [
+		cancelTreePagination,
+		loadTreeFirstPage,
+		updateScrollTop
+	]);
+	const returnToBreadcrumb = useCallback((index, scrollTop_1) => {
+		updateScrollTop(scrollTop_1);
+		cancelTreePagination();
+		const currentPath = breadcrumbPathRef.current;
+		const nextPath = index === ROOT_BREADCRUMB_INDEX ? [] : currentPath.slice(0, index + 1);
+		const parentGroupId_1 = nextPath[nextPath.length - 1]?.groupId;
+		breadcrumbPathRef.current = nextPath;
+		setBreadcrumbPath(nextPath);
+		activeParentGroupIdRef.current = parentGroupId_1;
+		requestVersionRef.current += 1;
+		const targetKey = getLevelKey(parentGroupId_1);
+		if (levelsByParentRef.current.has(targetKey)) {
+			setTreeLoading(false);
+			setTreeError(false);
+			return;
+		}
+		loadTreeFirstPage(parentGroupId_1);
+	}, [
+		cancelTreePagination,
+		loadTreeFirstPage,
+		updateScrollTop
+	]);
+	const loadTreeMore = useCallback(() => {
+		const parentGroupId_2 = activeParentGroupIdRef.current;
+		const key_2 = getLevelKey(parentGroupId_2);
+		const level_2 = levelsByParentRef.current.get(key_2);
+		if (!level_2 || !level_2.hasMore || level_2.loadingMore) return;
+		const nextPageNumber = level_2.pageNumber + 1;
+		const version_2 = requestVersionRef.current + 1;
+		requestVersionRef.current = version_2;
+		updateCurrentLevel((currentLevel) => ({
+			...currentLevel,
+			loadingMore: true,
+			loadMoreError: false
+		}));
+		queryUserGroupsPage({
+			parentGroupId: parentGroupId_2,
+			keyword: void 0,
+			pager: {
+				pageNumber: nextPageNumber,
+				pageSize: GROUP_PAGE_SIZE
+			}
+		}).then((page_1) => {
+			if (!isCurrentRequest(version_2)) return;
+			updateCurrentLevel((currentLevel_0) => ({
+				...currentLevel_0,
+				items: mergeGroupPages(currentLevel_0.items, page_1.data),
+				pageNumber: page_1.pageNumber,
+				hasMore: hasMoreGroupPages(page_1),
+				pathWarningCode: currentLevel_0.pathWarningCode || page_1.pathWarningCode,
+				truncated: currentLevel_0.truncated || page_1.truncated,
+				loadingMore: false,
+				loadMoreError: false
+			}));
+		}).catch(() => {
+			if (!isCurrentRequest(version_2)) return;
+			updateCurrentLevel((currentLevel_1) => ({
+				...currentLevel_1,
+				loadingMore: false,
+				loadMoreError: true
+			}));
+		});
+	}, [
+		isCurrentRequest,
+		queryUserGroupsPage,
+		updateCurrentLevel
+	]);
+	const loadSearchMore = useCallback(() => {
+		const currentSearch = searchStateRef.current;
+		const normalizedKeyword_0 = keywordRef.current.trim();
+		if (!normalizedKeyword_0 || currentSearch.loading || !currentSearch.hasMore || currentSearch.loadingMore) return;
+		const nextPageNumber_0 = currentSearch.pageNumber + 1;
+		const version_3 = requestVersionRef.current + 1;
+		requestVersionRef.current = version_3;
+		updateSearchState((state) => ({
+			...state,
+			loadingMore: true,
+			loadMoreError: false
+		}));
+		queryUserGroupsPage({
+			parentGroupId: void 0,
+			keyword: normalizedKeyword_0,
+			pager: {
+				pageNumber: nextPageNumber_0,
+				pageSize: GROUP_PAGE_SIZE
+			}
+		}).then((page_2) => {
+			if (!isCurrentRequest(version_3)) return;
+			updateSearchState((state_0) => ({
+				...state_0,
+				items: mergeGroupPages(state_0.items, page_2.data),
+				pageNumber: page_2.pageNumber,
+				hasMore: hasMoreGroupPages(page_2),
+				pathWarningCode: state_0.pathWarningCode || page_2.pathWarningCode,
+				truncated: state_0.truncated || page_2.truncated,
+				loadingMore: false,
+				loadMoreError: false
+			}));
+		}).catch(() => {
+			if (!isCurrentRequest(version_3)) return;
+			updateSearchState((state_1) => ({
+				...state_1,
+				loadingMore: false,
+				loadMoreError: true
+			}));
+		});
+	}, [
+		isCurrentRequest,
+		queryUserGroupsPage,
+		updateSearchState
+	]);
+	const setKeyword = useCallback((nextKeyword) => {
+		keywordRef.current = nextKeyword;
+		setKeywordState(nextKeyword);
+	}, []);
+	const isSearching = keyword.trim().length > 0;
+	const loadMore = useCallback(() => {
+		if (keywordRef.current.trim()) {
+			loadSearchMore();
+			return;
+		}
+		loadTreeMore();
+	}, [loadSearchMore, loadTreeMore]);
+	const retry = useCallback(() => {
+		const normalizedKeyword_1 = keywordRef.current.trim();
+		if (normalizedKeyword_1) {
+			const version_4 = requestVersionRef.current + 1;
+			requestVersionRef.current = version_4;
+			updateSearchState((state_2) => ({
+				...state_2,
+				loading: true,
+				loadingMore: false,
+				loadMoreError: false,
+				hasMore: false,
+				error: false
+			}));
+			queryUserGroupsPage({
+				parentGroupId: void 0,
+				keyword: normalizedKeyword_1,
+				pager: {
+					pageNumber: 1,
+					pageSize: GROUP_PAGE_SIZE
+				}
+			}).then((page_3) => {
+				if (!isCurrentRequest(version_4)) return;
+				updateSearchState((state_3) => ({
+					...state_3,
+					items: [...page_3.data],
+					pageNumber: page_3.pageNumber,
+					hasMore: hasMoreGroupPages(page_3),
+					pathWarningCode: page_3.pathWarningCode,
+					truncated: page_3.truncated,
+					loading: false,
+					error: false
+				}));
+			}).catch(() => {
+				if (!isCurrentRequest(version_4)) return;
+				updateSearchState((state_4) => ({
+					...state_4,
+					loading: false,
+					error: true
+				}));
+			});
+			return;
+		}
+		loadTreeFirstPage(activeParentGroupIdRef.current);
+	}, [
+		isCurrentRequest,
+		loadTreeFirstPage,
+		queryUserGroupsPage,
+		updateSearchState
+	]);
+	const currentLevel_2 = useMemo(() => levelsByParent.get(getLevelKey(activeParentGroupIdRef.current)), [levelsByParent]);
+	return {
+		breadcrumbPath,
+		pathWarningCode: isSearching ? searchState.pathWarningCode : currentLevel_2?.pathWarningCode,
+		truncated: isSearching ? searchState.truncated : currentLevel_2?.truncated,
+		items: isSearching ? searchState.items : currentLevel_2?.items ?? [],
+		keyword,
+		loading: isSearching ? searchState.loading : treeLoading,
+		loadingMore: isSearching ? searchState.loadingMore : currentLevel_2?.loadingMore ?? false,
+		error: isSearching ? searchState.error : treeError,
+		loadMoreError: isSearching ? searchState.loadMoreError : currentLevel_2?.loadMoreError ?? false,
+		hasMore: isSearching ? searchState.hasMore : currentLevel_2?.hasMore ?? false,
+		scrollTop: currentLevel_2?.scrollTop ?? 0,
+		setKeyword,
+		enterGroup,
+		returnToBreadcrumb,
+		loadMore,
+		retry,
+		retryLoadMore: loadMore,
+		updateScrollTop
+	};
+}
+//#endregion
+export { useUserGroupCandidates };
+
+//# sourceMappingURL=useUserGroupCandidates.js.map