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

package/lib/cjs/api/index.d.ts

@@ -0,0 +1,15 @@
+import type { commonEesType } from "../config";
+import type { AxiosInstance } from 'axios';
+import { BusinessGameInfoHighSecurityDecryptBody, BusinessGameInfoHighSecurityDecryptResponse, BusinessSelectListBody, BusinessSelectListResponse } from './types/index';
+/**
+ * 业务下拉选择列表
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数
+ */
+export declare const businessSelectList: (axios: AxiosInstance, data: BusinessSelectListBody) => Promise<commonEesType<BusinessSelectListResponse>>;
+/**
+ * 高敏信息解锁
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数
+ */
+export declare const businessGameInfoHighSecurityDecrypt: (axios: AxiosInstance, data: BusinessGameInfoHighSecurityDecryptBody) => Promise<commonEesType<BusinessGameInfoHighSecurityDecryptResponse>>;

package/lib/cjs/api/types/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 本文件由 yapi-gen 自动生成，请勿手动修改
+ * 生成时间: 2026/9/10 11:19:01
+ * 数据来源: https://api-pnt.intlgame.com
+ */
+export interface BusinessSelectListBody {
+    /** 业务接入类型：1-纯SDK，2-LI PASS，3-工作室品牌账号 */
+    business_access_method?: number;
+    /** 业务类型列表：1-正式业务，2-测试业务；SmartLink业务始终不返回 */
+    business_types?: number[];
+    /** 需要返回的字段；未传时使用场景默认字段，仅支持服务端白名单字段 */
+    fields?: string[];
+    /** 指定业务ID列表；与 Keyword 同时传入时取交集 */
+    game_ids?: string[];
+    /** 业务ID、中文名称或英文名称的模糊匹配关键字 */
+    keyword?: string;
+    /** 当前页 */
+    pageNum?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 下拉场景：default-通用业务，sdk-SDK定制，compliance_age-合规年龄，custom_region-自定义合规地域 */
+    scene?: string;
+    /** 业务状态列表：3-线上运营，4-接入中，5-中途结项，6-已下线 */
+    statuses?: number[];
+    /** 总条数 */
+    total?: number;
+    /** 总页数 */
+    totalPage?: number;
+}
+export interface BusinessSelectListResponseListItem {
+    /** 业务接入类型：1-纯SDK，2-LI PASS，3-工作室品牌账号 */
+    business_access_method?: number;
+    /** 业务类型：1-正式业务，2-测试业务 */
+    business_type?: number;
+    /** 当前场景是否可创建；仅 compliance_age、custom_region 场景有意义 */
+    creatable?: boolean;
+    /** 业务ID */
+    game_id?: string;
+    /** 业务接口开发负责人；SDK场景可返回 */
+    interface_developer_name?: string;
+    /** 业务中文名称 */
+    name?: string;
+    /** 业务英文名称 */
+    name_en?: string;
+    /** SDK定制版本通知人；SDK场景可返回 */
+    sdk_customize_notifier?: string;
+    /** 业务状态：3-线上运营，4-接入中，5-中途结项，6-已下线 */
+    state?: number;
+}
+export interface BusinessSelectListResponsePagination {
+    /** 当前页 */
+    pageNum?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 总条数 */
+    total?: number;
+    /** 总页数 */
+    totalPage?: number;
+}
+export interface BusinessSelectListResponse {
+    /** 业务列表；字段由请求 Fields 或场景默认字段决定 */
+    list?: BusinessSelectListResponseListItem[];
+    /** 分页信息；未分页时统计字段均为零值 */
+    pagination?: BusinessSelectListResponsePagination;
+}
+export interface BusinessGameInfoHighSecurityDecryptBodyParamItem {
+    /** 参数字段 */
+    key: string;
+    /** 参数密文 */
+    value: string;
+}
+export interface BusinessGameInfoHighSecurityDecryptBody {
+    param: BusinessGameInfoHighSecurityDecryptBodyParamItem[];
+    /** 页面ID */
+    page_id: string;
+    /** 请求环境 */
+    env: number;
+    game_id: number;
+}
+export type BusinessGameInfoHighSecurityDecryptResponse = Record<string, unknown>[];

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

@@ -0,0 +1,191 @@
+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 1-纯SDK，2-LI PASS，3-工作室品牌账号
+     */
+    businessAccessMethod?: 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 返回 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/cjs/components/PntGeneralLayout/index.d.ts

