@pixpilot/formily-shadcn 1.10.7 → 1.10.8

package/dist/components/Checkbox.d.ts

@@ -1,4 +1,4 @@
-import * as react1 from "react";
+import * as react0 from "react";
 import * as _radix_ui_react_checkbox0 from "@radix-ui/react-checkbox";
 
 //#region src/components/Checkbox.d.ts
@@ -6,6 +6,6 @@ import * as _radix_ui_react_checkbox0 from "@radix-ui/react-checkbox";
  * Formily-connected Checkbox component
  * Maps Formily field checked state to shadcn Checkbox
  */
-declare const Checkbox: react1.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_checkbox0.CheckboxProps & react1.RefAttributes<HTMLButtonElement>>, "ref"> & react1.RefAttributes<unknown>>;
+declare const Checkbox: react0.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_checkbox0.CheckboxProps & react0.RefAttributes<HTMLButtonElement>>, "ref"> & react0.RefAttributes<unknown>>;
 //#endregion
 export { Checkbox };

package/dist/components/DatePicker.d.ts

@@ -1,11 +1,11 @@
-import * as react4 from "react";
+import * as react2 from "react";
 import { DatePickerProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/DatePicker.d.ts
-declare const DatePicker$1: react4.ForwardRefExoticComponent<Partial<{
+declare const DatePicker$1: react2.ForwardRefExoticComponent<Partial<{
   value?: Date;
   onChange?: (date: Date | undefined) => void;
   placeholder?: string;
-} & Omit<DatePickerProps, "onSelect" | "selected" | "mode">> & react4.RefAttributes<unknown>>;
+} & Omit<DatePickerProps, "onSelect" | "selected" | "mode">> & react2.RefAttributes<unknown>>;
 //#endregion
 export { DatePicker$1 as DatePicker };

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

@@ -1,4 +1,4 @@
-import * as react0 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$1: react0.ForwardRefExoticComponent<Partial<Omit<IconPickerProps, "providers"> & {
+declare const IconPicker$1: react4.ForwardRefExoticComponent<Partial<Omit<IconPickerProps, "providers"> & {
   providers?: IconProviderProps[];
-}> & react0.RefAttributes<unknown>>;
+}> & react4.RefAttributes<unknown>>;
 //#endregion
 export { IconPicker$1 as 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_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime2 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_runtime3.JSX.Element;
+declare function Radio(props: RadioProps): react_jsx_runtime2.JSX.Element;
 declare namespace Radio {
   var displayName: string;
 }

package/dist/components/Rating.d.ts

@@ -1,4 +1,4 @@
-import * as react13 from "react";
+import * as react16 from "react";
 import * as _pixpilot_shadcn_ui0 from "@pixpilot/shadcn-ui";
 
 //#region src/components/Rating.d.ts
@@ -6,8 +6,8 @@ import * as _pixpilot_shadcn_ui0 from "@pixpilot/shadcn-ui";
  * Formily-connected Rating component
  * Automatically connects shadcn-ui Rating to Formily field state
  */
-declare const Rating$1: react13.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui0.RatingProps & {
-  children?: react13.ReactNode | undefined;
-}> & react13.RefAttributes<unknown>>;
+declare const Rating$1: react16.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui0.RatingProps & {
+  children?: react16.ReactNode | undefined;
+}> & react16.RefAttributes<unknown>>;
 //#endregion
 export { Rating$1 as Rating };

package/dist/components/Row.d.cts

@@ -1,5 +1,5 @@
 import React from "react";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime4 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_runtime4.JSX.Element;
 //#endregion
 export { Row };

package/dist/components/Row.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime3 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_runtime2.JSX.Element;
+}: IRowProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 export { Row };

package/dist/components/Separator.d.ts

@@ -1,4 +1,4 @@
-import * as react19 from "react";
+import * as react13 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: react19.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_separator0.SeparatorProps & react19.RefAttributes<HTMLDivElement>>, "ref"> & react19.RefAttributes<unknown>>;
+declare const Separator: react13.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_separator0.SeparatorProps & react13.RefAttributes<HTMLDivElement>>, "ref"> & react13.RefAttributes<unknown>>;
 //#endregion
 export { Separator };

package/dist/components/Switch.d.ts

@@ -1,4 +1,4 @@
-import * as react16 from "react";
+import * as react21 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: react16.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_switch0.SwitchProps & react16.RefAttributes<HTMLButtonElement>>, "ref"> & react16.RefAttributes<unknown>>;
+declare const Switch: react21.ForwardRefExoticComponent<Omit<Partial<_radix_ui_react_switch0.SwitchProps & react21.RefAttributes<HTMLButtonElement>>, "ref"> & react21.RefAttributes<unknown>>;
 //#endregion
 export { Switch };

package/dist/components/TagsInputInline.d.cts

@@ -1,5 +1,5 @@
-import * as react22 from "react";
-import * as _pixpilot_shadcn_ui1 from "@pixpilot/shadcn-ui";
+import * as react25 from "react";
+import * as _pixpilot_shadcn_ui2 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: react25.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui2.TagsInputProps> & react25.RefAttributes<unknown>>;
 //#endregion
 export { TagsInputInLine };

package/dist/components/TagsInputInline.d.ts

@@ -1,4 +1,4 @@
-import * as react26 from "react";
+import * as react19 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: react26.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui1.TagsInputProps> & react26.RefAttributes<unknown>>;
+declare const TagsInputInLine: react19.ForwardRefExoticComponent<Partial<_pixpilot_shadcn_ui1.TagsInputProps> & react19.RefAttributes<unknown>>;
 //#endregion
 export { TagsInputInLine };

package/dist/components/Textarea.d.cts

@@ -1,9 +1,9 @@
-import * as react24 from "react";
+import * as react27 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: react27.ForwardRefExoticComponent<Omit<Partial<react27.ClassAttributes<HTMLTextAreaElement> & react27.TextareaHTMLAttributes<HTMLTextAreaElement>>, "ref"> & react27.RefAttributes<unknown>>;
 //#endregion
 export { Textarea };

package/dist/components/Textarea.d.ts

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

package/dist/components/ToggleButton.d.cts

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

package/dist/components/ToggleButton.d.ts

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

package/dist/components/array-tags/ArrayTags.d.cts

@@ -1,4 +1,4 @@
-import * as _formily_react102 from "@formily/react";
+import * as _formily_react0 from "@formily/react";
 import React from "react";
 import { TagsInputProps } from "@pixpilot/shadcn-ui";
 
@@ -54,6 +54,6 @@ interface ArrayTagsProps extends TagsInputProps {
  * };
  * ```
  */
-declare const ArrayTags: React.MemoExoticComponent<_formily_react102.ReactFC<ArrayTagsProps>>;
+declare const ArrayTags: React.MemoExoticComponent<_formily_react0.ReactFC<ArrayTagsProps>>;
 //#endregion
 export { ArrayTags, ArrayTagsProps };

package/dist/components/context/types.d.cts

@@ -2,7 +2,9 @@ import { ActionItem } from "../array-base/types.cjs";
 import "../array-base/index.cjs";
 import { FormSpace } from "../../types/form.cjs";
 import { DescriptionPlacement, LabelPlacement } from "../../types/form-item.cjs";
-import { DialogContentProps, FormFileUploadOptions, IconProvider, PopoverContentProps, RichTextEditorProps } from "@pixpilot/shadcn-ui";
+import { FormFileUploadOptions } from "../file-upload/types.cjs";
+import "../file-upload/index.cjs";
+import { DialogContentProps, IconProvider, PopoverContentProps, RichTextEditorProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/context/types.d.ts
 interface FomFileUpload {

package/dist/components/context/types.d.ts

@@ -2,7 +2,9 @@ import { ActionItem } from "../array-base/types.js";
 import "../array-base/index.js";
 import { FormSpace } from "../../types/form.js";
 import { DescriptionPlacement, LabelPlacement } from "../../types/form-item.js";
-import { DialogContentProps, FormFileUploadOptions, IconProvider, PopoverContentProps, RichTextEditorProps } from "@pixpilot/shadcn-ui";
+import { FormFileUploadOptions } from "../file-upload/types.js";
+import "../file-upload/index.js";
+import { DialogContentProps, IconProvider, PopoverContentProps, RichTextEditorProps } from "@pixpilot/shadcn-ui";
 
 //#region src/components/context/types.d.ts
 interface FomFileUpload {

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

@@ -1,3 +1,5 @@
+const require_map_upload_props = require('./map-upload-props.cjs');
+const require_use_file_upload_feedback = require('./use-file-upload-feedback.cjs');
 const require_AvatarUpload = require('./AvatarUpload.cjs');
 const require_FileUpload = require('./FileUpload.cjs');
 const require_FileUploadInline = require('./FileUploadInline.cjs');

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

@@ -1,3 +1,6 @@
-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";
+import { FormilyUploadProps, UploadFieldCallbacks, UploadValueMapper, mapUploadProps } from "./map-upload-props.cjs";
+import { AvatarUpload, AvatarUploadProps } from "./AvatarUpload.cjs";
+import { FileUpload, FileUploadProps } from "./FileUpload.cjs";
+import { FileUploadInline, FileUploadInlineProps } from "./FileUploadInline.cjs";
+import { FormFileUploadOptions } from "./types.cjs";
+import { useFileUploadFeedback } from "./use-file-upload-feedback.cjs";

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

@@ -1,4 +1,6 @@
-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";
+import { FormilyUploadProps, UploadFieldCallbacks, UploadValueMapper, mapUploadProps } from "./map-upload-props.js";
+import { AvatarUpload, AvatarUploadProps } from "./AvatarUpload.js";
+import { FileUpload, FileUploadProps } from "./FileUpload.js";
+import { FileUploadInline, FileUploadInlineProps } from "./FileUploadInline.js";
+import { FormFileUploadOptions } from "./types.js";
+import { useFileUploadFeedback } from "./use-file-upload-feedback.js";

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

@@ -1,3 +1,5 @@
+import { mapUploadProps } from "./map-upload-props.js";
+import { useFileUploadFeedback } from "./use-file-upload-feedback.js";
 import { AvatarUpload } from "./AvatarUpload.js";
 import { FileUpload } from "./FileUpload.js";
 import { FileUploadInline } from "./FileUploadInline.js";

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

@@ -1,4 +1,4 @@
-import "@formily/core";
+import { Field } from "@formily/core";
 import { FileMetadata } from "@pixpilot/shadcn-ui";
 
 //#region src/components/file-upload/map-upload-props.d.ts
@@ -12,5 +12,46 @@ interface UploadValueMapper<TValue$1 extends SingleFileUploadValue = SingleFileU
 type FormilyUploadProps<P> = P extends {
   multiple: true;
 } ? P : P & UploadValueMapper<ExtractSingleFileValue<P>>;
+/**
+ * Callbacks that the shadcn upload components expose at the single-file level.
+ * `FileUploadProps`, `AvatarUploadProps` and `FileUploadInlineProps` all carry
+ * these when used in single-file mode.
+ */
+interface UploadFieldCallbacks<TValue$1 extends SingleFileUploadValue = SingleFileUploadValue> extends UploadValueMapper<TValue$1> {
+  onFileSuccess?: (fileMeta: FileMetadata) => void;
+  onFileError?: (file: File, error: string) => void;
+}
+interface MapUploadPropsOptions {
+  forceSingle?: boolean;
+}
+/**
+ * Shared `mapProps` mapper for all Formily-connected upload components.
+ *
+ * - 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.
+ * - 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; both single-file and multiple-file modes share
+ * the same `onFileSuccess`/`onFileError` callbacks that fire per file.
+ */
+declare function mapUploadProps<P extends object>(props: P, field: Field, options?: MapUploadPropsOptions): P;
 //#endregion
-export { FormilyUploadProps, UploadValueMapper };
+export { FormilyUploadProps, UploadFieldCallbacks, UploadValueMapper, mapUploadProps };

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

@@ -1,5 +1,5 @@
 import { FileMetadata } from "@pixpilot/shadcn-ui";
-import "@formily/core";
+import { Field } from "@formily/core";
 
 //#region src/components/file-upload/map-upload-props.d.ts
 type SingleFileUploadValue = FileMetadata | null;
@@ -12,5 +12,46 @@ interface UploadValueMapper<TValue$1 extends SingleFileUploadValue = SingleFileU
 type FormilyUploadProps<P> = P extends {
   multiple: true;
 } ? P : P & UploadValueMapper<ExtractSingleFileValue<P>>;
+/**
+ * Callbacks that the shadcn upload components expose at the single-file level.
+ * `FileUploadProps`, `AvatarUploadProps` and `FileUploadInlineProps` all carry
+ * these when used in single-file mode.
+ */
+interface UploadFieldCallbacks<TValue$1 extends SingleFileUploadValue = SingleFileUploadValue> extends UploadValueMapper<TValue$1> {
+  onFileSuccess?: (fileMeta: FileMetadata) => void;
+  onFileError?: (file: File, error: string) => void;
+}
+interface MapUploadPropsOptions {
+  forceSingle?: boolean;
+}
+/**
+ * Shared `mapProps` mapper for all Formily-connected upload components.
+ *
+ * - 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.
+ * - 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; both single-file and multiple-file modes share
+ * the same `onFileSuccess`/`onFileError` callbacks that fire per file.
+ */
+declare function mapUploadProps<P extends object>(props: P, field: Field, options?: MapUploadPropsOptions): P;
 //#endregion
-export { FormilyUploadProps, UploadValueMapper };
+export { FormilyUploadProps, UploadFieldCallbacks, UploadValueMapper, mapUploadProps };

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

@@ -0,0 +1,9 @@
+import { FileUploadProgressCallBacks } from "@pixpilot/shadcn-ui";
+
+//#region src/components/file-upload/types.d.ts
+interface FormFileUploadOptions extends FileUploadProgressCallBacks {
+  component: string;
+  componentProps: Record<string, any>;
+}
+//#endregion
+export { FormFileUploadOptions };

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

@@ -0,0 +1,9 @@
+import { FileUploadProgressCallBacks } from "@pixpilot/shadcn-ui";
+
+//#region src/components/file-upload/types.d.ts
+interface FormFileUploadOptions extends FileUploadProgressCallBacks {
+  component: string;
+  componentProps: Record<string, any>;
+}
+//#endregion
+export { FormFileUploadOptions };

package/dist/components/file-upload/use-file-upload-feedback.d.cts

@@ -0,0 +1,14 @@
+import { FileUploadBaseProps } from "@pixpilot/shadcn-ui";
+
+//#region src/components/file-upload/use-file-upload-feedback.d.ts
+declare function useFileUploadFeedback(props: FileUploadBaseProps): {
+  onUpload: ((...args: any[]) => any) | undefined;
+  maxSize: number | undefined;
+  handleFilesRejection: (files: Array<{
+    file: File;
+    message: string;
+  }>) => void;
+  handleFileValidate: (file: File) => string | null | undefined;
+};
+//#endregion
+export { useFileUploadFeedback };

package/dist/components/file-upload/use-file-upload-feedback.d.ts

@@ -0,0 +1,14 @@
+import { FileUploadBaseProps } from "@pixpilot/shadcn-ui";
+
+//#region src/components/file-upload/use-file-upload-feedback.d.ts
+declare function useFileUploadFeedback(props: FileUploadBaseProps): {
+  onUpload: ((...args: any[]) => any) | undefined;
+  maxSize: number | undefined;
+  handleFilesRejection: (files: Array<{
+    file: File;
+    message: string;
+  }>) => void;
+  handleFileValidate: (file: File) => string | null | undefined;
+};
+//#endregion
+export { useFileUploadFeedback };

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

@@ -1,13 +1,13 @@
 import { FormItemProps } from "./form-item-types.cjs";
-import * as react1889 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: react1889.ForwardRefExoticComponent<Omit<Partial<FormItemProps & {
-  children?: react1889.ReactNode | undefined;
-}>, "ref"> & react1889.RefAttributes<unknown>>;
+declare const FormItem: react1891.ForwardRefExoticComponent<Omit<Partial<FormItemProps & {
+  children?: react1891.ReactNode | undefined;
+}>, "ref"> & react1891.RefAttributes<unknown>>;
 //#endregion
 export { FormItem };

package/dist/components/number/NumberInput.d.cts

@@ -1,15 +1,15 @@
-import * as react33 from "react";
+import * as react31 from "react";
 
 //#region src/components/number/NumberInput.d.ts
 /**
  * Formily-connected Number Input component
  */
-declare const NumberInput: react33.ForwardRefExoticComponent<Omit<Partial<react33.ClassAttributes<HTMLInputElement> & react33.InputHTMLAttributes<HTMLInputElement> & {
+declare const NumberInput: react31.ForwardRefExoticComponent<Omit<Partial<react31.ClassAttributes<HTMLInputElement> & react31.InputHTMLAttributes<HTMLInputElement> & {
   prefix?: React.ReactNode;
   suffix?: React.ReactNode;
   groupClassName?: string;
   prefixClassName?: string;
   suffixClassName?: string;
-}>, "ref"> & react33.RefAttributes<unknown>>;
+}>, "ref"> & react31.RefAttributes<unknown>>;
 //#endregion
 export { NumberInput };