@aloudata/aloudata-design 3.1.6 → 3.1.8

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

@@ -0,0 +1,27 @@
+import { EMemberPicker, TMemberPickerValue as MemberPickerValue } from '../interface';
+import { TUserGroupValue, TUserValue, TUser } from '../../ConfigProvider/getUserList';
+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]) => [key, hydratedByKey.get(key) ?? member])));
+		}).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) => {
+		setSelectedByKey((currentSelected) => removeSelectedMember(currentSelected, member, lockedIds));
+	}, [lockedIds]);
+	const toggleMember = useCallback((member) => {
+		if (isMemberLocked(member, lockedIds)) return;
+		setSelectedByKey((currentSelected) => {
+			const key = getMemberKey(member);
+			return currentSelected.has(key) ? removeSelectedMember(currentSelected, member, lockedIds) : addSelectedMember(currentSelected, member);
+		});
+	}, [lockedIds]);
+	const toggleMembers = useCallback((members, selected) => {
+		setSelectedByKey((currentSelected) => setMembersSelected(currentSelected, 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":[],"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';
+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();
+	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) => {
+		setSearchState((currentState) => {
+			const nextState = updater(currentState);
+			searchStateRef.current = nextState;
+			return nextState;
+		});
+	}, []);
+	const isCurrentRequest = useCallback((version) => mountedRef.current && requestVersionRef.current === version, []);
+	const loadTreeFirstPage = useCallback((parentGroupId) => {
+		const version = requestVersionRef.current + 1;
+		requestVersionRef.current = version;
+		setTreeLoading(true);
+		setTreeError(false);
+		queryUserGroupsPage({
+			parentGroupId,
+			keyword: void 0,
+			pager: {
+				pageNumber: 1,
+				pageSize: GROUP_PAGE_SIZE
+			}
+		}).then((page) => {
+			if (!isCurrentRequest(version)) return;
+			updateLevels((currentLevels) => {
+				const key = getLevelKey(parentGroupId);
+				const previousLevel = currentLevels.get(key);
+				return new Map(currentLevels).set(key, {
+					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)) 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 = requestVersionRef.current + 1;
+		requestVersionRef.current = version;
+		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) => {
+				if (!isCurrentRequest(version)) return;
+				updateSearchState((currentState) => ({
+					...currentState,
+					keyword: normalizedKeyword,
+					items: [...page.data],
+					pageNumber: page.pageNumber,
+					hasMore: hasMoreGroupPages(page),
+					pathWarningCode: page.pathWarningCode,
+					truncated: page.truncated,
+					loading: false,
+					error: false
+				}));
+			}).catch(() => {
+				if (!isCurrentRequest(version)) return;
+				updateSearchState((currentState) => ({
+					...currentState,
+					loading: false,
+					error: true
+				}));
+			});
+		}, SEARCH_DEBOUNCE_MS);
+		return () => window.clearTimeout(timer);
+	}, [
+		cancelTreePagination,
+		isCurrentRequest,
+		keyword,
+		loadTreeFirstPage,
+		queryUserGroupsPage,
+		updateSearchState
+	]);
+	const updateCurrentLevel = useCallback((updater) => {
+		const parentGroupId = activeParentGroupIdRef.current;
+		const key = getLevelKey(parentGroupId);
+		updateLevels((currentLevels) => {
+			const level = currentLevels.get(key) ?? createEmptyLevel(parentGroupId);
+			return new Map(currentLevels).set(key, updater(level));
+		});
+	}, [updateLevels]);
+	const updateScrollTop = useCallback((scrollTop) => {
+		updateCurrentLevel((level) => ({
+			...level,
+			scrollTop
+		}));
+	}, [updateCurrentLevel]);
+	const enterGroup = useCallback((group, scrollTop) => {
+		updateScrollTop(scrollTop);
+		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) => {
+		updateScrollTop(scrollTop);
+		cancelTreePagination();
+		const currentPath = breadcrumbPathRef.current;
+		const nextPath = index === ROOT_BREADCRUMB_INDEX ? [] : currentPath.slice(0, index + 1);
+		const parentGroupId = nextPath[nextPath.length - 1]?.groupId;
+		breadcrumbPathRef.current = nextPath;
+		setBreadcrumbPath(nextPath);
+		activeParentGroupIdRef.current = parentGroupId;
+		requestVersionRef.current += 1;
+		const targetKey = getLevelKey(parentGroupId);
+		if (levelsByParentRef.current.has(targetKey)) {
+			setTreeLoading(false);
+			setTreeError(false);
+			return;
+		}
+		loadTreeFirstPage(parentGroupId);
+	}, [
+		cancelTreePagination,
+		loadTreeFirstPage,
+		updateScrollTop
+	]);
+	const loadTreeMore = useCallback(() => {
+		const parentGroupId = activeParentGroupIdRef.current;
+		const key = getLevelKey(parentGroupId);
+		const level = levelsByParentRef.current.get(key);
+		if (!level || !level.hasMore || level.loadingMore) return;
+		const nextPageNumber = level.pageNumber + 1;
+		const version = requestVersionRef.current + 1;
+		requestVersionRef.current = version;
+		updateCurrentLevel((currentLevel) => ({
+			...currentLevel,
+			loadingMore: true,
+			loadMoreError: false
+		}));
+		queryUserGroupsPage({
+			parentGroupId,
+			keyword: void 0,
+			pager: {
+				pageNumber: nextPageNumber,
+				pageSize: GROUP_PAGE_SIZE
+			}
+		}).then((page) => {
+			if (!isCurrentRequest(version)) return;
+			updateCurrentLevel((currentLevel) => ({
+				...currentLevel,
+				items: mergeGroupPages(currentLevel.items, page.data),
+				pageNumber: page.pageNumber,
+				hasMore: hasMoreGroupPages(page),
+				pathWarningCode: currentLevel.pathWarningCode || page.pathWarningCode,
+				truncated: currentLevel.truncated || page.truncated,
+				loadingMore: false,
+				loadMoreError: false
+			}));
+		}).catch(() => {
+			if (!isCurrentRequest(version)) return;
+			updateCurrentLevel((currentLevel) => ({
+				...currentLevel,
+				loadingMore: false,
+				loadMoreError: true
+			}));
+		});
+	}, [
+		isCurrentRequest,
+		queryUserGroupsPage,
+		updateCurrentLevel
+	]);
+	const loadSearchMore = useCallback(() => {
+		const currentSearch = searchStateRef.current;
+		const normalizedKeyword = keywordRef.current.trim();
+		if (!normalizedKeyword || currentSearch.loading || !currentSearch.hasMore || currentSearch.loadingMore) return;
+		const nextPageNumber = currentSearch.pageNumber + 1;
+		const version = requestVersionRef.current + 1;
+		requestVersionRef.current = version;
+		updateSearchState((state) => ({
+			...state,
+			loadingMore: true,
+			loadMoreError: false
+		}));
+		queryUserGroupsPage({
+			parentGroupId: void 0,
+			keyword: normalizedKeyword,
+			pager: {
+				pageNumber: nextPageNumber,
+				pageSize: GROUP_PAGE_SIZE
+			}
+		}).then((page) => {
+			if (!isCurrentRequest(version)) return;
+			updateSearchState((state) => ({
+				...state,
+				items: mergeGroupPages(state.items, page.data),
+				pageNumber: page.pageNumber,
+				hasMore: hasMoreGroupPages(page),
+				pathWarningCode: state.pathWarningCode || page.pathWarningCode,
+				truncated: state.truncated || page.truncated,
+				loadingMore: false,
+				loadMoreError: false
+			}));
+		}).catch(() => {
+			if (!isCurrentRequest(version)) return;
+			updateSearchState((state) => ({
+				...state,
+				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 = keywordRef.current.trim();
+		if (normalizedKeyword) {
+			const version = requestVersionRef.current + 1;
+			requestVersionRef.current = version;
+			updateSearchState((state) => ({
+				...state,
+				loading: true,
+				loadingMore: false,
+				loadMoreError: false,
+				hasMore: false,
+				error: false
+			}));
+			queryUserGroupsPage({
+				parentGroupId: void 0,
+				keyword: normalizedKeyword,
+				pager: {
+					pageNumber: 1,
+					pageSize: GROUP_PAGE_SIZE
+				}
+			}).then((page) => {
+				if (!isCurrentRequest(version)) return;
+				updateSearchState((state) => ({
+					...state,
+					items: [...page.data],
+					pageNumber: page.pageNumber,
+					hasMore: hasMoreGroupPages(page),
+					pathWarningCode: page.pathWarningCode,
+					truncated: page.truncated,
+					loading: false,
+					error: false
+				}));
+			}).catch(() => {
+				if (!isCurrentRequest(version)) return;
+				updateSearchState((state) => ({
+					...state,
+					loading: false,
+					error: true
+				}));
+			});
+			return;
+		}
+		loadTreeFirstPage(activeParentGroupIdRef.current);
+	}, [
+		isCurrentRequest,
+		loadTreeFirstPage,
+		queryUserGroupsPage,
+		updateSearchState
+	]);
+	const currentLevel = useMemo(() => levelsByParent.get(getLevelKey(activeParentGroupIdRef.current)), [levelsByParent]);
+	return {
+		breadcrumbPath,
+		pathWarningCode: isSearching ? searchState.pathWarningCode : currentLevel?.pathWarningCode,
+		truncated: isSearching ? searchState.truncated : currentLevel?.truncated,
+		items: isSearching ? searchState.items : currentLevel?.items ?? [],
+		keyword,
+		loading: isSearching ? searchState.loading : treeLoading,
+		loadingMore: isSearching ? searchState.loadingMore : currentLevel?.loadingMore ?? false,
+		error: isSearching ? searchState.error : treeError,
+		loadMoreError: isSearching ? searchState.loadMoreError : currentLevel?.loadMoreError ?? false,
+		hasMore: isSearching ? searchState.hasMore : currentLevel?.hasMore ?? false,
+		scrollTop: currentLevel?.scrollTop ?? 0,
+		setKeyword,
+		enterGroup,
+		returnToBreadcrumb,
+		loadMore,
+		retry,
+		retryLoadMore: loadMore,
+		updateScrollTop
+	};
+}
+//#endregion
+export { useUserGroupCandidates };
+
+//# sourceMappingURL=useUserGroupCandidates.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUserGroupCandidates.js","names":[],"sources":["../../../src/MemberPicker/dialog/useUserGroupCandidates.ts"],"sourcesContent":["import useDialogLocale from './useDialogLocale';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport ConfigProvider from '../../ConfigProvider';\nimport type {\n  IUserGroup,\n  MemberGroupPageRequest,\n  MemberGroupPage,\n} from '../../ConfigProvider/getUserList';\nimport { hasMoreGroupPages, mergeGroupPages } from './helper';\nimport {\n  ROOT_GROUP_CACHE_KEY,\n  type IGroupLevelCache,\n  type IGroupSearchState,\n} from './types';\n\nconst GROUP_PAGE_SIZE = 100;\nconst SEARCH_DEBOUNCE_MS = 300;\nconst ROOT_BREADCRUMB_INDEX = -1;\n\nconst createEmptyLevel = (parentGroupId?: string): IGroupLevelCache => ({\n  parentGroupId,\n  items: [],\n  pageNumber: 0,\n  hasMore: false,\n  scrollTop: 0,\n  loadingMore: false,\n  loadMoreError: false,\n});\n\nconst createEmptySearchState = (keyword = ''): IGroupSearchState => ({\n  keyword,\n  items: [],\n  pageNumber: 0,\n  hasMore: false,\n  loading: false,\n  loadingMore: false,\n  error: false,\n  loadMoreError: false,\n});\n\nconst getLevelKey = (parentGroupId?: string): string =>\n  parentGroupId ?? ROOT_GROUP_CACHE_KEY;\n\nexport interface IUserGroupCandidatesResult {\n  breadcrumbPath: IUserGroup[];\n  items: IUserGroup[];\n  keyword: string;\n  pathWarningCode?: string | null;\n  truncated?: boolean;\n  loading: boolean;\n  loadingMore: boolean;\n  error: boolean;\n  loadMoreError: boolean;\n  hasMore: boolean;\n  /** 当前层已保存的滚动位置，供候选面板在层级切换后恢复。 */\n  scrollTop: number;\n  setKeyword: (keyword: string) => void;\n  enterGroup: (group: IUserGroup, scrollTop: number) => void;\n  returnToBreadcrumb: (index: number, scrollTop: number) => void;\n  loadMore: () => void;\n  retry: () => void;\n  retryLoadMore: () => void;\n  updateScrollTop: (scrollTop: number) => void;\n}\n\n/**\n * 管理受限用户组树与跨层搜索。\n *\n * 树层级缓存和搜索结果分别持有；所有异步响应都受版本号保护，关闭弹窗、\n * 换词、清空或切换层级后，旧响应只能结束自身，不能覆盖当前界面。\n */\nexport function useUserGroupCandidates(): IUserGroupCandidatesResult {\n  const t = useDialogLocale();\n  const {\n    getMemberPickerGroupPage,\n    getNextLevelGroup,\n    getNextLevelGroupWithMeta,\n  } = ConfigProvider.useGetUserList();\n  const queryUserGroupsPage = useCallback(\n    async (request: MemberGroupPageRequest): Promise<MemberGroupPage> => {\n      if (getMemberPickerGroupPage) return getMemberPickerGroupPage(request);\n      const params = {\n        parentGroupId: request.parentGroupId,\n        keyword: request.keyword ?? '',\n      };\n      if (getNextLevelGroupWithMeta) {\n        const result = await getNextLevelGroupWithMeta(params);\n        // 旧接口没有页码能力：保留截断提示，不反复获取同一页。\n        return {\n          data: result.items,\n          pageNumber: request.pager.pageNumber,\n          hasMore: false,\n          pathWarningCode: result.pathWarningCode,\n          truncated: result.hasMore,\n        };\n      }\n      if (getNextLevelGroup)\n        return {\n          data: await getNextLevelGroup(params),\n          pageNumber: request.pager.pageNumber,\n          hasMore: false,\n        };\n      throw new Error(t.MemberPickerDialog.missingGroupSource);\n    },\n    [\n      getMemberPickerGroupPage,\n      getNextLevelGroup,\n      getNextLevelGroupWithMeta,\n      t.MemberPickerDialog.missingGroupSource,\n    ],\n  );\n  const [breadcrumbPath, setBreadcrumbPath] = useState<IUserGroup[]>([]);\n  const breadcrumbPathRef = useRef<IUserGroup[]>([]);\n  const [levelsByParent, setLevelsByParent] = useState<\n    Map<string, IGroupLevelCache>\n  >(new Map());\n  const levelsByParentRef = useRef(levelsByParent);\n  const activeParentGroupIdRef = useRef<string>();\n  const [treeLoading, setTreeLoading] = useState(true);\n  const [treeError, setTreeError] = useState(false);\n  const [keyword, setKeywordState] = useState('');\n  const keywordRef = useRef('');\n  const [searchState, setSearchState] = useState<IGroupSearchState>(() =>\n    createEmptySearchState(),\n  );\n  const searchStateRef = useRef(searchState);\n  const requestVersionRef = useRef(0);\n  const mountedRef = useRef(true);\n  const searchEffectInitializedRef = useRef(false);\n\n  const updateLevels = useCallback(\n    (\n      updater: (\n        levels: Map<string, IGroupLevelCache>,\n      ) => Map<string, IGroupLevelCache>,\n    ) => {\n      setLevelsByParent((currentLevels) => {\n        const nextLevels = updater(currentLevels);\n        levelsByParentRef.current = nextLevels;\n        return nextLevels;\n      });\n    },\n    [],\n  );\n\n  // 切层或转搜索会废弃当前请求，同时释放缓存层的分页锁，返回该层仍可继续加载。\n  const cancelTreePagination = useCallback(() => {\n    updateLevels(\n      (levels) =>\n        new Map(\n          Array.from(levels, ([key, level]) => [\n            key,\n            level.loadingMore ? { ...level, loadingMore: false } : level,\n          ]),\n        ),\n    );\n  }, [updateLevels]);\n\n  const updateSearchState = useCallback(\n    (updater: (state: IGroupSearchState) => IGroupSearchState) => {\n      setSearchState((currentState) => {\n        const nextState = updater(currentState);\n        searchStateRef.current = nextState;\n        return nextState;\n      });\n    },\n    [],\n  );\n\n  const isCurrentRequest = useCallback(\n    (version: number): boolean =>\n      mountedRef.current && requestVersionRef.current === version,\n    [],\n  );\n\n  const loadTreeFirstPage = useCallback(\n    (parentGroupId?: string) => {\n      const version = requestVersionRef.current + 1;\n      requestVersionRef.current = version;\n      setTreeLoading(true);\n      setTreeError(false);\n      queryUserGroupsPage({\n        parentGroupId,\n        keyword: undefined,\n        pager: { pageNumber: 1, pageSize: GROUP_PAGE_SIZE },\n      })\n        .then((page) => {\n          if (!isCurrentRequest(version)) {\n            return;\n          }\n          updateLevels((currentLevels) => {\n            const key = getLevelKey(parentGroupId);\n            const previousLevel = currentLevels.get(key);\n            return new Map(currentLevels).set(key, {\n              parentGroupId,\n              items: [...page.data],\n              pageNumber: page.pageNumber,\n              hasMore: hasMoreGroupPages(page),\n              pathWarningCode: page.pathWarningCode,\n              truncated: page.truncated,\n              scrollTop: previousLevel?.scrollTop ?? 0,\n              loadingMore: false,\n              loadMoreError: false,\n            });\n          });\n          setTreeLoading(false);\n        })\n        .catch(() => {\n          if (!isCurrentRequest(version)) {\n            return;\n          }\n          setTreeLoading(false);\n          setTreeError(true);\n        });\n    },\n    [isCurrentRequest, queryUserGroupsPage, updateLevels],\n  );\n\n  useEffect(() => {\n    mountedRef.current = true;\n    loadTreeFirstPage();\n    return () => {\n      mountedRef.current = false;\n      requestVersionRef.current += 1;\n    };\n  }, [loadTreeFirstPage]);\n\n  useEffect(() => {\n    if (!searchEffectInitializedRef.current) {\n      searchEffectInitializedRef.current = true;\n      return undefined;\n    }\n\n    const normalizedKeyword = keyword.trim();\n    cancelTreePagination();\n    const version = requestVersionRef.current + 1;\n    requestVersionRef.current = version;\n    if (!normalizedKeyword) {\n      updateSearchState(() => createEmptySearchState(keyword));\n      const activeKey = getLevelKey(activeParentGroupIdRef.current);\n      if (!levelsByParentRef.current.has(activeKey)) {\n        loadTreeFirstPage(activeParentGroupIdRef.current);\n      } else {\n        setTreeLoading(false);\n        setTreeError(false);\n      }\n      return undefined;\n    }\n\n    updateSearchState(() => ({\n      ...createEmptySearchState(normalizedKeyword),\n      loading: true,\n    }));\n    const timer = window.setTimeout(() => {\n      queryUserGroupsPage({\n        parentGroupId: undefined,\n        keyword: normalizedKeyword,\n        pager: { pageNumber: 1, pageSize: GROUP_PAGE_SIZE },\n      })\n        .then((page) => {\n          if (!isCurrentRequest(version)) {\n            return;\n          }\n          updateSearchState((currentState) => ({\n            ...currentState,\n            keyword: normalizedKeyword,\n            items: [...page.data],\n            pageNumber: page.pageNumber,\n            hasMore: hasMoreGroupPages(page),\n            pathWarningCode: page.pathWarningCode,\n            truncated: page.truncated,\n            loading: false,\n            error: false,\n          }));\n        })\n        .catch(() => {\n          if (!isCurrentRequest(version)) {\n            return;\n          }\n          updateSearchState((currentState) => ({\n            ...currentState,\n            loading: false,\n            error: true,\n          }));\n        });\n    }, SEARCH_DEBOUNCE_MS);\n\n    return () => window.clearTimeout(timer);\n  }, [\n    cancelTreePagination,\n    isCurrentRequest,\n    keyword,\n    loadTreeFirstPage,\n    queryUserGroupsPage,\n    updateSearchState,\n  ]);\n\n  const updateCurrentLevel = useCallback(\n    (updater: (level: IGroupLevelCache) => IGroupLevelCache) => {\n      const parentGroupId = activeParentGroupIdRef.current;\n      const key = getLevelKey(parentGroupId);\n      updateLevels((currentLevels) => {\n        const level = currentLevels.get(key) ?? createEmptyLevel(parentGroupId);\n        return new Map(currentLevels).set(key, updater(level));\n      });\n    },\n    [updateLevels],\n  );\n\n  const updateScrollTop = useCallback(\n    (scrollTop: number) => {\n      updateCurrentLevel((level) => ({ ...level, scrollTop }));\n    },\n    [updateCurrentLevel],\n  );\n\n  const enterGroup = useCallback(\n    (group: IUserGroup, scrollTop: number) => {\n      updateScrollTop(scrollTop);\n      cancelTreePagination();\n      const nextBreadcrumbPath = [...breadcrumbPathRef.current, group];\n      breadcrumbPathRef.current = nextBreadcrumbPath;\n      setBreadcrumbPath(nextBreadcrumbPath);\n      activeParentGroupIdRef.current = group.groupId;\n      const nextKey = getLevelKey(group.groupId);\n      requestVersionRef.current += 1;\n      if (levelsByParentRef.current.has(nextKey)) {\n        setTreeLoading(false);\n        setTreeError(false);\n        return;\n      }\n      loadTreeFirstPage(group.groupId);\n    },\n    [cancelTreePagination, loadTreeFirstPage, updateScrollTop],\n  );\n\n  const returnToBreadcrumb = useCallback(\n    (index: number, scrollTop: number) => {\n      updateScrollTop(scrollTop);\n      cancelTreePagination();\n      const currentPath = breadcrumbPathRef.current;\n      const nextPath =\n        index === ROOT_BREADCRUMB_INDEX ? [] : currentPath.slice(0, index + 1);\n      const parentGroupId = nextPath[nextPath.length - 1]?.groupId;\n      breadcrumbPathRef.current = nextPath;\n      setBreadcrumbPath(nextPath);\n      activeParentGroupIdRef.current = parentGroupId;\n      requestVersionRef.current += 1;\n      const targetKey = getLevelKey(parentGroupId);\n      if (levelsByParentRef.current.has(targetKey)) {\n        setTreeLoading(false);\n        setTreeError(false);\n        return;\n      }\n      loadTreeFirstPage(parentGroupId);\n    },\n    [cancelTreePagination, loadTreeFirstPage, updateScrollTop],\n  );\n\n  const loadTreeMore = useCallback(() => {\n    const parentGroupId = activeParentGroupIdRef.current;\n    const key = getLevelKey(parentGroupId);\n    const level = levelsByParentRef.current.get(key);\n    if (!level || !level.hasMore || level.loadingMore) {\n      return;\n    }\n    const nextPageNumber = level.pageNumber + 1;\n    const version = requestVersionRef.current + 1;\n    requestVersionRef.current = version;\n    updateCurrentLevel((currentLevel) => ({\n      ...currentLevel,\n      loadingMore: true,\n      loadMoreError: false,\n    }));\n    queryUserGroupsPage({\n      parentGroupId,\n      keyword: undefined,\n      pager: { pageNumber: nextPageNumber, pageSize: GROUP_PAGE_SIZE },\n    })\n      .then((page) => {\n        if (!isCurrentRequest(version)) {\n          return;\n        }\n        updateCurrentLevel((currentLevel) => ({\n          ...currentLevel,\n          items: mergeGroupPages(currentLevel.items, page.data),\n          pageNumber: page.pageNumber,\n          hasMore: hasMoreGroupPages(page),\n          pathWarningCode: currentLevel.pathWarningCode || page.pathWarningCode,\n          truncated: currentLevel.truncated || page.truncated,\n          loadingMore: false,\n          loadMoreError: false,\n        }));\n      })\n      .catch(() => {\n        if (!isCurrentRequest(version)) {\n          return;\n        }\n        updateCurrentLevel((currentLevel) => ({\n          ...currentLevel,\n          loadingMore: false,\n          loadMoreError: true,\n        }));\n      });\n  }, [isCurrentRequest, queryUserGroupsPage, updateCurrentLevel]);\n\n  const loadSearchMore = useCallback(() => {\n    const currentSearch = searchStateRef.current;\n    const normalizedKeyword = keywordRef.current.trim();\n    if (\n      !normalizedKeyword ||\n      currentSearch.loading ||\n      !currentSearch.hasMore ||\n      currentSearch.loadingMore\n    ) {\n      return;\n    }\n    const nextPageNumber = currentSearch.pageNumber + 1;\n    const version = requestVersionRef.current + 1;\n    requestVersionRef.current = version;\n    updateSearchState((state) => ({\n      ...state,\n      loadingMore: true,\n      loadMoreError: false,\n    }));\n    queryUserGroupsPage({\n      parentGroupId: undefined,\n      keyword: normalizedKeyword,\n      pager: { pageNumber: nextPageNumber, pageSize: GROUP_PAGE_SIZE },\n    })\n      .then((page) => {\n        if (!isCurrentRequest(version)) {\n          return;\n        }\n        updateSearchState((state) => ({\n          ...state,\n          items: mergeGroupPages(state.items, page.data),\n          pageNumber: page.pageNumber,\n          hasMore: hasMoreGroupPages(page),\n          pathWarningCode: state.pathWarningCode || page.pathWarningCode,\n          truncated: state.truncated || page.truncated,\n          loadingMore: false,\n          loadMoreError: false,\n        }));\n      })\n      .catch(() => {\n        if (!isCurrentRequest(version)) {\n          return;\n        }\n        updateSearchState((state) => ({\n          ...state,\n          loadingMore: false,\n          loadMoreError: true,\n        }));\n      });\n  }, [isCurrentRequest, queryUserGroupsPage, updateSearchState]);\n\n  const setKeyword = useCallback((nextKeyword: string) => {\n    keywordRef.current = nextKeyword;\n    setKeywordState(nextKeyword);\n  }, []);\n\n  const isSearching = keyword.trim().length > 0;\n  const loadMore = useCallback(() => {\n    if (keywordRef.current.trim()) {\n      loadSearchMore();\n      return;\n    }\n    loadTreeMore();\n  }, [loadSearchMore, loadTreeMore]);\n\n  const retry = useCallback(() => {\n    const normalizedKeyword = keywordRef.current.trim();\n    if (normalizedKeyword) {\n      const version = requestVersionRef.current + 1;\n      requestVersionRef.current = version;\n      updateSearchState((state) => ({\n        ...state,\n        loading: true,\n        loadingMore: false,\n        loadMoreError: false,\n        hasMore: false,\n        error: false,\n      }));\n      queryUserGroupsPage({\n        parentGroupId: undefined,\n        keyword: normalizedKeyword,\n        pager: { pageNumber: 1, pageSize: GROUP_PAGE_SIZE },\n      })\n        .then((page) => {\n          if (!isCurrentRequest(version)) {\n            return;\n          }\n          updateSearchState((state) => ({\n            ...state,\n            items: [...page.data],\n            pageNumber: page.pageNumber,\n            hasMore: hasMoreGroupPages(page),\n            pathWarningCode: page.pathWarningCode,\n            truncated: page.truncated,\n            loading: false,\n            error: false,\n          }));\n        })\n        .catch(() => {\n          if (!isCurrentRequest(version)) {\n            return;\n          }\n          updateSearchState((state) => ({\n            ...state,\n            loading: false,\n            error: true,\n          }));\n        });\n      return;\n    }\n    loadTreeFirstPage(activeParentGroupIdRef.current);\n  }, [\n    isCurrentRequest,\n    loadTreeFirstPage,\n    queryUserGroupsPage,\n    updateSearchState,\n  ]);\n\n  const currentLevel = useMemo(\n    () => levelsByParent.get(getLevelKey(activeParentGroupIdRef.current)),\n    [levelsByParent],\n  );\n\n  return {\n    breadcrumbPath,\n    pathWarningCode: isSearching\n      ? searchState.pathWarningCode\n      : currentLevel?.pathWarningCode,\n    truncated: isSearching ? searchState.truncated : currentLevel?.truncated,\n    items: isSearching ? searchState.items : currentLevel?.items ?? [],\n    keyword,\n    loading: isSearching ? searchState.loading : treeLoading,\n    loadingMore: isSearching\n      ? searchState.loadingMore\n      : currentLevel?.loadingMore ?? false,\n    error: isSearching ? searchState.error : treeError,\n    loadMoreError: isSearching\n      ? searchState.loadMoreError\n      : currentLevel?.loadMoreError ?? false,\n    hasMore: isSearching ? searchState.hasMore : currentLevel?.hasMore ?? false,\n    scrollTop: currentLevel?.scrollTop ?? 0,\n    setKeyword,\n    enterGroup,\n    returnToBreadcrumb,\n    loadMore,\n    retry,\n    retryLoadMore: loadMore,\n    updateScrollTop,\n  };\n}\n"],"mappings":"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"}

package/dist/MemberPicker/index.d.ts

@@ -1,7 +1,9 @@
+import { default as MemberPickerDialog } from './dialog/MemberPickerDialog.js';
 import { default as React } from 'react';
 import { default as MemberPanel } from './components/PanelWrapper.js';
 import { IMemberPickerProps } from './interface.js';
 declare const MemberSelector: React.FC<IMemberPickerProps> & {
     MemberPanel: typeof MemberPanel;
+    Dialog: typeof MemberPickerDialog;
 };
 export default MemberSelector;