Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
import { useCallback, useRef, useState } from "react";
import { acceptedAttachmentKind } from "@/hooks/useAttachedImages";
/** Extract supported attachment ``File``s from a paste / drop event.
*
* Deliberate behaviour:
* - Only items whose ``kind === "file"`` and match the Composer whitelist
* are returned; HTML fragments are ignored (defending against remote URL
* fetch + XSS surfaces).
* - Plain text pasted alongside attachments is *not* consumed by this helper,
* so the caller can still let the textarea receive it naturally.
*/
function extractImageFilesFromPaste(
event: ClipboardEvent | React.ClipboardEvent,
): File[] {
const clipboard = (event as ClipboardEvent).clipboardData
?? (event as React.ClipboardEvent).clipboardData;
if (!clipboard) return [];
const files: File[] = [];
for (const item of Array.from(clipboard.items)) {
if (item.kind !== "file") continue;
const file = item.getAsFile();
if (file && acceptedAttachmentKind(file)) files.push(file);
}
return files;
}
function extractImageFilesFromDrop(
event: DragEvent | React.DragEvent,
): File[] {
const dt = (event as DragEvent).dataTransfer
?? (event as React.DragEvent).dataTransfer;
if (!dt) return [];
const files: File[] = [];
for (const item of Array.from(dt.files)) {
if (acceptedAttachmentKind(item)) files.push(item);
}
return files;
}
export interface UseClipboardAndDropApi {
isDragging: boolean;
onPaste: (
event: React.ClipboardEvent,
) => void;
onDragEnter: (event: React.DragEvent) => void;
onDragOver: (event: React.DragEvent) => void;
onDragLeave: (event: React.DragEvent) => void;
onDrop: (event: React.DragEvent) => void;
}
/** Wire paste + drag-and-drop to a callback.
*
* The hook owns ``isDragging`` state and the refcount that keeps it accurate
* across nested ``dragenter`` / ``dragleave`` events (a known DOM gotcha: the
* text cursor inside a textarea fires ``dragleave`` on entry, flicking the
* highlight off otherwise). */
export function useClipboardAndDrop(
onImageFiles: (files: File[]) => void,
): UseClipboardAndDropApi {
const [isDragging, setIsDragging] = useState(false);
const dragDepth = useRef(0);
const onPaste = useCallback(
(event: React.ClipboardEvent) => {
const files = extractImageFilesFromPaste(event);
if (files.length === 0) return;
// Consume only when an attachment is actually present; plain-text paste
// still reaches the textarea unmolested.
event.preventDefault();
onImageFiles(files);
},
[onImageFiles],
);
const onDragEnter = useCallback((event: React.DragEvent) => {
if (!Array.from(event.dataTransfer.types ?? []).includes("Files")) return;
event.preventDefault();
dragDepth.current += 1;
setIsDragging(true);
}, []);
const onDragOver = useCallback((event: React.DragEvent) => {
if (!Array.from(event.dataTransfer.types ?? []).includes("Files")) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
}, []);
const onDragLeave = useCallback((event: React.DragEvent) => {
if (!Array.from(event.dataTransfer.types ?? []).includes("Files")) return;
event.preventDefault();
dragDepth.current = Math.max(0, dragDepth.current - 1);
if (dragDepth.current === 0) setIsDragging(false);
}, []);
const onDrop = useCallback(
(event: React.DragEvent) => {
dragDepth.current = 0;
setIsDragging(false);
const files = extractImageFilesFromDrop(event);
if (files.length === 0) return;
event.preventDefault();
onImageFiles(files);
},
[onImageFiles],
);
return { isDragging, onPaste, onDragEnter, onDragOver, onDragLeave, onDrop };
}