@para-ui/core 5.0.0-beta.11 → 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 (650) 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 +52 -49
  111. package/es/Anchor/type.d.ts +8 -4
  112. package/es/Argv/component.json +216 -0
  113. package/es/Argv/dataGenerator/index.js +1 -1
  114. package/es/Argv/index.d.ts +5 -6
  115. package/es/Argv/index.js +1 -1
  116. package/es/AutoBox/component.json +133 -0
  117. package/es/AutoBox/index.d.ts +3 -3
  118. package/es/AutoBox/index.js +1 -1
  119. package/es/AutoBox/protal.d.ts +2 -2
  120. package/es/AutoBox/protal.js +33 -30
  121. package/es/AutoButton/component.json +109 -0
  122. package/es/AutoButton/index.js +1 -1
  123. package/es/AutoTips/autoTipsMultiline/index.d.ts +1 -1
  124. package/es/AutoTips/autoTipsMultiline/index.js +1 -1
  125. package/es/AutoTips/component.json +121 -0
  126. package/es/AutoTips/index.js +1 -1
  127. package/es/Badge/component.json +92 -0
  128. package/es/Breadcrumbs/component.json +142 -0
  129. package/es/Breadcrumbs/index.js +1 -1
  130. package/es/Button/SplitButton.d.ts +2 -2
  131. package/es/Button/component.json +168 -0
  132. package/es/Button/index.js +44 -44
  133. package/es/ButtonGroup/component.json +132 -0
  134. package/es/ButtonGroup/index.d.ts +1 -1
  135. package/es/Card/component.json +162 -0
  136. package/es/Card/index.d.ts +2 -2
  137. package/es/Card/index.js +2 -2
  138. package/es/Carousel/component.json +142 -0
  139. package/es/Carousel/index.d.ts +1 -1
  140. package/es/Cascader/Cascader.js +1 -1
  141. package/es/Cascader/OptionList/Column.js +1 -1
  142. package/es/Cascader/OptionList/index.js +1 -1
  143. package/es/Cascader/component.json +196 -0
  144. package/es/Cascader/hooks/useEntities.js +7 -7
  145. package/es/Cascader/interface.d.ts +1 -0
  146. package/es/Cascader/utils/commonUtil.d.ts +1 -1
  147. package/es/Cascader/utils/commonUtil.js +16 -16
  148. package/es/Cascader/utils/treeUtil.d.ts +14 -5
  149. package/es/Cascader/utils/treeUtil.js +1 -1
  150. package/es/Checkbox/component.json +138 -0
  151. package/es/CheckboxGroup/component.json +152 -0
  152. package/es/CheckboxGroup/index.js +1 -1
  153. package/es/CodeEditor/component.json +189 -0
  154. package/es/CodeEditor/index.d.ts +11 -10
  155. package/es/CodeEditor/index.js +19 -19
  156. package/es/Collapse/component.json +166 -0
  157. package/es/Collapse/index.d.ts +1 -1
  158. package/es/Collapse/index.js +23 -22
  159. package/es/CollapseBox/component.json +84 -0
  160. package/es/CollapseLayout/component.json +155 -0
  161. package/es/ColorPicker/component.json +142 -0
  162. package/es/ComboSelect/component.json +181 -0
  163. package/es/ComboSelect/index.js +115 -109
  164. package/es/ComboSelect/interface.d.ts +2 -2
  165. package/es/ComboSelect/utils.d.ts +3 -3
  166. package/es/ComboSelect/utils.js +1 -1
  167. package/es/Container/component.json +111 -0
  168. package/es/ContentBox/component.json +81 -0
  169. package/es/CopyText/component.json +118 -0
  170. package/es/CycleSelector/component.json +98 -0
  171. package/es/CycleSelector/index.js +14 -13
  172. package/es/DatePicker/component.json +192 -0
  173. package/es/DatePicker/generatePicker/generateRangePicker.js +11 -11
  174. package/es/DatePicker/generatePicker/generateSinglePicker.js +2 -2
  175. package/es/Descriptions/component.json +142 -0
  176. package/es/Descriptions/index.d.ts +1 -1
  177. package/es/Desktop/component.json +171 -0
  178. package/es/Desktop/index.js +1 -1
  179. package/es/DragVerify/component.json +114 -0
  180. package/es/DragVerify/index.js +19 -19
  181. package/es/Drawer/component.json +200 -0
  182. package/es/Drawer/index.js +86 -86
  183. package/es/Drawer/interface.d.ts +1 -1
  184. package/es/Drawer/util.d.ts +1 -6
  185. package/es/Drawer/util.js +9 -6
  186. package/es/Dropdown/component.json +147 -0
  187. package/es/Dropdown/index.js +1 -1
  188. package/es/DynamicMultiBox/component.json +278 -0
  189. package/es/DynamicMultiBox/formItem.d.ts +1 -1
  190. package/es/DynamicMultiBox/index.js +1 -1
  191. package/es/DynamicMultiBox/rowForm.d.ts +2 -2
  192. package/es/Empty/component.json +123 -0
  193. package/es/Empty/index.css +1 -1
  194. package/es/Empty/index.d.ts +2 -2
  195. package/es/Empty/index.js +27 -26
  196. package/es/Empty/style/index.css +1 -1
  197. package/es/FieldForm/FieldFormItem/ItemHolder.js +1 -1
  198. package/es/FieldForm/FieldFormItem/MemoInput.d.ts +2 -2
  199. package/es/FieldForm/FieldFormItem/StatusProvider.js +1 -1
  200. package/es/FieldForm/FieldFormItem/index.d.ts +6 -6
  201. package/es/FieldForm/Form.d.ts +2 -2
  202. package/es/FieldForm/Form.js +1 -1
  203. package/es/FieldForm/FormItemInput.js +1 -1
  204. package/es/FieldForm/FormItemLabel.js +1 -1
  205. package/es/FieldForm/FormList.d.ts +2 -2
  206. package/es/FieldForm/component.json +196 -0
  207. package/es/FieldForm/context.d.ts +5 -1
  208. package/es/FieldForm/context.js +2 -2
  209. package/es/FieldForm/hooks/useForm.d.ts +4 -3
  210. package/es/FieldForm/hooks/useFormInstance.d.ts +1 -1
  211. package/es/FieldForm/hooks/useFormItemStatus.d.ts +9 -5
  212. package/es/FieldForm/hooks/useFormItemStatus.js +2 -2
  213. package/es/FieldForm/hooks/useItemRef.d.ts +1 -1
  214. package/es/FieldForm/hooks/useItemRef.js +6 -6
  215. package/es/Form/component.json +161 -0
  216. package/es/Form/index.d.ts +52 -49
  217. package/es/Form/index.js +1 -1
  218. package/es/FormItem/compoments/defaultCompoments/index.d.ts +5 -5
  219. package/es/FormItem/compoments/defaultCompoments/index.js +12 -11
  220. package/es/FormItem/compoments/formCheckboxGroup/index.d.ts +2 -2
  221. package/es/FormItem/compoments/formFile/index.js +8 -8
  222. package/es/FormItem/compoments/formRadioGroup/index.d.ts +1 -1
  223. package/es/FormItem/compoments/formSelect/index.d.ts +1 -1
  224. package/es/FormItem/component.json +171 -0
  225. package/es/FormItem/index.d.ts +5 -5
  226. package/es/FormItem/index.js +23 -23
  227. package/es/FormItem/itemType.js +1 -1
  228. package/es/FunctionModal/component.json +197 -0
  229. package/es/FunctionModal/dialog.d.ts +1 -1
  230. package/es/FunctionModal/modalContext.d.ts +4 -1
  231. package/es/GlobalContext/confirmLocale.js +1 -1
  232. package/es/GlobalContext/index.js +1 -1
  233. package/es/Help/component.json +118 -0
  234. package/es/HelperText/component.json +126 -0
  235. package/es/Image/PreviewGroup.js +1 -1
  236. package/es/Image/component.json +165 -0
  237. package/es/Image/index.js +1 -1
  238. package/es/InputCode/component.json +191 -0
  239. package/es/InputCode/index.d.ts +2 -2
  240. package/es/InputLang/component.json +205 -0
  241. package/es/InputLang/index.js +2 -2
  242. package/es/InputNumber/component.json +162 -0
  243. package/es/Label/component.json +126 -0
  244. package/es/Label/index.d.ts +2 -2
  245. package/es/Loading/component.json +91 -0
  246. package/es/Menu/component.json +180 -0
  247. package/es/Menu/verticalMenuList.js +1 -1
  248. package/es/Message/component.json +246 -0
  249. package/es/Message/index.d.ts +2 -2
  250. package/es/Message/index.js +2 -2
  251. package/es/Modal/Confirm/index.d.ts +1 -1
  252. package/es/Modal/Confirm/index.js +1 -1
  253. package/es/Modal/component.json +277 -0
  254. package/es/Modal/index.d.ts +85 -5
  255. package/es/Modal/index.js +159 -122
  256. package/es/Modal/interface.d.ts +1 -0
  257. package/es/MultiBox/component.json +216 -0
  258. package/es/MultiBox/index.js +19 -14
  259. package/es/Notification/component.json +184 -0
  260. package/es/OperateBtn/component.json +134 -0
  261. package/es/OperateBtn/index.d.ts +3 -3
  262. package/es/PageHeader/component.json +112 -0
  263. package/es/PageHeader/horizontalMeun.js +1 -1
  264. package/es/PageHeader/horizontalMeunRight.js +1 -1
  265. package/es/Pagination/component.json +181 -0
  266. package/es/Pagination/index.js +15 -15
  267. package/es/ParauiProvider/index.js +1 -1
  268. package/es/PasswordRules/component.json +105 -0
  269. package/es/PasswordRules/index.d.ts +4 -4
  270. package/es/PopConfirm/component.json +227 -0
  271. package/es/PopConfirm/index.d.ts +1 -1
  272. package/es/PopConfirm/index.js +1 -1
  273. package/es/PopMenu/component.json +131 -0
  274. package/es/PopMenu/hooks.d.ts +1 -1
  275. package/es/PopMenu/index.js +8 -8
  276. package/es/Popover/component.json +165 -0
  277. package/es/Popover/index.js +1 -1
  278. package/es/Progress/component.json +161 -0
  279. package/es/Prompt/component.json +144 -0
  280. package/es/Querying/component.json +96 -0
  281. package/es/Querying/index.css +1 -1
  282. package/es/Querying/index.d.ts +2 -2
  283. package/es/Querying/index.js +20 -19
  284. package/es/Querying/style/index.css +1 -1
  285. package/es/QuickReply/QuickReplyCode/index.js +1 -1
  286. package/es/QuickReply/component.json +129 -0
  287. package/es/QuickReply/index.d.ts +1 -1
  288. package/es/Radio/component.json +136 -0
  289. package/es/RadioGroup/component.json +149 -0
  290. package/es/RangeInput/component.json +198 -0
  291. package/es/RangeInput/index.js +20 -20
  292. package/es/Result/component.json +104 -0
  293. package/es/ScrollBar/component.json +115 -0
  294. package/es/Search/component.json +177 -0
  295. package/es/Search/index.d.ts +1 -1
  296. package/es/Select/component.json +244 -0
  297. package/es/Select/index.js +114 -114
  298. package/es/SelectInput/component.json +184 -0
  299. package/es/Selector/component.json +203 -0
  300. package/es/Selector/index.js +56 -50
  301. package/es/Selector/interface.d.ts +2 -2
  302. package/es/Selector/selectorData/index.js +1 -1
  303. package/es/Selector/selectorMain/index.js +3 -3
  304. package/es/Selector/selectorNode/index.js +1 -1
  305. package/es/Selector/util.d.ts +3 -3
  306. package/es/Selector/util.js +6 -12
  307. package/es/SelectorPicker/component.json +179 -0
  308. package/es/SelectorPicker/index.d.ts +5 -5
  309. package/es/SelectorPicker/index.js +15 -15
  310. package/es/SingleBox/component.json +151 -0
  311. package/es/SingleBox/index.d.ts +2 -2
  312. package/es/Slider/component.json +181 -0
  313. package/es/SortBox/component.json +108 -0
  314. package/es/Status/component.json +104 -0
  315. package/es/Stepper/component.json +129 -0
  316. package/es/Stepper/index.d.ts +2 -2
  317. package/es/Switch/component.json +207 -0
  318. package/es/Switch/index.css +1 -1
  319. package/es/Switch/index.d.ts +3 -2
  320. package/es/Switch/index.js +60 -59
  321. package/es/Switch/style/index.css +1 -1
  322. package/es/Table/component.json +547 -0
  323. package/es/Table/index.d.ts +2 -2
  324. package/es/Table/index.js +385 -382
  325. package/es/Table/interface.d.ts +30 -0
  326. package/es/Table/tableHead.js +1 -1
  327. package/es/Table/util.d.ts +1 -1
  328. package/es/Table/util.js +3 -12
  329. package/es/Tabs/component.json +227 -0
  330. package/es/Tag/component.json +221 -0
  331. package/es/Tag/index.css +1 -1
  332. package/es/Tag/index.d.ts +1 -1
  333. package/es/Tag/index.js +20 -20
  334. package/es/Tag/style/index.css +1 -1
  335. package/es/TextEditor/component.json +186 -0
  336. package/es/TextEditor/index.d.ts +5 -5
  337. package/es/TextEditor/index.js +1 -1
  338. package/es/TextField/component.json +290 -0
  339. package/es/TextField/index.d.ts +2 -2
  340. package/es/TextField/index.js +1 -1
  341. package/es/TimePicker/component.json +176 -0
  342. package/es/Timeline/component.json +110 -0
  343. package/es/Title/component.json +156 -0
  344. package/es/ToggleButton/component.json +153 -0
  345. package/es/ToggleButton/index.js +1 -1
  346. package/es/Tooltip/component.json +176 -0
  347. package/es/Tooltip/index.js +58 -53
  348. package/es/Tooltip/interface.d.ts +14 -1
  349. package/es/Tooltip/utils.js +6 -6
  350. package/es/Transfer/component.json +157 -0
  351. package/es/Tree/OperateBar/index.js +1 -1
  352. package/es/Tree/Tree.js +3 -3
  353. package/es/Tree/component.json +512 -0
  354. package/es/Tree/interface.d.ts +1 -1
  355. package/es/Upload/component.json +450 -0
  356. package/es/Upload/util.js +1 -1
  357. package/es/Utils/snack-kit-shims.d.ts +18 -0
  358. package/es/Utils/snack-kit-shims.js +19 -0
  359. package/es/Utils/type.d.ts +0 -2
  360. package/es/_virtual/index.js +5 -3
  361. package/es/_virtual/index2.js +2 -5
  362. package/es/index.d.ts +2 -0
  363. package/es/index.js +1 -1
  364. package/es/locale/en_US.d.ts +361 -0
  365. package/es/locale/en_US.js +364 -0
  366. package/es/locale/index.d.ts +1 -723
  367. package/es/locale/index2.js +10 -0
  368. package/es/locale/zh_CN.d.ts +361 -0
  369. package/es/locale/zh_CN.js +364 -0
  370. package/es/node_modules/classnames/index.js +1 -1
  371. package/lib/AlignBox/component.json +89 -0
  372. package/lib/AlignBox/index.css +1 -1
  373. package/lib/AlignBox/index.d.ts +6 -2
  374. package/lib/AlignBox/index.js +1 -1
  375. package/lib/AlignBox/style/index.css +1 -1
  376. package/lib/Anchor/anchorMenu/index.d.ts +2 -1
  377. package/lib/Anchor/anchorMenu/index.js +1 -1
  378. package/lib/Anchor/component.json +130 -0
  379. package/lib/Anchor/index.js +1 -1
  380. package/lib/Anchor/type.d.ts +8 -4
  381. package/lib/Argv/component.json +216 -0
  382. package/lib/Argv/dataGenerator/index.js +1 -1
  383. package/lib/Argv/index.d.ts +5 -6
  384. package/lib/Argv/index.js +1 -1
  385. package/lib/AutoBox/component.json +133 -0
  386. package/lib/AutoBox/index.d.ts +3 -3
  387. package/lib/AutoBox/index.js +1 -1
  388. package/lib/AutoBox/protal.d.ts +2 -2
  389. package/lib/AutoBox/protal.js +1 -1
  390. package/lib/AutoButton/component.json +109 -0
  391. package/lib/AutoButton/index.js +1 -1
  392. package/lib/AutoTips/autoTipsMultiline/index.d.ts +1 -1
  393. package/lib/AutoTips/autoTipsMultiline/index.js +1 -1
  394. package/lib/AutoTips/component.json +121 -0
  395. package/lib/AutoTips/index.js +1 -1
  396. package/lib/Badge/component.json +92 -0
  397. package/lib/Breadcrumbs/component.json +142 -0
  398. package/lib/Breadcrumbs/index.js +1 -1
  399. package/lib/Button/SplitButton.d.ts +2 -2
  400. package/lib/Button/component.json +168 -0
  401. package/lib/Button/index.js +1 -1
  402. package/lib/ButtonGroup/component.json +132 -0
  403. package/lib/ButtonGroup/index.d.ts +1 -1
  404. package/lib/Card/component.json +162 -0
  405. package/lib/Card/index.d.ts +2 -2
  406. package/lib/Card/index.js +1 -1
  407. package/lib/Carousel/component.json +142 -0
  408. package/lib/Carousel/index.d.ts +1 -1
  409. package/lib/Cascader/Cascader.js +1 -1
  410. package/lib/Cascader/OptionList/Column.js +1 -1
  411. package/lib/Cascader/OptionList/index.js +1 -1
  412. package/lib/Cascader/component.json +196 -0
  413. package/lib/Cascader/hooks/useEntities.js +1 -1
  414. package/lib/Cascader/interface.d.ts +1 -0
  415. package/lib/Cascader/utils/commonUtil.d.ts +1 -1
  416. package/lib/Cascader/utils/commonUtil.js +1 -1
  417. package/lib/Cascader/utils/treeUtil.d.ts +14 -5
  418. package/lib/Cascader/utils/treeUtil.js +1 -1
  419. package/lib/Checkbox/component.json +138 -0
  420. package/lib/CheckboxGroup/component.json +152 -0
  421. package/lib/CheckboxGroup/index.js +1 -1
  422. package/lib/CodeEditor/component.json +189 -0
  423. package/lib/CodeEditor/index.d.ts +11 -10
  424. package/lib/CodeEditor/index.js +1 -1
  425. package/lib/Collapse/component.json +166 -0
  426. package/lib/Collapse/index.d.ts +1 -1
  427. package/lib/Collapse/index.js +1 -1
  428. package/lib/CollapseBox/component.json +84 -0
  429. package/lib/CollapseLayout/component.json +155 -0
  430. package/lib/ColorPicker/component.json +142 -0
  431. package/lib/ComboSelect/component.json +181 -0
  432. package/lib/ComboSelect/index.js +1 -1
  433. package/lib/ComboSelect/interface.d.ts +2 -2
  434. package/lib/ComboSelect/utils.d.ts +3 -3
  435. package/lib/ComboSelect/utils.js +1 -1
  436. package/lib/Container/component.json +111 -0
  437. package/lib/ContentBox/component.json +81 -0
  438. package/lib/CopyText/component.json +118 -0
  439. package/lib/CycleSelector/component.json +98 -0
  440. package/lib/CycleSelector/index.js +1 -1
  441. package/lib/DatePicker/component.json +192 -0
  442. package/lib/DatePicker/generatePicker/generateRangePicker.js +1 -1
  443. package/lib/DatePicker/generatePicker/generateSinglePicker.js +1 -1
  444. package/lib/Descriptions/component.json +142 -0
  445. package/lib/Descriptions/index.d.ts +1 -1
  446. package/lib/Desktop/component.json +171 -0
  447. package/lib/Desktop/index.js +1 -1
  448. package/lib/DragVerify/component.json +114 -0
  449. package/lib/DragVerify/index.js +1 -1
  450. package/lib/Drawer/component.json +200 -0
  451. package/lib/Drawer/index.js +1 -1
  452. package/lib/Drawer/interface.d.ts +1 -1
  453. package/lib/Drawer/util.d.ts +1 -6
  454. package/lib/Drawer/util.js +1 -1
  455. package/lib/Dropdown/component.json +147 -0
  456. package/lib/Dropdown/index.js +1 -1
  457. package/lib/DynamicMultiBox/component.json +278 -0
  458. package/lib/DynamicMultiBox/formItem.d.ts +1 -1
  459. package/lib/DynamicMultiBox/index.js +1 -1
  460. package/lib/DynamicMultiBox/rowForm.d.ts +2 -2
  461. package/lib/Empty/component.json +123 -0
  462. package/lib/Empty/index.css +1 -1
  463. package/lib/Empty/index.d.ts +2 -2
  464. package/lib/Empty/index.js +1 -1
  465. package/lib/Empty/style/index.css +1 -1
  466. package/lib/FieldForm/FieldFormItem/ItemHolder.js +1 -1
  467. package/lib/FieldForm/FieldFormItem/MemoInput.d.ts +2 -2
  468. package/lib/FieldForm/FieldFormItem/StatusProvider.js +1 -1
  469. package/lib/FieldForm/FieldFormItem/index.d.ts +6 -6
  470. package/lib/FieldForm/Form.d.ts +2 -2
  471. package/lib/FieldForm/Form.js +1 -1
  472. package/lib/FieldForm/FormItemInput.js +1 -1
  473. package/lib/FieldForm/FormItemLabel.js +1 -1
  474. package/lib/FieldForm/FormList.d.ts +2 -2
  475. package/lib/FieldForm/component.json +196 -0
  476. package/lib/FieldForm/context.d.ts +5 -1
  477. package/lib/FieldForm/context.js +1 -1
  478. package/lib/FieldForm/hooks/useForm.d.ts +4 -3
  479. package/lib/FieldForm/hooks/useFormInstance.d.ts +1 -1
  480. package/lib/FieldForm/hooks/useFormItemStatus.d.ts +9 -5
  481. package/lib/FieldForm/hooks/useFormItemStatus.js +1 -1
  482. package/lib/FieldForm/hooks/useItemRef.d.ts +1 -1
  483. package/lib/FieldForm/hooks/useItemRef.js +1 -1
  484. package/lib/Form/component.json +161 -0
  485. package/lib/Form/index.d.ts +52 -49
  486. package/lib/Form/index.js +1 -1
  487. package/lib/FormItem/compoments/defaultCompoments/index.d.ts +5 -5
  488. package/lib/FormItem/compoments/defaultCompoments/index.js +1 -1
  489. package/lib/FormItem/compoments/formCheckboxGroup/index.d.ts +2 -2
  490. package/lib/FormItem/compoments/formFile/index.js +1 -1
  491. package/lib/FormItem/compoments/formRadioGroup/index.d.ts +1 -1
  492. package/lib/FormItem/compoments/formSelect/index.d.ts +1 -1
  493. package/lib/FormItem/component.json +171 -0
  494. package/lib/FormItem/index.d.ts +5 -5
  495. package/lib/FormItem/index.js +1 -1
  496. package/lib/FormItem/itemType.js +1 -1
  497. package/lib/FunctionModal/component.json +197 -0
  498. package/lib/FunctionModal/dialog.d.ts +1 -1
  499. package/lib/FunctionModal/modalContext.d.ts +4 -1
  500. package/lib/GlobalContext/confirmLocale.js +1 -1
  501. package/lib/GlobalContext/index.js +1 -1
  502. package/lib/Help/component.json +118 -0
  503. package/lib/HelperText/component.json +126 -0
  504. package/lib/Image/PreviewGroup.js +1 -1
  505. package/lib/Image/component.json +165 -0
  506. package/lib/Image/index.js +1 -1
  507. package/lib/InputCode/component.json +191 -0
  508. package/lib/InputCode/index.d.ts +2 -2
  509. package/lib/InputLang/component.json +205 -0
  510. package/lib/InputLang/index.js +1 -1
  511. package/lib/InputNumber/component.json +162 -0
  512. package/lib/Label/component.json +126 -0
  513. package/lib/Label/index.d.ts +2 -2
  514. package/lib/Loading/component.json +91 -0
  515. package/lib/Menu/component.json +180 -0
  516. package/lib/Menu/verticalMenuList.js +1 -1
  517. package/lib/Message/component.json +246 -0
  518. package/lib/Message/index.d.ts +2 -2
  519. package/lib/Message/index.js +1 -1
  520. package/lib/Modal/Confirm/index.d.ts +1 -1
  521. package/lib/Modal/Confirm/index.js +1 -1
  522. package/lib/Modal/component.json +277 -0
  523. package/lib/Modal/index.d.ts +85 -5
  524. package/lib/Modal/index.js +1 -1
  525. package/lib/Modal/interface.d.ts +1 -0
  526. package/lib/MultiBox/component.json +216 -0
  527. package/lib/MultiBox/index.js +1 -1
  528. package/lib/Notification/component.json +184 -0
  529. package/lib/OperateBtn/component.json +134 -0
  530. package/lib/OperateBtn/index.d.ts +3 -3
  531. package/lib/PageHeader/component.json +112 -0
  532. package/lib/PageHeader/horizontalMeun.js +1 -1
  533. package/lib/PageHeader/horizontalMeunRight.js +1 -1
  534. package/lib/Pagination/component.json +181 -0
  535. package/lib/Pagination/index.js +1 -1
  536. package/lib/ParauiProvider/index.js +1 -1
  537. package/lib/PasswordRules/component.json +105 -0
  538. package/lib/PasswordRules/index.d.ts +4 -4
  539. package/lib/PopConfirm/component.json +227 -0
  540. package/lib/PopConfirm/index.d.ts +1 -1
  541. package/lib/PopConfirm/index.js +1 -1
  542. package/lib/PopMenu/component.json +131 -0
  543. package/lib/PopMenu/hooks.d.ts +1 -1
  544. package/lib/PopMenu/index.js +1 -1
  545. package/lib/Popover/component.json +165 -0
  546. package/lib/Popover/index.js +1 -1
  547. package/lib/Progress/component.json +161 -0
  548. package/lib/Prompt/component.json +144 -0
  549. package/lib/Querying/component.json +96 -0
  550. package/lib/Querying/index.css +1 -1
  551. package/lib/Querying/index.d.ts +2 -2
  552. package/lib/Querying/index.js +1 -1
  553. package/lib/Querying/style/index.css +1 -1
  554. package/lib/QuickReply/QuickReplyCode/index.js +1 -1
  555. package/lib/QuickReply/component.json +129 -0
  556. package/lib/QuickReply/index.d.ts +1 -1
  557. package/lib/Radio/component.json +136 -0
  558. package/lib/RadioGroup/component.json +149 -0
  559. package/lib/RangeInput/component.json +198 -0
  560. package/lib/RangeInput/index.js +1 -1
  561. package/lib/Result/component.json +104 -0
  562. package/lib/ScrollBar/component.json +115 -0
  563. package/lib/Search/component.json +177 -0
  564. package/lib/Search/index.d.ts +1 -1
  565. package/lib/Select/component.json +244 -0
  566. package/lib/Select/index.js +1 -1
  567. package/lib/SelectInput/component.json +184 -0
  568. package/lib/Selector/component.json +203 -0
  569. package/lib/Selector/index.js +1 -1
  570. package/lib/Selector/interface.d.ts +2 -2
  571. package/lib/Selector/selectorData/index.js +1 -1
  572. package/lib/Selector/selectorMain/index.js +1 -1
  573. package/lib/Selector/selectorNode/index.js +1 -1
  574. package/lib/Selector/util.d.ts +3 -3
  575. package/lib/Selector/util.js +1 -1
  576. package/lib/SelectorPicker/component.json +179 -0
  577. package/lib/SelectorPicker/index.d.ts +5 -5
  578. package/lib/SelectorPicker/index.js +1 -1
  579. package/lib/SingleBox/component.json +151 -0
  580. package/lib/SingleBox/index.d.ts +2 -2
  581. package/lib/Slider/component.json +181 -0
  582. package/lib/SortBox/component.json +108 -0
  583. package/lib/Status/component.json +104 -0
  584. package/lib/Stepper/component.json +129 -0
  585. package/lib/Stepper/index.d.ts +2 -2
  586. package/lib/Switch/component.json +207 -0
  587. package/lib/Switch/index.css +1 -1
  588. package/lib/Switch/index.d.ts +3 -2
  589. package/lib/Switch/index.js +1 -1
  590. package/lib/Switch/style/index.css +1 -1
  591. package/lib/Table/component.json +547 -0
  592. package/lib/Table/index.d.ts +2 -2
  593. package/lib/Table/index.js +1 -1
  594. package/lib/Table/interface.d.ts +30 -0
  595. package/lib/Table/tableHead.js +1 -1
  596. package/lib/Table/util.d.ts +1 -1
  597. package/lib/Table/util.js +1 -1
  598. package/lib/Tabs/component.json +227 -0
  599. package/lib/Tag/component.json +221 -0
  600. package/lib/Tag/index.css +1 -1
  601. package/lib/Tag/index.d.ts +1 -1
  602. package/lib/Tag/index.js +1 -1
  603. package/lib/Tag/style/index.css +1 -1
  604. package/lib/TextEditor/component.json +186 -0
  605. package/lib/TextEditor/index.d.ts +5 -5
  606. package/lib/TextEditor/index.js +1 -1
  607. package/lib/TextField/component.json +290 -0
  608. package/lib/TextField/index.d.ts +2 -2
  609. package/lib/TextField/index.js +1 -1
  610. package/lib/TimePicker/component.json +176 -0
  611. package/lib/Timeline/component.json +110 -0
  612. package/lib/Title/component.json +156 -0
  613. package/lib/ToggleButton/component.json +153 -0
  614. package/lib/ToggleButton/index.js +1 -1
  615. package/lib/Tooltip/component.json +176 -0
  616. package/lib/Tooltip/index.js +1 -1
  617. package/lib/Tooltip/interface.d.ts +14 -1
  618. package/lib/Tooltip/utils.js +1 -1
  619. package/lib/Transfer/component.json +157 -0
  620. package/lib/Tree/OperateBar/index.js +2 -2
  621. package/lib/Tree/Tree.js +1 -1
  622. package/lib/Tree/component.json +512 -0
  623. package/lib/Tree/interface.d.ts +1 -1
  624. package/lib/Upload/component.json +450 -0
  625. package/lib/Upload/util.js +1 -1
  626. package/lib/Utils/snack-kit-shims.d.ts +18 -0
  627. package/lib/Utils/snack-kit-shims.js +2 -0
  628. package/lib/Utils/type.d.ts +0 -2
  629. package/lib/_virtual/index.js +1 -1
  630. package/lib/_virtual/index2.js +1 -1
  631. package/lib/index.d.ts +2 -0
  632. package/lib/index.js +1 -1
  633. package/lib/locale/en_US.d.ts +361 -0
  634. package/lib/locale/en_US.js +2 -0
  635. package/lib/locale/index.d.ts +1 -723
  636. package/lib/locale/index2.js +2 -0
  637. package/lib/locale/zh_CN.d.ts +361 -0
  638. package/lib/locale/zh_CN.js +2 -0
  639. package/lib/node_modules/classnames/index.js +1 -1
  640. package/package.json +11 -4
  641. package/es/_virtual/index3.js +0 -5
  642. package/es/_virtual/index4.js +0 -5
  643. package/es/node_modules/@para-snack/core/dist/index.js +0 -5231
  644. package/lib/_virtual/index3.js +0 -2
  645. package/lib/_virtual/index4.js +0 -2
  646. package/lib/node_modules/@para-snack/core/dist/index.js +0 -20
  647. /package/es/{Utils/Hooks → Hooks}/useResizeObserver.d.ts +0 -0
  648. /package/es/{Utils/Hooks → Hooks}/useResizeObserver.js +0 -0
  649. /package/lib/{Utils/Hooks → Hooks}/useResizeObserver.d.ts +0 -0
  650. /package/lib/{Utils/Hooks → Hooks}/useResizeObserver.js +0 -0
