@ckeditor/ckeditor5-ai 48.2.0-alpha.7 → 48.3.0-alpha.0

package/dist/aiassistant/ui/showaiassistantcommand.d.ts

@@ -1,40 +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/aiassistant/ui/showaiassistantcommand
- * @publicApi
- */
-import { Command, type Editor } from '@ckeditor/ckeditor5-core';
-import type { AICommandDefinition } from '../aiassistant.js';
+* @module ai/aiassistant/ui/showaiassistantcommand
+* @publicApi
+*/
+import { Command, type Editor } from "@ckeditor/ckeditor5-core";
+import type { AICommandDefinition } from "../aiassistant.js";
 /**
- * Command that shows the AI Assistant user interface.
- */
+* Command that shows the AI Assistant user interface.
+*/
 export declare class ShowAIAssistantCommand extends Command {
-    /**
-     * An array with ids of the AI commands enabled for the current selection.
-     *
-     * @observable
-     */
-    enabledCommandsIds: Array<string>;
-    /**
-     * Creates an instance of the command.
-     */
-    constructor(editor: Editor, commandDefinitions: Array<AICommandDefinition>);
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Opens AI Assistant user interface for the current document selection.
-     *
-     * @param query The initial query. If set, the AI assistant will automatically submit given query to the AI service.
-     * @param label Label to be displayed in the AI assistant query input field while the AI assistant processes the initial query.
-     * @param actionId The id of the executed action. It can be used in extended and custom adapters to customize the request. It
-     * will be prefixed with `aiAssistant:`. See also
-     * {@link module:ai/aiassistant/adapters/aitextadapter~AITextAdapterRequestData#actionId `AITextAdapterRequestData#actionId`}.
-     * @fires execute
-     */
-    execute(query?: string, label?: string, actionId?: string): void;
+	/**
+	* An array with ids of the AI commands enabled for the current selection.
+	*
+	* @observable
+	*/
+	enabledCommandsIds: Array<string>;
+	/**
+	* Creates an instance of the command.
+	*/
+	constructor(editor: Editor, commandDefinitions: Array<AICommandDefinition>);
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* Opens AI Assistant user interface for the current document selection.
+	*
+	* @param query The initial query. If set, the AI assistant will automatically submit given query to the AI service.
+	* @param label Label to be displayed in the AI assistant query input field while the AI assistant processes the initial query.
+	* @param actionId The id of the executed action. It can be used in extended and custom adapters to customize the request. It
+	* will be prefixed with `aiAssistant:`. See also
+	* {@link module:ai/aiassistant/adapters/aitextadapter~AITextAdapterRequestData#actionId `AITextAdapterRequestData#actionId`}.
+	* @fires execute
+	*/
+	override execute(query?: string, label?: string, actionId?: string): void;
 }

package/dist/aiassistant/utils/common-translations.d.ts

@@ -1,9 +1,9 @@
 /**
- * @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/aiassistant/utils/common-translations
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
+* @module ai/aiassistant/utils/common-translations
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
 export declare function getTranslation(locale: Locale, id: string, values?: string | Array<string> | number): string;

package/dist/aiassistant/utils/normalizecommandsconfig.d.ts

@@ -1,14 +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
- */
+* @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/aiassistant/utils/normalizecommandsconfig
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import type { AIGroupDefinition, AICommandDefinition } from '../aiassistant.js';
+* @module ai/aiassistant/utils/normalizecommandsconfig
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import type { AIGroupDefinition, AICommandDefinition } from "../aiassistant.js";
 export declare const UNGROUPED_COMMANDS_GROUP_ID = "_ungrouppedCommands";
 /**
- * Normalizes the `config.ai.assistant.commands` configuration taking into account different possible config formats (or lack thereof).
- */
+* Normalizes the `config.ai.assistant.commands` configuration taking into account different possible config formats (or lack thereof).
+*/
 export declare function normalizeCommandsConfig(config: Array<AIGroupDefinition | AICommandDefinition>, locale: Locale): Array<AIGroupDefinition>;

package/dist/aiballoon/aiballoon.d.ts

@@ -1,110 +1,110 @@
 /**
- * @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/aiballoon/aiballoon
- */
-import { ContextPlugin, type Editor } from '@ckeditor/ckeditor5-core';
-import { AIEditing } from '../aicore/aiediting.js';
-import '../../theme/aiballoon/aiballoon.css';
-import { type ModelRange } from '@ckeditor/ckeditor5-engine';
-import { type AIBalloonView } from './ui/aiballoonview.js';
+* @module ai/aiballoon/aiballoon
+*/
+import { ContextPlugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { AIEditing } from "../aicore/aiediting.js";
+import "../../theme/aiballoon/aiballoon.css";
+import { type ModelRange } from "@ckeditor/ckeditor5-engine";
+import { type AIBalloonView, AI_BALLOON_VIEW_EVENT_NAMES } from "./ui/aiballoonview.js";
 /**
- * Event names that can be fired by the AI Balloon plugin.
- * Includes all view events plus dialog-specific events.
- */
-export declare const AI_BALLOON_EVENT_NAMES: readonly ["applySuggestion", "insertSuggestion", "showNext", "showPrevious", "dialogClosed", "selectionRemoved"];
+* Event names that can be fired by the AI Balloon plugin.
+* Includes all view events plus dialog-specific events.
+*/
+export declare const AI_BALLOON_EVENT_NAMES: readonly [...typeof AI_BALLOON_VIEW_EVENT_NAMES, "dialogClosed", "selectionRemoved"];
 /**
- * Configuration object for opening the AI Balloon.
- */
+* Configuration object for opening the AI Balloon.
+*/
 export interface AIBalloonConfig {
-    id: string;
-    index: number;
-    title: string;
-    icon?: string;
-    mainView: AIBalloonView;
-    ranges: Array<ModelRange>;
-    class: string;
-    /**
-     * The editor the balloon should anchor to.
-     */
-    targetEditor: Editor;
+	id: string;
+	index: number;
+	title: string;
+	icon?: string;
+	mainView: AIBalloonView;
+	ranges: Array<ModelRange>;
+	class: string;
+	/**
+	* The editor the balloon should anchor to.
+	*/
+	targetEditor: Editor;
 }
 /**
- * The AI Balloon plugin provides a balloon dialog interface for displaying and interacting with AI suggestions.
- */
+* The AI Balloon plugin provides a balloon dialog interface for displaying and interacting with AI suggestions.
+*/
 export declare class AIBalloon extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AIEditing];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIBalloon";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * A flag indicating whether the AI Balloon dialog is currently open.
-     */
-    isOpen: boolean;
-    /**
-     * Opens the AI Balloon dialog with the provided configuration.
-     *
-     * @param config Configuration object containing dialog settings and content data
-     */
-    open(config: AIBalloonConfig): void;
-    /**
-     * Closes the currently open AI Balloon dialog.
-     */
-    close(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AIEditing]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIBalloon";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* A flag indicating whether the AI Balloon dialog is currently open.
+	*/
+	isOpen: boolean;
+	/**
+	* Opens the AI Balloon dialog with the provided configuration.
+	*
+	* @param config Configuration object containing dialog settings and content data
+	*/
+	open(config: AIBalloonConfig): void;
+	/**
+	* Closes the currently open AI Balloon dialog.
+	*/
+	close(): void;
 }
 /**
- * Event fired when the AI balloon dialog is closed. As opposed to `beforeDialogClosed`, this event is fired
- * after the dialog's core view has been destroyed and the dialog is no longer visible.
- */
+* Event fired when the AI balloon dialog is closed. As opposed to `beforeDialogClosed`, this event is fired
+* after the dialog's core view has been destroyed and the dialog is no longer visible.
+*/
 export type AIBalloonDialogClosedEvent = {
-    name: 'dialogClosed';
-    args: [{
-        id: string;
-    }];
+	name: "dialogClosed";
+	args: [{
+		id: string;
+	}];
 };
 /**
- * Event fired when the AI balloon dialog is about to be closed. It gives plugins a chance
- * to salvage their views if they were injected into the dialog before they get destroyed along with
- * the dialog's core view.
- */
+* Event fired when the AI balloon dialog is about to be closed. It gives plugins a chance
+* to salvage their views if they were injected into the dialog before they get destroyed along with
+* the dialog's core view.
+*/
 export type AIBalloonBeforeDialogClosedEvent = {
-    name: 'beforeDialogClosed';
-    args: [{
-        id: string;
-    }];
+	name: "beforeDialogClosed";
+	args: [{
+		id: string;
+	}];
 };
 /**
- * Event fired when the AI selection related to the balloon is removed.
- */
+* Event fired when the AI selection related to the balloon is removed.
+*/
 export type AIBalloonSelectionRemovedEvent = {
-    name: 'selectionRemoved';
-    args: [];
+	name: "selectionRemoved";
+	args: [];
 };
 /**
- * Event fired when user clicks the next suggestion button in the rotator.
- */
+* Event fired when user clicks the next suggestion button in the rotator.
+*/
 export type AIBalloonShowNextSuggestionEvent = {
-    name: 'showNext';
-    args: [];
+	name: "showNext";
+	args: [];
 };
 /**
- * Event fired when user clicks the previous suggestion button in the rotator.
- */
+* Event fired when user clicks the previous suggestion button in the rotator.
+*/
 export type AIBalloonShowPreviousSuggestionEvent = {
-    name: 'showPrevious';
-    args: [];
+	name: "showPrevious";
+	args: [];
 };

package/dist/aiballoon/ui/aiballoonview.d.ts

@@ -1,32 +1,32 @@
 /**
- * @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/aiballoon/ui/aiballoonview
- */
-import { View } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
+* @module ai/aiballoon/ui/aiballoonview
+*/
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
 export declare const AI_BALLOON_VIEW_EVENT_NAMES: readonly ["applySuggestion", "insertSuggestion", "showNext", "showPrevious"];
 /**
- * The base class for all balloon views used by the `AIBalloon` plugin.
- */
+* The base class for all balloon views used by the `AIBalloon` plugin.
+*/
 export declare abstract class AIBalloonView extends View {
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale);
-    /**
-     * Shows a blocking error message and disables toolbar buttons.
-     * This should be used for terminal errors where the interaction cannot continue (e.g., selection removed).
-     *
-     * @param message The error message to display
-     */
-    showBlockingError(message: string): void;
-    /**
-     * Shows an error message in the balloon.
-     *
-     * @param message The error message to display
-     */
-    showError(message: string): void;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale);
+	/**
+	* Shows a blocking error message and disables toolbar buttons.
+	* This should be used for terminal errors where the interaction cannot continue (e.g., selection removed).
+	*
+	* @param message The error message to display
+	*/
+	showBlockingError(message: string): void;
+	/**
+	* Shows an error message in the balloon.
+	*
+	* @param message The error message to display
+	*/
+	showError(message: string): void;
 }

