/**
* @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/builddocumentsuggestionsmap
*/
import type { AIReplyChangeGroup } from "../model/aireply.js";
import type { AIContextItemDocument } from "../model/aicontext.js";
import type { Document } from "domhandler";
import { type Editor } from "@ckeditor/ckeditor5-core";
/**
* A self-contained unit holding everything needed to compute operations for a single document.
*/
export type DocumentSuggestions = {
	groups: Array<AIReplyChangeGroup>;
	documentContext: AIContextItemDocument;
	documentContent: Document;
	editor: Editor;
	indexes: Array<number>;
};
/**
* Buckets groups by `documentId` and enriches each bucket with its pre-AI and post-AI document data.
* Groups whose `documentId` has no matching entry in `documents` or `documentContextContent` are silently skipped.
*/
export declare function buildDocumentSuggestionsMap({ groups, documentContextContent, documents }: {
	groups: Array<AIReplyChangeGroup>;
	documentContextContent: Map<string, Document>;
	documents: Array<AIContextItemDocument>;
}): Map<string, DocumentSuggestions>;