@pixpilot/formily-shadcn 1.8.0 → 1.9.0

package/dist/components/Form.d.ts

@@ -1,7 +1,7 @@
 import { FormContextStates } from "./context/form-context.js";
 import "./context/index.js";
 import React from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 import { Form } from "@formily/core";
 
 //#region src/components/Form.d.ts
@@ -25,6 +25,6 @@ declare function Form$1({
   onAutoSubmit,
   layout,
   settings
-}: IFormProps): react_jsx_runtime0.JSX.Element;
+}: IFormProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 export { Form$1 as Form };

package/dist/components/FormGrid.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/components/FormGrid.d.ts
 interface IFormGridProps extends React.HTMLAttributes<HTMLDivElement> {}
@@ -7,6 +7,6 @@ declare function FormGrid({
   className,
   children,
   ...rest
-}: IFormGridProps): react_jsx_runtime1.JSX.Element;
+}: IFormGridProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { FormGrid };

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/Radio.d.ts

@@ -1,5 +1,5 @@
 import { FC } from "react";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 import { RadioGroup } from "@pixpilot/shadcn";
 
 //#region src/components/Radio.d.ts
@@ -15,7 +15,7 @@ type RadioProps = {
 /**
  * Radio component with options rendering
  */
-declare function Radio(props: RadioProps): react_jsx_runtime2.JSX.Element;
+declare function Radio(props: RadioProps): react_jsx_runtime3.JSX.Element;
 declare namespace Radio {
   var displayName: string;
 }

package/dist/components/Row.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 
 //#region src/components/Row.d.ts
 interface IRowProps {
@@ -36,6 +36,6 @@ interface IRowProps {
 declare function Row({
   className,
   children
-}: IRowProps): react_jsx_runtime3.JSX.Element;
+}: IRowProps): react_jsx_runtime2.JSX.Element;
 //#endregion
 export { Row };

package/dist/components/Separator.d.ts

@@ -1,4 +1,4 @@
-import * as react16 from "react";
+import * as react19 from "react";
 import * as _radix_ui_react_separator0 from "@radix-ui/react-separator";
 
 //#region src/components/Separator.d.ts
@@ -6,6 +6,6 @@ import * as _radix_ui_react_separator0 from "@radix-ui/react-separator";
  * Formily-connected Separator component
  * A visual divider for content sections
  */
-declare const Separator: react16.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_separator0.SeparatorProps & react16.RefAttributes<HTMLDivElement>>, "ref"> & react16.RefAttributes<unknown>>;
+declare const Separator: react19.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_separator0.SeparatorProps & react19.RefAttributes<HTMLDivElement>>, "ref"> & react19.RefAttributes<unknown>>;
 //#endregion
 export { Separator };

package/dist/components/Switch.d.ts

@@ -1,4 +1,4 @@
-import * as react19 from "react";
+import * as react16 from "react";
 import * as _radix_ui_react_switch0 from "@radix-ui/react-switch";
 
 //#region src/components/Switch.d.ts
@@ -6,6 +6,6 @@ import * as _radix_ui_react_switch0 from "@radix-ui/react-switch";
  * Formily-connected Switch component
  * Toggle switch for boolean values
  */
-declare const Switch: react19.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_switch0.SwitchProps & react19.RefAttributes<HTMLButtonElement>>, "ref"> & react19.RefAttributes<unknown>>;
+declare const Switch: react16.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_switch0.SwitchProps & react16.RefAttributes<HTMLButtonElement>>, "ref"> & react16.RefAttributes<unknown>>;
 //#endregion
 export { Switch };

package/dist/components/TagsInputInline.d.ts

@@ -1,4 +1,4 @@
-import * as react22 from "react";
+import * as react26 from "react";
 import * as _pixpilot_shadcn_ui1 from "@pixpilot/shadcn-ui";
 
 //#region src/components/TagsInputInline.d.ts
@@ -10,6 +10,6 @@ import * as _pixpilot_shadcn_ui1 from "@pixpilot/shadcn-ui";
  * Based on DiceUI's tags-input for inline tag editing with keyboard navigation
  * and validation support.
  */
-declare const TagsInputInLine: react22.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui1.TagsInputProps> & react22.RefAttributes<unknown>>;
+declare const TagsInputInLine: react26.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui1.TagsInputProps> & react26.RefAttributes<unknown>>;
 //#endregion
 export { TagsInputInLine };

package/dist/components/Textarea.d.ts

@@ -1,9 +1,9 @@
-import * as react24 from "react";
+import * as react22 from "react";
 
 //#region src/components/Textarea.d.ts
 /**
  * Formily-connected Textarea component
  */
-declare const Textarea: react24.ForwardRefExoticComponent<Omit<Partial<react24.ClassAttributes<HTMLTextAreaElement> & react24.TextareaHTMLAttributes<HTMLTextAreaElement>>, "ref"> & react24.RefAttributes<unknown>>;
+declare const Textarea: react22.ForwardRefExoticComponent<Omit<Partial<react22.ClassAttributes<HTMLTextAreaElement> & react22.TextareaHTMLAttributes<HTMLTextAreaElement>>, "ref"> & react22.RefAttributes<unknown>>;
 //#endregion
 export { Textarea };

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,6 +5,8 @@
 *
 * - Forwards `field.value` (defaulting to `null`) as the `value` prop so the
 *   component displays the currently stored file metadata.
+* - Applies `mapValue` to the field value before forwarding it so callers can
+*   derive a display-ready file object without mutating the stored form value.
 * - 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).
@@ -23,10 +25,12 @@
 * because this function only overrides `onSuccess` and `onError`.
 */
 function mapUploadProps(props, field) {
-	const { onSuccess, onError } = props;
+	const { onSuccess, onError, mapValue,...restProps } = props;
+	const baseValue = field.value ?? null;
+	const value = mapValue ? mapValue(baseValue) : baseValue;
 	return {
-		...props,
-		value: field.value ?? null,
+		...restProps,
+		value,
 		onChange: void 0,
 		onSuccess: (fileMeta) => {
 			field.setValue(fileMeta);

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,6 +4,8 @@
 *
 * - Forwards `field.value` (defaulting to `null`) as the `value` prop so the
 *   component displays the currently stored file metadata.
+* - Applies `mapValue` to the field value before forwarding it so callers can
+*   derive a display-ready file object without mutating the stored form value.
 * - 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).
@@ -22,10 +24,12 @@
 * because this function only overrides `onSuccess` and `onError`.
 */
 function mapUploadProps(props, field) {
-	const { onSuccess, onError } = props;
+	const { onSuccess, onError, mapValue,...restProps } = props;
+	const baseValue = field.value ?? null;
+	const value = mapValue ? mapValue(baseValue) : baseValue;
 	return {
-		...props,
-		value: field.value ?? null,
+		...restProps,
+		value,
 		onChange: void 0,
 		onSuccess: (fileMeta) => {
 			field.setValue(fileMeta);

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 };