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

package/dist/aicore/pipeline/airesponseparser.d.ts

@@ -1,27 +1,28 @@
 /**
- * @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
- */
-import { type Document } from '../utils/htmlparser.js';
-declare const AIResponseParser_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Observable;
-    prototype: import("@ckeditor/ckeditor5-utils").Observable;
-};
+* @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
+*/
 /**
- * An utility for parsing AI responses.
- *
- * It can handle markdown and HTML content. The main purpose of this class is to clean-up
- * the HTML content for further processing.
- */
-export declare class AIResponseParser extends /* #__PURE__ -- @preserve */ AIResponseParser_base {
-    constructor();
-    /**
-     * Converts the given Markdown string to HTML. During conversion HTML is sanitized and normalized.
-     */
-    convertMarkdownToHTML(markdown: string): Document;
-    /**
-     * Parses, sanitizes and normalizes given HTML string.
-     */
-    parseAndNormalizeHTML(html: string): Document;
+* @module ai/aicore/pipeline/airesponseparser
+*/
+import { type ObservableMixinConstructor } from "@ckeditor/ckeditor5-utils";
+import { type Document } from "../utils/htmlparser.js";
+declare const AIResponseParserBase: ObservableMixinConstructor;
+/**
+* An utility for parsing AI responses.
+*
+* It can handle markdown and HTML content. The main purpose of this class is to clean-up
+* the HTML content for further processing.
+*/
+export declare class AIResponseParser extends AIResponseParserBase {
+	constructor();
+	/**
+	* Converts the given Markdown string to HTML. During conversion HTML is sanitized and normalized.
+	*/
+	convertMarkdownToHTML(markdown: string): Document;
+	/**
+	* Parses, sanitizes and normalizes given HTML string.
+	*/
+	parseAndNormalizeHTML(html: string): Document;
 }
 export {};

package/dist/aicore/ui/aidisclaimerview.d.ts

@@ -1,18 +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
- */
+* @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/aicore/ui/aidisclaimerview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { View } from '@ckeditor/ckeditor5-ui';
-import '../../../theme/common/aidisclaimer.css';
+* @module ai/aicore/ui/aidisclaimerview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "@ckeditor/ckeditor5-ui";
 /**
- * The disclaimer view of the AI plugin.
- *
- * It displays information about the AI, such as a reminder to double-check responses.
- */
+* The disclaimer view of the AI plugin.
+*
+* It displays information about the AI, such as a reminder to double-check responses.
+*/
 export declare class AIDisclaimerView extends View {
-    constructor(locale: Locale);
+	constructor(locale: Locale);
 }

package/dist/aicore/ui/aidotsloader.d.ts

@@ -0,0 +1,18 @@
+/**
+* @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/aicore/ui/aidotsloader
+*/
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+/**
+* The view that displays a loading indicator built of pulsing dots.
+*/
+export declare class AIDotsLoaderView extends View {
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale?: Locale);
+}

package/dist/aicore/ui/aiheaderview.d.ts

@@ -1,32 +1,31 @@
 /**
- * @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/aicore/ui/aiheaderview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type ButtonView, FormHeaderView, type View } from '@ckeditor/ckeditor5-ui';
-import '../../../theme/common/aiheader.css';
+* @module ai/aicore/ui/aiheaderview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { type ButtonView, FormHeaderView, type View } from "@ckeditor/ckeditor5-ui";
 export declare class AIHeaderView extends FormHeaderView {
-    /**
-     * The button to resize the chat view.
-     */
-    readonly resizeButton?: ButtonView;
-    /**
-     * Indicates whether the resize button shows maximized state.
-     *
-     * @observable
-     */
-    isMaximized: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, options: {
-        label: string;
-        icon: string;
-        class: string;
-        content?: View;
-        showResizeButton: boolean;
-    });
+	/**
+	* The button to resize the chat view.
+	*/
+	readonly resizeButton?: ButtonView;
+	/**
+	* Indicates whether the resize button shows maximized state.
+	*
+	* @observable
+	*/
+	isMaximized: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, options: {
+		label: string;
+		icon: string;
+		class: string;
+		content?: View;
+		showResizeButton: boolean;
+	});
 }

