@unicom-cloud/ui 0.8.150 → 0.8.152

package/select/index.d.ts

@@ -0,0 +1,16 @@
+import Option from './Option';
+import OptionGroup from './OptionGroup';
+declare const Select: import("react").ForwardRefExoticComponent<import("./interface").SelectProps & import("react").RefAttributes<import("./interface").SelectHandle>> & {
+    Option: typeof Option;
+    OptionGroup: typeof OptionGroup;
+} & {
+    Option: import("react").ForwardRefExoticComponent<import("./interface").OptionProps & import("react").RefAttributes<unknown>> & {
+        ___PQB_SELECT_OPTION___?: boolean;
+    };
+    OptionGroup: import("react").ForwardRefExoticComponent<import("./interface").OptionGroupProps & import("react").RefAttributes<unknown>> & {
+        ___PQB_SELECT_OPTGROUP___?: boolean;
+    };
+};
+export { Option as SelectOption, OptionGroup as SelectOptionGroup };
+export default Select;
+export type { OptionGroupProps, OptionProps, SelectProps } from './interface';

package/select/index.js

@@ -1,9 +1,12 @@
-/* 2026-03-04 15:09:50 */
-import t from "./Select.js";
-import { default as p } from "./Option.js";
-import { default as f } from "./OptionGroup.js";
-export {
-  p as SelectOption,
-  f as SelectOptionGroup,
-  t as default
-};
+/* 潘启宝 2026-03-24 16:29:04 星期二 */
+import e from "./Option.js";
+import t from "./OptionGroup.js";
+import n from "./Select.js";
+//#region components/pc/select/index.tsx
+var r = Object.assign(n, {
+	Option: e,
+	OptionGroup: t
+});
+//#endregion
+export { e as SelectOption, t as SelectOptionGroup, r as default };
+/* 独立思考，明辨是非 */

package/select/interface.d.ts