@@ -0,0 +1,82 @@
+import React, { FunctionComponent, ReactNode, Ref } from 'react';
+import './index.scss';
+interface PntGeneralLayoutProps {
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 头部标题内容
+     * @description 传入后将渲染 Layout Header 区域
+     */
+    headerTitle?: ReactNode;
+    /**
+     * 是否显示返回按钮
+     * @default false
+     */
+    showBackButton?: boolean;
+    /**
+     * 返回按钮点击回调
+     */
+    onBackButtonClick?: (() => void) | undefined;
+    /**
+     * 子头部内容
+     * @description 位于 Header 下方，常用于放置面包屑、Tab 等
+     */
+    subHeaderContent?: ReactNode;
+    /**
+     * 头部右侧操作区
+     * @description 常用于放置按钮组
+     */
+    operation?: ReactNode;
+    /**
+     * 内容区 ref
+     */
+    bodyRef?: Ref<HTMLDivElement>;
+    /**
+     * 页面主体内容
+     */
+    children?: ReactNode;
+    /**
+     * 内容区自定义样式
+     */
+    bodyStyle?: React.CSSProperties;
+    /**
+     * 底部内容
+     * @description 传入后将渲染 Layout Footer 区域，常用于放置操作按钮
+     */
+    footer?: ReactNode;
+}
+/**
+ * 通用页面布局组件（L3 布局组件）
+ * @description 提供标准的「头部 + 子头部 + 内容区 + 底部」页面布局结构，
+ * 基于 TDesign Layout 封装，适用于后台管理系统的详情页、表单页等场景。
+ *
+ * @example
+ * ```tsx
+ * // 基础用法：仅内容区
+ * <PntGeneralLayout>
+ *   <div>页面内容</div>
+ * </PntGeneralLayout>
+ *
+ * // 带标题和操作按钮
+ * <PntGeneralLayout
+ *   headerTitle="页面标题"
+ *   operation={<><Button>保存</Button><Button>取消</Button></>}
+ * >
+ *   <Form />
+ * </PntGeneralLayout>
+ *
+ * // 带返回按钮和底部
+ * <PntGeneralLayout
+ *   headerTitle="详情页"
+ *   showBackButton
+ *   onBackButtonClick={() => history.back()}
+ *   footer={<><Button>提交</Button><Button>重置</Button></>}
+ * >
+ *   <Detail />
+ * </PntGeneralLayout>
+ * ```
+ */
+declare const PntGeneralLayout: FunctionComponent<PntGeneralLayoutProps>;
+export default PntGeneralLayout;

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

@@ -0,0 +1,75 @@
+import React, { FC } from 'react';
+import './index.scss';
+interface PntImagePreviewProps {
+    /**
+     * 当前图片组件 URL
+     * @description 图片的完整 URL 地址，用于显示已上传的图片
+     */
+    iconUrl: string | undefined;
+    /**
+     * 上传加载状态
+     * @description 当为 true 时显示上传加载状态，阻止其他操作
+     */
+    loading: boolean;
+    /**
+     * 默认图片
+     * @description 支持传入默认封面图片，不传入则使用默认的 uploadImg 作为默认图片
+     */
+    defaultImg?: string;
+    /**
+     * 自定义扩展参数
+     * @description 用于传递额外的配置选项，如样式等
+     */
+    params?: {
+        /** 自定义样式 */
+        style?: React.CSSProperties;
+        /** 其他可扩展配置 */
+        [key: string]: any;
+    };
+    /**
+     * 删除回调函数
+     * @description 当点击删除图标时触发的回调函数
+     * @param e - 事件对象
+     */
+    onRemove?: (e: any) => void;
+}
+/**
+ * 上传图片查看器组件
+ * @description 用于展示上传的图片，支持预览、删除功能和上传状态显示
+ * @param {PntImagePreviewProps} props - 组件属性
+ * @param {string | undefined} props.iconUrl - 当前图片组件 URL
+ * @param {boolean} props.loading - 上传加载状态
+ * @param {string} [props.defaultImg] - 默认图片
+ * @param {object} [props.params] - 自定义扩展参数
+ * @param {function} [props.onRemove] - 删除回调函数
+ *
+ * @example
+ * ```tsx
+ * // 基础用法
+ * <UploadImageViewer
+ *   iconUrl={imageUrl}
+ *   loading={uploading}
+ *   onRemove={handleRemove}
+ * />
+ *
+ * // 带默认图片
+ * <UploadImageViewer
+ *   iconUrl={imageUrl}
+ *   loading={false}
+ *   defaultImg="/path/to/default.png"
+ *   onRemove={handleRemove}
+ * />
+ *
+ * // 自定义样式
+ * <UploadImageViewer
+ *   iconUrl={imageUrl}
+ *   loading={uploading}
+ *   params={{ style: { width: '200px', height: '200px' } }}
+ *   onRemove={handleRemove}
+ * />
+ * ```
+ *
+ * @returns {ReactElement} 上传图片查看器组件
+ */
+declare const PntImagePreview: FC<PntImagePreviewProps>;
+export default PntImagePreview;

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