package/dist/aicore/ui/aimodelselectorview.d.ts

@@ -0,0 +1,151 @@
+/**
+* @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/aicore/ui/aimodelselectorview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { ButtonLabelView, View, type DropdownView } from "@ckeditor/ckeditor5-ui";
+import { type AIModelData } from "../aiconnector.js";
+import { type AIModelDisplayMode } from "../utils/getmodeldisplaymode.js";
+/**
+* Per-feature configuration for the shared {@link module:ai/aicore/ui/aimodelselectorview~AIModelSelectorView}.
+*/
+export interface AIModelSelectorConfig {
+	/**
+	* The dropdown panel position (e.g. `'ne'` for AI Chat, `'se'` for AI Review).
+	*/
+	panelPosition: DropdownView["panelPosition"];
+	/**
+	* CSS class(es) for the dropdown.
+	*/
+	dropdownClass: string | Array<string>;
+	/**
+	* CSS class for the model-name label (shown when there is a single model).
+	*/
+	nameClass: string;
+	/**
+	* CSS classes for the dropdown item label parts.
+	*/
+	itemClasses: {
+		name: string;
+		description: string;
+		capabilities?: string;
+	};
+	/**
+	* The dropdown button label shown before a model is selected. Optional — features that immediately
+	* select a default model (e.g. AI Review) do not need it.
+	*/
+	defaultLabel?: string;
+	/**
+	* Optional tooltip shown on the dropdown button while the selector is disabled. When omitted, the
+	* active model name (the button label) is used as the tooltip regardless of the enabled state.
+	*/
+	disabledTooltip?: string;
+	/**
+	* Optional tooltip position for the dropdown button.
+	*/
+	tooltipPosition?: "s" | "n" | "e" | "w" | "sw" | "se" | "nw" | "ne";
+	/**
+	* When `true`, each dropdown item also renders the model's capabilities (web search, reasoning).
+	* Used by AI Chat; AI Review leaves it off.
+	*/
+	showCapabilities?: boolean;
+}
+/**
+* Fired when the user picks a model from the dropdown. Parents decide what to do with the selection
+* (the view does not update its own {@link module:ai/aicore/ui/aimodelselectorview~AIModelSelectorView#activeModelId}
+* optimistically — call {@link module:ai/aicore/ui/aimodelselectorview~AIModelSelectorView#setSelectedModel} to reflect it).
+*/
+export type AIModelSelectorSelectEvent = {
+	name: "selectModel";
+	args: [model: AIModelData];
+};
+/**
+* A shared model-selector: a dropdown of available models plus a single-model name label, with the
+* display-mode / active-model state. Used by AI Chat and AI Review; per-feature differences (CSS,
+* default label, chat's capability rendering) are injected via {@link ~AIModelSelectorConfig}.
+*/
+export declare class AIModelSelectorView extends View {
+	/**
+	* How the selector is presented: `'selector'` (dropdown), `'name'` (single model), or `'hidden'`.
+	*
+	* @observable
+	*/
+	modelDisplayMode: AIModelDisplayMode;
+	/**
+	* The id of the currently active model (drives the dropdown item highlight).
+	*
+	* @observable
+	*/
+	activeModelId: string | null;
+	/**
+	* The name of the currently active model (shown in `'name'` display mode).
+	*
+	* @observable
+	*/
+	activeModelName: string | null;
+	/**
+	* Whether the selector is enabled.
+	*
+	* @observable
+	*/
+	isEnabled: boolean;
+	/**
+	* The model-selection dropdown.
+	*/
+	readonly dropdownView: DropdownView;
+	/**
+	* The single-model name label.
+	*/
+	readonly nameView: ModelNameView;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, config: AIModelSelectorConfig);
+	/**
+	* Populates the dropdown with the given models and updates the display mode.
+	*/
+	setModels(models: Array<AIModelData>, showSelector: boolean): void;
+	/**
+	* Reflects the given model as the active selection (highlight, name, dropdown label). Passing `null`
+	* clears the active selection, which lets parents derive an "is a model available" state from
+	* {@link #activeModelId}.
+	*/
+	setSelectedModel(model: AIModelData | null): void;
+}
+/**
+* The single-model name label used by {@link module:ai/aicore/ui/aimodelselectorview~AIModelSelectorView}.
+*/
+export declare class ModelNameView extends View {
+	/**
+	* The text of the label.
+	*
+	* @observable
+	*/
+	text: string | undefined;
+	/**
+	* @observable
+	*/
+	isVisible: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, cssClass: string);
+}
+/**
+* The dropdown item label (model name + description, plus optional extra content such as capabilities)
+* used by {@link module:ai/aicore/ui/aimodelselectorview~AIModelSelectorView}.
+*/
+export declare class ModelButtonLabelView extends ButtonLabelView {
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, model: AIModelData, options: {
+		nameClass: string;
+		descriptionClass: string;
+		capabilitiesClass?: string;
+		extraContent?: Array<View>;
+	});
+}

