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

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

@@ -1,85 +1,100 @@
 /**
- * @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/aisuggestionbodyview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type BodyCollection, View } from '@ckeditor/ckeditor5-ui';
-import { AISuggestionBodyViewContentPartView } from './aisuggestioncontentpartview.js';
-import { type AISuggestionContentPartDefinition } from '../../utils/getsuggestionpartsfromreply.js';
-import { type AISuggestionActionName } from '../../../aichat/ui/feed/aichatfeedsuggestionitemactionsview.js';
-import { type AIReplyChangeGroupState } from '../../model/aireply.js';
-import { type AISource } from '../../aiconnector.js';
+* @module ai/aicore/ui/suggestioncontainer/aisuggestionbodyview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { type BodyCollection, View } from "@ckeditor/ckeditor5-ui";
+import { AISuggestionBodyViewContentPartView } from "./aisuggestioncontentpartview.js";
+import { type AISuggestionContentPartDefinition } from "../../utils/getsuggestionpartsfromreply.js";
+import { type AISuggestionActionName } from "../../utils/replyactions.js";
+import { type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../../model/aireply.js";
+import { type AISource } from "../../aiconnector.js";
 /**
- * The inner view of the suggestion container that displays the content of the suggestion (or multiple parts of it).
- */
+* A read-only gating state for one suggestion reply: per-part (by change-group index) read-only flags and
+* whether "apply/suggest all" is currently enabled. Computed by the controller, applied by the views.
+*/
+export type AISuggestionGating = {
+	readOnlyByIndex: Map<number, boolean>;
+	isAcceptAllEnabled: boolean;
+};
+/**
+* The inner view of the suggestion container that displays the content of the suggestion (or multiple parts of it).
+*/
 export declare class AISuggestionBodyView extends View<HTMLDivElement> {
-    /**
-     * Observable property that indicates whether the suggestion body has pending parts.
-     *
-     * This flag affects the interactivity of the {@link #actionsView} buttons.
-     */
-    hasPendingParts: boolean;
-    /**
-     * Observable property that indicates whether the track changes are on.
-     */
-    isTrackChangesOn: boolean;
-    constructor(locale: Locale, options: {
-        areActionsDisabled: boolean;
-        showUnchangedParts: boolean;
-        availableActions: Array<AISuggestionActionName>;
-        bodyCollection: BodyCollection;
-    });
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Gets the number of content parts in the suggestion.
-     */
-    get partsCount(): number;
-    /**
-     * Updates the content parts of the suggestion.
-     */
-    updateContentParts({ parts, abortSignal, skipLoadingEffects }: {
-        parts: Array<AISuggestionContentPartDefinition>;
-        abortSignal?: AbortSignal;
-        /**
-         * When `true`, all loading-state UI (skeleton, debounce timers) is bypassed and content
-         * parts are inserted immediately. Use for content that is already complete and should
-         * appear without any progressive-reveal delay (e.g. conversation history replays).
-         */
-        skipLoadingEffects?: boolean;
-    }): Promise<void>;
-    /**
-     * Updates the state of a content part by its index.
-     */
-    updatePartState(index: number, state: AIReplyChangeGroupState): void;
-    /**
-     * Sets the part active or not (active parts are those currently previewed in a dialog by the user).
-     *
-     * Passing `false` as the first argument deactivates all parts.
-     */
-    setPartActive(isActive: false): void;
-    setPartActive(index: number, isActive: boolean): void;
-    /**
-     * Displays and updates the web sources of the suggestion.
-     */
-    updateSources(sources: Array<AISource>): void;
-    /**
-     * Gets the view of a content part by its index.
-     */
-    getPartView(index: number): AISuggestionBodyViewContentPartView | null;
-    /**
-     * Marks the body view as done.
-     *
-     * Updates the visibility of the empty parts warning that will show up if some parts in the suggestion are empty.
-     */
-    markAsDone(): void;
-    /**
-     * Specifies whether among the displayed parts there are any that have any content that can be browsed or accepted.
-     */
-    get hasNonEmptyParts(): boolean;
+	/**
+	* The observable that "apply/suggest all" action binds to.
+	*
+	* @observable
+	*/
+	isAcceptAllEnabled: boolean;
+	/**
+	* Observable property that indicates whether the track changes are on.
+	*/
+	isTrackChangesOn: boolean;
+	constructor(locale: Locale, options: {
+		areActionsDisabled: boolean;
+		showUnchangedParts: boolean;
+		availableActions: Array<AISuggestionActionName>;
+		bodyCollection: BodyCollection;
+	});
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Gets the number of content parts in the suggestion.
+	*/
+	get partsCount(): number;
+	/**
+	* Updates the content parts of the suggestion.
+	*/
+	updateContentParts({ parts, abortSignal, skipLoadingEffects }: {
+		parts: Array<AISuggestionContentPartDefinition>;
+		abortSignal?: AbortSignal;
+		/**
+		* When `true`, all loading-state UI (skeleton, debounce timers) is bypassed and content
+		* parts are inserted immediately. Use for content that is already complete and should
+		* appear without any progressive-reveal delay (e.g. conversation history replays).
+		*/
+		skipLoadingEffects?: boolean;
+	}): Promise<void>;
+	/**
+	* Updates the state of a content part by its index.
+	*/
+	updatePartState(index: number, state: AIReplyChangeGroupState, outdatedReason?: AIReplyChangeGroupOutdatedReason): void;
+	/**
+	* Applies the gating state.
+	*
+	* Sets each existing part view's read-only flag and the "apply/suggest all" enablement.
+	* Parts still streaming pick up the read-only flag on creation.
+	*/
+	setGating({ readOnlyByIndex, isAcceptAllEnabled }: AISuggestionGating): void;
+	/**
+	* Sets the part active or not (active parts are those currently previewed in a dialog by the user).
+	*
+	* Passing `false` as the first argument deactivates all parts.
+	*/
+	setPartActive(isActive: false): void;
+	setPartActive(index: number, isActive: boolean): void;
+	/**
+	* Displays and updates the web sources of the suggestion.
+	*/
+	updateSources(sources: Array<AISource>): void;
+	/**
+	* Gets the view of a content part by its index.
+	*/
+	getPartView(index: number): AISuggestionBodyViewContentPartView | null;
+	/**
+	* Marks the body view as done.
+	*
+	* Updates the visibility of the empty parts warning that will show up if some parts in the suggestion are empty.
+	*/
+	markAsDone(): void;
+	/**
+	* Specifies whether among the displayed parts there are any that have any content that can be browsed or accepted.
+	*/
+	get hasNonEmptyParts(): boolean;
 }

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

