@vef-framework-react/components 2.10.0 → 2.11.0

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 (327) hide show
  1. package/dist/cjs/file-preview/index.cjs +1 -0
  2. package/dist/cjs/file-upload/helpers.cjs +1 -0
  3. package/dist/cjs/file-upload/index.cjs +1 -1
  4. package/dist/cjs/form/fields/upload/index.cjs +1 -1
  5. package/dist/cjs/index.cjs +1 -1
  6. package/dist/cjs/upload/helpers.cjs +1 -0
  7. package/dist/cjs/upload/index.cjs +1 -1
  8. package/dist/es/_base/constants/breakpoints.js +1 -1
  9. package/dist/es/_base/constants/common.js +1 -1
  10. package/dist/es/_base/constants/css-vars.js +1 -1
  11. package/dist/es/_base/constants/event.js +1 -1
  12. package/dist/es/_base/constants/index.js +1 -1
  13. package/dist/es/_base/constants/symbols.js +1 -1
  14. package/dist/es/_base/constants/theme.js +1 -1
  15. package/dist/es/_base/globals.js +1 -1
  16. package/dist/es/_base/helpers/breakpoints.js +1 -1
  17. package/dist/es/_base/helpers/color.js +1 -1
  18. package/dist/es/_base/helpers/common.js +1 -1
  19. package/dist/es/_base/helpers/event.js +1 -1
  20. package/dist/es/_base/helpers/index.js +1 -1
  21. package/dist/es/_base/helpers/message.js +1 -1
  22. package/dist/es/_base/helpers/modal.js +1 -1
  23. package/dist/es/_base/helpers/notification.js +1 -1
  24. package/dist/es/_base/helpers/props.js +1 -1
  25. package/dist/es/_base/helpers/react.js +1 -1
  26. package/dist/es/_base/hooks/index.js +1 -1
  27. package/dist/es/_base/hooks/use-theme-tokens.js +1 -1
  28. package/dist/es/_base/index.js +1 -1
  29. package/dist/es/_base/styles/common.js +1 -1
  30. package/dist/es/_base/styles/index.js +1 -1
  31. package/dist/es/_base/types/breakpoints.js +1 -1
  32. package/dist/es/_base/types/common.js +1 -1
  33. package/dist/es/_base/types/index.js +1 -1
  34. package/dist/es/action-button/index.js +1 -1
  35. package/dist/es/action-button/use-action-button.js +1 -1
  36. package/dist/es/action-group/index.js +1 -1
  37. package/dist/es/action-group/use-action-group.js +1 -1
  38. package/dist/es/action-group/use-computed-action-buttons.js +1 -1
  39. package/dist/es/affix/index.js +1 -1
  40. package/dist/es/alert/index.js +1 -1
  41. package/dist/es/anchor/index.js +1 -1
  42. package/dist/es/auto-complete/index.js +1 -1
  43. package/dist/es/avatar/index.js +1 -1
  44. package/dist/es/badge/index.js +1 -1
  45. package/dist/es/bool/index.js +1 -1
  46. package/dist/es/border-beam/index.js +1 -1
  47. package/dist/es/breadcrumb/index.js +1 -1
  48. package/dist/es/button/index.js +1 -1
  49. package/dist/es/calendar/index.js +1 -1
  50. package/dist/es/card/index.js +1 -1
  51. package/dist/es/carousel/index.js +1 -1
  52. package/dist/es/cascader/index.js +1 -1
  53. package/dist/es/center/index.js +1 -1
  54. package/dist/es/charts/chart.js +1 -1
  55. package/dist/es/charts/helpers/group.js +1 -1
  56. package/dist/es/charts/helpers/index.js +1 -1
  57. package/dist/es/charts/hooks/index.js +1 -1
  58. package/dist/es/charts/hooks/use-chart.js +1 -1
  59. package/dist/es/charts/index.js +1 -1
  60. package/dist/es/charts/themes/index.js +1 -1
  61. package/dist/es/charts/themes/walden-dark.js +1 -1
  62. package/dist/es/charts/themes/walden.js +1 -1
  63. package/dist/es/charts/themes/wonderland-dark.js +1 -1
  64. package/dist/es/charts/themes/wonderland.js +1 -1
  65. package/dist/es/checkbox/index.js +1 -1
  66. package/dist/es/code-editor/index.js +1 -1
  67. package/dist/es/code-highlighter/index.js +1 -1
  68. package/dist/es/col/index.js +1 -1
  69. package/dist/es/collapse/index.js +1 -1
  70. package/dist/es/color-picker/index.js +1 -1
  71. package/dist/es/compact/index.js +1 -1
  72. package/dist/es/config-provider/app.js +1 -1
  73. package/dist/es/config-provider/constants.js +1 -1
  74. package/dist/es/config-provider/context-holder.js +1 -1
  75. package/dist/es/config-provider/css-vars.js +1 -1
  76. package/dist/es/config-provider/dark-mode-context.js +1 -1
  77. package/dist/es/config-provider/error-fallback.js +1 -1
  78. package/dist/es/config-provider/global-style.js +1 -1
  79. package/dist/es/config-provider/index.js +1 -1
  80. package/dist/es/config-provider/theme-config.js +1 -1
  81. package/dist/es/config-provider/use-config-provider.js +1 -1
  82. package/dist/es/crud/components/action-button-group.js +1 -1
  83. package/dist/es/crud/components/index.js +1 -1
  84. package/dist/es/crud/components/main.js +1 -1
  85. package/dist/es/crud/components/mutation-holder.js +1 -1
  86. package/dist/es/crud/components/operation-button-group.js +1 -1
  87. package/dist/es/crud/components/scene-form.js +1 -1
  88. package/dist/es/crud/components/selection-indicator.js +1 -1
  89. package/dist/es/crud/components/toolbar-actions.js +1 -1
  90. package/dist/es/crud/components/toolbar.js +1 -1
  91. package/dist/es/crud/event.js +1 -1
  92. package/dist/es/crud/helpers.js +1 -1
  93. package/dist/es/crud/hooks/index.js +1 -1
  94. package/dist/es/crud/hooks/use-query-observer.js +1 -1
  95. package/dist/es/crud/hooks/use-search-values.js +1 -1
  96. package/dist/es/crud/hooks/use-selected-rows.js +1 -1
  97. package/dist/es/crud/index.js +1 -1
  98. package/dist/es/crud/store.js +1 -1
  99. package/dist/es/crud/styles.js +1 -1
  100. package/dist/es/crud-page/index.js +1 -1
  101. package/dist/es/date-picker/index.js +1 -1
  102. package/dist/es/descriptions/index.js +1 -1
  103. package/dist/es/divider/index.js +1 -1
  104. package/dist/es/drawer/index.js +1 -1
  105. package/dist/es/dropdown/index.js +1 -1
  106. package/dist/es/dynamic-icon/index.js +1 -1
  107. package/dist/es/dynamic-icon/load-icon-node.js +1 -1
  108. package/dist/es/dynamic-icon/placeholder-icon.js +1 -1
  109. package/dist/es/dynamic-icon/unknown-icon.js +1 -1
  110. package/dist/es/editable-table/components/add-row-button.js +1 -1
  111. package/dist/es/editable-table/components/editable-cell.js +1 -1
  112. package/dist/es/editable-table/components/editable-row-actions.js +1 -1
  113. package/dist/es/editable-table/components/index.js +1 -1
  114. package/dist/es/editable-table/helpers.js +1 -1
  115. package/dist/es/editable-table/hooks/index.js +1 -1
  116. package/dist/es/editable-table/hooks/use-editable-actions.js +1 -1
  117. package/dist/es/editable-table/hooks/use-editable-columns.js +1 -1
  118. package/dist/es/editable-table/index.js +1 -1
  119. package/dist/es/editable-table/store.js +1 -1
  120. package/dist/es/empty/empty.js +1 -1
  121. package/dist/es/empty/index.js +1 -1
  122. package/dist/es/file-preview/index.js +17 -0
  123. package/dist/es/file-upload/helpers.js +8 -0
  124. package/dist/es/file-upload/index.js +13 -16
  125. package/dist/es/flex/index.js +1 -1
  126. package/dist/es/flex-card/index.js +1 -1
  127. package/dist/es/flex-card/styles.js +1 -1
  128. package/dist/es/flip-text/index.js +1 -1
  129. package/dist/es/float-button/index.js +1 -1
  130. package/dist/es/form/components/form.js +1 -1
  131. package/dist/es/form/components/index.js +1 -1
  132. package/dist/es/form/components/reset-button.js +1 -1
  133. package/dist/es/form/components/submit-button.js +1 -1
  134. package/dist/es/form/contexts/form-context.js +1 -1
  135. package/dist/es/form/contexts/form-layout.js +1 -1
  136. package/dist/es/form/contexts/index.js +1 -1
  137. package/dist/es/form/fields/auto-complete/index.js +1 -1
  138. package/dist/es/form/fields/bool/index.js +1 -1
  139. package/dist/es/form/fields/cascader/index.js +1 -1
  140. package/dist/es/form/fields/checkbox/index.js +1 -1
  141. package/dist/es/form/fields/code-editor/index.js +1 -1
  142. package/dist/es/form/fields/color-picker/index.js +1 -1
  143. package/dist/es/form/fields/date-picker/index.js +1 -1
  144. package/dist/es/form/fields/date-range-picker/index.js +1 -1
  145. package/dist/es/form/fields/icon-picker/index.js +1 -1
  146. package/dist/es/form/fields/index.js +1 -1
  147. package/dist/es/form/fields/input/index.js +1 -1
  148. package/dist/es/form/fields/input-number/index.js +1 -1
  149. package/dist/es/form/fields/mentions/index.js +1 -1
  150. package/dist/es/form/fields/password/index.js +1 -1
  151. package/dist/es/form/fields/radio/index.js +1 -1
  152. package/dist/es/form/fields/rate/index.js +1 -1
  153. package/dist/es/form/fields/select/index.js +1 -1
  154. package/dist/es/form/fields/slider/index.js +1 -1
  155. package/dist/es/form/fields/textarea/index.js +1 -1
  156. package/dist/es/form/fields/time-picker/index.js +1 -1
  157. package/dist/es/form/fields/time-range-picker/index.js +1 -1
  158. package/dist/es/form/fields/transfer/index.js +1 -1
  159. package/dist/es/form/fields/tree-select/index.js +1 -1
  160. package/dist/es/form/fields/upload/index.js +52 -31
  161. package/dist/es/form/form-actions.js +1 -1
  162. package/dist/es/form/form.js +1 -1
  163. package/dist/es/form/helpers/create-field.js +1 -1
  164. package/dist/es/form/helpers/index.js +1 -1
  165. package/dist/es/form/helpers/with-form-item.js +1 -1
  166. package/dist/es/form/hooks/use-form-item-props.js +1 -1
  167. package/dist/es/form/hooks/use-label-width.js +1 -1
  168. package/dist/es/form/index.js +1 -1
  169. package/dist/es/form/use-form.js +1 -1
  170. package/dist/es/form-drawer/index.js +1 -1
  171. package/dist/es/form-modal/index.js +1 -1
  172. package/dist/es/generic-select/index.js +1 -1
  173. package/dist/es/grid/context.js +1 -1
  174. package/dist/es/grid/grid-item.js +1 -1
  175. package/dist/es/grid/hooks/index.js +1 -1
  176. package/dist/es/grid/hooks/use-container-breakpoints.js +1 -1
  177. package/dist/es/grid/hooks/use-container-width.js +1 -1
  178. package/dist/es/grid/hooks/use-grid-collapsed.js +1 -1
  179. package/dist/es/grid/hooks/use-normalized-gap.js +1 -1
  180. package/dist/es/grid/hooks/use-responsive-breakpoint.js +1 -1
  181. package/dist/es/grid/hooks/use-responsive-value.js +1 -1
  182. package/dist/es/grid/index.js +1 -1
  183. package/dist/es/grid/styles.js +1 -1
  184. package/dist/es/group/index.js +1 -1
  185. package/dist/es/icon/index.js +1 -1
  186. package/dist/es/icon-button/index.js +1 -1
  187. package/dist/es/icon-picker/icon-grid.js +1 -1
  188. package/dist/es/icon-picker/index.js +1 -1
  189. package/dist/es/image/index.js +1 -1
  190. package/dist/es/index.js +56 -54
  191. package/dist/es/input/index.js +1 -1
  192. package/dist/es/input-number/index.js +1 -1
  193. package/dist/es/keyboard/index.js +1 -1
  194. package/dist/es/list/index.js +1 -1
  195. package/dist/es/loader/index.js +1 -1
  196. package/dist/es/logo-icon/index.js +1 -1
  197. package/dist/es/mentions/index.js +1 -1
  198. package/dist/es/menu/index.js +1 -1
  199. package/dist/es/modal/index.js +1 -1
  200. package/dist/es/modal/modal.js +1 -1
  201. package/dist/es/operation-button/index.js +1 -1
  202. package/dist/es/page/components/aside-panel.js +1 -1
  203. package/dist/es/page/components/index.js +1 -1
  204. package/dist/es/page/components/resize-handle.js +1 -1
  205. package/dist/es/page/components/scroll-content.js +1 -1
  206. package/dist/es/page/entrance.js +1 -1
  207. package/dist/es/page/hooks/index.js +1 -1
  208. package/dist/es/page/hooks/use-page-key.js +1 -1
  209. package/dist/es/page/hooks/use-resize.js +1 -1
  210. package/dist/es/page/index.js +1 -1
  211. package/dist/es/page/styles.js +1 -1
  212. package/dist/es/page/viewport-context.js +1 -1
  213. package/dist/es/pagination/index.js +1 -1
  214. package/dist/es/permission-gate/index.js +1 -1
  215. package/dist/es/popconfirm/index.js +1 -1
  216. package/dist/es/popover/index.js +1 -1
  217. package/dist/es/pro-search/components/advanced-search-toggler.js +1 -1
  218. package/dist/es/pro-search/components/advanced-search.js +1 -1
  219. package/dist/es/pro-search/components/index.js +1 -1
  220. package/dist/es/pro-search/components/search-actions.js +1 -1
  221. package/dist/es/pro-search/index.js +1 -1
  222. package/dist/es/pro-search/styles.js +1 -1
  223. package/dist/es/pro-table/components/column-setting-item.js +1 -1
  224. package/dist/es/pro-table/components/column-settings-panel.js +1 -1
  225. package/dist/es/pro-table/components/column-settings.js +1 -1
  226. package/dist/es/pro-table/components/index.js +1 -1
  227. package/dist/es/pro-table/components/operation-button-group.js +1 -1
  228. package/dist/es/pro-table/components/ref.js +1 -1
  229. package/dist/es/pro-table/components/table-subscriber.js +1 -1
  230. package/dist/es/pro-table/components/table-summary.js +1 -1
  231. package/dist/es/pro-table/components/table-title.js +1 -1
  232. package/dist/es/pro-table/components/table.js +1 -1
  233. package/dist/es/pro-table/components/width-popover.js +1 -1
  234. package/dist/es/pro-table/context.js +1 -1
  235. package/dist/es/pro-table/event.js +1 -1
  236. package/dist/es/pro-table/hooks/index.js +1 -1
  237. package/dist/es/pro-table/hooks/use-column-settings-persistence.js +1 -1
  238. package/dist/es/pro-table/hooks/use-row-selection.js +1 -1
  239. package/dist/es/pro-table/hooks/use-table-columns.js +1 -1
  240. package/dist/es/pro-table/index.js +1 -1
  241. package/dist/es/pro-table/store.js +1 -1
  242. package/dist/es/progress/index.js +1 -1
  243. package/dist/es/qrcode/index.js +1 -1
  244. package/dist/es/radio/index.js +1 -1
  245. package/dist/es/rate/index.js +1 -1
  246. package/dist/es/result/index.js +1 -1
  247. package/dist/es/row/index.js +1 -1
  248. package/dist/es/scroll-area/index.js +1 -1
  249. package/dist/es/scroll-area/styles.js +1 -1
  250. package/dist/es/segmented/index.js +1 -1
  251. package/dist/es/select/hooks/index.js +1 -1
  252. package/dist/es/select/hooks/use-data-options-select.js +1 -1
  253. package/dist/es/select/hooks/use-dictionary-options-select.js +1 -1
  254. package/dist/es/select/index.js +1 -1
  255. package/dist/es/skeleton/index.js +1 -1
  256. package/dist/es/slider/index.js +1 -1
  257. package/dist/es/space/index.js +1 -1
  258. package/dist/es/space/space.js +1 -1
  259. package/dist/es/sparkles-text/index.js +1 -1
  260. package/dist/es/sparkles-text/sparkle.js +1 -1
  261. package/dist/es/spin/index.js +1 -1
  262. package/dist/es/split-text/index.js +1 -1
  263. package/dist/es/splitter/index.js +1 -1
  264. package/dist/es/stack/index.js +1 -1
  265. package/dist/es/statistic/index.js +1 -1
  266. package/dist/es/steps/index.js +1 -1
  267. package/dist/es/switch/index.js +1 -1
  268. package/dist/es/table/index.js +1 -1
  269. package/dist/es/table/use-pagination-props.js +1 -1
  270. package/dist/es/tabs/index.js +1 -1
  271. package/dist/es/tag/index.js +1 -1
  272. package/dist/es/time-picker/index.js +1 -1
  273. package/dist/es/timeline/index.js +1 -1
  274. package/dist/es/tooltip/index.js +1 -1
  275. package/dist/es/tour/index.js +1 -1
  276. package/dist/es/transfer/index.js +1 -1
  277. package/dist/es/tree/hooks/index.js +1 -1
  278. package/dist/es/tree/hooks/use-data-options-tree.js +1 -1
  279. package/dist/es/tree/index.js +1 -1
  280. package/dist/es/tree-select/hooks/index.js +1 -1
  281. package/dist/es/tree-select/hooks/use-data-options-tree-select.js +1 -1
  282. package/dist/es/tree-select/index.js +1 -1
  283. package/dist/es/typing-animation/index.js +1 -1
  284. package/dist/es/typography/index.js +1 -1
  285. package/dist/es/upload/helpers.js +80 -0
  286. package/dist/es/upload/index.js +105 -41
  287. package/dist/es/watermark/index.js +1 -1
  288. package/dist/types/dynamic-icon/index.d.ts +1 -1
  289. package/dist/types/file-preview/index.d.ts +21 -0
  290. package/dist/types/file-preview/types.d.ts +55 -0
  291. package/dist/types/file-upload/helpers.d.ts +1 -0
  292. package/dist/types/file-upload/index.d.ts +3 -3
  293. package/dist/types/file-upload/props.d.ts +3 -21
  294. package/dist/types/index.d.ts +3 -2
  295. package/dist/types/upload/helpers.d.ts +37 -0
  296. package/dist/types/upload/index.d.ts +3 -2
  297. package/dist/types/upload/props.d.ts +24 -0
  298. package/package.json +4 -4
  299. package/dist/types/action-button/index.test.d.ts +0 -1
  300. package/dist/types/action-group/index.test.d.ts +0 -1
  301. package/dist/types/bool/index.test.d.ts +0 -1
  302. package/dist/types/code-editor/index.test.d.ts +0 -1
  303. package/dist/types/crud/helpers.test.d.ts +0 -1
  304. package/dist/types/crud/store.test.d.ts +0 -1
  305. package/dist/types/crud-page/index.test.d.ts +0 -1
  306. package/dist/types/dynamic-icon/index.test.d.ts +0 -1
  307. package/dist/types/editable-table/index.test.d.ts +0 -1
  308. package/dist/types/file-upload/index.test.d.ts +0 -1
  309. package/dist/types/form/components/form.test.d.ts +0 -1
  310. package/dist/types/form/fields/code-editor/index.test.d.ts +0 -1
  311. package/dist/types/form/fields/icon-picker/index.test.d.ts +0 -1
  312. package/dist/types/form/form-actions.test.d.ts +0 -1
  313. package/dist/types/form-drawer/index.test.d.ts +0 -1
  314. package/dist/types/form-modal/index.test.d.ts +0 -1
  315. package/dist/types/generic-select/index.test.d.ts +0 -1
  316. package/dist/types/grid/index.test.d.ts +0 -1
  317. package/dist/types/icon-button/index.test.d.ts +0 -1
  318. package/dist/types/icon-picker/index.test.d.ts +0 -1
  319. package/dist/types/keyboard/index.test.d.ts +0 -1
  320. package/dist/types/modal/index.test.d.ts +0 -1
  321. package/dist/types/operation-button/index.test.d.ts +0 -1
  322. package/dist/types/page/entrance.test.d.ts +0 -1
  323. package/dist/types/page/index.test.d.ts +0 -1
  324. package/dist/types/permission-gate/index.test.d.ts +0 -1
  325. package/dist/types/pro-table/index.test.d.ts +0 -1
  326. package/dist/types/scroll-area/index.test.d.ts +0 -1
  327. package/dist/types/table/index.test.d.ts +0 -1
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Framework-normalized description of a file the user asked to preview.
3
+ *
4
+ * Exactly how the bytes are obtained is up to the preview host; prefer `file`
5
+ * when bytes are already local, then resolve `key` or `url` through a channel
6
+ * that satisfies the application's authentication requirements.
7
+ */
8
+ export interface FilePreviewTarget {
9
+ /**
10
+ * Display name including the extension. Most viewers derive the file
11
+ * format from it.
12
+ */
13
+ filename: string;
14
+ /**
15
+ * MIME type when known. Local files expose it; files hydrated from a
16
+ * storage key usually do not.
17
+ */
18
+ contentType?: string;
19
+ /**
20
+ * File size in bytes when known.
21
+ */
22
+ size?: number;
23
+ /**
24
+ * Local file content when available — pending, uploading, and failed
25
+ * files, plus files uploaded in the current session.
26
+ */
27
+ file?: File;
28
+ /**
29
+ * Storage object key for files uploaded through the framework's chunked
30
+ * storage protocol (e.g. `priv/2026/05/12/abc.docx`).
31
+ */
32
+ key?: string;
33
+ /**
34
+ * Resolved fetch URL when known — composed from `fileBaseUrl` for stored
35
+ * objects, or taken from the AntD `UploadFile` as-is.
36
+ */
37
+ url?: string;
38
+ }
39
+ /**
40
+ * Contract a file-preview host implements. The framework never renders a
41
+ * viewer itself — the application provides one (a dialog around a viewer
42
+ * library, a new tab, etc.) via `FilePreviewProvider`.
43
+ */
44
+ export interface FilePreviewHandler {
45
+ /**
46
+ * Whether the host can preview the target. Must be cheap and synchronous
47
+ * (no network). Treated as `true` when omitted.
48
+ */
49
+ canPreview?: (target: FilePreviewTarget) => boolean;
50
+ /**
51
+ * Open the preview for the target. Synchronous dispatch only — fetching
52
+ * and rendering happen inside the host.
53
+ */
54
+ openPreview: (target: FilePreviewTarget) => void;
55
+ }
@@ -0,0 +1 @@
1
+ export declare function resolveStoredFileUrl(key: string, fileBaseUrl: string | undefined, resolveFileUrl: ((key: string) => string) | undefined): string;
@@ -3,9 +3,9 @@ import { FileUploadProps } from './props';
3
3
  /**
4
4
  * Chunked-upload variant of `<Upload>` wired to `sys/storage`. Each file is
5
5
  * handed to its own `Uploader` instance, so AntD's concurrent file dispatch
6
- * works out of the box. Successfully uploaded files have `key`, `url`, and
7
- * `fileName` patched onto the AntD `UploadFile` so downstream form fields
6
+ * works out of the box. Successfully uploaded files have `key`, `sourceUrl`,
7
+ * and `fileName` patched onto the AntD `UploadFile` so downstream form fields
8
8
  * can read them without a separate state channel.
9
9
  */
