@pnt-team/pnt-component-frontend 0.0.89 → 0.0.91

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

@@ -110,60 +110,46 @@ var PntBusinessSelect = (props) => {
   );
   const fetchData = (0, import_react.useCallback)(
     async (kw, page, append) => {
-      var _a, _b, _c;
+      var _a, _b;
       if (append) {
-        if (appendLoadingRef.current || loadingRef.current) {
-          console.log("[PntBS] fetchData APPEND blocked: loading=" + loadingRef.current + " appendLoading=" + appendLoadingRef.current);
+        if (appendLoadingRef.current || loadingRef.current)
           return;
-        }
         const meta = listMetaRef.current;
-        if (meta.keyword !== kw) {
-          console.log("[PntBS] fetchData APPEND blocked: kw mismatch " + kw + " vs " + meta.keyword);
+        if (meta.keyword !== kw)
           return;
-        }
-        if (page <= meta.page) {
-          console.log("[PntBS] fetchData APPEND blocked: page " + page + " <= " + meta.page);
+        if (page <= meta.page)
           return;
-        }
-        if (optionsRef.current.length >= meta.total) {
-          console.log("[PntBS] fetchData APPEND blocked: no more");
+        if (optionsRef.current.length >= meta.total)
           return;
-        }
         appendLoadingRef.current = true;
       }
       const seq = ++fetchSeqRef.current;
-      console.log('[PntBS] fetchData START kw="' + kw + '" page=' + page + " append=" + append + " seq=" + seq);
       loadingRef.current = true;
       setLoading(true);
       try {
         const res = await requestFn(buildParams(kw, page));
-        console.log("[PntBS] fetchData GOT seq=" + seq + " latestSeq=" + fetchSeqRef.current + " code=" + res.code);
-        if (seq !== fetchSeqRef.current) {
-          console.log("[PntBS] fetchData seq MISMATCH - DROPPED (seq=" + seq + " latest=" + fetchSeqRef.current + ")");
+        if (seq !== fetchSeqRef.current)
           return;
-        }
         if (res.code === 0 && res.data) {
           const newList = res.data.list || [];
           const resTotal = ((_a = res.data.pagination) == null ? void 0 : _a.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))];
+            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 };
-          console.log("[PntBS] fetchData SET options count=" + nextList.length + " first=" + (((_b = nextList[0]) == null ? void 0 : _b.name) || "null"));
           setOptions(nextList);
-          (_c = onLoadedRef.current) == null ? void 0 : _c.call(onLoadedRef, nextList);
-        } else {
-          console.log("[PntBS] fetchData BAD RESPONSE code=" + res.code + " hasData=" + !!res.data);
+          (_b = onLoadedRef.current) == null ? void 0 : _b.call(onLoadedRef, nextList);
         }
-      } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        console.log("[PntBS] fetchData ERROR seq=" + seq + ' kw="' + kw + '": ' + msg);
+      } catch {
       } finally {
         if (append)
           appendLoadingRef.current = false;
@@ -178,13 +164,10 @@ var PntBusinessSelect = (props) => {
   const handleSearch = (0, import_react.useCallback)(
     (val) => {
       keywordRef.current = val;
-      console.log('[PntBS] handleSearch val="' + val + '" debounceMs=' + searchDebounce);
       if (debounceRef.current)
         clearTimeout(debounceRef.current);
       debounceRef.current = setTimeout(() => {
-        const kw = keywordRef.current;
-        console.log('[PntBS] handleSearch timer fired, fetchData kw="' + kw + '" append=false seq++');
-        fetchData(kw, 1, false);
+        fetchData(keywordRef.current, 1, false);
       }, searchDebounce);
     },
     [fetchData, searchDebounce]
@@ -203,7 +186,6 @@ var PntBusinessSelect = (props) => {
         clearTimeout(debounceRef.current);
       keywordRef.current = "";
       if (listMetaRef.current.keyword) {
-        console.log('[PntBS] popupClose resetting from kw="' + listMetaRef.current.keyword + '"');
         fetchData("", 1, false);
       }
     },
@@ -400,7 +382,6 @@ var PntBusinessSelect = (props) => {
     [onChange, multiple, getLabelText]
   );
   const handleClear = (0, import_react.useCallback)(() => {
-    console.log("[PntBS] handleClear X-button clicked, resetting");
     keywordRef.current = "";
     if (debounceRef.current)
       clearTimeout(debounceRef.current);

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

@@ -70,15 +70,7 @@ var PntGeneralLayout = (prop) => {
       operation && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "header-operation", children: operation })
     ] }),
     subHeaderContent && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "general-layout-sub-header", children: subHeaderContent }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-      "div",
