Core concepts

type MediaDropFile = {
	id: string; // generated, not the browser File's name
	file: File; // the original browser File
	name: string;
	size: number;
	type: string;
	lastModified?: number;
	status: "idle" | "accepted" | "rejected";
	errors: MediaDropError[]; // always an array, even when empty

	// Upload fields, only ever set once an upload is requested for this file:
	uploadStatus?: "queued" | "uploading" | "done" | "error" | "canceled";
	progress?: { loaded: number; total: number | null };
	uploadError?: MediaDropError; // present after a failed/canceled attempt
	uploadResult?: unknown; // whatever the transport resolved with
	uploadAttempts?: number;
};

engine.getState(); // { files: MediaDropFile[] }
engine.subscribe(listener); // full-state subscription
engine.subscribe(selector, listener); // fires only when selector's result changes

type DragState = {
	isDragActive: boolean; // a drag payload is over this dropzone right now
	isDragAccept: boolean; // best-effort: payload looks acceptable
	isDragReject: boolean; // best-effort: payload looks unacceptable
};