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

package/dist/aireviewcore/ui/aireviewcoreuicheckresultsview.d.ts

@@ -1,100 +1,127 @@
 /**
- * @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/ui/aireviewcoreuicheckresultsview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { ListItemView, ViewCollection } from '@ckeditor/ckeditor5-ui';
-import { type AIReviewCheckResultChange } from '../model/aireviewcheckresultchange.js';
-import { AIDisclaimerView } from '../../aicore/ui/aidisclaimerview.js';
-import { AIReviewCoreReviewCheckListItemResultsView } from './aireviewcorechecklistitemresultview.js';
-import '../../../theme/aireviewcore/aireviewcore-check-run.css';
-import '../../../theme/aireviewcore/aireviewcore-check-run-result.css';
+* @module ai/aireviewcore/ui/aireviewcoreuicheckresultsview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { ListItemView, ViewCollection } from "@ckeditor/ckeditor5-ui";
+import { type AIReviewCheckResultChange } from "../model/aireviewcheckresultchange.js";
+import { AIDisclaimerView } from "../../aicore/ui/aidisclaimerview.js";
 export type AIReviewCoreUICheckResultsViewContents = {
-    generalErrorText: string;
+	generalErrorText: string;
 };
 export declare class AIReviewCoreUICheckResultsView extends ListItemView {
-    /**
-     * The disclaimer view shown below the results.
-     */
-    reviewDisclaimer: AIDisclaimerView;
-    /**
-     * The title of the current check results.
-     *
-     * @observable
-     */
-    headerTitle: string;
-    /**
-     * The subtitle of the current check results.
-     *
-     * @observable
-     */
-    headerSubtitle: string;
-    /**
-     * The loading state of the controls.
-     *
-     * @observable
-     */
-    isLoading: boolean;
-    /**
-     * The toggle diff state of the controls.
-     *
-     * @observable
-     */
-    isToggleDiffOn: boolean;
-    /**
-     * Indicates whether the review is completed.
-     *
-     * @observable
-     */
-    isCompleted: boolean;
-    /**
-     * Indicates whether the results are ready and can be interacted with.
-     *
-     * @observable
-     */
-    isResultReady: boolean;
-    isError: boolean;
-    showErrorMessage: boolean;
-    errorType: 'chunk' | 'general' | undefined;
-    constructor(locale: Locale, contents: AIReviewCoreUICheckResultsViewContents);
-    clearResults(): void;
-    getResults(): ViewCollection<AIReviewCoreReviewCheckListItemResultsView>;
-    addResult(result: {
-        contentDiffed: string;
-        id: string;
-    }): void;
-    hideResult(id: string, status: AIReviewCheckResultChange['status']): void;
-    showResult(id: string, status: AIReviewCheckResultChange['status']): void;
-    /**
-     * Sets the title of the current check results.
-     *
-     * @param title The title to set in the header.
-     */
-    setTitle(title: string, subtitle?: string): void;
-    showChunkErrorMessage(): void;
-    showGeneralErrorMessage(): void;
-    resetErrorState(): void;
+	/**
+	* The disclaimer view shown below the results.
+	*/
+	reviewDisclaimer: AIDisclaimerView;
+	/**
+	* The title of the current check results.
+	*
+	* @observable
+	*/
+	headerTitle: string;
+	/**
+	* The subtitle of the current check results.
+	*
+	* @observable
+	*/
+	headerSubtitle: string;
+	/**
+	* The loading state of the controls.
+	*
+	* @observable
+	*/
+	isLoading: boolean;
+	/**
+	* Indicates whether the review is completed.
+	*
+	* @observable
+	*/
+	isCompleted: boolean;
+	/**
+	* Indicates whether the results are ready and can be interacted with.
+	*
+	* @observable
+	*/
+	isResultReady: boolean;
+	isError: boolean;
+	showErrorMessage: boolean;
+	errorType: "chunk" | "general" | "unsupported-inline" | undefined;
+	/**
+	* Whether there are pending (unreviewed) changes — pushed by the controller. Combined with the panel's own
+	* error state, this gates both the Accept All and Reject All bulk actions in the Complete review dropdown.
+	*
+	* @observable
+	*/
+	hasPendingChanges: boolean;
+	/**
+	* @observable
+	*/
+	isAnyResultReviewed: boolean;
+	constructor(locale: Locale, contents: AIReviewCoreUICheckResultsViewContents);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	clearResults(): void;
+	/**
+	* Updates the header progress bar with the number of reviewed (accepted, rejected, outdated) changes out of the total.
+	*/
+	updateProgress(reviewed: number, total: number): void;
+	getResults(): ViewCollection;
+	/**
+	* Marks the result showing `id` as active.
+	*/
+	setActiveResult(id: string): void;
+	/**
+	* Marks every result as inactive.
+	*/
+	resetActiveResults(): void;
+	/**
+	* Scrolls the results so the one showing `id` starts at the top of the list.
+	*/
+	scrollToResult(id: string): void;
+	/**
+	* Returns the rendered element of the result showing `id`, the one {@link #scrollToResult} brings into view.
+	*/
+	getResultElement(id: string): HTMLElement | null;
+	addResult(result: AIReviewCheckResultChange, isAcceptButtonVisible: boolean, isSuggestButtonVisible: boolean): void;
+	/**
+	* Reflects the change status on the result showing `id`. Resolved changes (accepted, rejected, outdated) are
+	* grayed out and stop responding to interaction, while going back to `pending` restores the result.
+	*/
+	updateChangeState(id: string, status: AIReviewCheckResultChange["status"]): void;
+	/**
+	* Sets the title of the current check results.
+	*
+	* @param title The title to set in the header.
+	*/
+	setTitle(title: string, subtitle?: string): void;
+	showChunkErrorMessage(): void;
+	showUnsupportedInlineChangeMessage(): void;
+	showGeneralErrorMessage(): void;
+	resetErrorState(): void;
 }
 export type AIAbortReviewStreamEvent = {
-    name: 'abortReviewStream';
-    args: [];
+	name: "abortReviewStream";
+	args: [];
 };
 export type AILeaveReviewCoreResultListEvent = {
-    name: 'leaveReviewCoreResultList';
-    args: [];
+	name: "leaveReviewCoreResultList";
+	args: [];
 };
 export type AIAcceptAllChangesEvent = {
-    name: 'acceptAllChanges';
-    args: [];
+	name: "acceptAllChanges";
+	args: [];
 };
