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

package/dist/aiquickactions/ui/balloon/aiactionsballoonview.d.ts

@@ -1,147 +1,84 @@
 /**
- * @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/aiquickactions/ui/balloon/aiactionsballoonview
- */
-import { type ViewWithFocusCycler } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type AISuggestionActionName } from '../../../aichat/ui/feed/aichatfeedsuggestionitemactionsview.js';
-import { type AIMiniToolbarConfig } from '../../../aicore/ui/suggestioncontainer/aiminitoolbarview.js';
-import { type AIContentRenderingStrategy } from '../../../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js';
-import { type AISuggestionContentPartDefinition } from '../../../aicore/utils/getsuggestionpartsfromreply.js';
-import { AIBalloonView } from '../../../aiballoon/ui/aiballoonview.js';
-import '../../../../theme/aiquickactions/aiquickactionsballoon.css';
+* @module ai/aiquickactions/ui/balloon/aiactionsballoonview
+*/
+import { type ViewWithFocusCycler } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { AIBalloonView, type AIBalloonViewConfig } from "../../../aiballoon/ui/aiballoonview.js";
 /**
- * Event names that can be fired by the AI Balloon view.
- */
-export declare const AI_ACTIONS_BALLOON_VIEW_EVENT_NAMES: readonly ["applySuggestion", "insertSuggestion"];
-/**
- * Configuration object for creating AI Balloon content.
- */
-export interface AIActionsBalloonViewConfig {
-    showApplyButton: boolean;
-    showSuggestButton: boolean;
-    miniToolbarConfig: AIMiniToolbarConfig;
-    availableActions: Array<AISuggestionActionName>;
-}
-/**
- * The AI Actions Balloon view class responsible for creating and managing the balloon dialog UI.
- *
- * This view handles:
- * - Focus management and keyboard navigation
- * - Event firing for suggestion interactions
- * - Toolbar and disclaimer management
- */
+* The AI Quick Actions balloon view.
+*
+* On top of the content, disclaimer and toolbars provided by {@link module:ai/aiballoon/ui/aiballoonview~AIBalloonView}, it adds
+* focus management, the loading skeleton and the interaction navigation in the mini toolbar.
+*/
 export declare class AIActionsBalloonView extends AIBalloonView implements ViewWithFocusCycler {
-    /**
-     * Observable property that indicates whether the view is busy.
-     *
-     * It is set to `true` when there are AI response being streamed or rendered.
-     */
-    isBusy: boolean;
-    constructor(locale: Locale, config: AIActionsBalloonViewConfig);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the balloon view.
-     */
-    focus(direction?: 1 | -1): void;
-    /**
-     * Sets the view loading state, enabling or disabling all interactive elements.
-     */
-    setIsLoading(isLoading: boolean): void;
-    /**
-     * Disables specific buttons (show changes) for error state.
-     */
-    setErrorState(): void;
-    /**
-     * Re-enables specific buttons (show changes) after clearing error state.
-     */
-    clearErrorState(): void;
-    /**
-     * Shows an error message in the balloon.
-     */
-    showError(message: string): void;
-    /**
-     * Clears the error state, re-enabling the previously disabled buttons (apply, suggest, etc.).
-     */
-    hideError(): void;
-    /**
-     * Displays a blocking error message and disables the toolbar buttons.
-     */
-    showBlockingError(message: string): void;
-    /**
-     * Shows the loader if it exists.
-     */
-    showLoader(): void;
-    /**
-     * Hides the loader if it exists.
-     */
-    hideLoader(): void;
-    /**
-     * Updates the main content view of the balloon.
-     * This method replaces the current main view with a new one without recreating the entire balloon.
-     *
-     * @param options The content update options.
-     */
-    updateContent(options: {
-        part: AISuggestionContentPartDefinition;
-        renderingStrategy: AIContentRenderingStrategy;
-        abortSignal?: AbortSignal;
-    }): Promise<void>;
-    /**
-     * Clears the main content of the view.
-     */
-    clearContent(): void;
-    /**
-     * Starts auto-scrolling to the bottom during streaming.
-     */
-    startAutoScroll(): void;
-    /**
-     * Stops auto-scrolling.
-     */
-    stopAutoScroll(): void;
-    toggleIsLoading(isLoading: boolean): void;
-    /**
-     * Resets the show changes button to default state (off).
-     */
-    resetShowChangesButton(): void;
+	/**
+	* Observable property that indicates whether the view is busy.
+	*
+	* It is set to `true` while an AI response is being generated or rendered.
+	*/
+	isBusy: boolean;
+	constructor(locale: Locale, config: AIBalloonViewConfig);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Focuses the balloon view.
+	*
+	* Forward focus lands on the primary action button so that accepting the suggestion is one keystroke away
+	* once the balloon shows up.
+	*/
+	focus(direction?: 1 | -1): void;
+	/**
+	* Disables specific buttons (show changes) for error state.
+	*/
+	setErrorState(): void;
+	/**
+	* Re-enables specific buttons (show changes) after clearing error state.
+	*/
+	clearErrorState(): void;
+	/**
+	* Clears the error state, re-enabling the previously disabled buttons (apply, suggest, etc.).
+	*/
+	override hideError(): void;
+	/**
+	* Displays a blocking error message and disables the toolbar buttons.
+	*/
+	override showBlockingError(message: string): void;
+	/**
+	* Sets the view loading state. While loading, the skeleton covers the content and the interactive elements are disabled.
+	*/
+	setIsLoading(isLoading: boolean): void;
+	/**
+	* Cleans up the rendering artifacts (the `data-id` attributes carried over from the reply) once the content is rendered.
+	*/
+	finalizeContent(): void;
+	/**
+	* Sets the state of the show changes button.
+	*/
+	setShowChangesButton(isOn: boolean): void;
+	/**
+	* @inheritDoc
+	*/
+	override adjustWidthToEditable(domRoot: HTMLElement): void;
 }
 /**
- * Event fired when user clicks the apply button to apply a suggestion.
- */
-export type AIActionsBalloonApplySuggestionEvent = {
-    name: 'applySuggestion';
-    args: [];
-};
-/**
- * Event fired when user clicks the insert/suggest button to insert a suggestion.
- */
-export type AIActionsBalloonInsertSuggestionEvent = {
-    name: 'insertSuggestion';
-    args: [];
-};
-/**
- * Event fired when user clicks the try again button.
- */
+* Event fired when user clicks the try again button.
+*/
 export type AIActionsBalloonTryAgainEvent = {
-    name: 'tryAgain';
-    args: [];
+	name: "tryAgain";
+	args: [];
 };
 /**
- * Event fired when user toggles the suggestion display mode.
- */
+* Event fired when user toggles the suggestion display mode.
+*/
 export type AIActionsBalloonToggleSuggestionDisplayModeEvent = {
-    name: 'toggleSuggestionDisplayMode';
-    args: [{
-        showDiff: boolean;
-    }];
+	name: "toggleSuggestionDisplayMode";
+	args: [{
+		showDiff: boolean;
+	}];
 };