@@ -0,0 +1,136 @@
1
+ {
2
+ "name": "Radio",
3
+ "category": "Data Entry",
4
+ "description": "单选框,用于在多个选项中选择一个,支持受控/非受控及 disabled tooltip",
5
+ "semantic": {
6
+ "intent": [
7
+ "单项选择",
8
+ "互斥选择"
9
+ ],
10
+ "useCases": [
11
+ "性别选择",
12
+ "支付方式",
13
+ "配置切换"
14
+ ],
15
+ "riskLevel": "low"
16
+ },
17
+ "variants": {
18
+ "default": {
19
+ "meaning": "独立单选框"
20
+ },
21
+ "group": {
22
+ "meaning": "单选框组"
23
+ },
24
+ "button": {
25
+ "meaning": "按钮样式单选"
26
+ }
27
+ },
28
+ "states": [
29
+ "checked",
30
+ "unchecked",
31
+ "disabled"
32
+ ],
33
+ "idealProps": {
34
+ "checked": {
35
+ "type": "boolean",
36
+ "description": "受控选中态;父维护 state · 互斥实现:`checked={selectedValue === thisValue}`;**onChange 仅 unchecked → checked 单向触发**(单选框选中后无法 UI 取消)"
37
+ },
38
+ "defaultChecked": {
39
+ "type": "boolean",
40
+ "description": "非受控初始选中态;首次渲染后内部维护;onChange 仍单向触发"
41
+ },
42
+ "disabled": {
43
+ "type": "boolean",
44
+ "default": false,
45
+ "description": "禁用(无法点击/触发 onChange);**本组件无 readOnly prop**,只读场景用 disabled+CSS 灰度覆盖"
46
+ },
47
+ "label": {
48
+ "type": "ReactNode",
49
+ "description": "标题文案;支持 ReactNode(AutoTips 包裹可实现超长截断+hover 显示完整,详见 codeString.ts labelOverflowRadio)"
50
+ },
51
+ "labelTooltip": {
52
+ "type": "LabelTooltipProps",
53
+ "description": "**帮助图标式 tooltip**:label 旁渲染 ? 图标 · hover 显示 tooltip;**不是文字截断省略**(截断需配 AutoTips 包 label · 见 codeString.ts)"
54
+ },
55
+ "width": {
56
+ "type": "string",
57
+ "description": "组件外层容器宽度;常用配合 label 截断(`width='100px'`)"
58
+ },
59
+ "onChange": {
60
+ "type": "(e: React.MouseEvent<HTMLLabelElement>, checked: boolean) => void",
61
+ "description": "选中态变化回调(src/Radio/index.tsx:38 interface 实证,签名为 MouseEvent on HTMLLabelElement,非 ChangeEvent);**仅在 unchecked → checked 单向触发一次**;第二参数 checked = 切换后的新状态(本组件场景下永远为 true)"
62
+ },
63
+ "size": {
64
+ "type": "enum",
65
+ "values": ["small", "medium", "large"],
66
+ "default": "large",
67
+ "description": "单选框大小(src/Radio/index.tsx:24,46,77 实证:default='large';控制 CSS 类 paraui-v4-radio-{size})"
68
+ },
69
+ "disabledTooltip": {
70
+ "type": "TooltipProps",
71
+ "description": "禁用状态下的 Tooltip 配置(src/Radio/index.tsx:34-35,136-142 实证:disabled 时将整个 Radio 包裹在 Tooltip 内,透传全部 TooltipProps,字段名 `title` 作为提示内容)"
72
+ },
73
+ "inputProps": {
74
+ "type": "React.InputHTMLAttributes<HTMLInputElement>",
75
+ "description": "内层原生 radio input 的额外 props(src/Radio/index.tsx:36,118 实证:透传到 `<input type='radio' {...props.inputProps} />`,可用于设置 name/value 等原生属性)"
76
+ },
77
+ "className": {
78
+ "type": "string",
79
+ "description": "自定义类名(src/Radio/index.tsx:14,43 实证,追加到根 label 元素的 className)"
80
+ },
81
+ "style": {
82
+ "type": "React.CSSProperties",
83
+ "description": "自定义样式(src/Radio/index.tsx:16,51,102 实证,透传到根 label 元素的 style;与 width prop 合并)"
84
+ }
85
+ },
86
+ "do": [
87
+ "选项较少(< 5)时优先展示所有选项而非使用 Select",
88
+ "Radio Group 能够清晰展示所有可用选项",
89
+ "**多 Radio 互斥**:父维护 `useState<string> selectedValue` · 每个 Radio 用 `checked={selectedValue === thisValue}` + onChange 触发后 `setSelectedValue(thisValue)`(完整示例见 docs/view/radio/codeString.ts multiRadioGroup)",
90
+ "**label 超长截断 + hover 完整显示**:用 `AutoTips` 包 label,如 `<Radio label={<AutoTips tipMaxWidth='none'>超长 label</AutoTips>} width='180px' />`"
91
+ ],
92
+ "dont": [
93
+ "在可以多选的场景使用 Radio",
94
+ "Radio 选中后无法取消(设计上应保持选中状态;若需 on/off 切换语义请用 Checkbox)",
95
+ "**期望 onChange 在选中后再次点击会再触发(单向触发,只在 unchecked → checked 触发一次)**",
96
+ "**依赖 labelTooltip 实现 label 文字截断省略**(labelTooltip 只是 ? 帮助图标 tooltip · 不截断;截断用 AutoTips 包 label)",
97
+ "**期望 Radio 有 readOnly prop**(无;只读用 disabled + CSS)"
98
+ ],
99
+ "events": {
100
+ "onChange": {
101
+ "signature": "(e: React.MouseEvent<HTMLLabelElement>, checked: boolean) => void",
102
+ "asyncSupported": false,
103
+ "examples": [
104
+ "受控互斥:onChange={(e, checked) => { if (checked) setSelectedValue(thisValue); }}",
105
+ "非受控监听:onChange={(e, checked) => console.log('选中', checked)} // checked 永远为 true",
106
+ "阻止冒泡:onChange={(e, checked) => { e.stopPropagation(); setSelected(checked); }}"
107
+ ],
108
+ "commonMistakes": [
109
+ "期望回调签名是 (e: ChangeEvent<HTMLInputElement>) → 实际是 MouseEvent<HTMLLabelElement>,监听 e.target 行为不同",
110
+ "期望 checked 参数可以是 false(已选后再次点击)——onChange 只在 unchecked→checked 触发,checked 永远为 true",
111
+ "用 onChange 做「取消选中」逻辑——Radio 无法通过点击取消选中;需要 toggle 语义请用 Checkbox"
112
+ ]
113
+ }
114
+ },
115
+ "typescriptPitfalls": [
116
+ {
117
+ "issue": "onChange 签名是 MouseEvent on HTMLLabelElement,不是 ChangeEvent<HTMLInputElement>",
118
+ "wrong": "onChange={(e: React.ChangeEvent<HTMLInputElement>) => setValue(e.target.checked)} // 类型不匹配",
119
+ "right": "onChange={(e: React.MouseEvent<HTMLLabelElement>, checked: boolean) => { if (checked) setValue(thisValue); }}"
120
+ },
121
+ {
122
+ "issue": "disabledTooltip 的类型是 TooltipProps(完整对象),不是字符串",
123
+ "wrong": "disabledTooltip='此项不可选' // 类型报错,应传对象",
124
+ "right": "disabledTooltip={{ title: '此项不可选', placement: 'top' }}"
125
+ },
126
+ {
127
+ "issue": "size 默认值是 'large'(不是 'medium'),与 antd/MUI 业界惯例不同",
128
+ "wrong": "// 不传 size 期望得到中等大小\n<Radio label='选项' /> // 实际渲染 large 尺寸",
129
+ "right": "<Radio label='选项' size='medium' /> // 明确指定 size 避免布局意外"
130
+ }
131
+ ],
132
+ "mapping": {
133
+ "realComponent": "Radio",
134
+ "adapter": null
135
+ }
136
+ }
@@ -0,0 +1,149 @@
1
+ {
2
+ "name": "RadioGroup",
3
+ "category": "Data Entry",
4
+ "description": "单选框组,统一管理一组 Radio 的受控选中态,支持泛型约束和二维布局",
5
+ "semantic": {
6
+ "intent": [
7
+ "单选",
8
+ "互斥选择"
9
+ ],
10
+ "useCases": [
11
+ "选项切换",
12
+ "模式选择",
13
+ "单选配置"
14
+ ],
15
+ "riskLevel": "low"
16
+ },
17
+ "variants": {
18
+ "default": {
19
+ "meaning": "默认样式"
20
+ }
21
+ },
22
+ "states": [
23
+ "default",
24
+ "disabled"
25
+ ],
26
+ "idealProps": {
27
+ "list": {
28
+ "type": "RadioListProps[] | RadioListProps[][]",
29
+ "description": "选项数据(必填)。**RadioListProps extends RadioProps**(可含 label/disabled 等 Radio prop)。⚠️ 默认以 `item[id]` 取值(id prop 默认 'name'),list 每项必须有对应字段;传二维数组 `RadioListProps[][]` 时按行分组渲染"
30
+ },
31
+ "value": {
32
+ "type": "T",
33
+ "description": "当前选中值(受控);类型 T 由泛型推断(默认 unknown);与 list 项的 item[id] 字段值对比决定哪项选中"
34
+ },
35
+ "defaultValue": {
36
+ "type": "T",
37
+ "description": "默认选中值(非受控初始态);与 value 互斥——传 value 则受控"
38
+ },
39
+ "onChange": {
40
+ "type": "(val: T, item?: RadioListProps) => void",
41
+ "description": "值变化回调;val = item[id](即 list 项中 id 字段对应的值);item 是被点击的完整 list 项对象"
42
+ },
43
+ "id": {
44
+ "type": "string",
45
+ "default": "name",
46
+ "description": "**list 每项的取值字段名**(默认 'name',不是 'value')——RadioGroup 内部取 item[id] 作为选中值;⚠️ 这是常见混淆点:字段名是 'name' 不是 'value'"
47
+ },
48
+ "label": {
49
+ "type": "ReactNode",
50
+ "description": "组标题"
51
+ },
52
+ "labelTooltip": {
53
+ "type": "LabelTooltipProps",
54
+ "description": "组标题旁的帮助图标 tooltip"
55
+ },
56
+ "required": {
57
+ "type": "boolean",
58
+ "default": false,
59
+ "description": "是否必填(显示红色星号)"
60
+ },
61
+ "row": {
62
+ "type": "boolean",
63
+ "default": true,
64
+ "description": "布局方式;true=横向排列;false=纵向排列"
65
+ },
66
+ "spacing": {
67
+ "type": "string",
68
+ "default": "32px",
69
+ "description": "横向布局时每项之间的间距(CSS 值,如 '16px');row=false 时不生效"
70
+ },
71
+ "itemWidth": {
72
+ "type": "string",
73
+ "description": "每项的固定宽度(CSS 值,如 '120px');配合 row=false 的栅格对齐"
74
+ },
75
+ "size": {
76
+ "type": "enum",
77
+ "values": ["small", "medium", "large"],
78
+ "default": "large",
79
+ "description": "尺寸,透传给每个 Radio(src/RadioGroup/index.tsx:65 实证,default='large')"
80
+ },
81
+ "disabled": {
82
+ "type": "boolean",
83
+ "default": false,
84
+ "description": "全局禁用所有选项(优先于 list 每项的 disabled)"
85
+ },
86
+ "error": {
87
+ "type": "boolean",
88
+ "default": false,
89
+ "description": "错误状态(显示红色边框 + helperText 错误样式,来自 HelperTextDetailProps 继承)"
90
+ },
91
+ "helperText": {
92
+ "type": "ReactNode",
93
+ "default": "",
94
+ "description": "错误或提示文字(error=true 时红色显示,error=false 时灰色显示)"
95
+ },
96
+ "hideErrorDom": {
97
+ "type": "boolean",
98
+ "description": "是否隐藏错误文字 DOM(表单布局固定高度时防止错误文字撑开布局)"
99
+ }
100
+ },
101
+ "do": [
102
+ "配合 Radio 使用——RadioGroup 统一管理 checked 状态,无需每个 Radio 手动维护",
103
+ "选项数量适中(2-5),超出 5 个考虑 Select",
104
+ "list 项必须有 id 对应字段(默认 'name')作为选中值,如 `list={[{ name: 'a', label: '选项A' }]}` 且不传 id prop",
105
+ "支持泛型收窄类型:`<RadioGroup<'male' | 'female'>>` 让 value/onChange 类型推断更精确"
106
+ ],
107
+ "dont": [
108
+ "选项过多(应使用 Select)",
109
+ "忽略默认选中——至少通过 defaultValue 或 value 提供初始状态,否则所有项均未选中",
110
+ "以为 list 项的取值字段是 'value'——RadioGroup 默认取 item['name'],需要用 'value' 字段时需传 id='value'"
111
+ ],
112
+ "events": {
113
+ "onChange": {
114
+ "signature": "(val: T, item?: RadioListProps) => void",
115
+ "asyncSupported": false,
116
+ "examples": [
117
+ "受控写法:value={selected} onChange={(val) => setSelected(val)}",
118
+ "获取完整 item:onChange={(val, item) => { setSelected(val); logItem(item); }}",
119
+ "泛型收窄:<RadioGroup<'a' | 'b'> list={...} value={v} onChange={(val) => setV(val)}>"
120
+ ],
121
+ "commonMistakes": [
122
+ "假设 val 是 item.value——RadioGroup 取 item[id](默认 item.name),不是 item.value",
123
+ "不回写 value prop 导致选中态不更新——RadioGroup 是受控组件,onChange 后必须 setState 回写 value",
124
+ "list 项缺少 id 字段——id 默认 'name',list 项无 name 字段时 val 会是 undefined"
125
+ ]
126
+ }
127
+ },
128
+ "typescriptPitfalls": [
129
+ {
130
+ "issue": "id prop 指定取值字段名,默认是 'name' 不是 'value',混淆导致 onChange 收到 undefined",
131
+ "wrong": "// list 每项有 value 字段,但不传 id:\nlist={[{ value: 'male', label: '男' }]} // onChange 收到 undefined,因为取的是 item['name']",
132
+ "right": "// 方案A:list 项用 name 字段\nlist={[{ name: 'male', label: '男' }]}\n// 方案B:显式传 id='value'\n<RadioGroup id='value' list={[{ value: 'male', label: '男' }]} />"
133
+ },
134
+ {
135
+ "issue": "RadioGroup 泛型参数 T 默认 unknown,value/onChange 类型过宽,建议显式传泛型",
136
+ "wrong": "// T=unknown,onChange val 类型 unknown,需 as 强转:\nconst [v, setV] = useState<string>(); onChange={(val) => setV(val as string)}",
137
+ "right": "const [v, setV] = useState<string>(); <RadioGroup<string> value={v} onChange={(val) => setV(val)} />"
138
+ },
139
+ {
140
+ "issue": "list 支持二维数组分行,但每行内项的 onChange 逻辑相同——误以为二维数组需要特殊处理",
141
+ "wrong": "// 二维数组时自己实现 checked 逻辑\nlist={[[...], [...]]} value={v} onChange不传 // 组件已内部处理,不需要额外逻辑",
142
+ "right": "<RadioGroup list={[[item1, item2], [item3, item4]]} value={v} onChange={(val) => setV(val)} />"
143
+ }
144
+ ],
145
+ "mapping": {
146
+ "realComponent": "RadioGroup",
147
+ "adapter": null
148
+ }
149
+ }
@@ -0,0 +1,198 @@
1
+ {
2
+ "name": "RangeInput",
3
+ "category": "Data Entry",
4
+ "description": "范围输入框,两个 InputNumber 组成数值区间,自动 swap 防止 min>max",
5
+ "semantic": {
6
+ "intent": [
7
+ "范围输入",
8
+ "区间选择"
9
+ ],
10
+ "useCases": [
11
+ "价格区间",
12
+ "数量范围",
13
+ "时间范围"
14
+ ],
15
+ "riskLevel": "normal"
16
+ },
17
+ "variants": {
18
+ "default": {
19
+ "meaning": "默认样式"
20
+ }
21
+ },
22
+ "states": [
23
+ "default",
24
+ "disabled",
25
+ "error"
26
+ ],
27
+ "idealProps": {
28
+ "value": {
29
+ "type": "Clearable extends true ? [number | null, number | null] : [number | undefined, number | undefined]",
30
+ "description": "当前值(受控)。**类型随 clearable 泛型条件切换**(协议 RI1):clearable=true → `[number | null, number | null]`(任一端可 null 表示清空);clearable=false(默认)→ `[number | undefined, number | undefined]`(直接传 null TS 报错)"
31
+ },
32
+ "defaultValue": {
33
+ "type": "Clearable extends true ? [number | null, number | null] : [number | undefined, number | undefined]",
34
+ "description": "默认值(非受控);类型规则同 value(随 clearable 切换)"
35
+ },
36
+ "onChange": {
37
+ "type": "(val, index) => void",
38
+ "description": "值变化回调。**val 类型**:clearable=true → `[number | null, number | null]`;clearable=false → `[number, number]`。**index** 是触发输入框下标(0/1),index=-1 表示内部 swap 触发(min>max 自动交换)。**业务 [number, number] 桥接**:`(val) => onChange([val[0] ?? 0, val[1] ?? 0])`(协议 RI2)"
39
+ },
40
+ "clearable": {
41
+ "type": "boolean",
42
+ "default": false,
43
+ "description": "是否允许清空(协议 RI1)。**默认 false**;true 时全链路类型放宽到 `number | null`,清空后 onChange 回传含 null 的二元组(不是 null 本体);false 时类型收窄。**业务需要清空必须显式 `clearable={true}`**"
44
+ },
45
+ "size": {
46
+ "type": "enum",
47
+ "values": [
48
+ "small",
49
+ "medium",
50
+ "large"
51
+ ],
52
+ "default": "large",
53
+ "description": "控件大小(三档全部支持)"
54
+ },
55
+ "label": {
56
+ "type": "ReactNode",
57
+ "description": "组标题"
58
+ },
59
+ "labelTooltip": {
60
+ "type": "LabelTooltipProps",
61
+ "description": "标题旁帮助图标 tooltip"
62
+ },
63
+ "required": {
64
+ "type": "boolean",
65
+ "default": false,
66
+ "description": "是否必填(显示红色星号)"
67
+ },
68
+ "disabled": {
69
+ "type": "boolean | [boolean, boolean]",
70
+ "default": false,
71
+ "description": "禁用;boolean=两侧都禁;[boolean, boolean]=分别控制左右"
72
+ },
73
+ "disabledTooltip": {
74
+ "type": "TooltipProps | [TooltipProps, TooltipProps]",
75
+ "description": "禁用状态 tooltip;单值=两侧共享;数组=分别控制左右(src/RangeInput/index.tsx:34 interface 实证)"
76
+ },
77
+ "separator": {
78
+ "type": "ReactNode",
79
+ "default": "~",
80
+ "description": "中间分隔符"
81
+ },
82
+ "unit": {
83
+ "type": "ReactNode",
84
+ "description": "单位文本(显示在右侧)"
85
+ },
86
+ "placeholder": {
87
+ "type": "ReactNode | [ReactNode, ReactNode]",
88
+ "description": "占位文本;单值=两侧共享;数组=分别控制左右"
89
+ },
90
+ "warningMessage": {
91
+ "type": "ReactNode",
92
+ "description": "min>max 自动 swap 后展示的警告文案(swap 发生后显示 warnTime 毫秒)"
93
+ },
94
+ "warnTime": {
95
+ "type": "number",
96
+ "default": 2000,
97
+ "description": "warningMessage 自动消失时间(毫秒)"
98
+ },
99
+ "otherProps": {
100
+ "type": "[InputNumberProps, InputNumberProps]",
101
+ "description": "左右两个 InputNumber 的额外 props,分别透传(src/RangeInput/index.tsx:60 interface 实证)"
102
+ },
103
+ "error": {
104
+ "type": "boolean",
105
+ "default": false,
106
+ "description": "错误状态"
107
+ },
108
+ "helperText": {
109
+ "type": "ReactNode",
110
+ "description": "错误/提示文字"
111
+ },
112
+ "onBlur": {
113
+ "type": "(event: React.FocusEvent<HTMLInputElement>, index: number) => void",
114
+ "description": "失去焦点回调;index=0/1 区分左右;swap 逻辑在整体失焦后触发(rAF 延后)"
115
+ },
116
+ "onFocus": {
117
+ "type": "(event: React.FocusEvent<HTMLInputElement>, index: number) => void",
118
+ "description": "获得焦点回调;index=0/1 区分左右"
119
+ },
120
+ "onEnter": {
121
+ "type": "(event: React.KeyboardEvent<HTMLInputElement>, index: number) => void",
122
+ "description": "回车回调;index=0/1 区分左右"
123
+ }
124
+ },
125
+ "crossPropInteractions": [
126
+ "clearable=true + value 类型 = 全链路放宽 [number | null, number | null]",
127
+ "clearable=false(默认)+ value 类型 = 收窄 [number | undefined, number | undefined]",
128
+ "onChange val + index = index=0/1 触发位,-1 表示内部 swap(min>max 自动交换)",
129
+ "disabled [boolean, boolean] + disabledTooltip [TooltipProps, TooltipProps] = 分别控制左右",
130
+ "size + 三档全部支持 = small / medium / large(api.ts 与 component.json 已对齐)"
131
+ ],
132
+ "commonMisconceptions": [
133
+ "❌ 默认就能传 [null, null] 清空 — 必须显式 clearable={true}",
134
+ "❌ clearable=true 清空回传 null 本体 — 实际回传 [null, null] 二元组",
135
+ "❌ onChange 永远是 [number | null, number | null] — clearable=false 时实为 [number, number]",
136
+ "❌ size 只支持 small/large — 三档全部支持(api.ts 已修正)",
137
+ "❌ value desc 说「默认值 受控」— 历史 typo,实际是「当前值 受控」"
138
+ ],
139
+ "do": [
140
+ "校验最小值不能大于最大值——组件会在整体失焦后自动 swap,配合 warningMessage 提示用户",
141
+ "提供清晰的分隔符(默认 '~',可自定义如 ' 至 ')",
142
+ "业务需要清空功能时显式传 clearable={true}(类型全链路放宽)",
143
+ "业务 [number, number] 严格非 null 时不传 clearable(类型收窄保护,onChange 回参直接是 [number, number])"
144
+ ],
145
+ "dont": [
146
+ "忽略边界校验——min>max 时组件虽自动 swap,但最好在 onChange 里加业务层校验",
147
+ "不提示输入错误——配合 error + helperText 展示校验失败原因",
148
+ "默认 clearable=false 时传 [null, null](TS 报错)"
149
+ ],
150
+ "events": {
151
+ "onChange": {
152
+ "signature": "(val: [number | null, number | null] | [number, number], index: number) => void",
153
+ "asyncSupported": false,
154
+ "examples": [
155
+ "受控写法:value={range} onChange={(val, index) => setRange(val)}",
156
+ "区分触发位:onChange={(val, index) => { if (index === 0) validateMin(val[0]); else if (index === 1) validateMax(val[1]); else console.log('swap 触发'); }}",
157
+ "clearable=false 桥接:onChange={(val) => setBizRange([val[0] ?? 0, val[1] ?? 0])}"
158
+ ],
159
+ "commonMistakes": [
160
+ "index=-1 时 val 两端都变化(swap)——不能只看 val[index],index=-1 时应同时处理两端",
161
+ "clearable=false 时 onChange val 里出现 null——理论上不会,但渐进过渡期需兼容",
162
+ "忘记回写 value prop——RangeInput 是受控组件,onChange 后必须 setState 回写,否则页面回弹"
163
+ ]
164
+ },
165
+ "onBlur": {
166
+ "signature": "(event: React.FocusEvent<HTMLInputElement>, index: number) => void",
167
+ "asyncSupported": false,
168
+ "examples": [
169
+ "整体失焦时才触发 swap——左右切焦时 onBlur 会被调但 swap 不触发(rAF 检测 activeElement 仍在组件内)",
170
+ "onBlur={(e, index) => { if (!rootRef.current?.contains(document.activeElement)) doValidation(); }}"
171
+ ],
172
+ "commonMistakes": [
173
+ "在 onBlur 里立即读 value 期望拿到 swap 后的值——swap 是通过 rAF 异步触发,onBlur 调用时 swap 尚未执行"
174
+ ]
175
+ }
176
+ },
177
+ "typescriptPitfalls": [
178
+ {
179
+ "issue": "clearable=false(默认)时 value 类型是 [number | undefined, number | undefined],直接传 [null, null] TS 报错",
180
+ "wrong": "value={[null, null]} // clearable=false 时类型不允许 null",
181
+ "right": "<RangeInput<true> clearable value={[null, null]} /> // 显式泛型 true 或 clearable={true}"
182
+ },
183
+ {
184
+ "issue": "onChange val 类型随 clearable 泛型变化,不显式传泛型时 val 类型推断可能宽泛",
185
+ "wrong": "// clearable=false 但 onChange handler 写成接受 null:\nonChange={(val: [number | null, number | null]) => ...} // 与 clearable=false 合约不符",
186
+ "right": "// clearable=false(默认)\nonChange={(val: [number, number]) => setRange(val)}"
187
+ },
188
+ {
189
+ "issue": "disabled 支持 [boolean, boolean] 元组,但传普通 boolean[] 数组类型不精确",
190
+ "wrong": "const flags: boolean[] = [true, false]; <RangeInput disabled={flags} /> // 类型报错",
191
+ "right": "const flags: [boolean, boolean] = [true, false]; <RangeInput disabled={flags} />"
192
+ }
193
+ ],
194
+ "mapping": {
195
+ "realComponent": "RangeInput",
196
+ "adapter": null
197
+ }
198
+ }
@@ -1,12 +1,12 @@
1
1
  import { j as n } from "../_virtual/jsx-runtime.js";