@@ -0,0 +1,295 @@
+import { CSSProperties, HTMLAttributes, PropsWithChildren, ReactElement, ReactNode } from 'react';
+import { FocusAndBlur, GetPopupContainer, ImperativeHandle, ReadOnly } from '../interface';
+import type { SelectViewCommonProps } from '../select-view';
+import type { TriggerProps } from '../trigger';
+import type { AvailableVirtualListProps } from '../virtual-list';
+export type OptionsType = SelectProps['options'];
+export type InputValueChangeReason = 'manual' | 'optionChecked' | 'optionListHide' | 'tokenSeparator';
+export interface OptionInfo extends PropsWithChildren<OptionProps> {
+    child?: ReactElement;
+    _valid: boolean;
+    _index: number;
+    _origin: 'children' | 'options' | 'userCreatedOptions' | 'userCreatingOption';
+}
+export type LabeledValue = {
+    value: string | number;
+    label: ReactNode;
+};
+export type SelectInnerStateValue = string | number | string[] | number[];
+/**
+ * @title Select
+ */
+export interface SelectProps extends SelectViewCommonProps, ReadOnly, GetPopupContainer {
+    /**
+     * @zh 选择框的默认值
+     * @en To set default value
+     */
+    defaultValue?: string | string[] | number | number[] | LabeledValue | LabeledValue[];
+    /**
+     * @zh 选择器的值（受控模式）
+     * @en To set value
+     */
+    value?: string | string[] | number | number[] | LabeledValue | LabeledValue[];
+    /**
+     * @zh 输入框的值（受控模式）
+     * @en To set input value
+     */
+    inputValue?: string;
+    /**
+     * @zh 是否开启多选模式或标签模式
+     * @en Set mode of Select
+     */
+    mode?: 'multiple' | 'single';
+    /**
+     * @zh 是否开启全选选项，仅在多选模式时才生效
+     */
+    allowCheckAll?: boolean | {
+        search?: boolean;
+    };
+    /**
+     * @zh 指定可选项
+     * @en Select options
+     */
+    options?: (string | number | {
+        label: ReactNode | string;
+        value: string | number;
+        disabled?: boolean;
+        extra?: unknown;
+    })[];
+    /**
+     * @zh 设置 `onChange` 回调中 `value` 的格式。默认是string，设置为true时候，value格式为：{ label: string, value: string }
+     * @en Whether to embed label in value, turn the format of value from string to `{ value: string, label: ReactNode }`
+     */
+    labelInValue?: boolean;
+    /**
+     * @zh 是否根据输入的值筛选数据。如果传入函数的话，接收 `inputValue` 和 `option` 两个参数，当option符合筛选条件时，返回 `true`，反之返回 `false`。
+     * @en If it's true, filter options by input value. If it's a function, filter options base on the function.
+     * @defaultValue true
+     */
+    filterOption?: boolean | ((inputValue: string, option: ReactElement, optionRaw: object | undefined | null) => boolean);
+    /**
+     * @zh
+     * 定制回显内容。返回值将会显示在下拉框内。若 `value` 对应的 `Option` 不存在，则第一个参数是 null
+     * @en
+     * Customize the content that will be displayed in the Select.
+     * If the `Option` corresponding to `value` does not exist, the first parameter will be `null`
+     */
+    renderFormat?: (option: OptionInfo | null, value: string | number | LabeledValue) => ReactNode;
+    /**
+     * @zh 是否默认高亮第一个选项
+     * @en Whether to highlight the first option by default
+     * @defaultValue false
+     */
+    defaultActiveFirstOption?: boolean;
+    /**
+     * @zh 是否允许通过输入创建新的选项。
+     * @en Whether to allow new options to be created by input.
+     */
+    allowCreate?: boolean | {
+        formatter: (inputValue: string, creating: boolean) => SelectProps['options'][number];
+    };
+    /**
+     * @zh 是否在隐藏的时候销毁 DOM 结构
+     * @en Whether to destroy the DOM when hiding
+     * @defaultValue true
+     */
+    unmountOnExit?: boolean;
+    /**
+     * @zh 下拉框是否默认打开。
+     * @en Whether to show dropdown by default.
+     */
+    defaultPopupVisible?: boolean;
+    /**
+     * @zh 控制下拉框是否打开。
+     * @en Whether to show dropdown.
+     */
+    popupVisible?: boolean;
+    /**
+     * @zh 没有数据时显示的内容
+     * @en Specify content to show when no result matches.
+     */
+    notFoundContent?: ReactNode;
+    /**
+     * @zh 在多选模式下自动分词的分隔符。
+     * @en Separator used to tokenize on `multiple` mode.
+     */
+    tokenSeparators?: string[];
+    /**
+     * @zh 触发方式。
+     * @en The trigger mode which executes the dropdown action.
+     * @defaultValue click
+     */
+    trigger?: TriggerProps['trigger'];
+    /**
+     * @zh 自定义触发元素。
+     * @en The trigger element which executes the dropdown action.
+     */
+    triggerElement?: ReactNode | ((params: {
+        value: unknown;
+        option: OptionInfo | OptionInfo[];
+    }) => ReactNode);
+    /**
+     * @zh 可以接受所有 `Trigger` 的 `Props`
+     * @en Pass all `Trigger` component properties
+     */
+    triggerProps?: Partial<TriggerProps>;
+    /**
+     * @zh 自定义弹出内容。
+     * @en Customize dropdown content
+     */
+    dropdownRender?: (menu: ReactNode) => ReactNode;
+    /**
+     * @zh 下拉列表的样式。
+     * @en The style of dropdown menu.
+     */
+    dropdownMenuStyle?: CSSProperties;
+    /**
+     * @zh 下拉列表的类。
+     * @en The className of dropdown menu.
+     */
+    dropdownMenuClassName?: string | string[];
+    /**
+     * @zh 传递虚拟滚动属性。
+     * @en Pass properties used by VirtualList.
+     */
+    virtualListProps?: AvailableVirtualListProps;
+    /**
+     * @zh 是否立即触发一次 onChange 回调。仅在 (value 或者 defaultValue) 条件满足的情况下才会触发。
+     */
+    immediateTriggerChangeOnMount?: boolean;
+    /**
+     * @zh 点击选择框的回调
+     * @en Callback when select an option or input value change.
+     */
+    onChange?: (value: any, option: OptionInfo | OptionInfo[]) => void;
+    /**
+     * @zh 选中选项时触发的回调，(只在 `multiple` 模式下触发)。
+     * @en Called when an option is selected. Only called for `multiple` mode.
+     */
+    onSelect?: (value: string | number | LabeledValue, option: OptionInfo) => void;
+    /**
+     * @zh 取消选中的时候触发的回调，(只在 `multiple` 模式下触发)。
+     * @en Called when an option is deselected. Only called for `multiple` mode.
+     */
+    onDeselect?: (value: string | number | LabeledValue, option: OptionInfo) => void;
+    /**
+     * @zh 点击清除时触发，参数是当前下拉框的展开状态。
+     * @en Called when clear
+     */
+    onClear?: (visible: boolean) => void;
+    /**
+     * @zh 搜索时的回调
+     * @en Callback when input changed
+     */
+    onSearch?: (value: string, reason: InputValueChangeReason) => void;
+    /**
+     * @zh 获得焦点时的回调
+     * @en Callback when get focus
+     */
+    onFocus?: (e: any) => void;
+    /**
+     * @zh 失去焦点时的回调
+     * @en Callback when lose focus
+     */
+    onBlur?: (e: any) => void;
+    /**
+     * @zh 下拉框的滚动监听函数，参数为滚动元素。
+     * @en Callback when dropdown scrolls.
+     */
+    onPopupScroll?: (elem: any) => void;
+    /**
+     * @zh 下拉框收起展开时触发
+     * @en Callback when visibility of dropdown is changed.
+     */
+    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * @zh 输入框文本改变的回调。
+     * @en Callback when the value of input is changed.
+     */
+    onInputValueChange?: (value: string, reason: InputValueChangeReason) => void;
+    /**
+     * @zh 输入框文本粘贴的回调。
+     * @en Callback when the you paste text in input box.
+     */
+    onPaste?: (e: any) => void;
+}
+/**
+ * @title Select.Option
+ */
+export interface OptionProps extends Omit<HTMLAttributes<HTMLLIElement>, 'className'> {
+    _key?: any;
+    style?: CSSProperties;
+    children?: ReactNode;
+    prefixCls?: string;
+    rtl?: boolean;
+    className?: string | string[];
+    wrapperClassName?: string | string[];
+    /**
+     * @zh 是否禁用
+     * @en Whether the option is disabled
+     */
+    disabled?: boolean;
+    /**
+     * @zh 默认根据此属性值进行筛选
+     * @en Value of this Option
+     */
+    value: string | number;
+    /**
+     * @zh 携带任意自定义数据。
+     * @en Any data you want to pass to Option.
+     */
+    extra?: unknown;
+    isSelectOption?: boolean;
+    _isMultipleMode?: boolean;
+    _isUserCreatedOption?: boolean;
+    _isUserCreatingOption?: boolean;
+    _valueActive?: OptionProps['value'];
+    _valueSelect?: SelectInnerStateValue;
+    _onClick?: (value: OptionProps['value'], disabled: boolean) => void;
+    _onMouseEnter?: (value: OptionProps['value']) => void;
+    _onMouseLeave?: () => void;
+}
+/**
+ * @title Select.OptionGroup
+ */
+export interface OptionGroupProps extends HTMLAttributes<HTMLLIElement> {
+    _key?: unknown;
+    children?: ReactNode;
+    prefixCls?: string;
+    /**
+     * @zh 组名
+     * @en Name of Group
+     */
+    label?: ReactNode;
+    isSelectOptionGroup?: boolean;
+}
+/**
+ * @title Select Reference Type
+ */
+export type SelectHandle = FocusAndBlur & ImperativeHandle & {
+    /**
+     * @zh 鼠标快捷操作的处理函数
+     * @en Processor of mouse shortcut operation
+     */
+    hotkeyHandler: (event: KeyboardEvent) => void;
+    /**
+     * @zh 处于悬浮态的选项的值
+     * @en The value of active option
+     */
+    activeOptionValue: OptionProps['value'];
+    /**
+     * @zh 获得选项信息的列表
+     * @en Get the list of option info
+     */
+    getOptionInfoList: () => OptionInfo[];
+    /**
+     * @zh 根据选项值获得对应的选项信息
+     * @en Get the option info by its value
+     */
+    getOptionInfoByValue: (value: OptionProps['value']) => OptionInfo;
+    /**
+     * @zh 将下拉列表滚动至指定选项
+     * @en Scroll the drop-down list to the specified option
+     */
+    scrollIntoView: (value: OptionProps['value'], options?: ScrollIntoViewOptions) => void;
+};