@@ -1,55 +1,54 @@
 /**
- * @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/aisuggestioncontainerview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { View, type BodyCollection } from '@ckeditor/ckeditor5-ui';
-import { type AISuggestionContentPartDefinition } from '../../utils/getsuggestionpartsfromreply.js';
-import { type AISource } from '../../aiconnector.js';
-import { type AISuggestionActionName } from '../../../aichat/ui/feed/aichatfeedsuggestionitemactionsview.js';
-import '../../../../theme/aichat/aisuggestioncontainer.css';
+* @module ai/aicore/ui/suggestioncontainer/aisuggestioncontainerview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { View, type BodyCollection } from "@ckeditor/ckeditor5-ui";
+import { type AISuggestionContentPartDefinition } from "../../utils/getsuggestionpartsfromreply.js";
+import { type AISource } from "../../aiconnector.js";
+import { type AISuggestionActionName } from "../../utils/replyactions.js";
 /**
- * This view displays a suggestion from the AI.
- *
- * It comes with a header with a switch button to show/hide the changes.
- *
- * It also has a body view and a changes views that are toggled by the toggle button.
- */
+* This view displays a suggestion from the AI.
+*
+* It comes with a header with a switch button to show/hide the changes.
+*
+* It also has a body view and a changes views that are toggled by the toggle button.
+*/
 export declare class AISuggestionContainerView extends View<HTMLDivElement> {
-    /**
-     * Observable property that indicates whether the track changes feature is on.
-     */
-    isTrackChangesOn: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, options: AISuggestionContainerViewOptions, bodyCollection: BodyCollection);
-    updateContent(options: {
-        parts: Array<AISuggestionContentPartDefinition>;
-        abortSignal?: AbortSignal;
-        skipLoadingEffects?: boolean;
-    }): Promise<void>;
-    /**
-     * Updates the web sources of the suggestion.
-     */
-    updateSources(sources: Array<AISource>): void;
-    /**
-     * Marks the suggestion container as done.
-     */
-    markAsDone(): void;
+	/**
+	* Observable property that indicates whether the track changes feature is on.
+	*/
+	isTrackChangesOn: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, options: AISuggestionContainerViewOptions, bodyCollection: BodyCollection);
+	updateContent(options: {
+		parts: Array<AISuggestionContentPartDefinition>;
+		abortSignal?: AbortSignal;
+		skipLoadingEffects?: boolean;
+	}): Promise<void>;
+	/**
+	* Updates the web sources of the suggestion.
+	*/
+	updateSources(sources: Array<AISource>): void;
+	/**
+	* Marks the suggestion container as done.
+	*/
+	markAsDone(): void;
 }
 export type AISuggestionContainerToggleSuggestionDisplayModeEvent = {
-    name: 'toggleSuggestionDisplayMode';
-    args: [{
-        showDiff: boolean;
-    }];
+	name: "toggleSuggestionDisplayMode";
+	args: [{
+		showDiff: boolean;
+	}];
 };
 export type AISuggestionContainerViewOptions = {
-    showDiff: boolean;
-    areActionsDisabled: boolean;
-    availableActions: Array<AISuggestionActionName>;
-    showUnchangedParts?: boolean;
+	showDiff: boolean;
+	areActionsDisabled: boolean;
+	availableActions: Array<AISuggestionActionName>;
+	showUnchangedParts?: boolean;
 };

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

