@para-ui/core 5.0.0-beta.12 → 5.0.0-beta.14

package/lib/ComboSelect/component.json

@@ -0,0 +1,181 @@
+{
+    "name": "ComboSelect",
+    "category": "Data Entry",
+    "description": "组合选择器，支持表格、树、列表多种模式",
+    "semantic": {
+        "intent": [
+            "复杂选择",
+            "多模式选择"
+        ],
+        "useCases": [
+            "人员选择",
+            "组织架构",
+            "资源选择"
+        ],
+        "riskLevel": "normal"
+    },
+    "variants": {
+        "table": {
+            "meaning": "表格模式"
+        },
+        "tree": {
+            "meaning": "树形模式"
+        },
+        "list": {
+            "meaning": "列表模式"
+        }
+    },
+    "states": [
+        "default",
+        "disabled",
+        "error"
+    ],
+    "idealProps": {
+        "mode": {
+            "type": "enum",
+            "values": [
+                "table",
+                "tree",
+                "list"
+            ],
+            "default": "table",
+            "description": "选择器模式;tree 启用 fullPath*,table 接受 TableProps,list 无 Table/Tree props"
+        },
+        "value": {
+            "type": "SelectOpt[] | SelectOpt",
+            "description": "受控值;checkable=true 数组(多选),checkable=false 单值(单选);字段名遵循 replaceFields"
+        },
+        "defaultValue": {
+            "type": "SelectOpt[] | SelectOpt",
+            "description": "非受控默认值,与 value 互斥;类型规则同 value"
+        },
+        "onChange": {
+            "type": "function",
+            "signature": "(options: SelectOpt[] | SelectOpt, originData?: TreeNodeProps[] | TreeNodeProps) => void",
+            "description": "value 变更回调;第二参 originData 是底层原数据透传(replaceFields 映射前的形态)"
+        },
+        "checkable": {
+            "type": "boolean",
+            "default": true,
+            "description": "单选 / 多选模式开关;直接影响 value/defaultValue/onChange 类型"
+        },
+        "replaceFields": {
+            "type": "object",
+            "default": "{ key: 'key', title: 'title', children: 'children' }",
+            "description": "入参字段映射;决定 value 里对象用什么字段名"
+        },
+        "outputFields": {
+            "type": "object",
+            "default": "{ outputKey: 'key', outputTitle: 'label' }",
+            "description": "出参字段映射(独立于 replaceFields);决定 onChange options 里字段名"
+        },
+        "showSearch": {
+            "type": "boolean",
+            "default": false,
+            "description": "显示搜索框;配合 realTimeSearch/searchPlaceholder/onSearch 使用"
+        },
+        "allowClear": {
+            "type": "boolean",
+            "default": false,
+            "description": "允许清空;触发 onClear 后组件自动清内部 state,父端需同步父 state"
+        },
+        "url": {
+            "type": "string",
+            "description": "远程数据源 URL;配合 ctx/method/params 一组使用,替代 TableProps.data / TreeProps.treeData"
+        },
+        "method": {
+            "type": "enum",
+            "values": [
+                "Get",
+                "Post"
+            ],
+            "default": "Get",
+            "description": "请求方法;注意首字母大写,不是 GET/POST"
+        }
+    },
+    "epics": [
+        "ComboSelect-api-rework-epic.md (R20 W-3 起草 · 议题 A 泛型化 / 议题 B 字段映射对称 / R21 user 评审)"
+    ],
+    "do": [
+        "用于需要复杂选择逻辑的场景（人员选择、组织架构、资源选择），简单场景用 Select",
+        "配合服务端搜索减少数据量（url + params + showSearch + onSearch）",
+        "checkable=false 单选时，value/onChange 的 options 是 SelectOpt 对象而非数组——不要用数组 API",
+        "replaceFields 和 outputFields 独立控制：replaceFields 控制入参字段映射，outputFields 控制 onChange 出参字段映射，两者不互通"
+    ],
+    "dont": [
+        "简单选择场景使用（应使用 Select，ComboSelect 引入了 Table/Tree 等重依赖）",
+        "数据量极大时不分页（远程模式需配合 TableProps.pagination 或分页参数控制）",
+        "不要假设 onOk 和 onChange 触发时机相同——showPopoverActions=true 时用 onOk/onCancel；不显示 footer 时只有 onChange"
+    ],
+    "events": {
+        "onChange": {
+            "signature": "(options: SelectOpt[] | SelectOpt, originData?: TreeNodeProps[] | TreeNodeProps) => void",
+            "asyncSupported": false,
+            "examples": [
+                "多选（checkable=true）：options 是 SelectOpt[] 数组，每项含 outputFields 指定的字段",
+                "单选（checkable=false）：options 是单个 SelectOpt 对象（不是数组），originData 是原始树节点",
+                "清空时（allowClear=true 触发 onClear）：onChange 额外触发，checkable=true 时 options=[]，checkable=false 时 options={}"
+            ],
+            "commonMistakes": [
+                "checkable=false 时把 options 当数组处理——单选模式 options 是 SelectOpt 对象，直接 .key 取值，不能 .map()",
+                "忽略 outputFields 对出参字段的影响——默认 outputFields={ outputKey:'key', outputTitle:'label' }，出参对象的 key 名是 outputKey/outputTitle，不是原始的 replaceFields 字段名",
+                "假设 onOk 等价 onChange——showPopoverActions=false 时没有 onOk，所有变更走 onChange；showPopoverActions=true 时点「确定」才触发 onOk",
+                "onTagRemove 返回 false 阻止删除后仍期望 onChange 触发——src 实证（index.tsx:236）返回 false 时直接 return，不会触发 onChange"
+            ]
+        },
+        "onOk": {
+            "signature": "(options: SelectedOptions) => void",
+            "asyncSupported": false,
+            "examples": [
+                "showPopoverActions=true 时用户点「确定」按钮触发，options 为当前选中列表",
+                "适合「选择后需要二次确认」场景——弹框有确认/取消按钮"
+            ],
+            "commonMistakes": [
+                "showPopoverActions=false 时期望 onOk 触发——不会，此时直接监听 onChange",
+                "onOk 和 onChange 同时监听导致重复处理——showPopoverActions=true 时推荐只用 onOk，不依赖 onChange"
+            ]
+        },
+        "onSearch": {
+            "signature": "(searchKey: string) => void",
+            "asyncSupported": false,
+            "examples": [
+                "showSearch=true 时用户输入触发，searchKey 为当前输入字符串",
+                "服务端搜索：在 onSearch 中更新请求参数，配合 params 刷新数据"
+            ],
+            "commonMistakes": [
+                "不传 onSearch 时期望服务端搜索——不传则组件做客户端过滤（realTimeSearch=true 时），服务端搜索必须传 onSearch"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "checkable=false 单选时 onChange 的 options 是 SelectOpt 对象而非数组，直接用数组方法报错",
+            "wrong": "onChange={(options) => options.map(o => o.key)}  // checkable=false 时 options 是对象，没有 .map()",
+            "right": "onChange={(options) => { if (Array.isArray(options)) { /* 多选 */ } else { /* 单选，options 是 SelectOpt */ } }}"
+        },
+        {
+            "issue": "method 字段首字母大写（'Get'|'Post'），传 'GET'/'POST' 会被忽略",
+            "wrong": "method='GET'  // 源码 interface 定义是 'Get' | 'Post'，大小写不同",
+            "right": "method='Get'  // 或 method='Post'（src/ComboSelect/interface.tsx 实证）"
+        },
+        {
+            "issue": "SelectOpt 是 { disabled?: boolean; closable?: boolean; [key: string]: any }，索引签名允许任意字段，但不应假设 key/title 字段名——取决于 outputFields",
+            "wrong": "const key = options[0].key  // 假设出参字段名是 key，实际由 outputFields.outputKey 决定",
+            "right": "const { outputKey = 'key' } = outputFields || {}; const key = options[0][outputKey];"
+        },
+        {
+            "issue": "value 类型随 checkable 变化，单独声明 useState 类型需要联合",
+            "wrong": "const [val, setVal] = useState<SelectOpt[]>()  // checkable=false 时 value 是 SelectOpt，不是数组",
+            "right": "const [val, setVal] = useState<SelectOpt[] | SelectOpt | undefined>()"
+        },
+        {
+            "issue": "嵌套 TableProps 时必须用 Para UI 的 headData（不是 antd 的 columns），字段结构也不同",
+            "wrong": "TableProps={{ columns: [{ title: '姓名', dataIndex: 'title' }] }}  // TS2353: 'columns' does not exist in type TableProps",
+            "right": "TableProps={{ headData: [{ name: 'title', label: '姓名', width: 200 }] }}  // headData 每项用 { name, label, width? }，name 对应数据字段 key，label 是表头显示文字"
+        }
+    ],
+    "mapping": {
+        "realComponent": "ComboSelect",
+        "adapter": null
+    }
+}

package/lib/ComboSelect/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');require('../Tree/style/index.css');const t=require("../_virtual/jsx-runtime.js"),o=require("react"),Ht=require("../node_modules/@para-ui/icons/Down/index.js"),Wt=require("../node_modules/@para-ui/icons/Search/index.js"),et=require("../node_modules/@para-ui/icons/Close/index.js"),Bt=require("../node_modules/@para-ui/icons/CloseCircleF/index.js"),Gt=require("../Table/index.js"),Ut=require("../Tree/Tree.js");;/* empty css                        */const tt=require("../Button/index.js"),Jt=require("../Dropdown/index.js"),st=require("../Popover/index.js"),be=require("../AutoTips/index.js"),Qt=require("../Tooltip/index.js"),F=require("clsx"),S=require("./utils.js"),Xt=require("@snack-kit/lib"),Yt=require("../Utils/snack-kit-shims.js"),Zt=require("../GlobalContext/index.js"),es=require("../Hooks/useGlobalProps.js"),ts=require("../GlobalContext/useFormatMessage.js"),ss=require("./lang/index.js"),rs=require("../Label/index.js"),os=require("../HelperText/index.js"),d=require("../GlobalContext/constant.js"),ns=require("../Search/index.js"),ls=require("../node_modules/@para-ui/icons/LoadingF/index.js");;/* empty css            */const rt=ot=>{const{mode:m="table",placeholder:je,searchPlaceholder:nt,overLine:K=!1,disabled:Re=!1,allowClear:lt=!1,className:ct,style:it,maxHeight:at,height:ut,placement:dt="bottomLeft",popoverClassName:mt,size:pt="large",popoverActions:ve=null,showPopoverActions:ge=!1,defaultOpen:Z=!1,defaultValue:Ee,replaceFields:xt={key:"key",title:"title",children:"children"},outputFields:ft={outputKey:"key",outputTitle:"label"},value:ee,onClear:te,onCancel:ht,onOk:bt,onClose:jt,onChange:C,onSearch:se,refresh:y,TableProps:re,TreeProps:k,checkable:a=!0,url:Ce,ctx:ye,params:$,method:we="Get",showSearch:_=!1,realTimeSearch:Rt=!1,error:Se=!1,hideErrorDom:vt,helperText:oe,paramsCallback:gt,fullPathKey:Et,fullPathRender:$e,disablePopup:x=!1,tagRender:ne,onTagRemove:Ne,action:Ct,label:Te="",labelTooltip:yt,required:ke=!1,emptyProps:Pe,toggleSelectedOnSingle:wt=!1,optionRender:qe,getOptionLabel:Me,dropdownMatchSelectWidth:le=!0,getPopupContainer:St,maxTagTextLength:A,renderInputContent:I,renderTagLabel:ce,renderMoreTagLabel:Le}=es.default(ot,"ComboSelect"),{language:Oe,locale:De}=o.useContext(Zt.default),N=o.useRef(null),[f,ie]=o.useState(!1),[j,V]=o.useState([]),H=o.useRef(new Map),[u,W]=o.useState([]),[B,ze]=o.useState(""),G=o.useRef(void 0),[P,Fe]=o.useState(null),[q,$t]=o.useState(!1),[T,Nt]=o.useState(0),[M,L]=o.useState(!1),ae=o.useRef([]),O=o.useRef(!1),U=o.useRef(null),Ke=o.useRef({}),_e=S.getReplaceField(m,xt,re,k),{key:D="",title:Ae=""}=_e,{outputKey:R="key",outputTitle:g="label"}=ft||{},w=ts.default("ComboSelect",ss.default),Ie=o.useRef(S.isRemoteLoad(m,m==="table"?re:k)),[ue,Tt]=o.useState(),h=o.useRef({list:[]}),[E,de]=o.useState(null),me=o.useRef(null);h.current.openMore=M,h.current.list=[...u];const kt=()=>{h.current.openMore&&L(!1)},Ve=e=>{if(e===null||e===0||(e===void 0&&(e=h.current.list.length),!me.current))return;const s=me.current.querySelector(".comboselect-overflow-list");if(s)if(s.scrollHeight>s.clientHeight){const r=Number(e)-1;de(r),Ve(r)}else h.current.list.length<=e&&kt()},J=()=>{if(h.current.list.length===0)return de(null);clearTimeout(h.current.resizeTimer),h.current.resizeTimer=setTimeout(()=>{de(h.current.list.length),Ve()},50)};o.useEffect(()=>(J(),()=>{clearTimeout(h.current.resizeTimer)}),[u]),o.useEffect(()=>(!K&&a?window.addEventListener("resize",J):window.removeEventListener("resize",J),()=>{window.removeEventListener("resize",J)}),[K,a]);const Pt=e=>{if(!x&&!Re){if(O.current){v();return}O.current=!0,ie(!0)}},v=(e,s)=>{O.current=!1,G.current=void 0,Ke.current={},ie(!1),Fe(null),ze(""),jt?.(),s==="cancel"&&He()},He=()=>{V([]),W([])},pe=(e,s)=>{V(e),Dt(s,e)},qt=e=>{V(s=>{const r=s.findIndex(l=>l===e[R]);return r>-1&&s.splice(r,1),[...s]})},We=(e,s)=>{if(e.stopPropagation(),s.closable===!1||Ne?.(s)===!1)return;const r=[...u],l=r.findIndex(n=>n[R]===s[R]);l>-1&&r.splice(l,1),W(r),qt(s),C?.(r)},Mt=o.useMemo(()=>S.debounce(async e=>{Q(e)},400),[]),Lt=e=>{ze(e),Rt&&Mt(e)},Q=e=>{const s=e??B;se?se(s):(G.current=s?.trim(),Nt(Math.random())),Ie.current&&Tt([])},Be=(e,s)=>{s?(bt?.(u),v(null,"ok")):(ht?.(),v(null,"cancel"))},Ge=()=>{let e="auto";N.current&&(e=`${N.current.offsetWidth}px`);const s=S.getOverlaySize(m,Ie.current,at,ut),r={minWidth:e,maxWidth:960};return typeof le=="number"?r.width=le:le&&(r.width=e),{overflow:"auto",...r,...s}},Ot=()=>F(`${d.$prefixCls}-comboselect`,ct,{[`${d.$prefixCls}-comboselect-focused`]:f&&!x,[`${d.$prefixCls}-comboselect-disabled`]:Re,[`${d.$prefixCls}-comboselect-radioable`]:!a,[`${d.$prefixCls}-comboselect-error`]:Se,[`${d.$prefixCls}-comboselect-clear`]:q,[`${d.$prefixCls}-comboselect-non-popup`]:x,[`${d.$prefixCls}-comboselect-overLine`]:K},`${d.$prefixCls}-comboselect-${pt}`),Dt=(e,s)=>{let r=[];if(e?.length&&(r=e.map(n=>{const i={};i[R]=n[D]||"",Me?i[g]=Me(n)||"":i[g]=n[Ae]||"";const c=ae.current?.find(p=>p[R]===i[R]);return c&&(c.disabled!==void 0&&(i.disabled=c.disabled),c.closable!==void 0&&(i.closable=c.closable)),i})),s?.length&&e){const n=s.filter(c=>e.findIndex(p=>p[D]===c)===-1),i=ae.current?.filter(c=>n?.includes(c[R]));i&&r.push(...i)}W(r);const l=Xt.DeepClone(e||[]);a?C?.(r,l):C?.(r[0],l[0])},Ue=e=>{const s=e.map(r=>r[R]);W(e),V(s),ae.current=e},zt=(e,s)=>{Fe(s.node)},Je=()=>{let e={};if(!x){const{width:s,minWidth:r,maxWidth:l}=Ge();e={width:s,minWidth:r,maxWidth:l}}return t.jsxRuntimeExports.jsx("div",{className:"comboselect-search",style:e,children:t.jsxRuntimeExports.jsx(ns.Search,{className:"comboselect-search-input",rightIconExist:!0,showBtn:!1,rightIcon:t.jsxRuntimeExports.jsx(Wt.Search,{}),btnType:"inside",value:B,onChange:Lt,placeholder:nt??w({id:"searchPlaceholder"}),onClickBtn:()=>{Q()},onEnter:()=>{Q()},onClear:()=>{Q("")}})})},Qe=()=>ve?t.jsxRuntimeExports.jsx("div",{className:"comboselect-actions",children:ve}):t.jsxRuntimeExports.jsxs("div",{className:"comboselect-actions",children:[t.jsxRuntimeExports.jsx(tt.Button,{onClick:e=>Be(e,!1),variant:"outlined",size:"small",children:w({id:"cancel"})}),t.jsxRuntimeExports.jsx(tt.Button,{variant:"outlined",onClick:e=>Be(e,!0),size:"small",children:w({id:"ok"})})]}),Xe=()=>m!=="tree"||!P?null:$e?t.jsxRuntimeExports.jsx("div",{className:"comboselect-fullPath",children:$e(P??{})}):t.jsxRuntimeExports.jsxs("div",{className:"comboselect-fullPath",children:[t.jsxRuntimeExports.jsx("span",{children:w({id:"fullPath"})}),P?.[Et]??""]}),Ft=e=>{e.stopPropagation(),He(),v(),L(!1),te?.(),C?.(a?[]:{})},Kt=e=>{e.stopPropagation(),L(!0),v()};o.useImperativeHandle(Ct,()=>({closePopup:()=>v()})),o.useEffect(()=>{!x&&Z&&(O.current=!0,ie(Z))},[Z]),o.useEffect(()=>{Ee&&Ue(S.toArray(Ee))},[]),o.useEffect(()=>{ee&&Ue(S.toArray(ee))},[ee]),o.useEffect(()=>{lt&&$t(!!u?.length)},[u]),o.useEffect(()=>{const e=r=>r&&r.ownerDocument||document,s=r=>{const l=e(N.current),n=r.target,i=!l.documentElement.contains(n)||U.current?.contains(n)||N.current?.contains(n)||!1;if(m==="table"){const c=`.${d.$prefixCls}-select-popover`,p=`.${d.$prefixCls}-table-show-colums-popover`,b=`.${d.$prefixCls}-filter-popover`;if(S.closest(n,`${c}, ${p}, ${b}`))return}O.current&&!i&&v()};if(f&&setTimeout(()=>{if(!U.current)return;const r=U.current.querySelector(".comboselect-search-input input");r&&r.focus()},200),!x&&f){const r=e(N.current);return r.addEventListener("mousedown",s),()=>{r.removeEventListener("mousedown",s)}}},[f]);const Ye=o.useMemo(()=>{if(!u?.length)return null;if(I)return I(a?u:u[0]);if(!a)return t.jsxRuntimeExports.jsx("span",{className:"comboselect-single-content",children:t.jsxRuntimeExports.jsx(be.default,{children:u[0]?.[g]})});if(!u.length)return;const e=l=>{if(ne)return ne(l);const{disabled:n,closable:i=!0}=l??{};let c=l[g];ce&&(c=ce(l));let p=!1;if(typeof A=="number"&&(typeof c=="string"||typeof c=="number")){const b=String(c);b.length>A&&(c=`${b.slice(0,A)}...`,p=!0)}return t.jsxRuntimeExports.jsxs("span",{className:F("comboselect-item",{"comboselect-item--disabled":n,"comboselect-item--unclosable":!i}),children:[p?t.jsxRuntimeExports.jsx(Qt.Tooltip,{title:t.jsxRuntimeExports.jsx("div",{onClick:b=>b.stopPropagation(),children:l[g]}),arrow:!1,placement:"bottomLeft",children:t.jsxRuntimeExports.jsx("span",{className:"comboselect-item-content",children:c})}):t.jsxRuntimeExports.jsx("span",{className:"comboselect-item-content",children:t.jsxRuntimeExports.jsx(be.default,{children:c})}),i===!0&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-item-remove",onClick:b=>We(b,l),onMouseDown:b=>b.stopPropagation(),children:t.jsxRuntimeExports.jsx(et.Close,{})})]})},s=()=>E!==null&&h.current.list.length>E?t.jsxRuntimeExports.jsx("div",{className:"comboselect-overflow-item",children:t.jsxRuntimeExports.jsx("span",{className:"comboselect-item",onClick:Kt,children:t.jsxRuntimeExports.jsxs("span",{className:"comboselect-item-content",children:["+",h.current.list.length-E]})})}):null,r=u.map((l,n)=>E!==null&&E<=n?null:t.jsxRuntimeExports.jsx("div",{className:"comboselect-overflow-item",children:e(l)},n));return t.jsxRuntimeExports.jsxs("div",{className:"comboselect-overflow-list",children:[r,s()]})},[u,C,a,E,A,g,ne,I,ce,K]),X=o.useMemo(()=>{let e=$||Ke.current;return _&&!se&&G.current!==void 0&&(e={...e,searchKey:G.current}),gt?.(e)||e},[$,T,y,f]),xe=o.useMemo(()=>{if(!x&&!f||m!=="table")return null;const e={url:Ce,ctx:ye,search:X,method:we},s=(r,l)=>{!a&&(v(),j.includes(r))||pe([r],[l])};return t.jsxRuntimeExports.jsx("div",{className:"comboselect-table",children:t.jsxRuntimeExports.jsx(Gt.default,{...e,...re,emptyProps:Pe,check:a,radio:!a,rowKey:D,setCheck:pe,setRadio:s,checkDefaultValue:j,radioDefaultValue:j[0],refresh:y??T,autoSize:!1,refreshInside:!1,checkCount:!1,paginationType:"simple"})})},[j,y,$,T,x,f,X,D,a]),fe=o.useMemo(()=>{if(!x&&!f||!["tree","list"].includes(m))return null;const e={url:Ce,ctx:ye,params:X,method:we},s=(n,i)=>{if(!i.checked){const p={};if(p[R]=i.node[D]||"",p[g]=i.node[Ae]||"",Ne?.(p)===!1)return}if(!a&&(v(),!wt&&j.includes(i.node?.key)))return;let c=i.checkedNodes;if(a||n?.length&&(c=[i.node]),a){const p=Yt.ArrayToObject("key",c);Array.from(H.current.keys()).forEach(z=>{n.includes(z)||H.current.delete(z)}),n.forEach(z=>{const he=String(z);p[he]&&H.current.set(he,p[he])}),c=Array.from(H.current.values())}pe(n,c)},r=n=>k?.titleRender?k.titleRender(n):qe?qe(n):n.title,l=F("comboselect-tree",{"comboselect-list":m==="list","comboselect-list-single":m==="list"&&!a});return t.jsxRuntimeExports.jsx("div",{className:l,children:t.jsxRuntimeExports.jsx(Ut.default,{blockNode:!0,...e,...k,wrapperStyle:{position:"static"},emptyProps:{size:"small",...Pe},replaceFields:_e,checkable:a,radioable:!a,showRadio:!1,selectable:m!=="list",loadedKeys:ue,checkedKeys:j,onCheck:s,onSelect:zt,titleRender:r,refresh:y??T,loadingNode:t.jsxRuntimeExports.jsxs("div",{className:"loading-node-content",children:[t.jsxRuntimeExports.jsx("div",{className:"loading-icon",children:t.jsxRuntimeExports.jsx(ls.LoadingF,{})}),w({id:"searching"})]})})})},[j,y,$,T,x,f,ue,m,X,a]),Y=o.useMemo(()=>t.jsxRuntimeExports.jsxs("div",{className:"comboselect-wrapper",ref:N,onClick:Pt,children:[t.jsxRuntimeExports.jsx("div",{className:F("comboselect-overflow",!a&&"comboselect-overflow-single"),children:Ye}),!x&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-arrow",children:t.jsxRuntimeExports.jsx(Ht.Down,{})}),q&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-clear",onClick:Ft,children:t.jsxRuntimeExports.jsx(Bt.CloseCircleF,{})}),!u?.length&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-placeholder",children:je??w({id:"pleaseSelect"})})]}),[u,Ye,a,q,x,je]),_t=()=>Te||ke?t.jsxRuntimeExports.jsx(rs.default,{label:Te,required:ke,...yt}):null,At=()=>t.jsxRuntimeExports.jsx("div",{ref:U,className:`comboselect-dropdown-wrapper ${_?"show-search":""} mode-${m}`,children:t.jsxRuntimeExports.jsxs("div",{style:Ge(),className:`${d.$prefixCls}-scrollbar-small dropdown-content`,children:[_&&Je(),m==="table"?xe:fe,f&&Xe(),ge&&Qe()]})}),Ze=()=>{const e=()=>u.map((s,r)=>{if(E!==null&&E>r)return null;let l=s[g];return Le&&(l=Le(s)),t.jsxRuntimeExports.jsxs("div",{className:"comboselect-more-item",children:[t.jsxRuntimeExports.jsx("span",{className:"comboselect-more-item-text",children:t.jsxRuntimeExports.jsx(be.default,{children:l})}),t.jsxRuntimeExports.jsx("span",{className:"comboselect-more-item-remove",onClick:n=>We(n,s),children:t.jsxRuntimeExports.jsx(et.Close,{})})]},r)});return t.jsxRuntimeExports.jsxs("div",{className:"comboselect-more-wrapper",children:[t.jsxRuntimeExports.jsx("span",{className:"comboselect-more-title",children:t.jsxRuntimeExports.jsx("span",{children:w({id:"more"})})}),t.jsxRuntimeExports.jsx("div",{className:"comboselect-more-content",children:e()})]})},It=o.useMemo(()=>t.jsxRuntimeExports.jsx(Jt.Dropdown,{overlay:At(),visible:f,placement:dt,trigger:["click"],overlayClassName:F(`${d.$prefixCls}-comboselect-dropdown`,mt),getPopupContainer:St,children:t.jsxRuntimeExports.jsx(st.Popover,{visible:M,destroyTooltipOnHide:!0,placement:"rightTop",content:Ze(),onVisibleChange:()=>L(!1),overlayClassName:`${d.$prefixCls}-comboselect-more-popover`,children:Y})}),[f,j,B,y,$,P,T,q,oe,Oe,De,M,ue,C,te,Y,u]),Vt=o.useMemo(()=>t.jsxRuntimeExports.jsxs(t.jsxRuntimeExports.Fragment,{children:[t.jsxRuntimeExports.jsx(st.Popover,{visible:M,destroyTooltipOnHide:!0,placement:"rightTop",content:Ze(),onVisibleChange:()=>L(!1),overlayClassName:`${d.$prefixCls}-comboselect-more-popover`,children:Y}),t.jsxRuntimeExports.jsxs("div",{className:"comboselect-non-popup-content",children:[_&&Je(),m==="table"?xe:fe,Xe(),ge&&Qe()]})]}),[j,B,y,$,P,q,oe,Oe,De,C,te,xe,fe,Y,M,u]);return t.jsxRuntimeExports.jsxs("div",{className:Ot(),style:it,ref:me,children:[_t(),x?Vt:It,x?null:t.jsxRuntimeExports.jsx(os.default,{error:Se,helperText:oe,hideErrorDom:vt})]})};exports.ComboSelect=rt;exports.default=rt;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');require('../Tree/style/index.css');const t=require("../_virtual/jsx-runtime.js"),o=require("react"),Ut=require("../node_modules/@para-ui/icons/Down/index.js"),Jt=require("../node_modules/@para-ui/icons/Search/index.js"),st=require("../node_modules/@para-ui/icons/Close/index.js"),Qt=require("../node_modules/@para-ui/icons/CloseCircleF/index.js"),Xt=require("../Table/index.js"),Yt=require("../Tree/Tree.js");;/* empty css                        */const rt=require("../Button/index.js"),Zt=require("../Dropdown/index.js"),ot=require("../Popover/index.js"),be=require("../AutoTips/index.js"),es=require("../Tooltip/index.js"),_=require("clsx"),S=require("./utils.js"),ts=require("@snack-kit/lib"),ss=require("../Utils/snack-kit-shims.js"),rs=require("../GlobalContext/index.js"),os=require("../Hooks/useGlobalProps.js"),ns=require("../GlobalContext/useFormatMessage.js"),ls=require("./lang/index.js"),cs=require("../Label/index.js"),is=require("../HelperText/index.js"),d=require("../GlobalContext/constant.js"),as=require("../Search/index.js"),us=require("../node_modules/@para-ui/icons/LoadingF/index.js");;/* empty css            */const nt=lt=>{const{mode:m="table",placeholder:je,searchPlaceholder:ct,maxCount:Re,overLine:z=!1,disabled:ve=!1,allowClear:it=!1,className:at,style:ut,maxHeight:dt,height:mt,placement:pt="bottomLeft",popoverClassName:ft,size:xt="large",popoverActions:ge=null,showPopoverActions:Ce=!1,defaultOpen:Z=!1,defaultValue:Ee,replaceFields:ht={key:"key",title:"title",children:"children"},outputFields:bt={outputKey:"key",outputTitle:"label"},value:ee,onClear:te,onCancel:jt,onOk:Rt,onClose:vt,onChange:E,onSearch:se,refresh:y,TableProps:re,TreeProps:k,checkable:a=!0,url:ye,ctx:we,params:N,method:Se="Get",showSearch:F=!1,realTimeSearch:gt=!1,error:Ne=!1,hideErrorDom:Ct,helperText:oe,paramsCallback:Et,fullPathKey:yt,fullPathRender:$e,disablePopup:f=!1,tagRender:ne,onTagRemove:Te,action:wt,label:ke="",labelTooltip:St,required:Pe=!1,emptyProps:qe,toggleSelectedOnSingle:Nt=!1,optionRender:Me,getOptionLabel:Le,dropdownMatchSelectWidth:le=!0,getPopupContainer:$t,maxTagTextLength:A,renderInputContent:V,renderTagLabel:ce,renderMoreTagLabel:Oe}=os.default(lt,"ComboSelect"),{language:De,locale:Ke}=o.useContext(rs.default),$=o.useRef(null),_e=o.useRef(!1);o.useEffect(()=>{process.env.NODE_ENV!=="production"&&Re!==void 0&&!_e.current&&(_e.current=!0,console.warn("[ComboSelect] maxCount 已在 v5.x 标记为 @deprecated 且自当前版本起 runtime 完全不生效(原代码 dead field)。请从 props 中移除 maxCount;tag 显示数量由 overLine 控制是否换行。v6.0 将移除该字段。"))},[Re]);const[x,ie]=o.useState(!1),[j,I]=o.useState([]),H=o.useRef(new Map),[u,W]=o.useState([]),[B,ze]=o.useState(""),G=o.useRef(void 0),[P,Fe]=o.useState(null),[q,Tt]=o.useState(!1),[T,kt]=o.useState(0),[M,L]=o.useState(!1),ae=o.useRef([]),O=o.useRef(!1),U=o.useRef(null),Ae=o.useRef({}),Ve=S.getReplaceField(m,ht,re,k),{key:Pt,title:qt}=Ve,D=Pt||"",Ie=qt||"",{outputKey:R="key",outputTitle:g="label"}=bt||{},w=ns.default("ComboSelect",ls.default),He=o.useRef(S.isRemoteLoad(m,m==="table"?re:k)),[ue,Mt]=o.useState(),h=o.useRef({list:[]}),[C,de]=o.useState(null),me=o.useRef(null);h.current.openMore=M,h.current.list=[...u];const Lt=()=>{h.current.openMore&&L(!1)},We=e=>{if(e===null||e===0||(e===void 0&&(e=h.current.list.length),!me.current))return;const s=me.current.querySelector(".comboselect-overflow-list");if(s)if(s.scrollHeight>s.clientHeight){const r=Number(e)-1;de(r),We(r)}else h.current.list.length<=e&&Lt()},J=()=>{if(h.current.list.length===0)return de(null);clearTimeout(h.current.resizeTimer),h.current.resizeTimer=setTimeout(()=>{de(h.current.list.length),We()},50)};o.useEffect(()=>(J(),()=>{clearTimeout(h.current.resizeTimer)}),[u]),o.useEffect(()=>(!z&&a?window.addEventListener("resize",J):window.removeEventListener("resize",J),()=>{window.removeEventListener("resize",J)}),[z,a]);const Ot=e=>{if(!f&&!ve){if(O.current){v();return}O.current=!0,ie(!0)}},v=(e,s)=>{O.current=!1,G.current=void 0,Ae.current={},ie(!1),Fe(null),ze(""),vt?.(),s==="cancel"&&Be()},Be=()=>{I([]),W([])},pe=(e,s)=>{I(e),Ft(s,e)},Dt=e=>{I(s=>{const r=s.findIndex(l=>l===e[R]);return r>-1&&s.splice(r,1),[...s]})},Ge=(e,s)=>{if(e.stopPropagation(),s.closable===!1||Te?.(s)===!1)return;const r=[...u],l=r.findIndex(n=>n[R]===s[R]);l>-1&&r.splice(l,1),W(r),Dt(s),E?.(r)},Kt=o.useMemo(()=>S.debounce(async e=>{Q(e)},400),[]),_t=e=>{ze(e),gt&&Kt(e)},Q=e=>{const s=e??B;se?se(s):(G.current=s?.trim(),kt(Math.random())),He.current&&Mt([])},Ue=(e,s)=>{s?(Rt?.(u),v(null,"ok")):(jt?.(),v(null,"cancel"))},Je=()=>{let e="auto";$.current&&(e=`${$.current.offsetWidth}px`);const s=S.getOverlaySize(m,He.current,dt,mt),r={minWidth:e,maxWidth:960};return typeof le=="number"?r.width=le:le&&(r.width=e),{overflow:"auto",...r,...s}},zt=()=>_(`${d.$prefixCls}-comboselect`,at,{[`${d.$prefixCls}-comboselect-focused`]:x&&!f,[`${d.$prefixCls}-comboselect-disabled`]:ve,[`${d.$prefixCls}-comboselect-radioable`]:!a,[`${d.$prefixCls}-comboselect-error`]:Ne,[`${d.$prefixCls}-comboselect-clear`]:q,[`${d.$prefixCls}-comboselect-non-popup`]:f,[`${d.$prefixCls}-comboselect-overLine`]:z},`${d.$prefixCls}-comboselect-${xt}`),Ft=(e,s)=>{let r=[];if(e?.length&&(r=e.map(n=>{const i={};i[R]=n[D]||"",Le?i[g]=Le(n)||"":i[g]=n[Ie]||"";const c=ae.current?.find(p=>p[R]===i[R]);return c&&(c.disabled!==void 0&&(i.disabled=c.disabled),c.closable!==void 0&&(i.closable=c.closable)),i})),s?.length&&e){const n=s.filter(c=>e.findIndex(p=>p[D]===c)===-1),i=ae.current?.filter(c=>n?.includes(c[R]));i&&r.push(...i)}W(r);const l=ts.DeepClone(e||[]);a?E?.(r,l):E?.(r[0],l[0])},Qe=e=>{const s=e.map(r=>r[R]);W(e),I(s),ae.current=e},At=(e,s)=>{Fe(s.node)},Xe=()=>{let e={};if(!f){const{width:s,minWidth:r,maxWidth:l}=Je();e={width:s,minWidth:r,maxWidth:l}}return t.jsxRuntimeExports.jsx("div",{className:"comboselect-search",style:e,children:t.jsxRuntimeExports.jsx(as.Search,{className:"comboselect-search-input",rightIconExist:!0,showBtn:!1,rightIcon:t.jsxRuntimeExports.jsx(Jt.Search,{}),btnType:"inside",value:B,onChange:_t,placeholder:ct??w({id:"searchPlaceholder"}),onClickBtn:()=>{Q()},onEnter:()=>{Q()},onClear:()=>{Q("")}})})},Ye=()=>ge?t.jsxRuntimeExports.jsx("div",{className:"comboselect-actions",children:ge}):t.jsxRuntimeExports.jsxs("div",{className:"comboselect-actions",children:[t.jsxRuntimeExports.jsx(rt.Button,{onClick:e=>Ue(e,!1),variant:"outlined",size:"small",children:w({id:"cancel"})}),t.jsxRuntimeExports.jsx(rt.Button,{variant:"outlined",onClick:e=>Ue(e,!0),size:"small",children:w({id:"ok"})})]}),Ze=()=>m!=="tree"||!P?null:$e?t.jsxRuntimeExports.jsx("div",{className:"comboselect-fullPath",children:$e(P??{})}):t.jsxRuntimeExports.jsxs("div",{className:"comboselect-fullPath",children:[t.jsxRuntimeExports.jsx("span",{children:w({id:"fullPath"})}),P?.[yt]??""]}),Vt=e=>{e.stopPropagation(),Be(),v(),L(!1),te?.(),E?.(a?[]:{})},It=e=>{e.stopPropagation(),L(!0),v()};o.useImperativeHandle(wt,()=>({closePopup:()=>v()})),o.useEffect(()=>{!f&&Z&&(O.current=!0,ie(Z))},[Z]),o.useEffect(()=>{Ee&&Qe(S.toArray(Ee))},[]),o.useEffect(()=>{ee&&Qe(S.toArray(ee))},[ee]),o.useEffect(()=>{it&&Tt(!!u?.length)},[u]),o.useEffect(()=>{const e=r=>r&&r.ownerDocument||document,s=r=>{const l=e($.current),n=r.target,i=!l.documentElement.contains(n)||U.current?.contains(n)||$.current?.contains(n)||!1;if(m==="table"){const c=`.${d.$prefixCls}-select-popover`,p=`.${d.$prefixCls}-table-show-colums-popover`,b=`.${d.$prefixCls}-filter-popover`;if(S.closest(n,`${c}, ${p}, ${b}`))return}O.current&&!i&&v()};if(x&&setTimeout(()=>{if(!U.current)return;const r=U.current.querySelector(".comboselect-search-input input");r&&r.focus()},200),!f&&x){const r=e($.current);return r.addEventListener("mousedown",s),()=>{r.removeEventListener("mousedown",s)}}},[x]);const et=o.useMemo(()=>{if(!u?.length)return null;if(V)return V(a?u:u[0]);if(!a)return t.jsxRuntimeExports.jsx("span",{className:"comboselect-single-content",children:t.jsxRuntimeExports.jsx(be.default,{children:u[0]?.[g]})});if(!u.length)return;const e=l=>{if(ne)return ne(l);const{disabled:n,closable:i=!0}=l??{};let c=l[g];ce&&(c=ce(l));let p=!1;if(typeof A=="number"&&(typeof c=="string"||typeof c=="number")){const b=String(c);b.length>A&&(c=`${b.slice(0,A)}...`,p=!0)}return t.jsxRuntimeExports.jsxs("span",{className:_("comboselect-item",{"comboselect-item--disabled":n,"comboselect-item--unclosable":!i}),children:[p?t.jsxRuntimeExports.jsx(es.Tooltip,{title:t.jsxRuntimeExports.jsx("div",{onClick:b=>b.stopPropagation(),children:l[g]}),arrow:!1,placement:"bottomLeft",children:t.jsxRuntimeExports.jsx("span",{className:"comboselect-item-content",children:c})}):t.jsxRuntimeExports.jsx("span",{className:"comboselect-item-content",children:t.jsxRuntimeExports.jsx(be.default,{children:c})}),i===!0&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-item-remove",onClick:b=>Ge(b,l),onMouseDown:b=>b.stopPropagation(),children:t.jsxRuntimeExports.jsx(st.Close,{})})]})},s=()=>C!==null&&h.current.list.length>C?t.jsxRuntimeExports.jsx("div",{className:"comboselect-overflow-item",children:t.jsxRuntimeExports.jsx("span",{className:"comboselect-item",onClick:It,children:t.jsxRuntimeExports.jsxs("span",{className:"comboselect-item-content",children:["+",h.current.list.length-C]})})}):null,r=u.map((l,n)=>C!==null&&C<=n?null:t.jsxRuntimeExports.jsx("div",{className:"comboselect-overflow-item",children:e(l)},n));return t.jsxRuntimeExports.jsxs("div",{className:"comboselect-overflow-list",children:[r,s()]})},[u,E,a,C,A,g,ne,V,ce,z]),X=o.useMemo(()=>{let e=N||Ae.current;return F&&!se&&G.current!==void 0&&(e={...e,searchKey:G.current}),Et?.(e)||e},[N,T,y,x]),fe=o.useMemo(()=>{if(!f&&!x||m!=="table")return null;const e={url:ye,ctx:we,search:X,method:Se},s=(r,l)=>{!a&&(v(),j.includes(r))||pe([r],[l])};return t.jsxRuntimeExports.jsx("div",{className:"comboselect-table",children:t.jsxRuntimeExports.jsx(Xt.default,{...e,...re,emptyProps:qe,check:a,radio:!a,rowKey:D,setCheck:pe,setRadio:s,checkDefaultValue:j,radioDefaultValue:j[0],refresh:y??T,autoSize:!1,refreshInside:!1,checkCount:!1,paginationType:"simple"})})},[j,y,N,T,f,x,X,D,a]),xe=o.useMemo(()=>{if(!f&&!x||!["tree","list"].includes(m))return null;const e={url:ye,ctx:we,params:X,method:Se},s=(n,i)=>{if(!i.checked){const p={};if(p[R]=i.node[D]||"",p[g]=i.node[Ie]||"",Te?.(p)===!1)return}if(!a&&(v(),!Nt&&j.includes(i.node?.key)))return;let c=i.checkedNodes;if(a||n?.length&&(c=[i.node]),a){const p=ss.ArrayToObject("key",c);Array.from(H.current.keys()).forEach(K=>{n.includes(K)||H.current.delete(K)}),n.forEach(K=>{const he=String(K);p[he]&&H.current.set(he,p[he])}),c=Array.from(H.current.values())}pe(n,c)},r=n=>k?.titleRender?k.titleRender(n):Me?Me(n):n.title,l=_("comboselect-tree",{"comboselect-list":m==="list","comboselect-list-single":m==="list"&&!a});return t.jsxRuntimeExports.jsx("div",{className:l,children:t.jsxRuntimeExports.jsx(Yt.default,{blockNode:!0,...e,...k,wrapperStyle:{position:"static"},emptyProps:{size:"small",...qe},replaceFields:Ve,checkable:a,radioable:!a,showRadio:!1,selectable:m!=="list",loadedKeys:ue,checkedKeys:j,onCheck:s,onSelect:At,titleRender:r,refresh:y??T,loadingNode:t.jsxRuntimeExports.jsxs("div",{className:"loading-node-content",children:[t.jsxRuntimeExports.jsx("div",{className:"loading-icon",children:t.jsxRuntimeExports.jsx(us.LoadingF,{})}),w({id:"searching"})]})})})},[j,y,N,T,f,x,ue,m,X,a]),Y=o.useMemo(()=>t.jsxRuntimeExports.jsxs("div",{className:"comboselect-wrapper",ref:$,onClick:Ot,children:[t.jsxRuntimeExports.jsx("div",{className:_("comboselect-overflow",!a&&"comboselect-overflow-single"),children:et}),!f&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-arrow",children:t.jsxRuntimeExports.jsx(Ut.Down,{})}),q&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-clear",onClick:Vt,children:t.jsxRuntimeExports.jsx(Qt.CloseCircleF,{})}),!u?.length&&t.jsxRuntimeExports.jsx("span",{className:"comboselect-placeholder",children:je??w({id:"pleaseSelect"})})]}),[u,et,a,q,f,je]),Ht=()=>ke||Pe?t.jsxRuntimeExports.jsx(cs.default,{label:ke,required:Pe,...St}):null,Wt=()=>t.jsxRuntimeExports.jsx("div",{ref:U,className:`comboselect-dropdown-wrapper ${F?"show-search":""} mode-${m}`,children:t.jsxRuntimeExports.jsxs("div",{style:Je(),className:`${d.$prefixCls}-scrollbar-small dropdown-content`,children:[F&&Xe(),m==="table"?fe:xe,x&&Ze(),Ce&&Ye()]})}),tt=()=>{const e=()=>u.map((s,r)=>{if(C!==null&&C>r)return null;let l=s[g];return Oe&&(l=Oe(s)),t.jsxRuntimeExports.jsxs("div",{className:"comboselect-more-item",children:[t.jsxRuntimeExports.jsx("span",{className:"comboselect-more-item-text",children:t.jsxRuntimeExports.jsx(be.default,{children:l})}),t.jsxRuntimeExports.jsx("span",{className:"comboselect-more-item-remove",onClick:n=>Ge(n,s),children:t.jsxRuntimeExports.jsx(st.Close,{})})]},r)});return t.jsxRuntimeExports.jsxs("div",{className:"comboselect-more-wrapper",children:[t.jsxRuntimeExports.jsx("span",{className:"comboselect-more-title",children:t.jsxRuntimeExports.jsx("span",{children:w({id:"more"})})}),t.jsxRuntimeExports.jsx("div",{className:"comboselect-more-content",children:e()})]})},Bt=o.useMemo(()=>t.jsxRuntimeExports.jsx(Zt.Dropdown,{overlay:Wt(),visible:x,placement:pt,trigger:["click"],overlayClassName:_(`${d.$prefixCls}-comboselect-dropdown`,ft),getPopupContainer:$t,children:t.jsxRuntimeExports.jsx(ot.Popover,{visible:M,destroyTooltipOnHide:!0,placement:"rightTop",content:tt(),onVisibleChange:()=>L(!1),overlayClassName:`${d.$prefixCls}-comboselect-more-popover`,children:Y})}),[x,j,B,y,N,P,T,q,oe,De,Ke,M,ue,E,te,Y,u]),Gt=o.useMemo(()=>t.jsxRuntimeExports.jsxs(t.jsxRuntimeExports.Fragment,{children:[t.jsxRuntimeExports.jsx(ot.Popover,{visible:M,destroyTooltipOnHide:!0,placement:"rightTop",content:tt(),onVisibleChange:()=>L(!1),overlayClassName:`${d.$prefixCls}-comboselect-more-popover`,children:Y}),t.jsxRuntimeExports.jsxs("div",{className:"comboselect-non-popup-content",children:[F&&Xe(),m==="table"?fe:xe,Ze(),Ce&&Ye()]})]}),[j,B,y,N,P,q,oe,De,Ke,E,te,fe,xe,Y,M,u]);return t.jsxRuntimeExports.jsxs("div",{className:zt(),style:ut,ref:me,children:[Ht(),f?Gt:Bt,f?null:t.jsxRuntimeExports.jsx(is.default,{error:Ne,helperText:oe,hideErrorDom:Ct})]})};exports.ComboSelect=nt;exports.default=nt;
 //# sourceMappingURL=index.js.map

package/lib/ComboSelect/interface.d.ts

@@ -18,7 +18,7 @@ export type { TableProps, TreeProps };
 export type SelectOpt = {
     disabled?: boolean;
     closable?: boolean;
-    [key: string]: any;
+    [key: string]: unknown;
 };
 export type SelectedOptions = Array<SelectOpt>;
 export type { TreeNodeProps };
@@ -30,7 +30,10 @@ export interface ComboSelectProps extends HelperTextDetailProps {
     /**search 占位符*/
     searchPlaceholder?: string;
     /**最大显示数*/
-    /** @deprecated This attribute has been deprecated */
+    /**
+     * @deprecated v5.x dead field — 该字段历史遗留,代码内仅解构未引用,runtime 完全不生效。v5.0.0-beta.14 起 dev 模式抛 warn,v6.0 移除字段。
+     *   迁移:从 props 中移除 maxCount;tag 换行行为请用 `overLine` 控制。
+     */
     maxCount?: number;
     /** 超出换行 */
     overLine?: boolean;
@@ -107,7 +110,7 @@ export interface ComboSelectProps extends HelperTextDetailProps {
     realTimeSearch?: boolean;
     /**参数处理回调*/
     paramsCallback?: (params: {
-        [name: string]: any;
+        [name: string]: unknown;
     }) => any;
     /**路径字段*/
     fullPathKey?: string;

package/lib/ComboSelect/utils.d.ts

@@ -1,8 +1,8 @@
-export declare const getReplaceField: (mode: string, repl: Record<string, unknown>, tableP?: Record<string, any>, treeP?: Record<string, any>) => any;
+export declare const getReplaceField: (mode: string, repl: Record<string, unknown>, tableP?: Record<string, unknown>, treeP?: Record<string, unknown>) => Record<string, unknown>;
 export declare const toArray: (list: unknown) => unknown[];
 export declare const isRemoteLoad: (mode: string, props?: {
-    data?: any;
-    treeData?: any;
+    data?: unknown;
+    treeData?: unknown;
 }) => boolean;
 export declare const getOverlaySize: (mode: string, isRemoteLoad?: boolean, maxHeight?: number, height?: number) => {
     height: string;

package/lib/ComboSelect/utils.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=(t,r,e,n)=>{let l={};return t==="tree"?l=n?.replaceFields:l=e?.replaceFields,{...r,...l}},f=t=>t?Array.isArray(t)?t:JSON.stringify(t)==="{}"?[]:[t]:[],h=(t,r)=>t==="table"?!(r&&Array.isArray(r.data)):!(r&&Array.isArray(r.treeData)),g=(t,r=!1,e,n)=>{const i=`${e||254}px`,s=`${e||232}px`,a=`${e||338}px`,o=`${e||304}px`,u=document.documentElement.clientHeight,c=n!==void 0?"height":"maxHeight";return t==="tree"?u<=720?r?{height:i}:{[c]:i}:r?{height:a}:{[c]:a}:t==="list"?u<=720?r?{[c]:s}:{[c]:s}:r?{[c]:o}:{[c]:o}:{height:`${e??n??380}px`}};function d(t,r){let e;return function(...n){e&&clearTimeout(e),e=setTimeout(()=>{t.apply(this,n)},r)}}const S=(t,r)=>{let e=t;const n=e.matches||e.webkitMatchesSelector||e.mozMatchesSelector||e.msMatchesSelector;for(;e&&!n.call(e,r);)e=e.parentElement;return e};exports.closest=S;exports.debounce=d;exports.getOverlaySize=g;exports.getReplaceField=y;exports.isRemoteLoad=h;exports.toArray=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=(t,r,e,n)=>{let l={};return t==="tree"?l=n?.replaceFields??{}:l=e?.replaceFields??{},{...r,...l}},f=t=>t?Array.isArray(t)?t:JSON.stringify(t)==="{}"?[]:[t]:[],h=(t,r)=>t==="table"?!(r&&Array.isArray(r.data)):!(r&&Array.isArray(r.treeData)),g=(t,r=!1,e,n)=>{const i=`${e||254}px`,s=`${e||232}px`,a=`${e||338}px`,o=`${e||304}px`,u=document.documentElement.clientHeight,c=n!==void 0?"height":"maxHeight";return t==="tree"?u<=720?r?{height:i}:{[c]:i}:r?{height:a}:{[c]:a}:t==="list"?u<=720?r?{[c]:s}:{[c]:s}:r?{[c]:o}:{[c]:o}:{height:`${e??n??380}px`}};function d(t,r){let e;return function(...n){e&&clearTimeout(e),e=setTimeout(()=>{t.apply(this,n)},r)}}const S=(t,r)=>{let e=t;const n=e.matches||e.webkitMatchesSelector||e.mozMatchesSelector||e.msMatchesSelector;for(;e&&!n.call(e,r);)e=e.parentElement;return e};exports.closest=S;exports.debounce=d;exports.getOverlaySize=g;exports.getReplaceField=y;exports.isRemoteLoad=h;exports.toArray=f;
 //# sourceMappingURL=utils.js.map

package/lib/Container/component.json

@@ -0,0 +1,111 @@
+{
+    "name": "Container",
+    "category": "Layout",
+    "description": "容器布局，支持上下左右四区域布局",
+    "semantic": {
+        "intent": [
+            "页面布局",
+            "分区容器"
+        ],
+        "useCases": [
+            "经典布局",
+            "管理后台",
+            "工作台"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "tlr": {
+            "meaning": "上左右布局"
+        },
+        "tlrb": {
+            "meaning": "上左右下布局"
+        },
+        "ltrb": {
+            "meaning": "左上右下布局"
+        },
+        "trb": {
+            "meaning": "上右下布局"
+        }
+    },
+    "states": [
+        "default"
+    ],
+    "idealProps": {
+        "type": {
+            "type": "enum",
+            "values": [
+                "tlrb",
+                "ltrb",
+                "trb",
+                "tlr"
+            ],
+            "default": "tlr",
+            "description": "布局类型;tlr=上左右、tlrb=上左右下、ltrb=左+上右下(左侧贯通顶部到底部)、trb=上右下(无左侧)"
+        },
+        "top": {
+            "type": "JSX.Element",
+            "description": "顶部容器内容;不传则顶部区域高度自动收缩为 0(src/Container/index.tsx:100 `height: top ? '50px' : '0'`)。注:类型是 JSX.Element 而非 ReactNode,传 string / null / number 会被 TS2322 阻断,需用 <div>{node}</div> 包裹"
+        },
+        "topStyle": {
+            "type": "React.CSSProperties",
+            "description": "顶部容器样式(背景色/高度等)"
+        },
+        "left": {
+            "type": "JSX.Element",
+            "description": "左侧容器内容;不传则左侧区域宽度自动收缩为 0。类型同 top"
+        },
+        "leftStyle": {
+            "type": "React.CSSProperties",
+            "description": "左侧容器样式(背景色/宽度等)"
+        },
+        "right": {
+            "type": "JSX.Element",
+            "description": "右侧/主体容器内容(在所有 type 下都是主显示区);类型同 top"
+        },
+        "rightStyle": {
+            "type": "React.CSSProperties",
+            "description": "右侧/主体容器样式"
+        },
+        "bottom": {
+            "type": "JSX.Element",
+            "description": "底部容器内容;不传则底部区域高度自动收缩为 0。类型同 top"
+        },
+        "bottomStyle": {
+            "type": "React.CSSProperties",
+            "description": "底部容器样式(背景色/高度等)"
+        }
+    },
+    "do": [
+        "用于快速搭建经典管理后台布局（tlr=顶部导航+左侧菜单+主区域，tlrb=四区域，trb=无侧边栏）",
+        "配合 CollapseLayout 实现可折叠侧边栏：leftStyle={{ width: 200 }} + 内嵌 CollapseLayout",
+        "顶部/左侧/底部区域的高宽默认值（如 top 默认 50px）可通过 topStyle/leftStyle 等覆盖"
+    ],
+    "dont": [
+        "嵌套过深的 Container（布局嵌套超过 2 层时改用 Flex/Grid 自实现，Container 本身不支持响应式断点）",
+        "复杂自适应布局硬用 Container——Container 是固定区域布局，响应式场景改用 Grid/Flex",
+        "把 string / null / number 直接传给 top/left/right/bottom——类型是 JSX.Element，需 <div> 包裹"
+    ],
+    "events": {},
+    "typescriptPitfalls": [
+        {
+            "issue": "top/left/right/bottom 的类型是 JSX.Element，不接受 string 或 ReactNode",
+            "wrong": "top={'首页标题'}  // TS 报错：string 不是 JSX.Element",
+            "right": "top={<div>首页标题</div>}  // 必须是 JSX 元素"
+        },
+        {
+            "issue": "type='trb' 时没有 left 区域，传 left/leftStyle 无效",
+            "wrong": "<Container type='trb' left={<Sidebar />} />  // trb 布局无 left 区域，Sidebar 不渲染",
+            "right": "<Container type='tlr' left={<Sidebar />} right={<Main />} />  // 需要侧边栏用 tlr/tlrb/ltrb"
+        },
+        {
+            "issue": "topStyle/leftStyle 等 Style prop 覆盖默认尺寸，需显式传 width/height",
+            "wrong": "leftStyle={{ background: '#f0f0f0' }}  // 背景色覆盖但宽度未设置，左侧宽度可能不符合预期",
+            "right": "leftStyle={{ background: '#f0f0f0', width: 200 }}  // 显式指定宽度"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Container",
+        "adapter": null
+    }
+}

package/lib/ContentBox/component.json

@@ -0,0 +1,81 @@
+{
+    "name": "ContentBox",
+    "category": "Layout",
+    "description": "内容容器，支持 Loading 和 Empty 状态",
+    "semantic": {
+        "intent": [
+            "状态容器",
+            "内容包装"
+        ],
+        "useCases": [
+            "数据列表",
+            "详情页",
+            "异步内容"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "default": {
+            "meaning": "默认样式"
+        }
+    },
+    "states": [
+        "loading",
+        "empty",
+        "default"
+    ],
+    "idealProps": {
+        "loading": {
+            "type": "boolean",
+            "description": "是否正在加载"
+        },
+        "empty": {
+            "type": "boolean",
+            "description": "是否为空"
+        },
+        "scroll": {
+            "type": "boolean",
+            "description": "是否支持滚动"
+        },
+        "loadingOverlay": {
+            "type": "boolean",
+            "description": "loading 是否覆盖内容"
+        },
+        "children": {
+            "type": "ReactNode",
+            "description": "子组件"
+        }
+    },
+    "do": [
+        "统一处理异步数据的三种状态（loading/empty/正常内容）——避免在每个页面重复写 if-else 状态判断",
+        "loadingOverlay=true（默认）时 loading 覆盖在内容之上；loadingOverlay=false 时隐藏内容只显示 Loading——根据业务场景选择",
+        "需要自定义 Loading/Empty 样式：传 loadingComponent 或 emptyComponent 覆盖默认组件"
+    ],
+    "dont": [
+        "在简单静态内容中使用 ContentBox——无异步状态的场景无需 ContentBox，直接渲染内容性能更好",
+        "empty=true 时仍期望 children 渲染——empty 状态下 children 被 Empty 组件替换（src/ContentBox/index.tsx:78-86 实证）",
+        "loading 和 empty 同时为 true——src 优先处理 loading，empty 判断有 !loading 前置条件，两者同时为 true 时只显示 Loading"
+    ],
+    "events": {},
+    "typescriptPitfalls": [
+        {
+            "issue": "emptyProps 只对默认 Empty 组件生效，传了 emptyComponent 后 emptyProps 被忽略",
+            "wrong": "// emptyComponent 和 emptyProps 同时传，期望 emptyProps 能影响自定义 emptyComponent\n<ContentBox empty emptyComponent={<MyEmpty />} emptyProps={{ description: '暂无数据' }} />",
+            "right": "// 自定义组件时 emptyProps 无效，直接在 emptyComponent 内传 props\n<ContentBox empty emptyComponent={<MyEmpty description='暂无数据' />} />"
+        },
+        {
+            "issue": "loadingComponent 不接受 null/undefined，传 null 时 tsc 报类型错误",
+            "wrong": "loadingComponent={null}  // ReactNode 可以是 null，但 ContentBox 内部 if(loadingComponent) 判断",
+            "right": "// 不传 loadingComponent 或传自定义 JSX 元素（不传时使用默认 Loading 组件）"
+        },
+        {
+            "issue": "ContentBox 使用 forwardRef，ref 类型是 HTMLDivElement",
+            "wrong": "const ref = useRef<HTMLElement>(null); <ContentBox ref={ref} />  // 类型不匹配",
+            "right": "const ref = useRef<HTMLDivElement>(null); <ContentBox ref={ref} />"
+        }
+    ],
+    "mapping": {
+        "realComponent": "ContentBox",
+        "adapter": null
+    }
+}

package/lib/CopyText/component.json

@@ -0,0 +1,118 @@
+{
+    "name": "CopyText",
+    "category": "Data Display",
+    "description": "复制文本，点击图标复制内容",
+    "semantic": {
+        "intent": [
+            "一键复制",
+            "信息展示"
+        ],
+        "useCases": [
+            "密钥展示",
+            "链接分享",
+            "代码片段"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "input": {
+            "meaning": "输入框模式"
+        },
+        "text": {
+            "meaning": "纯文本模式"
+        }
+    },
+    "states": [
+        "default",
+        "copied"
+    ],
+    "idealProps": {
+        "type": {
+            "type": "enum",
+            "values": [
+                "input",
+                "text"
+            ],
+            "default": "text",
+            "description": "类型('text' 纯文本展示 + 复制图标 / 'input' 输入框模式 + 复制图标 — 配合 textFieldProps 透传 TextField 配置)"
+        },
+        "value": {
+            "type": "ReactNode",
+            "description": "显示值;text 模式既是显示内容又是复制源(.toString() 兜底);input 模式必须 string(api.ts 类型 ReactNode 但 src:57 .toString() 兜底);**复制源优先级**:copyValue > valueCom(input 模式用户键入值) > value?.toString()"
+        },
+        "copyValue": {
+            "type": "string",
+            "description": "**显式指定写入剪贴板的内容,优先级最高**;适合'显示 ABC 但复制 ABC-with-prefix'或'显示掩码但复制真值'场景;不传则用 value/valueCom 兜底"
+        },
+        "textFieldProps": {
+            "type": "Omit<TextFieldProps, 'label'>",
+            "description": "**仅 type='input' 模式生效**;透传给内部 TextField — 可设 placeholder / readOnly / 自定义 onChange 等;text 模式下此 prop 被忽略"
+        },
+        "label": {
+            "type": "ReactNode",
+            "description": "组件标题(显示在 value 前)"
+        },
+        "copyIcon": {
+            "type": "ReactNode",
+            "description": "复制图标(默认 @para-ui/icons/Copy);复制成功后短暂切换为 CheckS,timeout 后切回"
+        },
+        "timeout": {
+            "type": "number",
+            "default": "800",
+            "description": "复制成功后图标切回原图的延时(ms);**仅控制状态指示视觉,不影响实际复制行为**(execCommand 已同步完成)"
+        },
+        "onCopy": {
+            "type": "function",
+            "description": "**复制前 hook**(点击时立即触发,await 后再 execCommand — src/CopyText/index.tsx:64-72);**不是复制成功回调**;**返回值语义**:返回 string 覆盖默认复制值,返回 undefined/void 用默认值;**组件已自动写剪贴板,不要在此调 navigator.clipboard.writeText**(会重复)"
+        }
+    },
+    "do": [
+        "在需要用户复制内容的场景使用——密钥/Token 展示、链接分享、代码片段等",
+        "提供复制成功反馈（copyIcon 切换为 CheckS，timeout 毫秒后切回）",
+        "显示内容与复制内容不同时（如掩码显示、真值复制）：传 copyValue 指定真实复制内容",
+        "input 模式下用户可编辑内容并复制：type='input' + textFieldProps 配置输入框属性"
+    ],
+    "dont": [
+        "复制敏感信息（密码/私钥）时不做视觉遮罩——显示 value 但复制内容不同时用 copyValue 隔离",
+        "在 onCopy 内调 navigator.clipboard.writeText——组件已自动 execCommand 写剪贴板，会重复写入",
+        "把 onCopy 当作复制成功后的回调——onCopy 是复制前 hook（在 execCommand 前 await），若需成功后 toast 在 onCopy 返回前自行触发",
+        "text 模式下传 textFieldProps 期待 placeholder 生效——textFieldProps 仅 type='input' 模式有效"
+    ],
+    "events": {
+        "onCopy": {
+            "signature": "() => Promise<string | void> | string | void",
+            "asyncSupported": true,
+            "examples": [
+                "动态获取复制值：onCopy={async () => { const token = await fetchToken(); return token; }}（返回 string 覆盖默认复制值）",
+                "仅做副作用（不改变复制值）：onCopy={() => { analytics.track('copy'); }}（返回 void 时用默认 value）",
+                "显示成功 toast：onCopy={async () => { const val = await getVal(); message.success('已复制'); return val; }}"
+            ],
+            "commonMistakes": [
+                "把 onCopy 当复制成功回调——onCopy 在 execCommand 之前触发（复制前 hook），不是复制成功后",
+                "在 onCopy 内调 navigator.clipboard.writeText——组件已自动写剪贴板（execCommand），调用后会重复写入",
+                "onCopy 返回 undefined 以为会阻止复制——返回 undefined 时组件用默认 value 复制，无法阻止复制行为"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "type='input' 时 value 必须是 string 类型（src 内部 .toString() 兜底但 TS 类型声明为 ReactNode）",
+            "wrong": "type='input' value={<span>复杂内容</span>}  // input 模式内部 setValueCom(value?.toString()) 导致 [object Object]",
+            "right": "type='input' value='plain string'  // input 模式只传 string"
+        },
+        {
+            "issue": "textFieldProps 类型是 Omit<TextFieldProps, 'label'>，label 已被剔除，不能在此传 label",
+            "wrong": "textFieldProps={{ label: '字段名', placeholder: '请输入' }}  // TS 报错：label 已被 Omit 剔除",
+            "right": "// label 通过 CopyText.label prop 传，textFieldProps 只传 TextField 其他属性\n<CopyText label='字段名' textFieldProps={{ placeholder: '请输入' }} />"
+        },
+        {
+            "issue": "copyValue 优先级最高，传了 copyValue 后 value 仅用于显示，不参与复制",
+            "wrong": "// 期望 copyValue 只在某些情况覆盖，平时还用 value：\n<CopyText value={displayText} copyValue={undefined} />  // copyValue=undefined 时自动 fallback 到 value，OK",
+            "right": "// 需要按条件切换：\ncopyValue={shouldOverride ? realValue : undefined}  // undefined 时组件用 value，string 时用 copyValue"
+        }
+    ],
+    "mapping": {
+        "realComponent": "CopyText",
+        "adapter": null
+    }
+}