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

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

@@ -1,46 +1,46 @@
 /**
- * @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/utils/documentrange
- */
-import { DocumentPosition } from './documentposition.js';
-import { Document } from './htmlparser.js';
+* @module ai/aicore/utils/documentrange
+*/
+import { DocumentPosition } from "./documentposition.js";
+import { Document } from "./htmlparser.js";
 /**
- * Represents a range in a htmlparser's Document limited by two
- * {@link module:ai/aicore/utils/documentposition~DocumentPosition} instances.
- */
+* Represents a range in a htmlparser's Document limited by two
+* {@link module:ai/aicore/utils/documentposition~DocumentPosition} instances.
+*/
 export declare class DocumentRange {
-    readonly start: DocumentPosition;
-    readonly end: DocumentPosition;
-    constructor(start: DocumentPosition, end: DocumentPosition);
-    isEqual(otherRange: DocumentRange): boolean;
-    /**
-     * Nudges {@link #start} and {@link #end} positions to the word boundary so that the range does not split
-     * a word.
-     *
-     * See {@link module:ai/aicore/utils/documentposition~DocumentPosition#getNudgedToWordBoundary} for more details.
-     */
-    getNudgedToWordBoundary(): DocumentRange;
-    /**
-     * Returns a document with the content of this range. The content is extracted from the original document,
-     * preserving the original structure.
-     *
-     * For instance, for the following document and range:
-     *
-     * ```html
-     * <p>fo[o</p>
-     * <p>bar <b>ba]z</b></p>
-     * <p>qux</p>
-     * ```
-     *
-     * the resulting document will be
-     *
-     * ```html
-     * <p>o</p>
-     * <p>bar <b>ba</b></p>
-     * ```
-     */
-    getContent(): Document;
+	readonly start: DocumentPosition;
+	readonly end: DocumentPosition;
+	constructor(start: DocumentPosition, end: DocumentPosition);
+	isEqual(otherRange: DocumentRange): boolean;
+	/**
+	* Nudges {@link #start} and {@link #end} positions to the word boundary so that the range does not split
+	* a word.
+	*
+	* See {@link module:ai/aicore/utils/documentposition~DocumentPosition#getNudgedToWordBoundary} for more details.
+	*/
+	getNudgedToWordBoundary(): DocumentRange;
+	/**
+	* Returns a document with the content of this range. The content is extracted from the original document,
+	* preserving the original structure.
+	*
+	* For instance, for the following document and range:
+	*
+	* ```html
+	* <p>fo[o</p>
+	* <p>bar <b>ba]z</b></p>
+	* <p>qux</p>
+	* ```
+	*
+	* the resulting document will be
+	*
+	* ```html
+	* <p>o</p>
+	* <p>bar <b>ba</b></p>
+	* ```
+	*/
+	getContent(): Document;
 }

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

@@ -1,8 +1,8 @@
 /**
- * @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/utils/eventnames
- */
+* @module ai/aicore/utils/eventnames
+*/
 export declare const AI_SUGGESTION_UI_EVENT_NAMES: readonly ["showChangeInText", "insertSuggestion", "applySuggestion", "rejectSuggestion", "mouseOverSuggestion", "mouseLeaveSuggestion", "toggleSuggestionDisplayMode", "like", "dislike"];

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

