@pnt-team/pnt-component-frontend 0.0.35 → 0.0.38

package/README.md

@@ -12,11 +12,11 @@ yarn add @pnt-team/pnt-component-frontend
 
 ### 依赖要求（peerDependencies）
 
-| 依赖 | 版本要求 | 说明 |
-|------|---------|------|
-| `react` | `>=16.9.0` | React 核心框架 |
-| `react-dom` | `>=16.9.0` | React DOM 渲染 |
-| `tdesign-react` | `>=1.5.0` | UI 组件库（本组件库基于 TDesign 封装） |
+| 依赖            | 版本要求   | 说明                                   |
+| --------------- | ---------- | -------------------------------------- |
+| `react`         | `>=16.9.0` | React 核心框架                         |
+| `react-dom`     | `>=16.9.0` | React DOM 渲染                         |
+| `tdesign-react` | `>=1.5.0`  | UI 组件库（本组件库基于 TDesign 封装） |
 
 > ⚠️ 请确保项目中已安装以上依赖，否则组件可能无法正常运行。
 
@@ -46,13 +46,13 @@ import {
 
 **Props：**
 
-| 属性 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `data` | `string \| (() => Promise<string>)` | ✅ | 需要复制的数据，支持字符串或异步函数 |
-| `tips` | `(isCopy: boolean, isFail: boolean) => ReactNode` | ✅ | 提示内容渲染函数 |
-| `contentFn` | `(props: { onClick, onMouseLeave }) => ReactNode` | ✅ | 触发元素渲染函数 |
-| `placement` | `PopupPlacement` | ❌ | Popup 弹出位置，默认由 TDesign 决定 |
-| `className` | `string` | ❌ | 自定义类名 |
+| 属性        | 类型                                              | 必填 | 说明                                 |
+| ----------- | ------------------------------------------------- | ---- | ------------------------------------ |
+| `data`      | `string \| (() => Promise<string>)`               | ✅   | 需要复制的数据，支持字符串或异步函数 |
+| `tips`      | `(isCopy: boolean, isFail: boolean) => ReactNode` | ✅   | 提示内容渲染函数                     |
+| `contentFn` | `(props: { onClick, onMouseLeave }) => ReactNode` | ✅   | 触发元素渲染函数                     |
+| `placement` | `PopupPlacement`                                  | ❌   | Popup 弹出位置，默认由 TDesign 决定  |
+| `className` | `string`                                          | ❌   | 自定义类名                           |
 
 **示例：**
 
@@ -84,13 +84,13 @@ import {
 
 **Props：**
 
-| 属性 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `iconUrl` | `string \| undefined` | ✅ | 图片 URL 地址 |
-| `loading` | `boolean` | ✅ | 上传加载状态 |
-| `defaultImg` | `string` | ❌ | 默认图片（不传则使用内置默认图） |
-| `params` | `{ style?: CSSProperties; [key: string]: any }` | ❌ | 自定义扩展参数 |
-| `onRemove` | `(e: any) => void` | ❌ | 删除回调函数 |
+| 属性         | 类型                                            | 必填 | 说明                             |
+| ------------ | ----------------------------------------------- | ---- | -------------------------------- |
+| `iconUrl`    | `string \| undefined`                           | ✅   | 图片 URL 地址                    |
+| `loading`    | `boolean`                                       | ✅   | 上传加载状态                     |
+| `defaultImg` | `string`                                        | ❌   | 默认图片（不传则使用内置默认图） |
+| `params`     | `{ style?: CSSProperties; [key: string]: any }` | ❌   | 自定义扩展参数                   |
+| `onRemove`   | `(e: any) => void`                              | ❌   | 删除回调函数                     |
 
 **示例：**
 
@@ -114,15 +114,15 @@ import {
 
 **Props：**
 
-| 属性 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `dataKey` | `string` | ✅ | 高敏信息的唯一标识 key |
-| `dataValue` | `string` | ✅ | 初始显示值（通常为脱敏后的数据） |
-| `env` | `string \| number` | ✅ | 环境标识（如 dev / test / production） |
-| `gameId` | `string \| number` | ✅ | 游戏 ID |
-| `renderDom` | `(content: string) => React.ReactNode` | ✅ | 自定义渲染函数 |
-| `viewText` | `string` | ❌ | 查看按钮文案，默认 `'View'` |
-| `pageId` | `string` | ❌ | 页面 ID（用于操作日志和权限验证） |
+| 属性        | 类型                                   | 必填 | 说明                                   |
+| ----------- | -------------------------------------- | ---- | -------------------------------------- |
+| `dataKey`   | `string`                               | ✅   | 高敏信息的唯一标识 key                 |
+| `dataValue` | `string`                               | ✅   | 初始显示值（通常为脱敏后的数据）       |
+| `env`       | `string \| number`                     | ✅   | 环境标识（如 dev / test / production） |
+| `gameId`    | `string \| number`                     | ✅   | 游戏 ID                                |
+| `renderDom` | `(content: string) => React.ReactNode` | ✅   | 自定义渲染函数                         |
+| `viewText`  | `string`                               | ❌   | 查看按钮文案，默认 `'View'`            |
+| `pageId`    | `string`                               | ❌   | 页面 ID（用于操作日志和权限验证）      |
 
 **示例：**
 
@@ -147,17 +147,17 @@ import {
 
 **参数：**
 
-| 参数 | 类型 | 说明 |
-|------|------|------|
+| 参数                  | 类型                                         | 说明                                   |
+| --------------------- | -------------------------------------------- | -------------------------------------- |
 | `onPaginationRequest` | `(params: { pageNumber, pageSize }) => void` | 分页变化时的回调，外部在此发起列表请求 |
 
 **返回值：**
 
-| 返回值 | 类型 | 说明 |
-|--------|------|------|
-| `paginationData` | `{ currentPage, totalCount, totalPage, pageSize }` | 当前分页数据 |
-| `setPaginationData` | `(data: PaginationData) => void` | 回写分页数据（通常由外部请求完成后调用） |
-| `paginationProps` | `PaginationProps \| undefined` | 可直接展开到 `<Pagination {...paginationProps} />` |
+| 返回值              | 类型                                               | 说明                                               |
+| ------------------- | -------------------------------------------------- | -------------------------------------------------- |
+| `paginationData`    | `{ currentPage, totalCount, totalPage, pageSize }` | 当前分页数据                                       |
+| `setPaginationData` | `(data: PaginationData) => void`                   | 回写分页数据（通常由外部请求完成后调用）           |
+| `paginationProps`   | `PaginationProps \| undefined`                     | 可直接展开到 `<Pagination {...paginationProps} />` |
 
 **示例：**
 
@@ -195,18 +195,18 @@ const Demo = () => {
 
 **参数：**
 
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `permissions` | `BtnPermissionMap` | 按钮权限映射 `{ [type]: { [key]: 1 \| -1 \| -2 } }` |
-| `demoGame` | `{ id: number \| string; name: string }` | 演示游戏信息 |
-| `serviceInfo` | `{ serviceType?, serviceName? }` | 当前服务信息 |
+| 参数          | 类型                                     | 说明                                                |
+| ------------- | ---------------------------------------- | --------------------------------------------------- |
+| `permissions` | `BtnPermissionMap`                       | 按钮权限映射 `{ [type]: { [key]: 1 \| -1 \| -2 } }` |
+| `demoGame`    | `{ id: number \| string; name: string }` | 演示游戏信息                                        |
+| `serviceInfo` | `{ serviceType?, serviceName? }`         | 当前服务信息                                        |
 
 **返回值：**
 
-| 返回值 | 类型 | 说明 |
-|--------|------|------|
-| `btnPermission` | `BtnPermissionMap` | 权限映射原文 |
-| `isDemoGame` | `boolean` | 是否为演示游戏 |
+| 返回值             | 类型                                          | 说明                                         |
+| ------------------ | --------------------------------------------- | -------------------------------------------- |
+| `btnPermission`    | `BtnPermissionMap`                            | 权限映射原文                                 |
+| `isDemoGame`       | `boolean`                                     | 是否为演示游戏                               |
 | `getBtnPermission` | `(type, key, defaultValue?) => 1 \| -1 \| -2` | 获取按钮权限（1 有权限 / -1 隐藏 / -2 禁用） |
 
 **示例：**
@@ -216,12 +216,19 @@ const Demo = ({ btnPermission, userInfo }) => {
   const { isDemoGame, getBtnPermission } = useBtnPermission({
     permissions: btnPermission,
     demoGame: userInfo?.demoGame,
-    serviceInfo: { serviceType: userInfo?.serviceType, serviceName: userInfo?.serviceName },
+    serviceInfo: {
+      serviceType: userInfo?.serviceType,
+      serviceName: userInfo?.serviceName,
+    },
   });
 
   const createPerm = getBtnPermission('global', 'create');
   if (createPerm === -1) return null; // 隐藏
-  return <Button disabled={createPerm === -2}>新建{isDemoGame ? '（演示）' : ''}</Button>;
+  return (
+    <Button disabled={createPerm === -2}>
+      新建{isDemoGame ? '（演示）' : ''}
+    </Button>
+  );
 };
 ```
 
@@ -233,11 +240,11 @@ const Demo = ({ btnPermission, userInfo }) => {
 
 **返回值：**
 
-| 返回值 | 类型 | 说明 |
-|--------|------|------|
-| `securityData` | `object` | 已解锁的高敏数据映射 `{ [key]: value }` |
-| `setSecurityData` | `(data: object) => void` | 手动设置已解锁数据 |
-| `requestSecurityData` | `({ gameId, param, env }) => void` | 请求解锁指定高敏数据 |
+| 返回值                | 类型                               | 说明                                    |
+| --------------------- | ---------------------------------- | --------------------------------------- |
+| `securityData`        | `object`                           | 已解锁的高敏数据映射 `{ [key]: value }` |
+| `setSecurityData`     | `(data: object) => void`           | 手动设置已解锁数据                      |
+| `requestSecurityData` | `({ gameId, param, env }) => void` | 请求解锁指定高敏数据                    |
 
 ---
 
@@ -247,14 +254,14 @@ const Demo = ({ btnPermission, userInfo }) => {
 
 **参数：**
 
-| 参数 | 类型 | 说明 |
-|------|------|------|
+| 参数      | 类型                                 | 说明                                         |
+| --------- | ------------------------------------ | -------------------------------------------- |
 | `fetcher` | `() => Promise<{ code, msg, data }>` | 自定义请求函数（不传则使用内置默认 fetcher） |
 
 **返回值：**
 
-| 返回值 | 类型 | 说明 |
-|--------|------|------|
+| 返回值           | 类型                                                                | 说明        |
+| ---------------- | ------------------------------------------------------------------- | ----------- |
 | `osPlatformList` | `{ os_list: OsItem[]; platform_list: PlatformItem[] } \| undefined` | OS/平台数据 |
 
 **示例：**
@@ -272,7 +279,7 @@ const { osPlatformList } = useOsPlatformList(() => http.get('/my/os/platform'));
     label: p.platform_name_zh,
     value: p.id,
   }))}
-/>
+/>;
 ```
 
 > 💡 如需强制刷新缓存，可调用 `clearOsPlatformListCache()` 清除全部缓存，或传入指定 fetcher 清除对应缓存。
@@ -301,14 +308,14 @@ yarn test
 
 ## 技术栈
 
-| 工具 | 用途 |
-|------|------|
-| [father4](https://github.com/umijs/father) | 组件库构建（ESM / CJS / UMD） |
-| [dumi2](https://d.umijs.org/) | 文档生成与开发调试 |
-| [TDesign React](https://tdesign.tencent.com/react) | UI 组件库（peerDependency） |
-| TypeScript | 类型安全 |
-| Sass | 样式方案 |
-| Jest | 单元测试 |
+| 工具                                               | 用途                          |
+| -------------------------------------------------- | ----------------------------- |
+| [father4](https://github.com/umijs/father)         | 组件库构建（ESM / CJS / UMD） |
+| [dumi2](https://d.umijs.org/)                      | 文档生成与开发调试            |
+| [TDesign React](https://tdesign.tencent.com/react) | UI 组件库（peerDependency）   |
+| TypeScript                                         | 类型安全                      |
+| Sass                                               | 样式方案                      |
+| Jest                                               | 单元测试                      |
 
 ## 相关资源
 

package/lib/cjs/components/PntSecureBox/index.d.ts

@@ -1,3 +1,4 @@
+import { type HighSecurityFetcher } from "../../hooks/useHighSecurity";
 import React, { FC } from 'react';
 import './index.scss';
 interface PntSecureBoxProps {
@@ -38,6 +39,11 @@ interface PntSecureBoxProps {
      * @description 用于记录操作日志和权限验证
      */
     pageId?: string;
+    /**
+     * 高敏数据请求函数
+     * @description 通过外部注入请求函数，避免组件库内部依赖敏感配置
+     */
+    fetcher: HighSecurityFetcher;
 }
 /**
  * 高敏信息展示统一组件
@@ -50,14 +56,19 @@ interface PntSecureBoxProps {
  * @param {(content: string) => React.ReactNode} props.renderDom - 自定义渲染函数
  * @param {string} [props.viewText] - 自定义查看按钮文案
  * @param {string} [props.pageId] - 页面 ID
+ * @param {HighSecurityFetcher} props.fetcher - 高敏数据请求函数
  *
  * @example
  * ```tsx
+ * import http from '@/utils/request';
+ * import { PntSecureBox } from '@pnt-team/pnt-component-frontend';
+ *
  * <PntSecureBox
  *   dataKey="userPhone"
  *   dataValue="138****8888"
  *   env="production"
  *   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/PntSecureBox/index.js

@@ -37,8 +37,17 @@ var import_utils = require("../../utils");
 var import_react = __toESM(require("react"));
 var import_index = require("./index.scss");
 var PntSecureBox = (prop) => {
-  const { dataKey, dataValue, env, gameId, renderDom, viewText, pageId } = prop;
-  const { securityData, requestSecurityData } = (0, import_useHighSecurity.useHighSecurity)();
+  const {
+    dataKey,
+    dataValue,
+    env,
+    gameId,
+    renderDom,
+    viewText,
+    pageId,
+    fetcher
+  } = prop;
+  const { securityData, requestSecurityData } = (0, import_useHighSecurity.useHighSecurity)(fetcher);
   return /* @__PURE__ */ import_react.default.createElement("div", { className: "pnt-secure-box" }, /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, renderDom(
     (0, import_utils.isSecurityData)(dataValue) ? securityData[dataKey] || "******" : dataValue
   ), (0, import_utils.isSecurityData)(dataValue) && !securityData.hasOwnProperty(dataKey) && /* @__PURE__ */ import_react.default.createElement(

package/lib/cjs/hooks/useHighSecurity.d.ts

@@ -1,6 +1,48 @@
-/// <reference types="react" />
-export declare const useHighSecurity: () => {
-    securityData: any;
-    setSecurityData: import("react").Dispatch<any>;
-    requestSecurityData: ({ gameId, param, env }: any) => Promise<void>;
+/** 高敏数据请求参数 */
+export interface HighSecurityRequestParams {
+    /** 游戏 ID */
+    gameId: string | number;
+    /** 环境标识 */
+    env: string | number;
+    /** 页面 ID（不传则默认取 location.pathname） */
+    pageId?: string;
+    /** 需要解锁的参数列表 */
+    param: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/** 高敏数据请求函数：返回 { ret, data } 结构且 ret === 0 视为成功 */
+export type HighSecurityFetcher = (params: HighSecurityRequestParams) => Promise<{
+    ret: number;
+    data?: Array<{
+        key: string;
+        value: string;
+    }>;
+}>;
+/**
+ * 高敏数据解锁 Hook（L3 业务 Hook）
+ *
+ * 管理高敏数据的解锁状态。零业务侵入：请求函数通过 fetcher 注入，
+ * 不再依赖内部 api/configs，避免将敏感配置打包进发布产物。
+ *
+ * @param fetcher 自定义高敏数据请求函数，需返回 { ret, data } 结构且 ret === 0 视为成功
+ * @returns securityData 已解锁的高敏数据映射；requestSecurityData 请求解锁指定数据
+ *
+ * @example
+ * ```tsx
+ * import http from '@/utils/request';
+ * import { useHighSecurity } from '@pnt-team/pnt-component-frontend';
+ *
+ * const Demo = () => {
+ *   const { securityData, requestSecurityData } = useHighSecurity((params) =>
+ *     http.post('/api/v3/business/game_info/high-security-decrypt', params).then(r => r.data)
+ *   );
+ *   // ...
+ * };
+ * ```
+ */
+export declare const useHighSecurity: (fetcher: HighSecurityFetcher) => {
+    securityData: Record<string, string>;
+    requestSecurityData: ({ gameId, param, env, pageId, }: HighSecurityRequestParams) => Promise<void>;
 };

package/lib/cjs/hooks/useHighSecurity.js

@@ -22,26 +22,39 @@ __export(useHighSecurity_exports, {
   useHighSecurity: () => useHighSecurity
 });
 module.exports = __toCommonJS(useHighSecurity_exports);
-var import_api = require("../api");
 var import_react = require("react");
-var useHighSecurity = () => {
-  const [securityData, setSecurityData] = (0, import_react.useState)({});
-  const requestSecurityData = async ({ gameId, param, env }) => {
-    var _a;
-    const { ret, data } = await (0, import_api.highSecurity)({
+var securityCache = /* @__PURE__ */ new Map();
+var useHighSecurity = (fetcher) => {
+  const [securityData, setSecurityData] = (0, import_react.useState)(
+    () => {
+      const cached = {};
+      securityCache.forEach((value, key) => {
+        cached[key] = value;
+      });
+      return cached;
+    }
+  );
+  const requestSecurityData = async ({
+    gameId,
+    param,
+    env,
+    pageId
+  }) => {
+    const result = await fetcher({
+      gameId,
       env: Number(env),
-      game_id: Number(gameId),
-      page_id: location.pathname,
+      pageId: pageId || location.pathname,
       param
     });
-    if (ret === 0) {
-      securityData[param == null ? void 0 : param[0].key] = (_a = data == null ? void 0 : data[0]) == null ? void 0 : _a.value;
-      setSecurityData({ ...securityData });
+    if (result.ret === 0 && result.data) {
+      result.data.forEach((item) => {
+        securityCache.set(item.key, item.value);
+      });
+      setSecurityData(Object.fromEntries(securityCache));
     }
   };
   return {
     securityData,
-    setSecurityData,
     requestSecurityData
   };
 };

package/lib/cjs/hooks/useOsPlatformList.d.ts

@@ -1,4 +1,3 @@
-import { commonEesType } from '../utils/request';
 /** OS 平台数据类型定义 */
 export interface OsItem {
     id: number;
@@ -17,14 +16,12 @@ export interface OsPlatformData {
     os_list: OsItem[];
     platform_list: PlatformItem[];
 }
-/** OS/平台列表请求函数：返回与 src/utils/request 响应拦截器解析后的结构一致（{ code, msg, data }） */
-export type OsPlatformFetcher = () => Promise<commonEesType<OsPlatformData>>;
-/**
- * 默认 fetcher：基于 src/utils/request 请求 OS/平台枚举接口。
- * 与源项目 account-business-frontend 的 getOsPlatformList 接口路径一致；
- * audience 参数由 request 拦截器自动补齐。
- */
-export declare const defaultOsPlatformFetcher: OsPlatformFetcher;
+/** OS/平台列表请求函数：返回 { code, msg, data } 结构且 code === 0 视为成功 */
+export type OsPlatformFetcher = () => Promise<{
+    code: number;
+    msg: string;
+    data: OsPlatformData;
+}>;
 /**
  * 清除缓存（用于极少数需要强制刷新的场景，如后台更新了平台列表后）。
  * @param fetcher 指定要清除的 fetcher；不传则清除全部缓存
@@ -36,20 +33,21 @@ export declare const clearOsPlatformListCache: (fetcher?: OsPlatformFetcher) =>
  * 拉取 OS 与平台枚举数据并做模块级缓存，整个会话只请求一次；
  * 并发调用共享同一个进行中的请求。
  *
- * 零业务侵入：数据接口通过 fetcher 注入，不传时使用内置默认 fetcher
- * （基于 src/utils/request 请求 /api/internal/business/manage/osPlatformList）。
+ * 零业务侵入：数据接口通过 fetcher 注入，不再依赖内部 request/configs，
+ * 避免将敏感配置打包进发布产物。
  *
  * @param fetcher 自定义请求函数，需返回 { code, msg, data } 结构且 code === 0 视为成功
  * @returns osPlatformList OS/平台数据，请求完成或命中缓存前为 undefined
  *
  * @example
  * ```tsx
- * import { useOsPlatformList } from '@pnt/business-components';
+ * import http from '@/utils/request';
+ * import { useOsPlatformList } from '@pnt-team/pnt-component-frontend';
  *
  * const Demo = () => {
- *   const { osPlatformList } = useOsPlatformList();
- *   // 或注入自定义 fetcher（建议用 useCallback 保持引用稳定）
- *   // const { osPlatformList } = useOsPlatformList(() => http.get('/my/os/platform'));
+ *   const { osPlatformList } = useOsPlatformList(() =>
+ *     http.get('/api/internal/business/manage/osPlatformList').then(r => r.data)
+ *   );
  *
  *   return (
  *     <Select
@@ -62,7 +60,7 @@ export declare const clearOsPlatformListCache: (fetcher?: OsPlatformFetcher) =>
  * };
  * ```
  */
-export declare const useOsPlatformList: (fetcher?: OsPlatformFetcher) => {
+export declare const useOsPlatformList: (fetcher: OsPlatformFetcher) => {
     osPlatformList: OsPlatformData | undefined;
 };
 export default useOsPlatformList;

package/lib/cjs/hooks/useOsPlatformList.js

@@ -1,8 +1,6 @@
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,14 +14,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/hooks/useOsPlatformList.ts
@@ -31,13 +21,10 @@ var useOsPlatformList_exports = {};
 __export(useOsPlatformList_exports, {
   clearOsPlatformListCache: () => clearOsPlatformListCache,
   default: () => useOsPlatformList_default,
-  defaultOsPlatformFetcher: () => defaultOsPlatformFetcher,
   useOsPlatformList: () => useOsPlatformList
 });
 module.exports = __toCommonJS(useOsPlatformList_exports);
 var import_react = require("react");
-var import_request = __toESM(require("../utils/request"));
-var defaultOsPlatformFetcher = () => import_request.default.get("/api/internal/business/manage/osPlatformList");
 var cacheMap = /* @__PURE__ */ new Map();
 var fetchOsPlatformList = async (fetcher) => {
   const cached = cacheMap.get(fetcher);
@@ -68,13 +55,11 @@ var clearOsPlatformListCache = (fetcher) => {
     cacheMap.clear();
   }
 };
-var useOsPlatformList = (fetcher = defaultOsPlatformFetcher) => {
-  const [osPlatformList, setOsPlatformList] = (0, import_react.useState)(
-    () => {
-      var _a;
-      return (_a = cacheMap.get(fetcher)) == null ? void 0 : _a.data;
-    }
-  );
+var useOsPlatformList = (fetcher) => {
+  const [osPlatformList, setOsPlatformList] = (0, import_react.useState)(() => {
+    var _a;
+    return (_a = cacheMap.get(fetcher)) == null ? void 0 : _a.data;
+  });
   (0, import_react.useEffect)(() => {
     var _a;
     const cached = (_a = cacheMap.get(fetcher)) == null ? void 0 : _a.data;
@@ -99,6 +84,5 @@ var useOsPlatformList_default = useOsPlatformList;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clearOsPlatformListCache,
-  defaultOsPlatformFetcher,
   useOsPlatformList
 });

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

@@ -1,3 +1,4 @@
+import { type HighSecurityFetcher } from "../../hooks/useHighSecurity";
 import React, { FC } from 'react';
 import './index.scss';
 interface PntSecureBoxProps {
@@ -38,6 +39,11 @@ interface PntSecureBoxProps {
      * @description 用于记录操作日志和权限验证
      */
     pageId?: string;
+    /**
+     * 高敏数据请求函数
+     * @description 通过外部注入请求函数，避免组件库内部依赖敏感配置
+     */
+    fetcher: HighSecurityFetcher;
 }
 /**
  * 高敏信息展示统一组件
@@ -50,14 +56,19 @@ interface PntSecureBoxProps {
  * @param {(content: string) => React.ReactNode} props.renderDom - 自定义渲染函数
  * @param {string} [props.viewText] - 自定义查看按钮文案
  * @param {string} [props.pageId] - 页面 ID
+ * @param {HighSecurityFetcher} props.fetcher - 高敏数据请求函数
  *
  * @example
  * ```tsx
+ * import http from '@/utils/request';
+ * import { PntSecureBox } from '@pnt-team/pnt-component-frontend';
+ *
  * <PntSecureBox
  *   dataKey="userPhone"
  *   dataValue="138****8888"
  *   env="production"
  *   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/esm/components/PntSecureBox/index.js

@@ -1,11 +1,22 @@
 // src/components/PntSecureBox/index.tsx
-import { useHighSecurity } from "../../hooks/useHighSecurity";
+import {
+  useHighSecurity
+} from "../../hooks/useHighSecurity";
 import { isSecurityData } from "../../utils";
 import React from "react";
 import "./index.scss";
 var PntSecureBox = (prop) => {
-  const { dataKey, dataValue, env, gameId, renderDom, viewText, pageId } = prop;
-  const { securityData, requestSecurityData } = useHighSecurity();
+  const {
+    dataKey,
+    dataValue,
+    env,
+    gameId,
+    renderDom,
+    viewText,
+    pageId,
+    fetcher
+  } = prop;
+  const { securityData, requestSecurityData } = useHighSecurity(fetcher);
   return /* @__PURE__ */ React.createElement("div", { className: "pnt-secure-box" }, /* @__PURE__ */ React.createElement(React.Fragment, null, renderDom(
     isSecurityData(dataValue) ? securityData[dataKey] || "******" : dataValue
   ), isSecurityData(dataValue) && !securityData.hasOwnProperty(dataKey) && /* @__PURE__ */ React.createElement(

package/lib/esm/hooks/useHighSecurity.d.ts

@@ -1,6 +1,48 @@
-/// <reference types="react" />
-export declare const useHighSecurity: () => {
-    securityData: any;
-    setSecurityData: import("react").Dispatch<any>;
-    requestSecurityData: ({ gameId, param, env }: any) => Promise<void>;
+/** 高敏数据请求参数 */
+export interface HighSecurityRequestParams {
+    /** 游戏 ID */
+    gameId: string | number;
+    /** 环境标识 */
+    env: string | number;
+    /** 页面 ID（不传则默认取 location.pathname） */
+    pageId?: string;
+    /** 需要解锁的参数列表 */
+    param: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/** 高敏数据请求函数：返回 { ret, data } 结构且 ret === 0 视为成功 */
+export type HighSecurityFetcher = (params: HighSecurityRequestParams) => Promise<{
+    ret: number;
+    data?: Array<{
+        key: string;
+        value: string;
+    }>;
+}>;
+/**
+ * 高敏数据解锁 Hook（L3 业务 Hook）
+ *
+ * 管理高敏数据的解锁状态。零业务侵入：请求函数通过 fetcher 注入，
+ * 不再依赖内部 api/configs，避免将敏感配置打包进发布产物。
+ *
+ * @param fetcher 自定义高敏数据请求函数，需返回 { ret, data } 结构且 ret === 0 视为成功
+ * @returns securityData 已解锁的高敏数据映射；requestSecurityData 请求解锁指定数据
+ *
+ * @example
+ * ```tsx
+ * import http from '@/utils/request';
+ * import { useHighSecurity } from '@pnt-team/pnt-component-frontend';
+ *
+ * const Demo = () => {
+ *   const { securityData, requestSecurityData } = useHighSecurity((params) =>
+ *     http.post('/api/v3/business/game_info/high-security-decrypt', params).then(r => r.data)
+ *   );
+ *   // ...
+ * };
+ * ```
+ */
+export declare const useHighSecurity: (fetcher: HighSecurityFetcher) => {
+    securityData: Record<string, string>;
+    requestSecurityData: ({ gameId, param, env, pageId, }: HighSecurityRequestParams) => Promise<void>;
 };