/**
* @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 { ViewCollection } from "../viewcollection.js";
import { type View } from "../view.js";
import { type Locale } from "@ckeditor/ckeditor5-utils";
/**
* This is a special {@link module:ui/viewcollection~ViewCollection} dedicated to elements that are detached from the DOM structure of
* the editor, like floating panels, floating toolbars, dialogs, etc.
*
* The body collection is available under the {@link module:ui/editorui/editoruiview~EditorUIView#body `editor.ui.view.body`} property.
* Any plugin can add a {@link module:ui/view~View view} to this collection.
*
* All views added to a body collection render in a dedicated DOM container (`...
`). All body collection
* containers render in a common shared (`...
`) in the DOM to limit the pollution of
* the `` element. The resulting DOM structure is as follows:
*
* ```html
*
*
*
*
*
*
* ```
*
* By default, the {@link module:ui/editorui/editoruiview~EditorUIView `editor.ui.view`} manages the life cycle of the
* {@link module:ui/editorui/editoruiview~EditorUIView#body `editor.ui.view.body`} collection, attaching and detaching it
* when the editor gets created or {@link module:core/editor/editor~Editor#destroy destroyed}.
*
* # Custom body collection instances
*
* Even though most editor instances come with a built-in body collection
* ({@link module:ui/editorui/editoruiview~EditorUIView#body `editor.ui.view.body`}), you can create your own instance of this
* class if you need to control their life cycle.
*
* The life cycle of a custom body collection must be handled manually by the developer using the dedicated API:
* * A body collection will render itself automatically in the DOM as soon as you call {@link ~BodyCollection#attachToDom}.
* * Calling {@link ~BodyCollection#detachFromDom} will remove the collection from the DOM.
*
* **Note**: The shared collection wrapper (`...
`) gets automatically removed from DOM when the
* last body collection is {@link ~BodyCollection#detachFromDom detached} and does not require any special handling.
*/
export declare class BodyCollection extends ViewCollection {
/**
* The {@link module:core/editor/editor~Editor#locale editor's locale} instance.
* See the view {@link module:ui/view~View#locale locale} property.
*/
readonly locale: Locale;
/**
* The element holding elements of the body collection.
*/
private _bodyCollectionContainer?;
/**
* The wrapper element that holds all of the {@link #_bodyCollectionContainer} elements.
*/
private static _bodyWrapper?;
/**
* Creates a new instance of the {@link module:ui/editorui/bodycollection~BodyCollection}.
*
* @param locale The {@link module:core/editor/editor~Editor editor's locale} instance.
* @param initialItems The initial items of the collection.
*/
constructor(locale: Locale, initialItems?: Iterable);
/**
* The element holding elements of the body collection.
*/
get bodyCollectionContainer(): HTMLElement | undefined;
/**
* Attaches the body collection to the DOM body element. You need to execute this method to render the content of
* the body collection.
*/
attachToDom(): void;
/**
* Detaches the collection from the DOM structure. Use this method when you do not need to use the body collection
* anymore to clean-up the DOM structure.
*/
detachFromDom(): void;
}