@pnt-team/pnt-component-frontend 0.0.73 → 0.0.75

package/README.md

@@ -22,11 +22,23 @@ yarn add @pnt-team/pnt-component-frontend
 
 ## 快速开始
 
+使用前需在应用根入口用 `PntProvider` 注入 http 实例（消费方已配置好的 axios）：
+
+```tsx
+import { PntProvider } from '@pnt-team/pnt-component-frontend';
+import http from '你的项目中的 axios 实例';
+
+<PntProvider value={{ http }}>
+  <App />
+</PntProvider>;
+```
+
 ```tsx
 import {
   // L1 基础展示组件
   PntImagePreview,
   // L2 业务复合组件
+  PntBusinessSelect,
   PntSecureBox,
   // L3 布局组件
   PntGeneralLayout,
@@ -67,9 +79,45 @@ import {
 
 ### L2 业务复合组件
 
+#### PntBusinessSelect — 业务选择器组件
+
+统一业务下拉选择器，内置对接后端通用接口 `/api/business/select/list`，支持远程搜索、滚动分页加载、多选、场景化禁用。
+
+**Props：**
+
+| 属性          | 类型                                                        | 必填 | 默认值      | 说明           |
+| ------------- | ----------------------------------------------------------- | :--: | ----------- | -------------- |
+| `value`       | `SelectValue`                                               |  ❌  | -           | 当前选中值     |
+| `onChange`    | `TdSelectProps['onChange']`                                 |  ❌  | -           | 值变化回调     |
+| `multiple`    | `boolean`                                                   |  ❌  | `false`     | 是否多选       |
+| `scene`       | `'default' \| 'sdk' \| 'compliance_age' \| 'custom_region'` |  ❌  | `'default'` | 下拉场景       |
+| `statuses`    | `number[]`                                                  |  ❌  | -           | 业务状态筛选   |
+| `labelFormat` | `'name' \| 'name_en' \| 'name_id' \| 'name_en_id'`          |  ❌  | `'name'`    | 标签格式       |
+| `filterable`  | `boolean`                                                   |  ❌  | `true`      | 是否可远程搜索 |
+| `pagination`  | `boolean`                                                   |  ❌  | `true`      | 是否分页       |
+| `placeholder` | `string`                                                    |  ❌  | -           | 占位提示文案   |
+| `disabled`    | `boolean`                                                   |  ❌  | `false`     | 是否禁用       |
+| `popupProps`  | `Partial<TdSelectProps['popupProps']>`                      |  ❌  | -           | 弹层属性透传   |
+
+**示例：**
+
+```tsx
+import { PntBusinessSelect } from '@pnt-team/pnt-component-frontend';
+
+<PntBusinessSelect
+  scene="compliance_age"
+  labelFormat="name_id"
+  placeholder="请选择业务"
+  value={gameId}
+  onChange={(v) => setGameId(v as string)}
+/>;
+```
+
+---
+
 #### PntSecureBox — 高敏信息展示组件
 
-统一处理和展示高敏信息，支持脱敏显示和按需获取真实数据。通过外部注入 `fetcher` 请求函数解锁敏感数据，零内部依赖。
+统一处理和展示高敏信息，支持脱敏显示和按需获取真实数据。通过 `PntProvider` 注入的 http 实例请求解锁敏感数据。
 
 **Props：**
 
@@ -80,26 +128,19 @@ import {
 | `env`       | `string \| number`                     | ✅   | 环境标识（如 dev / test / production） |
 | `gameId`    | `string \| number`                     | ✅   | 游戏 ID                                |
 | `renderDom` | `(content: string) => React.ReactNode` | ✅   | 自定义渲染函数                         |
-| `fetcher`   | `HighSecurityFetcher`                  | ✅   | 高敏数据请求函数（外部注入）           |
 | `viewText`  | `string`                               | ❌   | 查看按钮文案，默认 `'View'`            |
 | `pageId`    | `string`                               | ❌   | 页面 ID（用于操作日志和权限验证）      |
 
 **示例：**
 
 ```tsx
-import http from '@/utils/request';
 import { PntSecureBox } from '@pnt-team/pnt-component-frontend';
 
 <PntSecureBox
   dataKey="userPhone"
-  dataValue="138****8888"
-  env="production"
+  dataValue="_high_security_:AAAA...:6542"
+  env={2}
   gameId={12345}
-  fetcher={(params) =>
-    http
-      .post('/api/v3/business/game_info/high-security-decrypt', params)
-      .then((r) => r.data)
-  }
   renderDom={(content) => <span>{content}</span>}
   viewText="查看"
 />;

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

@@ -273,6 +273,11 @@ var PntBusinessSelect = (props) => {
       panelBottomContent: options.length > 0 && loading ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_tdesign_react.Loading, { loading: true, size: "small" }) : null,
       popupProps: {
         ...popupProps,
+        // 自动注入弹层样式类，消费方无需重复定义 overlayClassName
+        overlayClassName: [
+          "pnt-business-select-popup",
+          popupProps == null ? void 0 : popupProps.overlayClassName
+        ].filter(Boolean).join(" "),
         onScrollToBottom: enableScrollBottom ? handleScrollToBottom : void 0
       },
       className: className ? `pnt-business-select ${className}` : "pnt-business-select",

package/lib/cjs/components/PntBusinessSelect/index.scss

@@ -6,3 +6,22 @@
   display: block;
   width: 100%;
 }
+
+/* 弹层内容样式：loading / total-wrapper 统一高度与排版 */
+.pnt-business-select-popup {
+  .t-popup__content {
+    .total-wrapper,
+    .t-loading {
+      height: 36px;
+      font-weight: 400;
+      line-height: 20px;
+      display: flex;
+      align-items: center;
+      padding: 0 14px;
+    }
+    .total-wrapper {
+      color: #808191;
+      font-size: 14px;
+    }
+  }
+}

package/lib/esm/api/index.js

@@ -1,10 +1,13 @@
-// src/api/index.ts
-var businessSelectList = (axios, data) => axios.post("/business/select/list?audience=/player-network", data);
-var businessGameInfoHighSecurityDecrypt = (axios, data) => axios.post(
-  "/v3/business/game_info/high-security-decrypt?audience=/laas-pnt",
-  data
-);
-export {
-  businessGameInfoHighSecurityDecrypt,
-  businessSelectList
-};
+/**
+ * 业务下拉选择列表
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数
+ */
+export const businessSelectList = (axios, data) => axios.post('/business/select/list?audience=/player-network', data);
+
+/**
+ * 高敏信息解锁
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数
+ */
+export const businessGameInfoHighSecurityDecrypt = (axios, data) => axios.post('/v3/business/game_info/high-security-decrypt?audience=/laas-pnt', data);

package/lib/esm/api/types/index.js

@@ -0,0 +1 @@
+export {};