@ckeditor/ckeditor5-ai 48.8.1-alpha.4 → 49.0.0-alpha.1

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,113 +1,109 @@
 /**
- * @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 { 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. When provided (multi-root / multi-instance setups), it takes precedence over the
-     * focus-based heuristic used by {@link module:ai/aicore/utils/geteditorfromcontext~getEditorFromContext} — otherwise clicking a
-     * chat-sidebar suggestion chip routes the balloon to whichever editor happens to be focused, which collapses dialog positioning
-     * when the chip's target range lives on a different editor or root.
-     */
-    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/aiballoondisclaimerview.d.ts

@@ -0,0 +1,17 @@
+/**
+* @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/aiballoondisclaimerview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "@ckeditor/ckeditor5-ui";
+/**
+* The disclaimer view displayed in AI balloons.
+*
+* It displays information about the AI, such as a reminder to double-check responses.
+*/
+export declare class AIBalloonDisclaimerView extends View {
+	constructor(locale: Locale);
+}

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

@@ -0,0 +1,56 @@
+/**
+* @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/aiballoontoolbarview
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { ToolbarView, ButtonView } from "@ckeditor/ckeditor5-ui";
+/**
+* A class representing the toolbar view of the AI balloon.
+*/
+export declare class AIBalloonToolbarView extends ToolbarView {
+	/**
+	* Observable property that indicates whether the toolbar is visible or not.
+	*/
+	isVisible: boolean;
+	/**
+	* Button that is used to reject the suggestion.
+	*/
+	rejectButton?: ButtonView;
+	/**
+	* Button that is used to insert the suggestion.
+	*/
+	suggestButton?: ButtonView;
+	/**
+	* Button that is used to apply the suggestion.
+	*/
+	applyButton?: ButtonView;
+	/**
+	* Observable property that indicates whether the toolbar buttons are enabled or not.
+	*/
+	isEnabled: boolean;
+	/**
+	* Whether the target editor is read-only. Disables the write actions (apply, suggest), but not reject.
+	*
+	* @observable
+	*/
+	isTargetReadOnly: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, showApplyButton?: boolean, showSuggestButton?: boolean);
+	/**
+	* The button representing the primary (default) action of the toolbar. It is the apply button, or the suggest button
+	* when applying is not available, or the reject button when neither of them is.
+	*/
+	get primaryActionButton(): ButtonView;
+	/**
+	* Toggles the visibility of the apply and suggest buttons.
+	*/
+	setButtonsVisibility({ showApplyButton, showSuggestButton }: {
+		showApplyButton: boolean;
+		showSuggestButton: boolean;
+	}): void;
+}

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

@@ -1,32 +1,79 @@
 /**
- * @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';
-export declare const AI_BALLOON_VIEW_EVENT_NAMES: readonly ["applySuggestion", "insertSuggestion", "showNext", "showPrevious"];
+* @module ai/aiballoon/ui/aiballoonview
+*/
+import { View, type ViewCollection } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { type AIContentRenderingStrategy } from "../../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js";
+import { type AISuggestionContentPartDefinition } from "../../aicore/utils/getsuggestionpartsfromreply.js";
+import { type AIMiniToolbarConfig } from "../../aicore/ui/suggestioncontainer/aiminitoolbarview.js";
+import { type AISuggestionActionName } from "../../aicore/utils/replyactions.js";
+export declare const AI_BALLOON_VIEW_EVENT_NAMES: readonly ["applySuggestion", "insertSuggestion", "rejectSuggestion", "showNext", "showPrevious"];
+export type AIBalloonViewConfig = {
+	showApplyButton: boolean;
+	showSuggestButton: boolean;
+	availableActions: Array<AISuggestionActionName>;
+	showChangesButtonMode?: AIMiniToolbarConfig["showChanges"];
+};
 /**
- * The base class for all balloon views used by the `AIBalloon` plugin.
- */
+* The base class for all balloon views used by the `AIBalloon` plugin.
+*
+* It provides the content region, the disclaimer and the toolbars shared by every balloon. Anything that depends on how
+* a particular feature produces its suggestion stays in the subclass: the loading skeleton, the auto-scrolling during
+* streaming and the "Try again" action belong to the Quick Actions balloon only, because it generates the suggestion in
+* place, while the Chat balloon merely previews a suggestion that the chat feed has already streamed and rendered.
+*/
 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;
+	/**
+	* The children of the balloon view.
+	*/
+	children: ViewCollection<View>;
+	/**
+	* Observable property that indicates whether the track changes are on.
+	*/
+	isTrackChangesOn: boolean;
+	/**
+	* Whether the target editor is read-only. Forwarded to the toolbar to disable the write actions (apply, suggest),
+	* but not reject.
+	*
+	* @observable
+	*/
+	isTargetReadOnly: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, config: AIBalloonViewConfig);
+	/**
+	* 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;
+	/**
+	* Clears the content of the suggestion part displayed in the balloon.
+	*/
+	clearContent(): void;
+	/**
+	* Updates the content of the balloon.
+	*/
+	updateContent(options: {
+		part: AISuggestionContentPartDefinition;
+		renderingStrategy: AIContentRenderingStrategy;
+		abortSignal?: AbortSignal;
+		keepErrors?: boolean;
+	}): Promise<void>;
+	/**
+	* Sets {@link #width} so that this balloon's suggestion content follows the editable's width.
+	*/
+	abstract adjustWidthToEditable(domRoot: HTMLElement): void;
 }

package/dist/aiballoon/utils/contentwidth.d.ts

@@ -0,0 +1 @@
+export {};