package/dist/aiquickactions/ui/dropdownmenubuttonwithhighlightview.d.ts

@@ -1,29 +1,29 @@
 /**
- * @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/aiquickactions/ui/dropdownmenubuttonwithhighlightview
- */
-import { IconView, type ButtonLabelWithHighlightView, ListItemButtonView } from '@ckeditor/ckeditor5-ui';
+* @module ai/aiquickactions/ui/dropdownmenubuttonwithhighlightview
+*/
+import { IconView, type ButtonLabelWithHighlightView, ListItemButtonView } from "@ckeditor/ckeditor5-ui";
 /**
- * A custom dropdown menu button view that supports text highlighting.
- * We need to bypass DropdownMenuButtonView's constructor and manually set up the button.
- */
+* A custom dropdown menu button view that supports text highlighting.
+* We need to bypass DropdownMenuButtonView's constructor and manually set up the button.
+*/
 export declare class DropdownMenuButtonWithHighlightView extends ListItemButtonView {
-    /**
-     * An icon that displays an arrow to indicate a direction of the menu.
-     */
-    readonly arrowView: IconView;
-    /**
-     * Creates an instance with highlighting support.
-     *
-     * @param locale The localization services instance.
-     * @param labelView The label view with highlighting support.
-     */
-    constructor(locale: any, labelView: ButtonLabelWithHighlightView);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
+	/**
+	* An icon that displays an arrow to indicate a direction of the menu.
+	*/
+	readonly arrowView: IconView;
+	/**
+	* Creates an instance with highlighting support.
+	*
+	* @param locale The localization services instance.
+	* @param labelView The label view with highlighting support.
+	*/
+	constructor(locale: any, labelView: ButtonLabelWithHighlightView);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
 }

