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

package/dist/aichat/ui/controls/aichatcontextpanelurlinputview.d.ts

@@ -1,93 +1,93 @@
 /**
- * @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/ui/controls/aichatcontextpanelurlinputview
- */
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import { ButtonView, FocusCycler, LabeledFieldView, View, type InputTextView, type ViewWithFocusCycler } from '@ckeditor/ckeditor5-ui';
+* @module ai/aichat/ui/controls/aichatcontextpanelurlinputview
+*/
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import { ButtonView, FocusCycler, LabeledFieldView, View, type InputTextView, type ViewWithFocusCycler } from "@ckeditor/ckeditor5-ui";
 /**
- * A view for URL input in the AI chat context panel.
- * Provides a form with input field and submit/cancel buttons with proper focus management.
- */
+* A view for URL input in the AI chat context panel.
+* Provides a form with input field and submit/cancel buttons with proper focus management.
+*/
 export declare class AIChatContextPanelUrlInputView extends View implements ViewWithFocusCycler {
-    /**
-     * Tracks information about DOM focus in the form.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * Helps cycling over {@link #_focusables} in the form.
-     */
-    readonly focusCycler: FocusCycler;
-    /**
-     * The URL input field.
-     */
-    readonly urlInputField: LabeledFieldView<InputTextView>;
-    /**
-     * The back button.
-     */
-    readonly backButton: ButtonView;
-    /**
-     * The confirm button.
-     */
-    readonly confirmButton: ButtonView;
-    /**
-     * Indicates if the back button should be visible.
-     */
-    withBackButton: boolean;
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the URL input field.
-     */
-    focus(): void;
-    /**
-     * Gets the current URL value.
-     */
-    getValue(): string;
-    /**
-     * Clears the URL input field.
-     */
-    clear(): void;
-    /**
-     * Sets an error message on the URL input field.
-     */
-    setError(message: string): void;
-    /**
-     * Clears any error on the URL input field.
-     */
-    clearError(): void;
+	/**
+	* Tracks information about DOM focus in the form.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* Helps cycling over {@link #_focusables} in the form.
+	*/
+	readonly focusCycler: FocusCycler;
+	/**
+	* The URL input field.
+	*/
+	readonly urlInputField: LabeledFieldView<InputTextView>;
+	/**
+	* The back button.
+	*/
+	readonly backButton: ButtonView;
+	/**
+	* The confirm button.
+	*/
+	readonly confirmButton: ButtonView;
+	/**
+	* Indicates if the back button should be visible.
+	*/
+	withBackButton: boolean;
+	constructor(locale: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Focuses the URL input field.
+	*/
+	focus(): void;
+	/**
+	* Gets the current URL value.
+	*/
+	getValue(): string;
+	/**
+	* Clears the URL input field.
+	*/
+	clear(): void;
+	/**
+	* Sets an error message on the URL input field.
+	*/
+	setError(message: string): void;
+	/**
+	* Clears any error on the URL input field.
+	*/
+	clearError(): void;
 }
 /**
- * Event fired when the URL form is submitted.
- */
+* Event fired when the URL form is submitted.
+*/
 export type UrlInputSubmitEvent = {
-    name: 'submitUrl';
-    args: [url: string];
+	name: "submitUrl";
+	args: [url: string];
 };
 /**
- * Event fired when the URL form is cancelled.
- */
+* Event fired when the URL form is cancelled.
+*/
 export type UrlInputCancelEvent = {
-    name: 'cancel';
-    args: [];
+	name: "cancel";
+	args: [];
 };
 /**
- * Event fired when the balloon should be repositioned due to content size changes.
- */
+* Event fired when the balloon should be repositioned due to content size changes.
+*/
 export type RefreshBalloonEvent = {
-    name: 'refreshBalloon';
-    args: [];
+	name: "refreshBalloon";
+	args: [];
 };

package/dist/aichat/ui/controls/aichatcontextpanelview.d.ts

@@ -1,108 +1,118 @@
 /**
- * @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/ui/controls/aichatcontextpanelview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type BodyCollection, ButtonView, IconView, View } from '@ckeditor/ckeditor5-ui';
-import { type AIContextProvider, type AIContextResourceState, type AIAddContextOptionsState } from '../../../aichat/model/aichatcontext.js';
-import { type AIContextItem } from '../../../aicore/model/aicontext.js';
+* @module ai/aichat/ui/controls/aichatcontextpanelview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { type BodyCollection, ButtonView, IconView, ListItemButtonView, View } from "@ckeditor/ckeditor5-ui";
+import { type AIContextProvider, type AIContextResourceState, type AIAddContextOptionsState } from "../../../aichat/model/aichatcontext.js";
+import { type AIContextItem } from "../../../aicore/model/aicontext.js";
 export declare const CONTEXT_PANEL_VIEW_EVENT_NAMES: readonly ["addDocumentToContext", "addFileToContext", "addUrlToContext", "addResourceToContext", "removeContextItem", "loadSourceResources", "executeCustomItemCallback"];
 /**
- * Manages the context panel UI for AI chat, including pending contexts and conversation contexts.
- */
+* Manages the context panel UI for AI chat, including pending contexts and conversation contexts.
+*/
 export declare class AIChatContextPanelView extends View {
-    /**
-     * Button view for adding a context.
-     *
-     * **Note**: It gets rendered in the `AIChatPromptInputView` due to positioning constraints.
-     */
-    readonly addContextButtonView: ButtonView;
-    constructor(locale: Locale, options: {
-        bodyCollection: BodyCollection;
-        searchInputVisibleFrom?: number;
-    });
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Adds a context item to the current contexts collection.
-     */
-    addContextItem(contextItem: AIContextItem, isLoading: boolean): void;
-    /**
-     * Removes a context item by ID from the current contexts.
-     */
-    removeContextItem(id: string): void;
-    /**
-     * Sets the loading state of a context item.
-     */
-    setContextItemLoading(uiId: string, isLoading: boolean): void;
-    /**
-     * Sets the conversation context chips.
-     */
-    setConversationContext(contextItems: Array<AIContextItem>): void;
-    /**
-     * Clears all current context items.
-     */
-    clearCurrentContextItems(): void;
-    /**
-     * Clears all conversation context items.
-     */
-    clearConversationContextItems(): void;
-    /**
-     * Updates the state of a specific resource in the balloon views.
-     */
-    updateResourceState(sourceId: string, resourceId: string, isInContext: boolean): void;
-    /**
-     * Hides the add context balloon panel.
-     */
-    hideAddContextBalloonPanel(): void;
-    /**
-     * Shows the add context balloon panel.
-     */
-    showAddContextBalloonPanel(): void;
-    /**
-     * Hides the URL balloon panel.
-     */
-    hideUrlBalloonPanel(): void;
-    /**
-     * Shows the URL balloon panel.
-     */
-    showUrlBalloonPanel(): void;
-    /**
-     * Populates a source resource balloon with loaded resources.
-     */
-    populateSourceResourceBalloon(sourceId: string, source: AIContextProvider, resources: Array<AIContextResourceState>, uid: string): void;
-    /**
-     * Closes the source resource balloon and cleans up its state.
-     */
-    closeSourceResourceBalloon(sourceId: string): void;
-    /**
-     * Sets the add context options.
-     */
-    setAddContextOptions(options: AIAddContextOptionsState): void;
+	/**
+	* Button view for adding a context.
+	*
+	* **Note**: It gets rendered in the `AIChatPromptInputView` due to positioning constraints.
+	*/
+	readonly addContextButtonView: ButtonView;
+	/**
+	* Set while a response is streaming in.
+	*
+	* @observable
+	*/
+	isBusy: boolean;
+	constructor(locale: Locale, options: {
+		bodyCollection: BodyCollection;
+		searchInputVisibleFrom?: number;
+	});
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Adds a context item to the current contexts collection.
+	*/
+	addContextItem(contextItem: AIContextItem, isLoading: boolean): void;
+	/**
+	* Removes a context item by ID from the current contexts.
+	*/
+	removeContextItem(id: string): void;
+	/**
+	* Sets the loading state of a context item.
+	*/
+	setContextItemLoading(uiId: string, isLoading: boolean): void;
+	/**
+	* Sets the conversation context chips.
+	*/
+	setConversationContext(contextItems: Array<AIContextItem>): void;
+	/**
+	* Clears all current context items.
+	*/
+	clearCurrentContextItems(): void;
+	/**
+	* Clears all conversation context items.
+	*/
+	clearConversationContextItems(): void;
+	/**
+	* Updates the state of a specific resource in the balloon views.
+	*/
+	updateResourceState(sourceId: string, resourceId: string, isInContext: boolean): void;
+	/**
+	* Hides the add context balloon panel.
+	*/
+	hideAddContextBalloonPanel(): void;
+	/**
+	* Shows the add context balloon panel.
+	*/
+	showAddContextBalloonPanel(): void;
+	/**
+	* Hides the URL balloon panel.
+	*/
+	hideUrlBalloonPanel(): void;
+	/**
+	* Shows the URL balloon panel.
+	*/
+	showUrlBalloonPanel(): void;
+	/**
+	* Closes every balloon owned by this view — add-context, URL form, and source resource balloons.
+	*/
+	hideAllBalloons(): void;
+	/**
+	* Populates a source resource balloon with loaded resources.
+	*/
+	populateSourceResourceBalloon(sourceId: string, source: AIContextProvider, resources: Array<AIContextResourceState>, uid: string): void;
+	/**
+	* Closes the source resource balloon and cleans up its state.
+	*/
+	closeSourceResourceBalloon(sourceId: string): void;
+	/**
+	* Sets the add context options.
+	*/
+	setAddContextOptions(options: AIAddContextOptionsState): void;
 }
 /**
- * A balloon button view for sources. It includes an arrow.
- */
-export declare class SourcesBalloonButtonView extends ButtonView {
-    /**
-     * An icon that displays an arrow to indicate it's a menu button.
-     */
-    readonly arrowView: IconView;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
+* A balloon button view for sources. It includes an arrow.
+*/
+export declare class SourcesBalloonButtonView extends ListItemButtonView {
+	/**
+	* An icon that displays an arrow to indicate it's a menu button.
+	*/
+	readonly arrowView: IconView;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
 }

package/dist/aichat/ui/controls/aichatdropzoneview.d.ts

@@ -0,0 +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
+*/
+/**
+* @module ai/aichat/ui/controls/aichatdropzoneview
+*/
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+/**
+* Encapsulates the drop overlay and drag-and-drop listeners independently of the target
+* element, which is supplied later via {@link #attach}. A drop fires `'promptInputPaste'`
+* with an {@link AIChatInputPaste} payload, so the controller dispatches paste and drop
+* through one listener.
+*/
+export declare class AIChatDropZoneView extends View {
+	/**
+	* @observable
+	*/
+	isEnabled: boolean;
+	constructor(locale: Locale);
+	attach(target: HTMLElement): void;
+}
+/**
+* Fired on `dragenter` over the drop target so the parent can dismiss open balloons.
+*/
+export type AIChatDropZoneEnterEvent = {
+	name: "dragEnter";
+	args: [];
+};

package/dist/aichat/ui/controls/aichatpromptcapabilitiesview.d.ts

@@ -1,92 +1,83 @@
 /**
- * @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/ui/controls/aichatpromptcapabilitiesview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { View } from '@ckeditor/ckeditor5-ui';
-import { type AIModelData } from '../../../aicore/aiconnector.js';
+* @module ai/aichat/ui/controls/aichatpromptcapabilitiesview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "@ckeditor/ckeditor5-ui";
+import { AIModelSelectorView } from "../../../aicore/ui/aimodelselectorview.js";
+import { type AIModelData } from "../../../aicore/aiconnector.js";
 /**
- * Manages the prompt capabilities UI for AI chat, including web search, commands functionality, and model selection.
- */
+* Manages the prompt capabilities UI for AI chat, including web search, commands functionality, and model selection.
+*/
 export declare class AIChatPromptCapabilitiesView extends View {
-    /**
-     * Indicates whether the web search is active.
-     *
-     * @observable
-     */
-    webSearchActive: boolean;
-    /**
-     * Indicates whether reasoning is active.
-     *
-     * @observable
-     */
-    reasoningActive: boolean;
-    /**
-     * Determines the model display mode:
-     * * 'selector' – shows the dropdown,
-     * * 'name' – shows the model name,
-     * * 'hidden' – hides both.
-     *
-     * @observable
-     */
-    modelDisplayMode: 'selector' | 'name' | 'hidden';
-    /**
-     * Indicates whether the model selection UI is enabled. The selection gets disabled
-     * after the first message is sent to the API, as the model cannot be changed then.
-     *
-     * @observable
-     */
-    modelSelectorEnabled: boolean;
-    /**
-     * The ID of the currently active model.
-     *
-     * @observable
-     */
-    activeModelId: string | null;
-    /**
-     * The name of the currently active model.
-     *
-     * @observable
-     */
-    activeModelName: string | null;
-    constructor(locale: Locale);
-    /**
-     * Sets model list dropdown.
-     */
-    setModelList(models: Array<AIModelData>, hideModels: boolean): void;
-    /**
-     * Sets the web search state.
-     */
-    setWebSearch(isWebSearchEnabled: boolean): void;
-    /**
-     * Sets the reasoning state.
-     */
-    setReasoning(isReasoningEnabled: boolean): void;
-    /**
-     * Sets the selected model.
-     */
-    setModel(model: AIModelData | null): void;
-    /**
-     * Enables the model selector dropdown.
-     */
-    enableModelSelector(): void;
-    /**
-     * Disables the model selector dropdown.
-     */
-    disableModelSelector(hideSelector: boolean): void;
+	/**
+	* Indicates whether the web search is active.
+	*
+	* @observable
+	*/
+	webSearchActive: boolean;
+	/**
+	* Indicates whether reasoning is active.
+	*
+	* @observable
+	*/
+	reasoningActive: boolean;
+	/**
+	* Indicates whether the model selection UI is enabled. The selection gets disabled after the first
+	* message is sent to the API, as the model cannot be changed then.
+	*
+	* @observable
+	*/
+	modelSelectorEnabled: boolean;
+	/**
+	* Set while a response is streaming in.
+	*
+	* @observable
+	*/
+	isBusy: boolean;
+	constructor(locale: Locale);
+	/**
+	* Sets the web search state.
+	*/
+	setWebSearch(isWebSearchEnabled: boolean): void;
+	/**
+	* Sets the reasoning state.
+	*/
+	setReasoning(isReasoningEnabled: boolean): void;
+	/**
+	* Populates the model selector with the given models.
+	*/
+	setModelList(models: Array<AIModelData>, hideModels: boolean): void;
+	/**
+	* Reflects the selected model in the selector and the capability buttons.
+	*/
+	setModel(model: AIModelData | null): void;
+	/**
+	* Enables the model selector dropdown.
+	*/
+	enableModelSelector(): void;
+	/**
+	* Disables the model selector dropdown, optionally hiding it entirely.
+	*/
+	disableModelSelector(hideSelector: boolean): void;
 }
+/**
+* Creates the shared model selector configured for AI Chat: chat-specific CSS classes, per-model
+* capability rendering, and the "disabled" tooltip shown once the model can no longer be changed.
+*/
+export declare function createChatModelSelector(locale: Locale): AIModelSelectorView;
 export type AIChatUIToggleWebSearchEvent = {
-    name: 'toggleWebSearch';
-    args: [];
+	name: "toggleWebSearch";
+	args: [];
 };
 export type AIChatUIToggleReasoningEvent = {
-    name: 'toggleReasoning';
-    args: [];
+	name: "toggleReasoning";
+	args: [];
 };
 export type AIChatUISelectModelEvent = {
-    name: 'selectModel';
-    args: [model: AIModelData];
+	name: "selectModel";
+	args: [model: AIModelData];
 };