package/dist/aichat/aichat.d.ts

@@ -1,95 +1,96 @@
 /**
- * @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/aichat/aichat
- * @publicApi
- */
-import { type Context, ContextPlugin, type Editor } from '@ckeditor/ckeditor5-core';
-import { AIChatController } from './aichatcontroller.js';
-import { AIEditing } from '../aicore/aiediting.js';
-import { AIChatUI } from './aichatui.js';
-import { type AIChatContextConfig } from './model/aichatcontext.js';
-import { AIChatHistory } from '../aichathistory/aichathistory.js';
+* @module ai/aichat/aichat
+* @publicApi
+*/
+import { type Context, ContextPlugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { AIChatController } from "./aichatcontroller.js";
+import { AIEditing } from "../aicore/aiediting.js";
+import { AIChatUI } from "./aichatui.js";
+import { type AIChatContextConfig } from "./model/aichatcontext.js";
+import { AIChatHistory } from "../aichathistory/aichathistory.js";
+import { AIDocumentProcessingGateway } from "../aidocumentprocessing/aidocumentprocessinggateway.js";
 /**
- * The AI Chat feature. It brings a conversational AI that can be used to aid content creation and editing. It introduces a dynamic chat
- * interface designed to facilitate rich, multi-turn interactions between users and an AI Assistant.
- *
- * You can configure the feature by setting the {@link module:ai/aichat/aichat~AIChatConfig} property.
- *
- * See {@link module:ai/aichat/aichatcontroller~AIChatController} to learn about the public API available for this feature.
- *
- * Learn more about AI features in CKEditor in the {@glink features/ai/ckeditor-ai-overview AI Overview} documentation.
- */
+* The AI Chat feature. It brings a conversational AI that can be used to aid content creation and editing. It introduces a dynamic chat
+* interface designed to facilitate rich, multi-turn interactions between users and an AI Assistant.
+*
+* You can configure the feature by setting the {@link module:ai/aichat/aichat~AIChatConfig} property.
+*
+* See {@link module:ai/aichat/aichatcontroller~AIChatController} to learn about the public API available for this feature.
+*
+* Learn more about AI features in CKEditor in the {@glink features/ai/ckeditor-ai-overview AI Overview} documentation.
+*/
 export declare class AIChat extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AIChatController, typeof AIEditing, typeof AIChatUI, typeof AIChatHistory];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIChat";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    constructor(context: Context | Editor);
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AIChatController, AIEditing, AIChatUI, AIChatHistory, AIDocumentProcessingGateway]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIChat";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	constructor(context: Context | Editor);
 }
 /**
- * The configuration of the {@link module:ai/aichat/aichat~AIChat AI Chat feature}.
- *
- * The properties defined in this config are set in the `config.ai.chat` namespace.
- *
- * ```ts
- * ClassicEditor
- * 	.create( {
- * 		ai: {
- * 			chat: {
- * 				// AI Chat configuration.
- * 			}
- * 		}
- * 	} )
- * 	.then( ... )
- * 	.catch( ... );
- * ```
- *
- * See {@link module:ai/aiconfig~AIConfig the full AI configuration}.
- *
- * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
- */
+* The configuration of the {@link module:ai/aichat/aichat~AIChat AI Chat feature}.
+*
+* The properties defined in this config are set in the `config.ai.chat` namespace.
+*
+* ```ts
+* ClassicEditor
+* 	.create( {
+* 		ai: {
+* 			chat: {
+* 				// AI Chat configuration.
+* 			}
+* 		}
+* 	} )
+* 	.then( ... )
+* 	.catch( ... );
+* ```
+*
+* See {@link module:ai/aiconfig~AIConfig the full AI configuration}.
+*
+* See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
+*/
 export interface AIChatConfig {
-    /**
-     * The configuration of the AI Chat context.
-     *
-     * Read more in {@link module:ai/aichat/model/aichatcontext~AIChatContextConfig}.
-     */
-    context: AIChatContextConfig;
-    /**
-     * Decides which conversation will be loaded after the feature has initialized.
-     *
-     * Possible values are:
-     *
-     * * `'new'` - a new conversation is started (default),
-     * * `'lastCreated'` - the most recently created conversation will be loaded,
-     * * conversation ID - the conversation with given ID will be loaded.
-     *
-     * If `'lastCreated'` is set while the conversation history is empty, a new conversation will be started instead.
-     *
-     * If the conversation with the specified ID is not found, an error will be thrown.
-     *
-     * @default 'new'
-     */
-    initialConversation?: string;
-    /**
-     * The welcome message to be displayed when the AI chat is initialized. When not set, the default welcome message will be used.
-     *
-     * @default 'Hi! I can help you draft, rewrite, and improve your text, explore ideas, research topics, and solve problems. How can I help right now?'
-     */
-    welcomeMessage?: string;
+	/**
+	* The configuration of the AI Chat context.
+	*
+	* Read more in {@link module:ai/aichat/model/aichatcontext~AIChatContextConfig}.
+	*/
+	context: AIChatContextConfig;
+	/**
+	* Decides which conversation will be loaded after the feature has initialized.
+	*
+	* Possible values are:
+	*
+	* * `'new'` - a new conversation is started (default),
+	* * `'lastCreated'` - the most recently created conversation will be loaded,
+	* * conversation ID - the conversation with given ID will be loaded.
+	*
+	* If `'lastCreated'` is set while the conversation history is empty, a new conversation will be started instead.
+	*
+	* If the conversation with the specified ID is not found, an error will be thrown.
+	*
+	* @default 'new'
+	*/
+	initialConversation?: string;
+	/**
+	* The welcome message to be displayed when the AI chat is initialized. When not set, the default welcome message will be used.
+	*
+	* @default 'Hi! I can help you draft, rewrite, and improve your text, explore ideas, research topics, and solve problems. How can I help right now?'
+	*/
+	welcomeMessage?: string;
 }