@para-ui/core 5.0.0-beta.9 → 5.0.0

package/lib/Selector/interface.d.ts

@@ -28,7 +28,7 @@ export interface SearchReqDataProps {
          * */
         isTree?: boolean;
     };
-    err?: Error | string | null;
+    error?: Error | string | null;
 }
 /** 面包屑 */
 export interface BreadcrumbsListItem {
@@ -409,7 +409,7 @@ export interface SelectorProps extends HelperTextDetailProps {
     /** 处理请求参数 */
     paramsCallback?: (data: ReqFuncProps, isSearch?: boolean) => ReqFuncProps;
     /** 请求回调参数 requestCallback(data, cb) cb(data) 需要回调数据回来 */
-    requestCallback?: (data: any, cb: (data: SelectorAnyJson[]) => void, isSearch?: boolean) => void;
+    requestCallback?: (data: Record<string, unknown>, cb: (data: SelectorAnyJson[]) => void, isSearch?: boolean) => void;
     /** 选中数据标题render */
     selectDataTitleRender?: (list?: SelectorAnyJson[]) => ReactNode;
     /** 选中每一项自定义 */

package/lib/Selector/selectorData/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const n=require("../../_virtual/jsx-runtime.js"),h=require("react"),P=require("../selectorNode/index.js"),z=require("../../AutoTips/index.js"),B=require("../../node_modules/@para-ui/icons/Close/index.js"),G=require("@paraview/lib"),H=require("../../GlobalContext/useFormatMessage.js"),R=require("../../GlobalContext/constant.js"),K=require("../lang/index.js");;/* empty css            */const Q=$=>{const{className:b,layout:m="node",style:q,list:a,groupType:l,nodeMode:D,backDataFieldConfig:o,detail:k,detailRender:g,disabled:c,handSelectorNodeInfo:E,selectDataTitleRender:y,selectRenderItem:d,selectRender:u,onClose:x}=$,S=H.default("Selector",K.default),[v,F]=h.useState({}),j=h.useRef({listTypeJson:{},backDataFieldConfig:{}});j.current.listTypeJson=G.ArrayToObject("value",l),j.current.backDataFieldConfig=o||{},h.useEffect(()=>{if(a&&l&&l.length>0){const e={};for(let s=0,t=a.length;s<t;s++){const i=a[s],r=i[j.current.backDataFieldConfig.type||""];e[r]||(e[r]=[]),e[r].push(i)}F(e)}},[a]);const p=e=>{if(c){if(c===!0)return!0;if(c instanceof Array){const s=o?.key||"",t=e[s];if(c.indexOf(t)!==-1)return!0}}return!1},I=(e,s)=>{let t=e;E&&(t=E(e));const r={useCase:"edit",close:!p(e),detail:k,nodeMode:D,onClose:()=>x&&x(t,s),disabled:p(e),tagStyle:t.tagStyle};d&&(r.leftRender=()=>d(e)),t.leaf!==void 0&&(r.nodeMode=t.leaf?"leaf":"branch");const N=["img","mainTitle","subTitle","tag"];for(let f=0,w=N.length;f<w;f++){const T=N[f]||"",L=o&&o[T]||"";r[T]=t[L]}return g&&(r.detailRender=async()=>await g(t,!1)),t.detail!==void 0&&(r.detail=t.detail),t.close!==void 0&&(r.close=t.close),r},M=()=>u?u(a||[]):a?.map((e,s)=>n.jsxRuntimeExports.jsx(P.default,{...I(e,s)},s)),C=()=>{const e=()=>{if(y)return y(a);if(l)return n.jsxRuntimeExports.jsx(n.jsxRuntimeExports.Fragment,{children:l.map((s,t)=>{let i=0;const r=s.value;if(v[r]&&(i=v[r].length),i!==0)return n.jsxRuntimeExports.jsxs("span",{className:"title-content",children:[i,"个",s.label||s.value]},t)})})};return n.jsxRuntimeExports.jsxs("div",{className:"title",children:[n.jsxRuntimeExports.jsxs("span",{className:"title-tip",children:[S({id:"selected"}),":"]}),e()]})},A=()=>n.jsxRuntimeExports.jsxs("div",{className:"selector-data-node-box",children:[C(),n.jsxRuntimeExports.jsx("div",{className:"content",children:M()})]}),O=()=>u?u(a||[]):n.jsxRuntimeExports.jsx(n.jsxRuntimeExports.Fragment,{children:a?.map((e,s)=>{const t=p(e);return n.jsxRuntimeExports.jsxs("span",{className:"content-tag",children:[n.jsxRuntimeExports.jsx("span",{children:d?d(e):n.jsxRuntimeExports.jsx(z.default,{children:e[o?.mainTitle||""]||e[o?.key||""]})}),!t&&n.jsxRuntimeExports.jsx(B.Close,{onClick:()=>x&&x(e,s)})]},s)})}),_=()=>n.jsxRuntimeExports.jsxs("div",{className:"selector-data-tag-box",children:[C(),n.jsxRuntimeExports.jsx("div",{className:"content",children:O()})]}),J=()=>{let e=`${R.$prefixCls}-selector-data`;return m&&(e+=` ${R.$prefixCls}-selector-data-${m}`),c===!0&&(e+=` ${R.$prefixCls}-selector-data-disabled`),b&&(e+=` ${b}`),e};return n.jsxRuntimeExports.jsx("div",{className:J(),style:q,children:m==="node"?A():_()})};exports.default=Q;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const n=require("../../_virtual/jsx-runtime.js"),h=require("react"),L=require("../selectorNode/index.js"),P=require("../../AutoTips/index.js"),z=require("../../node_modules/@para-ui/icons/Close/index.js"),B=require("../../Utils/snack-kit-shims.js"),G=require("../../GlobalContext/useFormatMessage.js"),R=require("../../GlobalContext/constant.js"),H=require("../lang/index.js");;/* empty css            */const Q=k=>{const{className:b,layout:m="node",style:D,list:a,groupType:l,nodeMode:q,backDataFieldConfig:o,detail:S,detailRender:g,disabled:c,handSelectorNodeInfo:E,selectDataTitleRender:y,selectRenderItem:d,selectRender:u,onClose:x}=k,$=G.default("Selector",H.default),[v,F]=h.useState({}),j=h.useRef({listTypeJson:{},backDataFieldConfig:{}});j.current.listTypeJson=B.ArrayToObject("value",l),j.current.backDataFieldConfig=o||{},h.useEffect(()=>{if(a&&l&&l.length>0){const e={};for(let s=0,t=a.length;s<t;s++){const i=a[s],r=i[j.current.backDataFieldConfig.type||""];e[r]||(e[r]=[]),e[r].push(i)}F(e)}},[a]);const p=e=>{if(c){if(c===!0)return!0;if(c instanceof Array){const s=o?.key||"",t=e[s];if(c.indexOf(t)!==-1)return!0}}return!1},I=(e,s)=>{let t=e;E&&(t=E(e));const r={useCase:"edit",close:!p(e),detail:S,nodeMode:q,onClose:()=>x&&x(t,s),disabled:p(e),tagStyle:t.tagStyle};d&&(r.leftRender=()=>d(e)),t.leaf!==void 0&&(r.nodeMode=t.leaf?"leaf":"branch");const N=["img","mainTitle","subTitle","tag"];for(let f=0,w=N.length;f<w;f++){const T=N[f]||"",K=o&&o[T]||"";r[T]=t[K]}return g&&(r.detailRender=async()=>await g(t,!1)),t.detail!==void 0&&(r.detail=t.detail),t.close!==void 0&&(r.close=t.close),r},M=()=>u?u(a||[]):a?.map((e,s)=>n.jsxRuntimeExports.jsx(L.default,{...I(e,s)},s)),C=()=>{const e=()=>{if(y)return y(a);if(l)return n.jsxRuntimeExports.jsx(n.jsxRuntimeExports.Fragment,{children:l.map((s,t)=>{let i=0;const r=s.value;if(v[r]&&(i=v[r].length),i!==0)return n.jsxRuntimeExports.jsxs("span",{className:"title-content",children:[i,"个",s.label||s.value]},t)})})};return n.jsxRuntimeExports.jsxs("div",{className:"title",children:[n.jsxRuntimeExports.jsxs("span",{className:"title-tip",children:[$({id:"selected"}),":"]}),e()]})},A=()=>n.jsxRuntimeExports.jsxs("div",{className:"selector-data-node-box",children:[C(),n.jsxRuntimeExports.jsx("div",{className:"content",children:M()})]}),O=()=>u?u(a||[]):n.jsxRuntimeExports.jsx(n.jsxRuntimeExports.Fragment,{children:a?.map((e,s)=>{const t=p(e);return n.jsxRuntimeExports.jsxs("span",{className:"content-tag",children:[n.jsxRuntimeExports.jsx("span",{children:d?d(e):n.jsxRuntimeExports.jsx(P.default,{children:e[o?.mainTitle||""]||e[o?.key||""]})}),!t&&n.jsxRuntimeExports.jsx(z.Close,{onClick:()=>x&&x(e,s)})]},s)})}),_=()=>n.jsxRuntimeExports.jsxs("div",{className:"selector-data-tag-box",children:[C(),n.jsxRuntimeExports.jsx("div",{className:"content",children:O()})]}),J=()=>{let e=`${R.$prefixCls}-selector-data`;return m&&(e+=` ${R.$prefixCls}-selector-data-${m}`),c===!0&&(e+=` ${R.$prefixCls}-selector-data-disabled`),b&&(e+=` ${b}`),e};return n.jsxRuntimeExports.jsx("div",{className:J(),style:D,children:m==="node"?A():_()})};exports.default=Q;
 //# sourceMappingURL=index.js.map

package/lib/Selector/selectorMain/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const r=require("../../_virtual/jsx-runtime.js"),o=require("react"),ne=require("../selectorNode/index.js"),ue=require("../../Search/index.js"),he=require("../../Breadcrumbs/index.js"),fe=require("../../Loading/index.js"),me=require("../../Empty/index.js"),xe=require("../../node_modules/@para-ui/icons/Search/index.js"),pe=require("../../node_modules/@para-ui/icons/Refresh/index.js"),je=require("@paraview/lib"),le=require("../../GlobalContext/useFormatMessage.js"),ie=require("../lang/index.js"),q=require("../../GlobalContext/constant.js");;/* empty css            */const ce=K=>{const{className:C,value:f,rowKey:se="key",nodeMode:A="branch",selectMode:m,loadMore:R=!1,isAllCheck:j=!1,detail:V,detailRender:B,isLazy:G,list:l,groupType:a,breadcrumbs:z,breadcrumbsSeparator:D="-",breadcrumbsList:k=[],fieldConfig:Q,disabled:d,disabledChild:u,emptyProps:S,loading:x,onClickBreadcrumbs:w,onLevel:I,onSelect:E,onLoad:_,onAllCheck:v}=K,y=le.default("Selector",ie.default),[U,W]=o.useState({}),p=o.useRef({listTypeJson:{},fieldConfig:{},resizeTimer:null}),b=o.useRef(null),L=o.useRef(null);p.current.listTypeJson=je.ArrayToObject("value",a),p.current.fieldConfig=Q||{},o.useEffect(()=>(T(),()=>{clearTimeout(p.current.resizeTimer)}),[]),o.useEffect(()=>{if(l&&a&&a.length>0){const e={};for(let t=0,c=l.length;t<c;t++){const s=l[t],i=s.type;e[i]||(e[i]=[]),e[i].push(s)}W(e)}},[l]);const T=()=>{clearTimeout(p.current.resizeTimer),p.current.resizeTimer=setTimeout(()=>{N()},100)},N=()=>{if(!L.current||!b.current)return;const e=b.current,t=L.current;if(t.classList.remove("selector-main-list-scroll-top","selector-main-list-scroll-bottom","selector-main-list-scroll-middle"),!(e.scrollHeight<=e.clientHeight)){if(e.scrollTop===0){t.classList.add("selector-main-list-scroll-top");return}if(e.clientHeight+e.scrollTop===e.scrollHeight){t.classList.add("selector-main-list-scroll-bottom");return}t.classList.add("selector-main-list-scroll-middle")}},F=()=>{const e={checked:!1,indeterminate:!1};if(!f||!l||l.length===0)return e;for(let t=0,c=l.length;t<c;t++){const s=l[t],i=s.key;if(H(s)){f[i]&&(e.checked=!0);continue}f[i]?e.checked=!0:e.indeterminate=!0}return e.checked&&e.indeterminate?(e.checked=!1,e):(!e.checked&&e.indeterminate&&(e.indeterminate=!1),e)},H=e=>!!(d&&(d===!0||d instanceof Array&&e.key&&d.indexOf(e.key)!==-1)||e.disabled),O=e=>!!(u&&(u===!0||u instanceof Array&&e.key&&u.indexOf(e.key)!==-1)||e.disabledChild),X=()=>{if(!j||m!=="check")return null;const e=F(),t=()=>{let c=!0;e.checked&&(c=!1),v&&v(c)};return r.jsxRuntimeExports.jsx(ne.default,{disabled:d===!0,nodeMode:"branch",mainTitle:y({id:"selectAll"}),selectMode:"check",...e,onSelect:t,className:"selector-all-check"})},Y=()=>{_&&_()},J=()=>R?r.jsxRuntimeExports.jsx("div",{className:"selector-main-list-more",onClick:Y,children:r.jsxRuntimeExports.jsx("span",{className:"more-btn",children:y({id:"seeMore"})})}):null,M=e=>{let t=!1;return f&&f[e.key]&&(t=!0),t},P=e=>{const t={useCase:"view",detail:V,nodeMode:A,disabled:H(e),disabledChild:O(e),onLevel:()=>I&&I(e),onSelect:()=>E&&E(e),checked:M(e)};e.leaf!==void 0&&(t.nodeMode=e.leaf?"leaf":"branch");const c=["img","mainTitle","subTitle","tag","tagStyle"];for(let s=0,i=c.length;s<i;s++){const $=c[s];t[$]=e[$]}if(e.choice!==!1&&m&&(t.selectMode=m),G)t.child=e.child;else{const s=e.children||[];s&&s.length>0&&(t.child=!0),e.child!==void 0&&(t.child=e.child)}return B&&(t.detailRender=async()=>await B(e,!0)),e.detail!==void 0&&(t.detail=e.detail),t},g=e=>e?.map((t,c)=>r.jsxRuntimeExports.jsx(ne.default,{...P(t)},c)),h=()=>a&&a.length>0?r.jsxRuntimeExports.jsx(r.jsxRuntimeExports.Fragment,{children:a.map((e,t)=>{const c=e.value,s=U[c]||[];let i="selector-group-title";return t===0&&(i+=" selector-group-title-first"),r.jsxRuntimeExports.jsxs(o.Fragment,{children:[s.length>0&&r.jsxRuntimeExports.jsx("div",{className:i,children:e.label||c}),g(s)]},t)})}):g(l||[]),Z=e=>{w&&w(e)},ee=()=>!z||k.length===0?null:r.jsxRuntimeExports.jsx("div",{className:"nav-box",children:r.jsxRuntimeExports.jsx(he.Breadcrumbs,{minNum:1,list:k,separator:D,onClickItem:Z})}),te=()=>l?.length===0&&!x?r.jsxRuntimeExports.jsx("div",{className:"selector-main-list-no-data",children:r.jsxRuntimeExports.jsx(me.default,{...S,size:S?.size||"small"})}):r.jsxRuntimeExports.jsxs("div",{className:"selector-main-list",children:[X(),r.jsxRuntimeExports.jsx("div",{className:"selector-main-list-content",ref:L,children:r.jsxRuntimeExports.jsx("div",{className:"selector-main-list-content-box",ref:b,onScroll:N,children:h()})}),J()]}),re=()=>{let e="selector-main-content";return C&&(e+=` ${C}`),d&&(e+=" selector-main-content-disabled"),j&&m==="check"&&(e+=" selector-main-content-all-check"),R&&(e+=" selector-main-content-load-more"),e};return T(),r.jsxRuntimeExports.jsxs("div",{className:re(),children:[ee(),te()]})},be=K=>{const{className:C,style:f,url:se,value:A,rowKey:m="key",nodeMode:R="branch",selectMode:j,loadMore:V=!1,searchLoadMore:B=!1,isAllCheck:G=!1,disabled:l,disabledChild:a,detail:z,detailRender:D,isLazy:k,list:Q,groupType:d,groupRange:u,search:S,searchVal:x="",searchPlaceholder:w,searchTrigger:I,searchLoading:E,searchList:_,loading:v,mainHeader:y,breadcrumbs:U,breadcrumbsSeparator:W="-",breadcrumbsList:p=[],fieldConfig:b,onClickBreadcrumbs:L,onLevel:T,onSelect:N,onLoad:F,onAllCheck:H,onSearch:O,onRefresh:X}=K,Y=le.default("Selector",ie.default),[J,M]=o.useState(!1),[P,g]=o.useState(""),h=o.useRef({searchTimer:null,searchStr:""});o.useEffect(()=>{x&&(h.current.searchStr=x.val,g(x.val),x.val!==""&&M(!0))},[x]);const Z=n=>{g(n),h.current.searchStr=n,I!=="onEnter"&&e()},ee=()=>{e(!0)},te=()=>{e(!0)},re=()=>{e()},e=n=>{clearTimeout(h.current.searchTimer),h.current.searchTimer=setTimeout(()=>{M(!!h.current.searchStr),O&&O(h.current.searchStr,!!n)},300)},t=()=>{const n=()=>P?r.jsxRuntimeExports.jsx(xe.Search,{}):!se&&!X?null:r.jsxRuntimeExports.jsx(pe.Refresh,{});return r.jsxRuntimeExports.jsx(r.jsxRuntimeExports.Fragment,{children:S&&r.jsxRuntimeExports.jsx(ue.Search,{className:"selectot-main-search",value:P,rightIconExist:!0,showBtn:!1,rightIcon:n(),btnType:"inside",onChange:Z,onEnter:ee,onClear:re,placeholder:w||Y({id:"pleaseEnter"}),onClickBtn:te})})},c=n=>de=>{n&&(h.current.searchStr="",g(""),M(!1)),T&&T(de,n)},s=n=>()=>{F&&F(n)},i=()=>r.jsxRuntimeExports.jsx(ce,{className:"selector-main-list-box",value:A,rowKey:m,nodeMode:R,selectMode:j,loadMore:V,isAllCheck:G,disabled:l,disabledChild:a,detail:z,detailRender:D,isLazy:k,list:Q,loading:v,groupType:u==="list"||u==="searchList"?d:void 0,breadcrumbs:U,breadcrumbsSeparator:W,breadcrumbsList:p,fieldConfig:b,onClickBreadcrumbs:L,onLevel:c(!1),onSelect:N,onLoad:s(!1),onAllCheck:H},"list"),$=()=>{if(J)return r.jsxRuntimeExports.jsx(ce,{className:"selector-main-search-content",value:A,rowKey:m,nodeMode:R,selectMode:j,loadMore:B,isAllCheck:!1,disabled:l,disabledChild:a,detail:z,detailRender:D,isLazy:k,list:_,groupType:u==="search"||u==="searchList"?d:void 0,fieldConfig:b,loading:E,onSelect:N,onLevel:c(!0),onLoad:s(!0)},"search")},oe=()=>{if(E||v)return r.jsxRuntimeExports.jsx(fe.Loading,{})},ae=()=>{let n=`${q.$prefixCls}-selector-main`;return C&&(n+=` ${C}`),j==="check"&&(n+=` ${q.$prefixCls}-selector-main-select`),J&&(n+=` ${q.$prefixCls}-selector-main-show-search`),S&&(n+=` ${q.$prefixCls}-selector-main-search`),l===!0&&(n+=` ${q.$prefixCls}-selector-main-disabled`),n};return r.jsxRuntimeExports.jsxs("div",{className:ae(),style:f,children:[t(),y&&r.jsxRuntimeExports.jsx("div",{className:"selector-main-header",children:y}),r.jsxRuntimeExports.jsxs("div",{className:"selector-main-box",children:[i(),$(),oe()]})]})};exports.default=be;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const s=require("../../_virtual/jsx-runtime.js"),o=require("react"),ne=require("../selectorNode/index.js"),ue=require("../../Search/index.js"),he=require("../../Breadcrumbs/index.js"),fe=require("../../Loading/index.js"),me=require("../../Empty/index.js"),xe=require("../../node_modules/@para-ui/icons/Search/index.js"),pe=require("../../node_modules/@para-ui/icons/Refresh/index.js"),je=require("../../Utils/snack-kit-shims.js"),ie=require("../../GlobalContext/useFormatMessage.js"),le=require("../lang/index.js"),q=require("../../GlobalContext/constant.js");;/* empty css            */const ce=P=>{const{className:C,value:f,rowKey:re="key",nodeMode:A="branch",selectMode:m,loadMore:k=!1,isAllCheck:j=!1,detail:V,detailRender:B,isLazy:G,list:i,groupType:a,breadcrumbs:z,breadcrumbsSeparator:D="-",breadcrumbsList:R=[],fieldConfig:Q,disabled:d,disabledChild:u,emptyProps:S,loading:x,onClickBreadcrumbs:w,onLevel:I,onSelect:v,onLoad:_,onAllCheck:E}=P,y=ie.default("Selector",le.default),[U,W]=o.useState({}),p=o.useRef({listTypeJson:{},fieldConfig:{},resizeTimer:void 0}),b=o.useRef(null),L=o.useRef(null);p.current.listTypeJson=je.ArrayToObject("value",a),p.current.fieldConfig=Q||{},o.useEffect(()=>(T(),()=>{clearTimeout(p.current.resizeTimer)}),[]),o.useEffect(()=>{if(i&&a&&a.length>0){const e={};for(let t=0,c=i.length;t<c;t++){const r=i[t],l=r.type;e[l]||(e[l]=[]),e[l].push(r)}W(e)}},[i]);const T=()=>{clearTimeout(p.current.resizeTimer),p.current.resizeTimer=setTimeout(()=>{N()},100)},N=()=>{if(!L.current||!b.current)return;const e=b.current,t=L.current;if(t.classList.remove("selector-main-list-scroll-top","selector-main-list-scroll-bottom","selector-main-list-scroll-middle"),!(e.scrollHeight<=e.clientHeight)){if(e.scrollTop===0){t.classList.add("selector-main-list-scroll-top");return}if(e.clientHeight+e.scrollTop===e.scrollHeight){t.classList.add("selector-main-list-scroll-bottom");return}t.classList.add("selector-main-list-scroll-middle")}},F=()=>{const e={checked:!1,indeterminate:!1};if(!f||!i||i.length===0)return e;for(let t=0,c=i.length;t<c;t++){const r=i[t],l=r.key;if(H(r)){f[l]&&(e.checked=!0);continue}f[l]?e.checked=!0:e.indeterminate=!0}return e.checked&&e.indeterminate?(e.checked=!1,e):(!e.checked&&e.indeterminate&&(e.indeterminate=!1),e)},H=e=>!!(d&&(d===!0||d instanceof Array&&e.key&&d.indexOf(e.key)!==-1)||e.disabled),O=e=>!!(u&&(u===!0||u instanceof Array&&e.key&&u.indexOf(e.key)!==-1)||e.disabledChild),X=()=>{if(!j||m!=="check")return null;const e=F(),t=()=>{let c=!0;e.checked&&(c=!1),E&&E(c)};return s.jsxRuntimeExports.jsx(ne.default,{disabled:d===!0,nodeMode:"branch",mainTitle:y({id:"selectAll"}),selectMode:"check",...e,onSelect:t,className:"selector-all-check"})},Y=()=>{_&&_()},J=()=>k?s.jsxRuntimeExports.jsx("div",{className:"selector-main-list-more",onClick:Y,children:s.jsxRuntimeExports.jsx("span",{className:"more-btn",children:y({id:"seeMore"})})}):null,M=e=>{let t=!1;return f&&f[e.key]&&(t=!0),t},K=e=>{const t={useCase:"view",detail:V,nodeMode:A,disabled:H(e),disabledChild:O(e),onLevel:()=>I&&I(e),onSelect:()=>v&&v(e),checked:M(e)};e.leaf!==void 0&&(t.nodeMode=e.leaf?"leaf":"branch");const c=["img","mainTitle","subTitle","tag","tagStyle"];for(let r=0,l=c.length;r<l;r++){const $=c[r];t[$]=e[$]}if(e.choice!==!1&&m&&(t.selectMode=m),G)t.child=e.child;else{const r=e.children||[];r&&r.length>0&&(t.child=!0),e.child!==void 0&&(t.child=e.child)}return B&&(t.detailRender=async()=>await B(e,!0)),e.detail!==void 0&&(t.detail=e.detail),t},g=e=>e?.map((t,c)=>s.jsxRuntimeExports.jsx(ne.default,{...K(t)},c)),h=()=>a&&a.length>0?s.jsxRuntimeExports.jsx(s.jsxRuntimeExports.Fragment,{children:a.map((e,t)=>{const c=e.value,r=U[c]||[];let l="selector-group-title";return t===0&&(l+=" selector-group-title-first"),s.jsxRuntimeExports.jsxs(o.Fragment,{children:[r.length>0&&s.jsxRuntimeExports.jsx("div",{className:l,children:e.label||c}),g(r)]},t)})}):g(i||[]),Z=e=>{w&&w(e)},ee=()=>!z||R.length===0?null:s.jsxRuntimeExports.jsx("div",{className:"nav-box",children:s.jsxRuntimeExports.jsx(he.Breadcrumbs,{minNum:1,list:R,separator:D,onClickItem:Z})}),te=()=>i?.length===0&&!x?s.jsxRuntimeExports.jsx("div",{className:"selector-main-list-no-data",children:s.jsxRuntimeExports.jsx(me.default,{...S,size:S?.size||"small"})}):s.jsxRuntimeExports.jsxs("div",{className:"selector-main-list",children:[X(),s.jsxRuntimeExports.jsx("div",{className:"selector-main-list-content",ref:L,children:s.jsxRuntimeExports.jsx("div",{className:"selector-main-list-content-box",ref:b,onScroll:N,children:h()})}),J()]}),se=()=>{let e="selector-main-content";return C&&(e+=` ${C}`),d&&(e+=" selector-main-content-disabled"),j&&m==="check"&&(e+=" selector-main-content-all-check"),k&&(e+=" selector-main-content-load-more"),e};return T(),s.jsxRuntimeExports.jsxs("div",{className:se(),children:[ee(),te()]})},be=P=>{const{className:C,style:f,url:re,value:A,rowKey:m="key",nodeMode:k="branch",selectMode:j,loadMore:V=!1,searchLoadMore:B=!1,isAllCheck:G=!1,disabled:i,disabledChild:a,detail:z,detailRender:D,isLazy:R,list:Q,groupType:d,groupRange:u,search:S,searchVal:x="",searchPlaceholder:w,searchTrigger:I,searchLoading:v,searchList:_,loading:E,mainHeader:y,breadcrumbs:U,breadcrumbsSeparator:W="-",breadcrumbsList:p=[],fieldConfig:b,onClickBreadcrumbs:L,onLevel:T,onSelect:N,onLoad:F,onAllCheck:H,onSearch:O,onRefresh:X}=P,Y=ie.default("Selector",le.default),[J,M]=o.useState(!1),[K,g]=o.useState(""),h=o.useRef({searchTimer:void 0,searchStr:""});o.useEffect(()=>{x&&(h.current.searchStr=x.val,g(x.val),x.val!==""&&M(!0))},[x]);const Z=n=>{g(n),h.current.searchStr=n,I!=="onEnter"&&e()},ee=()=>{e(!0)},te=()=>{e(!0)},se=()=>{e()},e=n=>{clearTimeout(h.current.searchTimer),h.current.searchTimer=setTimeout(()=>{M(!!h.current.searchStr),O&&O(h.current.searchStr,!!n)},300)},t=()=>{const n=()=>K?s.jsxRuntimeExports.jsx(xe.Search,{}):!re&&!X?null:s.jsxRuntimeExports.jsx(pe.Refresh,{});return s.jsxRuntimeExports.jsx(s.jsxRuntimeExports.Fragment,{children:S&&s.jsxRuntimeExports.jsx(ue.Search,{className:"selectot-main-search",value:K,rightIconExist:!0,showBtn:!1,rightIcon:n(),btnType:"inside",onChange:Z,onEnter:ee,onClear:se,placeholder:w||Y({id:"pleaseEnter"}),onClickBtn:te})})},c=n=>de=>{n&&(h.current.searchStr="",g(""),M(!1)),T&&T(de,n)},r=n=>()=>{F&&F(n)},l=()=>s.jsxRuntimeExports.jsx(ce,{className:"selector-main-list-box",value:A,rowKey:m,nodeMode:k,selectMode:j,loadMore:V,isAllCheck:G,disabled:i,disabledChild:a,detail:z,detailRender:D,isLazy:R,list:Q,loading:E,groupType:u==="list"||u==="searchList"?d:void 0,breadcrumbs:U,breadcrumbsSeparator:W,breadcrumbsList:p,fieldConfig:b,onClickBreadcrumbs:L,onLevel:c(!1),onSelect:N,onLoad:r(!1),onAllCheck:H},"list"),$=()=>{if(J)return s.jsxRuntimeExports.jsx(ce,{className:"selector-main-search-content",value:A,rowKey:m,nodeMode:k,selectMode:j,loadMore:B,isAllCheck:!1,disabled:i,disabledChild:a,detail:z,detailRender:D,isLazy:R,list:_,groupType:u==="search"||u==="searchList"?d:void 0,fieldConfig:b,loading:v,onSelect:N,onLevel:c(!0),onLoad:r(!0)},"search")},oe=()=>{if(v||E)return s.jsxRuntimeExports.jsx(fe.Loading,{})},ae=()=>{let n=`${q.$prefixCls}-selector-main`;return C&&(n+=` ${C}`),j==="check"&&(n+=` ${q.$prefixCls}-selector-main-select`),J&&(n+=` ${q.$prefixCls}-selector-main-show-search`),S&&(n+=` ${q.$prefixCls}-selector-main-search`),i===!0&&(n+=` ${q.$prefixCls}-selector-main-disabled`),n};return s.jsxRuntimeExports.jsxs("div",{className:ae(),style:f,children:[t(),y&&s.jsxRuntimeExports.jsx("div",{className:"selector-main-header",children:y}),s.jsxRuntimeExports.jsxs("div",{className:"selector-main-box",children:[l(),$(),oe()]})]})};exports.default=be;
 //# sourceMappingURL=index.js.map

package/lib/Selector/selectorNode/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const e=require("../../_virtual/jsx-runtime.js"),m=require("react"),K=require("../../Radio/index.js"),Q=require("../../Checkbox/index.js"),U=require("../../Popover/index.js"),c=require("../../AutoTips/index.js"),W=require("../../Loading/index.js"),X=require("../../node_modules/@para-ui/icons/Close/index.js"),t=require("../../GlobalContext/constant.js"),Y=require("../../GlobalContext/useFormatMessage.js"),Z=require("../lang/index.js");;/* empty css            */const ee=k=>{const{className:p,style:L,nodeMode:d="branch",useCase:S="view",img:n,selectMode:j,mainTitle:r,subTitle:o,tag:l,tagStyle:h,detail:x,detailRender:f,leftRender:R,child:E,close:g,checked:C,indeterminate:y,disabled:a,disabledChild:N,onLevel:v,onSelect:$,onClose:b}=k,D=Y.default("Selector",Z.default),[_,q]=m.useState(),[P,u]=m.useState(!1),i=m.useRef(),M=()=>{a||$&&$()},T=s=>{s.stopPropagation(),!N&&v&&v()},w=s=>{s.stopPropagation()},F=s=>{s.stopPropagation(),b&&b()},z=async s=>{if(!f)return;if(u(!1),!s)return q(null);u(!0),i.current&&i.current.classList.add("selector-detail-popover-content-loading");const J=await f();i.current&&i.current.classList.remove("selector-detail-popover-content-loading"),u(!1),q(J)},A=()=>{if(!n)return null;let s=n;return typeof n=="string"&&(s=e.jsxRuntimeExports.jsx("img",{src:n})),e.jsxRuntimeExports.jsx("span",{className:"node-img",children:s})},B=()=>j==="radio"?e.jsxRuntimeExports.jsx(K.Radio,{size:"small",className:"selector-node-radio",checked:C,disabled:a}):j==="check"?e.jsxRuntimeExports.jsx(Q.Checkbox,{size:"small",className:"selector-node-check",checked:C,disabled:a,indeterminate:y}):null,I=()=>e.jsxRuntimeExports.jsxs("div",{className:"selector-detail-popover-content",ref:i,children:[_,P&&e.jsxRuntimeExports.jsx(W.Loading,{})]}),O=()=>x?e.jsxRuntimeExports.jsx(U.Popover,{content:I(),trigger:"hover",placement:"bottomRight",overlayClassName:`${t.$prefixCls}-selector-detail`,onVisibleChange:z,children:e.jsxRuntimeExports.jsx("span",{className:"detail",onClick:w,children:D({id:"detail"})})}):null,V=()=>{if(d==="branch")return e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[r&&e.jsxRuntimeExports.jsx("span",{className:"main-title",children:e.jsxRuntimeExports.jsx(c.default,{children:r})}),o&&e.jsxRuntimeExports.jsx("span",{className:"sub-title",children:e.jsxRuntimeExports.jsx(c.default,{children:o})}),l&&e.jsxRuntimeExports.jsx("span",{className:"tag",style:h,children:l})]});if(d==="leaf")return e.jsxRuntimeExports.jsxs("div",{className:"title-box",children:[e.jsxRuntimeExports.jsxs("div",{className:"main-title-box",children:[r&&e.jsxRuntimeExports.jsx("span",{className:"main-title",children:e.jsxRuntimeExports.jsx(c.default,{children:r})}),l&&e.jsxRuntimeExports.jsx("span",{className:"tag",style:h,children:l})]}),o&&e.jsxRuntimeExports.jsx("div",{className:"sub-title",children:e.jsxRuntimeExports.jsx(c.default,{children:o})})]})},G=()=>R?R():e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[B(),A(),V()]}),H=()=>{let s=`${t.$prefixCls}-selector-node`;return s+=` ${t.$prefixCls}-selector-node-${S}`,s+=` ${t.$prefixCls}-selector-node-${d}`,a&&(s+=` ${t.$prefixCls}-selector-node-disabled`),N&&(s+=` ${t.$prefixCls}-selector-node-disabled-child`),n&&(s+=` ${t.$prefixCls}-selector-node-img`),p&&(s+=` ${p}`),s};return e.jsxRuntimeExports.jsxs("div",{className:H(),style:L,onClick:M,children:[e.jsxRuntimeExports.jsx("div",{className:"selector-node-left",children:G()}),e.jsxRuntimeExports.jsxs("div",{className:"selector-node-right",children:[O(),x&&E&&e.jsxRuntimeExports.jsx("span",{className:"line"}),E&&e.jsxRuntimeExports.jsx("span",{className:"lower-child",onClick:T,children:D({id:"child"})}),x&&g&&e.jsxRuntimeExports.jsx("span",{className:"line"}),g&&e.jsxRuntimeExports.jsx("span",{className:"close",onClick:F,children:e.jsxRuntimeExports.jsx(X.Close,{})})]})]})};exports.default=ee;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const e=require("../../_virtual/jsx-runtime.js"),m=require("react"),K=require("../../Radio/index.js"),Q=require("../../Checkbox/index.js"),U=require("../../Popover/index.js"),c=require("../../AutoTips/index.js"),W=require("../../Loading/index.js"),X=require("../../node_modules/@para-ui/icons/Close/index.js"),t=require("../../GlobalContext/constant.js"),Y=require("../../GlobalContext/useFormatMessage.js"),Z=require("../lang/index.js");;/* empty css            */const ee=k=>{const{className:p,style:L,nodeMode:d="branch",useCase:S="view",img:n,selectMode:j,mainTitle:r,subTitle:o,tag:l,tagStyle:h,detail:x,detailRender:f,leftRender:R,child:E,close:g,checked:C,indeterminate:y,disabled:a,disabledChild:N,onLevel:v,onSelect:$,onClose:b}=k,D=Y.default("Selector",Z.default),[_,q]=m.useState(),[P,u]=m.useState(!1),i=m.useRef(null),M=()=>{a||$&&$()},T=s=>{s.stopPropagation(),!N&&v&&v()},w=s=>{s.stopPropagation()},F=s=>{s.stopPropagation(),b&&b()},z=async s=>{if(!f)return;if(u(!1),!s)return q(null);u(!0),i.current&&i.current.classList.add("selector-detail-popover-content-loading");const J=await f();i.current&&i.current.classList.remove("selector-detail-popover-content-loading"),u(!1),q(J)},A=()=>{if(!n)return null;let s=n;return typeof n=="string"&&(s=e.jsxRuntimeExports.jsx("img",{src:n})),e.jsxRuntimeExports.jsx("span",{className:"node-img",children:s})},B=()=>j==="radio"?e.jsxRuntimeExports.jsx(K.Radio,{size:"small",className:"selector-node-radio",checked:C,disabled:a}):j==="check"?e.jsxRuntimeExports.jsx(Q.Checkbox,{size:"small",className:"selector-node-check",checked:C,disabled:a,indeterminate:y}):null,I=()=>e.jsxRuntimeExports.jsxs("div",{className:"selector-detail-popover-content",ref:i,children:[_,P&&e.jsxRuntimeExports.jsx(W.Loading,{})]}),O=()=>x?e.jsxRuntimeExports.jsx(U.Popover,{content:I(),trigger:"hover",placement:"bottomRight",overlayClassName:`${t.$prefixCls}-selector-detail`,onVisibleChange:z,children:e.jsxRuntimeExports.jsx("span",{className:"detail",onClick:w,children:D({id:"detail"})})}):null,V=()=>{if(d==="branch")return e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[r&&e.jsxRuntimeExports.jsx("span",{className:"main-title",children:e.jsxRuntimeExports.jsx(c.default,{children:r})}),o&&e.jsxRuntimeExports.jsx("span",{className:"sub-title",children:e.jsxRuntimeExports.jsx(c.default,{children:o})}),l&&e.jsxRuntimeExports.jsx("span",{className:"tag",style:h,children:l})]});if(d==="leaf")return e.jsxRuntimeExports.jsxs("div",{className:"title-box",children:[e.jsxRuntimeExports.jsxs("div",{className:"main-title-box",children:[r&&e.jsxRuntimeExports.jsx("span",{className:"main-title",children:e.jsxRuntimeExports.jsx(c.default,{children:r})}),l&&e.jsxRuntimeExports.jsx("span",{className:"tag",style:h,children:l})]}),o&&e.jsxRuntimeExports.jsx("div",{className:"sub-title",children:e.jsxRuntimeExports.jsx(c.default,{children:o})})]})},G=()=>R?R():e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[B(),A(),V()]}),H=()=>{let s=`${t.$prefixCls}-selector-node`;return s+=` ${t.$prefixCls}-selector-node-${S}`,s+=` ${t.$prefixCls}-selector-node-${d}`,a&&(s+=` ${t.$prefixCls}-selector-node-disabled`),N&&(s+=` ${t.$prefixCls}-selector-node-disabled-child`),n&&(s+=` ${t.$prefixCls}-selector-node-img`),p&&(s+=` ${p}`),s};return e.jsxRuntimeExports.jsxs("div",{className:H(),style:L,onClick:M,children:[e.jsxRuntimeExports.jsx("div",{className:"selector-node-left",children:G()}),e.jsxRuntimeExports.jsxs("div",{className:"selector-node-right",children:[O(),x&&E&&e.jsxRuntimeExports.jsx("span",{className:"line"}),E&&e.jsxRuntimeExports.jsx("span",{className:"lower-child",onClick:T,children:D({id:"child"})}),x&&g&&e.jsxRuntimeExports.jsx("span",{className:"line"}),g&&e.jsxRuntimeExports.jsx("span",{className:"close",onClick:F,children:e.jsxRuntimeExports.jsx(X.Close,{})})]})]})};exports.default=ee;
 //# sourceMappingURL=index.js.map