10
10
  export declare function FileUpload({ public: isPublic, apiPath, resource, version, partConcurrency, maxPartRetries, resolveFileUrl, onUploadProgress, onUploadSuccess, onUploadError, ...uploadProps }: FileUploadProps): ReactElement;
11
- export type { FileUploadProps, UploadedFileMeta } from './props';
11
+ export type { FileUploadProps } from './props';
@@ -1,30 +1,12 @@
1
1
  import { UploaderOptions, UploadError, UploadProgress, UploadResult } from '@vef-framework-react/core';
2
2
  import { UploadProps } from '../upload';
3
- /**
4
- * Per-file metadata attached to AntD `UploadFile`s after a successful upload.
5
- */
6
- export interface UploadedFileMeta {
7
- /**
8
- * Object key (e.g. `priv/2026/05/12/abc.png`).
9
- */
10
- key: string;
11
- /**
12
- * Resolved fetch URL — composed from `fileBaseUrl` unless `resolveFileUrl` is supplied.
13
- */
14
- url: string;
15
- /**
16
- * Original client-supplied filename echoed back by the backend.
17
- */
18
- fileName: string;
19
- }
20
3
  /**
21
4
  * `<FileUpload>` props. Inherits the AntD `<Upload>` shell's props (drag-drop,
22
5
  * picture-card, paste, image crop, etc.) and overrides `customRequest` so the
23
6
  * upload runs through the framework's chunked storage protocol.
24
7
  *
25
- * Pass `value` / `onChange` for controlled use as a form field over file keys;
26
- * pass nothing and rely on `fileList` if you want fully-controlled AntD-style
27
- * use.
8
+ * Use `fileList` / `onChange` for controlled AntD-style use. Form values made
9
+ * of storage keys are owned by `UploadField`, not this component.
28
10
  */
