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

package/es/Selector/index.js

@@ -3,7 +3,8 @@ import { useState as g, useRef as ur, useEffect as L } from "react";
 import ir from "./selectorMain/index.js";
 import lr from "./selectorData/index.js";
 import { reqFunc as ke } from "./util.js";
-import { Cancel as fr, ArrayToObject as dr } from "@paraview/lib";
+import { Cancel as fr } from "@snack-kit/lib";
+import { ArrayToObject as dr } from "../Utils/snack-kit-shims.js";
 import hr from "../Hooks/useGlobalProps.js";
 import mr from "../GlobalContext/useFormatMessage.js";
 import { $prefixCls as B } from "../GlobalContext/constant.js";
@@ -17,7 +18,7 @@ const Cr = (c, x) => ({
   key: x,
   type: "type",
   ...c
-}), zr = (c) => {
+}), Vr = (c) => {
   const {
     className: x,
     style: X,
@@ -33,15 +34,15 @@ const Cr = (c, x) => ({
     defaultValue: re,
     data: J,
     pagination: je = !1,
-    size: M = 10,
+    size: A = 10,
     isLazy: ae = !1,
-    isAllCheck: ve = !0,
+    isAllCheck: Ie = !0,
     disabled: y,
-    disabledChild: Pe,
+    disabledChild: ve,
     detail: F,
     detailRender: te,
-    backDataFieldConfig: Te,
-    search: Ie,
+    backDataFieldConfig: Pe,
+    search: Te,
     searchPlaceholder: ze,
     searchTrigger: Ve = "onChange",
     breadcrumbs: Re = !0,
@@ -52,16 +53,16 @@ const Cr = (c, x) => ({
     groupRange: xe = "search",
     emptyProps: se,
     selectRenderItem: He,
-    selectRender: Me,
+    selectRender: Ae,
     onChange: oe,
     onSelect: w,
     onSearch: ue,
     onRefresh: O,
     error: ie = !1,
     hideErrorDom: we = !0,
-    helperText: Ae = "",
+    helperText: Me = "",
     mainHeader: _e
-  } = hr(c, "Selector"), le = mr("Selector", gr), C = Cr(c.fieldConfig, k), D = { ...C, ...Te }, [fe, A] = g([]), [Ne, _] = g(!1), [v, $e] = g([]), [de, Je] = g({}), [P, S] = g([]), [Fe, T] = g(!1), [Ee, he] = g({ val: "" }), [Oe, K] = g([]), [Ke, me] = g(!1), [Ge, I] = g(!0), [Qe, ge] = g(), e = ur({
+  } = hr(c, "Selector"), le = mr("Selector", gr), C = Cr(c.fieldConfig, k), D = { ...C, ...Pe }, [fe, M] = g([]), [Ne, _] = g(!1), [I, $e] = g([]), [de, Je] = g({}), [v, S] = g([]), [Fe, P] = g(!1), [Ee, he] = g({ val: "" }), [Oe, K] = g([]), [Ke, me] = g(!1), [Ge, T] = g(!0), [Qe, ge] = g(), e = ur({
     /** 对象集合 所有的 */
     jsonData: {},
     /** 浅拷贝对象 所有的 */
@@ -75,10 +76,10 @@ const Cr = (c, x) => ({
     /** 面包屑数据 带根/搜索 */
     breadcrumbsList: [],
     /** 接口id */
-    reqId: Math.random().toString(),
+    reqId: "",
     /** 请求数据 */
     reqParams: {
-      size: M,
+      size: A,
       pagination: !1,
       isLazy: !1
     },
@@ -95,13 +96,13 @@ const Cr = (c, x) => ({
     /** 搜索配置 */
     searchConfig: {
       page: 1,
-      size: M,
-      reqId: Math.random().toString(),
+      size: A,
+      reqId: "",
       /** 当前页数据源 本地数据为当前页所有的数据,请求数据为当前展示的数据 */
       currentSourceData: []
     }
   });
-  e.current.searchConfig.size = M, e.current.reqParams.size = M, e.current.reqParams.pagination = je, e.current.reqParams.isLazy = ae;
+  e.current.searchConfig.size = A, e.current.reqParams.size = A, e.current.reqParams.pagination = je, e.current.reqParams.isLazy = ae;
   const z = c.data || !e.current.reqParams.isLazy && e.current.noLazyReq;
   L(() => (re !== void 0 && Q(re), () => {
     e.current.reqTimer && clearTimeout(e.current.reqTimer);
@@ -123,17 +124,19 @@ const Cr = (c, x) => ({
             0,
             e.current.page * e.current.reqParams.size
           );
-          A(t), e.current.page * e.current.reqParams.size >= r.length ? _(!1) : _(!0);
+          M(t), e.current.page * e.current.reqParams.size >= r.length ? _(!1) : _(!0);
         } else
-          A(r);
-        I(!1);
+          M(r);
+        T(!1);
       }
       if (c.url) {
         const r = {
           method: ee,
           url: c.url,
           ctx: Z,
-          uuid: e.current.reqId,
+          onCancelId: (t) => {
+            e.current.reqId = t;
+          },
           data: {
             parentId: be(),
             ...c.params
@@ -190,27 +193,27 @@ const Cr = (c, x) => ({
     let r;
     return e.current.breadcrumbsList.length > 0 ? r = e.current.breadcrumbsList[e.current.breadcrumbsList.length - 1].value : c.breadcrumbsHead && (r = c.breadcrumbsHead.value), ne && e.current.breadcrumbsList.length === 1 && (r = void 0, c.breadcrumbsHead && (r = c.breadcrumbsHead.value)), r;
   }, Ce = async (r) => {
-    I(!0);
-    const { data: t, err: a } = await ke(r);
+    T(!0);
+    const { data: t, error: a } = await ke(r);
     if (a) {
-      I(!1), e.current.reqParams.isLazy && e.current.reqParams.pagination && e.current.page !== 1 && (e.current.page = e.current.page - 1);
+      T(!1), e.current.reqParams.isLazy && e.current.reqParams.pagination && e.current.page !== 1 && (e.current.page = e.current.page - 1);
       return;
     }
     if (c.requestCallback) {
       c.requestCallback(t, (n) => {
-        I(!1), ye(n);
+        T(!1), ye(n);
       });
       return;
     }
-    I(!1), ye(t);
+    T(!1), ye(t);
   }, ye = (r) => {
     if (e.current.reqParams.isLazy)
       if (e.current.reqParams.pagination) {
         const t = r.data || {}, a = t.list || [], n = t.total, s = q(a, !0), o = [...e.current.currentSourceData, ...s];
-        e.current.currentSourceData = o, A(o), e.current.page * e.current.reqParams.size >= n ? _(!1) : _(!0);
+        e.current.currentSourceData = o, M(o), e.current.page * e.current.reqParams.size >= n ? _(!1) : _(!0);
       } else {
         const t = r.data || [], a = q(t, !0);
-        e.current.currentSourceData = a, A(a);
+        e.current.currentSourceData = a, M(a);
       }
     else {
       e.current.noLazyReq = !0;
@@ -220,13 +223,13 @@ const Cr = (c, x) => ({
   }, p = () => {
     e.current.page = 1, ge(Math.random());
   }, Q = (r) => {
-    let t = r ? [r] : [];
+    let t = r ? Array.isArray(r) ? r : [r] : [];
     r instanceof Array && (t = [...r]);
     const a = dr(D.key, t);
     e.current.selectValueJson = a, Je(a), $e([...t]);
   }, We = (r, t) => {
-    let a = [...P];
-    t && (a = [], e.current.beforeSearchBreadcrumbs === null && (e.current.beforeSearchBreadcrumbs = [...P])), a.push({
+    let a = [...v];
+    t && (a = [], e.current.beforeSearchBreadcrumbs === null && (e.current.beforeSearchBreadcrumbs = [...v])), a.push({
       label: r.mainTitle,
       value: r.key || ""
     }), S(a);
@@ -254,8 +257,8 @@ const Cr = (c, x) => ({
       }
       if (b === "check") {
         const n = [], s = {}, o = {};
-        for (let u = 0, d = v.length; u < d; u++) {
-          const l = v[u];
+        for (let u = 0, d = I.length; u < d; u++) {
+          const l = I[u];
           if (!a || r.key !== l[D.key]) {
             const i = l[D.key] || "";
             s[i] = e.current.jsonData[i], o[i] = e.current.jsonDataCopy[i], n.push(l);
@@ -269,7 +272,7 @@ const Cr = (c, x) => ({
       }
     }
   }, Ze = (r) => !!(y && (y === !0 || y instanceof Array && r.key && y.indexOf(r.key) !== -1) || r.disabled), er = async (r) => {
-    const t = [...fe], a = [...v], n = [], s = {}, o = {}, u = [], d = [];
+    const t = [...fe], a = [...I], n = [], s = {}, o = {}, u = [], d = [];
     for (let i = 0, m = t.length; i < m; i++) {
       const f = t[i], h = f.key || "";
       Ze(f) || (r ? e.current.selectValueJson[h] || (a.push(U(f)), d.push(f)) : e.current.selectValueJson[h] && (u.push(h), d.push(f)));
@@ -287,7 +290,7 @@ const Cr = (c, x) => ({
     }
     e.current.page = e.current.page + 1, ge(Math.random());
   }, De = () => {
-    const r = [...P], t = E || {
+    const r = [...v], t = E || {
       label: le({ id: "root" }),
       // 根
       value: "_paraui_first_floor"
@@ -299,8 +302,8 @@ const Cr = (c, x) => ({
     }), ne && r.unshift(t), e.current.breadcrumbsList = r, r;
   }, ar = (r) => {
     const t = [];
-    for (let a = 0, n = P.length; a < n; a++) {
-      const s = P[a];
+    for (let a = 0, n = v.length; a < n; a++) {
+      const s = v[a];
       if (t.push(s), s.value === r.value)
         break;
     }
@@ -334,22 +337,23 @@ const Cr = (c, x) => ({
       e.current.searchConfig.currentSourceData = n, K(n);
     }
   }, pe = (r) => {
-    const { data: t, err: a } = r;
+    const { data: t, error: a } = r;
     if (a) {
-      T(!1), e.current.reqParams.pagination && e.current.searchConfig.page !== 1 && (e.current.searchConfig.page = e.current.searchConfig.page - 1);
+      P(!1), e.current.reqParams.pagination && e.current.searchConfig.page !== 1 && (e.current.searchConfig.page = e.current.searchConfig.page - 1);
       return;
     }
     if (c.requestCallback) {
       c.requestCallback(
         t,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         (n) => {
-          T(!1), Se(n);
+          P(!1), Se(n);
         },
         !0
       );
       return;
     }
-    T(!1), Se(t);
+    P(!1), Se(t);
   }, qe = async () => {
     if (ue) {
       const a = {};
@@ -362,7 +366,9 @@ const Cr = (c, x) => ({
       method: ee,
       url: c.url || "",
       ctx: Z,
-      uuid: e.current.reqId,
+      onCancelId: (a) => {
+        e.current.reqId = a;
+      },
       data: {
         searchKey: e.current.searchVal?.trim(),
         ...c.params
@@ -385,8 +391,8 @@ const Cr = (c, x) => ({
     };
     return n(t), a;
   }, cr = async (r, t) => {
-    if (T(!0), e.current.searchVal = r, r === "") {
-      if (K([]), T(!1), e.current.beforeSearchBreadcrumbs) {
+    if (P(!0), e.current.searchVal = r, r === "") {
+      if (K([]), P(!1), e.current.beforeSearchBreadcrumbs) {
         if (e.current.breadcrumbsList = [...e.current.beforeSearchBreadcrumbs], S([...e.current.beforeSearchBreadcrumbs]), e.current.beforeSearchBreadcrumbs = null, z) {
           const a = be(), n = nr(a, e.current.oneDataList);
           e.current.currentSourceData = n;
@@ -399,7 +405,7 @@ const Cr = (c, x) => ({
     e.current.searchConfig.page = 1, e.current.searchConfig.currentSourceData = [], qe();
   }, sr = (r, t) => {
     if (b === "radio" && V(null, [], {}, {}), b === "check") {
-      const a = [...v];
+      const a = [...I];
       a.splice(t, 1);
       const n = {}, s = {};
       for (let o = 0, u = a.length; o < u; o++) {
@@ -415,7 +421,7 @@ const Cr = (c, x) => ({
       backDataFieldConfig: D,
       groupType: ce,
       handSelectorNodeInfo: c.handSelectorNodeInfo,
-      list: v,
+      list: I,
       nodeMode: N,
       detail: F,
       detailRender: te,
@@ -423,7 +429,7 @@ const Cr = (c, x) => ({
       onClose: sr,
       selectDataTitleRender: c.selectDataTitleRender,
       selectRenderItem: He,
-      selectRender: Me,
+      selectRender: Ae,
       disabled: y
     }
   ), or = () => {
@@ -445,7 +451,7 @@ const Cr = (c, x) => ({
               rowKey: k,
               value: de,
               loadMore: Ne,
-              isAllCheck: ve,
+              isAllCheck: Ie,
               list: fe,
               groupType: ce,
               groupRange: xe,
@@ -455,13 +461,13 @@ const Cr = (c, x) => ({
               isLazy: ae,
               detail: F,
               detailRender: te,
-              search: Ie,
+              search: Te,
               searchTrigger: Ve,
               searchPlaceholder: ze,
               searchLoading: Fe,
               searchVal: Ee,
               disabled: y,
-              disabledChild: Pe,
+              disabledChild: ve,
               loading: Ge,
               searchLoadMore: Ke,
               searchList: Oe,
@@ -485,7 +491,7 @@ const Cr = (c, x) => ({
           br,
           {
             error: ie,
-            helperText: Ae,
+            helperText: Me,
             hideErrorDom: we
           }
         )
@@ -494,7 +500,7 @@ const Cr = (c, x) => ({
   );
 };
 export {
-  zr as default,
+  Vr as default,
   Cr as handFieldConfig
 };
 //# sourceMappingURL=index.js.map

package/es/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/es/Selector/selectorData/index.js

@@ -3,7 +3,7 @@ import { useState as z, useRef as B, useEffect as G } from "react";
 import H from "../selectorNode/index.js";
 import K from "../../AutoTips/index.js";
 import { Close as P } from "../../node_modules/@para-ui/icons/Close/index.js";
-import { ArrayToObject as Q } from "@paraview/lib";
+import { ArrayToObject as Q } from "../../Utils/snack-kit-shims.js";
 import U from "../../GlobalContext/useFormatMessage.js";
 import { $prefixCls as x } from "../../GlobalContext/constant.js";
 import V from "../lang/index.js";

package/es/Selector/selectorMain/index.js

@@ -7,7 +7,7 @@ import { Loading as be } from "../../Loading/index.js";
 import ge from "../../Empty/index.js";
 import { Search as ke } from "../../node_modules/@para-ui/icons/Search/index.js";
 import { Refresh as Ce } from "../../node_modules/@para-ui/icons/Refresh/index.js";
-import { ArrayToObject as xe } from "@paraview/lib";
+import { ArrayToObject as xe } from "../../Utils/snack-kit-shims.js";
 import ae from "../../GlobalContext/useFormatMessage.js";
 import ie from "../lang/index.js";
 import { $prefixCls as z } from "../../GlobalContext/constant.js";
@@ -42,7 +42,7 @@ const oe = (q) => {
   } = q, j = ae("Selector", ie), [W, X] = se({}), p = V({
     listTypeJson: {},
     fieldConfig: {},
-    resizeTimer: null
+    resizeTimer: void 0
   }), g = V(null), T = V(null);
   p.current.listTypeJson = xe("value", a), p.current.fieldConfig = U || {}, ne(() => (N(), () => {
     clearTimeout(p.current.resizeTimer);
@@ -243,7 +243,7 @@ const oe = (q) => {
     onSearch: O,
     onRefresh: Y
   } = q, Z = ae("Selector", ie), [K, A] = se(!1), [P, k] = se(""), h = V({
-    searchTimer: null,
+    searchTimer: void 0,
     searchStr: ""
   });
   ne(() => {

package/es/Selector/selectorNode/index.js

@@ -34,7 +34,7 @@ const pe = (R) => {
     onLevel: b,
     onSelect: D,
     onClose: $
-  } = R, k = _("Selector", ee), [F, L] = y(), [M, h] = y(!1), n = Q(), T = () => {
+  } = R, k = _("Selector", ee), [F, L] = y(), [M, h] = y(!1), n = Q(null), T = () => {
     a || D && D();
   }, z = (s) => {
     s.stopPropagation(), !v && b && b();

package/es/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/es/Selector/util.js

@@ -1,18 +1,12 @@
-import { Get as s, Post as n } from "@paraview/lib";
-const m = (e) => {
-  const { method: t, data: r, ...o } = e;
+import { Get as n, Post as a } from "@snack-kit/lib";
+const p = (s) => {
+  const { method: t, data: r, url: o, ...e } = s;
   if (t === "Get")
-    return s({
-      params: r,
-      ...o
-    });
+    return n(o, { params: r, ...e });
   if (t === "Post")
-    return n({
-      data: r,
-      ...o
-    });
+    return a(o, r, e);
 };
 export {
-  m as reqFunc
+  p as reqFunc
 };
 //# sourceMappingURL=util.js.map

package/es/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/es/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;