@pixpilot/formily-shadcn 1.8.0 → 1.9.1

package/dist/components/IconPicker.d.cts

@@ -1,4 +1,4 @@
-import * as react7 from "react";
+import * as react4 from "react";
 import { IconPickerProps, IconProviderProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/IconPicker.d.ts
@@ -8,8 +8,8 @@ import { IconPickerProps, IconProviderProps } from "@pixpilot/shadcn-ui";
  * Automatically connects to Formily field state
  * Supports both static and async icon providers
  */
-declare const IconPicker: react7.ForwardRefExoticComponent<Partial<Omit<IconPickerProps, "providers"> & {
+declare const IconPicker: react4.ForwardRefExoticComponent<Partial<Omit<IconPickerProps, "providers"> & {
   providers?: IconProviderProps[];
-}> & react7.RefAttributes<unknown>>;
+}> & react4.RefAttributes<unknown>>;
 //#endregion
 export { IconPicker };

package/dist/components/IconToggle.d.cts

@@ -1,4 +1,4 @@
-import * as react4 from "react";
+import * as react6 from "react";
 import * as _pixpilot_shadcn_ui0 from "@pixpilot/shadcn-ui";
 
 //#region src/components/IconToggle.d.ts
@@ -6,6 +6,6 @@ import * as _pixpilot_shadcn_ui0 from "@pixpilot/shadcn-ui";
  * Formily-connected IconToggle component
  * Toggle button with customizable icons for boolean values
  */
-declare const IconToggle: react4.ForwardRefExoticComponent<Omit<Partial<Omit<_pixpilot_shadcn_ui0.IconToggleProps, "ref"> & react4.RefAttributes<HTMLButtonElement>>, "ref"> & react4.RefAttributes<unknown>>;
+declare const IconToggle: react6.ForwardRefExoticComponent<Omit<Partial<Omit<_pixpilot_shadcn_ui0.IconToggleProps, "ref"> & react6.RefAttributes<HTMLButtonElement>>, "ref"> & react6.RefAttributes<unknown>>;
 //#endregion
 export { IconToggle };

package/dist/components/file-upload/AvatarUpload.cjs

@@ -12,9 +12,10 @@ react_jsx_runtime = require_rolldown_runtime.__toESM(react_jsx_runtime);
 
 //#region src/components/file-upload/AvatarUpload.tsx
 const BaseAvatarUpload = (props) => {
-	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = require_use_file_upload_feedback.useFileUploadFeedback(props);
+	const { mapValue: _mapValue,...uploadProps } = props;
+	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = require_use_file_upload_feedback.useFileUploadFeedback(uploadProps);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn_ui.AvatarUpload, {
-		...props,
+		...uploadProps,
 		maxSize,
 		onFilesReject: handleFilesRejection,
 		onFileValidate: handleFileValidate,

package/dist/components/file-upload/AvatarUpload.d.cts

@@ -1,12 +1,13 @@
+import { FormilyUploadProps } from "./map-upload-props.cjs";
 import React from "react";
 import { AvatarUploadProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/AvatarUpload.d.ts
-
+type AvatarUploadProps$1 = FormilyUploadProps<AvatarUploadProps>;
 /**
  * Formily-connected AvatarUpload component
  * Automatically connects shadcn AvatarUpload to Formily field state
  */
-declare const AvatarUpload: React.ForwardRefExoticComponent<Omit<Partial<AvatarUploadProps>, "ref"> & React.RefAttributes<unknown>>;
+declare const AvatarUpload: React.FC<AvatarUploadProps$1>;
 //#endregion
-export { AvatarUpload };
+export { AvatarUpload, AvatarUploadProps$1 as AvatarUploadProps };

package/dist/components/file-upload/AvatarUpload.d.ts

@@ -1,12 +1,13 @@
+import { FormilyUploadProps } from "./map-upload-props.js";
 import React from "react";
 import { AvatarUploadProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/AvatarUpload.d.ts
-
+type AvatarUploadProps$1 = FormilyUploadProps<AvatarUploadProps>;
 /**
  * Formily-connected AvatarUpload component
  * Automatically connects shadcn AvatarUpload to Formily field state
  */
-declare const AvatarUpload$1: React.ForwardRefExoticComponent<Omit<Partial<AvatarUploadProps>, "ref"> & React.RefAttributes<unknown>>;
+declare const AvatarUpload$1: React.FC<AvatarUploadProps$1>;
 //#endregion
-export { AvatarUpload$1 as AvatarUpload };
+export { AvatarUpload$1 as AvatarUpload, AvatarUploadProps$1 as AvatarUploadProps };

package/dist/components/file-upload/AvatarUpload.js

@@ -7,9 +7,10 @@ import { jsx } from "react/jsx-runtime";
 
 //#region src/components/file-upload/AvatarUpload.tsx
 const BaseAvatarUpload = (props) => {
-	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = useFileUploadFeedback(props);
+	const { mapValue: _mapValue,...uploadProps } = props;
+	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = useFileUploadFeedback(uploadProps);
 	return /* @__PURE__ */ jsx(AvatarUpload, {
-		...props,
+		...uploadProps,
 		maxSize,
 		onFilesReject: handleFilesRejection,
 		onFileValidate: handleFileValidate,

package/dist/components/file-upload/FileUpload.cjs

@@ -12,9 +12,10 @@ react_jsx_runtime = require_rolldown_runtime.__toESM(react_jsx_runtime);
 
 //#region src/components/file-upload/FileUpload.tsx
 const BaseFileUpload = (props) => {
-	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = require_use_file_upload_feedback.useFileUploadFeedback(props);
+	const { mapValue: _mapValue,...uploadProps } = props;
+	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = require_use_file_upload_feedback.useFileUploadFeedback(uploadProps);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn_ui.FileUpload, {
-		...props,
+		...uploadProps,
 		maxSize,
 		onFilesReject: handleFilesRejection,
 		onFileValidate: handleFileValidate,

package/dist/components/file-upload/FileUpload.d.cts

@@ -1,20 +1,13 @@
+import { FormilyUploadProps } from "./map-upload-props.cjs";
 import React from "react";
-import * as _pixpilot_shadcn_ui15 from "@pixpilot/shadcn-ui";
+import { FileUploadProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/FileUpload.d.ts
-
+type FileUploadProps$1 = FormilyUploadProps<FileUploadProps>;
 /**
  * Formily-connected FileUpload component
  * Automatically connects shadcn FileUpload to Formily field state
  */
-declare const FileUpload: React.ForwardRefExoticComponent<(Omit<Partial<_pixpilot_shadcn_ui15.FileUploadInlineBaseProps & _pixpilot_shadcn_ui15.FileUploadRootPropsBaseProps & {
-  multiple: true;
-  value?: _pixpilot_shadcn_ui15.FileMetadata[];
-  onChange?: _pixpilot_shadcn_ui15.OnChangeMultipleFiles;
-} & _pixpilot_shadcn_ui15.FileUploadBaseProps & _pixpilot_shadcn_ui15.MultiFileCallbacks>, "ref"> | Omit<Partial<_pixpilot_shadcn_ui15.FileUploadInlineBaseProps & _pixpilot_shadcn_ui15.FileUploadRootPropsBaseProps & {
-  multiple?: false;
-  value?: _pixpilot_shadcn_ui15.FileMetadata | null;
-  onChange?: _pixpilot_shadcn_ui15.OnChangeSingleFile;
-} & _pixpilot_shadcn_ui15.FileUploadBaseProps & _pixpilot_shadcn_ui15.UseFileCallbacks>, "ref">) & React.RefAttributes<unknown>>;
+declare const FileUpload: React.FC<FileUploadProps$1>;
 //#endregion
-export { FileUpload };
+export { FileUpload, FileUploadProps$1 as FileUploadProps };

package/dist/components/file-upload/FileUpload.d.ts

@@ -1,20 +1,13 @@
+import { FormilyUploadProps } from "./map-upload-props.js";
 import React from "react";
-import * as _pixpilot_shadcn_ui15 from "@pixpilot/shadcn-ui";
+import { FileUploadProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/FileUpload.d.ts
-
+type FileUploadProps$1 = FormilyUploadProps<FileUploadProps>;
 /**
  * Formily-connected FileUpload component
  * Automatically connects shadcn FileUpload to Formily field state
  */
-declare const FileUpload$1: React.ForwardRefExoticComponent<(Omit<Partial<_pixpilot_shadcn_ui15.FileUploadInlineBaseProps & _pixpilot_shadcn_ui15.FileUploadRootPropsBaseProps & {
-  multiple: true;
-  value?: _pixpilot_shadcn_ui15.FileMetadata[];
-  onChange?: _pixpilot_shadcn_ui15.OnChangeMultipleFiles;
-} & _pixpilot_shadcn_ui15.FileUploadBaseProps & _pixpilot_shadcn_ui15.MultiFileCallbacks>, "ref"> | Omit<Partial<_pixpilot_shadcn_ui15.FileUploadInlineBaseProps & _pixpilot_shadcn_ui15.FileUploadRootPropsBaseProps & {
-  multiple?: false;
-  value?: _pixpilot_shadcn_ui15.FileMetadata | null;
-  onChange?: _pixpilot_shadcn_ui15.OnChangeSingleFile;
-} & _pixpilot_shadcn_ui15.FileUploadBaseProps & _pixpilot_shadcn_ui15.UseFileCallbacks>, "ref">) & React.RefAttributes<unknown>>;
+declare const FileUpload$1: React.FC<FileUploadProps$1>;
 //#endregion
-export { FileUpload$1 as FileUpload };
+export { FileUpload$1 as FileUpload, FileUploadProps$1 as FileUploadProps };

package/dist/components/file-upload/FileUpload.js

@@ -7,9 +7,10 @@ import { jsx } from "react/jsx-runtime";
 
 //#region src/components/file-upload/FileUpload.tsx
 const BaseFileUpload = (props) => {
-	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = useFileUploadFeedback(props);
+	const { mapValue: _mapValue,...uploadProps } = props;
+	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = useFileUploadFeedback(uploadProps);
 	return /* @__PURE__ */ jsx(FileUpload, {
-		...props,
+		...uploadProps,
 		maxSize,
 		onFilesReject: handleFilesRejection,
 		onFileValidate: handleFileValidate,

package/dist/components/file-upload/FileUploadInline.cjs

@@ -12,9 +12,10 @@ react_jsx_runtime = require_rolldown_runtime.__toESM(react_jsx_runtime);
 
 //#region src/components/file-upload/FileUploadInline.tsx
 const BaseFileUploadInline = (props) => {
-	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = require_use_file_upload_feedback.useFileUploadFeedback(props);
+	const { mapValue: _mapValue,...uploadProps } = props;
+	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = require_use_file_upload_feedback.useFileUploadFeedback(uploadProps);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn_ui.FileUploadInline, {
-		...props,
+		...uploadProps,
 		maxSize,
 		onFilesReject: handleFilesRejection,
 		onFileValidate: handleFileValidate,

package/dist/components/file-upload/FileUploadInline.d.cts

@@ -1,20 +1,13 @@
+import { FormilyUploadProps } from "./map-upload-props.cjs";
 import React from "react";
-import * as _pixpilot_shadcn_ui3 from "@pixpilot/shadcn-ui";
+import { FileUploadInlineProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/FileUploadInline.d.ts
-
+type FileUploadInlineProps$1 = FormilyUploadProps<FileUploadInlineProps>;
 /**
  * Formily-connected FileUploadInline component
  * Automatically connects shadcn FileUploadInline to Formily field state
  */
-declare const FileUploadInline: React.ForwardRefExoticComponent<(Omit<Partial<_pixpilot_shadcn_ui3.FileUploadInlineBaseProps & _pixpilot_shadcn_ui3.FileUploadRootPropsBaseProps & {
-  multiple: true;
-  value?: _pixpilot_shadcn_ui3.FileMetadata[];
-  onChange?: _pixpilot_shadcn_ui3.OnChangeMultipleFiles;
-} & _pixpilot_shadcn_ui3.FileUploadBaseProps & _pixpilot_shadcn_ui3.MultiFileCallbacks>, "ref"> | Omit<Partial<_pixpilot_shadcn_ui3.FileUploadInlineBaseProps & _pixpilot_shadcn_ui3.FileUploadRootPropsBaseProps & {
-  multiple?: false;
-  value?: _pixpilot_shadcn_ui3.FileMetadata | null;
-  onChange?: _pixpilot_shadcn_ui3.OnChangeSingleFile;
-} & _pixpilot_shadcn_ui3.FileUploadBaseProps & _pixpilot_shadcn_ui3.UseFileCallbacks>, "ref">) & React.RefAttributes<unknown>>;
+declare const FileUploadInline: React.FC<FileUploadInlineProps$1>;
 //#endregion
-export { FileUploadInline };
+export { FileUploadInline, FileUploadInlineProps$1 as FileUploadInlineProps };

package/dist/components/file-upload/FileUploadInline.d.ts

@@ -1,20 +1,13 @@
+import { FormilyUploadProps } from "./map-upload-props.js";
 import React from "react";
-import * as _pixpilot_shadcn_ui3 from "@pixpilot/shadcn-ui";
+import { FileUploadInlineProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/FileUploadInline.d.ts
-
+type FileUploadInlineProps$1 = FormilyUploadProps<FileUploadInlineProps>;
 /**
  * Formily-connected FileUploadInline component
  * Automatically connects shadcn FileUploadInline to Formily field state
  */
-declare const FileUploadInline$1: React.ForwardRefExoticComponent<(Omit<Partial<_pixpilot_shadcn_ui3.FileUploadInlineBaseProps & _pixpilot_shadcn_ui3.FileUploadRootPropsBaseProps & {
-  multiple: true;
-  value?: _pixpilot_shadcn_ui3.FileMetadata[];
-  onChange?: _pixpilot_shadcn_ui3.OnChangeMultipleFiles;
-} & _pixpilot_shadcn_ui3.FileUploadBaseProps & _pixpilot_shadcn_ui3.MultiFileCallbacks>, "ref"> | Omit<Partial<_pixpilot_shadcn_ui3.FileUploadInlineBaseProps & _pixpilot_shadcn_ui3.FileUploadRootPropsBaseProps & {
-  multiple?: false;
-  value?: _pixpilot_shadcn_ui3.FileMetadata | null;
-  onChange?: _pixpilot_shadcn_ui3.OnChangeSingleFile;
-} & _pixpilot_shadcn_ui3.FileUploadBaseProps & _pixpilot_shadcn_ui3.UseFileCallbacks>, "ref">) & React.RefAttributes<unknown>>;
+declare const FileUploadInline$1: React.FC<FileUploadInlineProps$1>;
 //#endregion
-export { FileUploadInline$1 as FileUploadInline };
+export { FileUploadInline$1 as FileUploadInline, FileUploadInlineProps$1 as FileUploadInlineProps };

package/dist/components/file-upload/FileUploadInline.js

@@ -7,9 +7,10 @@ import { jsx } from "react/jsx-runtime";
 
 //#region src/components/file-upload/FileUploadInline.tsx
 const BaseFileUploadInline = (props) => {
-	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = useFileUploadFeedback(props);
+	const { mapValue: _mapValue,...uploadProps } = props;
+	const { onUpload, maxSize, handleFilesRejection, handleFileValidate } = useFileUploadFeedback(uploadProps);
 	return /* @__PURE__ */ jsx(FileUploadInline, {
-		...props,
+		...uploadProps,
 		maxSize,
 		onFilesReject: handleFilesRejection,
 		onFileValidate: handleFileValidate,

package/dist/components/file-upload/index.d.cts

@@ -1,3 +1,3 @@
-import { AvatarUpload } from "./AvatarUpload.cjs";
-import { FileUpload } from "./FileUpload.cjs";
-import { FileUploadInline } from "./FileUploadInline.cjs";
+import { AvatarUpload, AvatarUploadProps as AvatarUploadProps$1 } from "./AvatarUpload.cjs";
+import { FileUpload, FileUploadProps as FileUploadProps$1 } from "./FileUpload.cjs";
+import { FileUploadInline, FileUploadInlineProps as FileUploadInlineProps$1 } from "./FileUploadInline.cjs";

package/dist/components/file-upload/index.d.ts

@@ -1,4 +1,4 @@
-import { AvatarUpload as AvatarUpload$1 } from "./AvatarUpload.js";
-import { FileUpload as FileUpload$1 } from "./FileUpload.js";
-import { FileUploadInline as FileUploadInline$1 } from "./FileUploadInline.js";
+import { AvatarUpload as AvatarUpload$1, AvatarUploadProps as AvatarUploadProps$1 } from "./AvatarUpload.js";
+import { FileUpload as FileUpload$1, FileUploadProps as FileUploadProps$1 } from "./FileUpload.js";
+import { FileUploadInline as FileUploadInline$1, FileUploadInlineProps as FileUploadInlineProps$1 } from "./FileUploadInline.js";
 import "@pixpilot/shadcn-ui";

package/dist/components/file-upload/map-upload-props.cjs

@@ -5,39 +5,57 @@
 *
 * - Forwards `field.value` (defaulting to `null`) as the `value` prop so the
 *   component displays the currently stored file metadata.
-* - Sets `onChange` to `undefined` to prevent Formily's default wiring from
-*   calling `field.setValue()` the moment a file is selected (i.e. before the
-*   upload completes).
-* - Wraps `onSuccess` so that `field.setValue(fileMeta)` is called only after a
-*   successful upload, followed by the original `onSuccess` callback if one was
-*   supplied.
-* - Wraps `onError` so that `field.setFeedback({ type: 'error', … })` is set on
-*   upload failure, followed by the original `onError` callback if one was
-*   supplied.
+* - Applies `mapValue` to the field value before forwarding it so callers can
+*   derive a display-ready file object without mutating the stored form value.
+* - Provides a guarded `onChange` that only writes to the field on deletions
+*   (value becomes `null` for single-file, or the array shrinks for
+*   multi-file).  New-file accepts fire `onChange` before the upload
+*   completes with incomplete metadata (no `url`), so those calls are
+*   intentionally ignored here — `onFileSuccess` handles the final write
+*   once the upload finishes.
+* - Wraps `onFileSuccess` so that `field.setValue(fileMeta)` is called only
+*   after a successful upload, followed by the original `onFileSuccess`
+*   callback if one was supplied. When the field value is an array (multiple
+*   mode), the new file is appended to the existing array rather than
+*   replacing it.
+* - Wraps `onFileError` so that `field.setFeedback({ type: 'error', … })` is
+*   set on upload failure, followed by the original `onFileError` callback if
+*   one was supplied.
 *
 * The generic `P extends object` constraint keeps the return type identical to
 * the input type so that the mapper satisfies Formily's `IStateMapper<T>`.
 * Internally the props are cast to `UploadFieldCallbacks` to access the
-* upload-specific callbacks; the multiple-file variant of `FileUploadProps`
-* uses `onFileSuccess`/`onFileError` instead, which are simply left untouched
-* because this function only overrides `onSuccess` and `onError`.
+* upload-specific callbacks; both single-file and multiple-file modes share
+* the same `onFileSuccess`/`onFileError` callbacks that fire per file.
 */
-function mapUploadProps(props, field) {
-	const { onSuccess, onError } = props;
+function mapUploadProps(props, field, options) {
+	const { onFileSuccess, onFileError, mapValue,...restProps } = props;
+	const isSingle = options?.forceSingle === true || props.multiple === false;
+	const baseValue = field.value ?? null;
+	const value = mapValue ? mapValue(baseValue) : baseValue;
 	return {
-		...props,
-		value: field.value ?? null,
-		onChange: void 0,
-		onSuccess: (fileMeta) => {
-			field.setValue(fileMeta);
-			onSuccess?.(fileMeta);
+		...restProps,
+		value,
+		onChange: (newValue) => {
+			if (newValue === null) field.setValue(null);
+			else if (Array.isArray(newValue)) {
+				const currentLen = (field.value ?? []).length;
+				if (newValue.length <= currentLen) field.setValue(newValue);
+			}
 		},
-		onError: (file, error) => {
+		onFileSuccess: (fileMeta) => {
+			if (!isSingle) {
+				const current = field.value ?? [];
+				field.setValue([...current, fileMeta]);
+			} else field.setValue(fileMeta);
+			onFileSuccess?.(fileMeta);
+		},
+		onFileError: (file, error) => {
 			field.setFeedback({
 				type: "error",
 				messages: [error]
 			});
-			onError?.(file, error);
+			onFileError?.(file, error);
 		}
 	};
 }

package/dist/components/file-upload/map-upload-props.d.cts

@@ -0,0 +1,16 @@
+import "@formily/core";
+import { FileMetadata } from "@pixpilot/shadcn-ui";
+
+//#region src/components/file-upload/map-upload-props.d.ts
+type SingleFileUploadValue = FileMetadata | null;
+type ExtractSingleFileValue<P> = P extends {
+  value?: infer TValue;
+} ? Extract<TValue, SingleFileUploadValue> extends never ? SingleFileUploadValue : Extract<TValue, SingleFileUploadValue> : SingleFileUploadValue;
+interface UploadValueMapper<TValue$1 extends SingleFileUploadValue = SingleFileUploadValue> {
+  mapValue?: (value: TValue$1) => TValue$1;
+}
+type FormilyUploadProps<P> = P extends {
+  multiple: true;
+} ? P : P & UploadValueMapper<ExtractSingleFileValue<P>>;
+//#endregion
+export { FormilyUploadProps, UploadValueMapper };

package/dist/components/file-upload/map-upload-props.d.ts

@@ -0,0 +1,16 @@
+import { FileMetadata } from "@pixpilot/shadcn-ui";
+import "@formily/core";
+
+//#region src/components/file-upload/map-upload-props.d.ts
+type SingleFileUploadValue = FileMetadata | null;
+type ExtractSingleFileValue<P> = P extends {
+  value?: infer TValue;
+} ? Extract<TValue, SingleFileUploadValue> extends never ? SingleFileUploadValue : Extract<TValue, SingleFileUploadValue> : SingleFileUploadValue;
+interface UploadValueMapper<TValue$1 extends SingleFileUploadValue = SingleFileUploadValue> {
+  mapValue?: (value: TValue$1) => TValue$1;
+}
+type FormilyUploadProps<P> = P extends {
+  multiple: true;
+} ? P : P & UploadValueMapper<ExtractSingleFileValue<P>>;
+//#endregion
+export { FormilyUploadProps, UploadValueMapper };

package/dist/components/file-upload/map-upload-props.js

@@ -4,39 +4,57 @@
 *
 * - Forwards `field.value` (defaulting to `null`) as the `value` prop so the
 *   component displays the currently stored file metadata.
-* - Sets `onChange` to `undefined` to prevent Formily's default wiring from
-*   calling `field.setValue()` the moment a file is selected (i.e. before the
-*   upload completes).
-* - Wraps `onSuccess` so that `field.setValue(fileMeta)` is called only after a
-*   successful upload, followed by the original `onSuccess` callback if one was
-*   supplied.
-* - Wraps `onError` so that `field.setFeedback({ type: 'error', … })` is set on
-*   upload failure, followed by the original `onError` callback if one was
-*   supplied.
+* - Applies `mapValue` to the field value before forwarding it so callers can
+*   derive a display-ready file object without mutating the stored form value.
+* - Provides a guarded `onChange` that only writes to the field on deletions
+*   (value becomes `null` for single-file, or the array shrinks for
+*   multi-file).  New-file accepts fire `onChange` before the upload
+*   completes with incomplete metadata (no `url`), so those calls are
+*   intentionally ignored here — `onFileSuccess` handles the final write
+*   once the upload finishes.
+* - Wraps `onFileSuccess` so that `field.setValue(fileMeta)` is called only
+*   after a successful upload, followed by the original `onFileSuccess`
+*   callback if one was supplied. When the field value is an array (multiple
+*   mode), the new file is appended to the existing array rather than
+*   replacing it.
+* - Wraps `onFileError` so that `field.setFeedback({ type: 'error', … })` is
+*   set on upload failure, followed by the original `onFileError` callback if
+*   one was supplied.
 *
 * The generic `P extends object` constraint keeps the return type identical to
 * the input type so that the mapper satisfies Formily's `IStateMapper<T>`.
 * Internally the props are cast to `UploadFieldCallbacks` to access the
-* upload-specific callbacks; the multiple-file variant of `FileUploadProps`
-* uses `onFileSuccess`/`onFileError` instead, which are simply left untouched
-* because this function only overrides `onSuccess` and `onError`.
+* upload-specific callbacks; both single-file and multiple-file modes share
+* the same `onFileSuccess`/`onFileError` callbacks that fire per file.
 */
-function mapUploadProps(props, field) {
-	const { onSuccess, onError } = props;
+function mapUploadProps(props, field, options) {
+	const { onFileSuccess, onFileError, mapValue,...restProps } = props;
+	const isSingle = options?.forceSingle === true || props.multiple === false;
+	const baseValue = field.value ?? null;
+	const value = mapValue ? mapValue(baseValue) : baseValue;
 	return {
-		...props,
-		value: field.value ?? null,
-		onChange: void 0,
-		onSuccess: (fileMeta) => {
-			field.setValue(fileMeta);
-			onSuccess?.(fileMeta);
+		...restProps,
+		value,
+		onChange: (newValue) => {
+			if (newValue === null) field.setValue(null);
+			else if (Array.isArray(newValue)) {
+				const currentLen = (field.value ?? []).length;
+				if (newValue.length <= currentLen) field.setValue(newValue);
+			}
 		},
-		onError: (file, error) => {
+		onFileSuccess: (fileMeta) => {
+			if (!isSingle) {
+				const current = field.value ?? [];
+				field.setValue([...current, fileMeta]);
+			} else field.setValue(fileMeta);
+			onFileSuccess?.(fileMeta);
+		},
+		onFileError: (file, error) => {
 			field.setFeedback({
 				type: "error",
 				messages: [error]
 			});
-			onError?.(file, error);
+			onFileError?.(file, error);
 		}
 	};
 }

package/dist/components/form-item/ConnectedFormItem.d.cts

@@ -1,13 +1,13 @@
 import { FormItemProps } from "./form-item-types.cjs";
-import * as react1924 from "react";
+import * as react1891 from "react";
 
 //#region src/components/form-item/ConnectedFormItem.d.ts
 /**
  * FormItem component connected to Formily field state.
  * Automatically maps field validation state to component props.
  */
-declare const FormItem: react1924.ForwardRefExoticComponent<Omit<Partial<FormItemProps & {
-  children?: react1924.ReactNode | undefined;
-}>, "ref"> & react1924.RefAttributes<unknown>>;
+declare const FormItem: react1891.ForwardRefExoticComponent<Omit<Partial<FormItemProps & {
+  children?: react1891.ReactNode | undefined;
+}>, "ref"> & react1891.RefAttributes<unknown>>;
 //#endregion
 export { FormItem };

package/dist/components/form-item/ConnectedFormItem.d.ts

@@ -1,13 +1,13 @@
 import { FormItemProps } from "./form-item-types.js";
-import * as react1924 from "react";
+import * as react1891 from "react";
 
 //#region src/components/form-item/ConnectedFormItem.d.ts
 /**
  * FormItem component connected to Formily field state.
  * Automatically maps field validation state to component props.
  */
-declare const FormItem: react1924.ForwardRefExoticComponent<Omit<Partial<FormItemProps & {
-  children?: react1924.ReactNode | undefined;
-}>, "ref"> & react1924.RefAttributes<unknown>>;
+declare const FormItem: react1891.ForwardRefExoticComponent<Omit<Partial<FormItemProps & {
+  children?: react1891.ReactNode | undefined;
+}>, "ref"> & react1891.RefAttributes<unknown>>;
 //#endregion
 export { FormItem };