package/lib/Selector/util.d.ts

@@ -5,11 +5,11 @@ export interface ReqFuncProps {
     /** 请求上下文 */
     ctx?: string;
     /** 请求参数 */
-    data?: any;
-    [name: string]: any;
+    data?: Record<string, unknown>;
+    [name: string]: unknown;
 }
 /**
  * 发送请求
  * @param obj {ReqFuncProps} 请求信息
  */
-export declare const reqFunc: (obj: ReqFuncProps) => Promise<import('@paraview/lib').ParaResponse> | undefined;
+export declare const reqFunc: (obj: ReqFuncProps) => Promise<import('@snack-kit/lib').HttpResult<unknown>> | undefined;

package/lib/Selector/util.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@paraview/lib"),s=n=>{const{method:e,data:t,...r}=n;if(e==="Get")return o.Get({params:t,...r});if(e==="Post")return o.Post({data:t,...r})};exports.reqFunc=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@snack-kit/lib"),u=s=>{const{method:t,data:e,url:r,...o}=s;if(t==="Get")return n.Get(r,{params:e,...o});if(t==="Post")return n.Post(r,e,o)};exports.reqFunc=u;
 //# sourceMappingURL=util.js.map

package/lib/SelectorPicker/component.json

@@ -0,0 +1,179 @@
+{
+    "name": "SelectorPicker",
+    "category": "Data Entry",
+    "description": "选择器弹出框，Selector 的弹出框封装",
+    "semantic": {
+        "intent": [
+            "弹出选择",
+            "下拉选择器"
+        ],
+        "useCases": [
+            "表单选择",
+            "快速选择",
+            "弹出式选择"
+        ],
+        "riskLevel": "normal"
+    },
+    "variants": {
+        "default": {
+            "meaning": "默认样式"
+        }
+    },
+    "states": [
+        "default",
+        "disabled",
+        "error"
+    ],
+    "idealProps": {
+        "value": {
+            "type": "Record<string, any>[] | Record<string, any>",
+            "description": "受控选中值;multiple=true 时为对象数组 Record<string,any>[],false 时为单对象 Record<string,any>;清空时 onChange 入参为 null。外部以 string[] key 列表受控时,挂入前用 useMemo data.filter 反查为对象数组(见 api.ts 顶部 C 协议)"
+        },
+        "defaultValue": {
+            "type": "Record<string, any>[] | Record<string, any>",
+            "description": "非受控默认值;类型规则同 value"
+        },
+        "onChange": {
+            "type": "(val: Record<string,any>[] | Record<string,any> | null, node: Record<string,any>, rowData: Record<string,any>) => void",
+            "description": "值变化回调;multiple 时 val 为数组,否则为单对象;清空时 val=null(回写外部 string[] 时需 ?? [] 兜底);node=节点处理后数据、rowData=原始数据"
+        },
+        "multiple": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否多选;true 时 value/defaultValue 必须为数组,onChange 入参 val 也为数组"
+        },
+        "allowClear": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否支持清除已选值;true 时悬停显示清除按钮,触发顺序:onClear() → onChange(null)"
+        },
+        "selectorProps": {
+            "type": "Omit<SelectorProps, 'layout' | 'disabled' | 'value' | 'defaultValue' | 'onChange' | 'selectMode'>",
+            "description": "透传给底层 Selector 的属性(data/url/fieldConfig/rowKey/breadcrumbsHead/searchOption/backDataFieldConfig 等);Omit 列出的字段已被 SelectorPicker 接管不可透传;常用子字段速查见 api.ts 顶部 E 协议"
+        },
+        "tagRender": {
+            "type": "(item: Record<string, any>) => React.ReactNode",
+            "description": "多选 tag 自定义渲染;入参为已选 list 项对象"
+        },
+        "size": {
+            "type": "'small' | 'medium' | 'large'",
+            "values": ["small", "medium", "large"],
+            "default": "large",
+            "description": "输入框尺寸"
+        },
+        "placeholder": {
+            "type": "string",
+            "default": "请选择",
+            "description": "未选中时占位文本"
+        },
+        "getPopupContainer": {
+            "type": "(triggerNode: HTMLElement) => HTMLElement",
+            "description": "浮层挂载容器;默认 body,Modal 内必传 trigger.parentNode 避免点击穿透"
+        },
+        "label": {
+            "type": "React.ReactNode",
+            "description": "标签文案;支持节点(可嵌图标 / Tooltip 触发器)"
+        },
+        "required": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否必填;true 时 label 前渲染红色 *"
+        },
+        "disabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "禁用整个选择器(无法点击展开浮层、无法清除)"
+        },
+        "error": {
+            "type": "boolean",
+            "default": false,
+            "description": "错误状态;输入框边框变红,搭配 helperText 显示错误信息"
+        },
+        "helperText": {
+            "type": "React.ReactNode",
+            "description": "辅助文本;error=true 时显示为错误信息,否则显示为常规说明"
+        },
+        "overLine": {
+            "type": "boolean",
+            "description": "多选时已选项是否换行;true 换行,false 单行折叠显示 +N"
+        }
+    },
+    "do": [
+        "配合 Selector 使用(SelectorPicker 是 Selector 的弹出框封装,所有候选数据走 selectorProps.data 透传给底层 Selector)",
+        "外部以 string[](key 列表)受控时,用 useMemo data.find 反查映射为 Record<string,any>[] 后挂入 value(详见 api.ts §C 反向映射模式)",
+        "二次封装业务组件时,JSX 内 **受控 prop 写在 {...pickerProps} spread 之后**,后写覆盖保护受控状态(详见 api.ts §D)",
+        "提供清空功能(allowClear=true + onClear 监听,onChange 入参 val=null 时回写外部 string[] 用 `?? []` 兜底)"
+    ],
+    "dont": [
+        "传 `visible` / `open` / `show` 显隐控制 prop(本组件不存在;父层条件渲染 `{showPicker && <SelectorPicker ... />}` 控制 mount;见 api.ts §A)",
+        "selectorProps 透传 `layout` / `disabled` / `value` / `defaultValue` / `onChange` / `selectMode`(已被 SelectorPicker 接管,类型已 Omit,透传无效)",
+        "selectorProps 写错字段名:`list`(应为 `data`)/ `keys`(应为 `rowKey`)— 内部不消费会静默失败",
+        "二次封装时 `pickerProps?: any` **作为推荐签名**(❌ 不能阻止外部覆盖受控;✅ 推荐 `Omit<SelectorPickerProps, 'value'|'defaultValue'|'onChange'|'multiple'|'selectorProps'>`);**但若需求模板硬性要求 any 签名,见 interpretivePriority 兼容路径**",
+        "弹窗内容过于复杂",
+        "忽略 placeholder"
+    ],
+    "interpretivePriority": {
+        "principle": "**需求模板接口 `pickerProps: any` 与本组件 §D 协议推荐 Omit<...> 冲突时,严格按需求接口签名(api.ts §D-bis 兼容路径)**",
+        "reason": "需求接口(requirements/*.json)是观察者制定的固定 spec · 优化 AI 无权改;§D 协议 Omit<...> 是组件库的安全推荐 · sub-agent 不应擅自改需求接口签名;但 anti-pattern any 接口在运行时仍需保护受控状态 → 通过 JSX spread 顺序(受控 prop 写在 spread 之后)实现",
+        "resolution": "1. 接口签名照搬需求 `pickerProps: any`(不改) ;2. JSX 写法严格遵 §D 协议(`{...pickerProps} value={...} onChange={...} multiple` — 受控 prop 后写覆盖) ;3. 类型安全靠运行时 spread 顺序,不靠类型层面阻断;详见 api.ts §D-bis 完整代码示例",
+        "dataSourceDecisionTree": "data 来源根据需求接口字段决定:(1)接口含 data prop → 直接 selectorProps={{data}} 透传;(2)接口不含 data 字段,只有 pickerProps → 候选数据从 pickerProps.selectorProps.data 透传(`selectorProps={{ ...(pickerProps?.selectorProps ?? {}) }}`),封装层不内置;(3)需求语义为内置固定数据(如部门选择) → 封装层 const data = [...] 然后 selectorProps={{data}};详见 api.ts §D-ter",
+        "antiPatterns": [
+            "❌ 看到需求接口 `pickerProps: any` 后,擅自改为 Omit<...> 违背需求 spec",
+            "❌ 接口写 any,JSX 把 spread 放在受控 prop 之后(`<SelectorPicker value={...} onChange={...} {...pickerProps} />` — 外部 pickerProps 覆盖受控状态)",
+            "❌ 二次封装时,封装层 hardcode 候选数据而不查需求接口字段(需求接口若含 data prop 应透传,不应硬编码)"
+        ],
+        "correctPatterns": [
+            "✅ 接口签名 `pickerProps: any`(照搬需求) + JSX `<SelectorPicker {...pickerProps} value={...} onChange={...} multiple selectorProps={{ data }} />`(受控后写覆盖)",
+            "✅ 看需求接口:若有 data prop → `selectorProps={{ data }}`;若无 data 字段但有 pickerProps → `selectorProps={{ ...(pickerProps?.selectorProps ?? {}) }}`(透传外部数据);若需求要求'内置部门列表'业务语义 → 封装层 const data = [...] hardcode"
+        ]
+    },
+    "events": {
+        "onChange": {
+            "signature": "(val: Record<string,any>[] | Record<string,any> | null, node: Record<string,any>, rowData: Record<string,any>) => void",
+            "asyncSupported": false,
+            "examples": [
+                "单选时 val 是单对象，多选时 val 是对象数组，清空时 val 是 null",
+                "受控外部 string[] 场景：onChange={(val) => setIds(val ? (Array.isArray(val) ? val : [val]).map(it => it[rowKey]) : [])}",
+                "清空时兜底：setIds((val ?? []) instanceof Array ? val.map(it => it.key) : [])"
+            ],
+            "commonMistakes": [
+                "清空时期望 val 是 [] 而非 null——清空时 val=null，需 ?? [] 兜底",
+                "multiple=false 期望 val 是数组——单选 val 是单对象，需按模式分支处理",
+                "忽略第二三参 node/rowData——node 是内部处理后的数据，rowData 是原始数据，两者都是对象 Map（key=rowKey）"
+            ]
+        },
+        "onClear": {
+            "signature": "() => void",
+            "asyncSupported": false,
+            "examples": [
+                "用户点击清除按钮时先触发 onClear，再触发 onChange(null, {}, {})",
+                "受控场景需同时监听 onClear 和 onChange 才能完整捕获清空"
+            ],
+            "commonMistakes": [
+                "只监听 onClear 而不监听 onChange——受控 value 不会自动清空，需在 onChange 里同步 state",
+                "allowClear=false 时期望 onClear 触发——allowClear=false 不显示清除按钮，onClear 不会触发"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "selectorProps 透传了已被 SelectorPicker 接管的字段（如 layout/disabled/value/onChange/selectMode），TypeScript 报 Omit 类型错误",
+            "wrong": "selectorProps={{ layout: 'lr', value: [...], onChange: handler }}  // 这些字段已 Omit",
+            "right": "selectorProps={{ data: [...], rowKey: 'id', fieldConfig: { mainTitle: 'name' } }}  // 只传未 Omit 的字段"
+        },
+        {
+            "issue": "multiple=true 时 value 传单对象而非数组，受控不生效",
+            "wrong": "multiple={true} value={{ key: '1' }}  // multiple 时 value 必须是 Record<string,any>[]",
+            "right": "multiple={true} value={[{ key: '1' }]}  // 数组包裹"
+        },
+        {
+            "issue": "selectorProps 传 data 字段名拼错（如 list/items），候选数据静默失败",
+            "wrong": "selectorProps={{ list: myData }}  // Selector 内部读 data，不读 list",
+            "right": "selectorProps={{ data: myData }}  // Selector prop 名是 data"
+        }
+    ],
+    "mapping": {
+        "realComponent": "SelectorPicker",
+        "adapter": null
+    }
+}

