@aloudata/aloudata-design 3.1.5 → 3.1.7

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

@@ -0,0 +1,13 @@
+import { IMemberPickerProps as MemberPickerProps } from '../interface';
+import { TMember, TMemberKey } from './types.js';
+interface IProps {
+    selectedByKey: ReadonlyMap<TMemberKey, TMember>;
+    onToggle: (member: TMember) => void;
+    onToggleAll: (members: readonly TMember[], selected: boolean) => void;
+    lockedIds?: MemberPickerProps['lockedIds'];
+    filterItem?: MemberPickerProps['filterItem'];
+    renderItem?: MemberPickerProps['renderItem'];
+}
+/** 用户组树与跨层搜索共用选择事实源，但互不重置彼此的浏览状态。 */
+export default function UserGroupCandidatePanel({ selectedByKey, onToggle, onToggleAll, lockedIds, filterItem, renderItem, }: IProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/MemberPicker/dialog/UserGroupCandidatePanel.js

@@ -0,0 +1,134 @@
+import Breadcrumb from "../../Breadcrumb/index.js";
+import Button_default from "../../Button/index.js";
+import Checkbox from "../../Checkbox/index.js";
+import InputSearch from "../../InputSearch/index.js";
+import Empty from "../../Empty/index.js";
+import CustomSpin from "../../Spin/index.js";
+import useDialogLocale from "./useDialogLocale.js";
+import { getMemberKey, isMemberLocked } from "./helper.js";
+import MemberOption from "./MemberOption.js";
+import SearchFeedback from "../components/SearchFeedback.js";
+import { useUserGroupCandidates } from "./useUserGroupCandidates.js";
+import { useEffect, useMemo, useRef } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/MemberPicker/dialog/UserGroupCandidatePanel.tsx
+var LOAD_MORE_THRESHOLD = 32;
+var ROOT_BREADCRUMB_INDEX = -1;
+/** 用户组树与跨层搜索共用选择事实源，但互不重置彼此的浏览状态。 */
+function UserGroupCandidatePanel({ selectedByKey, onToggle, onToggleAll, lockedIds = [], filterItem, renderItem }) {
+	const t = useDialogLocale();
+	const candidates = useUserGroupCandidates();
+	const listRef = useRef(null);
+	const isSearching = candidates.keyword.trim().length > 0;
+	const groups = useMemo(() => candidates.items.filter((group) => filterItem ? filterItem(group) : true), [candidates.items, filterItem]);
+	const selectableGroups = groups.filter((group) => !isMemberLocked(group, lockedIds));
+	const selectedCount = selectableGroups.filter((group) => selectedByKey.has(getMemberKey(group))).length;
+	const allSelected = selectableGroups.length > 0 && selectedCount === selectableGroups.length;
+	const partiallySelected = selectedCount > 0 && !allSelected;
+	useEffect(() => {
+		if (!isSearching && listRef.current) listRef.current.scrollTop = candidates.scrollTop;
+	}, [
+		candidates.breadcrumbPath,
+		candidates.scrollTop,
+		isSearching
+	]);
+	return /* @__PURE__ */ jsxs("section", {
+		className: "tw-flex tw-h-full tw-min-h-0 tw-flex-col",
+		"data-testid": "user-group-candidate-panel",
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: "tw-shrink-0 tw-border-b tw-border-solid tw-border-border-default tw-p-sp-150",
+				children: /* @__PURE__ */ jsxs("div", {
+					className: "tw-flex tw-min-w-0 tw-flex-col tw-gap-sp-150",
+					children: [
+						!isSearching && candidates.breadcrumbPath.length > 0 ? /* @__PURE__ */ jsx(Breadcrumb, {
+							className: "tw-min-w-0 tw-flex-wrap",
+							items: [{
+								title: t.MemberPickerDialog.root,
+								onClick: () => candidates.returnToBreadcrumb(ROOT_BREADCRUMB_INDEX, listRef.current?.scrollTop ?? 0)
+							}, ...candidates.breadcrumbPath.map((group, index) => ({
+								title: group.name,
+								onClick: () => candidates.returnToBreadcrumb(index, listRef.current?.scrollTop ?? 0)
+							}))]
+						}) : null,
+						/* @__PURE__ */ jsx(InputSearch, {
+							inputMode: true,
+							size: "middle",
+							className: "tw-w-full",
+							debounce: false,
+							value: candidates.keyword,
+							placeholder: t.MemberPickerDialog.searchGroupsPlaceholder,
+							onChange: candidates.setKeyword,
+							onSearch: candidates.setKeyword
+						}),
+						/* @__PURE__ */ jsx(Checkbox, {
+							size: "small",
+							className: "tw-self-start",
+							checked: allSelected,
+							indeterminate: partiallySelected,
+							disabled: candidates.loading || candidates.error || selectableGroups.length === 0,
+							onChange: (event) => onToggleAll(selectableGroups, event.target.checked),
+							children: allSelected ? t.MemberPickerDialog.deselectCurrent(groups.length) : t.MemberPickerDialog.selectCurrent(groups.length)
+						})
+					]
+				})
+			}),
+			/* @__PURE__ */ jsx(SearchFeedback, {
+				pathWarningCode: candidates.pathWarningCode,
+				hasMore: candidates.truncated,
+				retry: candidates.retry
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				ref: listRef,
+				className: "tw-min-h-0 tw-flex-1 tw-overflow-auto tw-py-sp-100",
+				onScroll: (event) => {
+					const target = event.currentTarget;
+					if (!isSearching) candidates.updateScrollTop(target.scrollTop);
+					if (target.scrollHeight - target.scrollTop - target.clientHeight <= LOAD_MORE_THRESHOLD) candidates.loadMore();
+				},
+				children: [
+					candidates.loading ? /* @__PURE__ */ jsx(CustomSpin, {}) : null,
+					candidates.error ? /* @__PURE__ */ jsxs("div", {
+						className: "tw-flex tw-h-full tw-flex-col tw-items-center tw-justify-center tw-gap-2",
+						children: [/* @__PURE__ */ jsx("span", { children: t.MemberPickerDialog.loadFailed }), /* @__PURE__ */ jsx(Button_default, {
+							type: "link",
+							onClick: candidates.retry,
+							children: t.MemberPickerDialog.retry
+						})]
+					}) : null,
+					!candidates.loading && !candidates.error && !groups.length ? /* @__PURE__ */ jsx(Empty, { description: t.MemberPickerDialog.emptyCandidates }) : null,
+					!candidates.loading && !candidates.error ? groups.map((group) => /* @__PURE__ */ jsx(MemberOption, {
+						member: group,
+						searchValue: candidates.keyword,
+						selected: selectedByKey.has(getMemberKey(group)),
+						locked: isMemberLocked(group, lockedIds),
+						onToggle,
+						onOpenGroup: isSearching ? void 0 : () => {
+							const sourceGroup = candidates.items.find((item) => item.groupId === group.groupId);
+							if (sourceGroup) candidates.enterGroup(sourceGroup, listRef.current?.scrollTop ?? 0);
+						},
+						renderItem
+					}, group.groupId)) : null,
+					!candidates.loading && !candidates.error && candidates.hasMore && !candidates.loadMoreError ? /* @__PURE__ */ jsx(Button_default, {
+						type: "link",
+						loading: candidates.loadingMore,
+						onClick: candidates.loadMore,
+						children: t.MemberPickerDialog.loadMore
+					}) : null,
+					candidates.loadMoreError ? /* @__PURE__ */ jsxs("div", {
+						className: "tw-flex tw-items-center tw-justify-center tw-gap-2 tw-py-2",
+						children: [/* @__PURE__ */ jsx("span", { children: t.MemberPickerDialog.loadMoreFailed }), /* @__PURE__ */ jsx(Button_default, {
+							type: "link",
+							onClick: candidates.retryLoadMore,
+							children: t.MemberPickerDialog.retry
+						})]
+					}) : null
+				]
+			})
+		]
+	});
+}
+//#endregion
+export { UserGroupCandidatePanel as default };
+
+//# sourceMappingURL=UserGroupCandidatePanel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UserGroupCandidatePanel.js","names":[],"sources":["../../../src/MemberPicker/dialog/UserGroupCandidatePanel.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef } from 'react';\nimport Breadcrumb from '../../Breadcrumb';\nimport Button from '../../Button';\nimport Checkbox from '../../Checkbox';\nimport Empty from '../../Empty';\nimport InputSearch from '../../InputSearch';\nimport Spin from '../../Spin';\nimport type { IMemberPickerProps as MemberPickerProps } from '../interface';\nimport useDialogLocale from './useDialogLocale';\nimport { getMemberKey, isMemberLocked } from './helper';\nimport SearchFeedback from '../components/SearchFeedback';\nimport MemberOption from './MemberOption';\nimport type { TMember, TMemberKey } from './types';\nimport { useUserGroupCandidates } from './useUserGroupCandidates';\n\nconst LOAD_MORE_THRESHOLD = 32;\nconst ROOT_BREADCRUMB_INDEX = -1;\n\ninterface IProps {\n  selectedByKey: ReadonlyMap<TMemberKey, TMember>;\n  onToggle: (member: TMember) => void;\n  onToggleAll: (members: readonly TMember[], selected: boolean) => void;\n  lockedIds?: MemberPickerProps['lockedIds'];\n  filterItem?: MemberPickerProps['filterItem'];\n  renderItem?: MemberPickerProps['renderItem'];\n}\n\n/** 用户组树与跨层搜索共用选择事实源，但互不重置彼此的浏览状态。 */\nexport default function UserGroupCandidatePanel({\n  selectedByKey,\n  onToggle,\n  onToggleAll,\n  lockedIds = [],\n  filterItem,\n  renderItem,\n}: IProps) {\n  const t = useDialogLocale();\n  const candidates = useUserGroupCandidates();\n  const listRef = useRef<HTMLDivElement>(null);\n  const isSearching = candidates.keyword.trim().length > 0;\n  const groups = useMemo(\n    () =>\n      candidates.items.filter((group) =>\n        filterItem ? filterItem(group) : true,\n      ),\n    [candidates.items, filterItem],\n  );\n  const selectableGroups = groups.filter(\n    (group) => !isMemberLocked(group, lockedIds),\n  );\n  const selectedCount = selectableGroups.filter((group) =>\n    selectedByKey.has(getMemberKey(group)),\n  ).length;\n  const allSelected =\n    selectableGroups.length > 0 && selectedCount === selectableGroups.length;\n  const partiallySelected = selectedCount > 0 && !allSelected;\n\n  useEffect(() => {\n    if (!isSearching && listRef.current) {\n      listRef.current.scrollTop = candidates.scrollTop;\n    }\n  }, [candidates.breadcrumbPath, candidates.scrollTop, isSearching]);\n\n  return (\n    <section\n      className=\"tw-flex tw-h-full tw-min-h-0 tw-flex-col\"\n      data-testid=\"user-group-candidate-panel\"\n    >\n      <div className=\"tw-shrink-0 tw-border-b tw-border-solid tw-border-border-default tw-p-sp-150\">\n        <div className=\"tw-flex tw-min-w-0 tw-flex-col tw-gap-sp-150\">\n          {!isSearching && candidates.breadcrumbPath.length > 0 ? (\n            <Breadcrumb\n              className=\"tw-min-w-0 tw-flex-wrap\"\n              items={[\n                {\n                  title: t.MemberPickerDialog.root,\n                  onClick: () =>\n                    candidates.returnToBreadcrumb(\n                      ROOT_BREADCRUMB_INDEX,\n                      listRef.current?.scrollTop ?? 0,\n                    ),\n                },\n                ...candidates.breadcrumbPath.map((group, index) => ({\n                  title: group.name,\n                  onClick: () =>\n                    candidates.returnToBreadcrumb(\n                      index,\n                      listRef.current?.scrollTop ?? 0,\n                    ),\n                })),\n              ]}\n            />\n          ) : null}\n          <InputSearch\n            inputMode\n            size=\"middle\"\n            className=\"tw-w-full\"\n            debounce={false}\n            value={candidates.keyword}\n            placeholder={t.MemberPickerDialog.searchGroupsPlaceholder}\n            onChange={candidates.setKeyword}\n            onSearch={candidates.setKeyword}\n          />\n          <Checkbox\n            size=\"small\"\n            className=\"tw-self-start\"\n            checked={allSelected}\n            indeterminate={partiallySelected}\n            disabled={\n              candidates.loading ||\n              candidates.error ||\n              selectableGroups.length === 0\n            }\n            onChange={(event) =>\n              onToggleAll(selectableGroups, event.target.checked)\n            }\n          >\n            {allSelected\n              ? t.MemberPickerDialog.deselectCurrent(groups.length)\n              : t.MemberPickerDialog.selectCurrent(groups.length)}\n          </Checkbox>\n        </div>\n      </div>\n      <SearchFeedback\n        pathWarningCode={candidates.pathWarningCode}\n        hasMore={candidates.truncated}\n        retry={candidates.retry}\n      />\n      <div\n        ref={listRef}\n        className=\"tw-min-h-0 tw-flex-1 tw-overflow-auto tw-py-sp-100\"\n        onScroll={(event) => {\n          const target = event.currentTarget;\n          if (!isSearching) {\n            candidates.updateScrollTop(target.scrollTop);\n          }\n          if (\n            target.scrollHeight - target.scrollTop - target.clientHeight <=\n            LOAD_MORE_THRESHOLD\n          ) {\n            candidates.loadMore();\n          }\n        }}\n      >\n        {candidates.loading ? <Spin /> : null}\n        {candidates.error ? (\n          <div className=\"tw-flex tw-h-full tw-flex-col tw-items-center tw-justify-center tw-gap-2\">\n            <span>{t.MemberPickerDialog.loadFailed}</span>\n            <Button type=\"link\" onClick={candidates.retry}>\n              {t.MemberPickerDialog.retry}\n            </Button>\n          </div>\n        ) : null}\n        {!candidates.loading && !candidates.error && !groups.length ? (\n          <Empty description={t.MemberPickerDialog.emptyCandidates} />\n        ) : null}\n        {!candidates.loading && !candidates.error\n          ? groups.map((group) => (\n              <MemberOption\n                key={group.groupId}\n                member={group}\n                searchValue={candidates.keyword}\n                selected={selectedByKey.has(getMemberKey(group))}\n                locked={isMemberLocked(group, lockedIds)}\n                onToggle={onToggle}\n                onOpenGroup={\n                  isSearching\n                    ? undefined\n                    : () => {\n                        const sourceGroup = candidates.items.find(\n                          (item) => item.groupId === group.groupId,\n                        );\n                        if (sourceGroup) {\n                          candidates.enterGroup(\n                            sourceGroup,\n                            listRef.current?.scrollTop ?? 0,\n                          );\n                        }\n                      }\n                }\n                renderItem={renderItem}\n              />\n            ))\n          : null}\n        {!candidates.loading &&\n        !candidates.error &&\n        candidates.hasMore &&\n        !candidates.loadMoreError ? (\n          <Button\n            type=\"link\"\n            loading={candidates.loadingMore}\n            onClick={candidates.loadMore}\n          >\n            {t.MemberPickerDialog.loadMore}\n          </Button>\n        ) : null}\n        {candidates.loadMoreError ? (\n          <div className=\"tw-flex tw-items-center tw-justify-center tw-gap-2 tw-py-2\">\n            <span>{t.MemberPickerDialog.loadMoreFailed}</span>\n            <Button type=\"link\" onClick={candidates.retryLoadMore}>\n              {t.MemberPickerDialog.retry}\n            </Button>\n          </div>\n        ) : null}\n      </div>\n    </section>\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import { IUserGroup, TUserGroupValue, TUserValue } from '../../ConfigProvider/getUserList';
+import { TMember, TMemberKey } from './types.js';
+/** 用户和用户组可能复用同一 ID，因此唯一键必须包含成员类型。 */
+export declare function getMemberKey(member: TMember): TMemberKey;
+/** 从外部值创建独立草稿，并以首次出现顺序为准去重。 */
+export declare function createSelectedByKey(members: readonly TMember[]): Map<TMemberKey, TMember>;
+/** 增加候选时始终创建新 Map，重复项保持原插入位置。 */
+export declare function addSelectedMember(selectedByKey: ReadonlyMap<TMemberKey, TMember>, member: TMember): Map<TMemberKey, TMember>;
+/** 锁定项按类型化 key 判断，用户 ID 与用户组 ID 均受保护。 */
+export declare function removeSelectedMember(selectedByKey: ReadonlyMap<TMemberKey, TMember>, member: TMember, lockedIds: ReadonlyArray<TUserValue | TUserGroupValue>): Map<TMemberKey, TMember>;
+/** 批量更新当前候选，保留候选范围外的选择，并在取消选择时保护锁定项。 */
+export declare function setMembersSelected(selectedByKey: ReadonlyMap<TMemberKey, TMember>, members: readonly TMember[], selected: boolean, lockedIds: ReadonlyArray<TUserValue | TUserGroupValue>): Map<TMemberKey, TMember>;
+/** lockedIds 与成员使用同一类型化 key，避免不同类型的相同 ID 相互锁定。 */
+export declare function isMemberLocked(member: TMember, lockedIds: ReadonlyArray<TUserValue | TUserGroupValue>): boolean;
+/** 合并分页结果时按 groupId 去重，并保留每个用户组首次出现的位置。 */
+export declare function mergeGroupPages(currentItems: readonly IUserGroup[], nextItems: readonly IUserGroup[]): IUserGroup[];
+/** 是否仍有下一页由调用方分页契约明确提供。 */
+export declare const hasMoreGroupPages: (page: {
+    hasMore: boolean;
+}) => boolean;