-      {
-        className: "general-layout-body",
-        ref: bodyRef,
-        style: bodyStyle,
-        children
-      }
-    ),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "general-layout-body", ref: bodyRef, style: bodyStyle, children }),
     footer && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Footer, { children: footer })
   ] });
 };

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

@@ -0,0 +1,87 @@
+import React, { FC } from 'react';
+import './index.scss';
+/**
+ * PntImage 文案集合
+ * @description 所有内部展示文案均可通过 texts prop 自定义，用于多语言场景
+ */
+export interface PntImageTexts {
+    /** 上传中占位文案（仅上传预览模式生效） */
+    uploading?: string;
+    /** 图片加载中占位文案（纯预览模式生效，透传给 tdesign Image loading） */
+    loading?: string;
+    /** 图片加载失败占位文案（纯预览模式生效，透传给 tdesign Image error） */
+    loadFailed?: string;
+}
+export interface PntImageProps {
+    /**
+     * 图片地址
+     * @description 图片的完整 URL 地址；为空则展示 defaultImg 或内置 uploadImg
+     */
+    src: string | undefined;
+    /**
+     * alt 文本
+     * @description 图片加载失败时的替代文本，纯预览模式必传以提升可访问性
+     */
+    alt?: string;
+    /**
+     * 默认图片
+     * @description src 为空时展示的占位图；不传则使用内置的 uploadImg
+     */
+    defaultImg?: string;
+    /**
+     * 自定义样式
+     * @description 一般用于控制图片宽高
+     */
+    style?: React.CSSProperties;
+    /**
+     * 上传中状态
+     * @description 当为 true 时显示上传中 loading 占位，阻止其他操作；仅在上传预览模式（传入 onRemove）生效
+     */
+    loading?: boolean;
+    /**
+     * 删除回调
+     * @description 传入即启用「上传预览模式」，mask 含预览 + 删除按钮；不传则为「纯预览模式」
+     * @param e - 事件对象
+     */
+    onRemove?: (e: any) => void;
+    /**
+     * attach 容器
+     * @description 弹窗场景下需要透传给 tdesign ImageViewer 的 attach，避免预览浮层被父容器裁剪
+     */
+    container?: HTMLElement | (() => HTMLElement);
+    /**
+     * 多语言文案
+     * @description 传入即覆盖默认中文文案；仅对应字段会覆盖，未传字段仍用默认值
+     */
+    texts?: PntImageTexts;
+}
+/**
+ * PntImage 业务图片组件
+ * @description 统一覆盖「上传图片预览」和「纯图片预览」两种业务场景，避免业务侧维护两套组件
+ *
+ * 模式判定：传入 `onRemove` 即为上传预览模式，否则为纯预览模式
+ *
+ * @example
+ * ```tsx
+ * // 上传预览模式
+ * <PntImage
+ *   src={iconUrl}
+ *   loading={loading}
+ *   defaultImg={defaultImg}
+ *   onRemove={handleRemove}
+ *   style={{ width: 136, height: 136 }}
+ * />
+ *
+ * // 纯预览模式
+ * <PntImage
+ *   src={url}
+ *   alt="avatar"
+ *   style={{ width: 60, height: 60 }}
+ *   container={container}
+ * />
+ * ```
+ *
+ * @returns {ReactElement} 业务图片组件
+ */
+declare const PntImage: FC<PntImageProps>;
+export default PntImage;

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

