@para-ui/core 5.0.1 → 5.0.3-beta.8

package/FieldForm/component.json

@@ -61,6 +61,20 @@
         "children": {
             "type": "ReactNode",
             "description": "FieldForm 接收任意 ReactNode(包括 FieldForm.Item / Button type=submit / 自定义包装);**但每个 Item 的 child 必须是支持 value/onChange/error/disabled 的自定义组件**(TextField / Select / Checkbox / Switch / DatePicker / InputNumber 等);**不可用原生 input/textarea/select/button — 会触发 React non-boolean-attribute warning**(因 cloneElement 注入 error={false} 给原生 DOM 元素时,React 视 error 为 DOM attr → 报错);见 childrenContract.FormItem"
+        },
+        "itemDecorator": {
+            "type": "ItemDecorator",
+            "objectShape": {
+                "getItemClassName": {
+                    "type": "(meta: ItemDecoratorMeta) => string | undefined | false",
+                    "description": "按字段 namePath/path 返回要合并到该 FieldForm.Item 根节点的 className;返回 undefined/''/false 时不追加，不影响其他状态 class(is-error/is-success 等)"
+                },
+                "renderItemExtra": {
+                    "type": "(meta: ItemDecoratorMeta) => ReactNode",
+                    "description": "按字段 namePath/path 在该 FieldForm.Item 根节点内追加渲染内容(如 diff 命中原因说明);渲染在根节点内、内部间距容器之外，不影响 has-spacing/has-helper-text 的 20px 间距机制"
+                }
+            },
+            "description": "Form 级一次注册、所有子孙 FieldForm.Item 自动生效的字段装饰扩展点;meta.namePath 来自 rc-field-form 的 renderMeta.name(真实的、经过 List 等上下文处理后的最终路径)，meta.path 是预拼接字符串(数组下标用方括号,如 'ubr.list[0].x');未传 name 的 Item 固定拿到 { namePath: [], path: '' };典型用法:`<FieldForm itemDecorator={{ getItemClassName: (meta) => isHit(meta.path) ? 'is-hit' : undefined, renderItemExtra: (meta) => isHit(meta.path) ? <span>命中原因</span> : null }}>`"
         }
     },
     "childrenContract": {
@@ -137,7 +151,9 @@
         "把'仅使用 FieldForm 本身'解读为'整个文件不能 import TextField/Button'(见 interpretivePriority.resolution)",
         "字段过多不分组",
         "忽略异步校验",
-        "在 mount 后修改 initialValues prop(应用 form.setFieldsValue;initialValues 仅 mount 时灌入)"
+        "在 mount 后修改 initialValues prop(应用 form.setFieldsValue;initialValues 仅 mount 时灌入)",
+        "在 itemDecorator.getItemClassName/renderItemExtra 回调体内调用 useContext/useXxx 等 Hook(回调运行在 ItemHolder 渲染过程中，不在业务组件自身的渲染调用栈里，会违反 Hooks 规则;应在业务组件顶层用 Hook 取数后，用 useMemo 包成闭包再传入 itemDecorator)",
+        "期望 itemDecorator 对 noStyle 的 FieldForm.Item 生效(noStyle 不渲染独立 wrapper 节点，没有可挂载 className/额外内容的位置)"
     ],
     "events": {
         "onFinish": {
@@ -187,6 +203,11 @@
             "issue": "rules 中的 validator 函数签名必须返回 Promise(rc-field-form 约定),不是同步返回",
             "wrong": "rules={[{ validator: (_, val) => val > 0 ? true : false }]}  // 同步返回 boolean 不被识别",
             "right": "rules={[{ validator: (_, val) => val > 0 ? Promise.resolve() : Promise.reject('必须大于 0') }]}"
+        },
+        {
+            "issue": "itemDecorator 的 getItemClassName/renderItemExtra 回调不能在函数体内调用 React Hook",
+            "wrong": "itemDecorator={{ getItemClassName: (meta) => { const hit = useFieldHighlight(meta.path); return hit ? 'is-hit' : undefined; } }}  // 在回调体内调用 Hook，违反 Hooks 规则",
+            "right": "const highlightMap = useFieldHighlightMap();\nconst itemDecorator = useMemo(() => ({ getItemClassName: (meta) => (highlightMap[meta.path] ? 'is-hit' : undefined) }), [highlightMap]);\n<FieldForm itemDecorator={itemDecorator}>"
         }
     ],
     "mapping": {

package/FormItemGroup/component.json

@@ -0,0 +1,72 @@
+{
+    "name": "FormItemGroup",
+    "category": "Layout",
+    "description": "表单项堆叠容器：官方推荐的字段间纵向/横向间距方案。字段自带的 20px 间距基线（helper-text 占位）原本要外层手动挂 `.paraui-v4-form` 类名才会生效，容易被忘记导致字段在 flex 布局下零间距；FormItemGroup 把这条基线内置在自己身上，不用再记类名。同时内部 gap 只认自身 CSS 变量（!important），裸写 style.gap 不会生效，用来替代业务/AI 随手在字段外层加 gap 导致的间距叠加问题（基线已经占了 20px，外层再加 gap 会翻倍）。一个组件同时兜住「漏挂基线类→零间距」和「叠加 gap→翻倍」两个方向。",
+    "semantic": {
+        "intent": ["表单字段堆叠", "受控间距容器", "间距基线兜底"],
+        "useCases": [
+            "多个 TextField/Select/Switch 等字段手写堆叠（最常见场景，不依赖 Form/FieldForm）",
+            "多个 FormItem/FieldFormItem 纵向堆叠(direction='vertical'，默认)",
+            "少量字段并排展示(direction='horizontal')",
+            "需要在字段之间加统一间距的场景(gap 属性)"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "vertical": {
+            "meaning": "默认值。`display:flex; flex-direction:column`，字段自上而下堆叠。"
+        },
+        "horizontal": {
+            "meaning": "`display:flex; flex-direction:row`，字段并排展示。"
+        }
+    },
+    "states": ["default"],
+    "idealProps": {
+        "direction": {
+            "type": "enum",
+            "values": ["vertical", "horizontal"],
+            "default": "vertical",
+            "description": "排列方向。表单场景基本用默认的 'vertical'。"
+        },
+        "gap": {
+            "type": "number",
+            "default": 0,
+            "description": "字段间距(px)，默认 0——不额外加间距，完全依赖字段自身已有的间距（如 helper-text 占位）。真正需要更大间距时才传这个值，例如 gap={32}。"
+        },
+        "children": {
+            "type": "ReactNode",
+            "description": "子元素，通常是若干个 FormItem / FieldFormItem。"
+        },
+        "className": {
+            "type": "string",
+            "description": "外层根 div 的类名。"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "外层根 div 的内联样式。注意其中的 gap 不会生效（会被组件内部 !important 规则覆盖），间距请用 gap 属性。"
+        }
+    },
+    "do": [
+        "字段纵向堆叠用 <FormItemGroup> 替代手写 <div style={{ display:'flex', flexDirection:'column', gap: 16 }}>",
+        "用 <FormItemGroup> 包住字段就自动拿到 20px 间距基线，不需要再额外记着给外层容器挂 `.paraui-v4-form` 类名",
+        "确实需要比字段自带间距更大的间距时，用 gap 属性：<FormItemGroup gap={32}>",
+        "字段并排展示用 direction='horizontal'"
+    ],
+    "dont": [
+        "不要在 style 里直接写 gap，例如 <FormItemGroup style={{ gap: 16 }}>——会被内部规则忽略，且不会有任何视觉效果，请改用 gap 属性",
+        "不要在没有堆叠需求的单个字段外面套一层 FormItemGroup，纯粹是多余包裹",
+        "确实需要密集布局下零间距（如表格内联编辑），仍可以用更具体的选择器覆盖 min-height（这条基线规则没有 !important），不需要绕开 FormItemGroup"
+    ],
+    "events": {},
+    "typescriptPitfalls": [
+        {
+            "issue": "style.gap 不会生效，是设计上的行为而不是 bug",
+            "wrong": "<FormItemGroup style={{ gap: 16 }}>...</FormItemGroup>  // 不生效，且不会报 TS 错误，容易被误以为生效了",
+            "right": "<FormItemGroup gap={16}>...</FormItemGroup>  // 通过 gap 属性设置，实际生效"
+        }
+    ],
+    "mapping": {
+        "realComponent": "FormItemGroup",
+        "adapter": null
+    }
+}

package/Menu/component.json

@@ -116,12 +116,14 @@
         "配置 shrinkOthers 以提升用户查找效率",
         "使用 icon 辅助识别菜单项",
         "**菜单数据通过 menuListProps.list 传入**（不是顶层 list prop）：`<Menu menuListProps={{ list: menuData }} />`，menuData 是 MenuChildrenProps[] 数组",
-        "MenuChildrenProps 核心字段（src/Menu/interface.ts:25-63）：`label: ReactNode`（菜单名），`path: string`（路径，与 selectMenu 比对高亮），`icon: ReactNode`（图标），`children: MenuChildrenProps[]`（子菜单），`type: 'redirect'|'router'|'iframe'|'snack'|'snackPage'`（菜单类型），`href: string`（a 标签地址），`badge: ReactNode`（标记）"
+        "MenuChildrenProps 核心字段（src/Menu/interface.ts:25-63）：`label: ReactNode`（菜单名），`path: string`（路径，与 selectMenu 比对高亮），`icon: ReactNode`（图标），`children: MenuChildrenProps[]`（子菜单），`type: 'redirect'|'router'|'iframe'|'snack'|'snackPage'`（菜单类型），`href: string`（a 标签地址），`badge: ReactNode`（标记）",
+        "`group: boolean`（仅一级生效,需同时有 children）：把该项渲染成不可点击的纯文本分组小标题,children 常驻展开且按顶层菜单项样式渲染（不缩进,可配 icon）。示例：`{ label: '路由管理', group: true, children: [{ label: '路由规则', path: '/router/rule' }, { label: '静态资源', path: '/router/static' }] }`"
     ],
     "dont": [
         "在菜单项中放置非导航类的复杂交互组件",
         "过度使用动态生成的菜单导致性能问题",
-        "把菜单数据传给顶层 list prop——Menu 没有顶层 list prop,数据必须通过 menuListProps.list 传入"
+        "把菜单数据传给顶层 list prop——Menu 没有顶层 list prop,数据必须通过 menuListProps.list 传入",
+        "不要在非一级菜单项或没有 children 的项上设置 group: true——不满足条件会被忽略,自动退化为原有渲染（普通叶子节点 / 普通折叠子菜单）,不会报错但也不会生效"
     ],
     "events": {
         "onClickMenu": {
@@ -171,6 +173,11 @@
             "issue": "color prop 只有 'deep' 和 'light' 两个有效值(ColorType),传其他字符串 TS 报错",
             "wrong": "color='dark'  // TS2322: Type '\"dark\"' is not assignable to type 'ColorType'",
             "right": "color='deep'  // 合法值: 'deep'(深色主题) | 'light'(浅色主题)"
+        },
+        {
+            "issue": "group 生效需同时满足两个前提：该项是一级菜单（level 1）且自身有 children；在二级菜单项或没有 children 的项上设置 group: true 会被静默忽略,自动退化为原渲染,容易被误以为是 bug",
+            "wrong": "// 二级菜单项上设置 group,不会生效\n{ label: '一级', children: [{ label: '二级', group: true, children: [...] }] }",
+            "right": "// group 只能设在一级菜单项上\n{ label: '路由管理', group: true, children: [{ label: '路由规则', path: '/router/rule' }] }"
         }
     ],
     "mapping": {

package/es/Checkbox/index.js

@@ -1,10 +1,11 @@
 import { j as s } from "../_virtual/jsx-runtime.js";
-import { useState as g, useEffect as x } from "react";
-import y from "../Label/index.js";
+import { useState as R, useEffect as x } from "react";
+import T from "../Label/index.js";
 import { $prefixCls as a } from "../GlobalContext/constant.js";
-import { Tooltip as T } from "../Tooltip/index.js";
+import { Tooltip as g } from "../Tooltip/index.js";
+import { PARA_UI_COMPACT_CONTROL_MARKER as y } from "../FieldForm/compactControlMarker.js";
 import './index.css';/* empty css           */
-const H = (c) => {
+const A = (c) => {
   const {
     className: r = "",
     label: n,
@@ -13,28 +14,28 @@ const H = (c) => {
     disabled: h = !1,
     disabledTooltip: f,
     indeterminate: m = !1,
-    width: k,
-    onChange: i,
+    width: u,
+    onChange: o,
     style: C
-  } = c, [l, o] = g(!1);
+  } = c, [l, i] = R(!1);
   x(() => {
-    c.defaultChecked !== void 0 && o(c.defaultChecked);
+    c.defaultChecked !== void 0 && i(c.defaultChecked);
   }, []), x(() => {
-    c.checked !== void 0 && o(c.checked);
+    c.checked !== void 0 && i(c.checked);
   }, [c.checked]);
   const p = (e) => {
     if (e.preventDefault(), h) return;
     if (m) {
-      c.checked === void 0 && o(!0), i && i(e, !0);
+      c.checked === void 0 && i(!0), o && o(e, !0);
       return;
     }
-    c.checked === void 0 && o(!l);
+    c.checked === void 0 && i(!l);
     const b = e.target;
-    b.checked = !l, b.value = String(!l), i && i(e, !l);
-  }, $ = () => {
+    b.checked = !l, b.value = String(!l), o && o(e, !l);
+  }, N = () => {
     let e = `${a}-checkbox`;
     return r && (e += ` ${r}`), d && (e += ` ${a}-checkbox-${d}`), h && (e += ` ${a}-checkbox-disabled`), m ? e += ` ${a}-checkbox-indeterminate` : l && (e += ` ${a}-checkbox-checked`), t && t.tooltipType && (e += ` ${a}-checkbox-${t.tooltipType}`), e;
-  }, N = () => {
+  }, $ = () => {
     let e = "checkbox-label";
     return t && t.className && (e += ` ${t.className}`), e;
   }, j = () => {
@@ -42,11 +43,11 @@ const H = (c) => {
     return t && t.helpClassName && (e += ` ${t.helpClassName}`), e;
   }, v = () => {
     const e = { ...C };
-    return k && (e.width = k), e;
-  }, u = () => /* @__PURE__ */ s.jsxs(
+    return u && (e.width = u), e;
+  }, k = () => /* @__PURE__ */ s.jsxs(
     "label",
     {
-      className: $(),
+      className: N(),
       onClick: p,
       style: v(),
       children: [
@@ -62,28 +63,29 @@ const H = (c) => {
           /* @__PURE__ */ s.jsx("span", { className: "checkbox-box-inner" })
         ] }),
         n !== void 0 && n !== "" && n !== null ? /* @__PURE__ */ s.jsx(
-          y,
+          T,
           {
             label: n,
             ...t,
             helpClassName: j(),
-            className: N()
+            className: $()
           }
         ) : null
       ]
     }
   );
   return f ? /* @__PURE__ */ s.jsx(
-    T,
+    g,
     {
       disabled: !0,
       ...f,
-      children: u()
+      children: k()
     }
-  ) : u();
+  ) : k();
 };
+A[y] = !0;
 export {
-  H as Checkbox,
-  H as default
+  A as Checkbox,
+  A as default
 };
 //# sourceMappingURL=index.js.map

package/es/CheckboxGroup/index.css

@@ -1 +1 @@
-@charset "UTF-8";.paraui-v4-checkbox-group{font-family:-apple-system,BlinkMacSystemFont,Helvetica Neue,PingFang SC,Microsoft YaHei,Source Han Sans SC,Noto Sans CJK SC,WenQuanYi Micro Hei,sans-serif;font-size:14px;font-weight:400;width:100%}.paraui-v4-checkbox-group>.checkbox-group-label{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content{line-height:0}.paraui-v4-checkbox-group>.checkbox-group-content .checkbox-item-box{margin-bottom:4px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item:last-child{margin-bottom:0}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content{display:flex;flex-direction:column}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span{margin-bottom:10px}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span:last-child{margin-bottom:0}
+@charset "UTF-8";.paraui-v4-checkbox-group{width:100%;font-family:-apple-system,BlinkMacSystemFont,Helvetica Neue,PingFang SC,Microsoft YaHei,Source Han Sans SC,Noto Sans CJK SC,WenQuanYi Micro Hei,sans-serif;font-size:14px;font-weight:400}.paraui-v4-checkbox-group>.checkbox-group-label{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content{line-height:0}.paraui-v4-checkbox-group>.checkbox-group-content .checkbox-item-box{margin-bottom:4px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item:last-child{margin-bottom:0}.paraui-v4-checkbox-group:not(.paraui-v4-checkbox-group-column)>.checkbox-group-content{margin-bottom:-4px}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content{display:flex;flex-direction:column}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span{margin-bottom:10px}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span:last-child{margin-bottom:0}

package/es/CheckboxGroup/style/index.css

@@ -1 +1 @@
-.paraui-v4-checkbox-group{font-family:-apple-system,BlinkMacSystemFont,Helvetica Neue,PingFang SC,Microsoft YaHei,Source Han Sans SC,Noto Sans CJK SC,WenQuanYi Micro Hei,sans-serif;font-size:14px;font-weight:400;width:100%}.paraui-v4-checkbox-group>.checkbox-group-label{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content{line-height:0}.paraui-v4-checkbox-group>.checkbox-group-content .checkbox-item-box{margin-bottom:4px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item:last-child{margin-bottom:0}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content{display:flex;flex-direction:column}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span{margin-bottom:10px}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span:last-child{margin-bottom:0}
+.paraui-v4-checkbox-group{width:100%;font-family:-apple-system,BlinkMacSystemFont,Helvetica Neue,PingFang SC,Microsoft YaHei,Source Han Sans SC,Noto Sans CJK SC,WenQuanYi Micro Hei,sans-serif;font-size:14px;font-weight:400}.paraui-v4-checkbox-group>.checkbox-group-label{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content{line-height:0}.paraui-v4-checkbox-group>.checkbox-group-content .checkbox-item-box{margin-bottom:4px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item{margin-bottom:6px}.paraui-v4-checkbox-group>.checkbox-group-content>.checkbox-group-content-item:last-child{margin-bottom:0}.paraui-v4-checkbox-group:not(.paraui-v4-checkbox-group-column)>.checkbox-group-content{margin-bottom:-4px}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content{display:flex;flex-direction:column}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span{margin-bottom:10px}.paraui-v4-checkbox-group.paraui-v4-checkbox-group-column>.checkbox-group-content>span:last-child{margin-bottom:0}

package/es/ExpressionInput/Popup.js

@@ -2,7 +2,7 @@ import { j as t } from "../_virtual/jsx-runtime.js";
 import * as p from "react";
 import { Lock as S } from "../para-ui-core/node_modules/@para-ui/icons/Lock/index.js";
 import { $prefixCls as o } from "../GlobalContext/constant.js";
-const i = 30, d = 240, m = 4, b = p.forwardRef((v, g) => {
+const i = 30, m = 240, d = 4, b = p.forwardRef((v, g) => {
   const {
     instanceClass: T,
     visible: $,
@@ -24,7 +24,7 @@ const i = 30, d = 240, m = 4, b = p.forwardRef((v, g) => {
     n < r ? e.scrollTop = n : n + i > f && (e.scrollTop = n + i - e.clientHeight);
   }, [h]), !$ || s.length === 0)
     return null;
-  const l = s.length > w, u = l ? Math.max(0, Math.floor(H / i) - m) : 0, M = l ? Math.ceil(d / i) + m * 2 : s.length, R = l ? Math.min(s.length, u + M) : s.length, y = s.slice(u, R), C = u * i;
+  const l = s.length > w, u = l ? Math.max(0, Math.floor(H / i) - d) : 0, M = l ? Math.ceil(m / i) + d * 2 : s.length, R = l ? Math.min(s.length, u + M) : s.length, y = s.slice(u, R), C = u * i;
   return /* @__PURE__ */ t.jsxs(
     "div",
     {
@@ -38,7 +38,7 @@ const i = 30, d = 240, m = 4, b = p.forwardRef((v, g) => {
           {
             ref: c,
             className: `${o}-expression-input-popup-list`,
-            style: { maxHeight: d, overflowY: "auto" },
+            style: { maxHeight: m, overflowY: "auto" },
             onScroll: (e) => {
               l && x(e.currentTarget.scrollTop);
             },
@@ -65,7 +65,14 @@ const i = 30, d = 240, m = 4, b = p.forwardRef((v, g) => {
                       },
                       children: [
                         /* @__PURE__ */ t.jsx("span", { className: `${o}-expression-input-popup-item-value`, children: e.label ?? e.value }),
-                        e.desc && /* @__PURE__ */ t.jsx("span", { className: `${o}-expression-input-popup-item-desc`, children: e.desc }),
+                        e.desc && /* @__PURE__ */ t.jsx(
+                          "span",
+                          {
+                            className: `${o}-expression-input-popup-item-desc`,
+                            title: e.desc,
+                            children: e.desc
+                          }
+                        ),
                         e.sensitive && /* @__PURE__ */ t.jsx(
                           S,
                           {

package/es/ExpressionInput/useExpressionInput.js

@@ -1,59 +1,62 @@
-import * as s from "react";
-import { detectChainAtCursor as A } from "./detectChainAtCursor.js";
-import { filterCandidatesByPartial as E } from "./filterCandidatesByPartial.js";
-function B(x) {
-  const { value: u, onChange: l, resolveCandidates: C, triggerMode: k, triggerPrefix: o, disabled: f, readOnly: h } = x, [t, r] = s.useState(null), [p, c] = s.useState(0), w = s.useRef(/* @__PURE__ */ new Map()), m = s.useRef(null), y = s.useMemo(() => {
+import * as r from "react";
+import { detectChainAtCursor as $ } from "./detectChainAtCursor.js";
+import { filterCandidatesByPartial as B } from "./filterCandidatesByPartial.js";
+function H(M) {
+  const { value: h, onChange: i, resolveCandidates: a, triggerMode: u, triggerPrefix: l, disabled: p, readOnly: d } = M, [t, c] = r.useState(null), [g, o] = r.useState(0), y = r.useRef(/* @__PURE__ */ new Map()), x = r.useRef(a), C = r.useRef(null), b = r.useMemo(() => {
     if (!t)
       return [];
-    const e = t.parts.join("."), n = w.current;
-    return n.has(e) || n.set(e, C(t.parts)), n.get(e);
-  }, [t, C]), a = s.useMemo(
-    () => t ? E(y, t.partial) : [],
-    [y, t]
-  ), d = !f && !h && !!t && a.length > 0, D = s.useCallback(
+    x.current !== a && (y.current.clear(), x.current = a);
+    const e = t.parts.join("."), n = y.current;
+    return n.has(e) || n.set(e, a(t.parts)), n.get(e);
+  }, [t, a]), s = r.useMemo(
+    () => t ? B(b, t.partial) : [],
+    [b, t]
+  ), k = !p && !d && !!t && s.length > 0, S = r.useCallback(
     (e, n) => {
-      if (f || h) {
-        r(null);
+      if (p || d) {
+        c(null);
         return;
       }
-      l?.(e);
-      const g = A(e, n, { triggerPrefix: o, triggerMode: k });
-      r(g), c(0);
+      C.current = n, i?.(e);
+      const m = $(e, n, { triggerPrefix: l, triggerMode: u });
+      c(m), o(0);
     },
-    [l, f, h, o, k]
-  ), $ = s.useCallback(() => r(null), []), i = s.useCallback(
+    [i, p, d, l, u]
+  ), A = r.useCallback(() => c(null), []), f = r.useCallback(
     (e) => {
       if (!t)
         return;
-      const n = u.slice(0, t.startIdx), g = u.slice(t.endIdx), S = [...t.parts, e.value].join("."), b = `${o}.${S}${e.chain ? "." : ""}`;
-      m.current = n.length + b.length, l?.(`${n}${b}${g}`), r(null);
+      const n = h.slice(0, t.startIdx), m = h.slice(t.endIdx), j = [...t.parts, e.value].join("."), R = `${l}.${j}${e.chain ? "." : ""}`, w = `${n}${R}${m}`, D = n.length + R.length;
+      C.current = D, i?.(w), c(
+        e.chain ? $(w, D, { triggerPrefix: l, triggerMode: u }) : null
+      ), o(0);
     },
-    [t, u, l, o]
-  ), R = s.useCallback(
+    [t, h, i, l, u]
+  ), E = r.useCallback(
     (e) => {
-      d && (e.key === "ArrowDown" ? (e.preventDefault(), c((n) => (n + 1) % a.length)) : e.key === "ArrowUp" ? (e.preventDefault(), c((n) => (n - 1 + a.length) % a.length)) : e.key === "Enter" || e.key === "Tab" ? (e.preventDefault(), i(a[p])) : e.key === "Escape" && (e.preventDefault(), r(null)));
+      k && (e.key === "ArrowDown" ? (e.preventDefault(), o((n) => (n + 1) % s.length)) : e.key === "ArrowUp" ? (e.preventDefault(), o((n) => (n - 1 + s.length) % s.length)) : e.key === "Enter" || e.key === "Tab" ? (e.preventDefault(), f(s[g])) : e.key === "Escape" && (e.preventDefault(), c(null)));
     },
-    [d, a, p, i]
-  ), M = s.useCallback(
+    [k, s, g, f]
+  ), I = r.useCallback(
     (e) => {
-      i(e);
+      f(e);
     },
-    [i]
+    [f]
   );
   return {
-    open: d,
+    open: k,
     ctx: t ? { parts: t.parts, partial: t.partial } : null,
-    candidates: a,
-    highlight: p,
-    setHighlight: c,
-    pendingCursorRef: m,
-    handleValueChange: D,
-    handleKeyDown: R,
-    handleSelect: M,
-    close: $
+    candidates: s,
+    highlight: g,
+    setHighlight: o,
+    pendingCursorRef: C,
+    handleValueChange: S,
+    handleKeyDown: E,
+    handleSelect: I,
+    close: A
   };
 }
 export {
-  B as useExpressionInput
+  H as useExpressionInput
 };
 //# sourceMappingURL=useExpressionInput.js.map

package/es/FieldForm/ErrorList.js

@@ -1,18 +1,18 @@
 import { j as i } from "../_virtual/jsx-runtime.js";
 import { useMemo as u } from "react";
 import l from "../HelperText/index.js";
-function a(r, t, n, e = 0) {
+function a(r, t, e, n = 0) {
   return {
-    key: typeof r == "string" ? r : `${t}-${e}`,
+    key: typeof r == "string" ? r : `${t}-${n}`,
     error: r,
-    errorStatus: n
+    errorStatus: e
   };
 }
-const d = ({ helperText: r, helpStatus: t, errors: n = [], warnings: e = [] }) => {
+const d = ({ helperText: r, helpStatus: t, errors: e = [], warnings: n = [] }) => {
   const s = u(() => r != null ? [a(r, "help", t)] : [
-    ...n.map((o, m) => a(o, "error", "error", m)),
-    ...e.map((o, m) => a(o, "warning", "warning", m))
-  ], [r, n, e, t]);
+    ...e.map((o, m) => a(o, "error", "error", m)),
+    ...n.map((o, m) => a(o, "warning", "warning", m))
+  ], [r, e, n, t]);
   return /* @__PURE__ */ i.jsx(i.Fragment, { children: Array.isArray(s) && s.length ? s.map((o) => /* @__PURE__ */ i.jsx(
     "div",
     {
@@ -21,7 +21,8 @@ const d = ({ helperText: r, helpStatus: t, errors: n = [], warnings: e = [] }) =
         l,
         {
           error: !0,
-          helperText: o.error
+          helperText: o.error,
+          hideErrorDom: !1
         }
       )
     },

package/es/FieldForm/FieldFormItem/ItemHolder.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { Meta } from 'rc-field-form/lib/interface';
+import { ItemDecoratorMeta } from '../interface';
 import { ReportMetaChange } from '../context';
 import { FormItemProps } from './index';
 export interface ItemHolderProps extends FormItemProps {
@@ -7,6 +8,7 @@ export interface ItemHolderProps extends FormItemProps {
     errors: ReactNode[];
     warnings: ReactNode[];
     meta: Meta;
+    identityMeta: ItemDecoratorMeta;
     onSubItemMetaChange: ReportMetaChange;
 }
 declare function ItemHolder(props: ItemHolderProps): import("react/jsx-runtime").JSX.Element;