@pnt-team/pnt-component-frontend 0.0.138 → 0.0.140

package/lib/esm/components/PntBusinessSelect/index.d.ts

@@ -0,0 +1,192 @@
+import type { BusinessSelectListResponseListItem } from "../../api/types";
+import React, { FC } from 'react';
+import type { SelectValue, TdSelectProps } from 'tdesign-react/es/select/type';
+import './index.scss';
+/** 下拉场景 */
+type Scene = 'default' | 'sdk' | 'compliance_age' | 'custom_region';
+/** 标签格式 */
+type LabelFormat = 'name' | 'name_en' | 'name_id' | 'name_en_id';
+interface PntBusinessSelectProps {
+    /**
+     * 当前选中值
+     * @description 单选为 string，多选为 string[]
+     */
+    value?: SelectValue;
+    /**
+     * 值变化回调
+     */
+    onChange?: TdSelectProps['onChange'];
+    /**
+     * 是否多选
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * 下拉场景
+     * @description 后端按场景返回默认字段集
+     * @default 'default'
+     */
+    scene?: Scene;
+    /**
+     * 业务状态筛选
+     * @description 3-线上运营，4-接入中，5-中途结项，6-已下线
+     */
+    statuses?: number[];
+    /**
+     * 业务类型筛选
+     * @description 1-正式业务，2-测试业务
+     */
+    businessTypes?: number[];
+    /**
+     * 标签格式
+     * @description name-中文名，name_en-英文名，name_id-中文名（ID），name_en_id-英文名（ID）
+     * @default 'name'
+     */
+    labelFormat?: LabelFormat;
+    /**
+     * 占位提示文案
+     */
+    placeholder?: string;
+    /**
+     * 是否禁用整个选择器
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 是否可清除
+     * @default true
+     */
+    clearable?: boolean;
+    /**
+     * 是否可远程搜索
+     * @default true
+     */
+    filterable?: boolean;
+    /**
+     * 多选时最大可选数量
+     */
+    max?: number;
+    /**
+     * 每页条数
+     * @default 20
+     */
+    pageSize?: number;
+    /**
+     * 搜索防抖延迟（毫秒）
+     * @default 400
+     */
+    searchDebounce?: number;
+    /**
+     * 多选时最少折叠数量
+     * @description 超过此数量的选中项将折叠显示，透传至 TDesign Select
+     */
+    minCollapsedNum?: number;
+    /**
+     * 折叠项自定义渲染
+     * @description 透传至 TDesign Select collapsedItems
+     */
+    collapsedItems?: TdSelectProps['collapsedItems'];
+    /**
+     * 弹层属性透传
+     * @description 会与组件内部 onScrollToBottom 合并；常用 attach（挂载容器）、overlayClassName 等
+     */
+    popupProps?: Partial<TdSelectProps['popupProps']>;
+    /**
+     * 字段白名单
+     * @description 传给后端 fields 参数，指定返回字段；未传时后端按 scene 返回默认字段
+     */
+    fields?: string[];
+    /**
+     * 自定义 label 字段
+     * @description 从响应项的指定字段取 label；默认按 labelFormat 渲染
+     * 常用于消费方接口返回字段不是标准 name/name_en 的场景（如 game_name）
+     */
+    labelField?: string;
+    /**
+     * 自定义选项 label 渲染
+     * @description 返回 ReactNode 作为选项内容；优先级高于 labelFormat/labelField
+     * 常用于需要 ellipsis/样式包裹的场景
+     */
+    optionLabel?: (item: BusinessSelectListResponseListItem) => React.ReactNode;
+    /**
+     * 是否分页
+     * @description false 时一次性加载所有数据（pageNum=1, pageSize=0），不分页不远程搜索
+     * @default true
+     */
+    pagination?: boolean;
+    /**
+     * 选项加载完成回调
+     * @description 每次远程加载（首屏/搜索/翻页追加）成功后触发，返回当前全部选项；
+     * 不分页模式下首屏即全量数据，消费方可借此复用同一份数据，无需重复请求
+     */
+    onLoaded?: (options: BusinessSelectListResponseListItem[]) => void;
+    /**
+     * 自定义选项禁用逻辑
+     * @description 返回 true 时该选项禁用；与合规场景的 creatable 判断叠加（任一为 true 即禁用）
+     */
+    optionDisabled?: (item: BusinessSelectListResponseListItem) => boolean;
+    /**
+     * 自定义选项 tooltip 内容
+     * @description 返回非空字符串时该选项悬停显示 tooltip；常用于解释禁用原因
+     */
+    optionTooltip?: (item: BusinessSelectListResponseListItem) => string;
+    /**
+     * tooltip 位置
+     * @default 'top'
+     */
+    tooltipPlacement?: 'top' | 'bottom' | 'left' | 'right';
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 业务选择器组件
+ * @description 统一业务下拉选择器，内置对接后端通用接口 `/api/business/select/list`，
+ * 支持远程搜索、滚动分页加载、多选、场景化禁用（合规场景 creatable 字段）。
+ *
+ * @param {PntBusinessSelectProps} props - 组件属性
+ *
+ * @example
+ * ```tsx
+ * import { PntBusinessSelect } from '@pnt-team/pnt-component-frontend';
+ *
+ * // 最简用法
+ * <PntBusinessSelect
+ *   value={gameId}
+ *   onChange={(v) => setGameId(v as string)}
+ * />
+ *
+ * // SDK 定制场景 + 名称带 ID
+ * <PntBusinessSelect
+ *   scene="sdk"
+ *   labelFormat="name_id"
+ *   value={gameId}
+ *   onChange={(v) => setGameId(v as string)}
+ * />
+ *
+ * // 合规年龄场景（自动禁用 creatable=false 的业务）
+ * <PntBusinessSelect
+ *   scene="compliance_age"
+ *   value={gameId}
+ *   onChange={(v) => setGameId(v as string)}
+ * />
+ *
+ * // 多选 + 状态过滤
+ * <PntBusinessSelect
+ *   multiple
+ *   statuses={[3, 4]}
+ *   labelFormat="name_id"
+ *   value={gameIds}
+ *   onChange={(v) => setGameIds(v as string[])}
+ * />
+ * ```
+ *
+ * @returns {ReactElement} 业务选择器组件
+ */
+declare const PntBusinessSelect: FC<PntBusinessSelectProps>;
+export default PntBusinessSelect;

package/lib/esm/components/PntBusinessSelect/index.js

@@ -0,0 +1,513 @@
+import { businessSelectList } from "../../api";
+import { usePntConfig } from "../../config";
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { Loading, Select, Tooltip } from 'tdesign-react';
+import "./index.scss";
+
+// ==========================================
+// 类型定义
+// ==========================================
+
+/** 下拉场景 */
+
+/** 标签格式 */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 业务选择器组件
+ * @description 统一业务下拉选择器，内置对接后端通用接口 `/api/business/select/list`，
+ * 支持远程搜索、滚动分页加载、多选、场景化禁用（合规场景 creatable 字段）。
+ *
+ * @param {PntBusinessSelectProps} props - 组件属性
+ *
+ * @example
+ * ```tsx
+ * import { PntBusinessSelect } from '@pnt-team/pnt-component-frontend';
+ *
+ * // 最简用法
+ * <PntBusinessSelect
+ *   value={gameId}
+ *   onChange={(v) => setGameId(v as string)}
+ * />
+ *
+ * // SDK 定制场景 + 名称带 ID
+ * <PntBusinessSelect
+ *   scene="sdk"
+ *   labelFormat="name_id"
+ *   value={gameId}
+ *   onChange={(v) => setGameId(v as string)}
+ * />
+ *
+ * // 合规年龄场景（自动禁用 creatable=false 的业务）
+ * <PntBusinessSelect
+ *   scene="compliance_age"
+ *   value={gameId}
+ *   onChange={(v) => setGameId(v as string)}
+ * />
+ *
+ * // 多选 + 状态过滤
+ * <PntBusinessSelect
+ *   multiple
+ *   statuses={[3, 4]}
+ *   labelFormat="name_id"
+ *   value={gameIds}
+ *   onChange={(v) => setGameIds(v as string[])}
+ * />
+ * ```
+ *
+ * @returns {ReactElement} 业务选择器组件
+ */
+const PntBusinessSelect = props => {
+  const {
+    value,
+    onChange,
+    multiple = false,
+    scene = 'default',
+    statuses,
+    businessTypes,
+    labelFormat = 'name',
+    labelField,
+    optionLabel,
+    pagination = true,
+    onLoaded,
+    placeholder,
+    disabled,
+    clearable = true,
+    filterable = true,
+    max,
+    pageSize = 20,
+    searchDebounce = 400,
+    minCollapsedNum,
+    collapsedItems,
+    popupProps,
+    fields,
+    optionDisabled,
+    optionTooltip,
+    tooltipPlacement = 'top',
+    className,
+    style
+  } = props;
+
+  // ---- 内置请求函数（通过 PntProvider 注入的 http 实例） ----
+  const {
+    http
+  } = usePntConfig();
+  const requestFn = useCallback(params => businessSelectList(http, params), [http]);
+
+  // ---- 状态 ----
+  const [options, setOptions] = useState([]);
+  const [loading, setLoading] = useState(false);
+
+  // ---- Refs ----
+  const debounceRef = useRef();
+  const loadingRef = useRef(false);
+  /** 已选中项的完整数据缓存，确保搜索后选项仍能展示 label */
+  const selectedItemsRef = useRef(new Map());
+  /** 已发起过回填请求的 ID，避免重复请求 */
+  const requestedIdsRef = useRef(new Set());
+  /** 回填缓存更新标记，驱动 selectOptions 重新计算 */
+  const [cacheTick, setCacheTick] = useState(0);
+  /** onLoaded 用 ref 持有，避免消费方内联回调导致 fetchData 频繁重建 */
+  const onLoadedRef = useRef(onLoaded);
+  onLoadedRef.current = onLoaded;
+  /** 最新选项快照，供 fetchData 追加与 onLoaded 回调使用，避免进入请求依赖链 */
+  const optionsRef = useRef([]);
+  /** 请求序号：搜索/重置等替换请求发出后，在途的旧请求响应一律丢弃 */
+  const fetchSeqRef = useRef(0);
+  /** 翻页请求独立防重锁（不阻塞替换请求） */
+  const appendLoadingRef = useRef(false);
+  /** 当前列表元信息，触底回调据此校验，避免旧闭包的 keyword/pageNum 发错页 */
+  const listMetaRef = useRef({
+    keyword: '',
+    page: 0,
+    total: 0
+  });
+  /** 最新搜索词（输入即时同步，供关闭弹窗等场景读取） */
+  const keywordRef = useRef('');
+  /** 列表替换后的触底保护窗，吞掉内容骤短时浏览器 clamp 产生的残余滚动事件 */
+  const lastReplaceAtRef = useRef(0);
+  const SCROLL_GUARD_MS = 200;
+
+  // 数组类入参以内容序列化作为依赖，避免消费方内联字面量（fields={[...]}）
+  // 每次渲染产生新引用导致 buildParams/fetchData 频繁重建、初始请求被反复触发
+  const fieldsKey = (fields || []).join(',');
+  const statusesKey = (statuses || []).join(',');
+  const businessTypesKey = (businessTypes || []).join(',');
+
+  // ---- 构建请求参数 ----
+  const buildParams = useCallback((kw, page) => ({
+    keyword: kw || undefined,
+    // 后端规则：pageNum > 0 才开启分页；不分页模式必须传 0
+    pageNum: pagination ? page : 0,
+    pageSize: pagination ? pageSize : 0,
+    scene,
+    statuses,
+    business_types: businessTypes,
+    fields
+  }),
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [scene, statusesKey, businessTypesKey, pageSize, fieldsKey, pagination]);
+
+  // ---- 获取数据 ----
+  // append=true 为滚动翻页（追加），append=false 为初始化/搜索/重置（替换）
+  const fetchData = useCallback(async (kw, page, append) => {
+    if (append) {
+      if (appendLoadingRef.current || loadingRef.current) return;
+      const meta = listMetaRef.current;
+      if (meta.keyword !== kw) return;
+      if (page <= meta.page) return;
+      if (optionsRef.current.length >= meta.total) return;
+      appendLoadingRef.current = true;
+    }
+    const seq = ++fetchSeqRef.current;
+    loadingRef.current = true;
+    setLoading(true);
+    try {
+      const res = await requestFn(buildParams(kw, page));
+      if (seq !== fetchSeqRef.current) return;
+      if (res.code === 0 && res.data) {
+        const newList = res.data.list || [];
+        const resTotal = res.data.pagination?.total || 0;
+        let nextList;
+        if (append) {
+          const existed = new Set(optionsRef.current.map(o => o.game_id));
+          nextList = [...optionsRef.current, ...newList.filter(o => !existed.has(o.game_id))];
+        } else {
+          nextList = newList;
+          lastReplaceAtRef.current = Date.now();
+        }
+        optionsRef.current = nextList;
+        listMetaRef.current = {
+          keyword: kw,
+          page,
+          total: resTotal
+        };
+        setOptions(nextList);
+        onLoadedRef.current?.(nextList);
+      }
+    } catch {
+      // 请求失败静默处理，不阻塞主流程
+    } finally {
+      if (append) appendLoadingRef.current = false;
+      if (seq === fetchSeqRef.current) {
+        loadingRef.current = false;
+        setLoading(false);
+      }
+    }
+  }, [requestFn, buildParams]);
+
+  // ---- 远程搜索（防抖） ----
+  const handleSearch = useCallback(val => {
+    keywordRef.current = val;
+    if (debounceRef.current) clearTimeout(debounceRef.current);
+    debounceRef.current = setTimeout(() => {
+      fetchData(keywordRef.current, 1, false);
+    }, searchDebounce);
+  }, [fetchData, searchDebounce]);
+
+  // ---- 滚动触底加载下一页（全部读 ref，避免渲染闭包中的旧 keyword/pageNum） ----
+  const handleScrollToBottom = useCallback(() => {
+    // 列表刚替换后的短暂窗口内，触底多为滚动位置 clamp 的假事件，忽略
+    if (Date.now() - lastReplaceAtRef.current < SCROLL_GUARD_MS) return;
+    const meta = listMetaRef.current;
+    fetchData(meta.keyword, meta.page + 1, true);
+  }, [fetchData]);
+
+  // ---- 弹窗关闭时重置搜索 ----
+  const handlePopupVisibleChange = useCallback(visible => {
+    if (visible) return;
+    if (debounceRef.current) clearTimeout(debounceRef.current);
+    // 必须以「当前列表实际使用的关键词」为准，不能只看 keywordRef：
+    // 1) 单选选中一项后，TDesign 关闭弹窗时会先以 blur 触发 onSearch('')，
+    //    把 keywordRef 提前清空并挂一个重置 timer，随后本回调又会清掉该 timer，
+    //    若仅按 keywordRef 判断就会漏发重置请求；
+    // 2) 用户手动清空输入但未关闭下拉时，keywordRef 已为 ''，但列表仍残留
+    //    上次搜索结果，关闭时必须重置回默认列表。
+    keywordRef.current = '';
+    if (listMetaRef.current.keyword) {
+      fetchData('', 1, false);
+    }
+  }, [fetchData]);
+
+  // ---- 初始加载 + 筛选条件变化时重新加载 ----
+  useEffect(() => {
+    fetchData('', 1, false);
+  }, [fetchData]);
+
+  // ---- 缓存已选中项（确保搜索后仍能展示 label） ----
+  useEffect(() => {
+    const selectedValues = (Array.isArray(value) ? value : value ? [value] : []).map(String);
+    options.forEach(item => {
+      if (item.game_id && selectedValues.includes(item.game_id)) {
+        selectedItemsRef.current.set(item.game_id, item);
+      }
+    });
+  }, [options, value]);
+
+  // ---- 编辑回显：已选 ID 不在当前分页、缓存也没有时，按 game_ids 拉取 ----
+  // 不分页模式已全量加载，缺失即查无此项，无需补拉
+  useEffect(() => {
+    if (!pagination) return;
+    const selectedValues = (Array.isArray(value) ? value : value ? [value] : []).map(String);
+    const optionIds = new Set(options.map(item => item.game_id).filter(Boolean));
+    const missingIds = selectedValues.filter(id => id && !optionIds.has(id) && !selectedItemsRef.current.has(id) && !requestedIdsRef.current.has(id));
+    if (missingIds.length === 0) return;
+    missingIds.forEach(id => requestedIdsRef.current.add(id));
+    let cancelled = false;
+    (async () => {
+      try {
+        const res = await requestFn({
+          ...buildParams('', 1),
+          pageNum: 1,
+          pageSize: missingIds.length,
+          game_ids: missingIds,
+          keyword: undefined
+        });
+        if (cancelled || res.code !== 0 || !res.data?.list) return;
+        res.data.list.forEach(item => {
+          if (item.game_id) selectedItemsRef.current.set(item.game_id, item);
+        });
+        setCacheTick(tick => tick + 1);
+      } catch {
+        // 回填失败时 tag 降级显示原始 ID，不阻塞主流程
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [value, options, requestFn, buildParams, pagination]);
+
+  // ---- 组件卸载时清理防抖 ----
+  useEffect(() => {
+    return () => {
+      if (debounceRef.current) clearTimeout(debounceRef.current);
+    };
+  }, []);
+
+  // ---- 字符串标签（用于 tag 展示与过滤匹配） ----
+  // 不使用 optionLabel，因为它可能返回 ReactNode，无法作为 tag 文本
+  const getLabelText = useCallback(item => {
+    // 优先级：labelField > labelFormat
+    if (labelField) {
+      return item[labelField] || item.name || '';
+    }
+    const name = item.name || '';
+    const nameEn = item.name_en || '';
+    const gameId = item.game_id || '';
+    switch (labelFormat) {
+      case 'name_en':
+        return nameEn || name;
+      case 'name_id':
+        return `${name}（${gameId}）`;
+      case 'name_en_id':
+        return `${nameEn}（${gameId}）`;
+      default:
+        return name;
+    }
+  }, [labelFormat, labelField]);
+
+  // ---- 下拉选项富文本内容（可返回 ReactNode） ----
+  // 优先级：optionLabel > labelField > labelFormat
+  const formatLabel = useCallback(item => {
+    if (optionLabel) return optionLabel(item);
+    return getLabelText(item);
+  }, [optionLabel, getLabelText]);
+
+  // ---- 判断选项是否禁用（合规场景 creatable + 自定义 optionDisabled 叠加） ----
+  const isOptionDisabled = useCallback(item => {
+    if (scene === 'compliance_age' || scene === 'custom_region') {
+      if (item.creatable === false) return true;
+    }
+    return optionDisabled ? optionDisabled(item) : false;
+  }, [scene, optionDisabled]);
+
+  // ---- 计算选项 tooltip 内容 ----
+  const getOptionTooltip = useCallback(item => {
+    return optionTooltip ? optionTooltip(item) : '';
+  }, [optionTooltip]);
+
+  // ---- 构建最终选项（当前页 + 已选中项补充） ----
+  const selectOptions = useMemo(() => {
+    const map = new Map();
+
+    // 当前页选项
+    options.forEach(item => {
+      if (item.game_id) {
+        map.set(item.game_id, {
+          label: getLabelText(item),
+          content: formatLabel(item),
+          value: item.game_id,
+          disabled: isOptionDisabled(item),
+          name: item.name,
+          name_en: item.name_en,
+          game_id: item.game_id,
+          rawItem: item
+        });
+      }
+    });
+
+    // 已选中项（搜索结果不含时补充，确保 label 始终可展示）
+    const selectedValues = (Array.isArray(value) ? value : value ? [value] : []).map(String);
+    selectedValues.forEach(id => {
+      if (!map.has(id)) {
+        const item = selectedItemsRef.current.get(id);
+        if (item) {
+          map.set(id, {
+            label: getLabelText(item),
+            content: formatLabel(item),
+            value: id,
+            disabled: isOptionDisabled(item),
+            name: item.name,
+            name_en: item.name_en,
+            game_id: item.game_id,
+            rawItem: item
+          });
+        } else {
+          // 降级：无完整数据时显示原始 ID
+          map.set(id, {
+            label: id,
+            content: id,
+            value: id,
+            disabled: false
+          });
+        }
+      }
+    });
+    return Array.from(map.values());
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [options, value, formatLabel, getLabelText, isOptionDisabled, cacheTick]);
+
+  // ---- 本地过滤（与后端 keyword 逻辑一致：name / name_en / game_id） ----
+  const localFilter = useCallback((filterWord, option) => {
+    if (!filterWord) return true;
+    const kw = filterWord.toLowerCase();
+    const opt = option;
+    // 优先按 rawItem 的所有字符串字段匹配（含 labelField 指定字段）
+    const item = opt?.rawItem;
+    if (item) {
+      return Object.values(item).some(v => typeof v === 'string' && v.toLowerCase().includes(kw));
+    }
+    return (opt?.name || '').toLowerCase().includes(kw) || (opt?.name_en || '').toLowerCase().includes(kw) || (opt?.game_id || '').includes(kw);
+  }, []);
+  const {
+    Option
+  } = Select;
+
+  // 是否启用 tooltip（仅当 optionTooltip 传入时生效）
+  const hasTooltip = !!optionTooltip;
+
+  // 一次性加载模式：仅本地过滤，不触发远程搜索；不分页时禁用滚动触底
+  const enableRemoteSearch = filterable && pagination;
+  const enableScrollBottom = pagination;
+
+  // 统一将 value 归一化为字符串，与 Option 的 value（game_id 字符串）匹配，
+  // 避免消费方传入 number / number[] 时 tag 无法正确回显
+  const selectValue = useMemo(() => {
+    if (value === undefined || value === null) return value;
+    return Array.isArray(value) ? value.map(String) : String(value);
+  }, [value]);
+
+  // 包装 onChange：TDesign 在 children 模式下会把 Option 的 children（optionLabel
+  // 返回的 ReactNode，dev 环境带 _owner Fiber，存在循环引用）一并放进
+  // context.selectedOptions，消费方直接展开后提交会导致 JSON.stringify 报
+  // "Converting circular structure to JSON"。这里统一替换为纯业务数据对象。
+
+  const handleChange = useCallback((val, context) => {
+    if (!onChange) return;
+    const values = (Array.isArray(val) ? val : val !== undefined && val !== null ? [val] : []).map(String);
+    const ctxOptions = context?.selectedOptions || [];
+    const selectedOptions = values.map(id => {
+      const raw = optionsRef.current.find(o => o.game_id === id) || selectedItemsRef.current.get(id);
+      if (raw) {
+        return {
+          ...raw,
+          value: raw.game_id,
+          label: getLabelText(raw)
+        };
+      }
+      // 兜底：从 TDesign 上下文剥离 React 字段（children/content）
+      const fromCtx = ctxOptions.find(o => String(o.value) === id);
+      if (fromCtx) {
+        const rest = {
+          ...fromCtx
+        };
+        delete rest.children;
+        delete rest.content;
+        return rest;
+      }
+      return {
+        value: id,
+        label: id
+      };
+    });
+    onChange(val, {
+      ...context,
+      selectedOptions: multiple ? selectedOptions : selectedOptions.slice(0, 1)
+    });
+  }, [onChange, multiple, getLabelText]);
+
+  // 点击 clear 按钮（X）时重置列表——TDesign 的 onClearValue 只 setInputValue，
+  // 不触发 handleInputChange / onSearch，所以需要主动重置。
+  const handleClear = useCallback(() => {
+    keywordRef.current = '';
+    if (debounceRef.current) clearTimeout(debounceRef.current);
+    if (listMetaRef.current.keyword) {
+      fetchData('', 1, false);
+    }
+  }, [fetchData]);
+  return /*#__PURE__*/_jsx(Select, {
+    value: selectValue,
+    onChange: handleChange,
+    filterable: filterable,
+    filter: enableRemoteSearch ? undefined : filterable ? localFilter : undefined,
+    onSearch: enableRemoteSearch ? handleSearch : undefined,
+    onClear: enableRemoteSearch ? handleClear : undefined,
+    loading: loading && options.length === 0,
+    multiple: multiple,
+    max: max,
+    clearable: clearable,
+    disabled: disabled,
+    placeholder: placeholder,
+    minCollapsedNum: minCollapsedNum,
+    collapsedItems: collapsedItems,
+    onPopupVisibleChange: handlePopupVisibleChange,
+    panelBottomContent: options.length > 0 && loading ? /*#__PURE__*/_jsx(Loading, {
+      loading: true,
+      size: "small"
+    }) : null,
+    popupProps: {
+      ...popupProps,
+      // 自动注入弹层样式类，消费方无需重复定义 overlayClassName
+      overlayClassName: ['pnt-business-select-popup', popupProps?.overlayClassName].filter(Boolean).join(' '),
+      onScrollToBottom: enableScrollBottom ? handleScrollToBottom : undefined
+    },
+    className: className ? `pnt-business-select ${className}` : 'pnt-business-select',
+    style: style,
+    children: selectOptions.map(opt => {
+      const item = opt.rawItem;
+      const tip = hasTooltip && item ? getOptionTooltip(item) : '';
+      // 透传业务字段：TDesign 会将 Option 的 props 合入 onChange 的
+      // context.selectedOptions，消费方依赖 name / sdk_customize_notifier 等字段；
+      // value / label / disabled 放在后面覆盖，保证以组件内部计算为准
+      const optionProps = {
+        ...(item || {}),
+        value: opt.value,
+        label: opt.label,
+        disabled: opt.disabled
+      };
+      // Tooltip 必须放在 Option 内部：Select 通过直接子节点识别 Option，
+      // 外层包裹会破坏选项注册；且禁用项的 hover 事件由内部元素接收才稳定
+      return /*#__PURE__*/_jsx(Option, {
+        ...optionProps,
+        children: tip ? /*#__PURE__*/_jsx(Tooltip, {
+          content: tip,
+          placement: tooltipPlacement,
+          children: /*#__PURE__*/_jsx("span", {
+            className: "pnt-business-select-option-label",
+            children: opt.content
+          })
+        }) : opt.content
+      }, opt.value);
+    })
+  });
+};
+export default PntBusinessSelect;