@@ -0,0 +1,107 @@
+/**
+* @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/geteditorconfig
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import { type AlignmentConfig } from "@ckeditor/ckeditor5-alignment";
+import { type CodeBlockConfig } from "@ckeditor/ckeditor5-code-block";
+import { type FontSizeConfig, type FontFamilyConfig, type FontColorConfig } from "@ckeditor/ckeditor5-font";
+import { type FootnotesConfig } from "@ckeditor/ckeditor5-footnotes";
+import { type HeadingConfig } from "@ckeditor/ckeditor5-heading";
+import { type HighlightConfig } from "@ckeditor/ckeditor5-highlight";
+import { type ImageConfig } from "@ckeditor/ckeditor5-image";
+import { type IndentBlockConfig } from "@ckeditor/ckeditor5-indent";
+import { type TextPartLanguageOption } from "@ckeditor/ckeditor5-language";
+import { type LineHeightConfig } from "@ckeditor/ckeditor5-line-height";
+import { type LinkConfig } from "@ckeditor/ckeditor5-link";
+import { type ListConfig } from "@ckeditor/ckeditor5-list";
+import { type MentionConfig } from "@ckeditor/ckeditor5-mention";
+import { type MergeFieldsConfig } from "@ckeditor/ckeditor5-merge-fields";
+import { type MultiLevelListConfig } from "@ckeditor/ckeditor5-list-multi-level";
+import { type StyleConfig } from "@ckeditor/ckeditor5-style";
+import { type TableConfig } from "@ckeditor/ckeditor5-table";
+import { type MediaEmbedConfig } from "@ckeditor/ckeditor5-media-embed";
+import { type GeneralHtmlSupportConfig } from "@ckeditor/ckeditor5-html-support";
+import { type AIRootInfo } from "./getrootinfo.js";
+/**
+* Builds a compact, serializable snapshot of the editor's feature capabilities for the AI agent.
+*
+* The returned object is keyed by feature. A key is present only when the feature's plugin is loaded, so the agent
+* can tell at a glance what content the editor is able to produce:
+*
+* * For configurable features, the value is that feature's configuration with UI-only options stripped out
+* (toolbars, color pickers, icons, labels, keystrokes, dropdown limits, preview machinery, …), leaving only the
+* options that actually shape the document data.
+* * For features that expose no data-relevant configuration, the value is an empty object acting purely as a
+* presence flag.
+*
+* Knowing both which features are available and how they are configured (e.g. the allowed heading levels, font
+* sizes or table properties) lets the agent keep its edits within what the editor can represent.
+*
+* On top of the features, the snapshot describes the root it was gathered for in
+* {@link ~AIEditorConfig#rootType `rootType`} — what that root can hold and what surrounds it. A snapshot is
+* therefore specific to one root, which matters for editors with more than one.
+*
+* The live editor configuration is never mutated.
+*
+* @param editor The editor whose feature configuration is gathered.
+* @param rootName The name of the root the snapshot is gathered for.
+* @returns The editor's feature capabilities snapshot.
+*/
+export declare function getEditorConfig(editor: Editor, rootName?: string): AIEditorConfig;
+export type AIEditorConfig = AIEditorConfigFeatureConfigs & AIEditorConfigPresenceFlags & {
+	editorVersion: string;
+};
+export type AIEditorConfigFeatureConfigs = {
+	/**
+	* A snapshot of the root the document relates to. See
+	* {@link module:ai/aicore/utils/getrootinfo~getRootInfo `getRootInfo()`}.
+	*/
+	rootType: AIRootInfo;
+	alignment?: AlignmentConfig;
+	codeBlock?: CodeBlockConfig;
+	fontBackgroundColor?: FontColorConfig;
+	fontColor?: FontColorConfig;
+	fontFamily?: FontFamilyConfig;
+	fontSize?: FontSizeConfig;
+	footnotes?: FootnotesConfig;
+	htmlSupport?: GeneralHtmlSupportConfig;
+	heading?: HeadingConfig;
+	highlight?: HighlightConfig;
+	image?: ImageConfig;
+	indentBlock?: IndentBlockConfig;
+	lineHeight?: LineHeightConfig;
+	link?: LinkConfig;
+	list?: ListConfig;
+	listMultiLevel?: MultiLevelListConfig;
+	mediaEmbed?: MediaEmbedConfig;
+	mention?: MentionConfig;
+	mergeFields?: MergeFieldsConfig;
+	style?: StyleConfig;
+	table?: TableConfig;
+	textPartLanguage?: Array<TextPartLanguageOption>;
+};
+export type AIEditorConfigPresenceFlags = {
+	blockQuote?: object;
+	bold?: object;
+	bookmark?: object;
+	code?: object;
+	horizontalLine?: object;
+	htmlEmbed?: object;
+	italic?: object;
+	math?: object;
+	pageBreak?: object;
+	paragraph?: object;
+	restrictedEditing?: object;
+	shiftEnter?: object;
+	strikethrough?: object;
+	subscript?: object;
+	superscript?: object;
+	tableOfContents?: object;
+	title?: object;
+	todoList?: object;
+	underline?: object;
+};

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