@@ -1,42 +1,72 @@
 /**
- * @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/aisuggestioncontentpartheaderview
- */
-import { View } from '@ckeditor/ckeditor5-ui';
-import { type AISuggestionActionName } from '../../../aichat/ui/feed/aichatfeedsuggestionitemactionsview.js';
-import { type AISuggestionContentPartDefinition } from '../../utils/getsuggestionpartsfromreply.js';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { AISuggestionContentPartToolbarView } from './aisuggestioncontentparttoolbarview.js';
-import { type AIReplyChangeGroupState } from '../../model/aireply.js';
+* @module ai/aicore/ui/suggestioncontainer/aisuggestioncontentpartheaderview
+*/
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type AISuggestionActionName } from "../../utils/replyactions.js";
+import { type AISuggestionContentPartTranslationKeys } from "../../utils/contentparttranslationkeys.js";
+import { type AISuggestionContentPartDefinition } from "../../utils/getsuggestionpartsfromreply.js";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { AISuggestionContentPartToolbarView } from "./aisuggestioncontentparttoolbarview.js";
+import { type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../../model/aireply.js";
 /**
- * A view that displays the header of a single part in the suggestion content.
- *
- * Includes:
- * * The toolbar,
- * * The title label,
- * * The state view.
- */
+* A view that displays the header of a single part in the suggestion content.
+*
+* Includes:
+* * The toolbar,
+* * The title label,
+* * The state view.
+*/
 export declare class AISuggestionContentPartHeaderView extends View<HTMLDivElement> {
-    /**
-     * The state of the content part (pending, accepted, rejected, etc.). It is reflected in the {@link #stateView} view.
-     */
-    state: AIReplyChangeGroupState;
-    /**
-     * Controls whether the content part is enabled, which means that it can be interacted with. It affects the interactivity
-     * of the {@link #toolbarView} buttons.
-     */
-    isEnabled: boolean;
-    /**
-     * The view that displays the toolbar for the content part ("Apply", "Suggest", "Reject").
-     */
-    toolbarView: AISuggestionContentPartToolbarView;
-    constructor(locale: Locale, { part, uiIndex, availableActions, areActionsDisabled }: {
-        part: AISuggestionContentPartDefinition;
-        uiIndex: number;
-        availableActions: Array<AISuggestionActionName>;
-        areActionsDisabled?: boolean;
-    });
+	/**
+	* The state of the content part (pending, accepted, rejected, etc.). It is reflected in the {@link #stateView} view.
+	*/
+	state: AIReplyChangeGroupState;
+	/**
+	* For the `'outdated'` {@link #state}, the reason that selects the {@link #stateView} pill's tooltip.
+	*/
+	outdatedReason: AIReplyChangeGroupOutdatedReason | undefined;
+	/**
+	* Controls whether the content part is enabled, which means that it can be interacted with. It affects the interactivity
+	* of the {@link #toolbarView} buttons.
+	*/
+	isEnabled: boolean;
+	/**
+	* The view that displays the toolbar for the content part ("Apply", "Suggest", "Reject").
+	*/
+	toolbarView: AISuggestionContentPartToolbarView;
+	/**
+	* Observable property that indicates whether the track changes feature is on.
+	*/
+	isTrackChangesOn: boolean;
+	/**
+	* Whether the target editor is read-only. Forwarded to the toolbar to disable the write actions (apply,
+	* suggest) while keeping the reject action available.
+	*
+	* @observable
+	*/
+	isTargetReadOnly: boolean;
+	/**
+	* Whether the apply action may be offered for this part. Forwarded to the toolbar, which combines it with
+	* `isTrackChangesOn`.
+	*
+	* @observable
+	*/
+	isApplyVisible: boolean;
+	/**
+	* Whether the suggest action may be offered for this part. Forwarded to the toolbar.
+	*
+	* @observable
+	*/
+	isSuggestVisible: boolean;
+	constructor(locale: Locale, { part, uiIndex, availableActions, areActionsDisabled, translationKeys }: {
+		part: AISuggestionContentPartDefinition;
+		uiIndex: number;
+		availableActions: Array<AISuggestionActionName>;
+		areActionsDisabled?: boolean;
+		translationKeys?: AISuggestionContentPartTranslationKeys;
+	});
 }

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

@@ -1,36 +1,26 @@
 /**
- * @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/aisuggestioncontentpartstateview
- */
-import { IconView, View } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../../../theme/common/aisuggestioncontentpartstate.css';
-export declare const ICON_STATE_MAP: {
-    readonly accepted: string;
-    readonly rejected: string;
-    readonly outdated: string;
-};
+* @module ai/aicore/ui/suggestioncontainer/aisuggestioncontentpartstateview
+*/
+import { View } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { type AIReplyChangeGroupOutdatedReason } from "../../model/aireply.js";
+import { type AISuggestionContentPartTranslationKeys } from "../../utils/contentparttranslationkeys.js";
+export type AISuggestionContentPartState = "accepted" | "rejected" | "outdated";
+export declare const ICON_STATE_MAP: Record<AISuggestionContentPartState, string>;
 /**
- * A view that displays the state of a single part in the suggestion content.
- */
+* A view that displays the state of a single part in the suggestion content.
+*/
 export declare class AISuggestionContentPartStateView extends View {
-    state: keyof typeof ICON_STATE_MAP;
-    isVisible: boolean;
-    constructor(locale: Locale);
-    /**
-     * Sets the state of the view.
-     */
-    setState(state: keyof typeof ICON_STATE_MAP): void;
-}
-/**
- * A view that displays the icon of the state of a single part in the suggestion content.
- *
- * It automatically updates the icon content based on the state.
- */
-export declare class StateIconView extends IconView {
-    state: keyof typeof ICON_STATE_MAP;
-    constructor();
+	state: AISuggestionContentPartState;
+	outdatedReason: AIReplyChangeGroupOutdatedReason | undefined;
+	isVisible: boolean;
+	constructor(locale: Locale, translationKeys?: AISuggestionContentPartTranslationKeys);
+	/**
+	* Sets the state of the view.
+	*/
+	setState(state: keyof typeof ICON_STATE_MAP, outdatedReason?: AIReplyChangeGroupOutdatedReason): void;
 }

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

@@ -1,26 +1,51 @@
 /**
- * @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/aisuggestioncontentparttoolbarview
- */
-import { ToolbarView } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type AISuggestionActionName } from '../../../aichat/ui/feed/aichatfeedsuggestionitemactionsview.js';
-import '../../../../theme/common/aisuggestioncontentparttoolbar.css';
+* @module ai/aicore/ui/suggestioncontainer/aisuggestioncontentparttoolbarview
+*/
+import { ToolbarView } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { type AISuggestionActionName } from "../../utils/replyactions.js";
+import { type AISuggestionContentPartTranslationKeys } from "../../utils/contentparttranslationkeys.js";
 /**
- * A toolbar view with actions for a specific suggestion: delete, insert, apply.
- */
+* A toolbar view with actions for a specific suggestion: delete, insert, apply.
+*/
 export declare class AISuggestionContentPartToolbarView extends ToolbarView {
-    isEnabled: boolean;
-    isVisible: boolean;
-    constructor(locale: Locale, availableActions: Array<AISuggestionActionName>, areActionsDisabled?: boolean);
-    /**
-     * Toggles the visibility of the apply and suggest buttons.
-     */
-    setButtonsVisibility({ showApplyButton, showSuggestButton }: {
-        showApplyButton: boolean;
-        showSuggestButton: boolean;
-    }): void;
+	isEnabled: boolean;
+	isVisible: boolean;
+	/**
+	* Observable property that indicates whether the track changes feature is on.
+	*/
+	isTrackChangesOn: boolean;
+	/**
+	* Whether the target editor is read-only. Disables the write actions (apply, suggest), but not reject.
+	*
+	* @observable
+	*/
+	isTargetReadOnly: boolean;
+	/**
+	* Whether the apply action may be offered at all. Combined with `isTrackChangesOn`, which hides apply
+	* on its own. Surfaces that decide per suggestion (AI Review gates on each change's own editor) set this;
+	* the chat feed leaves it `true` and relies on `isTrackChangesOn` alone.
+	*
+	* @observable
+	*/
+	isApplyVisible: boolean;
+	/**
+	* Whether the suggest action may be offered at all. Set by surfaces that decide per suggestion; left `true`
+	* by the chat feed, where the presence of the action is already decided by `availableActions`.
+	*
+	* @observable
+	*/
+	isSuggestVisible: boolean;
+	constructor(locale: Locale, availableActions: Array<AISuggestionActionName>, areActionsDisabled?: boolean, translationKeys?: AISuggestionContentPartTranslationKeys);
+	/**
+	* Toggles the visibility of the apply and suggest buttons.
+	*/
+	setButtonsVisibility({ showApplyButton, showSuggestButton }: {
+		showApplyButton: boolean;
+		showSuggestButton: boolean;
+	}): void;
 }