@arcfusionz/arc-primitive-ui 0.2.15 → 0.2.17

package/dist/components/FileUpload/FileUpload.d.ts

@@ -37,20 +37,12 @@ declare function formatFileSize(bytes: number): string;
 interface FileUploadHandle {
   /** The currently selected files. */
   files: File[];
-  /** Number of selected files. */
-  fileCount: number;
   /** A file is being dragged over the dropzone. */
   isDragging: boolean;
   /** The upload is disabled. */
   disabled: boolean;
   /** The upload is marked invalid. */
   invalid: boolean;
-  /** Effective file cap (multiple mode only); `undefined` when unlimited or single. */
-  maxFiles?: number;
-  /** Slots left before `maxFiles`; `undefined` when there is no cap. */
-  remainingFiles?: number;
-  /** The selection has reached `maxFiles`. */
-  isAtMaxFiles: boolean;
   /** Open the native file picker. */
   open: () => void;
   /** Remove one file from the selection. */
@@ -105,7 +97,7 @@ interface FileUploadProps extends Omit<ComponentPropsWithoutRef<"div">, "classNa
   name?: string;
   /** Accessible name for the hidden file input. */
   inputLabel?: string;
-  /** Replace the rendered root `div` or inspect `{ dragging, disabled, invalid, empty }`. */
+  /** Replace the rendered root `div` or inspect `{ dragging, disabled, invalid, empty, atMax }`. */
   render?: useRender.RenderProp<FileUploadRenderState>;
   /** Compose the pieces: `FileUploadDropzone`, `FileUploadList`, `FileUploadTrigger`. */
   children?: ReactNode;
@@ -198,7 +190,7 @@ interface FileUploadItemProps extends Omit<ComponentPropsWithoutRef<"li">, "clas
   progress?: number;
   /** Detailed message shown while `status="error"`, in place of the size. */
   error?: ReactNode;
-  /** Short visible + announced status label. Defaults per `status` ("Uploading", "Uploaded", "Failed"); pass to override the copy. */
+  /** Short visible, accessible status label. Defaults per `status` ("Uploading", "Uploaded", "Failed"); pass to override the copy. This is not a live-region announcement. */
   statusLabel?: ReactNode;
   /** Show the remove button. Defaults to `true`. */
   removable?: boolean;
@@ -206,6 +198,12 @@ interface FileUploadItemProps extends Omit<ComponentPropsWithoutRef<"li">, "clas
   onRemove?: () => void;
   /** Accessible name for the remove button. Defaults to `Remove {file name}`. */
   removeLabel?: string;
+  /**
+   * Replace the leading visual completely. This compatibility escape hatch
+   * takes precedence over `previewSrc`; the consumer owns its presentation and
+   * accessibility. Prefer `previewSrc` when a standard thumbnail is sufficient.
+   */
+  preview?: ReactNode;
   /** URL of a preview image (e.g. a server-side thumbnail). The primitive owns the dimensions, radius, `object-fit`, decorative attributes, and drag prevention — you supply only the URL. Falls back to a file icon when omitted, non-image, or the image fails to load. */
   previewSrc?: string;
   /** Replace the entire row body. */

package/dist/components/FileUpload/FileUpload.js

@@ -58,13 +58,9 @@ function useFileUpload() {
 	const context = useFileUploadContext("useFileUpload");
 	return {
 		files: context.files,
-		fileCount: context.fileCount,
 		isDragging: context.isDragging,
 		disabled: context.disabled,
 		invalid: context.invalid,
-		maxFiles: context.maxFiles,
-		remainingFiles: context.remainingFiles,
-		isAtMaxFiles: context.isAtMaxFiles,
 		open: context.openPicker,
 		remove: context.removeFile,
 		clear: context.clear
@@ -430,7 +426,7 @@ const itemStatusColors = {
 * consumer-driven so the row reflects real upload state; the component shows
 * failures but does not itself retry.
 */
-const FileUploadItem = forwardRef(({ file, status = "idle", progress, error, statusLabel, removable = true, onRemove, removeLabel, previewSrc, children, className, ...rest }, ref) => {
+const FileUploadItem = forwardRef(({ file, status = "idle", progress, error, statusLabel, removable = true, onRemove, removeLabel, preview, previewSrc, children, className, ...rest }, ref) => {
 	const context = useFileUploadContext("FileUploadItem");
 	const handleRemove = onRemove ?? (() => context.removeFile(file));
 	const resolvedStatusLabel = statusLabel !== void 0 ? statusLabel : itemStatusLabels[status] || null;
@@ -443,7 +439,7 @@ const FileUploadItem = forwardRef(({ file, status = "idle", progress, error, sta
 		children: children ?? /* @__PURE__ */ jsxs(Fragment$1, { children: [
 			/* @__PURE__ */ jsx("span", {
 				className: "shrink-0",
-				children: /* @__PURE__ */ jsx(FileUploadThumbnail, {
+				children: preview ?? /* @__PURE__ */ jsx(FileUploadThumbnail, {
 					file,
 					src: previewSrc
 				})
@@ -500,9 +496,8 @@ const thumbnailImageClasses = "size-10 rounded-md object-cover";
 const thumbnailFallbackClasses = "flex size-10 items-center justify-center rounded-md bg-muted text-muted-foreground";
 function FileUploadThumbnail({ file, src }) {
 	const [autoUrl, setAutoUrl] = useState(null);
-	const [failed, setFailed] = useState(false);
+	const [failedSrc, setFailedSrc] = useState(null);
 	useEffect(() => {
-		setFailed(false);
 		if (src != null || !file.type.startsWith("image/") || !canUseObjectUrl()) {
 			setAutoUrl(null);
 			return;
@@ -512,13 +507,13 @@ function FileUploadThumbnail({ file, src }) {
 		return () => URL.revokeObjectURL(objectUrl);
 	}, [file, src]);
 	const resolvedSrc = src ?? autoUrl;
-	if (resolvedSrc != null && !failed) return /* @__PURE__ */ jsx("img", {
+	if (resolvedSrc != null && failedSrc !== resolvedSrc) return /* @__PURE__ */ jsx("img", {
 		src: resolvedSrc,
 		alt: "",
 		"aria-hidden": "true",
 		className: thumbnailImageClasses,
 		draggable: false,
-		onError: () => setFailed(true)
+		onError: () => setFailedSrc(resolvedSrc)
 	});
 	return /* @__PURE__ */ jsx("span", {
 		className: thumbnailFallbackClasses,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcfusionz/arc-primitive-ui",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "ArcFusion primitive UI components",
   "license": "MIT",
   "type": "module",