package/select/utils.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { OptionInfo, OptionProps, SelectInnerStateValue, SelectProps } from './interface';
+export type OptionInfoMap = Map<OptionProps['value'], OptionInfo>;
+declare function preventDefaultEvent(e: any): void;
+declare function isEmpty(value: any, isMultiple: boolean): boolean;
+declare function getValidValue(value: any, isMultiple: boolean, labelInValue: boolean): SelectInnerStateValue;
+declare function isSelectOption(child: any): boolean;
+declare function isSelectOptionGroup(child: any): boolean;
+declare function flatChildren(a: Pick<SelectProps, 'children' | 'options' | 'filterOption'>, b: {
+    inputValue: string;
+    userCreatedOptions?: SelectProps['options'];
+    userCreatingOption?: SelectProps['options'][number];
+    prefixCls: string;
+}, c?: {
+    optionInfoMap?: OptionInfoMap;
+    optionValueList?: Array<OptionProps['value']>;
+    customNodeCount?: number;
+}): {
+    childrenList: React.ReactElement<unknown, string | React.JSXElementConstructor<any>>[];
+    optionInfoMap: OptionInfoMap | undefined;
+    optionValueList: (string | number)[] | undefined;
+    optionIndexListForArrowKey: number[];
+    hasOptionGroup: boolean;
+    hasComplexLabelInOptions: boolean;
+};
+export { flatChildren, getValidValue, isEmpty, isSelectOption, isSelectOptionGroup, preventDefaultEvent, };