package/dist/MemberPicker/dialog/helper.js

@@ -0,0 +1,61 @@
+import { EUserType } from "../../ConfigProvider/getUserList.js";
+//#region src/MemberPicker/dialog/helper.ts
+/** 用户和用户组可能复用同一 ID，因此唯一键必须包含成员类型。 */
+function getMemberKey(member) {
+	const id = member.type === EUserType.USER ? member.userId : member.groupId;
+	return `${member.type}:${id}`;
+}
+/** 从外部值创建独立草稿，并以首次出现顺序为准去重。 */
+function createSelectedByKey(members) {
+	return members.reduce((selected, member) => {
+		const key = getMemberKey(member);
+		if (!selected.has(key)) selected.set(key, member);
+		return selected;
+	}, /* @__PURE__ */ new Map());
+}
+/** 增加候选时始终创建新 Map，重复项保持原插入位置。 */
+function addSelectedMember(selectedByKey, member) {
+	const nextSelectedByKey = new Map(selectedByKey);
+	const key = getMemberKey(member);
+	if (!nextSelectedByKey.has(key)) nextSelectedByKey.set(key, member);
+	return nextSelectedByKey;
+}
+/** 锁定项按类型化 key 判断，用户 ID 与用户组 ID 均受保护。 */
+function removeSelectedMember(selectedByKey, member, lockedIds) {
+	const nextSelectedByKey = new Map(selectedByKey);
+	const key = getMemberKey(member);
+	if (!isMemberLocked(member, lockedIds)) nextSelectedByKey.delete(key);
+	return nextSelectedByKey;
+}
+/** 批量更新当前候选，保留候选范围外的选择，并在取消选择时保护锁定项。 */
+function setMembersSelected(selectedByKey, members, selected, lockedIds) {
+	return members.reduce((nextSelectedByKey, member) => {
+		const key = getMemberKey(member);
+		if (isMemberLocked(member, lockedIds)) return nextSelectedByKey;
+		if (selected) {
+			if (!nextSelectedByKey.has(key)) nextSelectedByKey.set(key, member);
+			return nextSelectedByKey;
+		}
+		nextSelectedByKey.delete(key);
+		return nextSelectedByKey;
+	}, new Map(selectedByKey));
+}
+/** lockedIds 与成员使用同一类型化 key，避免不同类型的相同 ID 相互锁定。 */
+function isMemberLocked(member, lockedIds) {
+	const key = getMemberKey(member);
+	return lockedIds.some((lockedMember) => getMemberKey(lockedMember) === key);
+}
+/** 合并分页结果时按 groupId 去重，并保留每个用户组首次出现的位置。 */
+function mergeGroupPages(currentItems, nextItems) {
+	const groupsById = [...currentItems, ...nextItems].reduce((groups, group) => {
+		if (!groups.has(group.groupId)) groups.set(group.groupId, group);
+		return groups;
+	}, /* @__PURE__ */ new Map());
+	return Array.from(groupsById.values());
+}
+/** 是否仍有下一页由调用方分页契约明确提供。 */
+var hasMoreGroupPages = (page) => page.hasMore;
+//#endregion
+export { addSelectedMember, createSelectedByKey, getMemberKey, hasMoreGroupPages, isMemberLocked, mergeGroupPages, removeSelectedMember, setMembersSelected };
+
+//# sourceMappingURL=helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","names":[],"sources":["../../../src/MemberPicker/dialog/helper.ts"],"sourcesContent":["import { EUserType } from '../../ConfigProvider/getUserList';\nimport type { IUserGroup } from '../../ConfigProvider/getUserList';\nimport type {\n  TUserGroupValue,\n  TUserValue,\n} from '../../ConfigProvider/getUserList';\nimport type { TMember, TMemberKey } from './types';\n\n/** 用户和用户组可能复用同一 ID，因此唯一键必须包含成员类型。 */\nexport function getMemberKey(member: TMember): TMemberKey {\n  const id = member.type === EUserType.USER ? member.userId : member.groupId;\n  return `${member.type}:${id}`;\n}\n\n/** 从外部值创建独立草稿，并以首次出现顺序为准去重。 */\nexport function createSelectedByKey(\n  members: readonly TMember[],\n): Map<TMemberKey, TMember> {\n  return members.reduce<Map<TMemberKey, TMember>>((selected, member) => {\n    const key = getMemberKey(member);\n    if (!selected.has(key)) selected.set(key, member);\n    return selected;\n  }, new Map());\n}\n\n/** 增加候选时始终创建新 Map，重复项保持原插入位置。 */\nexport function addSelectedMember(\n  selectedByKey: ReadonlyMap<TMemberKey, TMember>,\n  member: TMember,\n): Map<TMemberKey, TMember> {\n  const nextSelectedByKey = new Map(selectedByKey);\n  const key = getMemberKey(member);\n  if (!nextSelectedByKey.has(key)) {\n    nextSelectedByKey.set(key, member);\n  }\n  return nextSelectedByKey;\n}\n\n/** 锁定项按类型化 key 判断，用户 ID 与用户组 ID 均受保护。 */\nexport function removeSelectedMember(\n  selectedByKey: ReadonlyMap<TMemberKey, TMember>,\n  member: TMember,\n  lockedIds: ReadonlyArray<TUserValue | TUserGroupValue>,\n): Map<TMemberKey, TMember> {\n  const nextSelectedByKey = new Map(selectedByKey);\n  const key = getMemberKey(member);\n  if (!isMemberLocked(member, lockedIds)) {\n    nextSelectedByKey.delete(key);\n  }\n  return nextSelectedByKey;\n}\n\n/** 批量更新当前候选，保留候选范围外的选择，并在取消选择时保护锁定项。 */\nexport function setMembersSelected(\n  selectedByKey: ReadonlyMap<TMemberKey, TMember>,\n  members: readonly TMember[],\n  selected: boolean,\n  lockedIds: ReadonlyArray<TUserValue | TUserGroupValue>,\n): Map<TMemberKey, TMember> {\n  return members.reduce<Map<TMemberKey, TMember>>(\n    (nextSelectedByKey, member) => {\n      const key = getMemberKey(member);\n      if (isMemberLocked(member, lockedIds)) {\n        return nextSelectedByKey;\n      }\n      if (selected) {\n        if (!nextSelectedByKey.has(key)) {\n          nextSelectedByKey.set(key, member);\n        }\n        return nextSelectedByKey;\n      }\n      nextSelectedByKey.delete(key);\n      return nextSelectedByKey;\n    },\n    new Map(selectedByKey),\n  );\n}\n\n/** lockedIds 与成员使用同一类型化 key，避免不同类型的相同 ID 相互锁定。 */\nexport function isMemberLocked(\n  member: TMember,\n  lockedIds: ReadonlyArray<TUserValue | TUserGroupValue>,\n): boolean {\n  const key = getMemberKey(member);\n  return lockedIds.some(\n    (lockedMember) => getMemberKey(lockedMember as TMember) === key,\n  );\n}\n\n/** 合并分页结果时按 groupId 去重，并保留每个用户组首次出现的位置。 */\nexport function mergeGroupPages(\n  currentItems: readonly IUserGroup[],\n  nextItems: readonly IUserGroup[],\n): IUserGroup[] {\n  const groupsById = [...currentItems, ...nextItems].reduce<\n    Map<string, IUserGroup>\n  >((groups, group) => {\n    if (!groups.has(group.groupId)) groups.set(group.groupId, group);\n    return groups;\n  }, new Map());\n  return Array.from(groupsById.values());\n}\n\n/** 是否仍有下一页由调用方分页契约明确提供。 */\nexport const hasMoreGroupPages = (page: { hasMore: boolean }): boolean =>\n  page.hasMore;\n"],"mappings":";;;AASA,SAAgB,aAAa,QAA6B;CACxD,MAAM,KAAK,OAAO,SAAS,UAAU,OAAO,OAAO,SAAS,OAAO;AACnE,QAAO,GAAG,OAAO,KAAK,GAAG;;;AAI3B,SAAgB,oBACd,SAC0B;AAC1B,QAAO,QAAQ,QAAkC,UAAU,WAAW;EACpE,MAAM,MAAM,aAAa,OAAO;AAChC,MAAI,CAAC,SAAS,IAAI,IAAI,CAAE,UAAS,IAAI,KAAK,OAAO;AACjD,SAAO;oBACN,IAAI,KAAK,CAAC;;;AAIf,SAAgB,kBACd,eACA,QAC0B;CAC1B,MAAM,oBAAoB,IAAI,IAAI,cAAc;CAChD,MAAM,MAAM,aAAa,OAAO;AAChC,KAAI,CAAC,kBAAkB,IAAI,IAAI,CAC7B,mBAAkB,IAAI,KAAK,OAAO;AAEpC,QAAO;;;AAIT,SAAgB,qBACd,eACA,QACA,WAC0B;CAC1B,MAAM,oBAAoB,IAAI,IAAI,cAAc;CAChD,MAAM,MAAM,aAAa,OAAO;AAChC,KAAI,CAAC,eAAe,QAAQ,UAAU,CACpC,mBAAkB,OAAO,IAAI;AAE/B,QAAO;;;AAIT,SAAgB,mBACd,eACA,SACA,UACA,WAC0B;AAC1B,QAAO,QAAQ,QACZ,mBAAmB,WAAW;EAC7B,MAAM,MAAM,aAAa,OAAO;AAChC,MAAI,eAAe,QAAQ,UAAU,CACnC,QAAO;AAET,MAAI,UAAU;AACZ,OAAI,CAAC,kBAAkB,IAAI,IAAI,CAC7B,mBAAkB,IAAI,KAAK,OAAO;AAEpC,UAAO;;AAET,oBAAkB,OAAO,IAAI;AAC7B,SAAO;IAET,IAAI,IAAI,cAAc,CACvB;;;AAIH,SAAgB,eACd,QACA,WACS;CACT,MAAM,MAAM,aAAa,OAAO;AAChC,QAAO,UAAU,MACd,iBAAiB,aAAa,aAAwB,KAAK,IAC7D;;;AAIH,SAAgB,gBACd,cACA,WACc;CACd,MAAM,aAAa,CAAC,GAAG,cAAc,GAAG,UAAU,CAAC,QAEhD,QAAQ,UAAU;AACnB,MAAI,CAAC,OAAO,IAAI,MAAM,QAAQ,CAAE,QAAO,IAAI,MAAM,SAAS,MAAM;AAChE,SAAO;oBACN,IAAI,KAAK,CAAC;AACb,QAAO,MAAM,KAAK,WAAW,QAAQ,CAAC;;;AAIxC,IAAa,qBAAqB,SAChC,KAAK"}

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

