@ckeditor/ckeditor5-ai 48.8.1-alpha.3 → 49.0.0-alpha.0

package/dist/aichat/utils/promisequeue.d.ts

@@ -1,29 +1,30 @@
 /**
- * @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
- */
-declare const PromiseQueue_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Emitter;
-    prototype: import("@ckeditor/ckeditor5-utils").Emitter;
-};
-export declare class PromiseQueue extends PromiseQueue_base {
-    isProcessing: boolean;
-    /**
-     * Adds a task to the queue. An abort signal is provided to the callback to allow it to abort the task.
-     */
-    enqueue(callback: PromiseQueueTaskCallback): Promise<void>;
-    /**
-     * Aborts the queue, rejects all pending tasks and resets it to initial state.
-     */
-    abort(): void;
-    /**
-     * A promise that resolves when the queue is empty.
-     */
-    get queueEmptyPromise(): Promise<void>;
-    /**
-     * Processes the queue sequentially.
-     */
-    private _processQueue;
+* @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
+*/
+/**
+* @module ai/aichat/utils/promisequeue
+*/
+import { type EmitterMixinConstructor } from "@ckeditor/ckeditor5-utils";
+declare const PromiseQueueBase: EmitterMixinConstructor;
+export declare class PromiseQueue extends PromiseQueueBase {
+	isProcessing: boolean;
+	/**
+	* Adds a task to the queue. An abort signal is provided to the callback to allow it to abort the task.
+	*/
+	enqueue(callback: PromiseQueueTaskCallback): Promise<void>;
+	/**
+	* Aborts the queue, rejects all pending tasks and resets it to initial state.
+	*/
+	abort(): void;
+	/**
+	* A promise that resolves when the queue is empty.
+	*/
+	get queueEmptyPromise(): Promise<void>;
+	/**
+	* Processes the queue sequentially.
+	*/
+	private _processQueue;
 }
 type PromiseQueueTaskCallback = (signal: AbortSignal) => Promise<void>;
 export {};

package/dist/aichat/utils/readdatatransferfiles.d.ts

@@ -0,0 +1,14 @@
+/**
+* @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
+*/
+/**
+* @module ai/aichat/utils/readdatatransferfiles
+*/
+/**
+* Detect directories — `dataTransfer.files` alone exposes them as zero-byte `File`s, so we probe `items` via `webkitGetAsEntry()`.
+*/
+export declare function readDataTransferFiles(dataTransfer: DataTransfer): {
+	files: Array<File>;
+	hasDirectory: boolean;
+};

package/dist/aichat/utils/resolvepaste.d.ts

@@ -0,0 +1,71 @@
+/**
+* @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 {};

package/dist/aichathistory/aichathistory.d.ts

@@ -1,30 +1,30 @@
 /**
- * @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
- */
+* @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
+*/
 /**
- * @module ai/aichathistory/aichathistory
- * @publicApi
- */
-import { ContextPlugin } from '@ckeditor/ckeditor5-core';
-import { AIChatHistoryController } from './aichathistorycontroller.js';
-import { AIChatHistoryUI } from './aichathistoryui.js';
-export { AIChatHistoryItem } from './model/aichathistoryitem.js';
+* @module ai/aichathistory/aichathistory
+* @publicApi
+*/
+import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { AIChatHistoryController } from "./aichathistorycontroller.js";
+import { AIChatHistoryUI } from "./aichathistoryui.js";
+export { AIChatHistoryItem } from "./model/aichathistoryitem.js";
 export declare class AIChatHistory extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AIChatHistoryController, typeof AIChatHistoryUI];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIChatHistory";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AIChatHistoryController, AIChatHistoryUI]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIChatHistory";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
 }

package/dist/aichathistory/aichathistorycontroller.d.ts

@@ -1,39 +1,40 @@
 /**
- * @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
- */
+* @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
+*/
 /**
- * @module ai/aichathistory/aichathistorycontroller
- */
-import { ContextPlugin } from '@ckeditor/ckeditor5-core';
-import { AIConnector } from '../aicore/aiconnector.js';
-import { AIChatController } from '../aichat/aichatcontroller.js';
-import { AITabs } from '../aitabs/aitabs.js';
-import { AIChatHistoryUI } from './aichathistoryui.js';
-import { AIChatHistoryConversations } from './model/aichathistoryconversations.js';
+* @module ai/aichathistory/aichathistorycontroller
+*/
+import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { AIConnector } from "../aicore/aiconnector.js";
+import { AIErrorSink } from "../aicore/aierrorreporter.js";
+import { AIChatController } from "../aichat/aichatcontroller.js";
+import { AITabs } from "../aitabs/aitabs.js";
+import { AIChatHistoryUI } from "./aichathistoryui.js";
+import { AIChatHistoryConversations } from "./model/aichathistoryconversations.js";
 export declare class AIChatHistoryController extends ContextPlugin {
-    /**
-     * The `AIChatHistoryConversations` model instance.
-     */
-    history: AIChatHistoryConversations;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AIConnector, typeof AIChatController, typeof AIChatHistoryUI, typeof AITabs];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIChatHistoryController";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
+	/**
+	* The `AIChatHistoryConversations` model instance.
+	*/
+	history: AIChatHistoryConversations;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, AIChatController, AIChatHistoryUI, AITabs]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIChatHistoryController";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
 }