package/dist/aireviewcore/aireviewcorecheckregistry.d.ts

@@ -0,0 +1,37 @@
+/**
+* @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/aireviewcore/aireviewcorecheckregistry
+*/
+import { ContextPlugin, type PluginDependencies } from "@ckeditor/ckeditor5-core";
+import type { AIReviewCheckList } from "./model/aireviewchecklist.js";
+/**
+* Base class for feature-specific check-list registries.
+*
+* Each feature (review mode, translate, …) ships a concrete subclass that knows how to build its own {@link AIReviewCheckList}.
+*/
+export declare abstract class AIReviewCoreCheckRegistry<T extends AIReviewCheckList> extends ContextPlugin {
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependencies;
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Returns the check list. The result is cached — subsequent calls return the same promise, so concurrent
+	* consumers (e.g. a controller + a headless gateway) share a single load.
+	*/
+	getChecksList(): Promise<T>;
+}

package/dist/aireviewcore/aireviewcorecontroller.d.ts

@@ -1,27 +1,52 @@
 /**
- * @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/aireviewcore/aireviewcorecontroller
- */
-import { ContextPlugin } from '@ckeditor/ckeditor5-core';
-import { AIConnector } from '../aicore/aiconnector.js';
+* @module ai/aireviewcore/aireviewcorecontroller
+*/
+import { ContextPlugin } from "@ckeditor/ckeditor5-core";
+import { type AIReviewCheck } from "./model/aireviewcheck.js";
+import { type AIReviewCheckRun } from "./model/aireviewcheckrun.js";
+import { type AIReviewCoreUIRunReviewCheckEvent } from "./ui/aireviewcorereviewcommandlistitemview.js";
 export declare abstract class AIReviewCoreController extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AIConnector];
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): Promise<void>;
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Runs the given review check on the currently loaded document and wires the check
+	* run into the UI (results panel, error views, balloons).
+	*
+	* This is the programmatic entry point used by {@link module:ai/aireviewmode/aireviewmode~AIReviewMode#startReview}
+	* and by the `runReviewCheck` UI event fired from the check list view — both paths end up here.
+	*
+	* Rejection of `data.id` (unknown check) is logged via `_logError` and the method returns without
+	* throwing, matching the original UI-event behavior. Stream errors surface via the existing UI
+	* error views; only unexpected apply-phase errors are thrown as `ai-review-mode-check-run-failed`.
+	*/
+	runCheck(data: AIReviewCoreUIRunReviewCheckEvent["args"][0]): Promise<void>;
+	/**
+	* Aborts the currently running review check, if any. No-op when no check is in flight.
+	*
+	* Called by the `abortReviewStream` UI event and by programmatic callers (e.g. the `AbortSignal`
+	* wiring in {@link module:ai/aireviewmode/aireviewmode~AIReviewMode#startReview}).
+	*/
+	abort(): void;
+	/**
+	* Exposes the list of review checks visible in the UI.
+	*/
+	getAvailableChecks(): ReadonlyArray<AIReviewCheck>;
+	/**
+	* Exposes the currently active review check run, if any.
+	*/
+	getCurrentCheckRun(): AIReviewCheckRun | undefined;
 }