@@ -0,0 +1,41 @@
+import { EMemberPicker } from '../interface';
+import { EUserType, IUser, IUserGroup } from '../../ConfigProvider/getUserList';
+/** 根层没有 parentGroupId，使用显式 key 避免 Map 中混用 undefined。 */
+export declare const ROOT_GROUP_CACHE_KEY = "__ROOT_GROUP__";
+export type TMember = IUser | IUserGroup;
+export type TMemberKey = `${EUserType}:${string}`;
+export type TMemberPickerTab = EMemberPicker.USER | EMemberPicker.GROUP;
+/** 单个树层级的分页缓存，离开层级后仍保留滚动位置和已加载页。 */
+export interface IGroupLevelCache {
+    parentGroupId?: string;
+    items: IUserGroup[];
+    pageNumber: number;
+    hasMore: boolean;
+    pathWarningCode?: string | null;
+    truncated?: boolean;
+    scrollTop: number;
+    loadingMore: boolean;
+    loadMoreError: boolean;
+}
+/** 树浏览状态与搜索状态隔离，清空搜索时可原样恢复浏览上下文。 */
+export interface IGroupTreeState {
+    breadcrumbPath: IUserGroup[];
+    levelsByParent: Map<string, IGroupLevelCache>;
+}
+export interface IGroupSearchState {
+    keyword: string;
+    items: IUserGroup[];
+    pageNumber: number;
+    hasMore: boolean;
+    pathWarningCode?: string | null;
+    truncated?: boolean;
+    loading: boolean;
+    loadingMore: boolean;
+    error: boolean;
+    loadMoreError: boolean;
+}
+/** 弹窗生命周期内的选择草稿，关闭弹窗即整体释放。 */
+export interface IMemberPickerDraftState {
+    activeTab: TMemberPickerTab;
+    selectedByKey: Map<TMemberKey, TMember>;
+}

