@ckeditor/ckeditor5-ai 48.3.1 → 48.4.0-alpha.0

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

@@ -7,7 +7,6 @@
 */
 import { type Locale } from "@ckeditor/ckeditor5-utils";
 import { ButtonView } from "@ckeditor/ckeditor5-ui";
-import "../../../theme/aireviewcore/aireviewcore-review-completed.css";
 export declare class AIReviewCoreFinishReviewButtonView extends ButtonView {
 	constructor(buttonLabel: string, locale?: Locale);
 }

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

@@ -8,7 +8,6 @@
 import type { Locale } from "@ckeditor/ckeditor5-utils";
 import { ListItemView } from "@ckeditor/ckeditor5-ui";
 import type { AIReviewCheck } from "../model/aireviewcheck.js";
-import "../../../theme/aireviewcore/aireviewcore-check-list.css";
 export declare class AIReviewCoreReviewCheckListView extends ListItemView {
 	constructor(locale: Locale);
 	/**

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

@@ -7,7 +7,6 @@
 */
 import { type Locale } from "@ckeditor/ckeditor5-utils";
 import { ListItemView } from "@ckeditor/ckeditor5-ui";
-import "../../../theme/aireviewcore/aireviewcore-review-completed.css";
 export type AIReviewCoreReviewCompletedViewContents = {
 	headerText: string;
 	emptyResultsText: string;

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

@@ -10,9 +10,6 @@ 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";
-import "../../../theme/aireviewcore/aireviewcore-review-completed.css";
 export type AIReviewCoreUICheckResultsViewContents = {
 	generalErrorText: string;
 };
@@ -59,14 +56,17 @@ export declare class AIReviewCoreUICheckResultsView extends ListItemView {
 	isResultReady: boolean;
 	isError: boolean;
 	showErrorMessage: boolean;
-	errorType: "chunk" | "general" | undefined;
+	errorType: "chunk" | "general" | "unsupported-inline" | undefined;
+	/**
+	* Whether "accept all" is enabled — pushed by the controller. Combined with the panel's own error state.
+	*
+	* @observable
+	*/
+	isAcceptAllEnabled: boolean;
 	constructor(locale: Locale, contents: AIReviewCoreUICheckResultsViewContents);
 	clearResults(): void;
 	getResults(): ViewCollection<AIReviewCoreReviewCheckListItemResultsView>;
-	addResult(result: {
-		contentDiffed: string;
-		id: string;
-	}): void;
+	addResult(result: AIReviewCheckResultChange): void;
 	hideResult(id: string, status: AIReviewCheckResultChange["status"]): void;
 	showResult(id: string, status: AIReviewCheckResultChange["status"]): void;
 	/**
@@ -76,8 +76,10 @@ export declare class AIReviewCoreUICheckResultsView extends ListItemView {
 	*/
 	setTitle(title: string, subtitle?: string): void;
 	showChunkErrorMessage(): void;
+	showUnsupportedInlineChangeMessage(): void;
 	showGeneralErrorMessage(): void;
 	resetErrorState(): void;
+	setAcceptAllEnabled(isEnabled: boolean): void;
 }
 export type AIAbortReviewStreamEvent = {
 	name: "abortReviewStream";

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

@@ -11,6 +11,7 @@ import { type AIReviewCoreReviewCheckListView } from "./aireviewcorereviewcheckl
 import { type AIReviewCoreReviewCompletedView } from "./aireviewcorereviewcompletedview.js";
 import { AIReviewCoreGeneralErrorView } from "./aireviewcoregeneralerrorview.js";
 import { type AIReviewCoreUICheckResultsView } from "./aireviewcoreuicheckresultsview.js";
+import { type AIReviewCheckResultChange } from "../model/aireviewcheckresultchange.js";
 export declare class AIReviewCoreView extends View {
 	/**
 	* The header of the AI Review Core.
@@ -40,10 +41,7 @@ export declare class AIReviewCoreView extends View {
 	});
 	showReviewCheckListView(): void;
 	showReviewCheckResultsView(): void;
-	addCheckRunResult(result: {
-		contentDiffed: string;
-		id: string;
-	}): void;
+	addCheckRunResult(result: AIReviewCheckResultChange): void;
 	showReviewCompletedView(): void;
 	showActionsWhenResultIsReady(): void;
 	showNoChangesView(): void;
@@ -51,4 +49,5 @@ export declare class AIReviewCoreView extends View {
 	showGeneralReviewCoreErrorView(errorMessage: string): void;
 	showGeneralResultsErrorView(): void;
 	showChunkErrorView(): void;
+	showUnsupportedInlineChangeView(): void;
 }

package/dist/aireviewmode/aireviewgateway.d.ts

@@ -7,12 +7,16 @@
 * @publicApi
 */
 import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
-import { AIConnector, type AIModelData } from "../aicore/aiconnector.js";
+import { AIConnector } from "../aicore/aiconnector.js";
 import { AIReviewCoreEditing } from "../aireviewcore/aireviewcoreediting.js";
 import { AIReviewModeCheckRegistry } from "./aireviewmodecheckregistry.js";
 import { AIEditing } from "../aicore/aiediting.js";
-import { AIReviewRunResult } from "./model/aireviewrunresult.js";
-import { AIGateway, type AIRunBaseOptions, type AIRunApplyMethod } from "../aicore/aigateway.js";
+import { type AIRunResult } from "../aicore/model/airunresult.js";
+import { type AICheckRunSingleRootResult } from "../aireviewcore/model/aichecksinglerootresult.js";
+import { AIGateway, type AIRunBaseOptions, type AIGatewayApplyOptions } from "../aicore/aigateway.js";
+import { AICore } from "../aicore/aicore.js";
+import { type AIModels } from "../aicore/model/aimodels.js";
+import { type AIEditorRoot } from "../aicore/model/aieditorroot.js";
 /**
 * Review command data.
 */
@@ -30,7 +34,7 @@ export interface AIReviewCommandData {
 	*/
 	description: string;
 	/**
-	* Selectable parameters for parameterized commands (e.g. `length`, `tone`). One of these ids can be
+	* Selectable parameters for parameterized commands (e.g. `length`, `tone`). One of these IDs can be
 	* passed as `options.parameterId` when invoking the command.
 	*/
 	parameters?: Array<{
@@ -38,17 +42,31 @@ export interface AIReviewCommandData {
 		label: string;
 	}>;
 }
-export type AIReviewRunOptions = {
+/**
+* Roots filter shared by both `AIReviewRunOptions` and `AIReviewCustomRunOptions`.
+*/
+export type AIReviewRootsOption = {
+	/**
+	* The roots to run the review against. When omitted, every visible root across every editor in the current
+	* {@link module:core/context~Context `Context`} is reviewed. When provided, only the listed roots are reviewed;
+	* the order of entries in `roots` is treated as a set-membership filter and does not affect the payload order.
+	*
+	* Each entry's `channelId` must match an editor's `collaboration.channelId`; `rootName` must match a live,
+	* visible (non-`$graveyard`) root within that editor.
+	*/
+	roots?: Array<AIEditorRoot>;
+};
+export type AIReviewRunOptions = AIReviewRootsOption & {
 	/**
 	* Id of one of the values in {@link module:ai/aireviewmode/aireviewgateway~AIReviewCommandData#parameters}.
 	* Applicable to parameterized commands (e.g. `length`, `tone`), ignored otherwise.
 	*/
 	parameterId?: string;
 };
-export type AIReviewCustomRunOptions = {
+export type AIReviewCustomRunOptions = AIReviewRootsOption & {
 	/**
 	* The model that will be used to run the custom command.
-	* The ids of an AI models can be acquired via {@link module:ai/aireviewmode/aireviewgateway~AIReviewGateway#getAvailableModels} call.
+	* The IDs of an AI models can be acquired via {@link module:ai/aicore/model/aimodels~AIModels#getAvailableModels}.
 	*/
 	model?: string;
 };
@@ -68,7 +86,16 @@ export declare class AIReviewGateway extends ContextPlugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIReviewCoreEditing, AIReviewModeCheckRegistry, AIConnector, AIEditing, AIGateway]>;
+	static get requires(): PluginDependenciesOf<[AIReviewCoreEditing, AIReviewModeCheckRegistry, AIConnector, AIEditing, AIGateway, AICore]>;
+	/**
+	* The shared model registry. Exposed here so headless gateways are self-sufficient — integrators can
+	* discover and resolve models (`getAvailableModels()`, `getModel()`, `resolveModel()`, …) without
+	* reaching for the `AICore` plugin directly.
+	*
+	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
+	* without the standard deprecation policy. Check the changelog for migration guidance.
+	*/
+	get models(): AIModels;
 	/**
 	* @inheritDoc
 	*/
@@ -92,62 +119,54 @@ export declare class AIReviewGateway extends ContextPlugin {
 	*/
 	getAllCommands(): Promise<Array<AIReviewCommandData>>;
 	/**
-	* Returns the list of AI models that the built-in `custom` review command can be run against.
-	*
-	* The returned model ids are valid values to supply as `options.model` when invoking the `custom`
-	* command. Built-in system command and additionally configured commands do not accept a model override — system
-	* checks always run against their default backend configuration, and extras use the model declared in their
-	* {@link module:ai/aireviewmode/aireviewmode~AIReviewModeConfig#extraCommands `ai.review.extraCommands`} entry.
-	*
-	* This is a convenience proxy to the {@link module:ai/aicore/aigateway~AIGateway#getAvailableModels} method.
-	*
-	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
-	* without the standard deprecation policy. Check the changelog for migration guidance.
-	*/
-	getAvailableModels(): Promise<Array<AIModelData>>;
-	/**
-	* Runs the given review command and returns
-	* the {@link module:ai/aireviewmode/model/aireviewrunresult~AIReviewRunResult detailed result}.
+	* Runs the given review command against every visible root across every editor in the current
+	* {@link module:core/context~Context `Context`} and returns an
+	* {@link module:ai/aicore/model/airunresult~AIRunResult} — a container with one
+	* {@link module:ai/aireviewcore/model/aichecksinglerootresult~AICheckRunSingleRootResult} per root and whole-run
+	* `status` / `error`. Accepts built-in commands and extra commands configured via
+	* {@link module:ai/aireviewmode/aireviewmode~AIReviewModeConfig#extraCommands `ai.review.extraCommands`}.
 	*
-	* The result can then be processed in various ways. To insert or suggest changes directly
-	* to the editor use {@link #applyReview}. Accepts built-in commands and extra commands configured
-	* via {@link module:ai/aireviewmode/aireviewmode~AIReviewModeConfig#extraCommands `ai.review.extraCommands`}
+	* To insert or suggest changes back to the editor, pass the returned result to {@link #applyReview}.
 	*
-	* The returned {@link module:ai/aireviewmode/model/aireviewrunresult~AIReviewRunResult} always resolves — transport, parsing
-	* and merge failures are surfaced via `status: 'error'` plus the `error` field, not thrown. Aborts (via `options.signal`)
-	* are reported as `status: 'aborted'`.
+	* When the `roots` option is provided, its entries are validated at the call boundary; an entry that does not
+	* resolve to a live, visible (non-`$graveyard`) root throws `ai-reviewcoreediting-root-not-found`, and an
+	* explicitly empty `roots` array throws `ai-reviewcoreediting-empty-roots`.
 	*
 	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
 	* without the standard deprecation policy. Check the changelog for migration guidance.
 	* @param commandId Id of a command returned by {@link #getAllCommands}.
-	* @param options Optional `parameterId` (selected from the command's `parameters`) and `signal` to allow aborting the run.
+	* @param options Optional `parameterId`, `roots` filter, and `signal` to allow aborting the run.
 	*/
-	runReview(commandId: string, options?: AIReviewHeadlessRunOptions): Promise<AIReviewRunResult>;
+	runReview(commandId: string, options?: AIReviewHeadlessRunOptions): Promise<AIRunResult<AICheckRunSingleRootResult>>;
 	/**
-	* Runs the `custom` review command and returns
-	* the {@link module:ai/aireviewmode/model/aireviewrunresult~AIReviewRunResult detailed result}.
+	* Runs the `custom` review command against every visible root across every editor in the current
+	* {@link module:core/context~Context `Context`} and returns an
+	* {@link module:ai/aicore/model/airunresult~AIRunResult}.
 	*
-	* The command requires a prompt to run, and optional model id. The list of available models
-	* can be discovered via {@link #getAvailableModels}.
+	* The command requires a prompt to run, and optional model ID. The list of available models can be discovered
+	* via {@link module:ai/aicore/model/aimodels~AIModels#getAvailableModels}.
 	*
 	* Analogical to {@link #runReview} but restricted to the `custom` command only.
 	*
 	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
 	* without the standard deprecation policy. Check the changelog for migration guidance.
 	* @param prompt The prompt to run the `custom` command with.
-	* @param options Optional `model` (optional override), plus optional `signal` to allow aborting the run.
+	* @param options Optional `model` (optional override), `roots` filter, and `signal` to allow aborting the run.
 	*/
-	runCustomReview(prompt: string, options?: AIReviewHeadlessCustomRunOptions): Promise<AIReviewRunResult>;
+	runCustomReview(prompt: string, options?: AIReviewHeadlessCustomRunOptions): Promise<AIRunResult<AICheckRunSingleRootResult>>;
 	/**
-	* Applies the review run result (produced by {@link #runReview} or {@link #runCustomReview}) to the editor content, either
-	* as direct changes or as track changes suggestions.
+	* Applies a review run result (produced by {@link #runReview} or {@link #runCustomReview}) to the editor content,
+	* either as direct changes or as track-changes suggestions. Each per-root sub-result is applied to the root
+	* identified by its own `channelId` and `rootName`. Pass `options.roots` to restrict the apply to a subset of
+	* roots — the filter is symmetric with the one accepted by {@link #runReview} / {@link #runCustomReview}.
 	*
-	* This is a proxy to the {@link module:ai/aicore/aigateway~AIGateway#apply} method.
+	* By default the apply is stamped with `aiSource: 'review'`; pass `options.aiSource` to override.
 	*
 	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
 	* without the standard deprecation policy. Check the changelog for migration guidance.
-	* @param result The result of a completed AI review run.
-	* @param applyMethod Method of applying the review suggestions to the editor content.
+	* @param result The result returned by {@link #runReview} or {@link #runCustomReview}.
+	* @param options Apply options forwarded to {@link module:ai/aicore/aigateway~AIGateway#apply}, including the
+	* `applyMethod` and an optional `roots` filter.
 	*/
-	applyReview(result: AIReviewRunResult, applyMethod: AIRunApplyMethod): void;
+	applyReview(result: AIRunResult<AICheckRunSingleRootResult>, options: AIGatewayApplyOptions): void;
 }

package/dist/aireviewmode/aireviewmode.d.ts

@@ -11,6 +11,7 @@ import { AIReviewModeUI } from "./aireviewmodeui.js";
 import { AIReviewCoreEditing } from "../aireviewcore/aireviewcoreediting.js";
 import { AIReviewModeController } from "./aireviewmodecontroller.js";
 import { type AIReviewCommandData, type AIReviewCustomRunOptions, AIReviewGateway, type AIReviewRunOptions } from "./aireviewgateway.js";
+import { type AIContextRef } from "../aicore/model/aicontextref.js";
 /**
 * The AI Review Mode feature.
 *
@@ -43,7 +44,7 @@ export declare class AIReviewMode extends ContextPlugin {
 	* the full UI-driven flow.
 	*
 	* Preconditions:
-	* - The command must be available in the UI. Not available commands or unknown ids throw `ai-reviewmode-unknown-command`.
+	* - The command must be available in the UI. Not available commands or unknown IDs throw `ai-reviewmode-unknown-command`.
 	* - The `commandId` must point at a built-in system command or an extra command configured via
 	* {@link module:ai/aireviewmode/aireviewmode~AIReviewModeConfig#extraCommands `ai.review.extraCommands`}.
 	* The built-in `custom` command throws `ai-reviewmode-not-a-system-command`. Use {@link #startCustomReview} instead
@@ -68,8 +69,8 @@ export declare class AIReviewMode extends ContextPlugin {
 	* Preconditions:
 	* - The `custom` command must be available in the UI. If not, the method throws `ai-reviewmode-unknown-command`.
 	* - A model must be resolvable from `options.model` or the command's default. Otherwise the method throws
-	* `ai-reviewmode-missing-custom-command-model`. Use {@link module:ai/aireviewmode/aireviewgateway~AIReviewGateway#getAvailableModels}
-	* for valid model ids.
+	* `ai-reviewmode-missing-custom-command-model`. Use {@link module:ai/aicore/model/aimodels~AIModels#getAvailableModels}
+	* for valid model IDs.
 	*
 	* The returned promise resolves once the review run is dispatched to the controller. The command itself
 	* continues to run asynchronously and the UI reflects its progress. Stream-phase failures surface via
@@ -79,7 +80,7 @@ export declare class AIReviewMode extends ContextPlugin {
 	* without the standard deprecation policy. Check the changelog for migration guidance.
 	* @param prompt The prompt to run the `custom` command with.
 	* @param options Optional `model` to run command with this specific model, instead of the default one.
-	* Use {@link module:ai/aireviewmode/aireviewgateway~AIReviewGateway#getAvailableModels} for valid model ids.
+	* Use {@link module:ai/aicore/model/aimodels~AIModels#getAvailableModels} for valid model IDs.
 	*/
 	startCustomReview(prompt: string, options?: AIReviewCustomRunOptions): Promise<void>;
 	/**
@@ -153,6 +154,12 @@ export interface AIReviewModeConfig {
 	* 						description: 'Expand abbreviations in the document.',
 	* 						prompt: 'Suggest expansions for abbreviations in the document.',
 	* 						model: 'gpt-5-2' // Optional, if not set, default model will be used.
+	* 					},
+	* 					{
+	* 						id: 'style-guide',
+	* 						label: 'Style Guide',
+	* 						description: 'Check the document against the style guide.',
+	* 						context: { id: 'style-guide', promptId: 'review-rules' }
 	* 					}
 	* 				]
 	* 			}
@@ -184,10 +191,71 @@ export interface AIReviewModeConfig {
 	*/
 	extraCommands?: Array<AIReviewCustomCommand>;
 }
+/**
+* An extra review command definition.
+*
+* The command needs a prompt source, provided in one of three ways:
+*
+* * an inline `prompt` string - sent as the prompt,
+* * a `context` reference - the referenced context drives the command (for example through a prompt it contains),
+* * both - the inline `prompt` is used and the `context` is attached as additional reference material (for example a file).
+*
+* The `model` property is optional. If not specified, the default model is used.
+*
+* ```ts
+* {
+*	id: 'improve-captions',
+*	label: 'Improve Captions',
+*	description: 'Improve image captions in the document.',
+*	prompt: 'Suggest improvements for the image captions in the document.'
+* }
+* ```
+*
+* The same command using a `context` reference instead of an inline `prompt`:
+*
+* ```ts
+* {
+*	id: 'improve-captions',
+*	label: 'Improve Captions',
+*	description: 'Improve image captions in the document.',
+*	context: { id: 'style-guide', promptId: 'improve-captions' }
+* }
+* ```
+*
+* An inline `prompt` combined with a `context` that attaches a single file as reference material:
+*
+* ```ts
+* {
+*	id: 'improve-captions',
+*	label: 'Improve Captions',
+*	description: 'Improve image captions in the document.',
+*	prompt: 'Suggest improvements for the image captions in the document.',
+*	context: { id: 'style-guide', fileId: 'caption-examples' }
+* }
+* ```
+*/
 export type AIReviewCustomCommand = {
 	id: string;
 	label: string;
 	description: string;
-	prompt: string;
 	model?: string;
+	/**
+	* The prompt to be sent to the AI model when the command is executed.
+	*
+	* At least one prompt source is required: an inline `prompt`, a `context` that carries a prompt (a whole context
+	* or a `promptId` reference), or both. A `context` that references only a single file (`fileId`) cannot drive the
+	* command on its own and must be combined with an inline `prompt`.
+	*/
+	readonly prompt?: string;
+	/**
+	* A context reference attached to the command.
+	*
+	* When no inline `prompt` is provided, the referenced context drives the command (a whole context or a `promptId`
+	* reference). When combined with an inline `prompt`, it is attached as additional reference material (for example
+	* a single file).
+	*
+	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
+	* without the standard deprecation policy. Check the changelog for migration guidance.
+	*/
+	readonly context?: AIContextRef;
 };

package/dist/aireviewmode/aireviewmodecheckregistry.d.ts

@@ -5,8 +5,11 @@
 /**
 * @module ai/aireviewmode/aireviewmodecheckregistry
 */
-import { type Context, type Editor } from "@ckeditor/ckeditor5-core";
+import { type Context, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
 import { CKEditorError } from "@ckeditor/ckeditor5-utils";
+import { AICore } from "../aicore/aicore.js";
+import { AIConnector } from "../aicore/aiconnector.js";
+import { AIErrorSink } from "../aicore/aierrorreporter.js";
 import { AIReviewCoreCheckRegistry } from "../aireviewcore/aireviewcorecheckregistry.js";
 import { type AIReviewCheckExtraDefinition } from "../aireviewcore/types.js";
 import { AIReviewModeCheckList } from "./model/aireviewmodechecklist.js";
@@ -25,6 +28,10 @@ export declare class AIReviewModeCheckRegistry extends AIReviewCoreCheckRegistry
 	/**
 	* @inheritDoc
 	*/
+	static override get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, AICore]>;
+	/**
+	* @inheritDoc
+	*/
 	constructor(context: Context | Editor);
 	/**
 	* The error captured during the last models fetch, or `null` if the fetch succeeded

package/dist/aireviewmode/aireviewmodecontroller.d.ts

@@ -4,6 +4,7 @@
 */
 import { AIReviewCoreController } from "../aireviewcore/aireviewcorecontroller.js";
 import { AIErrorSink } from "../aicore/aierrorreporter.js";
+import { AICore } from "../aicore/aicore.js";
 import { AIReviewModeCheckRegistry } from "./aireviewmodecheckregistry.js";
 import type { PluginDependenciesOf, Context, Editor } from "@ckeditor/ckeditor5-core";
 export declare class AIReviewModeController extends AIReviewCoreController {
@@ -14,7 +15,7 @@ export declare class AIReviewModeController extends AIReviewCoreController {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIErrorSink, AIReviewModeCheckRegistry]>;
+	static get requires(): PluginDependenciesOf<[AIErrorSink, AIReviewModeCheckRegistry, AICore]>;
 	/**
 	* @inheritDoc
 	*/

package/dist/aireviewmode/model/aireviewcheckextra.d.ts

@@ -7,6 +7,7 @@
 */
 import { type AIReviewCheckExtraDefinition } from "../../aireviewcore/types.js";
 import { type AIModelData } from "../../aicore/aiconnector.js";
+import { type AIContextRef } from "../../aicore/model/aicontextref.js";
 import { AIReviewCheck } from "../../aireviewcore/model/aireviewcheck.js";
 /**
 * Represents the extra check that can be added via
@@ -20,9 +21,13 @@ export declare class AIReviewCheckExtra extends AIReviewCheck {
 	*/
 	isExtra: boolean;
 	/**
-	* The prompt text for this extra check run.
+	* The prompt text for this extra check run. Not set when the check references a prompt through {@link #context}.
 	*/
-	prompt: string;
+	prompt: string | undefined;
+	/**
+	* The context reference used instead of an inline {@link #prompt}.
+	*/
+	context: AIContextRef | undefined;
 	/**
 	* The model for this extra check run.
 	*/

package/dist/aireviewmode/model/aireviewcustomcheckrun.d.ts

@@ -9,12 +9,13 @@ import { AIReviewCheckRun } from "../../aireviewcore/model/aireviewcheckrun.js";
 import { type AIConnector } from "../../aicore/aiconnector.js";
 import { type AIDocumentData } from "../../aireviewcore/aireviewcoreediting.js";
 import { type AIReviewCheck } from "../../aireviewcore/model/aireviewcheck.js";
+import { type AIContextRef } from "../../aicore/model/aicontextref.js";
 /**
 * Represents a single custom review check
 * ({@link module:ai/aireviewmode/model/aireviewcheckcustom~AIReviewCheckCustom}) run and its results.
 */
 export declare class AIReviewCustomCheckRun extends AIReviewCheckRun {
-	constructor(prompt: string, model: string, documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector);
+	constructor(prompt: string | undefined, model: string, documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, contexts?: Array<AIContextRef>);
 	/**
 	* @inheritDoc
 	*/

package/dist/aitabs/aitabsmainview.d.ts

@@ -8,7 +8,6 @@
 */
 import type { Locale } from "@ckeditor/ckeditor5-utils";
 import { AITabsView, type AITabsViewOptions } from "./tabs/aitabsview.js";
-import "../../theme/aitabs/aitabsview.css";
 /**
 * The supported types of the `AITabsView`.
 */

package/dist/aitabs/tabs/aitabsview.d.ts

@@ -10,7 +10,6 @@ import { View, type ViewCollection } from "@ckeditor/ckeditor5-ui";
 import { type ArrayOrItem, type Locale } from "@ckeditor/ckeditor5-utils";
 import { TabButtonView } from "./tabbuttonview.js";
 import { TabPanelView } from "./tabpanelview.js";
-import "../../../theme/aitabs/tabs/tabsview.css";
 export declare const AI_TABS_POSITIONS: readonly ["top", "left", "right"];
 /**
 * A view component that manages the tabs and their panels.

package/dist/aitabs/tabs/tabbuttonview.d.ts

@@ -8,7 +8,6 @@
 import { ButtonView } from "@ckeditor/ckeditor5-ui";
 import { type ArrayOrItem, type Locale } from "@ckeditor/ckeditor5-utils";
 import type { AI_TABS_POSITIONS } from "./aitabsview.js";
-import "../../../theme/aitabs/tabs/tabbuttonview.css";
 /**
 * A button that toggles the visibility of a tab in the tabs view component.
 */

package/dist/aitranslate/aitranslatecontroller.d.ts

@@ -6,6 +6,7 @@
 * @module ai/aitranslate/aitranslatecontroller
 */
 import { AIReviewCoreController } from "../aireviewcore/aireviewcorecontroller.js";
+import { AICore } from "../aicore/aicore.js";
 import { AIErrorSink } from "../aicore/aierrorreporter.js";
 import { AITranslateCheckRegistry } from "./aitranslatecheckregistry.js";
 import type { PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
@@ -17,5 +18,5 @@ export declare class AITranslateController extends AIReviewCoreController {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIErrorSink, AITranslateCheckRegistry]>;
+	static get requires(): PluginDependenciesOf<[AIErrorSink, AITranslateCheckRegistry, AICore]>;
 }

package/dist/aitranslate/aitranslategateway.d.ts

@@ -9,14 +9,21 @@
 import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
 import { AIConnector } from "../aicore/aiconnector.js";
 import { AIReviewCoreEditing } from "../aireviewcore/aireviewcoreediting.js";
-import { AITranslateRunResult } from "./model/aitranslaterunresult.js";
+import type { AIRunResult } from "../aicore/model/airunresult.js";
+import type { AICheckRunSingleRootResult } from "../aireviewcore/model/aichecksinglerootresult.js";
 import { AIEditing } from "../aicore/aiediting.js";
-import { AIGateway, type AIGatewayApplyOptions } from "../aicore/aigateway.js";
-export type AITranslateRunOptions = {
+import { AIGateway, type AIGatewayApplyOptions, type AIRunBaseOptions } from "../aicore/aigateway.js";
+import { type AIEditorRoot } from "../aicore/model/aieditorroot.js";
+export type AITranslateRunOptions = AIRunBaseOptions & {
 	/**
-	* An `AbortSignal` that cancels the run when aborted. Aborted runs resolve with `status: 'aborted'`.
+	* The roots to translate. When omitted, every non-`$graveyard` root across every editor in the current
+	* `Context` is translated. When provided, only the listed roots are translated; the order of entries in
+	* `roots` is treated as a set-membership filter and does not affect the payload order.
+	*
+	* Each entry's `channelId` must match an editor's `collaboration.channelId`; `rootName` must match a
+	* non-`$graveyard` root within that editor.
 	*/
-	signal?: AbortSignal;
+	roots?: Array<AIEditorRoot>;
 };
 /**
 * Headless, stateless public API for running AI translations end-to-end.
@@ -42,15 +49,20 @@ export declare class AITranslateGateway extends ContextPlugin {
 	*/
 	static override get isPremiumPlugin(): true;
 	/**
-	* Translates the editor content into the given language and returns
-	* the {@link module:ai/aitranslate/model/aitranslaterunresult~AITranslateRunResult detailed result}.
+	* Translates every non-`$graveyard` root across every editor in the current `Context` into the given language and
+	* returns one {@link module:ai/aireviewcore/model/aichecksinglerootresult~AICheckRunSingleRootResult result} per root. Each
+	* result carries its own `channelId` and `rootName`, identifying the editor/root it belongs to.
 	*
-	* The result can then be processed in various ways. To insert or suggest changes directly
-	* to the editor use {@link #applyTranslate}.
+	* Each per-root result can then be processed independently. To insert or suggest changes back to the editor,
+	* pass the full array (or any caller-filtered subset) to {@link #applyTranslate}.
 	*
-	* The returned {@link module:ai/aitranslate/model/aitranslaterunresult~AITranslateRunResult} always resolves —
+	* Each per-root {@link module:ai/aireviewcore/model/aichecksinglerootresult~AICheckRunSingleRootResult} always resolves —
 	* transport, parsing and merge failures are surfaced via `status: 'error'` plus the `error` field, not thrown.
-	* Aborts (via `options.signal`) are reported as `status: 'aborted'`.
+	* Aborts (via `options.signal`) are reported as `status: 'aborted'` on every per-root entry.
+	*
+	* When the `roots` option is provided, its entries are validated at the call boundary. An entry that does not
+	* resolve to a live, non-`$graveyard` root throws `ai-reviewcoreediting-root-not-found`; an empty `roots` array
+	* throws `ai-reviewcoreediting-empty-roots`.
 	*
 	* The target language is not restricted to a predefined list and is forwarded to the translate endpoint as-is.
 	* See the {@glink features/ai/ckeditor-ai-translate#supported-languages supported languages} guide.
@@ -58,20 +70,20 @@ export declare class AITranslateGateway extends ContextPlugin {
 	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
 	* without the standard deprecation policy. Check the changelog for migration guidance.
 	* @param language The target language to translate the content into.
-	* @param options Optional `signal` to allow aborting the run.
+	* @param options Optional `roots` filter and `signal` to allow aborting the run.
 	*/
-	runTranslate(language: string, options?: AITranslateRunOptions): Promise<AITranslateRunResult>;
+	runTranslate(language: string, options?: AITranslateRunOptions): Promise<AIRunResult<AICheckRunSingleRootResult>>;
 	/**
-	* Applies the translate run result (produced by {@link #runTranslate}) to the editor content, either
-	* as direct changes or as track changes suggestions.
-	*
-	* This is a proxy to the {@link module:ai/aicore/aigateway~AIGateway#apply} method.
+	* Applies a translate run result (produced by {@link #runTranslate}) to the editor content, either as direct
+	* changes or as track-changes suggestions. Each per-root sub-result is applied to the root identified by its own
+	* `channelId` and `rootName`. Pass `options.roots` to restrict the apply to a subset of roots — the filter is
+	* symmetric with the one accepted by {@link #runTranslate}.
 	*
 	* @experimental **Experimental:** This is a production-ready API but may change in minor releases
 	* without the standard deprecation policy. Check the changelog for migration guidance.
-	* @param result The result of a completed AI translate run.
-	* @param options Apply options forwarded to {@link module:ai/aicore/aigateway~AIGateway#apply} (for example the
-	* `applyMethod`).
+	* @param result The result returned by {@link #runTranslate}.
+	* @param options Apply options forwarded to {@link module:ai/aicore/aigateway~AIGateway#apply}, including the
+	* `applyMethod` and an optional `roots` filter.
 	*/
-	applyTranslate(result: AITranslateRunResult, options: AIGatewayApplyOptions): void;
+	applyTranslate(result: AIRunResult<AICheckRunSingleRootResult>, options: AIGatewayApplyOptions): void;
 }

package/dist/aitranslate/aitranslateui.d.ts

@@ -4,7 +4,6 @@
 */
 import { AIReviewCoreUI } from "../aireviewcore/aireviewcoreui.js";
 import { AIReviewCoreView } from "../aireviewcore/ui/aireviewcoreview.js";
-import "../../theme/aitranslate/aitranslate.css";
 export declare class AITranslateUI extends AIReviewCoreUI {
 	/**
 	* @inheritDoc

package/dist/aitranslate/model/aitranslatecheckrun.d.ts

@@ -9,6 +9,7 @@ import { type AIConnector } from "../../aicore/aiconnector.js";
 import { type AIDocumentData } from "../../aireviewcore/aireviewcoreediting.js";
 import { type AIReviewCheck } from "../../aireviewcore/model/aireviewcheck.js";
 import { AIReviewSystemCheckRun } from "../../aireviewcore/model/aireviewsystemcheckrun.js";
+import { type AIContextRef } from "../../aicore/model/aicontextref.js";
 /**
 * Represents a single translate check run and its results.
 */
@@ -16,7 +17,7 @@ export declare class AITranslateCheckRun extends AIReviewSystemCheckRun {
 	/**
 	* @inheritDoc
 	*/
-	constructor(documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, title: string, params?: Array<string>, args?: Record<string, any>);
+	constructor(documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, title: string, params?: Array<string>, args?: Record<string, any>, contexts?: Array<AIContextRef>);
 	/**
 	* @inheritDoc
 	*/