@@ -0,0 +1,137 @@
+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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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/components/PntImage/index.tsx
+var PntImage_exports = {};
+__export(PntImage_exports, {
+  default: () => PntImage_default
+});
+module.exports = __toCommonJS(PntImage_exports);
+var import_uploadImg = __toESM(require("../../assets/images/uploadImg.png"));
+var import_tdesign_icons_react = require("tdesign-icons-react");
+var import_tdesign_react = require("tdesign-react");
+var import_index = require("./index.scss");
+var import_jsx_runtime = require("react/jsx-runtime");
+var DEFAULT_TEXTS = {
+  uploading: "上传中",
+  loading: "加载中",
+  loadFailed: "加载失败"
+};
+var PntImage = ({
+  src,
+  alt = "",
+  defaultImg,
+  style,
+  loading = false,
+  onRemove,
+  container,
+  texts
+}) => {
+  const isUploadMode = typeof onRemove === "function";
+  const finalSrc = (src == null ? void 0 : src.length) ? src : defaultImg || import_uploadImg.default;
+  const attach = container ? typeof container === "function" ? container : () => container : void 0;
+  const finalTexts = { ...DEFAULT_TEXTS, ...texts };
+  const UploadLoadingContent = (isImageLoading) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      className: isImageLoading ? "pnt-image-progress" : "pnt-image-upload-progress",
+      style,
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "pnt-image-loading", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_tdesign_icons_react.LoadingIcon, { size: "18px", name: "loading" }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { children: finalTexts.uploading })
+      ] })
+    }
+  );
+  const basicImageLoading = /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    import_tdesign_react.Space,
+    {
+      direction: "vertical",
+      align: "center",
+      size: "small",
+      style: { color: "var(--td-text-color-disabled)" },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_tdesign_icons_react.ImageIcon, { size: 24 }),
+        finalTexts.loading
+      ]
+    }
+  );
+  const basicImageError = /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_tdesign_react.Space, { direction: "vertical", align: "center", size: "small", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_tdesign_icons_react.ImageErrorIcon, { size: 24 }),
+    finalTexts.loadFailed
+  ] });
+  const basicMask = (open) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      className: "pnt-image-mask pnt-image-mask--basic",
+      style: { background: "rgba(0,0,0,.1)", height: "100%" },
+      onClick: open
+    }
+  );
+  const uploadMask = (open) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "pnt-image-mask pnt-image-mask--upload", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_tdesign_icons_react.BrowseIcon, { onClick: open, size: "16px", name: "browse" }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "pnt-image-divider" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_tdesign_icons_react.DeleteIcon, { onClick: onRemove, size: "16px", name: "delete" }) })
+  ] });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      className: "pnt-image-wrapper",
+      onClick: (e) => {
+        if (isUploadMode && ((src == null ? void 0 : src.length) || loading)) {
+          e.stopPropagation();
+        }
+      },
+      children: isUploadMode && loading ? UploadLoadingContent(false) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        import_tdesign_react.ImageViewer,
+        {
+          images: [finalSrc],
+          closeOnOverlay: true,
+          attach,
+          trigger: ({ open }) => {
+            const mask = isUploadMode ? uploadMask(open) : basicMask(open);
+            return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              import_tdesign_react.Image,
+              {
+                alt,
+                src: finalSrc,
+                loading: isUploadMode ? UploadLoadingContent(true) : basicImageLoading,
+                error: isUploadMode ? void 0 : basicImageError,
+                overlayContent: isUploadMode ? src ? mask : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, {}) : mask,
+                overlayTrigger: "hover",
+                fit: "contain",
+                className: "pnt-image",
+                style
+              }
+            );
+          }
+        }
+      )
+    }
+  );
+};
+var PntImage_default = PntImage;

package/lib/{esm/components/PntImagePreview → cjs/components/PntImage}/index.scss

