lingee-ui 0.0.19 → 0.0.20

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-BVXwKHfX.mjs';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-BVXwKHfX.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,8 +3497,11 @@ interface PickerPaneData {
     /**
      * 是否渲染「全选」行。
      *
-     * 只作用于 `sections` 内的实体，不含 `orgNodes` —— 下级组织的成员未加载，
-     * 把它们算进全选会让勾选结果与用户所见不一致。
+     * 作用范围：有 `sections` 时只覆盖它，没有才退到 `orgNodes` —— 两个组织类页签
+     * 因此各自得到正确语义，组件无需知道当前是哪个页签。
+     *
+     * ⚠️ **可选项少于两个时不渲染**，哪怕本属性为 true：只有一个候选时，「全选」与
+     * 直接点那一行完全等价。
      */
     selectAll?: boolean;
 }
@@ -3588,6 +3612,27 @@ interface PersonPickerPanelProps {
     orgPath?: PickerOrgPathItem[];
     /** 层级变化回调：点面包屑回跳、点行尾箭头下钻都会触发 */
     onOrgPathChange?: (path: PickerOrgPathItem[]) => void;
+    /**
+     * 把组织展开为其下全部人员（含子组织，递归）。
+     *
+     * 传入后，「选择人员」页签的组织行语义变为**批量选人**：勾选 = 选中该组织下的所有
+     * 人，取消 = 把这批人移出已选，**组织本身不进已选区**。不传时组织行维持原语义
+     * （勾选 = 选中该组织实体）。
+     *
+     * 「选择组织」页签不受影响 —— 那里勾中的始终是组织自身。两个页签因此互不干扰：
+     * 在组织页签勾过的部门，切到人员页签时是未选中的。
+     *
+     * 组件不发请求，递归查询由消费方实现。返回的实体会原样进入已选，`type` 必须是
+     * `"person"`；结果按组织缓存，同一组织不重复请求。
+     */
+    onExpandOrg?: (org: PickerEntity) => Promise<PickerEntity[]>;
+    /**
+     * `onExpandOrg` 失败时触发。
+     *
+     * 组件内没有提示能力，必须由消费方告知用户（toast 等），否则点击组织后毫无反应、
+     * 看不出是失败还是没数据。
+     */
+    onExpandOrgError?: (org: PickerEntity, error: unknown) => void;
     /** 选择模式，默认 `"multiple"` */
     mode?: PickerMode;
     /** 最多可选数量，不传则不限 */
@@ -3595,7 +3640,7 @@ interface PersonPickerPanelProps {
     /** 选中数量将超过 `max` 时触发，此时本次勾选被丢弃 */
     onExceed?: (max: number) => void;
     /**
-     * 左右分栏的高度，默认 406（设计稿固定值）。
+     * 左右分栏的高度，默认 456。
      *
      * - `number` —— 固定像素高
      * - `"fill"` —— 撑满父容器剩余空间

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-BVXwKHfX.js';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-BVXwKHfX.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,8 +3497,11 @@ interface PickerPaneData {
     /**
      * 是否渲染「全选」行。
      *
-     * 只作用于 `sections` 内的实体，不含 `orgNodes` —— 下级组织的成员未加载，
-     * 把它们算进全选会让勾选结果与用户所见不一致。
+     * 作用范围：有 `sections` 时只覆盖它，没有才退到 `orgNodes` —— 两个组织类页签
+     * 因此各自得到正确语义，组件无需知道当前是哪个页签。
+     *
+     * ⚠️ **可选项少于两个时不渲染**，哪怕本属性为 true：只有一个候选时，「全选」与
+     * 直接点那一行完全等价。
      */
     selectAll?: boolean;
 }
@@ -3588,6 +3612,27 @@ interface PersonPickerPanelProps {
     orgPath?: PickerOrgPathItem[];
     /** 层级变化回调：点面包屑回跳、点行尾箭头下钻都会触发 */
     onOrgPathChange?: (path: PickerOrgPathItem[]) => void;
+    /**
+     * 把组织展开为其下全部人员（含子组织，递归）。
+     *
+     * 传入后，「选择人员」页签的组织行语义变为**批量选人**：勾选 = 选中该组织下的所有
+     * 人，取消 = 把这批人移出已选，**组织本身不进已选区**。不传时组织行维持原语义
+     * （勾选 = 选中该组织实体）。
+     *
+     * 「选择组织」页签不受影响 —— 那里勾中的始终是组织自身。两个页签因此互不干扰：
+     * 在组织页签勾过的部门，切到人员页签时是未选中的。
+     *
+     * 组件不发请求，递归查询由消费方实现。返回的实体会原样进入已选，`type` 必须是
+     * `"person"`；结果按组织缓存，同一组织不重复请求。
+     */
+    onExpandOrg?: (org: PickerEntity) => Promise<PickerEntity[]>;
+    /**
+     * `onExpandOrg` 失败时触发。
+     *
+     * 组件内没有提示能力，必须由消费方告知用户（toast 等），否则点击组织后毫无反应、
+     * 看不出是失败还是没数据。
+     */
+    onExpandOrgError?: (org: PickerEntity, error: unknown) => void;
     /** 选择模式，默认 `"multiple"` */
     mode?: PickerMode;
     /** 最多可选数量，不传则不限 */
@@ -3595,7 +3640,7 @@ interface PersonPickerPanelProps {
     /** 选中数量将超过 `max` 时触发，此时本次勾选被丢弃 */
     onExceed?: (max: number) => void;
     /**
-     * 左右分栏的高度，默认 406（设计稿固定值）。
+     * 左右分栏的高度，默认 456。
      *
      * - `number` —— 固定像素高
      * - `"fill"` —— 撑满父容器剩余空间