package/dist/aicore/ui/aiseparatorview.d.ts

@@ -0,0 +1,25 @@
+/**
+* @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/aicore/ui/aiseparatorview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "@ckeditor/ckeditor5-ui";
+/**
+* A thin line separating groups of items in a toolbar or a header. The theme styles it through the class
+* it is created with.
+*/
+export declare class AISeparatorView extends View {
+	/**
+	* Whether the separator is displayed.
+	*
+	* @observable
+	*/
+	isVisible: boolean;
+	/**
+	* @param className The class the theme styles the separator with.
+	*/
+	constructor(locale: Locale | undefined, className: string);
+}

package/dist/aicore/ui/aiskeleton.d.ts

@@ -1,42 +1,53 @@
 /**
- * @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/aicore/ui/aiskeleton
- */
-import { View } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../../theme/common/aiskeleton.css';
+* @module ai/aicore/ui/aiskeleton
+*/
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
 export declare class AISkeletonView extends View {
-    /**
-     * Controls the visibility of the skeleton view.
-     */
-    isVisible: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale | undefined, skeletonItemsList: Array<SkeletonDefinition>);
+	/**
+	* Controls the visibility of the skeleton view.
+	*/
+	isVisible: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale | undefined, skeletonItemsList: Array<SkeletonDefinition>);
 }
 /**
- * The predefined skeleton definitions for the AI skeleton view.
- */
+* The predefined skeleton definitions for the AI skeleton view.
+*/
 export declare const SKELETON_DEFINITIONS: Record<string, Array<SkeletonDefinition>>;