@@ -0,0 +1,73 @@
+import React, { FC } from 'react';
+import './index.scss';
+interface PntSecureBoxProps {
+    /**
+     * 高敏信息的唯一标识 key
+     * @description 用于标识和存储特定的高敏数据项
+     */
+    dataKey: string;
+    /**
+     * 高敏信息的实际值
+     * @description 初始显示的值，通常为脱敏后的数据
+     */
+    dataValue: string;
+    /**
+     * 环境标识
+     * @description 用于区分不同环境（如：dev, test, production）
+     */
+    env: string | number;
+    /**
+     * 游戏 ID
+     * @description 标识具体的游戏项目
+     */
+    gameId: string | number;
+    /**
+     * 自定义渲染函数
+     * @description 接收处理后的数据作为参数，返回需要渲染的 React 元素
+     * @param content - 处理后的数据内容（真实数据或脱敏数据）
+     * @returns React 元素
+     */
+    renderDom: (content: string) => React.ReactNode;
+    /**
+     * 自定义查看按钮文案
+     * @description 用于适配多语言场景，默认为 'View'
+     */
+    viewText?: string;
+    /**
+     * 页面 ID
+     * @description 用于记录操作日志和权限验证
+     */
+    pageId?: string;
+}
+/**
+ * 高敏信息展示统一组件
+ * @description 用于统一处理和展示高敏信息，支持脱敏显示和按需获取真实数据。
+ * 通过 PntProvider 注入 http 实例，对接 `/api/v3/business/game_info/high-security-decrypt`。
+ *
+ * @param {PntSecureBoxProps} props - 组件属性
+ * @param {string} props.dataKey - 高敏信息的唯一标识 key
+ * @param {string} props.dataValue - 高敏信息的实际值
+ * @param {string | number} props.env - 环境标识
+ * @param {string | number} props.gameId - 游戏 ID
+ * @param {(content: string) => React.ReactNode} props.renderDom - 自定义渲染函数
+ * @param {string} [props.viewText] - 自定义查看按钮文案
+ * @param {string} [props.pageId] - 页面 ID
+ *
+ * @example
+ * ```tsx
+ * import { PntSecureBox } from '@pnt-team/pnt-component-frontend';
+ *
+ * <PntSecureBox
+ *   dataKey="userPhone"
+ *   dataValue="_high_security_:AAAA...:6542"
+ *   env={2}
+ *   gameId={12345}
+ *   renderDom={(content) => <span>{content}</span>}
+ *   viewText="查看"
+ * />
+ * ```
+ *
+ * @returns {ReactElement} 高敏信息展示组件
+ */
+declare const PntSecureBox: FC<PntSecureBoxProps>;
+export default PntSecureBox;

package/lib/cjs/config.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="react" />
+import type { AxiosInstance } from 'axios';
+/**
+ * 统一响应结构（与后端 commonEesType 对齐）
+ */
+export interface commonEesType<T> {
+    code: number;
+    msg: string;
+    data: T;
+    ret?: number;
+}
+/**
+ * 组件库运行时配置：由消费方通过 PntProvider 注入
+ */
+export interface PntConfig {
+    /** 消费方已配置好的 axios 实例（含拦截器、鉴权、baseURL 等） */
+    http: AxiosInstance;
+}
+/**
+ * 配置 Provider：消费方在应用根入口包裹一次即可
+ * @example
+ * ```tsx
+ * import { PntProvider } from '@pnt-team/pnt-component-frontend';
+ * import http from './utils/request';
+ *
+ * <PntProvider value={{ http }}>
+ *   <App />
+ * </PntProvider>
+ * ```
+ */
+export declare const PntProvider: import("react").Provider<PntConfig | null>;
+/**
+ * 获取组件库运行时配置（内部使用）
+ * @internal
+ */
+export declare const usePntConfig: () => PntConfig;

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

@@ -0,0 +1,22 @@
+/** 高敏数据请求参数（组件层友好命名） */
+export interface HighSecurityRequestParams {
+    /** 游戏 ID */
+    gameId: string | number;
+    /** 环境标识 */
+    env: string | number;
+    /** 页面 ID（不传则默认取 location.pathname） */
+    pageId?: string;
+    /** 需要解锁的参数列表 */
+    param: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * 高敏数据解锁 Hook（PntSecureBox 内部依赖）
+ * @internal 不对外导出,归 PntSecureBox 组件内部使用
+ */
+export declare const useHighSecurity: () => {
+    securityData: Record<string, string>;
+    requestSecurityData: ({ gameId, param, env, pageId, }: HighSecurityRequestParams) => Promise<void>;
+};

package/lib/cjs/index.d.ts

@@ -0,0 +1,5 @@
+export { PntProvider, usePntConfig, type PntConfig, type commonEesType, } from './config';
+export { default as PntImagePreview } from './components/PntImagePreview';
+export { default as PntBusinessSelect } from './components/PntBusinessSelect';
+export { default as PntSecureBox } from './components/PntSecureBox';
+export { default as PntGeneralLayout } from './components/PntGeneralLayout';

package/lib/cjs/utils/const.d.ts

@@ -0,0 +1,13 @@
+export declare const SUB_APP_PATHNAME: {
+    ACCOUNT: string;
+    SDK: string;
+    NOTICE: string;
+    CONFIGFROM: string;
+    CONFIGTHEME: string;
+    REVIEWLIST: string;
+    INTERNALTOOLS: string;
+    REPORTS: string;
+};
+export declare const AUDIENCE_MAPPING: {
+    [x: string]: string;
+};

package/lib/cjs/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 判断是否是高敏信息逻辑
+ * @param {*} val
+ * @returns
+ */
+export declare const isSecurityData: (val: string | number) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnt-team/pnt-component-frontend",
-  "version": "0.0.72",
+  "version": "0.0.73",
   "description": "A react library developed with dumi",
   "license": "MIT",
   "exports": {