-export type AIToggleDiffEvent = {
-    name: 'toggleDiff';
-    args: [
-        {
-            on: boolean;
-        }
-    ];
+export type AIRejectAllChangesEvent = {
+	name: "rejectAllChanges";
+	args: [];
 };

package/dist/aireviewcore/ui/aireviewcoreview.d.ts

@@ -1,54 +1,58 @@
 /**
- * @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/ui/aireviewcoreview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { View, type FormHeaderView } from '@ckeditor/ckeditor5-ui';
-import { type AIReviewCoreReviewCheckListView } from './aireviewcorereviewchecklistview.js';
-import { type AIReviewCoreReviewCompletedView } from './aireviewcorereviewcompletedview.js';
-import { AIReviewCoreGeneralErrorView } from './aireviewcoregeneralerrorview.js';
-import { type AIReviewCoreUICheckResultsView } from './aireviewcoreuicheckresultsview.js';
+* @module ai/aireviewcore/ui/aireviewcoreview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type AIReviewCoreAbstractCheckListView } from "./aireviewcoreabstractchecklistview.js";
+import { type AIReviewCoreReviewCompletedView } from "./aireviewcorereviewcompletedview.js";
+import { AIReviewCoreGeneralErrorView } from "./aireviewcoregeneralerrorview.js";
+import { type AIReviewCoreUICheckResultsView } from "./aireviewcoreuicheckresultsview.js";
+import { type AIReviewCheckResultChange } from "../model/aireviewcheckresultchange.js";
+import { type AIHeaderView } from "../../aicore/ui/aiheaderview.js";
 export declare class AIReviewCoreView extends View {
-    /**
-     * The header of the AI Review Core.
-     */
-    reviewCoreHeader: FormHeaderView;
-    /**
-     * The general error view of the AI Review Core.
-     */
-    generalErrorView: AIReviewCoreGeneralErrorView;
-    /**
-     * The review check list view of the AI Review Core.
-     */
-    reviewCheckListView: AIReviewCoreReviewCheckListView;
-    /**
-     * The check run results view of the AI Review Core.
-     */
-    reviewCheckResultsView: AIReviewCoreUICheckResultsView;
-    /**
-     * The review completed view of the AI Review Core.
-     */
-    reviewCompletedView: AIReviewCoreReviewCompletedView;
-    constructor(locale: Locale, views: {
-        header: FormHeaderView;
-        list: AIReviewCoreReviewCheckListView;
-        results: AIReviewCoreUICheckResultsView;
-        completed: AIReviewCoreReviewCompletedView;
-    });
-    showReviewCheckListView(): void;
-    showReviewCheckResultsView(): void;
-    addCheckRunResult(result: {
-        contentDiffed: string;
-        id: string;
-    }): void;
-    showReviewCompletedView(): void;
-    showActionsWhenResultIsReady(): void;
-    showNoChangesView(): void;
-    hideActionsWhenResultIsReady(): void;
-    showGeneralReviewCoreErrorView(errorMessage: string): void;
-    showGeneralResultsErrorView(): void;
-    showChunkErrorView(): void;
+	/**
+	* The header of the AI Review Core.
+	*/
+	reviewCoreHeader: AIHeaderView;
+	/**
+	* The general error view of the AI Review Core.
+	*/
+	generalErrorView: AIReviewCoreGeneralErrorView;
+	/**
+	* The review check list view of the AI Review Core.
+	*/
+	reviewCheckListView: AIReviewCoreAbstractCheckListView;
+	/**
+	* The check run results view of the AI Review Core.
+	*/
+	reviewCheckResultsView: AIReviewCoreUICheckResultsView;
+	/**
+	* The review completed view of the AI Review Core.
+	*/
+	reviewCompletedView: AIReviewCoreReviewCompletedView;
+	constructor(locale: Locale, views: {
+		header: AIHeaderView;
+		list: AIReviewCoreAbstractCheckListView;
+		results: AIReviewCoreUICheckResultsView;
+		completed: AIReviewCoreReviewCompletedView;
+	});
+	/**
+	* Toggles the initial loading skeleton.
+	*/
+	toggleLoadingSkeleton(isLoading: boolean): void;
+	showReviewCheckListView(): void;
+	showReviewCheckResultsView(): void;
+	addCheckRunResult(result: AIReviewCheckResultChange, isAcceptButtonVisible: boolean, isSuggestButtonVisible: boolean): void;
+	showReviewCompletedView(): void;
+	showActionsWhenResultIsReady(): void;
+	showNoChangesView(): void;
+	hideActionsWhenResultIsReady(): void;
+	showGeneralReviewCoreErrorView(errorMessage: string): void;
+	showGeneralResultsErrorView(): void;
+	showChunkErrorView(): void;
+	showUnsupportedInlineChangeView(): void;
 }