@@ -1,15 +1,15 @@
-.pnt-image-preview-wrapper {
+.pnt-image-wrapper {
   position: relative;
 
-  .pnt-image-preview-progress,
-  .pnt-image-preview-upload-progress {
+  .pnt-image-progress,
+  .pnt-image-upload-progress {
     width: 136px;
     height: 136px;
     display: flex;
     align-items: center;
     justify-content: center;
 
-    .pnt-image-preview-loading {
+    .pnt-image-loading {
       width: 100%;
       height: 100%;
       text-align: center;
@@ -33,18 +33,25 @@
     }
   }
 
-  .pnt-image-preview {
+  .pnt-image {
     width: 136px;
     height: 136px;
 
-    .pnt-image-preview-mask {
+    .pnt-image-mask {
       background: rgba(0, 0, 0, 60%);
       color: #fff;
       height: 100%;
       display: flex;
       align-items: center;
       justify-content: center;
-      .pnt-image-preview-divider {
+
+      // 纯预览模式：半透明遮罩，鼠标手型
+      &--basic {
+        cursor: pointer;
+      }
+
+      // 上传预览模式：分隔线
+      .pnt-image-divider {
         margin: 0 var(--td-comp-margin-l);
         border-left: 1px var(--td-text-color-anti) solid;
         height: var(--td-comp-size-xxxs);

package/lib/cjs/index.d.ts

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

package/lib/cjs/index.js

@@ -31,14 +31,14 @@ var src_exports = {};
 __export(src_exports, {
   PntBusinessSelect: () => import_PntBusinessSelect.default,
   PntGeneralLayout: () => import_PntGeneralLayout.default,
-  PntImagePreview: () => import_PntImagePreview.default,
+  PntImage: () => import_PntImage.default,
   PntProvider: () => import_config.PntProvider,
   PntSecureBox: () => import_PntSecureBox.default,
   usePntConfig: () => import_config.usePntConfig
 });
 module.exports = __toCommonJS(src_exports);
 var import_config = require("./config");
-var import_PntImagePreview = __toESM(require("./components/PntImagePreview"));
+var import_PntImage = __toESM(require("./components/PntImage"));
 var import_PntBusinessSelect = __toESM(require("./components/PntBusinessSelect"));
 var import_PntSecureBox = __toESM(require("./components/PntSecureBox"));
 var import_PntGeneralLayout = __toESM(require("./components/PntGeneralLayout"));
@@ -46,7 +46,7 @@ var import_PntGeneralLayout = __toESM(require("./components/PntGeneralLayout"));
 0 && (module.exports = {
   PntBusinessSelect,
   PntGeneralLayout,
-  PntImagePreview,
+  PntImage,
   PntProvider,
   PntSecureBox,
   usePntConfig

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

@@ -153,36 +153,19 @@ const PntBusinessSelect = props => {
   // append=true 为滚动翻页（追加），append=false 为初始化/搜索/重置（替换）
   const fetchData = useCallback(async (kw, page, append) => {
     if (append) {
-      if (appendLoadingRef.current || loadingRef.current) {
-        console.log('[PntBS] fetchData APPEND blocked: loading=' + loadingRef.current + ' appendLoading=' + appendLoadingRef.current);
-        return;
-      }
+      if (appendLoadingRef.current || loadingRef.current) return;
       const meta = listMetaRef.current;
-      if (meta.keyword !== kw) {
-        console.log('[PntBS] fetchData APPEND blocked: kw mismatch ' + kw + ' vs ' + meta.keyword);
-        return;
-      }
-      if (page <= meta.page) {
-        console.log('[PntBS] fetchData APPEND blocked: page ' + page + ' <= ' + meta.page);
-        return;
-      }
-      if (optionsRef.current.length >= meta.total) {
-        console.log('[PntBS] fetchData APPEND blocked: no more');
-        return;
-      }
+      if (meta.keyword !== kw) return;
+      if (page <= meta.page) return;
+      if (optionsRef.current.length >= meta.total) return;
       appendLoadingRef.current = true;
     }
     const seq = ++fetchSeqRef.current;
-    console.log('[PntBS] fetchData START kw="' + kw + '" page=' + page + ' append=' + append + ' seq=' + seq);
     loadingRef.current = true;
     setLoading(true);
     try {
       const res = await requestFn(buildParams(kw, page));
-      console.log('[PntBS] fetchData GOT seq=' + seq + ' latestSeq=' + fetchSeqRef.current + ' code=' + res.code);
-      if (seq !== fetchSeqRef.current) {
-        console.log('[PntBS] fetchData seq MISMATCH - DROPPED (seq=' + seq + ' latest=' + fetchSeqRef.current + ')');
-        return;
-      }
+      if (seq !== fetchSeqRef.current) return;
       if (res.code === 0 && res.data) {
         const newList = res.data.list || [];
         const resTotal = res.data.pagination?.total || 0;
@@ -200,15 +183,11 @@ const PntBusinessSelect = props => {
           page,
           total: resTotal
         };
-        console.log('[PntBS] fetchData SET options count=' + nextList.length + ' first=' + (nextList[0]?.name || 'null'));
         setOptions(nextList);
         onLoadedRef.current?.(nextList);
-      } else {
-        console.log('[PntBS] fetchData BAD RESPONSE code=' + res.code + ' hasData=' + !!res.data);
       }
-    } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
-      console.log('[PntBS] fetchData ERROR seq=' + seq + ' kw="' + kw + '": ' + msg);
+    } catch {
+      // 请求失败静默处理，不阻塞主流程
     } finally {
       if (append) appendLoadingRef.current = false;
       if (seq === fetchSeqRef.current) {
@@ -221,12 +200,9 @@ const PntBusinessSelect = props => {
   // ---- 远程搜索（防抖） ----
   const handleSearch = useCallback(val => {
     keywordRef.current = val;
-    console.log('[PntBS] handleSearch val="' + val + '" debounceMs=' + searchDebounce);
     if (debounceRef.current) clearTimeout(debounceRef.current);
     debounceRef.current = setTimeout(() => {
-      const kw = keywordRef.current;
-      console.log('[PntBS] handleSearch timer fired, fetchData kw="' + kw + '" append=false seq++');
-      fetchData(kw, 1, false);
+      fetchData(keywordRef.current, 1, false);
     }, searchDebounce);
   }, [fetchData, searchDebounce]);
 
@@ -250,7 +226,6 @@ const PntBusinessSelect = props => {
     //    上次搜索结果，关闭时必须重置回默认列表。
     keywordRef.current = '';
     if (listMetaRef.current.keyword) {
-      console.log('[PntBS] popupClose resetting from kw="' + listMetaRef.current.keyword + '"');
       fetchData('', 1, false);
     }
   }, [fetchData]);
@@ -475,7 +450,6 @@ const PntBusinessSelect = props => {
   // 点击 clear 按钮（X）时重置列表——TDesign 的 onClearValue 只 setInputValue，
   // 不触发 handleInputChange / onSearch，所以需要主动重置。
   const handleClear = useCallback(() => {
-    console.log('[PntBS] handleClear X-button clicked, resetting');
     keywordRef.current = '';
     if (debounceRef.current) clearTimeout(debounceRef.current);
     if (listMetaRef.current.keyword) {

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

@@ -0,0 +1,87 @@
+import React, { FC } from 'react';
+import './index.scss';
+/**
+ * PntImage 文案集合
+ * @description 所有内部展示文案均可通过 texts prop 自定义，用于多语言场景
+ */
+export interface PntImageTexts {
+    /** 上传中占位文案（仅上传预览模式生效） */
+    uploading?: string;
+    /** 图片加载中占位文案（纯预览模式生效，透传给 tdesign Image loading） */
+    loading?: string;
+    /** 图片加载失败占位文案（纯预览模式生效，透传给 tdesign Image error） */
+    loadFailed?: string;
+}
+export interface PntImageProps {
+    /**
+     * 图片地址
+     * @description 图片的完整 URL 地址；为空则展示 defaultImg 或内置 uploadImg
+     */
+    src: string | undefined;
+    /**
+     * alt 文本
+     * @description 图片加载失败时的替代文本，纯预览模式必传以提升可访问性
+     */
+    alt?: string;
+    /**
+     * 默认图片
+     * @description src 为空时展示的占位图；不传则使用内置的 uploadImg
+     */
+    defaultImg?: string;
+    /**
+     * 自定义样式
+     * @description 一般用于控制图片宽高
+     */
+    style?: React.CSSProperties;
+    /**
+     * 上传中状态
+     * @description 当为 true 时显示上传中 loading 占位，阻止其他操作；仅在上传预览模式（传入 onRemove）生效
+     */
+    loading?: boolean;
+    /**
+     * 删除回调
+     * @description 传入即启用「上传预览模式」，mask 含预览 + 删除按钮；不传则为「纯预览模式」
+     * @param e - 事件对象
+     */
+    onRemove?: (e: any) => void;
+    /**
+     * attach 容器
+     * @description 弹窗场景下需要透传给 tdesign ImageViewer 的 attach，避免预览浮层被父容器裁剪
+     */
+    container?: HTMLElement | (() => HTMLElement);
+    /**
+     * 多语言文案
+     * @description 传入即覆盖默认中文文案；仅对应字段会覆盖，未传字段仍用默认值
+     */
+    texts?: PntImageTexts;
+}
+/**
+ * PntImage 业务图片组件
+ * @description 统一覆盖「上传图片预览」和「纯图片预览」两种业务场景，避免业务侧维护两套组件
+ *
+ * 模式判定：传入 `onRemove` 即为上传预览模式，否则为纯预览模式
+ *
+ * @example
+ * ```tsx
+ * // 上传预览模式
+ * <PntImage
+ *   src={iconUrl}
+ *   loading={loading}
+ *   defaultImg={defaultImg}
+ *   onRemove={handleRemove}
+ *   style={{ width: 136, height: 136 }}
+ * />
+ *
+ * // 纯预览模式
+ * <PntImage
+ *   src={url}
+ *   alt="avatar"
+ *   style={{ width: 60, height: 60 }}
+ *   container={container}
+ * />
+ * ```
+ *
+ * @returns {ReactElement} 业务图片组件
+ */
+declare const PntImage: FC<PntImageProps>;
+export default PntImage;