2
2
  import { useState as b, useRef as q, useEffect as v } from "react";
3
- import { $prefixCls as i } from "../GlobalContext/constant.js";
3
+ import { $prefixCls as u } from "../GlobalContext/constant.js";
4
4
  import ee from "../Label/index.js";
5
5
  import { InputNumber as H } from "../InputNumber/index.js";
6
6
  import P from "../HelperText/index.js";
7
7
  import re from "clsx";
8
8
  import { Tooltip as ne } from "../Tooltip/index.js";
9
- import { DeepClone as te } from "@paraview/lib";
9
+ import { DeepClone as te } from "@snack-kit/lib";
10
10
  import './index.css';/* empty css */
11
11
  function ge(o) {
12
12
  const {
@@ -27,14 +27,14 @@ function ge(o) {
27
27
  helperText: O = "",
28
28
  separator: Q = "~",
29
29
  unit: j,
30
- placeholder: c,
30
+ placeholder: i,
31
31
  clearable: oe = !1,
32
32
  onFocus: T,
33
33
  onBlur: E,
34
34
  onEnter: I,
35
- onChange: d,
36
- otherProps: f
37
- } = o, [u, m] = b([null, null]), [U, F] = b(!1), [X, N] = b(!1), e = q({
35
+ onChange: c,
36
+ otherProps: d
37
+ } = o, [f, m] = b([null, null]), [U, F] = b(!1), [X, N] = b(!1), e = q({
38
38
  timer: null,
39
39
  swapRafId: null
40
40
  }), $ = q(null);
@@ -45,7 +45,7 @@ function ge(o) {
45
45
  }, [h]), v(() => () => {
46
46
  e.current.swapRafId !== null && (cancelAnimationFrame(e.current.swapRafId), e.current.swapRafId = null), e.current.timer !== null && (clearTimeout(e.current.timer), e.current.timer = null);
47
47
  }, []);
48
- const A = (r) => c && c instanceof Array ? c[r] : c, p = (r) => l && l instanceof Array ? l[r] : l, D = (r) => (t) => {
48
+ const A = (r) => i && i instanceof Array ? i[r] : i, p = (r) => l && l instanceof Array ? l[r] : l, D = (r) => (t) => {
49
49
  F(!0), T && T(t, r);
50
50
  }, y = (r) => (t) => {
51
51
  F(!1), E && E(t, r), e.current.swapRafId !== null && cancelAnimationFrame(e.current.swapRafId), e.current.swapRafId = requestAnimationFrame(() => {
@@ -53,33 +53,33 @@ function ge(o) {
53
53
  const a = $.current;
54
54
  if (a && a.contains(document.activeElement))
55
55
  return;
56
- const [g, x] = u;
56
+ const [g, x] = f;
57
57
  if (g !== null && x !== null && g > x) {
58
58
  const W = [x, g];
59
- o.value === void 0 && m(W), d && d(W, -1), w && Y();
59
+ o.value === void 0 && m(W), c && c(W, -1), w && Y();
60
60
  }
61
61
  });
62
62
  }, Y = () => {
63
- clearTimeout(e.current.timer), N(!0), e.current.timer = setTimeout(() => {
63
+ clearTimeout(e.current.timer ?? void 0), N(!0), e.current.timer = setTimeout(() => {
64
64
  N(!1);
65
65
  }, K);
66
66
  }, B = (r) => (t) => {
67
67
  I && I(t, r);
68
68
  }, V = (r) => (t) => {
69
- const a = u ? te(u) : [];
70
- a[r] = t, o.value === void 0 && m(a), d && d(a, r);
69
+ const a = te(f);
70
+ a[r] = t, o.value === void 0 && m(a), c && c(a, r);
71
71
  }, M = () => /* @__PURE__ */ n.jsxs("div", { className: "range-input-content", children: [
72
72
  /* @__PURE__ */ n.jsx(
73
73
  H,
74
74
  {
75
- ...f && f[0],
75
+ ...d && d[0],
76
76
  clearable: !0,
77
77
  btnMode: "none",
78
78
  hideErrorDom: !0,
79
79
  placeholder: A(0),
80
80
  disabled: p(0),
81
81
  disabledTooltip: s?.[0],
82
- value: u[0],
82
+ value: f[0],
83
83
  onFocus: D(0),
84
84
  onBlur: y(0),
85
85
  onEnter: B(0),
@@ -90,14 +90,14 @@ function ge(o) {
90
90
  /* @__PURE__ */ n.jsx(
91
91
  H,
92
92
  {
93
- ...f && f[1],
93
+ ...d && d[1],
94
94
  clearable: !0,
95
95
  btnMode: "none",
96
96
  hideErrorDom: !0,
97
97
  placeholder: A(1),
98
98
  disabled: p(1),
99
99
  disabledTooltip: s?.[1],
100
- value: u[1],
100
+ value: f[1],
101
101
  onFocus: D(1),
102
102
  onBlur: y(1),
103
103
  onEnter: B(1),
@@ -132,10 +132,10 @@ function ge(o) {
132
132
  "div",
133
133
  {
134
134
  ref: $,
135
- className: re(S, `${i}-range-input`, `${i}-range-input-${G}`, {
136
- [`${i}-range-input-focus`]: U,
137
- [`${i}-range-input-disabled`]: l === !0 || p(0) && p(1),
138
- [`${i}-range-input-error`]: C
135
+ className: re(S, `${u}-range-input`, `${u}-range-input-${G}`, {
136
+ [`${u}-range-input-focus`]: U,
137
+ [`${u}-range-input-disabled`]: l === !0 || p(0) && p(1),
138
+ [`${u}-range-input-error`]: C
139
139
  }),
140
140
  style: z,
141
141
  children: [