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

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

@@ -1,276 +0,0 @@
-import usePntCosUploader from "../PntCosUploader";
-import PntImage from "../PntImage";
-import React, { useMemo, useState } from 'react';
-import { DeleteIcon, FileIcon, UploadIcon } from 'tdesign-icons-react';
-import { Progress, Upload } from 'tdesign-react';
-import "./index.scss";
-
-// ==========================================
-// 类型定义
-// ==========================================
-
-/**
- * PntUpload 文案集合
- * @description 所有内部展示文案均可通过 texts prop 自定义，用于多语言场景
- */
-
-/**
- * 校验/上传失败阶段
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-import { jsxs as _jsxs } from "react/jsx-runtime";
-// ==========================================
-// 常量与工具
-// ==========================================
-
-const DEFAULT_TEXTS = {
-  uploading: '上传中',
-  uploadFailed: '上传失败，请重试',
-  sizeInvalid: '文件大小超出限制',
-  typeInvalid: '文件类型不支持',
-  selectFile: '选择文件',
-  reselect: '重新选择'
-};
-
-/**
- * 将 accept 归一化为小写 token 列表
- */
-const toAcceptList = accept => {
-  const raw = Array.isArray(accept) ? accept : accept ? accept.split(',') : [];
-  return raw.map(item => item.trim().toLowerCase()).filter(Boolean);
-};
-
-/**
- * 校验文件类型是否匹配 accept
- */
-const matchAccept = (file, acceptList) => {
-  if (!acceptList.length) {
-    return true;
-  }
-  const name = file.name.toLowerCase();
-  const type = file.type.toLowerCase();
-  return acceptList.some(token => {
-    if (token.startsWith('.')) {
-      return name.endsWith(token);
-    }
-    if (token.endsWith('/*')) {
-      return !!type && type.startsWith(token.slice(0, -1));
-    }
-    return type === token;
-  });
-};
-
-/** 从 URL 中提取文件名（用于编辑态回显） */
-const getFileNameFromUrl = url => {
-  if (!url) {
-    return '';
-  }
-  const lastSeg = url.split('?')[0].split('/').pop() || '';
-  try {
-    return decodeURIComponent(lastSeg);
-  } catch {
-    return lastSeg;
-  }
-};
-
-// ==========================================
-// PntUpload 组件
-// ==========================================
-
-/**
- * PntUpload 业务上传组件
- * @description 基于 TDesign Upload + PntImage + usePntCosUploader，
- * 内置 COS 凭证获取、直传、进度、校验、错误处理；支持图片预览 / 文件两种模式
- *
- * @example
- * ```tsx
- * <PntUpload
- *   scene="default"
- *   pathKey="marketing_icon"
- *   context={{ gameId }}
- *   accept="image/png"
- *   sizeLimit={500 * 1024}
- *   imagePreview
- *   value={iconUrl}
- *   onChange={(url) => setIconUrl(url)}
- *   onRemove={() => setIconUrl('')}
- * />
- * ```
- */
-const PntUpload = ({
-  value,
-  onChange,
-  onRemove,
-  onError,
-  scene,
-  pathKey,
-  context,
-  audience,
-  accept,
-  sizeLimit,
-  imagePreview = true,
-  previewStyle,
-  defaultImg,
-  fileNameStrategy,
-  useCdn,
-  getCredential,
-  normalizeCredential,
-  texts,
-  disabled = false,
-  style,
-  className
-}) => {
-  const [uploading, setUploading] = useState(false);
-  const [percent, setPercent] = useState(0);
-  const [errorText, setErrorText] = useState('');
-  const [lastFile, setLastFile] = useState(null);
-  const finalTexts = useMemo(() => ({
-    ...DEFAULT_TEXTS,
-    ...texts
-  }), [texts]);
-  const acceptList = useMemo(() => toAcceptList(accept), [accept]);
-  const acceptString = useMemo(() => acceptList.join(', '), [acceptList]);
-  const uploader = usePntCosUploader({
-    scene,
-    pathKey,
-    context,
-    audience,
-    fileNameStrategy,
-    useCdn,
-    getCredential,
-    normalizeCredential
-  });
-  const reportError = (message, phase, file) => {
-    setErrorText(message);
-    onError?.(new Error(message), phase, file);
-  };
-
-  /**
-   * 自定义上传：TDesign 选好文件后回调，内部完成校验 + COS 直传
-   */
-  const requestMethod = async files => {
-    const tdFile = Array.isArray(files) ? files[0] : files;
-    const file = tdFile?.raw;
-    if (!file) {
-      return {
-        status: 'fail',
-        error: 'no file',
-        response: {}
-      };
-    }
-
-    // 1. 本地校验：类型 / 大小
-    if (!matchAccept(file, acceptList)) {
-      reportError(finalTexts.typeInvalid, 'validate', file);
-      return {
-        status: 'fail',
-        error: finalTexts.typeInvalid,
-        response: {}
-      };
-    }
-    if (typeof sizeLimit === 'number' && file.size > sizeLimit) {
-      reportError(finalTexts.sizeInvalid, 'validate', file);
-      return {
-        status: 'fail',
-        error: finalTexts.sizeInvalid,
-        response: {}
-      };
-    }
-
-    // 2. COS 直传
-    setUploading(true);
-    setPercent(0);
-    setErrorText('');
-    try {
-      const result = await uploader.upload(file, setPercent);
-      setLastFile(file);
-      onChange?.(result.fileUrl, result.cosKey, file);
-      return {
-        status: 'success',
-        response: {
-          url: result.fileUrl
-        }
-      };
-    } catch (e) {
-      const err = e instanceof Error ? e : new Error(String(e));
-      setErrorText(finalTexts.uploadFailed);
-      onError?.(err, 'upload', file);
-      return {
-        status: 'fail',
-        error: err.message,
-        response: {}
-      };
-    } finally {
-      setUploading(false);
-    }
-  };
-  const handleRemove = e => {
-    // 阻止冒泡到 Upload 触发文件选择（DeleteIcon 与 PntImage 移除按钮均为 SVG 点击事件）
-    e.stopPropagation();
-    if (disabled || uploading) {
-      return;
-    }
-    setLastFile(null);
-    setErrorText('');
-    onRemove?.();
-  };
-  const wrapperClassName = ['pnt-upload', imagePreview ? 'pnt-upload--image' : 'pnt-upload--file', disabled ? 'pnt-upload--disabled' : '', className || ''].filter(Boolean).join(' ');
-  const displayName = lastFile?.name || getFileNameFromUrl(value);
-  return /*#__PURE__*/_jsxs("div", {
-    className: wrapperClassName,
-    style: style,
-    children: [/*#__PURE__*/_jsx(Upload, {
-      theme: "custom",
-      requestMethod: requestMethod,
-      accept: acceptString || undefined,
-      allowUploadDuplicateFile: true,
-      disabled: disabled || uploading,
-      className: "pnt-upload__trigger",
-      children: imagePreview ? /*#__PURE__*/_jsx(PntImage, {
-        src: value,
-        loading: uploading,
-        defaultImg: defaultImg,
-        style: previewStyle,
-        texts: {
-          uploading: finalTexts.uploading
-        },
-        onRemove: disabled ? undefined : handleRemove
-      }) : /*#__PURE__*/_jsx("div", {
-        className: "pnt-upload-file",
-        children: value && !uploading ? /*#__PURE__*/_jsxs("div", {
-          className: "pnt-upload-file__row",
-          children: [/*#__PURE__*/_jsx(FileIcon, {
-            className: "pnt-upload-file__icon"
-          }), /*#__PURE__*/_jsx("span", {
-            className: "pnt-upload-file__name",
-            title: displayName,
-            children: displayName
-          }), !disabled && /*#__PURE__*/_jsx(DeleteIcon, {
-            className: "pnt-upload-file__delete",
-            onClick: handleRemove
-          })]
-        }) : uploading ? /*#__PURE__*/_jsxs("div", {
-          className: "pnt-upload-file__row pnt-upload-file__row--progress",
-          children: [/*#__PURE__*/_jsx(Progress, {
-            percentage: percent,
-            className: "pnt-upload-file__progress"
-          }), /*#__PURE__*/_jsxs("span", {
-            className: "pnt-upload-file__percent",
-            children: [finalTexts.uploading, " ", percent, "%"]
-          })]
-        }) : /*#__PURE__*/_jsxs("div", {
-          className: "pnt-upload-file__row pnt-upload-file__row--empty",
-          children: [/*#__PURE__*/_jsx(UploadIcon, {
-            className: "pnt-upload-file__icon"
-          }), /*#__PURE__*/_jsx("span", {
-            children: value ? finalTexts.reselect : finalTexts.selectFile
-          })]
-        })
-      })
-    }), errorText && /*#__PURE__*/_jsx("p", {
-      className: "pnt-upload__error",
-      children: errorText
-    })]
-  });
-};
-export default PntUpload;