package/dist/aichathistory/aichathistoryui.d.ts

@@ -1,106 +1,97 @@
 /**
- * @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
- */
+* @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
+*/
 /**
- * @module ai/aichathistory/aichathistoryui
- */
-import { type Context, type Editor, ContextPlugin } from '@ckeditor/ckeditor5-core';
-import { AITabs } from '../aitabs/aitabs.js';
-import '../../theme/aichat/aichathistory.css';
+* @module ai/aichathistory/aichathistoryui
+*/
+import { type Context, type Editor, ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { AITabs } from "../aitabs/aitabs.js";
 export declare const AI_CHAT_HISTORY_UI_EVENT_NAMES: readonly ["showConversationHistory", "removeConversation", "editConversationTitle", "setConversationPinned", "selectConversation", "startConversation"];
 export declare class AIChatHistoryUI extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AITabs];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIChatHistoryUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    constructor(context: Context | Editor);
-    /**
-     * Removes a conversation item from the history list.
-     */
-    removeHistoryItem(id: string): void;
-    /**
-     * Updates the history items with categorized data.
-     */
-    updateItems(categories: Array<AIChatHistoryCategoryData>): void;
-    /**
-     * Updates the title of a specific history item in the UI.
-     */
-    updateItemTitle(itemId: string, title: string): void;
-    /**
-     * Updates the loading state of a specific history item in the UI.
-     */
-    updateItemLoadingState(itemId: string, operation: string | null, isLoading: boolean): void;
-    /**
-     * Toggles the loading skeleton in the history view.
-     */
-    setLoadingSkeleton(isLoading: boolean): void;
-    /**
-     * Shows an error message in the history view.
-     */
-    showError(message: string): void;
-    /**
-     * Hides the error message in the history view.
-     */
-    hideError(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AITabs]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIChatHistoryUI";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	constructor(context: Context | Editor);
+	/**
+	* Removes a conversation item from the history list.
+	*/
+	removeHistoryItem(id: string): void;
+	/**
+	* Updates the history items with categorized data.
+	*/
+	updateItems(categories: Array<AIChatHistoryCategoryData>): void;
+	/**
+	* Updates the title of a specific history item in the UI.
+	*/
+	updateItemTitle(itemId: string, title: string): void;
+	/**
+	* Updates the loading state of a specific history item in the UI.
+	*/
+	updateItemLoadingState(itemId: string, operation: string | null, isLoading: boolean): void;
+	/**
+	* Toggles the loading skeleton in the history view.
+	*/
+	setLoadingSkeleton(isLoading: boolean): void;
+	/**
+	* Shows an error message in the history view.
+	*/
+	showError(message: string): void;
+	/**
+	* Hides the error message in the history view.
+	*/
+	hideError(): void;
 }
 export type AIChatHistoryItemData = {
-    id: string;
-    title: string;
-    createdAt: string;
-    active: boolean;
-    pinned?: boolean;
+	id: string;
+	title: string;
+	createdAt: string;
+	active: boolean;
+	pinned?: boolean;
 };
 export type AIChatHistoryCategoryData = {
-    title: string;
-    items: Array<AIChatHistoryItemData>;
+	title: string;
+	items: Array<AIChatHistoryItemData>;
 };
 export type AIChatHistoryUIRemoveConversationEvent = {
-    name: 'removeConversation';
-    args: [
-        {
-            id: string;
-        }
-    ];
+	name: "removeConversation";
+	args: [{
+		id: string;
+	}];
 };
 export type AIChatHistoryUIEditTitleEvent = {
-    name: 'editConversationTitle';
-    args: [
-        {
-            id: string;
-            title: string;
-        }
-    ];
+	name: "editConversationTitle";
+	args: [{
+		id: string;
+		title: string;
+	}];
 };
 export type AIChatHistoryUISelectConversationEvent = {
-    name: 'selectConversation';
-    args: [
-        {
-            id: string;
-        }
-    ];
+	name: "selectConversation";
+	args: [{
+		id: string;
+	}];
 };
 export type AIChatHistoryUISetPinnedEvent = {
-    name: 'setConversationPinned';
-    args: [
-        {
-            id: string;
-            pinned: boolean;
-        }
-    ];
+	name: "setConversationPinned";
+	args: [{
+		id: string;
+		pinned: boolean;
+	}];
 };