@@ -0,0 +1,18 @@
+/**
+* @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
+*/
+import { type ContextInterface, Editor } from "@ckeditor/ckeditor5-core";
+/**
+* Returns all editor instances registered on the context. For a single editor passed as `context`, returns `[ context ]`.
+* Returns an empty array when the context has no editors yet.
+*/
+export declare function getEditorsFromContext(context: ContextInterface | null | undefined): Array<Editor>;
+/**
+* Returns the editor that should drive user-driven AI operations when several editors share a {@link module:core/context~Context Context}:
+* the one with UI focus if any, otherwise the last editor that had UI focus (tracked by {@link module:ai/aicore/aiediting~AIEditing}),
+* otherwise the first editor in registration order.
+*
+* For a single editor passed as `context`, returns that editor.
+*/
+export declare function getFocusedEditorFromContext(context: ContextInterface): Editor;

package/dist/aicore/utils/getmodeldisplaymode.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/aicore/utils/getmodeldisplaymode
+*/
+/**
+* How the model selector should be presented in the UI:
+* * `'selector'` — a dropdown with the available models,
+* * `'name'` — just the single model's name (no choice to make),
+* * `'hidden'` — no model UI at all.
+*/
+export type AIModelDisplayMode = "selector" | "name" | "hidden";
+/**
+* Resolves how the model selector should be presented, shared by all AI features that expose one.
+*
+* @param modelCount The number of available models.
+* @param showModelSelector Whether the model selector UI is enabled (the `ai.models.showModelSelector` config).
+*/
+export declare function getModelDisplayMode(modelCount: number, showModelSelector: boolean): AIModelDisplayMode;

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

@@ -0,0 +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
+*/
+/**
+* @module ai/aicore/utils/getoperationsfordocumentsuggestions
+*/
+import { type DocumentChanges, type DocumentChangesOptions } from "../../aisdk/documentchanges.js";
+import { type Operation } from "@ckeditor/ckeditor5-engine";
+import type { DocumentSuggestions } from "./builddocumentsuggestionsmap.js";
+/**
+* Returns operations that need to be applied to the editor documents to apply the AI reply.
+* The result is a `Map` keyed by `documentId`, each entry holding the operations for that document.
+*/
+export declare function getOperationsForDocumentSuggestions({ documentSuggestions, transform, documentChanges, documentChangesOptions }: {
+	documentSuggestions: Map<string, DocumentSuggestions>;
+	transform: boolean;
+	documentChanges: DocumentChanges;
+	documentChangesOptions: DocumentChangesOptions;
+}): Map<string, Array<Operation>>;

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

@@ -0,0 +1,45 @@
+/**
+* @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/getrootinfo
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+/**
+* Builds a snapshot of a single editor root for the AI agent.
+*
+* The snapshot tells the agent what the root can hold and what surrounds it, so it can keep its edits within the
+* shape of that root: an inline root cannot take block content at all, and a root hosted by a semantic element
+* (a `<h1>` title, a `<span>` label) implies a different tone and length than a full-page `<div>`.
+*
+* Unlike the {@link module:ai/aicore/utils/geteditorconfig~getEditorConfig feature configuration snapshot}, this one
+* must not be cached for the editor's lifetime: it is per root, and roots come and go at runtime (for example through
+* `MultiRootEditor#addRoot()` / `#detachRoot()`).
+*
+* A root name that matches no root in the editor is described as a regular block root hosted by the default element,
+* mirroring how {@link module:ai/aicore/utils/inlineroot~isInlineRoot `isInlineRoot()`} falls back for such a name.
+*
+* @param editor The editor owning the root.
+* @param rootName The name of the root to describe.
+* @returns The root snapshot.
+*/
+export declare function getRootInfo(editor: Editor, rootName: string): AIRootInfo;
+/**
+* The {@link ~getRootInfo root snapshot}.
+*/
+export interface AIRootInfo {
+	/**
+	* Whether the root is an inline root, that is, whether it rejects block content and behaves like a single
+	* paragraph. Content of such a root must stay inline-only.
+	*/
+	isInline: boolean;
+	/**
+	* The tag name of the element hosting the root, for example `div` for a regular rich-text area or `h1` for a
+	* title mounted on a heading.
+	*
+	* This element surrounds the root - it is not part of the root's content and cannot be edited. It must not be
+	* reproduced in content produced for this root.
+	*/
+	hostElement: string;
+}

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

