@para-ui/core 5.0.0-beta.11 → 5.0.0-beta.13

package/lib/Upload/component.json

@@ -0,0 +1,450 @@
+{
+    "name": "Upload",
+    "category": "Form",
+    "description": "文件选择上传和拖拽上传控件",
+    "semantic": {
+        "intent": [
+            "上传文件",
+            "导入数据",
+            "图片上传",
+            "文件选择"
+        ],
+        "useCases": [
+            "表单附件",
+            "头像更换",
+            "文档管理",
+            "数据导入"
+        ],
+        "riskLevel": "normal"
+    },
+    "variants": {
+        "select": {
+            "meaning": "点击选择文件上传"
+        },
+        "drag": {
+            "meaning": "拖拽文件上传——两种写法等价：① `<Upload type='drag'>` ② `<Upload.Dragger>`（推荐，更语义化）"
+        },
+        "avatar": {
+            "meaning": "头像/图片上传——推荐用 `<Upload.ImageUpload>`（默认 accept='image/*'，内置图片卡片样式）"
+        }
+    },
+    "subComponents": {
+        "Upload.Dragger": {
+            "description": "拖拽上传子组件，等价于 `<Upload type='drag'>`，props 与 Upload 完全相同（去掉 type）",
+            "usage": "import { Upload } from '@para-ui/core'; const { Dragger } = Upload;\n<Dragger height={200} stash fileList={list} onChange={fn} />",
+            "props": "同 UploadProps，去掉 type（固定为 drag）"
+        },
+        "Upload.ImageUpload": {
+            "description": "图片/头像上传子组件，默认 accept='image/*'、内置 picture-card 展示样式",
+            "usage": "import { Upload } from '@para-ui/core'; const { ImageUpload } = Upload;\n<ImageUpload action='/api/upload' multiple onChange={fn} />",
+            "additionalProps": {
+                "defaultImage": {
+                    "type": "{ imageUrl: string; imageName?: string }",
+                    "description": "showUploadList=false 时的默认回显图片"
+                },
+                "readonly": {
+                    "type": "boolean",
+                    "description": "只读模式：只回显图片，不显示上传和删除操作"
+                }
+            },
+            "props": "同 UploadProps（去掉 type）+ defaultImage + readonly"
+        }
+    },
+    "states": [
+        "default",
+        "uploading",
+        "error",
+        "disabled",
+        "success"
+    ],
+    "idealProps": {
+        "type": {
+            "type": "enum",
+            "values": ["drag", "select"],
+            "default": "select",
+            "description": "上传交互类型：点击选择或拖拽上传",
+            "src": "src/Upload/index.tsx:23"
+        },
+        "action": {
+            "type": "string | function",
+            "signature": "string | ((file: RcFile) => string | PromiseLike<string>)",
+            "description": "上传 API 地址，可以是字符串或函数（函数可同步返回 string 或异步返回 PromiseLike<string>）",
+            "src": "src/Upload/interface.tsx:104"
+        },
+        "name": {
+            "type": "string",
+            "default": "file",
+            "description": "发到后台的文件参数名",
+            "src": "src/Upload/interface.tsx:92"
+        },
+        "method": {
+            "type": "string",
+            "default": "post",
+            "description": "上传请求的 HTTP method",
+            "src": "src/Upload/interface.tsx:106"
+        },
+        "data": {
+            "type": "object | function",
+            "signature": "Record<string, unknown> | ((file: RcFile | string | Blob) => Record<string, unknown>)",
+            "description": "上传所需额外参数，或返回额外参数的方法",
+            "src": "src/Upload/interface.tsx:110"
+        },
+        "headers": {
+            "type": "object",
+            "objectShape": {
+                "[key: string]": { "type": "string", "description": "请求头键值对，例：{ Authorization: 'Bearer token', 'X-Custom-Header': 'value' }" }
+            },
+            "completeExample": "{ Authorization: 'Bearer ' + token }",
+            "description": "请求头配置",
+            "src": "src/Upload/interface.tsx:112"
+        },
+        "withCredentials": {
+            "type": "boolean",
+            "default": false,
+            "description": "上传请求时是否携带 cookie",
+            "src": "src/Upload/interface.tsx:134"
+        },
+        "customRequest": {
+            "type": "function",
+            "signature": "(option: UploadRequestOption) => void",
+            "description": "完全覆盖默认上传行为，option 包含 action/file/headers/onSuccess/onError/onProgress 等，适合自定义上传逻辑",
+            "src": "src/Upload/interface.tsx:132"
+        },
+        "accept": {
+            "type": "string",
+            "description": "接受的文件类型，遵循 HTML input accept 规范，例：'.jpg,.png,image/*'",
+            "src": "src/Upload/interface.tsx:114"
+        },
+        "multiple": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否支持多选文件，开启后按住 ctrl 可选择多个文件",
+            "src": "src/Upload/interface.tsx:116"
+        },
+        "directory": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否支持上传文件夹",
+            "src": "src/Upload/interface.tsx:108"
+        },
+        "disabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否禁用上传",
+            "src": "src/Upload/interface.tsx:98"
+        },
+        "disabledTooltip": {
+            "type": "object",
+            "description": "禁用状态下的 Tooltip 提示配置，传 TooltipProps",
+            "src": "src/Upload/index.tsx:47"
+        },
+        "openFileDialogOnClick": {
+            "type": "boolean",
+            "default": true,
+            "description": "点击时是否打开文件选择对话框",
+            "src": "src/Upload/interface.tsx:136"
+        },
+        "fileList": {
+            "type": "array",
+            "itemSchema": {
+                "uid": { "type": "string", "description": "唯一标识，必填" },
+                "name": { "type": "string", "description": "文件名，必填" },
+                "status": { "type": "enum", "values": ["error", "done", "removed"], "description": "上传状态，默认 done" },
+                "url": { "type": "string", "description": "文件默认显示地址" },
+                "thumbUrl": { "type": "string", "description": "缩略图地址" },
+                "dataUrl": { "type": "string", "description": "上传时的 dataUrl" },
+                "size": { "type": "number", "description": "文件字节大小" },
+                "type": { "type": "string", "description": "文件 MIME 类型" },
+                "response": { "type": "string", "description": "服务端响应内容" },
+                "lastModified": { "type": "number", "description": "最后修改时间戳" },
+                "originFileObj": { "type": "object", "description": "原始 RcFile 对象" },
+                "isDefault": { "type": "boolean", "description": "是否为默认文件" }
+            },
+            "description": "受控文件列表，传入后组件受控，需配合 onChange 更新",
+            "src": "src/Upload/interface.tsx:142"
+        },
+        "defaultFileList": {
+            "type": "array",
+            "description": "非受控模式下的初始已上传文件列表，结构同 fileList itemSchema",
+            "src": "src/Upload/interface.tsx:140"
+        },
+        "defaultFile": {
+            "type": "object",
+            "description": "默认单个文件（与 defaultFileList 互斥，只能传其中一个），结构同 UploadFile",
+            "src": "src/Upload/index.tsx:52"
+        },
+        "maxCount": {
+            "type": "number",
+            "description": "限制上传数量。当为 1 时，始终用最新文件替换当前文件",
+            "src": "src/Upload/interface.tsx:144"
+        },
+        "listType": {
+            "type": "enum",
+            "values": ["text", "picture-card"],
+            "default": "text",
+            "description": "文件列表展示样式",
+            "src": "src/Upload/interface.tsx:200"
+        },
+        "showUploadList": {
+            "type": "boolean | object",
+            "objectShape": {
+                "showRemoveIcon": { "type": "boolean", "description": "是否显示删除图标" },
+                "removeIcon": { "type": "ReactNode", "description": "自定义删除图标" },
+                "showPreviewIcon": { "type": "boolean", "description": "是否显示预览图标" },
+                "previewIcon": { "type": "ReactNode", "description": "自定义预览图标" }
+            },
+            "default": true,
+            "description": "是否显示上传列表，或传对象自定义列表图标",
+            "src": "src/Upload/interface.tsx:146"
+        },
+        "itemRender": {
+            "type": "function",
+            "signature": "(file: UploadFile, fileList?: Array<UploadFile>) => React.ReactNode",
+            "description": "自定义上传列表项渲染",
+            "src": "src/Upload/index.tsx:39"
+        },
+        "actionRender": {
+            "type": "function",
+            "signature": "(file: UploadFile, actions: { onRemove: () => void; onPreview: () => void }) => React.ReactNode",
+            "description": "自定义渲染上传列表操作按钮区域",
+            "src": "src/Upload/index.tsx:49"
+        },
+        "operateBtnProps": {
+            "type": "function",
+            "signature": "(file: UploadFile, actions: { onRemove: () => void; onPreview: () => void }) => OperateBtnListProps",
+            "description": "上传列表操作按钮组属性，用于配置 OperateBtn 组件",
+            "src": "src/Upload/index.tsx:48"
+        },
+        "showUploadError": {
+            "type": "boolean | object",
+            "objectShape": {
+                "uploadErrorMsg": { "type": "string", "description": "自定义错误提示文案" },
+                "leaveDelay": { "type": "number", "description": "错误提示自动关闭延迟（ms），负数表示不自动关闭" }
+            },
+            "default": false,
+            "description": "是否显示上传错误浮层提示，传对象可自定义文案和关闭延迟",
+            "src": "src/Upload/index.tsx:40"
+        },
+        "removeErrorTip": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否隐藏错误提示弹窗（默认不移除）",
+            "src": "src/Upload/index.tsx:51"
+        },
+        "stash": {
+            "type": "boolean",
+            "default": false,
+            "description": "开启暂存文件模式，beforeUpload 需返回 false 来阻止上传，文件暂存到列表但不发请求",
+            "src": "src/Upload/index.tsx:42"
+        },
+        "showLoading": {
+            "type": "boolean",
+            "default": true,
+            "description": "是否显示上传 loading（仅在有 action 时生效）",
+            "src": "src/Upload/index.tsx:44"
+        },
+        "loading": {
+            "type": "boolean",
+            "default": false,
+            "description": "外部控制 loading 状态",
+            "src": "src/Upload/index.tsx:45"
+        },
+        "size": {
+            "type": "enum",
+            "values": ["small", "medium", "large"],
+            "default": "large",
+            "description": "上传按钮大小",
+            "src": "src/Upload/index.tsx:41"
+        },
+        "height": {
+            "type": "number | string",
+            "description": "拖拽区域（Dragger）的高度",
+            "src": "src/Upload/index.tsx:53"
+        },
+        "dragArea": {
+            "type": "object",
+            "objectShape": {
+                "areaIcon": { "type": "ReactNode", "description": "拖拽区域图标" },
+                "areaText": { "type": "ReactNode", "description": "拖拽区域主文本" },
+                "areaDesc": { "type": "ReactNode", "description": "拖拽区域描述文本" }
+            },
+            "description": "type='drag' 时自定义拖拽区域内容，不传则显示默认图标+文案",
+            "src": "src/Upload/index.tsx:46"
+        },
+        "children": {
+            "type": "ReactNode",
+            "description": "触发上传的自定义元素，传入后替换默认的上传按钮或拖拽区域内容",
+            "src": "src/Upload/index.tsx:38"
+        },
+        "avatarProps": {
+            "type": "boolean | object",
+            "objectShape": {
+                "borderRadius": { "type": "string | number", "description": "圆角，默认 50%" },
+                "showReset": { "type": "boolean", "description": "是否展示重置按钮，默认 false" },
+                "defaultImage": { "type": "object", "description": "{ imageUrl: string; imageName?: string; } 默认头像" },
+                "showName": { "type": "boolean", "description": "是否展示图片名称，默认 false" }
+            },
+            "description": "头像上传模式属性配置",
+            "src": "src/Upload/interface.tsx:118"
+        },
+        "beforeUpload": {
+            "type": "function",
+            "signature": "(file: RcFile, FileList?: RcFile[]) => boolean | string | File | Blob | Promise<boolean | string | File | Blob | void>",
+            "description": "⚠️ 上传前校验钩子：返回 false 同步阻止上传；返回 Promise.reject() 同样阻止；返回 Promise.resolve(File/Blob) 可替换上传文件。不要在异步场景下依赖同步返回值。",
+            "src": "src/Upload/interface.tsx:130"
+        },
+        "onChange": {
+            "type": "function",
+            "signature": "(files: UploadFile[]) => void",
+            "description": "⚠️ 注意：此组件 onChange 签名为直接传入 UploadFile[] 数组（非 antd 的 { file, fileList } 对象），每次状态变化（选择、上传中、完成、错误、删除）均会触发",
+            "src": "src/Upload/interface.tsx:120"
+        },
+        "onStart": {
+            "type": "function",
+            "signature": "(file: RcFile) => void",
+            "description": "上传开始时回调",
+            "src": "src/Upload/index.tsx:26"
+        },
+        "onSuccess": {
+            "type": "function",
+            "signature": "(response: unknown, file: RcFile, xhr?: unknown) => void",
+            "description": "上传成功回调",
+            "src": "src/Upload/index.tsx:27"
+        },
+        "onError": {
+            "type": "function",
+            "signature": "(error: Error, ret?: unknown, file?: RcFile) => void",
+            "description": "上传失败回调",
+            "src": "src/Upload/index.tsx:28"
+        },
+        "onProgress": {
+            "type": "function",
+            "signature": "(event: { percent: number }, file?: RcFile) => void",
+            "description": "上传进度回调",
+            "src": "src/Upload/index.tsx:29"
+        },
+        "onRemove": {
+            "type": "function",
+            "signature": "(file: UploadFile) => void | boolean | Promise<void | boolean>",
+            "description": "点击移除文件时回调，返回 false 或 Promise<false> 可阻止删除",
+            "src": "src/Upload/interface.tsx:138"
+        },
+        "onPreview": {
+            "type": "function",
+            "signature": "(file: UploadFile, event?: React.MouseEvent) => Promise<boolean | void>",
+            "description": "点击文件链接或预览图标的回调，返回 false 可阻止组件默认预览行为",
+            "src": "src/Upload/index.tsx:50"
+        },
+        "onDrop": {
+            "type": "function",
+            "signature": "(event: React.DragEvent) => void",
+            "description": "文件被拖入上传区域时的回调（仅 type='drag' 有效）",
+            "src": "src/Upload/index.tsx:33"
+        }
+    },
+    "commonMisconceptions": [
+        "⚠️ 图片/头像上传不要手拼 `<Upload listType='picture-card'>`——应直接用 `<Upload.ImageUpload>`，后者自带图片卡片样式且 accept 默认 image/*",
+        "⚠️ onChange 签名与 antd 不同：此组件直接传 `UploadFile[]`，不是 `{ file: UploadFile; fileList: UploadFile[] }`",
+        "⚠️ 拖拽上传：推荐 `<Upload.Dragger>`，或等价写法 `<Upload type='drag'>`，不要裸写 HTML drag 事件"
+    ],
+    "do": [
+        "图片/头像上传用 `<Upload.ImageUpload>`，不要手动设置 listType='picture-card'",
+        "拖拽上传用 `<Upload.Dragger>` 或 `<Upload type='drag'>`",
+        "上传大文件或特定格式时使用 beforeUpload 进行校验",
+        "需要自定义上传逻辑（如分片、签名）时使用 customRequest",
+        "受控文件列表：fileList + onChange 配合，onChange 中必须调用 setFileList 更新 state（否则列表 UI 不更新）"
+    ],
+    "dont": [
+        "⚠️ 图片上传不要用 `<Upload listType='picture-card'>`——改用 `<Upload.ImageUpload>`（antd 迁移常见错误）",
+        "⚠️ onChange 不要写成 antd 格式的 `({file, fileList}) => void`——此组件签名为 `(files: UploadFile[]) => void`",
+        "在没有用户触发的情况下自动上传（通常需要用户 explicit action）",
+        "使用 Upload 组件进行非文件类数据的提交"
+    ],
+    "events": {
+        "onChange": {
+            "signature": "(files: UploadFile[]) => void",
+            "asyncSupported": false,
+            "examples": [
+                "受控文件列表：onChange={(files) => setFileList(files)} 必须同步更新 state",
+                "监听上传完成：onChange={(files) => { const done = files.filter(f=>f.status==='done'); }}",
+                "每次选择/上传/删除都触发：onChange 是全量文件列表，不是增量"
+            ],
+            "commonMistakes": [
+                "假设 onChange 签名是 ({file, fileList}) => void（antd 格式）——此组件直接传 UploadFile[] 数组",
+                "受控模式下不在 onChange 中更新 fileList——导致列表 UI 不更新",
+                "onChange 触发时机包括选择、上传中、完成、错误、删除，不只是上传完成"
+            ]
+        },
+        "beforeUpload": {
+            "signature": "(file: RcFile, FileList?: RcFile[]) => boolean | string | File | Blob | Promise<boolean | string | File | Blob | void>",
+            "asyncSupported": true,
+            "examples": [
+                "同步阻止：beforeUpload={(file) => { if(file.size > 2*1024*1024) { message.error('文件超过2M'); return false; } return true; }}",
+                "异步替换文件：beforeUpload={(file) => compressImage(file).then(blob => blob)}",
+                "暂存模式（stash=true）：beforeUpload 返回 false，文件暂存到列表但不发请求"
+            ],
+            "commonMistakes": [
+                "返回 Promise.reject() 而非 false 来阻止上传——在某些浏览器 reject 可能不阻止",
+                "异步场景下依赖同步返回值——异步 beforeUpload 应返回 Promise",
+                "stash=true 时忘记在 beforeUpload 返回 false——不返回 false 文件会立即上传"
+            ]
+        },
+        "onSuccess": {
+            "signature": "(response: unknown, file: RcFile, xhr?: unknown) => void",
+            "asyncSupported": false,
+            "examples": [
+                "获取服务端返回的文件 URL：onSuccess={(res) => setUploadedUrl(res.data.url)}",
+                "上传成功后更新表单字段：onSuccess={(res, file) => form.current.refreshForm(...)}",
+                "多文件场景记录每个文件的响应：onSuccess={(res, file) => setResults(prev => ({...prev, [file.uid]: res}))}"
+            ],
+            "commonMistakes": [
+                "假设 response 有固定类型——response 是 unknown，需要类型断言后访问字段",
+                "在 onSuccess 中更新 fileList state——应在 onChange 中统一处理，onSuccess 只做额外副作用"
+            ]
+        },
+        "onRemove": {
+            "signature": "(file: UploadFile) => void | boolean | Promise<void | boolean>",
+            "asyncSupported": true,
+            "examples": [
+                "阻止删除（如权限控制）：onRemove={() => false}",
+                "异步确认删除：onRemove={(file) => confirm().then(ok => ok)}",
+                "删除前调用服务端接口：onRemove={async (file) => { await api.delete(file.url); return true; }}"
+            ],
+            "commonMistakes": [
+                "假设 onRemove 返回 void 就可以阻止删除——必须返回 false（或 Promise<false>）才能阻止",
+                "忘记在受控模式下处理 onRemove——onChange 会在删除后触发，不需要在 onRemove 里手动 splice"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "onChange 签名是 (files: UploadFile[]) => void，不是 antd 的 ({file,fileList}) => void",
+            "wrong": "onChange={({file, fileList}) => setList(fileList)}  // 解构对象，实际传入的是数组",
+            "right": "onChange={(files) => setList(files)}  // files 直接就是 UploadFile[]"
+        },
+        {
+            "issue": "UploadFile 的 status 类型只有 'error' | 'done' | 'removed'，没有 'uploading'",
+            "wrong": "if (file.status === 'uploading') ...  // 永远不匹配，UploadFile.status 无此值",
+            "right": "// 上传中状态用 showLoading/loading prop 控制 UI；file.status 只有完成后才赋值"
+        },
+        {
+            "issue": "RcFile 是 OriRcFile 的扩展，不能直接用 File 类型断言",
+            "wrong": "const f = file as File; f.lastModifiedDate  // File 无 lastModifiedDate（是 RcFile 扩展字段）",
+            "right": "import { RcFile } from '@para-ui/core'; const f = file as RcFile; f.lastModifiedDate"
+        },
+        {
+            "issue": "customRequest option 包含 onSuccess/onError/onProgress，自定义上传必须调用这些回调",
+            "wrong": "customRequest={async ({file, action}) => { const res = await upload(file, action); }}  // 未调用 onSuccess",
+            "right": "customRequest={async ({file, action, onSuccess, onError}) => { try { const res = await upload(file, action); onSuccess(res); } catch(e) { onError(e); } }}"
+        },
+        {
+            "issue": "onChange 回调参数是 UploadFile[] 数组,不是 antd 风格的 {file, fileList} 对象 (TS2339)",
+            "wrong": "onChange={({file, fileList}) => { const latest = fileList[fileList.length-1]; ... }}  // TS2339: Property 'fileList' does not exist on type 'UploadFile<unknown>[]'",
+            "right": "onChange={(files: UploadFile[]) => { const latest = files[files.length-1]; ... }}"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Upload",
+        "adapter": null
+    }
+}

package/lib/Upload/util.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@paraview/lib"),u=(e="")=>{const t=e.split("/"),i=t[t.length-1].split(/#|\?/)[0];return(/\.[^./\\]*$/.exec(i)||[""])[0]},c=e=>e.indexOf("image/")===0,f=e=>{if(e.type&&!e.thumbUrl)return c(e.type);const t=e.thumbUrl||e.url||"",s=u(t);return/^data:image\//.test(t)||/(webp|svg|png|gif|jpg|jpeg|jfif|bmp|dpg|ico|heic|heif)$/i.test(s)?!0:!(/^data:/.test(t)||s)},r=e=>{if(e){const t={...e};return t.isDefault=!0,t.uid||(t.uid=o.UUID()),{...t}}},a=(e,t)=>{const s=r(t);return e?.length?e:s?[s]:[]},p=(e,t,s)=>{let i=[...t];e===1?i=i.slice(-1):e&&(i=i.slice(0,e));const n=r(s);return n&&i.length&&(i=i.filter(l=>!l.isDefault)),!i.length&&n&&(i=i.concat(n)),[...i]};exports.composeDefaultFile=r;exports.composeDefaultFileList=a;exports.isImageUrl=f;exports.processUploadFiles=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@snack-kit/lib"),u=(e="")=>{const t=e.split("/"),i=t[t.length-1].split(/#|\?/)[0];return(/\.[^./\\]*$/.exec(i)||[""])[0]},c=e=>e.indexOf("image/")===0,f=e=>{if(e.type&&!e.thumbUrl)return c(e.type);const t=e.thumbUrl||e.url||"",s=u(t);return/^data:image\//.test(t)||/(webp|svg|png|gif|jpg|jpeg|jfif|bmp|dpg|ico|heic|heif)$/i.test(s)?!0:!(/^data:/.test(t)||s)},r=e=>{if(e){const t={...e};return t.isDefault=!0,t.uid||(t.uid=o.UUID()),{...t}}},a=(e,t)=>{const s=r(t);return e?.length?e:s?[s]:[]},p=(e,t,s)=>{let i=[...t];e===1?i=i.slice(-1):e&&(i=i.slice(0,e));const n=r(s);return n&&i.length&&(i=i.filter(l=>!l.isDefault)),!i.length&&n&&(i=i.concat(n)),[...i]};exports.composeDefaultFile=r;exports.composeDefaultFileList=a;exports.isImageUrl=f;exports.processUploadFiles=p;
 //# sourceMappingURL=util.js.map

package/lib/Utils/snack-kit-shims.d.ts

@@ -0,0 +1,18 @@
+import { HttpRequestConfig } from '@snack-kit/lib';
+/**
+ * 兼容旧 @paraview/lib 的 ParaRequestConfig。
+ * 上游未提供该类型，本仓库自定义为 HttpRequestConfig（继承 AxiosRequestConfig，
+ * 含 ctx/cancelId/onCancelId/cache 扩展字段）。
+ */
+export type ParaRequestConfig<D = unknown> = HttpRequestConfig<D>;
+/** 数组 → 对象映射，等价旧版 ArrayToObject(key, list) */
+export declare const ArrayToObject: <T>(key: string, list: T[] | null | undefined) => Record<string, T>;
+/** 字符串 JSON → 对象，解析失败返回 fallback */
+export declare const ToObject: <T = unknown>(input: string | null | undefined, fallback: T) => T;
+/** 旧 IE / Trident 检测（仅用于历史代码 motionDeadline 兼容） */
+export declare const isIE: () => boolean;
+export type BrowserClass = 'edge' | 'chrome' | 'firefox' | 'safari' | 'ie' | 'other';
+/** 浏览器分类，返回值是 BrowserClass 字面量联合之一 */
+export declare const GetBrowserClass: () => BrowserClass;
+/** 取浏览器语言，返回 'zh' / 'en' 形式（项目历史行为：截取主语言段） */
+export declare const GetLanguage: () => string;

package/lib/Utils/snack-kit-shims.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=(e,o)=>{const t={};for(const r of o||[]){const n=r?.[e];n!=null&&(t[String(n)]=r)}return t},i=()=>typeof navigator>"u"?!1:/MSIE|Trident/.test(navigator.userAgent),s=()=>{if(typeof navigator>"u")return"other";const e=navigator.userAgent;return/Edg\//.test(e)?"edge":/Chrome\//.test(e)?"chrome":/Firefox\//.test(e)?"firefox":/Safari\//.test(e)&&!/Chrome\//.test(e)?"safari":/MSIE|Trident/.test(e)?"ie":"other"},u=()=>typeof navigator>"u"?"zh":(navigator.language||navigator.userLanguage||"zh").split(/[-_]/)[0].toLowerCase();exports.ArrayToObject=a;exports.GetBrowserClass=s;exports.GetLanguage=u;exports.isIE=i;
+//# sourceMappingURL=snack-kit-shims.js.map

package/lib/Utils/type.d.ts

@@ -1,6 +1,4 @@
 import { ReactNode } from 'react';
-/** 通用对象类型 - 允许任意值 */
-export type IObject = Record<string, unknown>;
 /** 通用键值对类型 */
 export type IRecord<T = unknown> = Record<string, T>;
 /** 通用选项值类型 */

package/lib/_virtual/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../node_modules/@para-snack/core/dist/index.js");var r=e.__require();exports.distExports=r;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./_commonjsHelpers.js"),r=require("../node_modules/classnames/index.js");var s=r.__require();const t=e.getDefaultExportFromCjs(s);exports.default=t;
 //# sourceMappingURL=index.js.map

package/lib/_virtual/index2.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./_commonjsHelpers.js"),r=require("../node_modules/classnames/index.js");var s=r.__require();const t=e.getDefaultExportFromCjs(s);exports.default=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e={exports:{}};exports.__module=e;
 //# sourceMappingURL=index2.js.map

package/lib/index.d.ts

@@ -96,6 +96,7 @@ export { default as Message } from './Message';
 export * from './Message';
 export { default as Modal } from './Modal';
 export * from './Modal';
+export type { ModalDismissReason } from './Modal/interface';
 export { default as MultiBox } from './MultiBox';
 export * from './MultiBox';
 export { default as Notification } from './Notification';
@@ -138,6 +139,7 @@ export { default as Search } from './Search';
 export * from './Search';
 export { default as Select } from './Select';
 export * from './Select';
+export type { SelectOptionValue, SelectOptionBase } from './Utils/type';
 export { default as SelectInput } from './SelectInput';
 export * from './SelectInput';
 export { default as Selector } from './Selector';

package/lib/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require('./Tree/style/index.css');require('./ColorPicker/index.css');require('./Cascader/index.css');const a=require("./AlignBox/index.js"),c=require("./Anchor/index.js"),e=require("./Argv/index.js"),l=require("./AutoBox/index.js"),s=require("./AutoButton/index.js"),x=require("./AutoTips/index.js"),q=require("./Badge/index.js"),p=require("./Breadcrumbs/index.js"),_=require("./Button/index.js"),f=require("./ButtonGroup/index.js"),g=require("./Card/index.js"),C=require("./Carousel/index.js"),m=require("./Cascader/Cascader.js");;/* empty css                     */const T=require("./Checkbox/index.js"),B=require("./CheckboxGroup/index.js"),t=require("./CodeEditor/index.js"),S=require("./Collapse/index.js"),P=require("./CollapseBox/index.js"),b=require("./CollapseLayout/index.js"),M=require("./ColorPicker/swatchesPicker/index.js"),k=require("./ColorPicker/compactPicker/index.js"),D=require("./ColorPicker/chromePicker/index.js"),h=require("./ColorPicker/sketchPicker/index.js");;/* empty css                        */const y=require("./ComboSelect/index.js"),I=require("./Container/index.js"),R=require("./ContentBox/index.js"),A=require("./CopyText/index.js"),F=require("./CycleSelector/index.js"),G=require("./DatePicker/index.js"),L=require("./Descriptions/index.js"),v=require("./Desktop/index.js"),w=require("./DragVerify/index.js"),H=require("./Drawer/index.js"),j=require("./Dropdown/index.js"),O=require("./DynamicMultiBox/index.js"),Y=require("./Empty/index.js"),Q=require("./FieldForm/index.js"),E=require("./Form/index.js"),$=require("./FormItem/index.js"),o=require("./FunctionModal/modalContext.js"),N=require("./GlobalContext/index.js"),U=require("./Help/index.js"),V=require("./HelperText/index.js"),K=require("./Image/index.js"),z=require("./InputCode/index.js"),J=require("./InputLang/index.js"),W=require("./InputNumber/index.js"),X=require("./Label/index.js"),Z=require("./Loading/index.js"),ee=require("./Menu/index.js"),i=require("./Message/index.js"),re=require("./Modal/index.js"),oe=require("./MultiBox/index.js"),te=require("./Notification/index.js"),ie=require("./OperateBtn/index.js"),ne=require("./PageHeader/index.js"),ue=require("./Pagination/index.js"),de=require("./ParauiProvider/index.js"),ae=require("./PasswordRules/index.js"),ce=require("./PopConfirm/index.js"),le=require("./PopMenu/index.js"),se=require("./Popover/index.js"),xe=require("./Progress/index.js"),qe=require("./Prompt/index.js"),pe=require("./Querying/index.js"),_e=require("./QuickReply/index.js"),fe=require("./Radio/index.js"),ge=require("./RadioGroup/index.js"),Ce=require("./RangeInput/index.js"),me=require("./Result/index.js"),Te=require("./ScrollBar/index.js"),Be=require("./Search/index.js"),Se=require("./Select/index.js"),Pe=require("./SelectInput/index.js"),n=require("./Selector/index.js"),be=require("./SelectorPicker/index.js"),Me=require("./SingleBox/index.js"),ke=require("./Slider/index.js"),De=require("./SortBox/index.js"),he=require("./Status/index.js"),ye=require("./Stepper/index.js"),Ie=require("./Switch/index.js"),Re=require("./Table/index.js"),Ae=require("./Tabs/index.js"),Fe=require("./Tag/index.js"),Ge=require("./TextEditor/index.js"),Le=require("./TextField/index.js"),ve=require("./TimePicker/index.js"),we=require("./Timeline/index.js"),He=require("./Title/index.js"),je=require("./ToggleButton/index.js"),Oe=require("./Tooltip/index.js"),u=require("./Transfer/index.js"),Ye=require("./Tree/Tree.js");;/* empty css                       */const Qe=require("./Upload/index.js"),r=require("./Utils/index.js"),Ee=require("./locale/index.js"),$e=require("./AutoTips/autoTipsMultiline/index.js"),Ne=require("./QuickReply/QuickReplyCode/index.js"),Ue=require("./Tag/TagGroup.js"),Ve=require("./ToggleButton/ToggleButtonGroup.js"),Ke=require("./Modal/Confirm/index.js"),d=require("./GlobalContext/confirmLocale.js");exports.AlignBox=a.default;exports.Anchor=c.default;exports.Argv=e.default;exports.checkArgvData=e.checkArgvData;exports.formatDataToObject=e.formatDataToObject;exports.formatObjectToData=e.formatObjectToData;exports.AutoBox=l.AutoBox;exports.AutoButton=s.AutoButton;exports.AutoTips=x.default;exports.Badge=q.Badge;exports.Breadcrumbs=p.Breadcrumbs;exports.Button=_.Button;exports.ButtonGroup=f.ButtonGroup;exports.Card=g.Card;exports.Carousel=C.Carousel;exports.Cascader=m.default;exports.Checkbox=T.Checkbox;exports.CheckboxGroup=B.CheckboxGroup;exports.CodeEditor=t.default;exports.CompletionItemKind=t.CompletionItemKind;exports.Collapse=S.Collapse;exports.CollapseBox=P.default;exports.CollapseLayout=b.default;exports.SwatchesPicker=M.default;exports.CompactPicker=k.default;exports.ChromePicker=D.default;exports.ColorPicker=h.default;exports.ComboSelect=y.ComboSelect;exports.Container=I.Container;exports.ContentBox=R.default;exports.CopyText=A.default;exports.CycleSelector=F.default;exports.DatePicker=G.default;exports.Descriptions=L.default;exports.Desktop=v.Desktop;exports.DragVerify=w.DragVerify;exports.Drawer=H.Drawer;exports.Dropdown=j.Dropdown;exports.DynamicMultiBox=O.default;exports.Empty=Y.default;exports.FieldForm=Q.default;exports.Form=E.default;exports.FormItem=$.default;exports.FunctionModal=o.useModal;exports.FunctionModalProvider=o.FunctionModalProvider;exports.useClose=o.useClose;exports.GlobalContext=N.default;exports.Help=U.default;exports.HelperText=V.default;exports.Image=K.default;exports.InputCode=z.InputCode;exports.InputLang=J.InputLang;exports.InputNumber=W.InputNumber;exports.Label=X.default;exports.Loading=Z.Loading;exports.Menu=ee.Menu;exports.Message=i.default;exports.MessageBar=i.MessageBar;exports.Modal=re.Modal;exports.MultiBox=oe.MultiBox;exports.Notification=te.default;exports.OperateBtn=ie.default;exports.PageHeader=ne.PageHeader;exports.Pagination=ue.Pagination;exports.ParauiProvider=de.ParauiProvider;exports.PasswordRules=ae.default;exports.PopConfirm=ce.PopConfirm;exports.PopMenu=le.PopMenu;exports.Popover=se.Popover;exports.Progress=xe.Progress;exports.Prompt=qe.Prompt;exports.Querying=pe.default;exports.QuickReply=_e.QuickReply;exports.Radio=fe.Radio;exports.RadioGroup=ge.RadioGroup;exports.RangeInput=Ce.RangeInput;exports.Result=me.Result;exports.ScrollBar=Te.default;exports.Search=Be.Search;exports.Select=Se.default;exports.SelectInput=Pe.SelectInput;exports.Selector=n.default;exports.handFieldConfig=n.handFieldConfig;exports.SelectorPicker=be.default;exports.SingleBox=Me.SingleBox;exports.Slider=ke.Slider;exports.SortBox=De.SortBox;exports.Status=he.Status;exports.Stepper=ye.Stepper;exports.Switch=Ie.Switch;exports.Table=Re.default;exports.Tabs=Ae.Tabs;exports.Tag=Fe.Tag;exports.TextEditor=Ge.default;exports.TextField=Le.TextField;exports.TimePicker=ve.default;exports.Timeline=we.Timeline;exports.Title=He.Title;exports.ToggleButton=je.ToggleButton;exports.Tooltip=Oe.Tooltip;exports.SSortablejs=u.SSortablejs;exports.Transfer=u.Transfer;exports.Tree=Ye.default;exports.Upload=Qe.default;exports.Utils=r.default;exports.getDateYYYYMMddHHMM=r.getDateYYYYMMddHHMM;exports.isObject=r.isObject;exports.pixelReplacement=r.pixelReplacement;exports.locale=Ee.default;exports.AutoTipsMultiline=$e.default;exports.QuickReplyCode=Ne.QuickReplyCode;exports.TagGroup=Ue.default;exports.ToggleButtonGroup=Ve.default;exports.Confirm=Ke.Confirm;exports.changeConfirmLocale=d.changeConfirmLocale;exports.getConfirmLocale=d.getConfirmLocale;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require('./Tree/style/index.css');require('./ColorPicker/index.css');require('./Cascader/index.css');const a=require("./AlignBox/index.js"),c=require("./Anchor/index.js"),e=require("./Argv/index.js"),l=require("./AutoBox/index.js"),s=require("./AutoButton/index.js"),x=require("./AutoTips/index.js"),q=require("./Badge/index.js"),p=require("./Breadcrumbs/index.js"),_=require("./Button/index.js"),f=require("./ButtonGroup/index.js"),g=require("./Card/index.js"),C=require("./Carousel/index.js"),m=require("./Cascader/Cascader.js");;/* empty css                     */const T=require("./Checkbox/index.js"),B=require("./CheckboxGroup/index.js"),t=require("./CodeEditor/index.js"),S=require("./Collapse/index.js"),P=require("./CollapseBox/index.js"),b=require("./CollapseLayout/index.js"),M=require("./ColorPicker/swatchesPicker/index.js"),k=require("./ColorPicker/compactPicker/index.js"),D=require("./ColorPicker/chromePicker/index.js"),h=require("./ColorPicker/sketchPicker/index.js");;/* empty css                        */const y=require("./ComboSelect/index.js"),I=require("./Container/index.js"),R=require("./ContentBox/index.js"),A=require("./CopyText/index.js"),F=require("./CycleSelector/index.js"),G=require("./DatePicker/index.js"),L=require("./Descriptions/index.js"),v=require("./Desktop/index.js"),w=require("./DragVerify/index.js"),H=require("./Drawer/index.js"),j=require("./Dropdown/index.js"),O=require("./DynamicMultiBox/index.js"),Y=require("./Empty/index.js"),Q=require("./FieldForm/index.js"),$=require("./Form/index.js"),E=require("./FormItem/index.js"),o=require("./FunctionModal/modalContext.js"),N=require("./GlobalContext/index.js"),U=require("./Help/index.js"),V=require("./HelperText/index.js"),K=require("./Image/index.js"),z=require("./InputCode/index.js"),J=require("./InputLang/index.js"),W=require("./InputNumber/index.js"),X=require("./Label/index.js"),Z=require("./Loading/index.js"),ee=require("./Menu/index.js"),i=require("./Message/index.js"),re=require("./Modal/index.js"),oe=require("./MultiBox/index.js"),te=require("./Notification/index.js"),ie=require("./OperateBtn/index.js"),ne=require("./PageHeader/index.js"),ue=require("./Pagination/index.js"),de=require("./ParauiProvider/index.js"),ae=require("./PasswordRules/index.js"),ce=require("./PopConfirm/index.js"),le=require("./PopMenu/index.js"),se=require("./Popover/index.js"),xe=require("./Progress/index.js"),qe=require("./Prompt/index.js"),pe=require("./Querying/index.js"),_e=require("./QuickReply/index.js"),fe=require("./Radio/index.js"),ge=require("./RadioGroup/index.js"),Ce=require("./RangeInput/index.js"),me=require("./Result/index.js"),Te=require("./ScrollBar/index.js"),Be=require("./Search/index.js"),Se=require("./Select/index.js"),Pe=require("./SelectInput/index.js"),n=require("./Selector/index.js"),be=require("./SelectorPicker/index.js"),Me=require("./SingleBox/index.js"),ke=require("./Slider/index.js"),De=require("./SortBox/index.js"),he=require("./Status/index.js"),ye=require("./Stepper/index.js"),Ie=require("./Switch/index.js"),Re=require("./Table/index.js"),Ae=require("./Tabs/index.js"),Fe=require("./Tag/index.js"),Ge=require("./TextEditor/index.js"),Le=require("./TextField/index.js"),ve=require("./TimePicker/index.js"),we=require("./Timeline/index.js"),He=require("./Title/index.js"),je=require("./ToggleButton/index.js"),Oe=require("./Tooltip/index.js"),u=require("./Transfer/index.js"),Ye=require("./Tree/Tree.js");;/* empty css                       */const Qe=require("./Upload/index.js"),r=require("./Utils/index.js"),$e=require("./locale/index2.js"),Ee=require("./AutoTips/autoTipsMultiline/index.js"),Ne=require("./QuickReply/QuickReplyCode/index.js"),Ue=require("./Tag/TagGroup.js"),Ve=require("./ToggleButton/ToggleButtonGroup.js"),Ke=require("./Modal/Confirm/index.js"),d=require("./GlobalContext/confirmLocale.js");exports.AlignBox=a.default;exports.Anchor=c.default;exports.Argv=e.default;exports.checkArgvData=e.checkArgvData;exports.formatDataToObject=e.formatDataToObject;exports.formatObjectToData=e.formatObjectToData;exports.AutoBox=l.AutoBox;exports.AutoButton=s.AutoButton;exports.AutoTips=x.default;exports.Badge=q.Badge;exports.Breadcrumbs=p.Breadcrumbs;exports.Button=_.Button;exports.ButtonGroup=f.ButtonGroup;exports.Card=g.Card;exports.Carousel=C.Carousel;exports.Cascader=m.default;exports.Checkbox=T.Checkbox;exports.CheckboxGroup=B.CheckboxGroup;exports.CodeEditor=t.default;exports.CompletionItemKind=t.CompletionItemKind;exports.Collapse=S.Collapse;exports.CollapseBox=P.default;exports.CollapseLayout=b.default;exports.SwatchesPicker=M.default;exports.CompactPicker=k.default;exports.ChromePicker=D.default;exports.ColorPicker=h.default;exports.ComboSelect=y.ComboSelect;exports.Container=I.Container;exports.ContentBox=R.default;exports.CopyText=A.default;exports.CycleSelector=F.default;exports.DatePicker=G.default;exports.Descriptions=L.default;exports.Desktop=v.Desktop;exports.DragVerify=w.DragVerify;exports.Drawer=H.Drawer;exports.Dropdown=j.Dropdown;exports.DynamicMultiBox=O.default;exports.Empty=Y.default;exports.FieldForm=Q.default;exports.Form=$.default;exports.FormItem=E.default;exports.FunctionModal=o.useModal;exports.FunctionModalProvider=o.FunctionModalProvider;exports.useClose=o.useClose;exports.GlobalContext=N.default;exports.Help=U.default;exports.HelperText=V.default;exports.Image=K.default;exports.InputCode=z.InputCode;exports.InputLang=J.InputLang;exports.InputNumber=W.InputNumber;exports.Label=X.default;exports.Loading=Z.Loading;exports.Menu=ee.Menu;exports.Message=i.default;exports.MessageBar=i.MessageBar;exports.Modal=re.Modal;exports.MultiBox=oe.MultiBox;exports.Notification=te.default;exports.OperateBtn=ie.default;exports.PageHeader=ne.PageHeader;exports.Pagination=ue.Pagination;exports.ParauiProvider=de.ParauiProvider;exports.PasswordRules=ae.default;exports.PopConfirm=ce.PopConfirm;exports.PopMenu=le.PopMenu;exports.Popover=se.Popover;exports.Progress=xe.Progress;exports.Prompt=qe.Prompt;exports.Querying=pe.default;exports.QuickReply=_e.QuickReply;exports.Radio=fe.Radio;exports.RadioGroup=ge.RadioGroup;exports.RangeInput=Ce.RangeInput;exports.Result=me.Result;exports.ScrollBar=Te.default;exports.Search=Be.Search;exports.Select=Se.default;exports.SelectInput=Pe.SelectInput;exports.Selector=n.default;exports.handFieldConfig=n.handFieldConfig;exports.SelectorPicker=be.default;exports.SingleBox=Me.SingleBox;exports.Slider=ke.Slider;exports.SortBox=De.SortBox;exports.Status=he.Status;exports.Stepper=ye.Stepper;exports.Switch=Ie.Switch;exports.Table=Re.default;exports.Tabs=Ae.Tabs;exports.Tag=Fe.Tag;exports.TextEditor=Ge.default;exports.TextField=Le.TextField;exports.TimePicker=ve.default;exports.Timeline=we.Timeline;exports.Title=He.Title;exports.ToggleButton=je.ToggleButton;exports.Tooltip=Oe.Tooltip;exports.SSortablejs=u.SSortablejs;exports.Transfer=u.Transfer;exports.Tree=Ye.default;exports.Upload=Qe.default;exports.Utils=r.default;exports.getDateYYYYMMddHHMM=r.getDateYYYYMMddHHMM;exports.isObject=r.isObject;exports.pixelReplacement=r.pixelReplacement;exports.locale=$e.default;exports.AutoTipsMultiline=Ee.default;exports.QuickReplyCode=Ne.QuickReplyCode;exports.TagGroup=Ue.default;exports.ToggleButtonGroup=Ve.default;exports.Confirm=Ke.Confirm;exports.changeConfirmLocale=d.changeConfirmLocale;exports.getConfirmLocale=d.getConfirmLocale;
 //# sourceMappingURL=index.js.map