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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (556) hide show
  1. package/AGENTS.md +315 -0
  2. package/AlignBox/component.json +89 -0
  3. package/Anchor/component.json +130 -0
  4. package/Argv/component.json +216 -0
  5. package/AutoBox/component.json +133 -0
  6. package/AutoButton/component.json +109 -0
  7. package/AutoTips/component.json +121 -0
  8. package/Badge/component.json +92 -0
  9. package/Breadcrumbs/component.json +142 -0
  10. package/Button/component.json +168 -0
  11. package/ButtonGroup/component.json +132 -0
  12. package/Card/component.json +162 -0
  13. package/Carousel/component.json +142 -0
  14. package/Cascader/component.json +196 -0
  15. package/Checkbox/component.json +138 -0
  16. package/CheckboxGroup/component.json +152 -0
  17. package/CodeEditor/component.json +189 -0
  18. package/Collapse/component.json +166 -0
  19. package/CollapseBox/component.json +84 -0
  20. package/CollapseLayout/component.json +155 -0
  21. package/ColorPicker/component.json +142 -0
  22. package/ComboSelect/component.json +181 -0
  23. package/Container/component.json +111 -0
  24. package/ContentBox/component.json +81 -0
  25. package/CopyText/component.json +118 -0
  26. package/CycleSelector/component.json +98 -0
  27. package/DatePicker/component.json +192 -0
  28. package/Descriptions/component.json +142 -0
  29. package/Desktop/component.json +171 -0
  30. package/DragVerify/component.json +114 -0
  31. package/Drawer/component.json +200 -0
  32. package/Dropdown/component.json +147 -0
  33. package/DynamicMultiBox/component.json +278 -0
  34. package/Empty/component.json +123 -0
  35. package/FieldForm/component.json +196 -0
  36. package/Form/component.json +161 -0
  37. package/FormItem/component.json +171 -0
  38. package/FunctionModal/component.json +197 -0
  39. package/Help/component.json +118 -0
  40. package/HelperText/component.json +126 -0
  41. package/Image/component.json +165 -0
  42. package/InputCode/component.json +191 -0
  43. package/InputLang/component.json +205 -0
  44. package/InputNumber/component.json +162 -0
  45. package/Label/component.json +126 -0
  46. package/Loading/component.json +91 -0
  47. package/Menu/component.json +180 -0
  48. package/Message/component.json +246 -0
  49. package/Modal/component.json +277 -0
  50. package/MultiBox/component.json +216 -0
  51. package/Notification/component.json +184 -0
  52. package/OperateBtn/component.json +134 -0
  53. package/PageHeader/component.json +112 -0
  54. package/Pagination/component.json +181 -0
  55. package/PasswordRules/component.json +105 -0
  56. package/PopConfirm/component.json +227 -0
  57. package/PopMenu/component.json +131 -0
  58. package/Popover/component.json +165 -0
  59. package/Progress/component.json +161 -0
  60. package/Prompt/component.json +144 -0
  61. package/Querying/component.json +96 -0
  62. package/QuickReply/component.json +129 -0
  63. package/Radio/component.json +136 -0
  64. package/RadioGroup/component.json +149 -0
  65. package/RangeInput/component.json +198 -0
  66. package/Result/component.json +104 -0
  67. package/ScrollBar/component.json +115 -0
  68. package/Search/component.json +177 -0
  69. package/Select/component.json +244 -0
  70. package/SelectInput/component.json +184 -0
  71. package/Selector/component.json +203 -0
  72. package/SelectorPicker/component.json +179 -0
  73. package/SingleBox/component.json +151 -0
  74. package/Slider/component.json +181 -0
  75. package/SortBox/component.json +108 -0
  76. package/Status/component.json +104 -0
  77. package/Stepper/component.json +129 -0
  78. package/Switch/component.json +207 -0
  79. package/Table/component.json +547 -0
  80. package/Tabs/component.json +227 -0
  81. package/Tag/component.json +221 -0
  82. package/TextEditor/component.json +186 -0
  83. package/TextField/component.json +290 -0
  84. package/TimePicker/component.json +176 -0
  85. package/Timeline/component.json +110 -0
  86. package/Title/component.json +156 -0
  87. package/ToggleButton/component.json +153 -0
  88. package/Tooltip/component.json +176 -0
  89. package/Transfer/component.json +157 -0
  90. package/Tree/component.json +512 -0
  91. package/Upload/component.json +450 -0
  92. package/ai-workflows/01-crud-list-multi-drawer.md +278 -0
  93. package/ai-workflows/02-rbac-operation-buttons.md +290 -0
  94. package/ai-workflows/03-complex-form-async-cascade.md +350 -0
  95. package/ai-workflows/04-array-field-form.md +281 -0
  96. package/ai-workflows/05-popconfirm-async-message-queue.md +333 -0
  97. package/ai-workflows/06-modal-drawer-form-workflow.md +385 -0
  98. package/ai-workflows/07-search-filter-table-trio.md +387 -0
  99. package/ai-workflows/08-table-advanced-features.md +365 -0
  100. package/ai-workflows/09-batch-operation-export-progress.md +367 -0
  101. package/ai-workflows/10-cross-component-state-coordination.md +412 -0
  102. package/es/AlignBox/component.json +89 -0
  103. package/es/AlignBox/index.css +1 -1
  104. package/es/AlignBox/index.d.ts +6 -2
  105. package/es/AlignBox/index.js +1 -1
  106. package/es/AlignBox/style/index.css +1 -1
  107. package/es/Anchor/anchorMenu/index.d.ts +2 -1
  108. package/es/Anchor/anchorMenu/index.js +36 -33
  109. package/es/Anchor/component.json +130 -0
  110. package/es/Anchor/index.js +50 -47
  111. package/es/Anchor/type.d.ts +8 -4
  112. package/es/Argv/component.json +216 -0
  113. package/es/Argv/index.d.ts +5 -6
  114. package/es/AutoBox/component.json +133 -0
  115. package/es/AutoBox/index.d.ts +3 -3
  116. package/es/AutoBox/index.js +1 -1
  117. package/es/AutoBox/protal.d.ts +2 -2
  118. package/es/AutoBox/protal.js +32 -29
  119. package/es/AutoButton/component.json +109 -0
  120. package/es/AutoButton/index.js +1 -1
  121. package/es/AutoTips/autoTipsMultiline/index.d.ts +1 -1
  122. package/es/AutoTips/autoTipsMultiline/index.js +1 -1
  123. package/es/AutoTips/component.json +121 -0
  124. package/es/Badge/component.json +92 -0
  125. package/es/Breadcrumbs/component.json +142 -0
  126. package/es/Breadcrumbs/index.js +1 -1
  127. package/es/Button/SplitButton.d.ts +2 -2
  128. package/es/Button/component.json +168 -0
  129. package/es/Button/index.js +44 -44
  130. package/es/ButtonGroup/component.json +132 -0
  131. package/es/ButtonGroup/index.d.ts +1 -1
  132. package/es/Card/component.json +162 -0
  133. package/es/Card/index.d.ts +2 -2
  134. package/es/Card/index.js +2 -2
  135. package/es/Carousel/component.json +142 -0
  136. package/es/Carousel/index.d.ts +1 -1
  137. package/es/Cascader/component.json +196 -0
  138. package/es/Cascader/hooks/useEntities.js +7 -7
  139. package/es/Cascader/interface.d.ts +1 -0
  140. package/es/Cascader/utils/commonUtil.d.ts +1 -1
  141. package/es/Cascader/utils/commonUtil.js +16 -16
  142. package/es/Cascader/utils/treeUtil.d.ts +14 -5
  143. package/es/Cascader/utils/treeUtil.js +1 -1
  144. package/es/Checkbox/component.json +138 -0
  145. package/es/CheckboxGroup/component.json +152 -0
  146. package/es/CodeEditor/component.json +189 -0
  147. package/es/CodeEditor/index.d.ts +10 -9
  148. package/es/Collapse/component.json +166 -0
  149. package/es/Collapse/index.d.ts +1 -1
  150. package/es/Collapse/index.js +23 -22
  151. package/es/CollapseBox/component.json +84 -0
  152. package/es/CollapseLayout/component.json +155 -0
  153. package/es/ColorPicker/component.json +142 -0
  154. package/es/ComboSelect/component.json +181 -0
  155. package/es/ComboSelect/index.js +73 -68
  156. package/es/ComboSelect/interface.d.ts +2 -2
  157. package/es/ComboSelect/utils.d.ts +3 -3
  158. package/es/ComboSelect/utils.js +1 -1
  159. package/es/Container/component.json +111 -0
  160. package/es/ContentBox/component.json +81 -0
  161. package/es/CopyText/component.json +118 -0
  162. package/es/CycleSelector/component.json +98 -0
  163. package/es/CycleSelector/index.js +14 -13
  164. package/es/DatePicker/component.json +192 -0
  165. package/es/DatePicker/generatePicker/generateRangePicker.js +10 -10
  166. package/es/DatePicker/generatePicker/generateSinglePicker.js +1 -1
  167. package/es/Descriptions/component.json +142 -0
  168. package/es/Descriptions/index.d.ts +1 -1
  169. package/es/Desktop/component.json +171 -0
  170. package/es/DragVerify/component.json +114 -0
  171. package/es/DragVerify/index.js +19 -19
  172. package/es/Drawer/component.json +200 -0
  173. package/es/Drawer/index.js +86 -86
  174. package/es/Drawer/interface.d.ts +1 -1
  175. package/es/Drawer/util.d.ts +1 -6
  176. package/es/Drawer/util.js +9 -6
  177. package/es/Dropdown/component.json +147 -0
  178. package/es/DynamicMultiBox/component.json +278 -0
  179. package/es/DynamicMultiBox/formItem.d.ts +1 -1
  180. package/es/DynamicMultiBox/rowForm.d.ts +2 -2
  181. package/es/Empty/component.json +123 -0
  182. package/es/Empty/index.css +1 -1
  183. package/es/Empty/index.d.ts +2 -2
  184. package/es/Empty/index.js +27 -26
  185. package/es/Empty/style/index.css +1 -1
  186. package/es/FieldForm/FieldFormItem/MemoInput.d.ts +2 -2
  187. package/es/FieldForm/FieldFormItem/index.d.ts +6 -6
  188. package/es/FieldForm/Form.d.ts +2 -2
  189. package/es/FieldForm/FormList.d.ts +2 -2
  190. package/es/FieldForm/component.json +196 -0
  191. package/es/FieldForm/context.d.ts +5 -1
  192. package/es/FieldForm/context.js +2 -2
  193. package/es/FieldForm/hooks/useForm.d.ts +4 -3
  194. package/es/FieldForm/hooks/useFormInstance.d.ts +1 -1
  195. package/es/FieldForm/hooks/useFormItemStatus.d.ts +9 -5
  196. package/es/FieldForm/hooks/useFormItemStatus.js +2 -2
  197. package/es/FieldForm/hooks/useItemRef.d.ts +1 -1
  198. package/es/FieldForm/hooks/useItemRef.js +6 -6
  199. package/es/Form/component.json +161 -0
  200. package/es/Form/index.d.ts +52 -49
  201. package/es/FormItem/compoments/defaultCompoments/index.d.ts +5 -5
  202. package/es/FormItem/compoments/defaultCompoments/index.js +12 -11
  203. package/es/FormItem/compoments/formCheckboxGroup/index.d.ts +2 -2
  204. package/es/FormItem/compoments/formFile/index.js +8 -8
  205. package/es/FormItem/compoments/formRadioGroup/index.d.ts +1 -1
  206. package/es/FormItem/compoments/formSelect/index.d.ts +1 -1
  207. package/es/FormItem/component.json +171 -0
  208. package/es/FormItem/index.d.ts +5 -5
  209. package/es/FormItem/index.js +23 -23
  210. package/es/FormItem/itemType.js +1 -1
  211. package/es/FunctionModal/component.json +197 -0
  212. package/es/FunctionModal/dialog.d.ts +1 -1
  213. package/es/FunctionModal/modalContext.d.ts +4 -1
  214. package/es/Help/component.json +118 -0
  215. package/es/HelperText/component.json +126 -0
  216. package/es/Image/component.json +165 -0
  217. package/es/InputCode/component.json +191 -0
  218. package/es/InputCode/index.d.ts +2 -2
  219. package/es/InputLang/component.json +205 -0
  220. package/es/InputLang/index.js +1 -1
  221. package/es/InputNumber/component.json +162 -0
  222. package/es/Label/component.json +126 -0
  223. package/es/Label/index.d.ts +2 -2
  224. package/es/Loading/component.json +91 -0
  225. package/es/Menu/component.json +180 -0
  226. package/es/Message/component.json +246 -0
  227. package/es/Message/index.d.ts +2 -2
  228. package/es/Message/index.js +2 -2
  229. package/es/Modal/Confirm/index.d.ts +1 -1
  230. package/es/Modal/component.json +277 -0
  231. package/es/Modal/index.d.ts +85 -5
  232. package/es/Modal/index.js +159 -122
  233. package/es/Modal/interface.d.ts +1 -0
  234. package/es/MultiBox/component.json +216 -0
  235. package/es/MultiBox/index.js +19 -14
  236. package/es/Notification/component.json +184 -0
  237. package/es/OperateBtn/component.json +134 -0
  238. package/es/OperateBtn/index.d.ts +3 -3
  239. package/es/PageHeader/component.json +112 -0
  240. package/es/Pagination/component.json +181 -0
  241. package/es/Pagination/index.js +15 -15
  242. package/es/PasswordRules/component.json +105 -0
  243. package/es/PasswordRules/index.d.ts +4 -4
  244. package/es/PopConfirm/component.json +227 -0
  245. package/es/PopConfirm/index.d.ts +1 -1
  246. package/es/PopConfirm/index.js +1 -1
  247. package/es/PopMenu/component.json +131 -0
  248. package/es/PopMenu/hooks.d.ts +1 -1
  249. package/es/PopMenu/index.js +8 -8
  250. package/es/Popover/component.json +165 -0
  251. package/es/Popover/index.js +1 -1
  252. package/es/Progress/component.json +161 -0
  253. package/es/Prompt/component.json +144 -0
  254. package/es/Querying/component.json +96 -0
  255. package/es/Querying/index.css +1 -1
  256. package/es/Querying/index.d.ts +2 -2
  257. package/es/Querying/index.js +20 -19
  258. package/es/Querying/style/index.css +1 -1
  259. package/es/QuickReply/component.json +129 -0
  260. package/es/QuickReply/index.d.ts +1 -1
  261. package/es/Radio/component.json +136 -0
  262. package/es/RadioGroup/component.json +149 -0
  263. package/es/RangeInput/component.json +198 -0
  264. package/es/RangeInput/index.js +1 -1
  265. package/es/Result/component.json +104 -0
  266. package/es/ScrollBar/component.json +115 -0
  267. package/es/Search/component.json +177 -0
  268. package/es/Search/index.d.ts +1 -1
  269. package/es/Select/component.json +244 -0
  270. package/es/Select/index.js +113 -113
  271. package/es/SelectInput/component.json +184 -0
  272. package/es/Selector/component.json +203 -0
  273. package/es/Selector/index.js +28 -27
  274. package/es/Selector/interface.d.ts +1 -1
  275. package/es/Selector/selectorMain/index.js +2 -2
  276. package/es/Selector/selectorNode/index.js +1 -1
  277. package/es/Selector/util.d.ts +2 -2
  278. package/es/SelectorPicker/component.json +179 -0
  279. package/es/SelectorPicker/index.d.ts +5 -5
  280. package/es/SelectorPicker/index.js +15 -15
  281. package/es/SingleBox/component.json +151 -0
  282. package/es/SingleBox/index.d.ts +2 -2
  283. package/es/Slider/component.json +181 -0
  284. package/es/SortBox/component.json +108 -0
  285. package/es/Status/component.json +104 -0
  286. package/es/Stepper/component.json +129 -0
  287. package/es/Stepper/index.d.ts +2 -2
  288. package/es/Switch/component.json +207 -0
  289. package/es/Switch/index.css +1 -1
  290. package/es/Switch/index.d.ts +3 -2
  291. package/es/Switch/index.js +60 -59
  292. package/es/Switch/style/index.css +1 -1
  293. package/es/Table/component.json +547 -0
  294. package/es/Table/index.d.ts +2 -2
  295. package/es/Table/index.js +414 -414
  296. package/es/Table/interface.d.ts +6 -0
  297. package/es/Tabs/component.json +227 -0
  298. package/es/Tag/component.json +221 -0
  299. package/es/Tag/index.css +1 -1
  300. package/es/Tag/index.d.ts +1 -1
  301. package/es/Tag/index.js +20 -20
  302. package/es/Tag/style/index.css +1 -1
  303. package/es/TextEditor/component.json +186 -0
  304. package/es/TextEditor/index.d.ts +5 -5
  305. package/es/TextField/component.json +290 -0
  306. package/es/TextField/index.d.ts +2 -2
  307. package/es/TimePicker/component.json +176 -0
  308. package/es/Timeline/component.json +110 -0
  309. package/es/Title/component.json +156 -0
  310. package/es/ToggleButton/component.json +153 -0
  311. package/es/Tooltip/component.json +176 -0
  312. package/es/Tooltip/index.js +58 -53
  313. package/es/Tooltip/interface.d.ts +14 -1
  314. package/es/Tooltip/utils.js +6 -6
  315. package/es/Transfer/component.json +157 -0
  316. package/es/Tree/component.json +512 -0
  317. package/es/Upload/component.json +450 -0
  318. package/es/Utils/type.d.ts +0 -2
  319. package/es/index.d.ts +2 -0
  320. package/es/index.js +1 -1
  321. package/es/locale/en_US.d.ts +361 -0
  322. package/es/locale/en_US.js +364 -0
  323. package/es/locale/index.d.ts +1 -723
  324. package/es/locale/index2.js +10 -0
  325. package/es/locale/zh_CN.d.ts +361 -0
  326. package/es/locale/zh_CN.js +364 -0
  327. package/lib/AlignBox/component.json +89 -0
  328. package/lib/AlignBox/index.css +1 -1
  329. package/lib/AlignBox/index.d.ts +6 -2
  330. package/lib/AlignBox/index.js +1 -1
  331. package/lib/AlignBox/style/index.css +1 -1
  332. package/lib/Anchor/anchorMenu/index.d.ts +2 -1
  333. package/lib/Anchor/anchorMenu/index.js +1 -1
  334. package/lib/Anchor/component.json +130 -0
  335. package/lib/Anchor/index.js +1 -1
  336. package/lib/Anchor/type.d.ts +8 -4
  337. package/lib/Argv/component.json +216 -0
  338. package/lib/Argv/index.d.ts +5 -6
  339. package/lib/AutoBox/component.json +133 -0
  340. package/lib/AutoBox/index.d.ts +3 -3
  341. package/lib/AutoBox/index.js +1 -1
  342. package/lib/AutoBox/protal.d.ts +2 -2
  343. package/lib/AutoBox/protal.js +1 -1
  344. package/lib/AutoButton/component.json +109 -0
  345. package/lib/AutoButton/index.js +1 -1
  346. package/lib/AutoTips/autoTipsMultiline/index.d.ts +1 -1
  347. package/lib/AutoTips/autoTipsMultiline/index.js +1 -1
  348. package/lib/AutoTips/component.json +121 -0
  349. package/lib/Badge/component.json +92 -0
  350. package/lib/Breadcrumbs/component.json +142 -0
  351. package/lib/Breadcrumbs/index.js +1 -1
  352. package/lib/Button/SplitButton.d.ts +2 -2
  353. package/lib/Button/component.json +168 -0
  354. package/lib/Button/index.js +1 -1
  355. package/lib/ButtonGroup/component.json +132 -0
  356. package/lib/ButtonGroup/index.d.ts +1 -1
  357. package/lib/Card/component.json +162 -0
  358. package/lib/Card/index.d.ts +2 -2
  359. package/lib/Card/index.js +1 -1
  360. package/lib/Carousel/component.json +142 -0
  361. package/lib/Carousel/index.d.ts +1 -1
  362. package/lib/Cascader/component.json +196 -0
  363. package/lib/Cascader/hooks/useEntities.js +1 -1
  364. package/lib/Cascader/interface.d.ts +1 -0
  365. package/lib/Cascader/utils/commonUtil.d.ts +1 -1
  366. package/lib/Cascader/utils/commonUtil.js +1 -1
  367. package/lib/Cascader/utils/treeUtil.d.ts +14 -5
  368. package/lib/Cascader/utils/treeUtil.js +1 -1
  369. package/lib/Checkbox/component.json +138 -0
  370. package/lib/CheckboxGroup/component.json +152 -0
  371. package/lib/CodeEditor/component.json +189 -0
  372. package/lib/CodeEditor/index.d.ts +10 -9
  373. package/lib/Collapse/component.json +166 -0
  374. package/lib/Collapse/index.d.ts +1 -1
  375. package/lib/Collapse/index.js +1 -1
  376. package/lib/CollapseBox/component.json +84 -0
  377. package/lib/CollapseLayout/component.json +155 -0
  378. package/lib/ColorPicker/component.json +142 -0
  379. package/lib/ComboSelect/component.json +181 -0
  380. package/lib/ComboSelect/index.js +1 -1
  381. package/lib/ComboSelect/interface.d.ts +2 -2
  382. package/lib/ComboSelect/utils.d.ts +3 -3
  383. package/lib/ComboSelect/utils.js +1 -1
  384. package/lib/Container/component.json +111 -0
  385. package/lib/ContentBox/component.json +81 -0
  386. package/lib/CopyText/component.json +118 -0
  387. package/lib/CycleSelector/component.json +98 -0
  388. package/lib/CycleSelector/index.js +1 -1
  389. package/lib/DatePicker/component.json +192 -0
  390. package/lib/DatePicker/generatePicker/generateRangePicker.js +1 -1
  391. package/lib/DatePicker/generatePicker/generateSinglePicker.js +1 -1
  392. package/lib/Descriptions/component.json +142 -0
  393. package/lib/Descriptions/index.d.ts +1 -1
  394. package/lib/Desktop/component.json +171 -0
  395. package/lib/DragVerify/component.json +114 -0
  396. package/lib/DragVerify/index.js +1 -1
  397. package/lib/Drawer/component.json +200 -0
  398. package/lib/Drawer/index.js +1 -1
  399. package/lib/Drawer/interface.d.ts +1 -1
  400. package/lib/Drawer/util.d.ts +1 -6
  401. package/lib/Drawer/util.js +1 -1
  402. package/lib/Dropdown/component.json +147 -0
  403. package/lib/DynamicMultiBox/component.json +278 -0
  404. package/lib/DynamicMultiBox/formItem.d.ts +1 -1
  405. package/lib/DynamicMultiBox/rowForm.d.ts +2 -2
  406. package/lib/Empty/component.json +123 -0
  407. package/lib/Empty/index.css +1 -1
  408. package/lib/Empty/index.d.ts +2 -2
  409. package/lib/Empty/index.js +1 -1
  410. package/lib/Empty/style/index.css +1 -1
  411. package/lib/FieldForm/FieldFormItem/MemoInput.d.ts +2 -2
  412. package/lib/FieldForm/FieldFormItem/index.d.ts +6 -6
  413. package/lib/FieldForm/Form.d.ts +2 -2
  414. package/lib/FieldForm/FormList.d.ts +2 -2
  415. package/lib/FieldForm/component.json +196 -0
  416. package/lib/FieldForm/context.d.ts +5 -1
  417. package/lib/FieldForm/context.js +1 -1
  418. package/lib/FieldForm/hooks/useForm.d.ts +4 -3
  419. package/lib/FieldForm/hooks/useFormInstance.d.ts +1 -1
  420. package/lib/FieldForm/hooks/useFormItemStatus.d.ts +9 -5
  421. package/lib/FieldForm/hooks/useFormItemStatus.js +1 -1
  422. package/lib/FieldForm/hooks/useItemRef.d.ts +1 -1
  423. package/lib/FieldForm/hooks/useItemRef.js +1 -1
  424. package/lib/Form/component.json +161 -0
  425. package/lib/Form/index.d.ts +52 -49
  426. package/lib/FormItem/compoments/defaultCompoments/index.d.ts +5 -5
  427. package/lib/FormItem/compoments/defaultCompoments/index.js +1 -1
  428. package/lib/FormItem/compoments/formCheckboxGroup/index.d.ts +2 -2
  429. package/lib/FormItem/compoments/formFile/index.js +1 -1
  430. package/lib/FormItem/compoments/formRadioGroup/index.d.ts +1 -1
  431. package/lib/FormItem/compoments/formSelect/index.d.ts +1 -1
  432. package/lib/FormItem/component.json +171 -0
  433. package/lib/FormItem/index.d.ts +5 -5
  434. package/lib/FormItem/index.js +1 -1
  435. package/lib/FormItem/itemType.js +1 -1
  436. package/lib/FunctionModal/component.json +197 -0
  437. package/lib/FunctionModal/dialog.d.ts +1 -1
  438. package/lib/FunctionModal/modalContext.d.ts +4 -1
  439. package/lib/Help/component.json +118 -0
  440. package/lib/HelperText/component.json +126 -0
  441. package/lib/Image/component.json +165 -0
  442. package/lib/InputCode/component.json +191 -0
  443. package/lib/InputCode/index.d.ts +2 -2
  444. package/lib/InputLang/component.json +205 -0
  445. package/lib/InputLang/index.js +1 -1
  446. package/lib/InputNumber/component.json +162 -0
  447. package/lib/Label/component.json +126 -0
  448. package/lib/Label/index.d.ts +2 -2
  449. package/lib/Loading/component.json +91 -0
  450. package/lib/Menu/component.json +180 -0
  451. package/lib/Message/component.json +246 -0
  452. package/lib/Message/index.d.ts +2 -2
  453. package/lib/Message/index.js +1 -1
  454. package/lib/Modal/Confirm/index.d.ts +1 -1
  455. package/lib/Modal/component.json +277 -0
  456. package/lib/Modal/index.d.ts +85 -5
  457. package/lib/Modal/index.js +1 -1
  458. package/lib/Modal/interface.d.ts +1 -0
  459. package/lib/MultiBox/component.json +216 -0
  460. package/lib/MultiBox/index.js +1 -1
  461. package/lib/Notification/component.json +184 -0
  462. package/lib/OperateBtn/component.json +134 -0
  463. package/lib/OperateBtn/index.d.ts +3 -3
  464. package/lib/PageHeader/component.json +112 -0
  465. package/lib/Pagination/component.json +181 -0
  466. package/lib/Pagination/index.js +1 -1
  467. package/lib/PasswordRules/component.json +105 -0
  468. package/lib/PasswordRules/index.d.ts +4 -4
  469. package/lib/PopConfirm/component.json +227 -0
  470. package/lib/PopConfirm/index.d.ts +1 -1
  471. package/lib/PopConfirm/index.js +1 -1
  472. package/lib/PopMenu/component.json +131 -0
  473. package/lib/PopMenu/hooks.d.ts +1 -1
  474. package/lib/PopMenu/index.js +1 -1
  475. package/lib/Popover/component.json +165 -0
  476. package/lib/Popover/index.js +1 -1
  477. package/lib/Progress/component.json +161 -0
  478. package/lib/Prompt/component.json +144 -0
  479. package/lib/Querying/component.json +96 -0
  480. package/lib/Querying/index.css +1 -1
  481. package/lib/Querying/index.d.ts +2 -2
  482. package/lib/Querying/index.js +1 -1
  483. package/lib/Querying/style/index.css +1 -1
  484. package/lib/QuickReply/component.json +129 -0
  485. package/lib/QuickReply/index.d.ts +1 -1
  486. package/lib/Radio/component.json +136 -0
  487. package/lib/RadioGroup/component.json +149 -0
  488. package/lib/RangeInput/component.json +198 -0
  489. package/lib/RangeInput/index.js +1 -1
  490. package/lib/Result/component.json +104 -0
  491. package/lib/ScrollBar/component.json +115 -0
  492. package/lib/Search/component.json +177 -0
  493. package/lib/Search/index.d.ts +1 -1
  494. package/lib/Select/component.json +244 -0
  495. package/lib/Select/index.js +1 -1
  496. package/lib/SelectInput/component.json +184 -0
  497. package/lib/Selector/component.json +203 -0
  498. package/lib/Selector/index.js +1 -1
  499. package/lib/Selector/interface.d.ts +1 -1
  500. package/lib/Selector/selectorMain/index.js +1 -1
  501. package/lib/Selector/selectorNode/index.js +1 -1
  502. package/lib/Selector/util.d.ts +2 -2
  503. package/lib/SelectorPicker/component.json +179 -0
  504. package/lib/SelectorPicker/index.d.ts +5 -5
  505. package/lib/SelectorPicker/index.js +1 -1
  506. package/lib/SingleBox/component.json +151 -0
  507. package/lib/SingleBox/index.d.ts +2 -2
  508. package/lib/Slider/component.json +181 -0
  509. package/lib/SortBox/component.json +108 -0
  510. package/lib/Status/component.json +104 -0
  511. package/lib/Stepper/component.json +129 -0
  512. package/lib/Stepper/index.d.ts +2 -2
  513. package/lib/Switch/component.json +207 -0
  514. package/lib/Switch/index.css +1 -1
  515. package/lib/Switch/index.d.ts +3 -2
  516. package/lib/Switch/index.js +1 -1
  517. package/lib/Switch/style/index.css +1 -1
  518. package/lib/Table/component.json +547 -0
  519. package/lib/Table/index.d.ts +2 -2
  520. package/lib/Table/index.js +1 -1
  521. package/lib/Table/interface.d.ts +6 -0
  522. package/lib/Tabs/component.json +227 -0
  523. package/lib/Tag/component.json +221 -0
  524. package/lib/Tag/index.css +1 -1
  525. package/lib/Tag/index.d.ts +1 -1
  526. package/lib/Tag/index.js +1 -1
  527. package/lib/Tag/style/index.css +1 -1
  528. package/lib/TextEditor/component.json +186 -0
  529. package/lib/TextEditor/index.d.ts +5 -5
  530. package/lib/TextField/component.json +290 -0
  531. package/lib/TextField/index.d.ts +2 -2
  532. package/lib/TimePicker/component.json +176 -0
  533. package/lib/Timeline/component.json +110 -0
  534. package/lib/Title/component.json +156 -0
  535. package/lib/ToggleButton/component.json +153 -0
  536. package/lib/Tooltip/component.json +176 -0
  537. package/lib/Tooltip/index.js +1 -1
  538. package/lib/Tooltip/interface.d.ts +14 -1
  539. package/lib/Tooltip/utils.js +1 -1
  540. package/lib/Transfer/component.json +157 -0
  541. package/lib/Tree/component.json +512 -0
  542. package/lib/Upload/component.json +450 -0
  543. package/lib/Utils/type.d.ts +0 -2
  544. package/lib/index.d.ts +2 -0
  545. package/lib/index.js +1 -1
  546. package/lib/locale/en_US.d.ts +361 -0
  547. package/lib/locale/en_US.js +2 -0
  548. package/lib/locale/index.d.ts +1 -723
  549. package/lib/locale/index2.js +2 -0
  550. package/lib/locale/zh_CN.d.ts +361 -0
  551. package/lib/locale/zh_CN.js +2 -0
  552. package/package.json +9 -3
  553. /package/es/{Utils/Hooks → Hooks}/useResizeObserver.d.ts +0 -0
  554. /package/es/{Utils/Hooks → Hooks}/useResizeObserver.js +0 -0
  555. /package/lib/{Utils/Hooks → Hooks}/useResizeObserver.d.ts +0 -0
  556. /package/lib/{Utils/Hooks → Hooks}/useResizeObserver.js +0 -0
