/**
* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
*/
/**
* Domain payload built by the view layer from a `ClipboardEvent` or `DragEvent`. Keeps DOM
* types inside the view; downstream code sees only data.
*/
export type AIChatInputPaste = {
	files: ReadonlyArray<File>;
	plainText: string;
	/**
	* `true` when the source `DataTransfer` carried at least one directory entry.
	*/
	hasDirectory: boolean;
	/**
	* Bypasses {@link AIChatPasteOptions#longTextThreshold}: any non-empty text attaches.
	* Used by drag-and-drop so dropped text isn't lost.
	*/
	forceTextAttachment: boolean;
	/**
	* Suppresses the textarea's default paste behaviour. Called by the controller when it
	* has fully handled the input (e.g. attached long pasted text as a file).
	*/
	preventDefault: () => void;
};
type AIChatPasteOptions = {
	/**
	* Localized label for the long-text attachment, without extension (e.g. `Pasted Text`).
	* Rendered as `<label>.txt` when the long-text branch fires.
	*/
	pastedTextLabel: string;
	/**
	* Minimum plain-text length (in characters) to trigger the long-text branch.
	*/
	longTextThreshold?: number;
	/**
	* Mirrors `ai.chat.context.files.enabled`. Gates the file, image, and long-text branches.
	*/
	filesEnabled: boolean;
	/**
	* Mirrors `ai.chat.context.urls.enabled`. Gates the URL branch.
	*/
	urlsEnabled: boolean;
};
/**
* Result returned by {@link resolvePaste}.
*
* Possible shapes:
* * `{ type: 'file', files }`: one or more files (multi-select clipboard paste).
* * `{ type: 'text', files }`: single-element array, serialized as text by the model.
* * `{ type: 'url', url }`: a URL to add to context.
*
* `null` means "no action" (plain text below threshold, no URL match, or files all unusable).
* The controller is responsible for suppressing the source event's default — `resolvePaste`
* itself is side-effect-free with respect to DOM events.
*/
type AIChatPasteResult = {
	type: "file" | "text";
	files: Array<File>;
} | {
	type: "url";
	url: string;
};
/**
* Runs the paste detection ladder, synthesizes the right `File`s (or extracts the URL), and
* returns the action the controller should dispatch, or `null` for "nothing to do". Pure with
* respect to DOM events — the controller decides whether to suppress the source default.
*/
export declare function resolvePaste(paste: AIChatInputPaste, options: AIChatPasteOptions): AIChatPasteResult | null;
export {};