@@ -1,23 +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/aicore/utils/getsuggestionpartsfromreply
- */
-import { type Editor } from '@ckeditor/ckeditor5-core';
-import { Document } from './htmlparser.js';
-import { type AIReplyChangeGroup } from '../model/aireply.js';
-export declare function getSuggestionPartsFromReply({ editor, changeGroups, documentContextContent, showDiff, trimUnchanged }: {
-    editor: Editor;
-    showDiff: boolean;
-    changeGroups: Array<AIReplyChangeGroup>;
-    documentContextContent: Document;
-    trimUnchanged?: boolean;
+* @module ai/aicore/utils/getsuggestionpartsfromreply
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import { Document } from "./htmlparser.js";
+import { type AIReplyChangeGroup, type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../model/aireply.js";
+export declare function getSuggestionPartsFromReply({ changeGroups, documentContextContent, showDiff, trimUnchanged }: {
+	showDiff: boolean;
+	changeGroups: Array<AIReplyChangeGroup>;
+	documentContextContent: Map<string, Document>;
+	trimUnchanged?: boolean;
 }): Array<AISuggestionContentPartDefinition>;
+export declare function passThroughEditorDataPipeline(editor: Editor, before: Document, after: Document, showDiff: boolean, trimUnchanged?: boolean): {
+	content: Document;
+	hasChanges: boolean;
+};
 export type AISuggestionContentPartDefinition = {
-    type: 'modified' | 'new' | 'removed' | 'context';
-    index: number;
-    content: Document;
-    hasChanges: boolean;
+	type: "modified" | "new" | "removed" | "context";
+	index: number;
+	state: AIReplyChangeGroupState;
+	outdatedReason?: AIReplyChangeGroupOutdatedReason;
+	content: Document;
+	hasChanges: boolean;
+	wrapperTag?: string;
 };

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

@@ -1,16 +1,23 @@
 /**
- * @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
- */
-import { append, appendChild, find, findAll, findOne, getChildren, isComment, isTag, prepend, prependChild, removeElement, replaceElement, textContent, getParent, hasChildren } from 'domutils';
-import render from 'dom-serializer';
-import { cloneNode, isDocument, isText, Element, Text, type AnyNode, type ChildNode, type Comment, Document, NodeWithChildren, type ParentNode } from 'domhandler';
+* @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/htmlparser
+*/
+import { parseDocument } from "htmlparser2";
+import { append, appendChild, find, findAll, findOne, getChildren, isComment, isTag, prepend, prependChild, removeElement, replaceElement, textContent, getParent, hasChildren } from "domutils";
+import render from "dom-serializer";
+import { cloneNode, isDocument, isText, Element, Text, type AnyNode, type ChildNode, type Comment, Document, NodeWithChildren, type ParentNode } from "domhandler";
 export { cloneNode, find, findOne, findAll, getChildren, getParent, isComment, isDocument, isTag, isText, append, appendChild, prepend, prependChild, render, removeElement, replaceElement, textContent, hasChildren, Element, Document, NodeWithChildren, Text };
 export type { AnyNode, ParentNode, ChildNode };
-export declare function parse(html: string): Document;
-export declare function serialize(document: Document | AnyNode): string;
+export declare function parse(html: string, options?: Parameters<typeof parseDocument>[1]): Document;
+export declare function serialize(document: Document | AnyNode, options?: Parameters<typeof render>[1]): string;
 export declare function findByAttribute(name: string, value: string | null, nodes: Array<AnyNode> | ParentNode): ReturnType<typeof findOne>;
 export declare function findAllByAttribute(name: string, value: string | null, nodes: Array<AnyNode> | ParentNode): ReturnType<typeof findAll>;
+export declare function isUnsupportedTag(name: string): boolean;
+export declare function findAllUnsupported(root: ParentNode): Array<Element>;
+export declare function isMarkerBoundaryElement(node: AnyNode): boolean;
 export declare function findAllComments(document: Document): Array<Comment>;
 export declare function getAttribute(node: AnyNode | null, name: string): string | null;
 export declare function setAttribute(node: AnyNode, name: string, value: string | null): void;
@@ -24,12 +31,12 @@ export declare function getNodeNestingLevel(node: ChildNode): number;
 export declare function removeElementsAfter(node: ChildNode): void;
 export declare function getNodePath(node: AnyNode): DocumentPath;
 /**
- * Represents a position in the HTML document as an array of numbers.
- *
- * Each number represents either:
- * - An index of an element among its siblings (for element nodes)
- * - A character position within a text node (for text nodes)
- *
- * Example: [0, 1, 2] means the third child of the second child of the first element.
- */
+* Represents a position in the HTML document as an array of numbers.
+*
+* Each number represents either:
+* - An index of an element among its siblings (for element nodes)
+* - A character position within a text node (for text nodes)
+*
+* Example: [0, 1, 2] means the third child of the second child of the first element.
+*/
 export type DocumentPath = ReadonlyArray<number>;

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

@@ -1,89 +1,89 @@
 /**
- * @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
- */
-import { type Document } from './htmlparser.js';
+* @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
+*/
+import { type Document } from "./htmlparser.js";
 /**
- * The default animation for text nodes. It is a smooth fade-in animation from 0 to 1 opacity.
- */
+* The default animation for text nodes. It is a smooth fade-in animation from 0 to 1 opacity.
+*/
 export declare const DEFAULT_FADE_IN_ANIMATION = "animation: ck-html-streamer-fade-in .3s";
 /**
- * A class that streams arbitrary HTML content into a target DOM element in an incremental manner.
- *
- * It uses a virtual DOM to avoid flickering of images and other dynamic content.
- */
+* A class that streams arbitrary HTML content into a target DOM element in an incremental manner.
+*
+* It uses a virtual DOM to avoid flickering of images and other dynamic content.
+*/
 export declare class HTMLStreamer {
-    /**
-     * Creates an instance of HTMLStreamer.
-     */
-    constructor(options?: HTMLStreamerOptions);
-    /**
-     * Incrementally streams the HTML string into provided target DOM element.
-     *
-     * **Note**: This method can be called repeatedly with a new document to continue the previous call. The new parsed document
-     * must be an extension of the previous document (only growing, never shrinking).
-     *
-     * ## Basic example
-     *
-     * ```ts
-     * const document = parse( '<p>foo bar</p>' );
-     *
-     * const htmlStreamer = new HTMLStreamer( {
-     * 	targetElement,
-     * 	textNodeStyle: 'animation: my-animation .5s'
-     * } );
-     *
-     * await htmlStreamer.stream( { document } );
-     * ```
-     *
-     * after 10ms will stream:
-     *
-     * ```html
-     * <p></p>
-     * ```
-     *
-     * and after 20ms:
-     *
-     * ```html
-     * <p><span data-ck-html-streamer-word-chunk="" style="animation: my-animation .5s">foo </span></p>
-     * ```
-     *
-     * and after 30ms:
-     *
-     * ```html
-     * <p>
-     * 	<span data-ck-html-streamer-word-chunk="" style="animation: my-animation .5s">foo </span>
-     * 	<span data-ck-html-streamer-word-chunk="" style="animation: my-animation .5s">bar</span>
-     * </p>
-     * ```
-     */
-    stream({ document, targetElement, abortSignal }: {
-        document: Document;
-        targetElement: HTMLElement;
-        abortSignal?: AbortSignal;
-    }): Promise<void>;
-    /**
-     * Resets the HTMLStreamer to its initial state.
-     */
-    reset(): void;
-    /**
-     * Cleans up the animation `<span>` elements from the configured target element with minimum DOM manipulation.
-     */
-    cleanUpAnimations({ targetElement }: {
-        targetElement: HTMLElement;
-    }): void;
+	/**
+	* Creates an instance of HTMLStreamer.
+	*/
+	constructor(options?: HTMLStreamerOptions);
+	/**
+	* Incrementally streams the HTML string into provided target DOM element.
+	*
+	* **Note**: This method can be called repeatedly with a new document to continue the previous call. The new parsed document
+	* must be an extension of the previous document (only growing, never shrinking).
+	*
+	* ## Basic example
+	*
+	* ```ts
+	* const document = parse( '<p>foo bar</p>' );
+	*
+	* const htmlStreamer = new HTMLStreamer( {
+	* 	targetElement,
+	* 	textNodeStyle: 'animation: my-animation .5s'
+	* } );
+	*
+	* await htmlStreamer.stream( { document } );
+	* ```
+	*
+	* after 10ms will stream:
+	*
+	* ```html
+	* <p></p>
+	* ```
+	*
+	* and after 20ms:
+	*
+	* ```html
+	* <p><span data-ck-html-streamer-word-chunk="" style="animation: my-animation .5s">foo </span></p>
+	* ```
+	*
+	* and after 30ms:
+	*
+	* ```html
+	* <p>
+	* 	<span data-ck-html-streamer-word-chunk="" style="animation: my-animation .5s">foo </span>
+	* 	<span data-ck-html-streamer-word-chunk="" style="animation: my-animation .5s">bar</span>
+	* </p>
+	* ```
+	*/
+	stream({ document, targetElement, abortSignal }: {
+		document: Document;
+		targetElement: HTMLElement;
+		abortSignal?: AbortSignal;
+	}): Promise<void>;
+	/**
+	* Resets the HTMLStreamer to its initial state.
+	*/
+	reset(): void;
+	/**
+	* Cleans up the animation `<span>` elements from the configured target element with minimum DOM manipulation.
+	*/
+	cleanUpAnimations({ targetElement }: {
+		targetElement: HTMLElement;
+	}): void;
 }
 /**
- * Options for the HTMLStreamer.
- */
+* Options for the HTMLStreamer.
+*/
 interface HTMLStreamerOptions {
-    /**
-     * Delay between `stream()` updates in milliseconds. Default is 10ms.
-     */
-    delay?: number;
-    /**
-     * The `style` attribute value for `<span>` elements that wrap text nodes.
-     */
-    textNodeStyle?: string;
+	/**
+	* Delay between `stream()` updates in milliseconds. Default is 10ms.
+	*/
+	delay?: number;
+	/**
+	* The `style` attribute value for `<span>` elements that wrap text nodes.
+	*/
+	textNodeStyle?: string;
 }
 export {};

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

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

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

@@ -0,0 +1,23 @@
+/**
+* @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/istrackchangesenabled
+*/
+import { type ContextInterface, type Editor } from "@ckeditor/ckeditor5-core";
+/**
+* Whether Track Changes mode is currently on for the given editor. `false` when the Track Changes plugin
+* (and with it, the `trackChanges` command) is not loaded at all.
+*/
+export declare function isTrackChangesEnabledForEditor(editor: Editor): boolean;
+/**
+* Whether the Track Changes plugin is loaded in every editor registered on the context. `false` for an empty
+* editor list, so a Context whose editors have not registered yet does not report `true` by default
+* (`Array#every()` is `true` for an empty array).
+*/
+export declare function hasTrackChangesPluginInEveryEditor(context: ContextInterface): boolean;
+/**
+* Whether Track Changes mode is currently on for at least one editor registered on the context.
+*/
+export declare function isTrackChangesEnabledInAnyEditor(context: ContextInterface): boolean;

package/dist/aicore/utils/markoperationsasai.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/aicore/utils/markoperationsasai
+*/
+import type { Operation } from "@ckeditor/ckeditor5-engine";
+import type { AIOperationSource } from "@ckeditor/ckeditor5-collaboration-core";
+export type { AIOperationSource };
+/**
+* Sets the AI source identifier on a list of operations. After this call, every non-no-op operation has its
+* `_aiSource` field set to `source` and is preserved through collaborative transmission.
+*
+* No-op operations are skipped on purpose — they describe no change, so labelling them would tag transformed
+* AI work that ended up empty (for example, when a concurrent user edit cancelled out the AI change).
+*
+* Use this helper when an AI feature produces operations and you want downstream consumers (notably track-changes
+* suggestion creation) to recognize them as AI-originated.
+*/
+export declare function markOperationsAsAI(operations: Iterable<Operation>, source: AIOperationSource): void;