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

package/lib/Empty/component.json

@@ -0,0 +1,123 @@
+{
+    "name": "Empty",
+    "category": "Data Display",
+    "description": "空状态时的展示占位符，用于无数据、无搜索结果、无权限等场景，支持自定义图片、描述文案、刷新按钮及整体替换",
+    "semantic": {
+        "intent": [
+            "展示空状态",
+            "引导操作",
+            "占位"
+        ],
+        "useCases": [
+            "无数据",
+            "无搜索结果",
+            "无权限"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "default": {
+            "meaning": "默认样式"
+        }
+    },
+    "states": [
+        "visible"
+    ],
+    "idealProps": {
+        "size": {
+            "type": "enum",
+            "values": [
+                "small",
+                "medium",
+                "large"
+            ],
+            "default": "large",
+            "description": "尺寸。三档统一为 small / medium / large(2026-05-08 跨组件命名 epic §3.1 选项 B 实施,medium 为新增视觉档,默认 large 不变,既有 small/large 调用零回归)"
+        },
+        "image": {
+            "type": "ReactNode | string",
+            "description": "自定义图片节点。传字符串时渲染为 <img src={image}>,传 ReactNode 时直接渲染。**不传时按 size 自动选内置图：small=SmallNull, medium/large=LargeNull**"
+        },
+        "description": {
+            "type": "ReactNode | string",
+            "description": "自定义描述内容；不传时显示国际化默认文案（zh_CN='暂无内容'）"
+        },
+        "imageStyle": {
+            "type": "object",
+            "objectShape": {
+                "height": { "type": "string | number", "description": "图片高度" },
+                "width": { "type": "string | number", "description": "图片宽度" }
+            },
+            "completeExample": "{ height: 60 }",
+            "description": "图片区域内联样式（React.CSSProperties 子集）"
+        },
+        "showRefresh": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否显示刷新按钮；配合 onRefresh 使用"
+        },
+        "onRefresh": {
+            "type": "(event: React.MouseEvent) => void",
+            "description": "点击刷新按钮回调；仅 showRefresh=true 时展示触发"
+        },
+        "customEmpty": {
+            "type": "ReactNode",
+            "description": "**完整替换**整个空状态内容（包括图片 + 描述），传入后 image / description / showRefresh 全部不渲染（src/Empty/index.tsx 90 行 if(customEmpty) 分支实证）"
+        },
+        "className": {
+            "type": "string",
+            "description": "外层容器自定义类名"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "外层容器 style"
+        }
+    },
+    "do": [
+        "在无数据时提供 Empty 状态",
+        "提供引导操作：配合 showRefresh + onRefresh 增加刷新入口",
+        "需要完整自定义布局时使用 customEmpty 整体替换",
+        "size 默认 large，需要紧凑展示（如表格内嵌）时用 small"
+    ],
+    "dont": [
+        "在 Loading 时显示 Empty——应先消除 Loading 遮罩再渲染 Empty",
+        "同时传 customEmpty 和 description/image——customEmpty 会覆盖后者，造成困惑"
+    ],
+    "events": {
+        "onRefresh": {
+            "signature": "(event: React.MouseEvent) => void",
+            "asyncSupported": false,
+            "examples": [
+                "showRefresh={true} onRefresh={() => fetchData()} — 点击刷新文字触发重新请求",
+                "onRefresh={(e) => { e.stopPropagation(); reload(); }} — 阻止冒泡后重载",
+                "配合 loading state：onRefresh={() => { setLoading(true); fetch().finally(() => setLoading(false)); }}"
+            ],
+            "commonMistakes": [
+                "不传 showRefresh={true} 只传 onRefresh — 刷新按钮不会渲染，回调永不触发",
+                "期望点击图片触发 onRefresh — 只有文字区域的刷新链接触发，图片无点击事件",
+                "异步刷新后没有给用户反馈（Loading 状态）— 应结合父组件 loading 状态"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "image prop 类型是 ReactNode | string，传 null 会触发 TS2322",
+            "wrong": "const img: React.ReactNode | null = getImg(); <Empty image={img} /> // 可能 null，TS 报错",
+            "right": "const img = getImg(); <Empty image={img ?? undefined} /> // 用 undefined 替代 null"
+        },
+        {
+            "issue": "description 类型是 ReactNode，不支持 false/null 显式传递",
+            "wrong": "<Empty description={null} /> // 期望显示默认文案，但 null 在 ReactNode 中合法，结果不渲染描述区域",
+            "right": "<Empty /> // 不传 description 时自动用国际化默认文案（'暂无内容'）"
+        },
+        {
+            "issue": "customEmpty 传入后 image/description/showRefresh 均不生效——源码 if(customEmpty) 分支直接 return customEmpty",
+            "wrong": "<Empty customEmpty={<CustomUI />} description='还有数据哦' /> // description 被 customEmpty 覆盖",
+            "right": "// 要自定义描述同时用 customEmpty：把描述塞进 customEmpty 里\n<Empty customEmpty={<><CustomUI /><p>还有数据哦</p></>} />"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Empty",
+        "adapter": null
+    }
+}

package/lib/Empty/index.css

@@ -1 +1 @@
-@charset "UTF-8";.paraui-v4-empty{display:inline-flex;flex-direction:column;align-items:center}.paraui-v4-empty>.empty-image{line-height:0;overflow:hidden}.paraui-v4-empty>.empty-image img{width:100%}.paraui-v4-empty .empty-image-large{width:334px;height:238px}.paraui-v4-empty .empty-image-small{width:120px;height:120px}.paraui-v4-empty>.empty-description{line-height:17px;font-size:14px;font-weight:400;color:#5c6573}.paraui-v4-empty>.empty-description>.empty-description-refresh{display:inline-block}.paraui-v4-empty>.empty-description>.empty-description-refresh span{color:#2e65e6;cursor:pointer}.paraui-v4-empty>.empty-description>.empty-description-refresh span:hover{color:#5783eb}.paraui-v4-empty.paraui-v4-empty-large>.empty-description{margin-top:20px}.paraui-v4-empty.paraui-v4-empty-small>.empty-description{margin-top:10px;font-size:14px}
+@charset "UTF-8";.paraui-v4-empty{display:inline-flex;flex-direction:column;align-items:center}.paraui-v4-empty>.empty-image{overflow:hidden;line-height:0}.paraui-v4-empty>.empty-image img{width:100%}.paraui-v4-empty .empty-image-large{width:334px;height:238px}.paraui-v4-empty .empty-image-medium{width:220px;height:180px}.paraui-v4-empty .empty-image-small{width:120px;height:120px}.paraui-v4-empty>.empty-description{font-size:14px;font-weight:400;line-height:17px;color:#5c6573}.paraui-v4-empty>.empty-description>.empty-description-refresh{display:inline-block}.paraui-v4-empty>.empty-description>.empty-description-refresh span{color:#2e65e6;cursor:pointer}.paraui-v4-empty>.empty-description>.empty-description-refresh span:hover{color:#5783eb}.paraui-v4-empty.paraui-v4-empty-large>.empty-description{margin-top:20px}.paraui-v4-empty.paraui-v4-empty-medium>.empty-description{margin-top:15px;font-size:14px}.paraui-v4-empty.paraui-v4-empty-small>.empty-description{margin-top:10px;font-size:14px}

package/lib/Empty/index.d.ts

@@ -5,7 +5,7 @@ export interface EmptyProps {
     /** style */
     style?: React.CSSProperties;
     /** 尺寸 */
-    size?: 'large' | 'small';
+    size?: 'small' | 'medium' | 'large';
     /** 图片样式 */
     imageStyle?: React.CSSProperties;
     /** 图片 */
@@ -18,7 +18,7 @@ export interface EmptyProps {
     onRefresh?: (event: React.MouseEvent) => void;
     /** 自定义空节点 */
     customEmpty?: React.ReactNode;
-    [name: string]: any;
+    [name: string]: unknown;
 }
 declare const Empty: FC<EmptyProps>;
 export default Empty;

package/lib/Empty/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"),R=require("clsx"),a=require("./images/index.js"),h=require("../GlobalContext/useFormatMessage.js"),N=require("./lang/index.js"),q=require("../Hooks/useGlobalProps.js"),c=require("../GlobalContext/constant.js");;/* empty css            */const $={large:e.jsxRuntimeExports.jsx(a.LargeNull,{}),small:e.jsxRuntimeExports.jsx(a.SmallNull,{})},v=l=>{const{className:u,style:x,size:t="large",imageStyle:p,image:i=$[t],description:o,showRefresh:d=!1,onRefresh:j,customEmpty:m}=q.default(l,"Empty"),r=h.default("Empty",N.default),f=E=>{j?.(E)},s=typeof o<"u"?o:r({id:"noData"}),g=typeof s=="string"?s:"empty";let n=null;const y=d?e.jsxRuntimeExports.jsxs("span",{className:"empty-description-refresh",children:[r({id:"click"}),e.jsxRuntimeExports.jsx("span",{onClick:f,children:r({id:"refresh"})})]}):null;return typeof i=="string"?n=e.jsxRuntimeExports.jsx("img",{src:i,alt:g}):n=i,e.jsxRuntimeExports.jsx("div",{className:R(`${c.$prefixCls}-empty`,u,`${c.$prefixCls}-empty-${t}`),style:x,children:m||e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[e.jsxRuntimeExports.jsx("div",{className:`empty-image ${l?.image?"":`empty-image-${t}`}`,style:p,children:n}),s&&e.jsxRuntimeExports.jsxs("div",{className:"empty-description",children:[e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:s}),y]})]})})};exports.default=v;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const e=require("../_virtual/jsx-runtime.js"),R=require("clsx"),l=require("./images/index.js"),h=require("../GlobalContext/useFormatMessage.js"),N=require("./lang/index.js"),q=require("../Hooks/useGlobalProps.js"),u=require("../GlobalContext/constant.js");;/* empty css            */const $={large:e.jsxRuntimeExports.jsx(l.LargeNull,{}),medium:e.jsxRuntimeExports.jsx(l.LargeNull,{}),small:e.jsxRuntimeExports.jsx(l.SmallNull,{})},v=o=>{const{className:x,style:c,size:t="large",imageStyle:p,image:i=$[t],description:m,showRefresh:d=!1,onRefresh:j,customEmpty:a}=q.default(o,"Empty"),r=h.default("Empty",N.default),g=E=>{j?.(E)},s=typeof m<"u"?m:r({id:"noData"}),f=typeof s=="string"?s:"empty";let n=null;const y=d?e.jsxRuntimeExports.jsxs("span",{className:"empty-description-refresh",children:[r({id:"click"}),e.jsxRuntimeExports.jsx("span",{onClick:g,children:r({id:"refresh"})})]}):null;return typeof i=="string"?n=e.jsxRuntimeExports.jsx("img",{src:i,alt:f}):n=i,e.jsxRuntimeExports.jsx("div",{className:R(`${u.$prefixCls}-empty`,x,`${u.$prefixCls}-empty-${t}`),style:c,children:a||e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[e.jsxRuntimeExports.jsx("div",{className:`empty-image ${o?.image?"":`empty-image-${t}`}`,style:p,children:n}),s&&e.jsxRuntimeExports.jsxs("div",{className:"empty-description",children:[e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:s}),y]})]})})};exports.default=v;
 //# sourceMappingURL=index.js.map

package/lib/Empty/style/index.css

@@ -1 +1 @@
-.paraui-v4-empty{display:inline-flex;flex-direction:column;align-items:center}.paraui-v4-empty>.empty-image{line-height:0;overflow:hidden}.paraui-v4-empty>.empty-image img{width:100%}.paraui-v4-empty .empty-image-large{width:334px;height:238px}.paraui-v4-empty .empty-image-small{width:120px;height:120px}.paraui-v4-empty>.empty-description{line-height:17px;font-size:14px;font-weight:400;color:#5c6573}.paraui-v4-empty>.empty-description>.empty-description-refresh{display:inline-block}.paraui-v4-empty>.empty-description>.empty-description-refresh span{color:#2e65e6;cursor:pointer}.paraui-v4-empty>.empty-description>.empty-description-refresh span:hover{color:#5783eb}.paraui-v4-empty.paraui-v4-empty-large>.empty-description{margin-top:20px}.paraui-v4-empty.paraui-v4-empty-small>.empty-description{margin-top:10px;font-size:14px}
+.paraui-v4-empty{display:inline-flex;flex-direction:column;align-items:center}.paraui-v4-empty>.empty-image{overflow:hidden;line-height:0}.paraui-v4-empty>.empty-image img{width:100%}.paraui-v4-empty .empty-image-large{width:334px;height:238px}.paraui-v4-empty .empty-image-medium{width:220px;height:180px}.paraui-v4-empty .empty-image-small{width:120px;height:120px}.paraui-v4-empty>.empty-description{font-size:14px;font-weight:400;line-height:17px;color:#5c6573}.paraui-v4-empty>.empty-description>.empty-description-refresh{display:inline-block}.paraui-v4-empty>.empty-description>.empty-description-refresh span{color:#2e65e6;cursor:pointer}.paraui-v4-empty>.empty-description>.empty-description-refresh span:hover{color:#5783eb}.paraui-v4-empty.paraui-v4-empty-large>.empty-description{margin-top:20px}.paraui-v4-empty.paraui-v4-empty-medium>.empty-description{margin-top:15px;font-size:14px}.paraui-v4-empty.paraui-v4-empty-small>.empty-description{margin-top:10px;font-size:14px}

package/lib/ExpressionInput/HighlightOverlay.d.ts

@@ -0,0 +1,8 @@
+import { HighlightSegment } from './highlightSegments';
+import * as React from 'react';
+export interface HighlightOverlayProps {
+    segments: HighlightSegment[];
+    style?: React.CSSProperties;
+}
+declare const HighlightOverlay: React.ForwardRefExoticComponent<HighlightOverlayProps & React.RefAttributes<HTMLDivElement>>;
+export default HighlightOverlay;

package/lib/ExpressionInput/HighlightOverlay.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const s=require("../_virtual/jsx-runtime.js"),c=require("react"),a=require("../GlobalContext/constant.js");function u(e){const i=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const t in e)if(t!=="default"){const r=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(i,t,r.get?r:{enumerable:!0,get:()=>e[t]})}}return i.default=e,Object.freeze(i)}const l=u(c),o=l.forwardRef(({segments:e,style:i},t)=>s.jsxRuntimeExports.jsx("div",{ref:t,"aria-hidden":"true",className:`${a.$prefixCls}-expression-input-overlay`,style:i,children:e.map((r,n)=>r.highlight?s.jsxRuntimeExports.jsx("span",{className:`${a.$prefixCls}-expression-input-overlay-highlight`,children:r.text},n):s.jsxRuntimeExports.jsx(l.Fragment,{children:r.text},n))}));o.displayName="HighlightOverlay";exports.default=o;
+//# sourceMappingURL=HighlightOverlay.js.map

package/lib/ExpressionInput/Popup.d.ts

@@ -0,0 +1,19 @@
+import { ExprCandidate } from './interface';
+import * as React from 'react';
+export interface PopupRect {
+    top: number;
+    left: number;
+    width: number;
+}
+export interface PopupProps {
+    instanceClass: string;
+    visible: boolean;
+    rect: PopupRect;
+    header: React.ReactNode;
+    candidates: ExprCandidate[];
+    highlight: number;
+    virtualizeThreshold: number;
+    onSelect: (candidate: ExprCandidate) => void;
+    onHighlightChange: (index: number) => void;
+}
+export declare const Popup: React.ForwardRefExoticComponent<PopupProps & React.RefAttributes<HTMLDivElement>>;

package/lib/ExpressionInput/Popup.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../_virtual/jsx-runtime.js"),O=require("react"),P=require("../para-ui-core/node_modules/@para-ui/icons/Lock/index.js"),o=require("../GlobalContext/constant.js");function I(n){const c=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const l in n)if(l!=="default"){const x=Object.getOwnPropertyDescriptor(n,l);Object.defineProperty(c,l,x.get?x:{enumerable:!0,get:()=>n[l]})}}return c.default=n,Object.freeze(c)}const a=I(O),i=30,j=240,$=4,R=a.forwardRef((n,c)=>{const{instanceClass:l,visible:x,rect:d,header:E,candidates:s,highlight:m,virtualizeThreshold:T,onSelect:b,onHighlightChange:C}=n,[y,g]=a.useState(0),f=a.useRef(null);if(a.useEffect(()=>{g(0),f.current&&(f.current.scrollTop=0)},[s]),a.useEffect(()=>{const e=f.current;if(!e)return;const p=m*i,u=e.scrollTop,v=u+e.clientHeight;p<u?e.scrollTop=p:p+i>v&&(e.scrollTop=p+i-e.clientHeight)},[m]),!x||s.length===0)return null;const r=s.length>T,h=r?Math.max(0,Math.floor(y/i)-$):0,w=r?Math.ceil(j/i)+$*2:s.length,N=r?Math.min(s.length,h+w):s.length,M=s.slice(h,N),S=h*i;return t.jsxRuntimeExports.jsxs("div",{ref:c,className:`${o.$prefixCls}-expression-input-popup ${l}`,style:{position:"fixed",top:d.top,left:d.left,width:d.width},children:[t.jsxRuntimeExports.jsx("div",{className:`${o.$prefixCls}-expression-input-popup-header`,children:E}),t.jsxRuntimeExports.jsx("div",{ref:f,className:`${o.$prefixCls}-expression-input-popup-list`,style:{maxHeight:j,overflowY:"auto"},onScroll:e=>{r&&g(e.currentTarget.scrollTop)},children:t.jsxRuntimeExports.jsx("div",{style:{height:r?s.length*i:void 0,position:"relative"},children:t.jsxRuntimeExports.jsx("div",{style:{position:r?"absolute":void 0,top:r?S:void 0,left:0,right:0},children:M.map((e,p)=>{const u=h+p,v=u===m;return t.jsxRuntimeExports.jsxs("div",{"data-testid":`expr-candidate-row-${e.value}`,className:`${o.$prefixCls}-expression-input-popup-item${v?` ${o.$prefixCls}-expression-input-popup-item-active`:""}`,style:{height:i},onMouseEnter:()=>C(u),onMouseDown:H=>{H.preventDefault(),b(e)},children:[t.jsxRuntimeExports.jsx("span",{className:`${o.$prefixCls}-expression-input-popup-item-value`,children:e.label??e.value}),e.desc&&t.jsxRuntimeExports.jsx("span",{className:`${o.$prefixCls}-expression-input-popup-item-desc`,children:e.desc}),e.sensitive&&t.jsxRuntimeExports.jsx(P.Lock,{"data-testid":`expr-candidate-lock-${e.value}`,className:`${o.$prefixCls}-expression-input-popup-item-lock`})]},e.value)})})})})]})});R.displayName="Popup";exports.Popup=R;
+//# sourceMappingURL=Popup.js.map

package/lib/ExpressionInput/component.json

@@ -0,0 +1,79 @@
+{
+  "name": "ExpressionInput",
+  "category": "数据录入",
+  "description": "单行表达式变量自动补全输入框,默认要求 {{ }} 包裹触发,候选数据完全由业务方通过 resolveCandidates 注入。",
+  "semantic": {
+    "intent": ["在文本中输入引用变量的表达式", "按命名空间层级下钻选择变量"],
+    "useCases": ["脚本/配置里引用运行时变量", "低代码画布属性面板里的表达式绑定"],
+    "riskLevel": "low"
+  },
+  "variants": {
+    "braces": { "meaning": "默认触发模式,要求光标位于 {{ }} 区间内才弹出候选" },
+    "bare": { "meaning": "不要求大括号包裹,任意位置匹配 triggerPrefix 即弹出候选" }
+  },
+  "states": ["default", "focus", "disabled", "readOnly", "popup-open"],
+  "idealProps": {
+    "value": { "type": "string", "description": "受控值", "required": false },
+    "onChange": { "type": "function", "description": "值变化回调", "signature": "(value: string) => void" },
+    "resolveCandidates": {
+      "type": "function",
+      "description": "按命名空间路径返回该层级的完整候选列表,组件内部按 parts 缓存",
+      "signature": "(parts: string[]) => ExprCandidate[]",
+      "required": true
+    },
+    "triggerMode": {
+      "type": "string",
+      "description": "触发匹配机制",
+      "values": ["braces", "bare"],
+      "default": "braces"
+    },
+    "triggerPrefix": { "type": "string", "description": "触发前缀符号", "default": "$" },
+    "virtualizeThreshold": { "type": "number", "description": "候选数超过该阈值启用虚拟滚动", "default": "50" },
+    "renderPopupHeader": {
+      "type": "function",
+      "description": "自定义浮层 header 文案",
+      "signature": "(ctx: ExprChainCtx, count: number) => React.ReactNode",
+      "required": false
+    },
+    "expressionTooltip": {
+      "type": "ReactNode",
+      "description": "表达式说明 tooltip 文案,不传则不展示;仅当 value 命中表达式格式(braces/bare)时 hover/focus 才弹出",
+      "required": false
+    }
+  },
+  "commonMisconceptions": [
+    "以为 resolveCandidates 每次按键都会被调用——实际只有下钻/回退到新的命名空间层级时才调用,同层级内逐字过滤是客户端完成的",
+    "以为默认触发不需要 {{ }} 包裹——默认 triggerMode 是 'braces',裸写 $.xxx 不会触发,需要显式传 triggerMode='bare' 才对齐 Ditto 原始行为",
+    "以为传入的 candidate.value 可以是任意字符串——实际必须是合法标识符字符([A-Za-z0-9_$]),否则插入后再次解析会被截断",
+    "以为 expressionTooltip 会随打字实时弹出/消失——实际是否命中只在 hover/focus 触发那一刻判定,光标停留期间继续输入使 value 从未命中变为命中不会自动弹出,需要重新 hover/focus",
+    "以为花括号着色和 expressionTooltip 用同一套判定标准——实际着色只看 {{ }} 是否配对闭合,不校验内容合法性,门槛比 expressionTooltip 低,{{$.}} 这类值会着色但不会弹出 tooltip,两者可能不一致,这是预期行为"
+  ],
+  "do": [
+    "为需要继续下钻子级的候选项设置 chain: true,让选中后自动追加 . 方便连续输入",
+    "为敏感字段设置 sensitive: true,组件会自动展示锁图标",
+    "在 Modal/Drawer 中使用时无需额外处理,组件内部已对接 usePopupContainer 自动寻找最近可滚动祖先容器"
+  ],
+  "dont": [
+    "不要在 resolveCandidates 内部做未做缓存的重量级计算并假设组件会防抖——组件只在 parts 变化时调用一次,但单次调用本身仍需业务方保证足够快",
+    "不要给多个实例传相同的 DOM id 或手动操作 document.body 上的浮层 — 组件已经用 UUID 做了实例隔离"
+  ],
+  "events": {
+    "onChange": {
+      "signature": "(value: string) => void",
+      "asyncSupported": false,
+      "examples": ["受控更新 value 状态"],
+      "commonMistakes": ["忘记把新 value 传回 props.value,导致组件表现为不可编辑"]
+    }
+  },
+  "typescriptPitfalls": [
+    {
+      "issue": "resolveCandidates 类型签名从 ChainCtx 变成了 parts: string[]",
+      "wrong": "resolveCandidates={(ctx) => ctx.partial ? [] : rootCandidates}",
+      "right": "resolveCandidates={(parts) => parts.length === 0 ? rootCandidates : []}"
+    }
+  ],
+  "mapping": {
+    "realComponent": "ExpressionInput",
+    "adapter": "无,直接使用"
+  }
+}

package/lib/ExpressionInput/detectChainAtCursor.d.ts

@@ -0,0 +1,17 @@
+/** partial 片段本身允许出现的字符(不含 .) */
+export declare const ID_TAIL: RegExp;
+export interface DetectChainOptions {
+    triggerPrefix: string;
+    triggerMode: 'braces' | 'bare';
+}
+export interface ChainResult {
+    /** 链路在原文本中的起始下标(含前缀符号) */
+    startIdx: number;
+    /** 链路在原文本中的结束下标(即光标位置) */
+    endIdx: number;
+    /** 已确定的上级片段 */
+    parts: string[];
+    /** 正在输入的片段 */
+    partial: string;
+}
+export declare function detectChainAtCursor(text: string, cursor: number, options: DetectChainOptions): ChainResult | null;

package/lib/ExpressionInput/detectChainAtCursor.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=/[A-Za-z0-9_$]/;function x(t){const e=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`[A-Za-z0-9_.${e}]`)}function I(t,e){const i=t.slice(0,e),r=i.lastIndexOf("{{");if(r===-1||i.lastIndexOf("}}")>r)return!1;const o=t.slice(e),n=o.indexOf("}}"),s=o.indexOf("{{");return n===-1?!0:!(s!==-1&&s<n)}function h(t,e,i){const{triggerPrefix:r,triggerMode:c}=i;if(c==="braces"&&!I(t,e))return null;const o=x(r);let n=e;for(;n>0&&o.test(t[n-1]);)n-=1;const s=t.slice(n,e),f=`${r}.`;if(!s.startsWith(f))return null;const a=s.slice(f.length),u=a.length>0?a.split("."):[""],l=u.pop(),g=u;return l.length>0&&!l.split("").every(p=>d.test(p))?null:{startIdx:n,endIdx:e,parts:g,partial:l}}exports.ID_TAIL=d;exports.detectChainAtCursor=h;
+//# sourceMappingURL=detectChainAtCursor.js.map

package/lib/ExpressionInput/filterCandidatesByPartial.d.ts

@@ -0,0 +1,2 @@
+import { ExprCandidate } from './interface';
+export declare function filterCandidatesByPartial(candidates: ExprCandidate[], partial: string): ExprCandidate[];

package/lib/ExpressionInput/filterCandidatesByPartial.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function a(e,t){if(!t)return e;const r=t.toLowerCase();return e.filter(l=>{if(l.value.toLowerCase().startsWith(r))return!0;const o=l.label?.toLowerCase();return!!o&&o.includes(r)})}exports.filterCandidatesByPartial=a;
+//# sourceMappingURL=filterCandidatesByPartial.js.map

package/lib/ExpressionInput/highlightSegments.d.ts

@@ -0,0 +1,9 @@
+export interface HighlightSegment {
+    text: string;
+    highlight: boolean;
+}
+/**
+ * 按 {{ }} 配对闭合切分 value,不校验内容合法性,不处理嵌套。
+ * 用于表达式片段着色,判定门槛低于 isExpressionValue。
+ */
+export declare function highlightSegments(value: string): HighlightSegment[];

package/lib/ExpressionInput/highlightSegments.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=/\{\{[^{}]*\}\}/g;function g(e){if(!e)return[];const h=[];let i=0,t;for(n.lastIndex=0;(t=n.exec(e))!==null;)t.index>i&&h.push({text:e.slice(i,t.index),highlight:!1}),h.push({text:t[0],highlight:!0}),i=t.index+t[0].length;return i<e.length&&h.push({text:e.slice(i),highlight:!1}),h}exports.highlightSegments=g;
+//# sourceMappingURL=highlightSegments.js.map

package/lib/ExpressionInput/index.css

@@ -0,0 +1 @@
+@charset "UTF-8";.paraui-v4-expression-input{display:inline-block;width:100%}.paraui-v4-expression-input input{position:relative;z-index:1;color:transparent!important;caret-color:#1d2126!important}.paraui-v4-expression-input-overlay{position:absolute;inset:0;z-index:0;overflow:hidden;color:#1d2126;white-space:pre;pointer-events:none}.paraui-v4-expression-input-overlay-highlight{color:#2e65e6}.paraui-v4-expression-input-popup{z-index:1500;min-width:280px;overflow:hidden;background:#fff;border:1px solid rgb(212,218,227);border-radius:4px;box-shadow:0 2px 8px #d4dae366}.paraui-v4-expression-input-popup-header{padding:6px 12px;font-size:12px;color:#a1a8b3;border-bottom:1px solid rgb(234,236,241)}.paraui-v4-expression-input-popup-list{padding:4px 0}.paraui-v4-expression-input-popup-item{display:flex;align-items:center;padding:0 12px;font-size:14px;color:#1d2126;white-space:nowrap;cursor:pointer}.paraui-v4-expression-input-popup-item-active{color:#2e65e6;background:#f0f5ff}.paraui-v4-expression-input-popup-item-value{flex:0 0 auto;margin-right:8px}.paraui-v4-expression-input-popup-item-desc{flex:1 1 auto;overflow:hidden;font-size:12px;color:#a1a8b3;text-overflow:ellipsis}.paraui-v4-expression-input-popup-item-lock{flex:0 0 auto;margin-left:8px;font-size:16px;color:#a1a8b3}

package/lib/ExpressionInput/index.d.ts

@@ -0,0 +1,5 @@
+import { ExpressionInputProps } from './interface';
+import * as React from 'react';
+declare const ExpressionInput: React.FunctionComponent<ExpressionInputProps>;
+export default ExpressionInput;
+export * from './interface';

package/lib/ExpressionInput/index.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const p=require("../_virtual/jsx-runtime.js");;/* empty css            */const Q=require("react"),Y=require("react-dom"),ee=require("@snack-kit/lib"),te=require("../TextField/index.js"),ne=require("../Tooltip/index.js"),re=require("../GlobalContext/usePopupContainer.js"),oe=require("../GlobalContext/useFormatMessage.js"),T=require("../GlobalContext/constant.js"),se=require("./useExpressionInput.js"),ie=require("./Popup.js"),ue=require("./isExpressionValue.js"),ce=require("./highlightSegments.js"),le=require("./HighlightOverlay.js"),ae=require("./lang/index.js");function _(o){const s=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(o){for(const i in o)if(i!=="default"){const f=Object.getOwnPropertyDescriptor(o,i);Object.defineProperty(s,i,f.get?f:{enumerable:!0,get:()=>o[i]})}}return s.default=o,Object.freeze(s)}const n=_(Q),z=_(Y),de=50,pe="$",fe=o=>{const{value:s,onChange:i,resolveCandidates:f,triggerMode:S="braces",triggerPrefix:h=pe,virtualizeThreshold:D=de,renderPopupHeader:y,expressionTooltip:x,disabled:b,readOnly:F,className:w,...v}=o,P=oe.default("ExpressionInput",ae.default),[E]=n.useState(()=>`${T.$prefixCls}-expression-input-${ee.UUID()}`),r=n.useRef(null),q=n.useRef(null),I=n.useRef({getRootDomNode:()=>r.current}),M=re.default(I),[$,H]=n.useState({top:0,left:0,width:0}),a=n.useRef(null),[L,U]=n.useState(null),[V,N]=n.useState({}),d=String(s??""),W=n.useMemo(()=>ce.highlightSegments(d),[d]),{open:u,ctx:g,candidates:m,highlight:k,setHighlight:A,handleValueChange:B,handleKeyDown:K,handleSelect:G,close:C,pendingCursorRef:R}=se.useExpressionInput({value:d,onChange:i,resolveCandidates:f,triggerMode:S,triggerPrefix:h,disabled:b,readOnly:F}),c=n.useCallback(()=>{const e=r.current?.querySelector("input, textarea");if(!e)return;const t=e.getBoundingClientRect();H({top:t.bottom+4,left:t.left,width:Math.max(t.width,280)})},[]),l=n.useCallback(()=>{const e=r.current?.querySelector("input, textarea");if(!e)return;U(e.parentElement);const t=window.getComputedStyle(e);N({paddingTop:t.paddingTop,paddingRight:t.paddingRight,paddingBottom:t.paddingBottom,paddingLeft:t.paddingLeft,fontFamily:t.fontFamily,fontSize:t.fontSize,fontWeight:t.fontWeight,lineHeight:t.lineHeight,letterSpacing:t.letterSpacing,boxSizing:t.boxSizing,borderWidth:t.borderWidth,borderStyle:t.borderStyle,borderColor:"transparent"})},[]);n.useLayoutEffect(()=>{l(),window.addEventListener("resize",l);const e=r.current;let t;return e&&typeof ResizeObserver<"u"&&(t=new ResizeObserver(l),t.observe(e)),()=>{window.removeEventListener("resize",l),t?.disconnect()}},[l]),n.useEffect(()=>{const e=r.current?.querySelector("input, textarea");if(!e)return;const t=()=>{a.current&&(a.current.scrollLeft=e.scrollLeft)};return e.addEventListener("scroll",t),()=>e.removeEventListener("scroll",t)},[]),n.useEffect(()=>{const e=r.current?.querySelector("input, textarea");e&&a.current&&(a.current.scrollLeft=e.scrollLeft)},[s]),n.useEffect(()=>{const e=R.current;if(e===null)return;const t=r.current?.querySelector("input, textarea");t&&(t.focus(),t.setSelectionRange(e,e)),R.current=null},[s,R]),n.useEffect(()=>{if(u)return c(),window.addEventListener("scroll",c,!0),window.addEventListener("resize",c),()=>{window.removeEventListener("scroll",c,!0),window.removeEventListener("resize",c)}},[u,c]),n.useEffect(()=>{if(!u)return;const e=t=>{const O=t.target;r.current?.contains(O)||q.current?.contains(O)||C()};return document.addEventListener("mousedown",e,!0),()=>document.removeEventListener("mousedown",e,!0)},[u,C,E]);const X=e=>{const t=e.target.selectionStart??e.target.value.length;B(e.target.value,t)},Z=g?y?y(g,m.length):P({id:"header"},{path:g.parts.length?g.parts.join("."):h,count:m.length}):null,J=!!x&&ue.isExpressionValue(d,h,S),j=p.jsxRuntimeExports.jsx(te.TextField,{...v,value:d,disabled:b,onChange:X,onFocus:e=>{l(),v.onFocus?.(e)},onKeydown:e=>{K(e),v.onKeydown?.(e)}});return p.jsxRuntimeExports.jsxs("div",{ref:r,className:`${T.$prefixCls}-expression-input ${E}${w?` ${w}`:""}`,children:[x?p.jsxRuntimeExports.jsx(ne.Tooltip,{title:x,trigger:["hover","focus"],...J?{}:{visible:!1},children:j}):j,L&&z.createPortal(p.jsxRuntimeExports.jsx(le.default,{ref:a,segments:W,style:V}),L),u&&r.current&&z.createPortal(p.jsxRuntimeExports.jsx(ie.Popup,{ref:q,instanceClass:E,visible:u,rect:$,header:Z,candidates:m,highlight:k,virtualizeThreshold:D,onSelect:G,onHighlightChange:A}),M(r.current))]})};exports.default=fe;
+//# sourceMappingURL=index.js.map

package/lib/ExpressionInput/interface.d.ts

@@ -0,0 +1,52 @@
+import { TextFieldProps } from '../TextField';
+import * as React from 'react';
+export interface ExprCandidate {
+    /** 插入表达式时使用的实际值 */
+    value: string;
+    /** 展示用名称,不传则显示 value */
+    label?: string;
+    /** 右侧描述文案 */
+    desc?: string;
+    /** 选中后是否自动追加 `.` 以便继续下钻子级 */
+    chain?: boolean;
+    /** 是否为敏感字段,展示锁图标 */
+    sensitive?: boolean;
+}
+export interface ExprChainCtx {
+    /** 当前光标所在链路中,已确定的上级片段(不含正在输入的部分) */
+    parts: string[];
+    /** 当前正在输入、尚未确定的片段 */
+    partial: string;
+}
+export interface ExpressionInputProps extends Omit<TextFieldProps, 'value' | 'onChange'> {
+    value?: string;
+    onChange?: (value: string) => void;
+    /**
+     * 只读态,输入触发前缀时不弹出候选浮层。
+     * 注:仓库现有 TextField 无 readOnly 能力,该态仅影响候选弹出逻辑,不改变输入框本身的可编辑外观。
+     */
+    readOnly?: boolean;
+    /**
+     * 按当前命名空间路径(不含正在输入的 partial)返回该层级的完整候选列表。
+     * 仅在 parts 变化(下钻/回退层级)时调用,组件内部按 parts 缓存结果;
+     * 同层级内继续输入 partial 只做客户端过滤,不会重复调用。
+     */
+    resolveCandidates: (parts: string[]) => ExprCandidate[];
+    /**
+     * 触发匹配机制,默认 'braces':仅当光标位于 `{{ }}` 区间内且内容匹配
+     * `{prefix}.xxx` 才弹窗。'bare':不要求大括号包裹,对齐 Ditto 原始行为。
+     */
+    triggerMode?: 'braces' | 'bare';
+    /** 触发表达式补全的前缀符号,默认 '$' */
+    triggerPrefix?: string;
+    /** 候选数量超过该阈值时启用虚拟滚动,默认 50 */
+    virtualizeThreshold?: number;
+    /** 自定义浮层 header 文案(面包屑 + 数量 + 快捷键提示),不传则使用默认 i18n 文案 */
+    renderPopupHeader?: (ctx: ExprChainCtx, count: number) => React.ReactNode;
+    /**
+     * 表达式说明 tooltip 文案,不传则不展示;仅当 value 命中表达式格式(braces/bare)时,hover/focus 输入框才会真正弹出。
+     * 注:是否命中只在触发 hover/focus 那一刻判定,若光标停留期间继续输入使 value 从未命中变为命中,
+     * 不会自动弹出,需要重新 hover/focus 才会展示——这是已知的边界行为,非 bug。
+     */
+    expressionTooltip?: React.ReactNode;
+}

package/lib/ExpressionInput/isExpressionValue.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 判断 value 是否已经是一段完整的表达式引用,用于决定是否展示 expressionTooltip 说明。
+ * braces 模式要求 `{{ prefix.xxx }}` 完整闭合;bare 模式只要求文本中出现 `prefix.xxx` 即可。
+ */
+export declare function isExpressionValue(value: string, triggerPrefix: string, triggerMode: 'braces' | 'bare'): boolean;

package/lib/ExpressionInput/isExpressionValue.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./detectChainAtCursor.js");function i(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function o(e){const r=i(e),t=`${s.ID_TAIL.source}+`;return`${r}\\.${t}(?:\\.${t})*`}function c(e,r,t){if(!e)return!1;const n=o(r);return t==="braces"?new RegExp(`\\{\\{\\s*${n}\\s*\\}\\}`).test(e):new RegExp(n).test(e)}exports.isExpressionValue=c;
+//# sourceMappingURL=isExpressionValue.js.map

package/lib/ExpressionInput/lang/en_US.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    header: string;
+};
+export default _default;

package/lib/ExpressionInput/lang/en_US.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e={header:"{path} · {count} items · ↑↓ select · Enter/Tab insert · Esc close"};exports.default=e;
+//# sourceMappingURL=en_US.js.map

package/lib/ExpressionInput/lang/index.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    zh: {
+        header: string;
+    };
+    en: {
+        header: string;
+    };
+};
+export default _default;

package/lib/ExpressionInput/lang/index.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./en_US.js"),t=require("./zh_CN.js"),u={zh:t.default,en:e.default};exports.default=u;
+//# sourceMappingURL=index.js.map

package/lib/ExpressionInput/lang/zh_CN.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    header: string;
+};
+export default _default;

package/lib/ExpressionInput/lang/zh_CN.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e={header:"{path} · {count} 项 · ↑↓ 选择 · Enter/Tab 插入 · Esc 关闭"};exports.default=e;
+//# sourceMappingURL=zh_CN.js.map

package/lib/ExpressionInput/style/css.js

@@ -0,0 +1 @@
+import './index.css';

package/lib/ExpressionInput/style/index.css

@@ -0,0 +1 @@
+.paraui-v4-expression-input{display:inline-block;width:100%}.paraui-v4-expression-input input{position:relative;z-index:1;color:rgba(0,0,0,0) !important;caret-color:#1d2126 !important}.paraui-v4-expression-input-overlay{position:absolute;top:0;right:0;bottom:0;left:0;z-index:0;overflow:hidden;color:#1d2126;white-space:pre;pointer-events:none}.paraui-v4-expression-input-overlay-highlight{color:#2e65e6}.paraui-v4-expression-input-popup{z-index:1500;min-width:280px;overflow:hidden;background:#fff;border:1px solid #d4dae3;border-radius:4px;box-shadow:0px 2px 8px 0px rgba(212,218,227,.4)}.paraui-v4-expression-input-popup-header{padding:6px 12px;font-size:12px;color:#a1a8b3;border-bottom:1px solid #eaecf1}.paraui-v4-expression-input-popup-list{padding:4px 0}.paraui-v4-expression-input-popup-item{display:flex;align-items:center;padding:0 12px;font-size:14px;color:#1d2126;white-space:nowrap;cursor:pointer}.paraui-v4-expression-input-popup-item-active{color:#2e65e6;background:#f0f5ff}.paraui-v4-expression-input-popup-item-value{flex:0 0 auto;margin-right:8px}.paraui-v4-expression-input-popup-item-desc{flex:1 1 auto;overflow:hidden;font-size:12px;color:#a1a8b3;text-overflow:ellipsis}.paraui-v4-expression-input-popup-item-lock{flex:0 0 auto;margin-left:8px;font-size:16px;color:#a1a8b3}

package/lib/ExpressionInput/style/index.js

@@ -0,0 +1 @@
+import './index.css';

package/lib/ExpressionInput/useExpressionInput.d.ts

@@ -0,0 +1,26 @@
+import { ExprCandidate, ExprChainCtx } from './interface';
+import * as React from 'react';
+export interface UseExpressionInputOptions {
+    value: string;
+    onChange?: (value: string) => void;
+    resolveCandidates: (parts: string[]) => ExprCandidate[];
+    triggerMode: 'braces' | 'bare';
+    triggerPrefix: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+}
+export interface UseExpressionInputResult {
+    open: boolean;
+    ctx: ExprChainCtx | null;
+    candidates: ExprCandidate[];
+    highlight: number;
+    /** 手动指定当前高亮索引,供鼠标移入候选行时与键盘 ArrowUp/Down 共享同一份高亮状态,避免出现两套独立高亮源 */
+    setHighlight: (index: number) => void;
+    /** 插入候选后期望的光标落点(相对新 value 的下标),供 Task 6 index.tsx 把光标设置到实际 DOM input 上;未处于"刚插入"状态时为 null */
+    pendingCursorRef: React.MutableRefObject<number | null>;
+    handleValueChange: (nextValue: string, cursor: number) => void;
+    handleKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    handleSelect: (candidate: ExprCandidate) => void;
+    close: () => void;
+}
+export declare function useExpressionInput(options: UseExpressionInputOptions): UseExpressionInputResult;

package/lib/ExpressionInput/useExpressionInput.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("react"),R=require("./detectChainAtCursor.js"),$=require("./filterCandidatesByPartial.js");function A(s){const l=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(s){for(const a in s)if(a!=="default"){const o=Object.getOwnPropertyDescriptor(s,a);Object.defineProperty(l,a,o.get?o:{enumerable:!0,get:()=>s[a]})}}return l.default=s,Object.freeze(l)}const r=A(P);function E(s){const{value:l,onChange:a,resolveCandidates:o,triggerMode:y,triggerPrefix:u,disabled:p,readOnly:g}=s,[t,i]=r.useState(null),[h,f]=r.useState(0),S=r.useRef(new Map),k=r.useRef(null),m=r.useMemo(()=>{if(!t)return[];const e=t.parts.join("."),n=S.current;return n.has(e)||n.set(e,o(t.parts)),n.get(e)},[t,o]),c=r.useMemo(()=>t?$.filterCandidatesByPartial(m,t.partial):[],[m,t]),C=!p&&!g&&!!t&&c.length>0,j=r.useCallback((e,n)=>{if(p||g){i(null);return}a?.(e);const b=R.detectChainAtCursor(e,n,{triggerPrefix:u,triggerMode:y});i(b),f(0)},[a,p,g,u,y]),w=r.useCallback(()=>i(null),[]),d=r.useCallback(e=>{if(!t)return;const n=l.slice(0,t.startIdx),b=l.slice(t.endIdx),M=[...t.parts,e.value].join("."),D=`${u}.${M}${e.chain?".":""}`;k.current=n.length+D.length,a?.(`${n}${D}${b}`),i(null)},[t,l,a,u]),x=r.useCallback(e=>{C&&(e.key==="ArrowDown"?(e.preventDefault(),f(n=>(n+1)%c.length)):e.key==="ArrowUp"?(e.preventDefault(),f(n=>(n-1+c.length)%c.length)):e.key==="Enter"||e.key==="Tab"?(e.preventDefault(),d(c[h])):e.key==="Escape"&&(e.preventDefault(),i(null)))},[C,c,h,d]),O=r.useCallback(e=>{d(e)},[d]);return{open:C,ctx:t?{parts:t.parts,partial:t.partial}:null,candidates:c,highlight:h,setHighlight:f,pendingCursorRef:k,handleValueChange:j,handleKeyDown:x,handleSelect:O,close:w}}exports.useExpressionInput=E;
+//# sourceMappingURL=useExpressionInput.js.map

package/lib/FieldForm/FieldFormItem/ItemHolder.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../_virtual/jsx-runtime.js"),n=require("react"),F=require("../../_virtual/index2.js"),H=require("rc-util/lib/Dom/isVisible"),N=require("rc-util/lib/hooks/useLayoutEffect"),h=require("../context.js"),O=require("../FormItemLabel.js"),T=require("../FormItemInput.js"),V=require("./StatusProvider.js");function W(a){const{className:p,style:b,helperText:o,errors:c,warnings:d,status:e,hidden:j,children:y,fieldId:r,required:q,onSubItemMetaChange:S,layout:m,hideLabel:v,hideError:E,noSpacing:I,label:R,labelProps:C,labelAlign:L,colon:M,labelWidth:P,labelWrap:_}=a,{prefixCls:i,layout:x}=n.useContext(h.FormContext),l=n.useMemo(()=>m??x,[m,x]),s=n.useRef(null),f=!!(o!=null||c.length||d.length),$=!!s.current&&H(s.current),[w,g]=n.useState(null);N(()=>{if(f&&s.current){const u=getComputedStyle(s.current);g(parseInt(u.marginBottom,10))}},[f,$]);const B=u=>{u||g(null)};return t.jsxRuntimeExports.jsx(V.default,{...a,prefixCls:i,children:t.jsxRuntimeExports.jsxs("div",{className:F.default(p,`${i}-item`,{[`${i}-item__${r}`]:r,"is-success":e==="success","is-warning":e==="warning","is-error":e==="error","is-validating":e==="validating","is-hidden":j,[`is-${l}`]:l}),style:b,children:[t.jsxRuntimeExports.jsx(O.default,{fieldId:r,label:R,labelWidth:P,labelWrap:_,labelAlign:L,colon:M,labelProps:{required:q,...C},hideLabel:v,layout:l}),t.jsxRuntimeExports.jsx(T.default,{fieldId:r,errors:c,warnings:d,status:e,helperText:o,marginBottom:w,onErrorVisibleChanged:B,hideError:E,noSpacing:I,children:t.jsxRuntimeExports.jsx(h.NoStyleItemContext.Provider,{value:S,children:y})})]})})}exports.default=W;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../_virtual/jsx-runtime.js"),n=require("react"),F=require("../../_virtual/index.js"),H=require("rc-util/lib/Dom/isVisible"),N=require("rc-util/lib/hooks/useLayoutEffect"),h=require("../context.js"),O=require("../FormItemLabel.js"),T=require("../FormItemInput.js"),V=require("./StatusProvider.js");function W(a){const{className:p,style:b,helperText:o,errors:c,warnings:d,status:e,hidden:j,children:y,fieldId:r,required:q,onSubItemMetaChange:S,layout:m,hideLabel:v,hideError:E,noSpacing:I,label:R,labelProps:C,labelAlign:L,colon:M,labelWidth:P,labelWrap:_}=a,{prefixCls:i,layout:x}=n.useContext(h.FormContext),l=n.useMemo(()=>m??x,[m,x]),s=n.useRef(null),f=!!(o!=null||c.length||d.length),$=!!s.current&&H(s.current),[w,g]=n.useState(null);N(()=>{if(f&&s.current){const u=getComputedStyle(s.current);g(parseInt(u.marginBottom,10))}},[f,$]);const B=u=>{u||g(null)};return t.jsxRuntimeExports.jsx(V.default,{...a,prefixCls:i,children:t.jsxRuntimeExports.jsxs("div",{className:F.default(p,`${i}-item`,{[`${i}-item__${r}`]:r,"is-success":e==="success","is-warning":e==="warning","is-error":e==="error","is-validating":e==="validating","is-hidden":j,[`is-${l}`]:l}),style:b,children:[t.jsxRuntimeExports.jsx(O.default,{fieldId:r,label:R,labelWidth:P,labelWrap:_,labelAlign:L,colon:M,labelProps:{required:q,...C},hideLabel:v,layout:l}),t.jsxRuntimeExports.jsx(T.default,{fieldId:r,errors:c,warnings:d,status:e,helperText:o,marginBottom:w,onErrorVisibleChanged:B,hideError:E,noSpacing:I,children:t.jsxRuntimeExports.jsx(h.NoStyleItemContext.Provider,{value:S,children:y})})]})})}exports.default=W;
 //# sourceMappingURL=ItemHolder.js.map

package/lib/FieldForm/FieldFormItem/MemoInput.d.ts

@@ -1,9 +1,9 @@
 import { default as React } from 'react';
 interface MemoInputProps {
     control: object;
-    update: any;
+    update: unknown;
     children: React.ReactNode;
-    childProps: any[];
+    childProps: unknown[];
 }
 declare const _default: React.MemoExoticComponent<({ children }: MemoInputProps) => JSX.Element>;
 export default _default;

package/lib/FieldForm/FieldFormItem/StatusProvider.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const o=require("../../_virtual/jsx-runtime.js"),l=require("react"),j=require("../../node_modules/@para-ui/icons/Loading/index.js"),C=require("../../node_modules/@para-ui/icons/CheckCircleF/index.js"),g=require("../../node_modules/@para-ui/icons/CloseCircleF/index.js"),k=require("../../node_modules/@para-ui/icons/WarningCircleF/index.js"),v=require("../../_virtual/index2.js"),x=require("../context.js"),$=require("../util.js"),S={success:C.CheckCircleF,warning:k.WarningCircleF,error:g.CloseCircleF,validating:j.Loading};function R({children:I,errors:r,warnings:s,hasFeedback:e,validateStatus:p,prefixCls:u,meta:f,noStyle:c}){const t=$.getStatus(r,s,f,null,!!e,p),{isFormItemInput:i,status:a,hasFeedback:q,feedbackIcon:F}=l.useContext(x.FormItemInputContext),b=l.useMemo(()=>{let d;if(e){const m=t&&S[t];d=m?o.jsxRuntimeExports.jsx("span",{className:v.default(`${u}-feedback-icon`,`${u}-feedback-icon-${t}`),children:o.jsxRuntimeExports.jsx(m,{})}):null}const n={status:t||"",errors:r,warnings:s,hasFeedback:!!e,feedbackIcon:d,isFormItemInput:!0};return c&&(n.status=(t??a)||"",n.isFormItemInput=i,n.hasFeedback=!!(e??q),n.feedbackIcon=e!==void 0?n.feedbackIcon:F),n},[t,e,c,i,a]);return o.jsxRuntimeExports.jsx(x.FormItemInputContext.Provider,{value:b,children:I})}exports.default=R;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const o=require("../../_virtual/jsx-runtime.js"),l=require("react"),j=require("../../para-ui-core/node_modules/@para-ui/icons/Loading/index.js"),C=require("../../para-ui-core/node_modules/@para-ui/icons/CheckCircleF/index.js"),g=require("../../para-ui-core/node_modules/@para-ui/icons/CloseCircleF/index.js"),k=require("../../para-ui-core/node_modules/@para-ui/icons/WarningCircleF/index.js"),v=require("../../_virtual/index.js"),x=require("../context.js"),$=require("../util.js"),S={success:C.CheckCircleF,warning:k.WarningCircleF,error:g.CloseCircleF,validating:j.Loading};function R({children:I,errors:r,warnings:s,hasFeedback:e,validateStatus:p,prefixCls:u,meta:f,noStyle:c}){const t=$.getStatus(r,s,f,null,!!e,p),{isFormItemInput:i,status:a,hasFeedback:q,feedbackIcon:F}=l.useContext(x.FormItemInputContext),b=l.useMemo(()=>{let d;if(e){const m=t&&S[t];d=m?o.jsxRuntimeExports.jsx("span",{className:v.default(`${u}-feedback-icon`,`${u}-feedback-icon-${t}`),children:o.jsxRuntimeExports.jsx(m,{})}):null}const n={status:t||"",errors:r,warnings:s,hasFeedback:!!e,feedbackIcon:d,isFormItemInput:!0};return c&&(n.status=(t??a)||"",n.isFormItemInput=i,n.hasFeedback=!!(e??q),n.feedbackIcon=e!==void 0?n.feedbackIcon:F),n},[t,e,c,i,a]);return o.jsxRuntimeExports.jsx(x.FormItemInputContext.Provider,{value:b,children:I})}exports.default=R;
 //# sourceMappingURL=StatusProvider.js.map

package/lib/FieldForm/FieldFormItem/index.d.ts

@@ -6,9 +6,9 @@ import { FormItemInputProps } from '../FormItemInput';
 import { FormItemLabelProps } from '../FormItemLabel';
 import { ReportMetaChange } from '../context';
 import { default as useFormItemStatus } from '../hooks/useFormItemStatus';
-type RenderChildren<Values = any> = (form: FormInstance<Values>) => ReactNode;
-type RcFieldProps<Values = any> = Omit<FieldProps<Values>, 'children'>;
-type ChildrenType<Values = any> = RenderChildren<Values> | ReactNode;
+type RenderChildren<Values = unknown> = (form: FormInstance<Values>) => ReactNode;
+type RcFieldProps<Values = unknown> = Omit<FieldProps<Values>, 'children'>;
+type ChildrenType<Values = unknown> = RenderChildren<Values> | ReactNode;
 declare const ValidateStatuses: readonly ["success", "warning", "error", "validating", ""];
 export type ValidateStatus = (typeof ValidateStatuses)[number];
 export type FeedbackIcons = (itemStatus: {
@@ -18,7 +18,7 @@ export type FeedbackIcons = (itemStatus: {
 }) => {
     [key in ValidateStatus]?: ReactNode;
 };
-export interface FormItemProps<Values = any> extends FormItemLabelProps, FormItemInputProps, RcFieldProps<Values> {
+export interface FormItemProps<Values = unknown> extends FormItemLabelProps, FormItemInputProps, RcFieldProps<Values> {
     noStyle?: boolean;
     style?: CSSProperties;
     className?: string;
@@ -28,7 +28,7 @@ export interface FormItemProps<Values = any> extends FormItemLabelProps, FormIte
     validateStatus?: ValidateStatus;
     required?: boolean;
     hidden?: boolean;
-    initialValue?: any;
+    initialValue?: unknown;
     messageVariables?: Record<string, string>;
     layout?: FormItemLayout;
     hideError?: boolean;
@@ -45,7 +45,7 @@ export interface ItemHolderProps extends FormItemProps {
     isRequired?: boolean;
     onSubItemMetaChange: ReportMetaChange;
 }
-declare function InternalFormItem<Values = any>(props: FormItemProps<Values>): ReactElement;
+declare function InternalFormItem<Values = unknown>(props: FormItemProps<Values>): ReactElement;
 type InternalFormItemType = typeof InternalFormItem;
 type CompoundedComponent = InternalFormItemType & {
     useStatus: typeof useFormItemStatus;

package/lib/FieldForm/Form.d.ts

@@ -10,7 +10,7 @@ export type RequiredMark = boolean | 'optional' | ((labelNode: ReactNode, info:
 }) => ReactNode);
 export type FormLayout = 'horizontal' | 'vertical';
 export type FormItemLayout = 'horizontal' | 'vertical';
-export interface FormProps<Values = any> extends Omit<RcFormProps<Values>, 'form'> {
+export interface FormProps<Values = unknown> extends Omit<RcFormProps<Values>, 'form'> {
     colon?: boolean;
     name?: string;
     layout?: FormLayout;
@@ -23,6 +23,6 @@ export interface FormProps<Values = any> extends Omit<RcFormProps<Values>, 'form
     requiredMark?: RequiredMark;
     size?: 'small' | 'medium' | 'large';
 }
-declare const FieldForm: (<Values = any>(props: PropsWithChildren<FormProps<Values>> & RefAttributes<FormRef<Values>>) => ReactElement) & Pick<FC, "displayName">;
+declare const FieldForm: (<Values = unknown>(props: PropsWithChildren<FormProps<Values>> & RefAttributes<FormRef<Values>>) => ReactElement) & Pick<FC, "displayName">;
 export { useForm, useWatch, type FormInstance };
 export default FieldForm;