package/dist/MemberPicker/dialog/types.js

@@ -0,0 +1,7 @@
+//#region src/MemberPicker/dialog/types.ts
+/** 根层没有 parentGroupId，使用显式 key 避免 Map 中混用 undefined。 */
+var ROOT_GROUP_CACHE_KEY = "__ROOT_GROUP__";
+//#endregion
+export { ROOT_GROUP_CACHE_KEY };
+
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/MemberPicker/dialog/types.ts"],"sourcesContent":["import { EMemberPicker } from '../interface';\nimport { EUserType } from '../../ConfigProvider/getUserList';\nimport type { IUser } from '../../ConfigProvider/getUserList';\nimport type { IUserGroup } from '../../ConfigProvider/getUserList';\n\n/** 根层没有 parentGroupId，使用显式 key 避免 Map 中混用 undefined。 */\nexport const ROOT_GROUP_CACHE_KEY = '__ROOT_GROUP__';\n\nexport type TMember = IUser | IUserGroup;\nexport type TMemberKey = `${EUserType}:${string}`;\nexport type TMemberPickerTab = EMemberPicker.USER | EMemberPicker.GROUP;\n\n/** 单个树层级的分页缓存，离开层级后仍保留滚动位置和已加载页。 */\nexport interface IGroupLevelCache {\n  parentGroupId?: string;\n  items: IUserGroup[];\n  pageNumber: number;\n  hasMore: boolean;\n  pathWarningCode?: string | null;\n  truncated?: boolean;\n  scrollTop: number;\n  loadingMore: boolean;\n  loadMoreError: boolean;\n}\n\n/** 树浏览状态与搜索状态隔离，清空搜索时可原样恢复浏览上下文。 */\nexport interface IGroupTreeState {\n  breadcrumbPath: IUserGroup[];\n  levelsByParent: Map<string, IGroupLevelCache>;\n}\n\nexport interface IGroupSearchState {\n  keyword: string;\n  items: IUserGroup[];\n  pageNumber: number;\n  hasMore: boolean;\n  pathWarningCode?: string | null;\n  truncated?: boolean;\n  loading: boolean;\n  loadingMore: boolean;\n  error: boolean;\n  loadMoreError: boolean;\n}\n\n/** 弹窗生命周期内的选择草稿，关闭弹窗即整体释放。 */\nexport interface IMemberPickerDraftState {\n  activeTab: TMemberPickerTab;\n  selectedByKey: Map<TMemberKey, TMember>;\n}\n"],"mappings":";;AAMA,IAAa,uBAAuB"}

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