29
11
  export interface FileUploadProps extends Omit<UploadProps, "customRequest" | "action" | "method" | "data" | "headers"> {
30
12
  /**
@@ -53,7 +35,7 @@ export interface FileUploadProps extends Omit<UploadProps, "customRequest" | "ac
53
35
  */
54
36
  maxPartRetries?: UploaderOptions["maxPartRetries"];
55
37
  /**
56
- * Resolve an object key into a fetch URL. Defaults to
38
+ * Resolve an object key into a source URL. Defaults to
57
39
  * `${fileBaseUrl}/${key}` from `useAppContext` with double-slash collapsing.
58
40
  */
59
41
  resolveFileUrl?: (key: string) => string;
@@ -36,7 +36,8 @@ export { Dropdown, type DropdownButtonProps, type DropdownButtonType, type Dropd
36
36
  export { DynamicIcon, type DynamicIconName, type DynamicIconProps } from './dynamic-icon';
37
37
  export { createEditableColumn, EditableTable, type EditableColumn, type EditableColumnOptions, type EditableOperationColumnConfig, type EditableRowActionsTexts, type EditableTableProps, type EditFieldContext, type RenderEditor, type RenderView } from './editable-table';
38
38
  export { Empty, type EmptyProps } from './empty';
39
- export { FileUpload, type FileUploadProps, type UploadedFileMeta } from './file-upload';
39
+ export { FilePreviewProvider, useFilePreview, type FilePreviewHandler, type FilePreviewProviderProps, type FilePreviewTarget } from './file-preview';
40
+ export { FileUpload, type FileUploadProps } from './file-upload';
40
41
  export { Flex, type FlexProps } from './flex';
41
42
  export { FlexCard, type FlexCardProps } from './flex-card';
42
43
  export { FlipText, type FlipTextProps } from './flip-text';
@@ -102,5 +103,5 @@ export { Tree, useDataOptionsTree, type TreeNode, type TreeProps, type UseDataOp
102
103
  export { TreeSelect, useDataOptionsTreeSelect, type TreeSelectProps, type UseDataOptionsTreeSelectOptions } from './tree-select';
103
104
  export { TypingAnimation, type TypingAnimationProps } from './typing-animation';
104
105
  export { Link, Paragraph, Text, Title, type LinkProps, type ParagraphProps, type TextProps, type TitleProps } from './typography';
105
- export { Upload, type UploadFile, type UploadProps } from './upload';
106
+ export { toFilePreviewTarget, Upload, type UploadedFileMeta, type UploadFile, type UploadProps } from './upload';
106
107
  export { Watermark, type WatermarkProps } from './watermark';
@@ -0,0 +1,37 @@
1
+ import { UploadFile } from 'antd';
2
+ import { FilePreviewTarget } from '../file-preview';
3
+ /**
4
+ * Read the URL a preview host should use without exposing it to AntD's list
5
+ * renderer. Framework-owned files use `sourceUrl`; ordinary UploadFiles keep
6
+ * their original `url` behind the internal view-model marker.
7
+ */
8
+ export declare function getUploadSourceUrl(file: UploadFile): string | undefined;
9
+ /**
10
+ * Build the safe view-model passed to AntD. AntD renders `UploadFile.url` as a
11
+ * native link and uses it in its default download fallback, so source URLs
12
+ * must not be present on that object.
13
+ */
14
+ export declare function toAntdUploadFile(file: UploadFile): UploadFile;
15
+ /**
16
+ * Restore an ordinary UploadFile's original URL at explicit callback
17
+ * boundaries. Framework-owned files continue to expose `sourceUrl` instead.
18
+ */
19
+ export declare function toPublicUploadFile(file: UploadFile): UploadFile;
20
+ /**
21
+ * Keep a URL added by a custom request readable to its owner while preventing
22
+ * AntD's success-path object spread from copying it into the list view-model.
23
+ */
24
+ export declare function isolateUploadRequestFileUrl(file: unknown): void;
25
+ /**
26
+ * Decide whether an AntD `UploadFile` represents an image from its actual
27
+ * file metadata. AntD's generated thumbnail is deliberately ignored because
28
+ * non-image files may also have image thumbnails.
29
+ */
30
+ export declare function isImageFile(file: UploadFile): boolean;
31
+ /**
32
+ * Normalize an AntD `UploadFile` into the framework's preview contract.
33
+ * This is the single place that knows where the upload family stores its
34
+ * metadata — `UploadedFileMeta` on the list entry, local bytes on
35
+ * `originFileObj` — so preview hosts never inspect `UploadFile` themselves.
36
+ */
37
+ export declare function toFilePreviewTarget(file: UploadFile): FilePreviewTarget;
@@ -1,4 +1,5 @@
1
1
  import { UploadProps } from './props';
2
- export declare function Upload({ enableCrop, cropperProps, listType, fileList, defaultFileList, maxCount, pastable, onPreview, children, ...props }: UploadProps): import("@emotion/react/jsx-runtime").JSX.Element;
3
- export { type UploadProps } from './props';
2
+ export declare function Upload({ enableCrop, cropperProps, isImageUrl, listType, fileList, iconRender, itemRender, defaultFileList, maxCount, pastable, customRequest, onChange, onDownload, onPreview, onRemove, showUploadList, children, ...props }: UploadProps): import("@emotion/react/jsx-runtime").JSX.Element;
3
+ export { toFilePreviewTarget } from './helpers';
4
+ export { type UploadedFileMeta, type UploadProps } from './props';
4
5
  export { type UploadFile } from 'antd';
@@ -1,6 +1,30 @@
1
1
  import { Except } from '@vef-framework-react/shared';
2
2
  import { UploadProps as UploadPropsInternal } from 'antd';
3
3
  import { ImgCropProps } from 'antd-img-crop';
4
+ /**
5
+ * Per-file storage metadata stamped onto AntD `UploadFile`s by the upload
6
+ * family: `<FileUpload>` patches it onto the origin `File` when a chunked
7
+ * upload completes (AntD spreads it into the list entry), and `UploadField`
8
+ * stamps it when hydrating stored keys. Preview targeting and form fields
9
+ * read storage keys back through this shape.
10
+ */
11
+ export interface UploadedFileMeta {
12
+ /**
13
+ * Object key (e.g. `priv/2026/05/12/abc.png`).
14
+ */
15
+ key: string;
16
+ /**
17
+ * Resolved source URL for fetching the stored object. Kept separate from
18
+ * AntD's navigable `UploadFile.url` so authenticated files are never exposed
19
+ * as native list links. Use `UploadFile.thumbUrl` only for an application-
20
+ * approved presentation thumbnail.
21
+ */
22
+ sourceUrl: string;
23
+ /**
24
+ * Original client-supplied filename echoed back by the backend.
25
+ */
26
+ fileName: string;
27
+ }
4
28
  export interface UploadProps extends UploadPropsInternal {
5
29
  /**
6
30
  * Whether to enable image cropping feature
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vef-framework-react/components",
3
- "version": "2.10.0",
3
+ "version": "2.11.0",
4
4
  "private": false,
5
5
  "description": "Components for VEF Framework",
6
6
  "keywords": [
@@ -73,9 +73,9 @@
73
73
  "react-error-boundary": "^6.1.2",
74
74
  "react-syntax-highlighter": "^16.1.1",
75
75
  "tslib": "^2.8.1",
76
- "@vef-framework-react/hooks": "2.10.0",
77
- "@vef-framework-react/shared": "2.10.0",
78
- "@vef-framework-react/core": "2.10.0"
76
+ "@vef-framework-react/core": "2.11.0",
77
+ "@vef-framework-react/shared": "2.11.0",
78
+ "@vef-framework-react/hooks": "2.11.0"
79
79
  },
80
80
  "devDependencies": {
81
81
  "@types/react-syntax-highlighter": "^15.5.13",
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};
@@ -1 +0,0 @@
1
- export {};