-export type SkeletonDefinition = {
-    tag: string;
-    attributes: {
-        class?: string;
-        width: string;
-        height: string;
-        align: AlignOptions;
-    };
+/**
+* A single bar of a skeleton.
+*/
+export type SkeletonBarDefinition = {
+	tag: string;
+	attributes: {
+		class?: string;
+		width: string;
+		height: string;
+		align: AlignOptions;
+	};
+};
+/**
+* A row holding several bars. A row is a separate element, so it can carry its own padding and separator.
+*/
+export type SkeletonRowDefinition = {
+	tag: string;
+	children: Array<SkeletonBarDefinition>;
 };
+export type SkeletonDefinition = SkeletonBarDefinition | SkeletonRowDefinition;
 export type SkeletonItem = {
-    tag: string;
-    attributes: {
-        class: Array<string>;
-        style: string;
-    };
+	tag: string;
+	attributes: {
+		class: Array<string>;
+		style?: string;
+	};
+	children?: Array<SkeletonItem>;
 };
-type AlignOptions = 'left' | 'right' | 'center';
+type AlignOptions = "left" | "right" | "center";
 export {};

package/dist/aicore/ui/aispinner.d.ts

@@ -1,15 +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/aicore/ui/aispinner
- */
-import { SpinnerView } from '@ckeditor/ckeditor5-ui';
-import '../../../theme/common/aispinner.css';
+* @module ai/aicore/ui/aispinner
+*/
+import { SpinnerView } from "@ckeditor/ckeditor5-ui";
 export declare class AISpinnerView extends SpinnerView {
-    /**
-     * @inheritDoc
-     */
-    constructor(size?: 'small' | 'tiny' | undefined);
+	/**
+	* @inheritDoc
+	*/
+	constructor(size?: "small" | "tiny" | undefined);
 }

package/dist/aicore/ui/suggestioncontainer/aiminitoolbarview.d.ts

@@ -1,70 +1,69 @@
 /**
- * @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/aicore/ui/suggestioncontainer/aiminitoolbarview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { ToolbarView, type ViewCollection } from '@ckeditor/ckeditor5-ui';
-import '../../../../theme/aichat/aiminitoolbar.css';
+* @module ai/aicore/ui/suggestioncontainer/aiminitoolbarview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { ToolbarView, type ViewCollection } from "@ckeditor/ckeditor5-ui";
 /**
- * Configuration interface for AIMiniToolbarView buttons.
- */
+* Configuration interface for AIMiniToolbarView buttons.
+*/
 export interface AIMiniToolbarConfig {
-    /**
-     * Whether to show the copy button.
-     */
-    showCopy?: boolean;
-    /**
-     * Configuration for the show changes button. If undefined, the button won't be shown.
-     */
-    showChanges?: 'icon' | 'full';
-    /**
-     * Whether to show the like button.
-     */
-    showLike?: boolean;
-    /**
-     * Whether to show the dislike button.
-     */
-    showDislike?: boolean;
-    /**
-     * Custom views to add to the toolbar as the last items.
-     */
-    customView?: ViewCollection;
+	/**
+	* Whether to show the copy button.
+	*/
+	showCopy?: boolean;
+	/**
+	* Configuration for the show changes button. If undefined, the button won't be shown.
+	*/
+	showChanges?: "icon" | "full";
+	/**
+	* Whether to show the like button.
+	*/
+	showLike?: boolean;
+	/**
+	* Whether to show the dislike button.
+	*/
+	showDislike?: boolean;
+	/**
+	* Custom views to add to the toolbar as the last items.
+	*/
+	customView?: ViewCollection;
 }
 /**
- * A view for the mini toolbar in the AI suggestion preview.
- *
- * It hosts the copy, like and dislike buttons.
- */
+* A view for the mini toolbar in the AI suggestion preview.
+*
+* It hosts the copy, like and dislike buttons.
+*/
 export declare class AIMiniToolbarView extends ToolbarView {
-    /**
-     * Observable property that indicates whether the toolbar buttons are interactive.
-     */
-    isEnabled: boolean;
-    /**
-     * Observable property that indicates whether the show changes button is on.
-     */
-    isShowChangesOn: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, config?: AIMiniToolbarConfig);
-    /**
-     * Toggles the enabled state of the show changes button.
-     */
-    toggleShowChangesEnabled(isEnabled: boolean): void;
+	/**
+	* Observable property that indicates whether the toolbar buttons are interactive.
+	*/
+	isEnabled: boolean;
+	/**
+	* Observable property that indicates whether the show changes button is on.
+	*/
+	isShowChangesOn: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, config?: AIMiniToolbarConfig);
+	/**
+	* Toggles the enabled state of the show changes button.
+	*/
+	toggleShowChangesEnabled(isEnabled: boolean): void;
 }
 export type AIMiniToolbarLikeEvent = {
-    name: 'like';
-    args: [];
+	name: "like";
+	args: [];
 };
 export type AIMiniToolbarDislikeEvent = {
-    name: 'dislike';
-    args: [];
+	name: "dislike";
+	args: [];
 };
 export type AIMiniToolbarToggleShowChangesEvent = {
-    name: 'toggleShowChanges';
-    args: [];
+	name: "toggleShowChanges";
+	args: [];
 };