package/es/Empty/index.js CHANGED
@@ -1,56 +1,57 @@
1
1
  import { j as e } from "../_virtual/jsx-runtime.js";
2
- import u from "clsx";
3
- import { SmallNull as N, LargeNull as $ } from "./images/index.js";
2
+ import N from "clsx";
3
+ import { SmallNull as $, LargeNull as n } from "./images/index.js";
4
4
  import E from "../GlobalContext/useFormatMessage.js";
5
5
  import k from "./lang/index.js";
6
6
  import v from "../Hooks/useGlobalProps.js";
7
- import { $prefixCls as n } from "../GlobalContext/constant.js";
7
+ import { $prefixCls as c } from "../GlobalContext/constant.js";
8
8
  import './index.css';/* empty css */
9
9
  const C = {
10
- large: /* @__PURE__ */ e.jsx($, {}),
11
- small: /* @__PURE__ */ e.jsx(N, {})
10
+ large: /* @__PURE__ */ e.jsx(n, {}),
11
+ medium: /* @__PURE__ */ e.jsx(n, {}),
12
+ small: /* @__PURE__ */ e.jsx($, {})
12
13
  }, G = (l) => {
13
14
  const {
14
- className: c,
15
- style: p,
15
+ className: p,
16
+ style: d,
16
17
  size: t = "large",
17
- imageStyle: d,
18
- image: r = C[t],
18
+ imageStyle: f,
19
+ image: m = C[t],
19
20
  description: o,
20
- showRefresh: f = !1,
21
- onRefresh: y,
21
+ showRefresh: y = !1,
22
+ onRefresh: g,
22
23
  customEmpty: a
23
- } = v(l, "Empty"), i = E("Empty", k), g = (j) => {
24
- y?.(j);
25
- }, s = typeof o < "u" ? o : i({ id: "noData" }), x = typeof s == "string" ? s : "empty";
26
- let m = null;
27
- const h = f ? /* @__PURE__ */ e.jsxs("span", { className: "empty-description-refresh", children: [
24
+ } = v(l, "Empty"), i = E("Empty", k), x = (u) => {
25
+ g?.(u);
26
+ }, s = typeof o < "u" ? o : i({ id: "noData" }), h = typeof s == "string" ? s : "empty";
27
+ let r = null;
28
+ const j = y ? /* @__PURE__ */ e.jsxs("span", { className: "empty-description-refresh", children: [
28
29
  i({ id: "click" }),
29
- /* @__PURE__ */ e.jsx("span", { onClick: g, children: i({ id: "refresh" }) })
30
+ /* @__PURE__ */ e.jsx("span", { onClick: x, children: i({ id: "refresh" }) })
30
31
  ] }) : null;
31
- return typeof r == "string" ? m = /* @__PURE__ */ e.jsx(
32
+ return typeof m == "string" ? r = /* @__PURE__ */ e.jsx(
32
33
  "img",
33
34
  {
34
- src: r,
35
- alt: x
35
+ src: m,
36
+ alt: h
36
37
  }
37
- ) : m = r, /* @__PURE__ */ e.jsx(
38
+ ) : r = m, /* @__PURE__ */ e.jsx(
38
39
  "div",
39
40
  {
40
- className: u(`${n}-empty`, c, `${n}-empty-${t}`),
41
- style: p,
41
+ className: N(`${c}-empty`, p, `${c}-empty-${t}`),
42
+ style: d,
42
43
  children: a || /* @__PURE__ */ e.jsxs(e.Fragment, { children: [
43
44
  /* @__PURE__ */ e.jsx(
44
45
  "div",
45
46
  {
46
47
  className: `empty-image ${l?.image ? "" : `empty-image-${t}`}`,
47
- style: d,
48
- children: m
48
+ style: f,
49
+ children: r
49
50
  }
50
51
  ),
51
52
  s && /* @__PURE__ */ e.jsxs("div", { className: "empty-description", children: [
52
53
  /* @__PURE__ */ e.jsx(e.Fragment, { children: s }),
53
- h
54
+ j
54
55
  ] })
55
56
  ] })
56
57
  }
@@ -1 +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}
1
+ .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}
@@ -1,9 +1,9 @@
1
1
  import { default as React } from 'react';
2
2
  interface MemoInputProps {
3
3
  control: object;
4
- update: any;
4
+ update: unknown;
5
5
  children: React.ReactNode;
6
- childProps: any[];
6
+ childProps: unknown[];
7
7
  }
8
8
  declare const _default: React.MemoExoticComponent<({ children }: MemoInputProps) => JSX.Element>;
9
9
  export default _default;
@@ -6,9 +6,9 @@ import { FormItemInputProps } from '../FormItemInput';
6
6
  import { FormItemLabelProps } from '../FormItemLabel';
7
7
  import { ReportMetaChange } from '../context';
8
8
  import { default as useFormItemStatus } from '../hooks/useFormItemStatus';
9
- type RenderChildren<Values = any> = (form: FormInstance<Values>) => ReactNode;
10
- type RcFieldProps<Values = any> = Omit<FieldProps<Values>, 'children'>;
11
- type ChildrenType<Values = any> = RenderChildren<Values> | ReactNode;
9
+ type RenderChildren<Values = unknown> = (form: FormInstance<Values>) => ReactNode;
10
+ type RcFieldProps<Values = unknown> = Omit<FieldProps<Values>, 'children'>;
11
+ type ChildrenType<Values = unknown> = RenderChildren<Values> | ReactNode;
12
12
  declare const ValidateStatuses: readonly ["success", "warning", "error", "validating", ""];
13
13
  export type ValidateStatus = (typeof ValidateStatuses)[number];
14
14
  export type FeedbackIcons = (itemStatus: {
@@ -18,7 +18,7 @@ export type FeedbackIcons = (itemStatus: {
18
18
  }) => {
19
19
  [key in ValidateStatus]?: ReactNode;
20
20
  };
21
- export interface FormItemProps<Values = any> extends FormItemLabelProps, FormItemInputProps, RcFieldProps<Values> {
21
+ export interface FormItemProps<Values = unknown> extends FormItemLabelProps, FormItemInputProps, RcFieldProps<Values> {
22
22
  noStyle?: boolean;
23
23
  style?: CSSProperties;
24
24
  className?: string;
@@ -28,7 +28,7 @@ export interface FormItemProps<Values = any> extends FormItemLabelProps, FormIte
28
28
  validateStatus?: ValidateStatus;
29
29
  required?: boolean;
30
30
  hidden?: boolean;
31
- initialValue?: any;
31
+ initialValue?: unknown;
32
32
  messageVariables?: Record<string, string>;
33
33
  layout?: FormItemLayout;
34
34
  hideError?: boolean;
@@ -45,7 +45,7 @@ export interface ItemHolderProps extends FormItemProps {
45
45
  isRequired?: boolean;
46
46
  onSubItemMetaChange: ReportMetaChange;
47
47
  }
48
- declare function InternalFormItem<Values = any>(props: FormItemProps<Values>): ReactElement;
48
+ declare function InternalFormItem<Values = unknown>(props: FormItemProps<Values>): ReactElement;
49
49
  type InternalFormItemType = typeof InternalFormItem;
50
50
  type CompoundedComponent = InternalFormItemType & {
51
51
  useStatus: typeof useFormItemStatus;
@@ -10,7 +10,7 @@ export type RequiredMark = boolean | 'optional' | ((labelNode: ReactNode, info:
10
10
  }) => ReactNode);
11
11
  export type FormLayout = 'horizontal' | 'vertical';
12
12
  export type FormItemLayout = 'horizontal' | 'vertical';
13
- export interface FormProps<Values = any> extends Omit<RcFormProps<Values>, 'form'> {
13
+ export interface FormProps<Values = unknown> extends Omit<RcFormProps<Values>, 'form'> {
14
14
  colon?: boolean;
15
15
  name?: string;
16
16
  layout?: FormLayout;
@@ -23,6 +23,6 @@ export interface FormProps<Values = any> extends Omit<RcFormProps<Values>, 'form
23
23
  requiredMark?: RequiredMark;
24
24
  size?: 'small' | 'medium' | 'large';
25
25
  }
26
- declare const FieldForm: (<Values = any>(props: PropsWithChildren<FormProps<Values>> & RefAttributes<FormRef<Values>>) => ReactElement) & Pick<FC, "displayName">;
26
+ declare const FieldForm: (<Values = unknown>(props: PropsWithChildren<FormProps<Values>> & RefAttributes<FormRef<Values>>) => ReactElement) & Pick<FC, "displayName">;
27
27
  export { useForm, useWatch, type FormInstance };
28
28
  export default FieldForm;
@@ -3,7 +3,7 @@ import { StoreValue, ValidatorRule } from 'rc-field-form/lib/interface';
3
3
  export interface FormListFieldData {
4
4
  name: number;
5
5
  key: number;
6
- error?: any;
6
+ error?: unknown;
7
7
  }
8
8
  export interface FormListOperation {
9
9
  add: (defaultValue?: StoreValue, insertIndex?: number) => void;
@@ -13,7 +13,7 @@ export interface FormListOperation {
13
13
  export interface FormListProps {
14
14
  name: string | number | (string | number)[];
15
15
  rules?: ValidatorRule[];
16
- initialValue?: any[];
16
+ initialValue?: unknown[];
17
17
  children: (fields: FormListFieldData[], operation: FormListOperation, meta: {
18
18
  errors: ReactNode[];
19
19
  warnings: ReactNode[];
@@ -0,0 +1,196 @@
1
+ {
2
+ "name": "FieldForm",
3
+ "category": "Data Entry",
4
+ "description": "表单组件,提供完整的表单解决方案(基于 rc-field-form;内部 cloneElement 注入 value/onChange/error 到 Item.children)",
5
+ "semantic": {
6
+ "intent": [
7
+ "表单管理",
8
+ "数据录入"
9
+ ],
10
+ "useCases": [
11
+ "用户注册",
12
+ "数据编辑",
13
+ "配置页面"
14
+ ],
15
+ "riskLevel": "normal"
16
+ },
17
+ "variants": {
18
+ "horizontal": {
19
+ "meaning": "水平布局"
20
+ },
21
+ "vertical": {
22
+ "meaning": "垂直布局"
23
+ }
24
+ },
25
+ "states": [
26
+ "default",
27
+ "disabled",
28
+ "validating",
29
+ "error"
30
+ ],
31
+ "idealProps": {
32
+ "form": {
33
+ "type": "FormInstance",
34
+ "description": "由 useForm() 创建的表单实例:`const [form] = FieldForm.useForm();` 仅在父组件需外部调用 submit/resetFields/setFieldsValue 时需要;**类型别名注意**:`FormInstance`(api.ts) ≡ `FieldFormInstance`(src/FieldForm 导出)两个名字指同一类型,推荐用 `FieldFormInstance`(更精确不与其他库混淆)"
35
+ },
36
+ "initialValues": {
37
+ "type": "object",
38
+ "objectShape": {
39
+ "[fieldName: string]": { "type": "any", "description": "字段名 → 初始值,例:{ username: '张三', age: 25 }" }
40
+ },
41
+ "completeExample": "{ username: '张三', email: 'zs@example.com' }",
42
+ "description": "表单初始默认值(仅 mount 时灌入;**后续动态变化需用 form.setFieldsValue,不能修改 initialValues prop**);典型用法 `<FieldForm initialValues={{ name: '张三', age: 25 }}>`"
43
+ },
44
+ "onFinish": {
45
+ "type": "(values: any) => void",
46
+ "description": "校验通过后触发:values 是表单全部字段的扁平对象(包含 FieldForm.Item.name 收集的所有字段);**触发时机**:点击 `<Button type=\"submit\">` 或调用 `form.submit()` 后,内部跑校验通过 → onFinish"
47
+ },
48
+ "onFinishFailed": {
49
+ "type": "({ values, errorFields, outOfDate }) => void",
50
+ "description": "校验失败后触发;errorFields 是失败字段数组"
51
+ },
52
+ "layout": {
53
+ "type": "enum",
54
+ "values": [
55
+ "horizontal",
56
+ "vertical"
57
+ ],
58
+ "default": "vertical",
59
+ "description": "vertical=label 在字段上方(默认,省略即生效);horizontal=label 在左侧"
60
+ },
61
+ "children": {
62
+ "type": "ReactNode",
63
+ "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"
64
+ }
65
+ },
66
+ "childrenContract": {
67
+ "FormItem": {
68
+ "rule": "FieldForm.Item 的 children 必须是支持 value/onChange/error/disabled prop 的自定义组件",
69
+ "recommended": [
70
+ "TextField",
71
+ "Select",
72
+ "Switch",
73
+ "Checkbox",
74
+ "InputNumber",
75
+ "DatePicker",
76
+ "TextEditor",
77
+ "RangeInput",
78
+ "RadioGroup",
79
+ "CheckboxGroup",
80
+ "Slider"
81
+ ],
82
+ "forbidden": [
83
+ "原生 <input>",
84
+ "原生 <textarea>",
85
+ "原生 <select>",
86
+ "包一层 <div>"
87
+ ],
88
+ "reason": "Item 用 cloneElement 注入 value/onChange/error/disabled/size 等 prop;原生 DOM 元素不消费 error: boolean,React 会报 non-boolean attribute warning(运行时 console error,demo 验证 fail)"
89
+ },
90
+ "submit": {
91
+ "rule": "提交用 <Button type=\"submit\"> 或 form.submit()",
92
+ "trigger": "<Button>(来自 @para-ui/core/Button)渲染为 <button type='submit'>,会触发 form 的 submit 事件 → 跑校验 → onFinish/onFinishFailed",
93
+ "wrapper": "提交按钮通常用 FieldForm.Item(不带 name)包裹做布局,如 `<FieldForm.Item><Button type='submit'>提交</Button></FieldForm.Item>`;Item 不带 name 时不会注入 value/onChange/error(纯布局容器),不会触发 non-boolean-attribute warning;**也可不包 Item 直接放 Button**(看布局需求)"
94
+ }
95
+ },
96
+ "interpretivePriority": {
97
+ "principle": "**当需求描述中的'范围约束'(如 '仅使用 FieldForm 本身' / '不引入其他组件')与 childrenContract 冲突时,优先服从 childrenContract**",
98
+ "reason": "childrenContract 决定 runtime 是否报 React warning;需求'仅使用 FieldForm 本身'通常指**目标包装组件**(如 EditDataForm / SearchHorizontalForm)的**实现层 import 限制**(不在该包装组件内部 import 其他组件),**不限制 Demo 入口层或 children 子组件**;若字面理解为'整个文件只能 import FieldForm',会导致 Item.children 只能用原生 <input> → 触发 non-boolean warning → 运行时 fail",
99
+ "resolution": "标准解读:'仅使用 FieldForm 本身' = '目标包装组件(EditDataForm 等)的实现 import 列表只有 FieldForm';**Demo 渲染入口 (`const Demo: FC = () => ...`) 可自由 import TextField / Button / Select 等推荐子组件作为 children 传入包装组件**;**包装组件接收 children: ReactNode 直接透传给 FieldForm 即可,不需要内部 import 字段组件**",
100
+ "antiPatterns": [
101
+ "❌ 整个 demo 文件只 import FieldForm,FieldForm.Item.children 用原生 <input>",
102
+ "❌ 整个 demo 文件只 import FieldForm,提交按钮用原生 <button type='submit'>",
103
+ "❌ 把'仅使用 FieldForm 本身'解读为'禁止 import TextField/Button'"
104
+ ],
105
+ "correctPatterns": [
106
+ "✅ 包装组件 (EditDataForm) 实现层只 import FieldForm,接收 children: ReactNode",
107
+ "✅ Demo 渲染入口 import TextField + Button,构造 <FieldForm.Item><TextField/></FieldForm.Item> 作为 children 传入",
108
+ "✅ 提交按钮:Demo 入口 import Button,<FieldForm.Item><Button type='submit'>提交</Button></FieldForm.Item>"
109
+ ]
110
+ },
111
+ "commonMisconceptions": {
112
+ "M1": {
113
+ "wrong": "FieldForm.Item.children 用原生 <input>",
114
+ "result": "React 报 `Received 'false' for a non-boolean attribute 'error'` warning → ai-test runtime fail",
115
+ "fix": "改用 TextField (或其他 recommended 组件)"
116
+ },
117
+ "M2": {
118
+ "wrong": "提交按钮用原生 `<button type='submit'>` 包在 FieldForm.Item 内",
119
+ "result": "Item cloneElement 注入 error={false} 到原生 button → React warning → ai-test fail",
120
+ "fix": "改用 `<Button type='submit'>` 或不包 FieldForm.Item 直接放原生 button(Item 在不包裹时不注入 error)"
121
+ },
122
+ "M3": {
123
+ "wrong": "需求 '仅使用 FieldForm 本身' 被解读为整个 demo 文件只 import FieldForm",
124
+ "result": "Item children 退化为原生 <input> → M1 warning",
125
+ "fix": "见 interpretivePriority.resolution(包装组件实现层 vs Demo 入口层的区分)"
126
+ }
127
+ },
128
+ "completeExample": "// R23 议题修补:R22 4/5 fail 根因 sub-agent 误解'仅使用 FieldForm 本身'\n// 标准完整示例(initialValues + useForm + onFinish + Item + TextField + Button submit):\n\nimport React, { FC } from 'react';\nimport FieldForm from '@para-ui/core/FieldForm';\nimport type { FieldFormInstance } from '@para-ui/core/FieldForm';\nimport TextField from '@para-ui/core/TextField';\nimport Button from '@para-ui/core/Button';\n\n// === 1. 目标包装组件(实现层只 import FieldForm + 类型) ===\ninterface EditDataFormProps {\n initialData?: Record<string, any>;\n children: React.ReactNode;\n onSubmitSuccess: (values: any) => void;\n}\nconst EditDataForm: FC<EditDataFormProps> = ({ initialData, children, onSubmitSuccess }) => {\n const [form] = FieldForm.useForm();\n return (\n <FieldForm\n form={form}\n initialValues={initialData}\n onFinish={onSubmitSuccess}\n layout='vertical'\n >\n {children}\n </FieldForm>\n );\n};\n\n// === 2. Demo 渲染入口(可自由 import TextField + Button 作为 children) ===\nconst Demo: FC = () => (\n <EditDataForm\n initialData={{ username: '张三', email: 'zs@example.com' }}\n onSubmitSuccess={(values) => console.log('submitted', values)}\n >\n <FieldForm.Item name='username' label='用户名' rules={[{ required: true }]}>\n <TextField placeholder='请输入用户名' />\n </FieldForm.Item>\n <FieldForm.Item name='email' label='邮箱' rules={[{ required: true, type: 'email' }]}>\n <TextField placeholder='请输入邮箱' />\n </FieldForm.Item>\n <FieldForm.Item>\n <Button type='submit'>保存修改</Button>\n </FieldForm.Item>\n </EditDataForm>\n);\nexport default Demo;",
129
+ "do": [
130
+ "**Demo 入口层**必须 import TextField / Button 等推荐组件给 Item.children(即使需求说'仅使用 FieldForm 本身',这是包装组件实现层约束,不是 Demo 入口约束)",
131
+ "使用 useForm() 管理表单实例;父组件需要外部调用 submit/resetFields/setFieldsValue 时通过 form prop 传入",
132
+ "完整 demo 模板见 completeExample(initialValues + onFinish + FieldForm.Item + TextField + Button)",
133
+ "提供完整的校验规则(rules: [{ required: true }, { type: 'email' }, { pattern: /.../ }])"
134
+ ],
135
+ "dont": [
136
+ "FieldForm.Item.children 用原生 <input> / <textarea> / <select> / <button>(触发 non-boolean-attribute warning,见 childrenContract.FormItem.reason)",
137
+ "把'仅使用 FieldForm 本身'解读为'整个文件不能 import TextField/Button'(见 interpretivePriority.resolution)",
138
+ "字段过多不分组",
139
+ "忽略异步校验",
140
+ "在 mount 后修改 initialValues prop(应用 form.setFieldsValue;initialValues 仅 mount 时灌入)"
141
+ ],
142
+ "events": {
143
+ "onFinish": {
144
+ "signature": "(values: any) => void",
145
+ "asyncSupported": false,
146
+ "examples": [
147
+ "校验全部通过后触发:values 是全部 FieldForm.Item.name 收集到的字段扁平对象",
148
+ "点击 <Button type='submit'> 或调用 form.submit() 后跑校验,通过才触发 onFinish",
149
+ "values 结构与 initialValues 形状一致,key = 每个 Item 的 name 字段值"
150
+ ],
151
+ "commonMistakes": [
152
+ "假设 onFinish 会在校验失败时也触发——只有全部通过才触发,失败时触发 onFinishFailed",
153
+ "假设 onFinish 签名是 (e: FormEvent) => void——实际只有 (values: any) 一个参数",
154
+ "假设 submit 时直接拿到 event.preventDefault()——FieldForm 内部已处理,不需要手动 preventDefault"
155
+ ]
156
+ },
157
+ "onFinishFailed": {
158
+ "signature": "({ values, errorFields, outOfDate }: ValidateErrorEntity) => void",
159
+ "asyncSupported": false,
160
+ "examples": [
161
+ "校验失败时触发:errorFields 是 { name: NamePath; errors: string[] }[] 数组",
162
+ "values 包含当前所有字段值(含未通过校验的字段)"
163
+ ],
164
+ "commonMistakes": [
165
+ "假设参数是 (errors: string[]) 而不是对象——实际是 { values, errorFields, outOfDate } 解构对象",
166
+ "假设只有 onFinish 就够了——校验失败场景必须处理 onFinishFailed 才能给用户提示"
167
+ ]
168
+ }
169
+ },
170
+ "typescriptPitfalls": [
171
+ {
172
+ "issue": "FieldFormInstance 与 FormInstance 是同一类型的两个别名,推荐用 FieldFormInstance 避免与其他库冲突",
173
+ "wrong": "import type { FormInstance } from 'rc-field-form'; // 直接用 rc-field-form 的类型",
174
+ "right": "import type { FieldFormInstance } from '@para-ui/core/FieldForm'; const [form] = FieldForm.useForm<FieldFormInstance>();"
175
+ },
176
+ {
177
+ "issue": "FieldForm.Item 的 children 必须是自定义组件(支持 value/onChange/error prop),不能是原生 DOM 元素",
178
+ "wrong": "<FieldForm.Item name='age'><input type='number' /></FieldForm.Item> // error prop 会被注入到原生 input,React 报 non-boolean warning",
179
+ "right": "<FieldForm.Item name='age'><InputNumber /></FieldForm.Item> // 使用支持 error: boolean 的自定义组件"
180
+ },
181
+ {
182
+ "issue": "initialValues 仅在 mount 时生效,mount 后动态修改 initialValues prop 不会刷新表单",
183
+ "wrong": "// 动态修改 initialValues 期望刷新表单\n<FieldForm initialValues={dynamicData} /> // 后续 dynamicData 变化不会更新表单",
184
+ "right": "// 需要动态回填时用 form.setFieldsValue(newData)\nconst [form] = FieldForm.useForm();\nuseEffect(() => { form.setFieldsValue(dynamicData); }, [dynamicData]);"
185
+ },
186
+ {
187
+ "issue": "rules 中的 validator 函数签名必须返回 Promise(rc-field-form 约定),不是同步返回",
188
+ "wrong": "rules={[{ validator: (_, val) => val > 0 ? true : false }]} // 同步返回 boolean 不被识别",
189
+ "right": "rules={[{ validator: (_, val) => val > 0 ? Promise.resolve() : Promise.reject('必须大于 0') }]}"
190
+ }
191
+ ],
192
+ "mapping": {
193
+ "realComponent": "FieldForm",
194
+ "adapter": null
195
+ }
196
+ }
@@ -20,7 +20,11 @@ export interface FormContextProps {
20
20
  size?: 'small' | 'medium' | 'large';
21
21
  }
22
22
  export declare const FormContext: React.Context<FormContextProps>;
23
- export type ReportMetaChange = (meta: Meta, uniqueKeys: Key[]) => void;
23
+ /** rc-field-form 在销毁字段时会传入带 destroy 标记的 meta(官方 Meta 类型未声明此字段) */
24
+ export type MetaWithDestroy = Meta & {
25
+ destroy?: boolean;
26
+ };
27
+ export type ReportMetaChange = (meta: MetaWithDestroy, uniqueKeys: Key[]) => void;
24
28
  export declare const NoStyleItemContext: React.Context<ReportMetaChange | null>;
25
29
  export interface FormItemStatusContextProps {
26
30
  isFormItemInput?: boolean;
@@ -8,8 +8,8 @@ const x = (t) => {
8
8
  }, c = o({
9
9
  labelAlign: "left",
10
10
  layout: "vertical",
11
- itemRef: (() => {
12
- })
11
+ itemRef: () => () => {
12
+ }
13
13
  }), f = o(null), a = o({});
14
14
  export {
15
15
  c as FormContext,
@@ -1,6 +1,7 @@
1
+ import { ReactElement } from 'react';
1
2
  import { FormInstance as RcFormInstance } from 'rc-field-form';
2
3
  import { NamePath } from '../interface';
3
- export interface FormInstance<Values = any> extends RcFormInstance<Values> {
4
- getFieldInstance: (name: NamePath) => any;
4
+ export interface FormInstance<Values = unknown> extends RcFormInstance<Values> {
5
+ getFieldInstance: (name: NamePath) => ReactElement | undefined;
5
6
  }
6
- export default function useForm<Values = any>(form?: FormInstance<Values>): [FormInstance<Values>];
7
+ export default function useForm<Values = unknown>(form?: FormInstance<Values>): [FormInstance<Values>];
@@ -1,2 +1,2 @@
1
1
  import { FormInstance } from './useForm';
2
- export default function useFormInstance<Value = any>(): FormInstance<Value>;
2
+ export default function useFormInstance<Value = unknown>(): FormInstance<Value>;
@@ -1,9 +1,13 @@
1
1
  import { ReactNode } from 'react';
2
2
  import { ValidateStatus } from '../FieldFormItem';
3
- type UseFormItemStatus = () => {
4
- status?: ValidateStatus;
5
- errors: ReactNode[];
6
- warnings: ReactNode[];
7
- };
3
+ import { FormItemInputContext } from '../context';
4
+ interface UseFormItemStatus {
5
+ (): {
6
+ status?: ValidateStatus;
7
+ errors: ReactNode[];
8
+ warnings: ReactNode[];
9
+ };
10
+ Context: typeof FormItemInputContext;
11
+ }
8
12
  declare const useFormItemStatus: UseFormItemStatus;
9
13
  export default useFormItemStatus;
@@ -1,9 +1,9 @@
1
1
  import { useContext as s } from "react";
2
2
  import { FormItemInputContext as t } from "../context.js";
3
- const n = () => {
3
+ const n = (() => {
4
4
  const { status: o, errors: r = [], warnings: e = [] } = s(t);
5
5
  return { status: o, errors: r, warnings: e };
6
- };
6
+ });
7
7
  n.Context = t;
8
8
  export {
9
9
  n as default
@@ -1,3 +1,3 @@
1
1
  import { default as React } from 'react';
2
2
  import { InternalNamePath } from '../interface';
3
- export default function useItemRef(): (name: InternalNamePath, children: any) => React.Ref<any> | undefined;
3
+ export default function useItemRef(): (name: InternalNamePath, children: React.ReactNode) => React.Ref<unknown> | undefined;
@@ -1,11 +1,11 @@
1
- import { useContext as u, useRef as m } from "react";
2
- import { composeRef as i } from "rc-util/lib/ref";
1
+ import { useContext as u, useRef as i } from "react";
2
+ import { composeRef as m } from "rc-util/lib/ref";
3
3
  import { FormContext as s } from "../context.js";
4
4
  function g() {
5
- const { itemRef: f } = u(s), e = m({});
6
- function c(o, r) {
7
- const t = r && typeof r == "object" && r.ref, n = o.join("_");
8
- return (e.current.name !== n || e.current.originRef !== t) && (e.current.name = n, e.current.originRef = t, e.current.ref = i(f(o), t)), e.current.ref;
5
+ const { itemRef: f } = u(s), e = i({});
6
+ function c(o, t) {
7
+ const r = t && typeof t == "object" && t.ref, n = o.join("_");
8
+ return (e.current.name !== n || e.current.originRef !== r) && (e.current.name = n, e.current.originRef = r, e.current.ref = m(f(o), r)), e.current.ref;
9
9
  }
10
10
  return c;
11
11
  }