package/lib/SelectorPicker/index.d.ts

@@ -31,15 +31,15 @@ export interface SelectorPickerProps extends HelperTextDetailProps {
     /** 支持清除 */
     allowClear?: boolean;
     /** 值 */
-    value?: Record<string, any>[] | Record<string, any>;
+    value?: Record<string, unknown>[] | Record<string, unknown>;
     /** 默认值 不受控 */
-    defaultValue?: Record<string, any>[] | Record<string, any>;
+    defaultValue?: Record<string, unknown>[] | Record<string, unknown>;
     /** 自定义tag内容 */
-    tagRender?: (item: any) => ReactNode;
+    tagRender?: (item: Record<string, unknown>) => ReactNode;
     /** 清除回调 */
     onClear?: () => void;
     /** 改变事件 val绑定值, node处理过的数据 rowData原始数据 */
-    onChange?: (val: Record<string, any>[] | Record<string, any> | null, node: Record<string, any>, rowData: Record<string, any>) => void;
+    onChange?: (val: Record<string, unknown>[] | Record<string, unknown> | null, node: Record<string, unknown>, rowData: Record<string, unknown>) => void;
     /** 选择器属性 */
     selectorProps?: Omit<SelectorProps, 'layout' | 'disabled' | 'value' | 'defaultValue' | 'disabled' | 'onChange' | 'selectMode'>;
     /** 浮层渲染容器 */
@@ -48,7 +48,7 @@ export interface SelectorPickerProps extends HelperTextDetailProps {
     morePopoverClassName?: string;
     /** 下拉框className */
     overlayClassName?: string;
-    [name: string]: any;
+    [name: string]: unknown;
 }
 declare const SelectorPicker: React.FC<SelectorPickerProps>;
 export default SelectorPicker;

package/lib/SelectorPicker/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const r=require("../_virtual/jsx-runtime.js"),o=require("react"),J=require("clsx"),$e=require("../HelperText/index.js"),be=require("../Label/index.js"),we=require("../Dropdown/index.js"),Q=require("../Selector/index.js"),y=require("../AutoTips/index.js"),Ne=require("../Popover/index.js"),Pe=require("../node_modules/@para-ui/icons/CloseCircleF/index.js"),ye=require("../node_modules/@para-ui/icons/Down/index.js"),U=require("../node_modules/@para-ui/icons/Close/index.js"),i=require("../GlobalContext/constant.js"),Te=require("../GlobalContext/useFormatMessage.js"),qe=require("./lang/index.js"),Se=require("../Tooltip/index.js");;/* empty css            */const Me=v=>{const T=Te.default("SelectorPicker",qe.default),{className:X,label:q,value:k,defaultValue:$,required:S=!1,labelTooltip:Y,error:M=!1,hideErrorDom:Z,helperText:ee,size:C="large",disabled:a=!1,disabledTooltip:V,style:re,placeholder:te=T("select"),multiple:m=!1,allowClear:D=!1,overLine:f=!1,selectorProps:_,onChange:z,onClear:se,tagRender:u,morePopoverClassName:H,getPopupContainer:ne,overlayClassName:le}=v,p={...Q.handFieldConfig(v.selectorProps?.fieldConfig,v.selectorProps?.rowKey||"key"),...v.selectorProps?.backDataFieldConfig},[L,oe]=o.useState($||[]),[F,E]=o.useState(!1),[O,A]=o.useState(!1),[c,b]=o.useState(null),h=o.useRef(null),t=o.useRef({list:[]}),l=`${i.$prefixCls}-selector-picker`;t.current.value=k,t.current.valueCom=L,t.current.openMore=O;const K=()=>t.current.value!==void 0?t.current.value:t.current.valueCom,ce=()=>{const e=K();let s=e?[e]:[];return e instanceof Array&&(s=[...e]),s};t.current.list=ce(),o.useEffect(()=>(!f&&m?window.addEventListener("resize",g):window.removeEventListener("resize",g),()=>{window.removeEventListener("resize",g)}),[f,m]),o.useEffect(()=>(g(),()=>{clearTimeout(t.current.resizeTimer)}),[L,k]);const W=e=>{if(e===null||e===0)return;e===void 0&&(e=t.current.list.length);const s=h.current;if(!s)return;const n=s.querySelector(".selector-picker-wrapper-content-check");if(n)if(n.scrollHeight>n.clientHeight){const j=Number(e)-1;b(j),W(j)}else t.current.list.length<=e&&G()},g=()=>{if(t.current.list.length===0)return b(null);clearTimeout(t.current.resizeTimer),t.current.resizeTimer=setTimeout(()=>{b(t.current.list.length),W()},50)},B=(e,s,n)=>{n.stopPropagation(),t.current.list.splice(s,1),w([...t.current.list],{},{})},w=(e,s,n)=>{z&&z(e,s,n),m||E(!1),k===void 0&&oe(e||[])},ie=()=>{if(q||S)return r.jsxRuntimeExports.jsx(be.default,{label:q,required:S,...Y})},ae=()=>{const e=()=>({layout:"list",disabled:a,selectMode:m?"check":"radio",value:K(),defaultValue:$,onChange:w,..._});return r.jsxRuntimeExports.jsx("div",{className:`selector-picker-dropdown-content ${i.$prefixCls}-scrollbar-small`,style:{width:`${h&&h.current?h.current.offsetWidth:0}px`},children:r.jsxRuntimeExports.jsx(Q.default,{...e()})})},ue=e=>{e.stopPropagation(),A(!0),E(!1)},G=()=>{t.current.openMore&&A(!1)},pe=e=>{e.stopPropagation(),E(!1),se?.(),w(null,{},{})},de=e=>{a||E(e)},xe=()=>{if(m)return r.jsxRuntimeExports.jsxs("div",{className:"selector-picker-wrapper-content-check",children:[t.current.list.map((d,x)=>{if(c!==null&&c<=x)return null;const N=p.mainTitle||"",Ee=p.key||"",ge=d[N]||d[Ee],Re=u&&u(d);let P=!0;return a===!0&&(P=!1),r.jsxRuntimeExports.jsxs("div",{className:P?"check-select-content-item":"check-select-content-item check-select-content-item-noclose",children:[r.jsxRuntimeExports.jsx("span",{children:r.jsxRuntimeExports.jsx(y.default,{placement:"top-start",children:Re||ge})}),P&&r.jsxRuntimeExports.jsx(U.Close,{onClick:ke=>B?.(d,x,ke)})]},x)}),(()=>{if(c!==null&&t.current.list.length>c)return r.jsxRuntimeExports.jsx("div",{className:"check-select-content-item check-select-content-item-more",onClick:ue,children:r.jsxRuntimeExports.jsxs("span",{children:["+",t.current.list.length-c]})})})()]});const e=p.mainTitle||"",s=p.key||"",n=t.current.list[0]?.[e]||t.current.list[0]?.[s],R=u&&u(t.current.list[0])||n;return r.jsxRuntimeExports.jsx("div",{className:"selector-picker-wrapper-content-radio",children:f?R:r.jsxRuntimeExports.jsx(y.default,{placement:"top-start",children:R})})},me=()=>t.current.list.length?r.jsxRuntimeExports.jsx("div",{className:"selector-picker-wrapper-content",children:xe()}):null,fe=()=>r.jsxRuntimeExports.jsxs("div",{className:"selector-picker-wrapper",children:[me(),!t.current.list.length&&r.jsxRuntimeExports.jsx("span",{className:"selector-picker-placeholder",children:te}),r.jsxRuntimeExports.jsx("span",{className:"selector-picker-arrow",children:r.jsxRuntimeExports.jsx(ye.Down,{})}),D&&t.current.list.length&&!a?r.jsxRuntimeExports.jsx("span",{className:"selector-picker-clear",onClick:pe,children:r.jsxRuntimeExports.jsx(Pe.CloseCircleF,{})}):null]}),he=()=>r.jsxRuntimeExports.jsxs("div",{className:"select-more",children:[r.jsxRuntimeExports.jsx("div",{className:"select-more-title",children:r.jsxRuntimeExports.jsx("span",{children:T({id:"more"})})}),r.jsxRuntimeExports.jsx("div",{className:"select-more-content",children:t.current.list.map((e,s)=>{if(c!==null&&c>s)return null;const n=p.mainTitle||"",j=p.key||"",R=e[n]||e[j],d=u&&u(e);let x=!0;return a===!0&&(x=!1),r.jsxRuntimeExports.jsxs("div",{className:"select-more-content-item",children:[r.jsxRuntimeExports.jsx("span",{children:r.jsxRuntimeExports.jsx(y.default,{placement:"top-start",children:d||R})}),x&&r.jsxRuntimeExports.jsx(U.Close,{onClick:N=>B?.(e,s,N)})]},s)})})]}),je=()=>{let e=`${i.$prefixCls}-selector-more-popover ${i.$prefixCls}-scrollbar-small`;return C&&(e+=` ${i.$prefixCls}-selector-more-popover-${C}`),H&&(e+=` ${H}`),e},I=()=>r.jsxRuntimeExports.jsx(Ne.Popover,{placement:"rightTop",visible:O,content:he(),onVisibleChange:G,overlayClassName:je(),children:fe()}),ve=()=>r.jsxRuntimeExports.jsx(we.Dropdown,{visible:F,destroyPopupOnHide:!0,overlay:ae(),placement:"bottomLeft",trigger:["click"],onVisibleChange:de,overlayClassName:J(`${i.$prefixCls}-selector-picker-dropdown`,le,{[`${i.$prefixCls}-selector-picker-dropdown-search`]:_?.search}),getPopupContainer:ne,children:V?r.jsxRuntimeExports.jsx(Se.Tooltip,{disabled:!0,...V,children:I()}):I()}),Ce=()=>J(l,X,{[`${l}-focused`]:F,[`${l}-disabled`]:a,[`${l}-error`]:M,[`${l}-clear`]:D&&t.current.list.length,[`${l}-${C}`]:C,[`${l}-wrap`]:f,[`${l}-nowrap`]:!f});return r.jsxRuntimeExports.jsxs("div",{className:Ce(),style:re,ref:h,children:[ie(),ve(),r.jsxRuntimeExports.jsx($e.default,{error:M,helperText:ee,hideErrorDom:Z})]})};exports.default=Me;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const r=require("../_virtual/jsx-runtime.js"),o=require("react"),J=require("clsx"),$e=require("../HelperText/index.js"),be=require("../Label/index.js"),we=require("../Dropdown/index.js"),Q=require("../Selector/index.js"),P=require("../AutoTips/index.js"),ye=require("../Popover/index.js"),Ne=require("../node_modules/@para-ui/icons/CloseCircleF/index.js"),Pe=require("../node_modules/@para-ui/icons/Down/index.js"),U=require("../node_modules/@para-ui/icons/Close/index.js"),i=require("../GlobalContext/constant.js"),Te=require("../GlobalContext/useFormatMessage.js"),qe=require("./lang/index.js"),Se=require("../Tooltip/index.js");;/* empty css            */const Me=v=>{const T=Te.default("SelectorPicker",qe.default),{className:X,label:q,value:k,defaultValue:$,required:S=!1,labelTooltip:Y,error:M=!1,hideErrorDom:Z,helperText:ee,size:C="large",disabled:a=!1,disabledTooltip:V,style:re,placeholder:te=T("select"),multiple:m=!1,allowClear:D=!1,overLine:f=!1,selectorProps:_,onChange:z,onClear:se,tagRender:u,morePopoverClassName:H,getPopupContainer:ne,overlayClassName:le}=v,p={...Q.handFieldConfig(v.selectorProps?.fieldConfig,v.selectorProps?.rowKey||"key"),...v.selectorProps?.backDataFieldConfig},[L,oe]=o.useState($||[]),[A,E]=o.useState(!1),[F,O]=o.useState(!1),[c,b]=o.useState(null),h=o.useRef(null),t=o.useRef({list:[]}),l=`${i.$prefixCls}-selector-picker`;t.current.value=k,t.current.valueCom=L,t.current.openMore=F;const K=()=>t.current.value!==void 0?t.current.value:t.current.valueCom,ce=()=>{const e=K();let s=e?Array.isArray(e)?e:[e]:[];return e instanceof Array&&(s=[...e]),s};t.current.list=ce(),o.useEffect(()=>(!f&&m?window.addEventListener("resize",g):window.removeEventListener("resize",g),()=>{window.removeEventListener("resize",g)}),[f,m]),o.useEffect(()=>(g(),()=>{clearTimeout(t.current.resizeTimer)}),[L,k]);const W=e=>{if(e===null||e===0)return;e===void 0&&(e=t.current.list.length);const s=h.current;if(!s)return;const n=s.querySelector(".selector-picker-wrapper-content-check");if(n)if(n.scrollHeight>n.clientHeight){const j=Number(e)-1;b(j),W(j)}else t.current.list.length<=e&&G()},g=()=>{if(t.current.list.length===0)return b(null);clearTimeout(t.current.resizeTimer),t.current.resizeTimer=setTimeout(()=>{b(t.current.list.length),W()},50)},B=(e,s,n)=>{n.stopPropagation(),t.current.list.splice(s,1),w([...t.current.list],{},{})},w=(e,s,n)=>{z&&z(e,s,n),m||E(!1),k===void 0&&oe(e||[])},ie=()=>{if(q||S)return r.jsxRuntimeExports.jsx(be.default,{label:q,required:S,...Y})},ae=()=>{const e=()=>({layout:"list",disabled:a,selectMode:m?"check":"radio",value:K(),defaultValue:$,onChange:w,..._});return r.jsxRuntimeExports.jsx("div",{className:`selector-picker-dropdown-content ${i.$prefixCls}-scrollbar-small`,style:{width:`${h&&h.current?h.current.offsetWidth:0}px`},children:r.jsxRuntimeExports.jsx(Q.default,{...e()})})},ue=e=>{e.stopPropagation(),O(!0),E(!1)},G=()=>{t.current.openMore&&O(!1)},pe=e=>{e.stopPropagation(),E(!1),se?.(),w(null,{},{})},de=e=>{a||E(e)},xe=()=>{if(m)return r.jsxRuntimeExports.jsxs("div",{className:"selector-picker-wrapper-content-check",children:[t.current.list.map((d,x)=>{if(c!==null&&c<=x)return null;const y=p.mainTitle||"",Ee=p.key||"",ge=d[y]||d[Ee],Re=u&&u(d);let N=!0;return a===!0&&(N=!1),r.jsxRuntimeExports.jsxs("div",{className:N?"check-select-content-item":"check-select-content-item check-select-content-item-noclose",children:[r.jsxRuntimeExports.jsx("span",{children:r.jsxRuntimeExports.jsx(P.default,{placement:"top-start",children:Re||ge})}),N&&r.jsxRuntimeExports.jsx(U.Close,{onClick:ke=>B?.(d,x,ke)})]},x)}),(()=>{if(c!==null&&t.current.list.length>c)return r.jsxRuntimeExports.jsx("div",{className:"check-select-content-item check-select-content-item-more",onClick:ue,children:r.jsxRuntimeExports.jsxs("span",{children:["+",t.current.list.length-c]})})})()]});const e=p.mainTitle||"",s=p.key||"",n=t.current.list[0]?.[e]||t.current.list[0]?.[s],R=u&&u(t.current.list[0])||n;return r.jsxRuntimeExports.jsx("div",{className:"selector-picker-wrapper-content-radio",children:f?R:r.jsxRuntimeExports.jsx(P.default,{placement:"top-start",children:R})})},me=()=>t.current.list.length?r.jsxRuntimeExports.jsx("div",{className:"selector-picker-wrapper-content",children:xe()}):null,fe=()=>r.jsxRuntimeExports.jsxs("div",{className:"selector-picker-wrapper",children:[me(),!t.current.list.length&&r.jsxRuntimeExports.jsx("span",{className:"selector-picker-placeholder",children:te}),r.jsxRuntimeExports.jsx("span",{className:"selector-picker-arrow",children:r.jsxRuntimeExports.jsx(Pe.Down,{})}),D&&t.current.list.length&&!a?r.jsxRuntimeExports.jsx("span",{className:"selector-picker-clear",onClick:pe,children:r.jsxRuntimeExports.jsx(Ne.CloseCircleF,{})}):null]}),he=()=>r.jsxRuntimeExports.jsxs("div",{className:"select-more",children:[r.jsxRuntimeExports.jsx("div",{className:"select-more-title",children:r.jsxRuntimeExports.jsx("span",{children:T({id:"more"})})}),r.jsxRuntimeExports.jsx("div",{className:"select-more-content",children:t.current.list.map((e,s)=>{if(c!==null&&c>s)return null;const n=p.mainTitle||"",j=p.key||"",R=e[n]||e[j],d=u&&u(e);let x=!0;return a===!0&&(x=!1),r.jsxRuntimeExports.jsxs("div",{className:"select-more-content-item",children:[r.jsxRuntimeExports.jsx("span",{children:r.jsxRuntimeExports.jsx(P.default,{placement:"top-start",children:d||R})}),x&&r.jsxRuntimeExports.jsx(U.Close,{onClick:y=>B?.(e,s,y)})]},s)})})]}),je=()=>{let e=`${i.$prefixCls}-selector-more-popover ${i.$prefixCls}-scrollbar-small`;return C&&(e+=` ${i.$prefixCls}-selector-more-popover-${C}`),H&&(e+=` ${H}`),e},I=()=>r.jsxRuntimeExports.jsx(ye.Popover,{placement:"rightTop",visible:F,content:he(),onVisibleChange:G,overlayClassName:je(),children:fe()}),ve=()=>r.jsxRuntimeExports.jsx(we.Dropdown,{visible:A,destroyPopupOnHide:!0,overlay:ae(),placement:"bottomLeft",trigger:["click"],onVisibleChange:de,overlayClassName:J(`${i.$prefixCls}-selector-picker-dropdown`,le,{[`${i.$prefixCls}-selector-picker-dropdown-search`]:_?.search}),getPopupContainer:ne,children:V?r.jsxRuntimeExports.jsx(Se.Tooltip,{disabled:!0,...V,children:I()}):I()}),Ce=()=>J(l,X,{[`${l}-focused`]:A,[`${l}-disabled`]:a,[`${l}-error`]:M,[`${l}-clear`]:D&&t.current.list.length,[`${l}-${C}`]:C,[`${l}-wrap`]:f,[`${l}-nowrap`]:!f});return r.jsxRuntimeExports.jsxs("div",{className:Ce(),style:re,ref:h,children:[ie(),ve(),r.jsxRuntimeExports.jsx($e.default,{error:M,helperText:ee,hideErrorDom:Z})]})};exports.default=Me;
 //# sourceMappingURL=index.js.map

package/lib/SingleBox/component.json

@@ -0,0 +1,151 @@
+{
+    "name": "SingleBox",
+    "category": "Data Entry",
+    "description": "逐行多值列表输入框(每行一个值,整体以 string[] 数组收集 · 支持自动补全)",
+    "semantic": {
+        "intent": [
+            "多值列表输入(逐行)",
+            "标签集合录入",
+            "自动补全"
+        ],
+        "useCases": [
+            "多关键词输入(每行一个)",
+            "标签批量录入",
+            "多值配置项"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "default": {
+            "meaning": "默认样式"
+        }
+    },
+    "states": [
+        "default",
+        "disabled",
+        "error"
+    ],
+    "idealProps": {
+        "value": {
+            "type": "array",
+            "itemType": "string",
+            "description": "受控值 string[],与 defaultValue 互斥(必须配合 onChange 同步)。**业务 string 单值桥接**(协议 SB1):`value={s ? [s] : []}`;**value=[] 行为**(协议 SB2):自动渲染一个空 input 行"
+        },
+        "defaultValue": {
+            "type": "array",
+            "itemType": "string",
+            "description": "非受控默认值,与 value 互斥,仅首次 mount 生效"
+        },
+        "onChange": {
+            "type": "function",
+            "signature": "(val: string[]) => void",
+            "description": "值变更回调,val 是当前所有行的完整数组快照。**业务 string 单值桥接**(协议 SB1):`(val) => setKeyword(val[0] ?? '')`;**val 永远至少 [''])**(协议 SB3);**disabled+受控**仍需传 onChange(空函数避免 warning)"
+        },
+        "fetchSuggestions": {
+            "type": "function",
+            "signature": "(val: string, cb: (data: any[]) => void) => void",
+            "description": "自动补全数据源,存在时每行 input 启用联想。cb 数据可为 string[](直接显示)或 {label, value}[](按 label 显示)"
+        },
+        "size": {
+            "type": "enum",
+            "values": [
+                "small",
+                "medium",
+                "large"
+            ],
+            "default": "large",
+            "description": "控件大小"
+        },
+        "disabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "禁用整组输入,可配合 disabledTooltip 解释原因"
+        },
+        "required": {
+            "type": "boolean",
+            "default": false,
+            "description": "必填(透传到 Label 显示星号)"
+        },
+        "label": {
+            "type": "ReactNode",
+            "description": "标题"
+        },
+        "placeholder": {
+            "type": "ReactNode",
+            "description": "每行 input 占位"
+        },
+        "helperText": {
+            "type": "ReactNode | ReactNode[]",
+            "description": "错误文本,单值=所有行共享;数组=按行下标对应,空串项表示该行无错"
+        },
+        "disabledTooltip": {
+            "type": "TooltipProps",
+            "description": "禁用态下添加按钮的 tooltip 配置(仅 disabled=true 时生效)"
+        },
+        "otherProps": {
+            "type": "(index: number, val: string) => TextFieldProps",
+            "description": "每行 TextField 的额外 props;index 是行下标(0-based),返回对象展开到该行 TextField"
+        }
+    },
+    "crossPropInteractions": [
+        "value=[] / [''] = 渲染一个空 input 行(自动归一化)",
+        "业务 string ↔ SingleBox string[] 桥接 = 入站 [s] + 出站 val[0] ?? ''(协议 SB1)",
+        "disabled=true = 隐藏添加/删除按钮 + 所有 input 只读;受控仍需传 onChange",
+        "helperText[] 按行下标对应 + value[] 行数 = 错误信息可逐行显示",
+        "fetchSuggestions + otherProps = 联想 + 按行定制(如某行 maxLength)"
+    ],
+    "commonMisconceptions": [
+        "❌ SingleBox 是单值输入框 — 实际 value 是 string[](多行)",
+        "❌ value=[] 不显示输入框 — 自动渲染一个空 input 行",
+        "❌ 删除所有行后 onChange 给 [] — 实际最少 [''](组件保留一行)",
+        "❌ disabled+受控可省略 onChange — 仍需传(空函数)避免 React warning",
+        "❌ 业务 string 直接传 value — 必须 [s] 包装,onChange 取 val[0]"
+    ],
+    "do": [
+        "支持自动完成",
+        "提供建议列表",
+        "业务单值场景用 [s] 包装 value + (val) => val[0] ?? '' 出站桥接"
+    ],
+    "dont": [
+        "建议列表过长",
+        "忽略去重",
+        "把 SingleBox 当单值 TextField 用(它是多值列表,建议用 TextField)"
+    ],
+    "events": {
+        "onChange": {
+            "signature": "(val: string[]) => void",
+            "asyncSupported": false,
+            "examples": [
+                "val 是所有行当前值的完整数组快照，如 ['keyword1', 'keyword2', '']",
+                "业务单值桥接：onChange={(val) => setSingleKeyword(val[0] ?? '')}",
+                "删除最后一行后 val 仍是 ['']（保留至少一行空 input）"
+            ],
+            "commonMistakes": [
+                "期望删除所有行后 onChange 返回 [] ——组件保留最少一行，val 永远是 [''] 或更多",
+                "disabled+受控时省略 onChange——仍需传（可传空函数）否则 React 报 prop 变化 warning",
+                "业务 string 直接传 value——必须 [s] 包装，onChange 取 val[0] ?? ''"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "value 类型是 string[]，传单个 string 报 TS 类型不兼容",
+            "wrong": "value={keyword}  // keyword: string，TS 报不兼容 string[]",
+            "right": "value={keyword ? [keyword] : ['']}  // 桥接：string → string[]"
+        },
+        {
+            "issue": "helperText 传数组时数组下标必须与 value 数组行数对齐",
+            "wrong": "value={['a','b']} helperText={['err0']}  // 仅第 0 行报错，第 1 行错误无文案但不会静默",
+            "right": "value={['a','b']} helperText={['err0', 'err1']}  // 按行下标一一对应"
+        },
+        {
+            "issue": "otherProps 函数需要返回完整 TextFieldProps 对象，类型不对会扩散到每行 TextField",
+            "wrong": "otherProps={(i) => i === 0 ? { maxLength: 10 } : null}  // null 不满足 TextFieldProps",
+            "right": "otherProps={(i) => i === 0 ? { maxLength: 10 } : {}}  // 非目标行返回空对象"
+        }
+    ],
+    "mapping": {
+        "realComponent": "SingleBox",
+        "adapter": null
+    }
+}

package/lib/SingleBox/index.d.ts

@@ -37,10 +37,10 @@ export interface SingleBoxProps extends HelperTextDetailProps {
     /** 改变值 */
     onChange?: (val: string[]) => void;
     /** 匹配 */
-    fetchSuggestions?: (val: string, cb: (data: any[]) => void) => void;
+    fetchSuggestions?: (val: string, cb: (data: Record<string, unknown>[]) => void) => void;
     /** 输入框其他参数 */
     otherProps?: (index: number, val: string) => TextFieldProps;
-    [name: string]: any;
+    [name: string]: unknown;
 }
 export declare const SingleBox: FunctionComponent<SingleBoxProps>;
 export default SingleBox;