lingee-ui 0.0.19 → 0.0.21

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { B as ButtonProps } from './index-7pb5YOcq.mjs';
-export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-7pb5YOcq.mjs';
+import { B as ButtonProps } from './index-89atTLPD.mjs';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-89atTLPD.mjs';
 import * as React$1 from 'react';
 import React__default, { ReactNode, MouseEvent, CSSProperties, HTMLAttributes, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
 import { TooltipProps } from './tooltip/index.mjs';
@@ -677,6 +677,19 @@ interface DialogHostModal {
      * 若用它防止表单被误关，端上灰度期内防不住。
      */
     maskClosable?: boolean;
+    /**
+     * 跨发起方去重键（与 requestId 正交，仅客户端 webview 通道）。
+     *
+     * requestId 由 Dialog 内部随机生成，是「本发起方卸载时撤销弹窗」的句柄；
+     * 本字段是全局固定值（如 "experience-retention-block"），端壳收到相同
+     * fixedId 的请求时只渲染一个弹窗，后续发起方的 Promise 跟随既有弹窗结算。
+     * 用于多个 webview 实例（工作/管理/开发三板块）可能同时发起同一阻断弹窗
+     * 的场景 —— 没有它端壳会渲染多个叠加弹窗。
+     *
+     * 复用既有弹窗时业务入参以首个发起方为准；单个发起方卸载只结算自己、
+     * 弹窗保留，全部发起方卸载后弹窗才随兜底关闭。
+     */
+    fixedId?: string;
     /**
      * 宿主弹窗关闭时回调。
      * @param result 承载页通过 `closeHostModal` 回传的业务结果；用户直接关窗时为 undefined
@@ -1217,6 +1230,13 @@ interface DropdownSubProps {
     defaultOpen?: boolean;
     /** 开关变化回调 */
     onOpenChange?: (open: boolean) => void;
+    /**
+     * 展开方式，默认 `hover`。
+     *
+     * `click`：点击触发项展开、再点收起，hover 其它项或移出菜单都不会收起；
+     * 点外部、选中菜单项时随主菜单关闭。子面板很高、需要长距离移动才够得到时使用。
+     */
+    trigger?: "hover" | "click";
 }
 interface DropdownSubTriggerProps {
     /** 子菜单触发项内容 */
@@ -1276,6 +1296,13 @@ interface DropdownButtonProps extends Omit<React__default.ButtonHTMLAttributes<H
     onClear?: (e: React__default.MouseEvent) => void;
 }
 
+declare function DropdownSub({ children, open, defaultOpen, onOpenChange, trigger }: DropdownSubProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownSub {
+    var displayName: string;
+}
+declare const DropdownSubTrigger: React__default.ForwardRefExoticComponent<DropdownSubTriggerProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownSubContent: React__default.ForwardRefExoticComponent<DropdownSubContentProps & React__default.RefAttributes<HTMLDivElement>>;
+
 /**
  * DropdownButton — 统一的 Dropdown/Popover 触发器按钮
  *
@@ -1328,12 +1355,6 @@ declare function DropdownGroup({ children }: DropdownGroupProps): react_jsx_runt
 declare namespace DropdownGroup {
     var displayName: string;
 }
-declare function DropdownSub({ children, open, defaultOpen, onOpenChange }: DropdownSubProps): react_jsx_runtime.JSX.Element;
-declare namespace DropdownSub {
-    var displayName: string;
-}
-declare const DropdownSubTrigger: React__default.ForwardRefExoticComponent<DropdownSubTriggerProps & React__default.RefAttributes<HTMLDivElement>>;
-declare const DropdownSubContent: React__default.ForwardRefExoticComponent<DropdownSubContentProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type DatePickerSize = LgSize;
 interface DatePickerProps {
@@ -3476,11 +3497,27 @@ interface PickerPaneData {
     /**
      * 是否渲染「全选」行。
      *
-     * 只作用于 `sections` 内的实体，不含 `orgNodes` —— 下级组织的成员未加载，
-     * 把它们算进全选会让勾选结果与用户所见不一致。
+     * 作用范围：有 `sections` 时只覆盖它，没有才退到 `orgNodes` —— 两个组织类页签
+     * 因此各自得到正确语义，组件无需知道当前是哪个页签。
+     *
+     * ⚠️ **可选项少于两个时不渲染**，哪怕本属性为 true：只有一个候选时，「全选」与
+     * 直接点那一行完全等价。
      */
     selectAll?: boolean;
 }
+/**
+ * 页签切换的上下文，交给 `resetPathOnTabChange` 的函数形态判断是否回根层。
+ *
+ * 用对象而非位置参数：以后要补字段不会破坏既有调用方的签名。
+ */
+interface PickerTabChangeContext {
+    /** 切换前所在的页签 */
+    prevTab: PickerTabKey;
+    /** 即将切到的页签 */
+    nextTab: PickerTabKey;
+    /** 切换前所处的层级路径，空数组表示已在根层 */
+    orgPath: PickerOrgPathItem[];
+}
 /** 组织层级路径中的一项，用于面包屑回跳 */
 interface PickerOrgPathItem {
     /** 组织 id */
@@ -3588,6 +3625,73 @@ interface PersonPickerPanelProps {
     orgPath?: PickerOrgPathItem[];
     /** 层级变化回调：点面包屑回跳、点行尾箭头下钻都会触发 */
     onOrgPathChange?: (path: PickerOrgPathItem[]) => void;
+    /**
+     * 切换页签时是否回到根层，默认 `true`。
+     *
+     * 两个组织类页签看的虽是同一棵组织树，层级却不一定互通 —— 消费方完全可以只在
+     * `person` 页签提供某些节点（例如「无组织」这类根本不属于组织树的虚拟层级）。
+     * 停在那种层级上切到 `org`，会得到一个列不出任何内容的空列表，用户只能点面包屑
+     * 的根节点自己退回来。默认回根层就是为了不把人卡在这种死路上。
+     *
+     * - `true`（默认）—— 一律回根层
+     * - `false` —— 一律保留。两个页签的层级**完全互通**时更连贯（切过去仍停在同一
+     *   部门，只是从「看子部门」变成「看部门里的人」）
+     * - 函数 —— 逐次决定，用于「只有某些层级需要回根层」。组件不认识业务上的虚拟
+     *   层级，这个判断只能由消费方做：
+     *
+     * ```tsx
+     * // 只有停在「无组织」这类虚拟层级时才回根层，其余保留下钻位置
+     * resetPathOnTabChange={({ orgPath }) =>
+     *   orgPath.some((item) => item.id === UNASSIGNED_ORG_ID)
+     * }
+     * ```
+     *
+     * 受控用法（传了 `orgPath`）下组件不直接改值，而是调 `onOrgPathChange([])` 请求
+     * 消费方重置 —— 与 `value` / `onChange` 同一套受控约定。
+     */
+    resetPathOnTabChange?: boolean | ((context: PickerTabChangeContext) => boolean);
+    /**
+     * 把组织展开为其下全部人员（含子组织，递归）。
+     *
+     * 传入后，「选择人员」页签的组织行语义变为**批量选人**：勾选 = 选中该组织下的所有
+     * 人，取消 = 把这批人移出已选，**组织本身不进已选区**。不传时组织行维持原语义
+     * （勾选 = 选中该组织实体）。
+     *
+     * 「选择组织」页签不受影响 —— 那里勾中的始终是组织自身。两个页签因此互不干扰：
+     * 在组织页签勾过的部门，切到人员页签时是未选中的。
+     *
+     * 组件不发请求，递归查询由消费方实现。返回的实体会原样进入已选，`type` 必须是
+     * `"person"`；结果按组织缓存，同一组织不重复请求。
+     */
+    onExpandOrg?: (org: PickerEntity) => Promise<PickerEntity[]>;
+    /**
+     * `onExpandOrg` 失败时触发。
+     *
+     * 组件内没有提示能力，必须由消费方告知用户（toast 等），否则点击组织后毫无反应、
+     * 看不出是失败还是没数据。
+     */
+    onExpandOrgError?: (org: PickerEntity, error: unknown) => void;
+    /**
+     * 「全选」时拉取**当前范围的全部实体**。
+     *
+     * 列表是分页的，已加载的往往只是第一页。不传本属性时全选只覆盖已加载项 —— 用户
+     * 在一个 370 人的层级里点全选，实际只选中 20 个，而全选框却是选中态，他完全看不出
+     * 漏了 350 人。传入后改为先拉全量再整批选中，与「勾选组织即选中其下所有人」
+     * （`onExpandOrg`）保持同一个心理模型。
+     *
+     * 「当前范围」由消费方自己掌握（当前页签、层级、搜索词决定查询条件），组件只负责
+     * 在该调的时候调。结果按范围缓存，同一范围内重复点全选不会重复请求；切层级、
+     * 切页签、改搜索词后缓存自动作废。
+     *
+     * 拉取期间全选框替换为加载指示器 —— 它可能要翻好几页。
+     */
+    onSelectAll?: () => Promise<PickerEntity[]>;
+    /**
+     * `onSelectAll` 失败时触发。
+     *
+     * 组件内没有提示能力，必须由消费方告知用户，否则点了全选毫无反应。
+     */
+    onSelectAllError?: (error: unknown) => void;
     /** 选择模式，默认 `"multiple"` */
     mode?: PickerMode;
     /** 最多可选数量，不传则不限 */
@@ -3595,7 +3699,7 @@ interface PersonPickerPanelProps {
     /** 选中数量将超过 `max` 时触发，此时本次勾选被丢弃 */
     onExceed?: (max: number) => void;
     /**
-     * 左右分栏的高度，默认 406（设计稿固定值）。
+     * 左右分栏的高度，默认 456。
      *
      * - `number` —— 固定像素高
      * - `"fill"` —— 撑满父容器剩余空间
@@ -4051,4 +4155,4 @@ declare const Carousel: CarouselComponent;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabChangeContext, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as ButtonProps } from './index-7pb5YOcq.js';
-export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-7pb5YOcq.js';
+import { B as ButtonProps } from './index-89atTLPD.js';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-89atTLPD.js';
 import * as React$1 from 'react';
 import React__default, { ReactNode, MouseEvent, CSSProperties, HTMLAttributes, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
 import { TooltipProps } from './tooltip/index.js';
@@ -677,6 +677,19 @@ interface DialogHostModal {
      * 若用它防止表单被误关，端上灰度期内防不住。
      */
     maskClosable?: boolean;
+    /**
+     * 跨发起方去重键（与 requestId 正交，仅客户端 webview 通道）。
+     *
+     * requestId 由 Dialog 内部随机生成，是「本发起方卸载时撤销弹窗」的句柄；
+     * 本字段是全局固定值（如 "experience-retention-block"），端壳收到相同
+     * fixedId 的请求时只渲染一个弹窗，后续发起方的 Promise 跟随既有弹窗结算。
+     * 用于多个 webview 实例（工作/管理/开发三板块）可能同时发起同一阻断弹窗
+     * 的场景 —— 没有它端壳会渲染多个叠加弹窗。
+     *
+     * 复用既有弹窗时业务入参以首个发起方为准；单个发起方卸载只结算自己、
+     * 弹窗保留，全部发起方卸载后弹窗才随兜底关闭。
+     */
+    fixedId?: string;
     /**
      * 宿主弹窗关闭时回调。
      * @param result 承载页通过 `closeHostModal` 回传的业务结果；用户直接关窗时为 undefined
@@ -1217,6 +1230,13 @@ interface DropdownSubProps {
     defaultOpen?: boolean;
     /** 开关变化回调 */
     onOpenChange?: (open: boolean) => void;
+    /**
+     * 展开方式，默认 `hover`。
+     *
+     * `click`：点击触发项展开、再点收起，hover 其它项或移出菜单都不会收起；
+     * 点外部、选中菜单项时随主菜单关闭。子面板很高、需要长距离移动才够得到时使用。
+     */
+    trigger?: "hover" | "click";
 }
 interface DropdownSubTriggerProps {
     /** 子菜单触发项内容 */
@@ -1276,6 +1296,13 @@ interface DropdownButtonProps extends Omit<React__default.ButtonHTMLAttributes<H
     onClear?: (e: React__default.MouseEvent) => void;
 }
 
+declare function DropdownSub({ children, open, defaultOpen, onOpenChange, trigger }: DropdownSubProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownSub {
+    var displayName: string;
+}
+declare const DropdownSubTrigger: React__default.ForwardRefExoticComponent<DropdownSubTriggerProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownSubContent: React__default.ForwardRefExoticComponent<DropdownSubContentProps & React__default.RefAttributes<HTMLDivElement>>;
+
 /**
  * DropdownButton — 统一的 Dropdown/Popover 触发器按钮
  *
@@ -1328,12 +1355,6 @@ declare function DropdownGroup({ children }: DropdownGroupProps): react_jsx_runt
 declare namespace DropdownGroup {
     var displayName: string;
 }
-declare function DropdownSub({ children, open, defaultOpen, onOpenChange }: DropdownSubProps): react_jsx_runtime.JSX.Element;
-declare namespace DropdownSub {
-    var displayName: string;
-}
-declare const DropdownSubTrigger: React__default.ForwardRefExoticComponent<DropdownSubTriggerProps & React__default.RefAttributes<HTMLDivElement>>;
-declare const DropdownSubContent: React__default.ForwardRefExoticComponent<DropdownSubContentProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type DatePickerSize = LgSize;
 interface DatePickerProps {
@@ -3476,11 +3497,27 @@ interface PickerPaneData {
     /**
      * 是否渲染「全选」行。
      *
-     * 只作用于 `sections` 内的实体，不含 `orgNodes` —— 下级组织的成员未加载，
-     * 把它们算进全选会让勾选结果与用户所见不一致。
+     * 作用范围：有 `sections` 时只覆盖它，没有才退到 `orgNodes` —— 两个组织类页签
+     * 因此各自得到正确语义，组件无需知道当前是哪个页签。
+     *
+     * ⚠️ **可选项少于两个时不渲染**，哪怕本属性为 true：只有一个候选时，「全选」与
+     * 直接点那一行完全等价。
      */
     selectAll?: boolean;
 }
+/**
+ * 页签切换的上下文，交给 `resetPathOnTabChange` 的函数形态判断是否回根层。
+ *
+ * 用对象而非位置参数：以后要补字段不会破坏既有调用方的签名。
+ */
+interface PickerTabChangeContext {
+    /** 切换前所在的页签 */
+    prevTab: PickerTabKey;
+    /** 即将切到的页签 */
+    nextTab: PickerTabKey;
+    /** 切换前所处的层级路径，空数组表示已在根层 */
+    orgPath: PickerOrgPathItem[];
+}
 /** 组织层级路径中的一项，用于面包屑回跳 */
 interface PickerOrgPathItem {
     /** 组织 id */
@@ -3588,6 +3625,73 @@ interface PersonPickerPanelProps {
     orgPath?: PickerOrgPathItem[];
     /** 层级变化回调：点面包屑回跳、点行尾箭头下钻都会触发 */
     onOrgPathChange?: (path: PickerOrgPathItem[]) => void;
+    /**
+     * 切换页签时是否回到根层，默认 `true`。
+     *
+     * 两个组织类页签看的虽是同一棵组织树，层级却不一定互通 —— 消费方完全可以只在
+     * `person` 页签提供某些节点（例如「无组织」这类根本不属于组织树的虚拟层级）。
+     * 停在那种层级上切到 `org`，会得到一个列不出任何内容的空列表，用户只能点面包屑
+     * 的根节点自己退回来。默认回根层就是为了不把人卡在这种死路上。
+     *
+     * - `true`（默认）—— 一律回根层
+     * - `false` —— 一律保留。两个页签的层级**完全互通**时更连贯（切过去仍停在同一
+     *   部门，只是从「看子部门」变成「看部门里的人」）
+     * - 函数 —— 逐次决定，用于「只有某些层级需要回根层」。组件不认识业务上的虚拟
+     *   层级，这个判断只能由消费方做：
+     *
+     * ```tsx
+     * // 只有停在「无组织」这类虚拟层级时才回根层，其余保留下钻位置
+     * resetPathOnTabChange={({ orgPath }) =>
+     *   orgPath.some((item) => item.id === UNASSIGNED_ORG_ID)
+     * }
+     * ```
+     *
+     * 受控用法（传了 `orgPath`）下组件不直接改值，而是调 `onOrgPathChange([])` 请求
+     * 消费方重置 —— 与 `value` / `onChange` 同一套受控约定。
+     */
+    resetPathOnTabChange?: boolean | ((context: PickerTabChangeContext) => boolean);
+    /**
+     * 把组织展开为其下全部人员（含子组织，递归）。
+     *
+     * 传入后，「选择人员」页签的组织行语义变为**批量选人**：勾选 = 选中该组织下的所有
+     * 人，取消 = 把这批人移出已选，**组织本身不进已选区**。不传时组织行维持原语义
+     * （勾选 = 选中该组织实体）。
+     *
+     * 「选择组织」页签不受影响 —— 那里勾中的始终是组织自身。两个页签因此互不干扰：
+     * 在组织页签勾过的部门，切到人员页签时是未选中的。
+     *
+     * 组件不发请求，递归查询由消费方实现。返回的实体会原样进入已选，`type` 必须是
+     * `"person"`；结果按组织缓存，同一组织不重复请求。
+     */
+    onExpandOrg?: (org: PickerEntity) => Promise<PickerEntity[]>;
+    /**
+     * `onExpandOrg` 失败时触发。
+     *
+     * 组件内没有提示能力，必须由消费方告知用户（toast 等），否则点击组织后毫无反应、
+     * 看不出是失败还是没数据。
+     */
+    onExpandOrgError?: (org: PickerEntity, error: unknown) => void;
+    /**
+     * 「全选」时拉取**当前范围的全部实体**。
+     *
+     * 列表是分页的，已加载的往往只是第一页。不传本属性时全选只覆盖已加载项 —— 用户
+     * 在一个 370 人的层级里点全选，实际只选中 20 个，而全选框却是选中态，他完全看不出
+     * 漏了 350 人。传入后改为先拉全量再整批选中，与「勾选组织即选中其下所有人」
+     * （`onExpandOrg`）保持同一个心理模型。
+     *
+     * 「当前范围」由消费方自己掌握（当前页签、层级、搜索词决定查询条件），组件只负责
+     * 在该调的时候调。结果按范围缓存，同一范围内重复点全选不会重复请求；切层级、
+     * 切页签、改搜索词后缓存自动作废。
+     *
+     * 拉取期间全选框替换为加载指示器 —— 它可能要翻好几页。
+     */
+    onSelectAll?: () => Promise<PickerEntity[]>;
+    /**
+     * `onSelectAll` 失败时触发。
+     *
+     * 组件内没有提示能力，必须由消费方告知用户，否则点了全选毫无反应。
+     */
+    onSelectAllError?: (error: unknown) => void;
     /** 选择模式，默认 `"multiple"` */
     mode?: PickerMode;
     /** 最多可选数量，不传则不限 */
@@ -3595,7 +3699,7 @@ interface PersonPickerPanelProps {
     /** 选中数量将超过 `max` 时触发，此时本次勾选被丢弃 */
     onExceed?: (max: number) => void;
     /**
-     * 左右分栏的高度，默认 406（设计稿固定值）。
+     * 左右分栏的高度，默认 456。
      *
      * - `number` —— 固定像素高
      * - `"fill"` —— 撑满父容器剩余空间
@@ -4051,4 +4155,4 @@ declare const Carousel: CarouselComponent;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabChangeContext, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };