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

package/dist/aicore/utils/replyactions.d.ts

@@ -0,0 +1,13 @@
+/**
+* @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/utils/replyactions
+*/
+/**
+* The actions that can be performed on an AI suggestion, used as the default set wherever
+* `ai.availableReplyActions` is not configured.
+*/
+export declare const AI_REPLY_ACTIONS: readonly ["applySuggestion", "insertSuggestion"];
+export type AISuggestionActionName = typeof AI_REPLY_ACTIONS[number];

package/dist/aicore/utils/scrollmanager.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
- */
+* @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
+*/
 /**
- * The scroll manager for an element. Once started, it auto-scrolls to the bottom of the element as its
- * children change unless the user interacts with the element.
- */
+* The scroll manager for an element. Once started, it auto-scrolls to the bottom of the element as its
+* children change unless the user interacts with the element.
+*/
 export declare class ScrollManager {
-    constructor(element: HTMLElement);
-    /**
-     * Starts the auto-scrolling.
-     *
-     * @param options.smooth When `false`, the scroll jumps instantly instead of animating. Defaults to `true`.
-     */
-    start({ smooth }?: {
-        smooth?: boolean;
-    }): void;
-    /**
-     * Stops the auto-scrolling.
-     */
-    stop(): void;
-    /**
-     * Destroys the scroll manager.
-     */
-    destroy(): void;
+	constructor(element: HTMLElement);
+	/**
+	* Starts the auto-scrolling.
+	*
+	* @param options Scrolling options.
+	* @param options.smooth When `false`, the scroll jumps instantly instead of animating. Defaults to `true`.
+	*/
+	start({ smooth }?: {
+		smooth?: boolean;
+	}): void;
+	/**
+	* Stops the auto-scrolling.
+	*/
+	stop(): void;
+	/**
+	* Destroys the scroll manager.
+	*/
+	destroy(): void;
 }

package/dist/aicore/utils/showaitab.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/aidocumentprocessing/aidocumentprocessinggateway.d.ts

@@ -0,0 +1,110 @@
+/**
+* @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/aidocumentprocessing/aidocumentprocessinggateway
+* @publicApi
+*/
+import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import type { AIEditorRoot } from "../aicore/model/aieditorroot.js";
+import { AIConnector } from "../aicore/aiconnector.js";
+import { AICore } from "../aicore/aicore.js";
+import { type AIModels } from "../aicore/model/aimodels.js";
+import { AIEditing } from "../aicore/aiediting.js";
+import { AIGateway, type AIRunBaseOptions, type AIGatewayApplyOptions } from "../aicore/aigateway.js";
+import { type AICapabilitiesConfigAdvanced } from "../aicore/model/aicapabilities.js";
+import { AIDocumentProcessingRunResult } from "./model/aidocumentprocessingrunresult.js";
+import { AIRunResult } from "../aicore/model/airunresult.js";
+export type AIDocumentProcessingRunOptions = AIRunBaseOptions & {
+	/**
+	* The model that will be used to run the document processing request.
+	* The IDs of an AI models can be acquired
+	* via {@link module:ai/aicore/model/aimodels~AIModels#getAvailableModels} call.
+	*/
+	model: string;
+	/**
+	* The roots to process. When omitted, every non-`$graveyard` root across every editor in the current
+	* {@link module:core/context~Context `Context`} is processed. When provided, only the listed roots are
+	* processed; 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 the `collaboration.channelId` config of the target editor instance.
+	* `rootName` must match an existing, non-`$graveyard` root within that editor.
+	*/
+	roots?: Array<AIEditorRoot>;
+	/**
+	* Per-call AI capability directives. `webSearch` toggles web search; `reasoning` toggles reasoning and
+	* optionally selects a level
+	* (see {@link module:ai/aicore/model/aicapabilities~AIReasoningLevel AIReasoningLevel}).
+	* Omitting the option or leaving all flags falsy disables both capabilities for this call.
+	*/
+	capabilities?: AICapabilitiesConfigAdvanced;
+};
+/**
+* Headless, stateless API for performing AI-powered transformations on entire documents through the `/documents/process` endpoint.
+* Similar to sending a single message through the {@link module:ai/aichat/aichat~AIChat AI Chat plugin}.
+*
+* This API provides a simple document-processing workflow: a single `prompt` is applied to one or more documents,
+* producing transformed documents with all AI-generated changes already applied.
+*
+* By default, every non-`$graveyard` root across every editor in the context is processed. To restrict a run to a
+* subset of roots, pass the `roots` option to
+* {@link module:ai/aidocumentprocessing/aidocumentprocessinggateway~AIDocumentProcessingGateway#processDocument}.
+*/
+export declare class AIDocumentProcessingGateway extends ContextPlugin {
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIDocumentProcessingGateway";
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[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
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* Runs the document processing request and returns an
+	* {@link module:ai/aicore/model/airunresult~AIRunResult AIRunResult} — a container with one
+	* {@link module:ai/aidocumentprocessing/model/aidocumentprocessingrunresult~AIDocumentProcessingRunResult
+	* AIDocumentProcessingRunResult} per root and whole-run `status` / `error`.
+	*
+	* The result can then be applied to the editor via {@link #applyResult}. 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'`.
+	*
+	* @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 against the document.
+	* @param options Run options: required `model`, optional `roots` to restrict the run to a subset of roots, optional `signal`
+	* to abort the run, and optional `capabilities` asking the AI service to use web search or reasoning for this call.
+	*/
+	processDocument(prompt: string, options: AIDocumentProcessingRunOptions): Promise<AIRunResult<AIDocumentProcessingRunResult>>;
+	/**
+	* Applies the document processing result (produced by {@link #processDocument}) to the editor content, either as direct
+	* changes or as track changes suggestions.
+	*
+	* This is a proxy to {@link module:ai/aicore/aigateway~AIGateway#apply}.
+	*
+	* @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 run.
+	* @param applyOptions Options for applying the changes to the editor content.
+	*/
+	applyResult(result: AIRunResult<AIDocumentProcessingRunResult>, applyOptions: AIGatewayApplyOptions): void;
+}

package/dist/aidocumentprocessing/model/aidocumentprocessingrunresult.d.ts

@@ -0,0 +1,19 @@
+/**
+* @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/aidocumentprocessing/model/aidocumentprocessingrunresult
+* @publicApi
+*/
+import { AIRunSingleRootResult } from "../../aicore/model/airunsinglerootresult.js";
+/**
+* The result of an AI document processing run.
+*/
+export declare class AIDocumentProcessingRunResult extends AIRunSingleRootResult {
+	/**
+	* The summary of changes produced by the run.
+	*/
+	get summary(): string;
+	set summary(value: string);
+}

package/dist/aieditorintegration/aieditorintegration.d.ts

@@ -1,37 +1,47 @@
 /**
- * @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/aieditorintegration/aieditorintegration
- * @publicApi
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { AIToggleButtonUI } from './aitogglebutton/aitogglebuttonui.js';
-import { AIChatBalloon } from '../aichat/aichatballoon.js';
-import { SuggestionsConversion } from '@ckeditor/ckeditor5-collaboration-core';
+* @module ai/aieditorintegration/aieditorintegration
+* @publicApi
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { Dialog } from "@ckeditor/ckeditor5-ui";
+import { AIToggleButtonUI } from "./aitogglebutton/aitogglebuttonui.js";
+import { AIChatBalloon } from "../aichat/aichatballoon.js";
+import { SuggestionsConversion } from "@ckeditor/ckeditor5-collaboration-core";
 /**
- * The AI Editor Integration plugin. It registers AI-related components in the editor
- * and provides the necessary UI elements for AI functionality.
- *
- * This plugin works alongside context plugins that provide specific AI features,
- * handling the editor-level integration and toolbar controls.
- */
+* The AI Editor Integration plugin. It registers AI-related components in the editor
+* and provides the necessary UI elements for AI functionality.
+*
+* This plugin works alongside context plugins that provide specific AI features,
+* handling the editor-level integration and toolbar controls.
+*/
 export declare class AIEditorIntegration extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AIToggleButtonUI, typeof AIChatBalloon, typeof SuggestionsConversion];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIEditorIntegration";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AIToggleButtonUI, AIChatBalloon, SuggestionsConversion]>;
+	/**
+	* The `Dialog` plugin used by this editor's AI features.
+	*
+	* `AIEditorIntegration` is the single point that has a real, direct dependency on `Dialog`
+	* (via `AIChatBalloon`). Exposing it here lets `ContextPlugin`s — which cannot declare `Dialog`
+	* in their own `requires`, since it is not a context plugin — reach it through this integration
+	* point instead of looking it up on the editor's plugin collection by string name.
+	*/
+	get dialog(): Dialog;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIEditorIntegration";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
 }

package/dist/aieditorintegration/aitogglebutton/aitogglebuttonui.d.ts

@@ -1,39 +1,38 @@
 /**
- * @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/aieditorintegration/aitogglebutton/aitogglebuttonui
- * @publicApi
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { AITabs } from '../../aitabs/aitabs.js';
-import '../../../theme/aieditorintegration/aitogglebutton.css';
+* @module ai/aieditorintegration/aitogglebutton/aitogglebuttonui
+* @publicApi
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { AITabs } from "../../aitabs/aitabs.js";
 /**
- * Registers the `toggleAi` toolbar button that toggles the visibility of AI tabs.
- *
- * Context plugins can’t register toolbar items via the editor’s component factory, so this is provided as a dedicated editor plugin.
- * Include this plugin in the editor configuration to enable the button.
- */
+* Registers the `toggleAi` toolbar button that toggles the visibility of AI tabs.
+*
+* Context plugins can’t register toolbar items via the editor’s component factory, so this is provided as a dedicated editor plugin.
+* Include this plugin in the editor configuration to enable the button.
+*/
 export declare class AIToggleButtonUI extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof AITabs];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "AIToggleButtonUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[AITabs]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "AIToggleButtonUI";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
 }

package/dist/aieditorintegration/aitogglebutton/toggleaicommand.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/aieditorintegration/aitogglebutton/toggleaicommand
- * @publicApi
- */
-import { Command, type Editor } from '@ckeditor/ckeditor5-core';
+* @module ai/aieditorintegration/aitogglebutton/toggleaicommand
+* @publicApi
+*/
+import { Command, type Editor } from "@ckeditor/ckeditor5-core";
 export declare class ToggleAICommand extends Command {
-    constructor(editor: Editor);
-    /**
-     * @inheritdoc
-     */
-    execute(): void;
+	constructor(editor: Editor);
+	/**
+	* @inheritdoc
+	*/
+	override execute(): void;
 }