package/dist/aireviewcore/ui/changeevents.d.ts

@@ -0,0 +1,49 @@
+/**
+* @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/ui/changeevents
+*/
+/**
+* The events a review results panel and the change navigation panel raise for the controllers.
+*
+* `source` is typed loosely because the panel renders changes differently per mode — AI Review uses the shared
+* suggestion content part, AI Translate the review tile — and no listener reads it.
+*/
+import { type View } from "@ckeditor/ckeditor5-ui";
+export type AIReviewCoreDeactivateChangeEventData = {
+	origin: "panel";
+	id: string;
+	source: View;
+};
+export type AIReviewCoreActivateChangeEvent = {
+	name: "activateChange";
+	args: [{
+		id: string;
+		source: View;
+		uiInteraction: "click" | "hover";
+	}];
+};
+export type AIReviewCoreDeactivateChangeEvent = {
+	name: "deactivateChange";
+	args: [AIReviewCoreDeactivateChangeEventData];
+};
+export type AIReviewCoreAcceptChangeEvent = {
+	name: "acceptChange";
+	args: [{
+		id: string;
+	}];
+};
+export type AIReviewCoreDismissChangeEvent = {
+	name: "dismissChange";
+	args: [{
+		id: string;
+	}];
+};
+export type AIReviewCoreSuggestChangeEvent = {
+	name: "suggestChange";
+	args: [{
+		changeId: string;
+	}];
+};

package/dist/aireviewcore/ui/form/aireviewcoreformdropdown.d.ts

@@ -1,20 +1,20 @@
 /**
- * @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/ui/form/aireviewcoreformdropdown
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { View } from '@ckeditor/ckeditor5-ui';
-import type { AIReviewCheckOptions } from '../../types.js';
+* @module ai/aireviewcore/ui/form/aireviewcoreformdropdown
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "@ckeditor/ckeditor5-ui";
+import type { AIReviewCheckOptions } from "../../types.js";
 export declare class AIReviewCoreFormDropdownView extends View {
-    /**
-     * The `value` of the currently selected option.
-     *
-     * @observable
-     */
-    formValue: string | null;
-    constructor(locale: Locale, options: AIReviewCheckOptions);
-    resetToDefault(): void;
+	/**
+	* The `value` of the currently selected option.
+	*
+	* @observable
+	*/
+	formValue: string | null;
+	constructor(locale: Locale, options: AIReviewCheckOptions);
+	resetToDefault(): void;
 }

package/dist/aireviewcore/ui/form/aireviewcoreformmanager.d.ts