@@ -0,0 +1,103 @@
+/** 文案由组件库 locale 决定，业务方不必提供 CAN 文案。 */
+export default function useDialogLocale(): {
+    locale: string;
+    DatePicker: import('rc-picker/es/interface').Locale;
+    Empty: {
+        noContentFound: string;
+    };
+    ColorPicker: {
+        default: string;
+        standardColor: string;
+        recentlyUsed: string;
+    };
+    DataPreviewTable: {
+        dataLoadFailed: string;
+        loadFailed: string;
+    };
+    InputSearch: {
+        search: string;
+    };
+    MemberPickerDialog: {
+        missingGroupSource: string;
+        missingUserSource: string;
+        loadMore: string;
+        resizePanels: string;
+        title: string;
+        user: string;
+        userGroup: string;
+        selected: string;
+        root: string;
+        subLevel: string;
+        searchUsersPlaceholder: string;
+        searchGroupsPlaceholder: string;
+        selectCurrent: (count: number) => string;
+        deselectCurrent: (count: number) => string;
+        emptyCandidates: string;
+        emptySelected: string;
+        loadFailed: string;
+        retry: string;
+        loadMoreFailed: string;
+        maximize: string;
+        exitMaximize: string;
+        ok: string;
+        cancel: string;
+    };
+    MemberPicker: {
+        searchFailed: string;
+        pathUnavailable: string;
+        moreResults: string;
+        retry: string;
+        select: string;
+        ban: string;
+        pleaseConfigGetUserByKeywordsMethod: string;
+        pleaseConfigGetUserByIdsMethod: string;
+        noData: string;
+        subLevel: string;
+        users: string;
+        userGroups: string;
+        selectedTotal: (total: number) => string;
+        cancel: string;
+        confirm: string;
+    };
+    Modal: {
+        cancel: string;
+        sure: string;
+    };
+    Select: {
+        noSearchResult: string;
+        all: string;
+    };
+    Tree: {
+        expand: string;
+    };
+    Table: {
+        cancelSelect: string;
+        selected: string;
+        item: string;
+        selectAll: string;
+    };
+    ErrorBoundary: {
+        happenedError: string;
+    };
+    LogicTree: {
+        btn: {
+            addCondition: string;
+            addRelation: string;
+        };
+        select: {
+            and: string;
+            or: string;
+        };
+    };
+    Pagination: {
+        navigationLabel: string;
+        previousPage: string;
+        nextPage: string;
+        page: (page: number) => string;
+        currentPage: (page: number) => string;
+        pageSize: string;
+        itemsPerPage: string;
+        selectPageSize: string;
+        totalItems: (total: number, range: [number, number]) => string;
+    };
+};

package/dist/MemberPicker/dialog/useDialogLocale.js

@@ -0,0 +1,12 @@
+import { LocaleContext, getTranslator } from "../../locale/default.js";
+import { useContext } from "react";
+//#region src/MemberPicker/dialog/useDialogLocale.ts
+/** 文案由组件库 locale 决定，业务方不必提供 CAN 文案。 */
+function useDialogLocale() {
+	const { locale } = useContext(LocaleContext);
+	return getTranslator(locale);
+}
+//#endregion
+export { useDialogLocale as default };
+
+//# sourceMappingURL=useDialogLocale.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDialogLocale.js","names":[],"sources":["../../../src/MemberPicker/dialog/useDialogLocale.ts"],"sourcesContent":["import { useContext } from 'react';\nimport { getTranslator, LocaleContext } from '../../locale/default';\n/** 文案由组件库 locale 决定，业务方不必提供 CAN 文案。 */\nexport default function useDialogLocale() {\n  const { locale } = useContext(LocaleContext);\n  return getTranslator(locale);\n}\n"],"mappings":";;;;AAGA,SAAwB,kBAAkB;CACxC,MAAM,EAAE,WAAW,WAAW,cAAc;AAC5C,QAAO,cAAc,OAAO"}

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;