package/lib/esm/components/PntUpload/index.scss

@@ -1,101 +0,0 @@
-.pnt-upload {
-  display: inline-block;
-
-  // TDesign Upload custom 触发器外层
-  .pnt-upload__trigger {
-    display: inline-block;
-    cursor: pointer;
-  }
-
-  // 错误文案（图片 / 文件模式共用）
-  .pnt-upload__error {
-    margin: 4px 0 0;
-    color: var(--td-error-color, #d54941);
-    font-size: 12px;
-    line-height: 20px;
-  }
-
-  &--disabled {
-    .pnt-upload__trigger {
-      cursor: not-allowed;
-    }
-  }
-
-  // ========== 文件模式 ==========
-  .pnt-upload-file {
-    box-sizing: border-box;
-    min-width: 320px;
-    padding: 12px 16px;
-    border: 1px dashed var(--td-component-border, #dcdcdc);
-    border-radius: var(--td-radius-default, 6px);
-    background-color: var(--td-bg-color-container, #fff);
-    transition: border-color 0.2s;
-
-    &:hover {
-      border-color: var(--td-brand-color, #165dff);
-    }
-
-    &__row {
-      display: flex;
-      align-items: center;
-      gap: 8px;
-      color: var(--td-text-color-primary, #1f2329);
-      font-size: 14px;
-      line-height: 22px;
-
-      &--empty {
-        justify-content: flex-start;
-        color: var(--td-text-color-secondary, #6b7280);
-      }
-
-      &--progress {
-        align-items: center;
-      }
-    }
-
-    &__icon {
-      flex: none;
-      font-size: 20px;
-      color: var(--td-text-color-secondary, #6b7280);
-    }
-
-    &__name {
-      flex: 1;
-      overflow: hidden;
-      white-space: nowrap;
-      text-overflow: ellipsis;
-    }
-
-    &__delete {
-      flex: none;
-      font-size: 18px;
-      color: var(--td-text-color-secondary, #6b7280);
-      cursor: pointer;
-
-      &:hover {
-        color: var(--td-error-color, #d54941);
-      }
-    }
-
-    &__progress {
-      flex: 1;
-      min-width: 0;
-    }
-
-    &__percent {
-      flex: none;
-      color: var(--td-text-color-secondary, #6b7280);
-      font-size: 12px;
-    }
-  }
-
-  &--disabled {
-    .pnt-upload-file {
-      background-color: var(--td-bg-color-component-disabled, #f3f3f3);
-
-      &:hover {
-        border-color: var(--td-component-border, #dcdcdc);
-      }
-    }
-  }
-}

package/lib/esm/config.d.ts

@@ -1,97 +0,0 @@
-/// <reference types="react" />
-/**
- * 统一响应结构（与后端 commonEesType 对齐）
- */
-export interface commonEesType<T> {
-    code: number;
-    msg: string;
-    data: T;
-    ret?: number;
-}
-/**
- * 库所需的最小 HTTP 能力（仅 post）。
- * 用结构化类型而非直接依赖 AxiosInstance，
- * 避免与消费方 axios 版本的类型定义强耦合（如 1.13 vs 1.20 的 query 方法差异）。
- * 任何具备 axios 兼容 post 签名的实例均可注入。
- */
-export interface PntHttpLike {
-    get<R = unknown>(url: string, config?: any): Promise<R>;
-    post<R = unknown, D = unknown>(url: string, data?: D, config?: any): Promise<R>;
-}
-/**
- * 高敏信息解锁接口配置（可选，全局覆盖）
- */
-export interface PntHighSecurityConfig {
-    /**
-     * 业务级解密接口 URL，覆盖默认 /api/v3/business/game_info/high-security-decrypt?audience=/laas-pnt
-     * @description scope='business'（默认）时使用
-     */
-    decryptUrl?: string;
-    /**
-     * 平台级解密接口 URL，覆盖默认 /api/v3/business/game_info/plat-high-security-decrypt?audience=/laas-pnt
-     * @description scope='platform' 时使用（发布记录页等平台级权限校验场景）
-     */
-    decryptPlatUrl?: string;
-    /** 成功码字段：'code'（默认）或 'ret'（account-business 现状） */
-    successCodeField?: 'code' | 'ret';
-    /** audience 覆盖（默认 /laas-pnt） */
-    audience?: string;
-}
-/**
- * 地区查询接口配置（可选，全局覆盖）
- */
-export interface PntRegionQueryConfig {
-    /**
-     * 业务级地区查询接口 URL，覆盖默认 /api/v5/business/region/query?audience=/laas-pnt
-     * @description scope='business'（默认）时使用
-     */
-    queryUrl?: string;
-    /**
-     * 平台级地区查询接口 URL，覆盖默认 /api/v5/business/region/plat-query?audience=/laas-pnt
-     * @description scope='platform' 时使用
-     */
-    queryPlatUrl?: string;
-}
-/**
- * 组件库运行时配置：由消费方通过 PntProvider 注入
- */
-export interface PntConfig {
-    /** 消费方已配置好的 axios 实例（含拦截器、鉴权、baseURL 等） */
-    http: PntHttpLike;
-    /** 高敏信息解锁接口全局配置（可选） */
-    highSecurity?: PntHighSecurityConfig;
-    /** 地区查询接口全局配置（可选） */
-    regionQuery?: PntRegionQueryConfig;
-    /**
-     * 全局语言设置 @default 'zh'
-     * - zh: 中文（默认文案）
-     * - en: 英文（内置英文文案）
-     * @description 组件内部文案（全选、反选、批量导入等）会根据此值自动切换
-     */
-    locale?: 'zh' | 'en';
-}
-/**
- * 配置 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;
-/**
- * 获取组件库运行时配置（可选版本，内部使用）
- * @description 供「外部受控数据」模式的组件使用：未注入 Provider 时返回 null，
- *              组件自行降级（不发起内部请求），不抛错
- * @internal
- */
-export declare const usePntConfigOptional: () => PntConfig | null;

package/lib/esm/config.js

@@ -1,60 +0,0 @@
-import { createContext, useContext } from 'react';
-
-/**
- * 统一响应结构（与后端 commonEesType 对齐）
- */
-
-/**
- * 库所需的最小 HTTP 能力（仅 post）。
- * 用结构化类型而非直接依赖 AxiosInstance，
- * 避免与消费方 axios 版本的类型定义强耦合（如 1.13 vs 1.20 的 query 方法差异）。
- * 任何具备 axios 兼容 post 签名的实例均可注入。
- */
-
-/**
- * 高敏信息解锁接口配置（可选，全局覆盖）
- */
-
-/**
- * 地区查询接口配置（可选，全局覆盖）
- */
-
-/**
- * 组件库运行时配置：由消费方通过 PntProvider 注入
- */
-
-const PntContext = /*#__PURE__*/createContext(null);
-
-/**
- * 配置 Provider：消费方在应用根入口包裹一次即可
- * @example
- * ```tsx
- * import { PntProvider } from '@pnt-team/pnt-component-frontend';
- * import http from './utils/request';
- *
- * <PntProvider value={{ http }}>
- *   <App />
- * </PntProvider>
- * ```
- */
-export const PntProvider = PntContext.Provider;
-
-/**
- * 获取组件库运行时配置（内部使用）
- * @internal
- */
-export const usePntConfig = () => {
-  const cfg = useContext(PntContext);
-  if (!cfg) {
-    throw new Error('[pnt-component-frontend] 未注入配置：请在应用根入口用 <PntProvider value={{ http }}> 包裹');
-  }
-  return cfg;
-};
-
-/**
- * 获取组件库运行时配置（可选版本，内部使用）
- * @description 供「外部受控数据」模式的组件使用：未注入 Provider 时返回 null，
- *              组件自行降级（不发起内部请求），不抛错
- * @internal
- */
-export const usePntConfigOptional = () => useContext(PntContext);

package/lib/esm/global.css

@@ -1,2 +0,0 @@
-/* TDesign 组件库全局样式（dumi 文档站自动加载） */
-@import 'tdesign-react/dist/tdesign.min.css';

package/lib/esm/global.d.ts

@@ -1,39 +0,0 @@
-// src/global.d.ts
-declare module '*.png' {
-  const src: string;
-  export default src;
-}
-
-declare module '*.jpg' {
-  const src: string;
-  export default src;
-}
-
-declare module '*.svg' {
-  const src: string;
-  export default src;
-}
-
-// 字体文件
-declare module '*.woff' {
-  const src: string;
-  export default src;
-}
-declare module '*.woff2' {
-  const src: string;
-  export default src;
-}
-
-declare module '*.json' {
-  const value: any;
-  export default value;
-}
-
-// use-sync-external-store shim（兼容 React 16/17，包本身未提供 .d.ts）
-declare module 'use-sync-external-store/shim' {
-  export function useSyncExternalStore<A>(
-    subscribe: (callback: () => void) => () => void,
-    getSnapshot: () => A,
-    getServerSnapshot?: () => A,
-  ): A;
-}

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

@@ -1,88 +0,0 @@
-import type { PntHighSecurityConfig } from "../config";
-/** 单个解锁项 */
-export interface HighSecurityParamItem {
-    /** 字段标识（与后端约定） */
-    key: string;
-    /** 参数密文（_high_security_: 前缀） */
-    value: string;
-    /**
-     * 缓存别名（可选）
-     * @description 当后端 key 相同但密文不同时（如两组 SDK 密钥），
-     * 用 cacheKey 区分缓存，请求体仍用 key。默认 cacheKey=key
-     */
-    cacheKey?: string;
-}
-/** 单次请求的接口配置覆盖（优先级 > PntProvider 全局配置） */
-export type HighSecurityApiConfig = PntHighSecurityConfig;
-/**
- * 高敏接口变体
- * - 'business'（默认）：业务级，走 /api/v3/business/game_info/high-security-decrypt
- * - 'platform'：平台级（发布记录页场景），走 /api/v3/business/game_info/plat-high-security-decrypt
- */
-export type HighSecurityScope = 'business' | 'platform';
-/** 高敏数据解锁请求参数（组件层友好命名，库内部转换为后端 snake_case） */
-export interface HighSecurityRequestParams {
-    /** 业务 ID */
-    gameId: string | number;
-    /** 环境标识（可缺省，默认 0；以各业务现有约定为准） */
-    env?: string | number;
-    /** 页面 ID（不传则默认取 location.pathname），用于操作日志和权限校验 */
-    pageId?: string;
-    /** 需要解锁的参数列表，支持批量 */
-    param: HighSecurityParamItem[];
-    /** 强制刷新：忽略缓存，每次都调接口（默认 false） */
-    forceRefresh?: boolean;
-    /** 本次请求的接口配置覆盖（可选） */
-    apiConfig?: HighSecurityApiConfig;
-    /** 本次请求的接口变体，覆盖 hook 初始化时的 scope */
-    scope?: HighSecurityScope;
-}
-/** hook 初始化 scope：传入后 securityData/isUnlocked 自动按该业务+环境过滤 */
-export interface UseHighSecurityOptions {
-    /** 当前业务 ID */
-    gameId?: string | number;
-    /** 当前环境（可缺省，默认 0） */
-    env?: string | number;
-    /** 接口变体（默认 'business'）；发布记录页等平台级场景传 'platform' */
-    scope?: HighSecurityScope;
-}
-/** 清缓存过滤条件 */
-export interface ClearSecurityDataFilter {
-    gameId?: string | number;
-    env?: string | number;
-}
-export interface UseHighSecurityResult {
-    /**
-     * 当前 scope 下已解锁的明文；未传 scope 时为空对象
-     * @description key 为请求时入参的 cacheKey（未传 cacheKey 时为字段名）
-     */
-    securityData: Record<string, string>;
-    /**
-     * 发起解锁
-     * @description
-     * - 已缓存的 key 直接返回缓存值，不再请求
-     * - 同一参数的在途请求自动去重
-     * - 成功：写入模块缓存并返回当次解密数组（含已缓存项）
-     * - 失败/部分失败：仅返回拿到的项（可能为空数组），不抛错
-     */
-    requestSecurityData: (params: HighSecurityRequestParams) => Promise<HighSecurityParamItem[]>;
-    /**
-     * 清缓存：不传参清空全部；传 gameId 清空该业务所有环境；
-     * 同时传 gameId+env 只清空该业务指定环境；仅传 env 清空所有业务该环境
-     */
-    clearSecurityData: (filter?: ClearSecurityDataFilter) => void;
-    /** 当前 scope 下某字段是否已解锁（两步式"查看 → 复制"UI 用） */
-    isUnlocked: (key: string) => boolean;
-}
-/**
- * 高敏数据解锁 Hook（PntSecureBox 内部依赖，同时对外导出供"复制"等非展示场景使用）
- *
- * @example
- * ```tsx
- * // 展示场景请直接用 PntSecureBox；两步式"查看 → 复制"：
- * const { isUnlocked, requestSecurityData, securityData } = useHighSecurity({ gameId, env });
- * const res = await requestSecurityData({ gameId, env, param: [{ key: 'SDK_KEY', value }] });
- * if (res.length) copy(securityData.SDK_KEY);
- * ```
- */
-export declare const useHighSecurity: (options?: UseHighSecurityOptions) => UseHighSecurityResult;