@@ -1,16 +1,16 @@
 /**
- * @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/ui/form/aireviewcoreformmanager
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { type View, ListItemView } from '@ckeditor/ckeditor5-ui';
-import { type AIReviewCheckOptions } from '../../types.js';
+* @module ai/aireviewcore/ui/form/aireviewcoreformmanager
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { type View, ListItemView } from "@ckeditor/ckeditor5-ui";
+import { type AIReviewCheckOptions } from "../../types.js";
 export declare class AIReviewCoreFormManagerView extends ListItemView {
-    value: string;
-    argsKey: string | undefined;
-    constructor(locale: Locale, options: AIReviewCheckOptions, submitButton: View | null);
-    resetToDefault(): void;
+	value: string;
+	argsKey: string | undefined;
+	constructor(locale: Locale, options: AIReviewCheckOptions, submitButton: View | null);
+	resetToDefault(): void;
 }

package/dist/aireviewcore/utils/openleaveconfirmationdialog.d.ts

@@ -0,0 +1,21 @@
+/**
+* @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/utils/openleaveconfirmationdialog
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import { type AILeaveConfirmationOptions } from "../aireviewcoreui.js";
+import { type View } from "@ckeditor/ckeditor5-ui";
+/**
+* Opens the leave-confirmation dialog. Calls `onExit` if the user confirms leaving, or `onStay` once the
+* dialog is dismissed any other way (the stay button, the close button, or the <kbd>Esc</kbd> key).
+*
+* Goes through `AIEditorIntegration#dialog` rather than resolving `Dialog` directly: `Dialog` is a
+* `Plugin`, not a `ContextPlugin`, so a `ContextPlugin` caller can't declare it in `requires`
+* (`PluginCollection#checkContextPlugin()` throws `plugincollection-context-required` otherwise).
+* `AIEditorIntegration` already depends on `Dialog` directly and proxies it here. Degrades gracefully
+* (leave proceeds unconfirmed) for the unlikely case `AIEditorIntegration` isn't loaded on the focused editor.
+*/
+export declare function openLeaveConfirmationDialog(editor: Editor, options: AILeaveConfirmationOptions, contentView: View<HTMLElement>, onExit: () => void, onStay?: () => void): void;

package/dist/aireviewcore/utils/reviewcontentpart.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/aireviewcore/utils/reviewcontentpart
+*/
+import { type AISuggestionContentPartTranslationKeys } from "../../aicore/utils/contentparttranslationkeys.js";
+import { type AISuggestionContentPartDefinition } from "../../aicore/utils/getsuggestionpartsfromreply.js";
+import { type AIReviewCheckResultChange } from "../model/aireviewcheckresultchange.js";
+/**
+* AI Review's wording for the shared suggestion content part. The chat feed says "Change 1 / Apply change /
+* Reject change"; review says "Review 1 / Accept / Dismiss".
+*/
+export declare const AI_REVIEW_CONTENT_PART_TRANSLATION_KEYS: AISuggestionContentPartTranslationKeys;
+/**
+* Describes a review change as a suggestion content part, so the panel can render it with the same view the chat
+* feed uses.
+*
+* The diff arrives from the review pipeline as an HTML string, while the content part renders a parsed document;
+* parsing here also routes the markup through the part's own sanitization rather than a raw `innerHTML` write.
+*
+* @param index The part's index, assigned by the caller and mapped back to `AIReviewCheckResultChange#id`.
+*/
+export declare function createReviewContentPartDefinition(change: AIReviewCheckResultChange, index: number): AISuggestionContentPartDefinition;

package/dist/aireviewmode/aireviewcheckdefinitions.d.ts

@@ -1,16 +1,16 @@
 /**
- * @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/aireviewmode/aireviewcheckdefinitions
- */
-import { type AIReviewCheckDefinition } from '../aireviewcore/types.js';
+* @module ai/aireviewmode/aireviewcheckdefinitions
+*/
+import { type AIReviewCheckDefinition } from "../aireviewcore/types.js";
 /**
- * List of definitions of available review checks that can be performed in the AI Review Mode.
- *
- * IMPORTANT: Every time this list changes, the `availableCommands` property
- * in {@link module:ai/aireviewmode/aireviewmode~AIReviewModeConfig} and Review feature guide
- * should be updated accordingly.
- */
+* List of definitions of available review checks that can be performed in the AI Review Mode.
+*
+* IMPORTANT: Every time this list changes, the `availableCommands` property
+* in {@link module:ai/aireviewmode/aireviewmode~AIReviewModeConfig} and Review feature guide
+* should be updated accordingly.
+*/
 export declare const AI_REVIEW_CHECKS: Array<AIReviewCheckDefinition>;