package/select/utils.js

@@ -1,120 +1,99 @@
-/* 2026-03-04 15:09:50 */
-import { jsx as K } from "react/jsx-runtime";
-import f from "lodash/get";
-import g from "react";
-import U from "@unicom-cloud/ui-common/utils/fillNBSP";
-import B from "@unicom-cloud/ui-common/utils/getHighlightText";
-import { isArray as x, isPlainObject as b, isEmptyArray as j, isNil as z, isString as T, isNumber as D, isFunction as Q, isNullOrUndefined as R } from "@unicom-cloud/ui-common/utils/is";
-import H from "./Option.js";
-function re(t) {
-  t?.preventDefault?.();
+/* 潘启宝 2026-03-24 16:29:04 星期二 */
+import { isArray as e, isEmptyArray as t, isFunction as n, isNil as r, isNullOrUndefined as i, isNumber as a, isPlainObject as o, isString as s } from "../utils/is.js";
+import c from "../utils/fillNBSP.js";
+import l from "../utils/getHighlightText.js";
+import u from "./Option.js";
+import d from "react";
+import { jsx as f } from "react/jsx-runtime";
+import p from "lodash/get";
+//#region components/pc/select/utils.tsx
+function m(e) {
+	e?.preventDefault?.();
 }
-function M(t, s) {
-  return s ? !x(t) || j(t) : z(t);
+function h(n, i) {
+	return i ? !e(n) || t(n) : r(n);
 }
-function se(t, s, d) {
-  return d && (s ? x(t) && (t = t.map((p, I, a) => b(p) && "label" in p ? p.value : p)) : b(t) && "label" in t && (t = t.value)), M(t, s) ? s ? x(t) ? t : [] : void 0 : t;
+function g(t, n, r) {
+	return r && (n ? e(t) && (t = t.map((e, t, n) => o(e) && "label" in e ? e.value : e)) : o(t) && "label" in t && (t = t.value)), h(t, n) ? n ? e(t) ? t : [] : void 0 : t;
 }
-function q(t) {
-  return f(t, "props.isSelectOption") || f(t, "type.___PQB_SELECT_OPTION___");
+function _(e) {
+	return p(e, "props.isSelectOption") || p(e, "type.___PQB_SELECT_OPTION___");
 }
-function J(t) {
-  return f(t, "props.isSelectOptionGroup") || f(t, "type.___PQB_SELECT_OPTGROUP___");
+function v(e) {
+	return p(e, "props.isSelectOptionGroup") || p(e, "type.___PQB_SELECT_OPTGROUP___");
 }
-function W(t, s, d = { optionInfoMap: /* @__PURE__ */ new Map(), optionValueList: [], customNodeCount: 0 }) {
-  const { children: p, options: I, filterOption: a } = t, {
-    inputValue: _ = "",
-    userCreatedOptions: A,
-    userCreatingOption: S,
-    prefixCls: V
-  } = s, { optionInfoMap: u, optionValueList: y } = d;
-  let { customNodeCount: L } = d, N = !1, m = !1, r = [], O = [];
-  const F = (e) => {
-    const i = f(e, "props.value"), n = f(e, "props.children");
-    return i === void 0 && !R(n) ? n.toString() : i;
-  }, C = ({ label: e, value: i }, n, o) => !e && !i && !n ? (L++, `custom_node_${L}`) : o ? n || `group_${e}` : n || `${typeof i}_${i}` || `${e}_${u.size}`, w = (e, i, n) => {
-    const o = F(e);
-    let l = !0;
-    a === !0 ? l = o !== void 0 && String(o).toLowerCase().includes(_.toLowerCase()) : Q(a) && (l = !_ || a(_, e, n));
-    const c = u.get(o), P = c?._origin === "userCreatedOptions" || c?._origin === "userCreatingOption";
-    if (!c || P) {
-      "_key" in e.props || (e = g.cloneElement(e, {
-        _key: C(e.props, e.key)
-      }));
-      const $ = u.size, k = {
-        child: e,
-        ...e.props,
-        value: o,
-        _index: $,
-        _origin: i,
-        _valid: l
-      };
-      if (u.set(o, k), P) {
-        const E = r.findIndex((G, X, Y) => G?.props?.value === o);
-        E > -1 && (l ? r[E] = e : r.splice(E, 1));
-      } else
-        y.push(o), l && (r.push(e), k.disabled || O.push($));
-    }
-    T(e.props.children) || (m = !0);
-  }, h = (e, i) => (i && x(e) && e.length && e.forEach((n) => {
-    (T(n) || D(n)) && (n = {
-      label: n,
-      value: n
-    });
-    const o = /* @__PURE__ */ K(
-      H,
-      {
-        _key: C(n),
-        value: n.value,
-        disabled: n.disabled === !0,
-        extra: n.extra,
-        children: U(n.label)
-      }
-    );
-    w(o, i, n);
-  }), e);
-  return S && h([S], "userCreatingOption"), p && g.Children.map(p, (e) => {
-    if (J(e)) {
-      const { children: i, options: n } = e.props, {
-        childrenList: o,
-        optionIndexListForArrowKey: l,
-        hasComplexLabelInOptions: c
-      } = W(
-        { children: i, options: n, filterOption: a },
-        { inputValue: _, prefixCls: V },
-        { optionInfoMap: u, optionValueList: y, customNodeCount: L }
-      );
-      o.length && (r.push(
-        g.cloneElement(e, {
-          children: null,
-          _key: C(e.props, e.key, !0)
-        })
-      ), r = r.concat(o), O = O.concat(
-        l
-      ), N = !0, m = m || c);
-    } else q(e) ? w(e, "children", null) : b(e) && e.props && r.push(
-      g.cloneElement(e, {
-        _key: C(e.props, e.key)
-      })
-    );
-  }), h(I, "options"), h(A, "userCreatedOptions"), {
-    childrenList: B({
-      nodeList: r,
-      pattern: _,
-      highlightClassName: `${V}-highlight`
-    }),
-    optionInfoMap: u,
-    optionValueList: y,
-    optionIndexListForArrowKey: O,
-    hasOptionGroup: N,
-    hasComplexLabelInOptions: m
-  };
+function y(t, r, m = {
+	optionInfoMap: /* @__PURE__ */ new Map(),
+	optionValueList: [],
+	customNodeCount: 0
+}) {
+	let { children: h, options: g, filterOption: b } = t, { inputValue: x = "", userCreatedOptions: S, userCreatingOption: C, prefixCls: w } = r, { optionInfoMap: T, optionValueList: E } = m, { customNodeCount: D } = m, O = !1, k = !1, A = [], j = [], M = (e) => {
+		let t = p(e, "props.value"), n = p(e, "props.children");
+		return t === void 0 && !i(n) ? n.toString() : t;
+	}, N = ({ label: e, value: t }, n, r) => !e && !t && !n ? (D++, `custom_node_${D}`) : r ? n || `group_${e}` : n || `${typeof t}_${t}` || `${e}_${T.size}`, P = (e, t, r) => {
+		let i = M(e), a = !0;
+		b === !0 ? a = i !== void 0 && String(i).toLowerCase().includes(x.toLowerCase()) : n(b) && (a = !x || b(x, e, r));
+		let o = T.get(i), c = o?._origin === "userCreatedOptions" || o?._origin === "userCreatingOption";
+		if (!o || c) {
+			"_key" in e.props || (e = d.cloneElement(e, { _key: N(e.props, e.key) }));
+			let n = T.size, r = {
+				child: e,
+				...e.props,
+				value: i,
+				_index: n,
+				_origin: t,
+				_valid: a
+			};
+			if (T.set(i, r), c) {
+				let t = A.findIndex((e, t, n) => e?.props?.value === i);
+				t > -1 && (a ? A[t] = e : A.splice(t, 1));
+			} else E.push(i), a && (A.push(e), r.disabled || j.push(n));
+		}
+		s(e.props.children) || (k = !0);
+	}, F = (t, n) => (n && e(t) && t.length && t.forEach((e) => {
+		(s(e) || a(e)) && (e = {
+			label: e,
+			value: e
+		}), P(/* @__PURE__ */ f(u, {
+			_key: N(e),
+			value: e.value,
+			disabled: e.disabled === !0,
+			extra: e.extra,
+			children: c(e.label)
+		}), n, e);
+	}), t);
+	return C && F([C], "userCreatingOption"), h && d.Children.map(h, (e) => {
+		if (v(e)) {
+			let { children: t, options: n } = e.props, { childrenList: r, optionIndexListForArrowKey: i, hasComplexLabelInOptions: a } = y({
+				children: t,
+				options: n,
+				filterOption: b
+			}, {
+				inputValue: x,
+				prefixCls: w
+			}, {
+				optionInfoMap: T,
+				optionValueList: E,
+				customNodeCount: D
+			});
+			r.length && (A.push(d.cloneElement(e, {
+				children: null,
+				_key: N(e.props, e.key, !0)
+			})), A = A.concat(r), j = j.concat(i), O = !0, k ||= a);
+		} else _(e) ? P(e, "children", null) : o(e) && e.props && A.push(d.cloneElement(e, { _key: N(e.props, e.key) }));
+	}), F(g, "options"), F(S, "userCreatedOptions"), {
+		childrenList: l({
+			nodeList: A,
+			pattern: x,
+			highlightClassName: `${w}-highlight`
+		}),
+		optionInfoMap: T,
+		optionValueList: E,
+		optionIndexListForArrowKey: j,
+		hasOptionGroup: O,
+		hasComplexLabelInOptions: k
+	};
 }
-export {
-  W as flatChildren,
-  se as getValidValue,
-  M as isEmpty,
-  q as isSelectOption,
-  J as isSelectOptionGroup,
-  re as preventDefaultEvent
-};
+//#endregion
+export { y as flatChildren, g as getValidValue, h as isEmpty, _ as isSelectOption, v as isSelectOptionGroup, m as preventDefaultEvent };
+/* 独立思考，明辨是非 */