@ckeditor/ckeditor5-editor-balloon 48.8.1-alpha.3 → 49.0.0-alpha.0

package/dist/ballooneditoruiview.d.ts

@@ -1,38 +1,39 @@
 /**
- * @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 editor-balloon/ballooneditoruiview
- */
-import { EditorUIView, InlineEditableUIView, MenuBarView } from '@ckeditor/ckeditor5-ui';
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import type { EditingView } from '@ckeditor/ckeditor5-engine';
+* @module editor-balloon/ballooneditoruiview
+*/
+import { EditorUIView, InlineEditableUIView, MenuBarView } from "@ckeditor/ckeditor5-ui";
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import type { EditingView } from "@ckeditor/ckeditor5-engine";
+import type { ViewRootElementDefinition } from "@ckeditor/ckeditor5-core";
 /**
- * Contextual editor UI view. Uses the {@link module:ui/editableui/inline/inlineeditableuiview~InlineEditableUIView}.
- */
+* Contextual editor UI view. Uses the {@link module:ui/editableui/inline/inlineeditableuiview~InlineEditableUIView}.
+*/
 export declare class BalloonEditorUIView extends EditorUIView {
-    /**
-     * Editable UI view.
-     */
-    readonly editable: InlineEditableUIView;
-    /**
-     * Menu bar view instance.
-     */
-    menuBarView: MenuBarView;
-    /**
-     * Creates an instance of the balloon editor UI view.
-     *
-     * @param locale The {@link module:core/editor/editor~Editor#locale} instance.
-     * @param editingView The editing view instance this view is related to.
-     * @param editableElement The editable element. If not specified, it will be automatically created by
-     * {@link module:ui/editableui/editableuiview~EditableUIView}. Otherwise, the given element will be used.
-     * @param label When set, this value will be used as an accessible `aria-label` of the
-     * {@link module:ui/editableui/editableuiview~EditableUIView editable view}.
-     */
-    constructor(locale: Locale, editingView: EditingView, editableElement?: HTMLElement, label?: string | Record<string, string>);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
+	/**
+	* Editable UI view.
+	*/
+	readonly editable: InlineEditableUIView;
+	/**
+	* Menu bar view instance.
+	*/
+	override menuBarView: MenuBarView;
+	/**
+	* Creates an instance of the balloon editor UI view.
+	*
+	* @param locale The {@link module:core/editor/editor~Editor#locale} instance.
+	* @param editingView The editing view instance this view is related to.
+	* @param editableElement The editable element. If not specified, it will be automatically created by
+	* {@link module:ui/editableui/editableuiview~EditableUIView}. Otherwise, the given element will be used.
+	* @param label When set, this value will be used as an accessible `aria-label` of the
+	* {@link module:ui/editableui/editableuiview~EditableUIView editable view}.
+	*/
+	constructor(locale: Locale, editingView: EditingView, editableElement?: HTMLElement | ViewRootElementDefinition, label?: string | Record<string, string>);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
 }

package/dist/index-content.css

@@ -2,3 +2,6 @@
  * @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
  */
+
+
+/*# sourceMappingURL=index-content.css.map */

package/dist/index-content.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index-content.css"],"names":[],"mappings":";;;;;;AAEA,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC","file":"index-content.css.map","sourcesContent":["\n\n/*# sourceMappingURL=index-content.css.map */"]}

package/dist/index-editor.css

@@ -2,3 +2,6 @@
  * @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
  */
+
+
+/*# sourceMappingURL=index-editor.css.map */

package/dist/index-editor.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index-editor.css"],"names":[],"mappings":";;;;;;AAEA,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC","file":"index-editor.css.map","sourcesContent":["\n\n/*# sourceMappingURL=index-editor.css.map */"]}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /**
- * @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 editor-balloon
- */
-export { BalloonEditor } from './ballooneditor.js';
-export { BalloonEditorUI } from './ballooneditorui.js';
-export { BalloonEditorUIView } from './ballooneditoruiview.js';
+* @module editor-balloon
+*/
+export { BalloonEditor } from "./ballooneditor.js";
+export { BalloonEditorUI } from "./ballooneditorui.js";
+export { BalloonEditorUIView } from "./ballooneditoruiview.js";

package/dist/index.js

@@ -2,214 +2,215 @@
  * @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 { ElementApiMixin, Editor, normalizeSingleRootEditorConstructorParams, normalizeRootsConfig, secureSourceElement, registerAndInitializeRootConfigAttributes, attachToForm, verifyRootElements } from '@ckeditor/ckeditor5-core/dist/index.js';
-import { EditorUI, EditorUIView, InlineEditableUIView, MenuBarView, BalloonToolbar } from '@ckeditor/ckeditor5-ui/dist/index.js';
-import { CKEditorError } from '@ckeditor/ckeditor5-utils/dist/index.js';
-import { enableViewPlaceholder } from '@ckeditor/ckeditor5-engine/dist/index.js';
-import { isElement as isElement$1 } from 'es-toolkit/compat';
+import { Editor, ElementApiMixin, attachToForm, normalizeRootsConfig, normalizeSingleRootEditorConstructorParams, registerAndInitializeRootConfigAttributes, rootAcceptsBlocks, secureSourceElement, verifyRootElements } from "@ckeditor/ckeditor5-core";
+import { BalloonToolbar, EditorUI, EditorUIView, InlineEditableUIView, MenuBarView } from "@ckeditor/ckeditor5-ui";
+import { enableViewPlaceholder } from "@ckeditor/ckeditor5-engine";
+import { isElement } from "es-toolkit/compat";
 
 /**
- * The balloon editor UI class.
- */ class BalloonEditorUI extends EditorUI {
-    /**
-	 * The main (top–most) view of the editor UI.
-	 */ view;
-    /**
-	 * Creates an instance of the balloon editor UI class.
-	 *
-	 * @param editor The editor instance.
-	 * @param view The view of the UI.
-	 */ constructor(editor, view){
-        super(editor);
-        this.view = view;
-    }
-    /**
-	 * @inheritDoc
-	 */ get element() {
-        return this.view.editable.element;
-    }
-    /**
-	 * Initializes the UI.
-	 */ init() {
-        const editor = this.editor;
-        const view = this.view;
-        const editingView = editor.editing.view;
-        const editable = view.editable;
-        const editingRoot = editingView.document.getRoot();
-        // The editable UI and editing root should share the same name. Then name is used
-        // to recognize the particular editable, for instance in ARIA attributes.
-        editable.name = editingRoot.rootName;
-        view.render();
-        // The editable UI element in DOM is available for sure only after the editor UI view has been rendered.
-        // But it can be available earlier if a DOM element has been passed to BalloonEditor.create().
-        const editableElement = editable.element;
-        // Register the editable UI view in the editor. A single editor instance can aggregate multiple
-        // editable areas (roots) but the balloon editor has only one.
-        this.setEditableElement(editable.name, editableElement);
-        // Let the editable UI element respond to the changes in the global editor focus
-        // tracker. It has been added to the same tracker a few lines above but, in reality, there are
-        // many focusable areas in the editor, like balloons, toolbars or dropdowns and as long
-        // as they have focus, the editable should act like it is focused too (although technically
-        // it isn't), e.g. by setting the proper CSS class, visually announcing focus to the user.
-        // Doing otherwise will result in editable focus styles disappearing, once e.g. the
-        // toolbar gets focused.
-        editable.bind('isFocused').to(this.focusTracker);
-        // Bind the editable UI element to the editing view, making it an end– and entry–point
-        // of the editor's engine. This is where the engine meets the UI.
-        editingView.attachDomRoot(editableElement);
-        this._initPlaceholder();
-        this.initMenuBar(this.view.menuBarView);
-        this.fire('ready');
-    }
-    /**
-	 * @inheritDoc
-	 */ destroy() {
-        super.destroy();
-        const view = this.view;
-        const editingView = this.editor.editing.view;
-        if (editingView.getDomRoot(view.editable.name)) {
-            editingView.detachDomRoot(view.editable.name);
-        }
-        view.destroy();
-    }
-    /**
-	 * Enable the placeholder text on the editing root.
-	 */ _initPlaceholder() {
-        const editor = this.editor;
-        const editingView = editor.editing.view;
-        const editingRoot = editingView.document.getRoot();
-        const placeholder = editor.config.get('roots')[editingRoot.rootName].placeholder;
-        if (placeholder) {
-            editingRoot.placeholder = placeholder;
-        }
-        enableViewPlaceholder({
-            view: editingView,
-            element: editingRoot,
-            isDirectHost: false,
-            keepOnFocus: true
-        });
-    }
-}
+* @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 editor-balloon/ballooneditorui
+*/
+/**
+* The balloon editor UI class.
+*/
+var BalloonEditorUI = class extends EditorUI {
+	/**
+	* The main (top–most) view of the editor UI.
+	*/
+	view;
+	/**
+	* Creates an instance of the balloon editor UI class.
+	*
+	* @param editor The editor instance.
+	* @param view The view of the UI.
+	*/
+	constructor(editor, view) {
+		super(editor);
+		this.view = view;
+	}
+	/**
+	* @inheritDoc
+	*/
+	get element() {
+		return this.view.editable.element;
+	}
+	/**
+	* Initializes the UI.
+	*/
+	init() {
+		const editor = this.editor;
+		const view = this.view;
+		const editingView = editor.editing.view;
+		const editable = view.editable;
+		const editingRoot = editingView.document.getRoot();
+		editable.name = editingRoot.rootName;
+		editable.isInlineRoot = !rootAcceptsBlocks(editor, editingRoot.rootName);
+		view.render();
+		const editableElement = editable.element;
+		this.setEditableElement(editable.name, editableElement);
+		editable.bind("isFocused").to(this.focusTracker);
+		editingView.attachDomRoot(editableElement);
+		this._initPlaceholder();
+		this.initMenuBar(this.view.menuBarView);
+		this.fire("ready");
+	}
+	/**
+	* @inheritDoc
+	*/
+	destroy() {
+		super.destroy();
+		const view = this.view;
+		const editingView = this.editor.editing.view;
+		if (editingView.getDomRoot(view.editable.name)) editingView.detachDomRoot(view.editable.name);
+		view.destroy();
+	}
+	/**
+	* Enable the placeholder text on the editing root.
+	*/
+	_initPlaceholder() {
+		const editor = this.editor;
+		const editingView = editor.editing.view;
+		const editingRoot = editingView.document.getRoot();
+		const placeholder = editor.config.get("roots")[editingRoot.rootName].placeholder;
+		if (placeholder) editingRoot.placeholder = placeholder;
+		enableViewPlaceholder({
+			view: editingView,
+			element: editingRoot,
+			isDirectHost: this.view.editable.isInlineRoot,
+			keepOnFocus: true
+		});
+	}
+};
 
 /**
- * Contextual editor UI view. Uses the {@link module:ui/editableui/inline/inlineeditableuiview~InlineEditableUIView}.
- */ class BalloonEditorUIView extends EditorUIView {
-    /**
-	 * Editable UI view.
-	 */ editable;
-    /**
-	 * Menu bar view instance.
-	 */ menuBarView;
-    /**
-	 * Creates an instance of the balloon editor UI view.
-	 *
-	 * @param locale The {@link module:core/editor/editor~Editor#locale} instance.
-	 * @param editingView The editing view instance this view is related to.
-	 * @param editableElement The editable element. If not specified, it will be automatically created by
-	 * {@link module:ui/editableui/editableuiview~EditableUIView}. Otherwise, the given element will be used.
-	 * @param label When set, this value will be used as an accessible `aria-label` of the
-	 * {@link module:ui/editableui/editableuiview~EditableUIView editable view}.
-	 */ constructor(locale, editingView, editableElement, label){
-        super(locale);
-        this.editable = new InlineEditableUIView(locale, editingView, editableElement, {
-            label
-        });
-        this.menuBarView = new MenuBarView(locale);
-        this.menuBarView.extendTemplate({
-            attributes: {
-                class: [
-                    'ck-reset_all',
-                    'ck-rounded-corners'
-                ],
-                dir: locale.uiLanguageDirection
-            }
-        });
-    }
-    /**
-	 * @inheritDoc
-	 */ render() {
-        super.render();
-        this.registerChild(this.editable);
-        this.registerChild(this.menuBarView);
-    }
-}
+* @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 editor-balloon/ballooneditoruiview
+*/
+/**
+* Contextual editor UI view. Uses the {@link module:ui/editableui/inline/inlineeditableuiview~InlineEditableUIView}.
+*/
+var BalloonEditorUIView = class extends EditorUIView {
+	/**
+	* Editable UI view.
+	*/
+	editable;
+	/**
+	* Menu bar view instance.
+	*/
+	menuBarView;
+	/**
+	* Creates an instance of the balloon editor UI view.
+	*
+	* @param locale The {@link module:core/editor/editor~Editor#locale} instance.
+	* @param editingView The editing view instance this view is related to.
+	* @param editableElement The editable element. If not specified, it will be automatically created by
+	* {@link module:ui/editableui/editableuiview~EditableUIView}. Otherwise, the given element will be used.
+	* @param label When set, this value will be used as an accessible `aria-label` of the
+	* {@link module:ui/editableui/editableuiview~EditableUIView editable view}.
+	*/
+	constructor(locale, editingView, editableElement, label) {
+		super(locale);
+		this.editable = new InlineEditableUIView(locale, editingView, editableElement, { label });
+		this.menuBarView = new MenuBarView(locale);
+		this.menuBarView.extendTemplate({ attributes: {
+			class: ["ck-reset_all", "ck-rounded-corners"],
+			dir: locale.uiLanguageDirection
+		} });
+	}
+	/**
+	* @inheritDoc
+	*/
+	render() {
+		super.render();
+		this.registerChild(this.editable);
+		this.registerChild(this.menuBarView);
+	}
+};
 
 /**
- * The balloon editor implementation (Medium-like editor).
- * It uses an inline editable and a toolbar based on the {@link module:ui/toolbar/balloon/balloontoolbar~BalloonToolbar}.
- * See the {@glink examples/builds/balloon-editor demo}.
- *
- * In order to create a balloon editor instance, use the static
- * {@link module:editor-balloon/ballooneditor~BalloonEditor.create `BalloonEditor.create()`} method.
- */ class BalloonEditor extends /* #__PURE__ */ ElementApiMixin(Editor) {
-    /**
-	 * @inheritDoc
-	 */ static get editorName() {
-        return 'BalloonEditor';
-    }
-    /**
-	 * @inheritDoc
-	 */ ui;
-    constructor(sourceElementOrDataOrConfig, config = {}){
-        const { sourceElementOrData, editorConfig } = normalizeSingleRootEditorConstructorParams(sourceElementOrDataOrConfig, config);
-        super(editorConfig);
-        normalizeRootsConfig(sourceElementOrData, this.config);
-        // From this point use only normalized `roots.main.element`.
-        const sourceElement = this.config.get('roots').main.element;
-        if (isElement(sourceElement)) {
-            if (sourceElement.tagName === 'TEXTAREA') {
-                // Documented in core/editor/editor.js
-                // eslint-disable-next-line ckeditor5-rules/ckeditor-error-message
-                throw new CKEditorError('editor-wrong-element', null);
-            }
-            this.sourceElement = sourceElement;
-            secureSourceElement(this, sourceElement);
-        }
-        const plugins = this.config.get('plugins');
-        plugins.push(BalloonToolbar);
-        this.config.set('plugins', plugins);
-        this.config.define('balloonToolbar', this.config.get('toolbar'));
-        this.model.document.createRoot(this.config.get('roots').main.modelElement);
-        registerAndInitializeRootConfigAttributes(this);
-        const view = new BalloonEditorUIView(this.locale, this.editing.view, this.sourceElement, this.config.get('roots').main.label);
-        this.ui = new BalloonEditorUI(this, view);
-        attachToForm(this);
-    }
-    /**
-	 * Destroys the editor instance, releasing all resources used by it.
-	 *
-	 * Updates the original editor element with the data if the
-	 * {@link module:core/editor/editorconfig~EditorConfig#updateSourceElementOnDestroy `updateSourceElementOnDestroy`}
-	 * configuration option is set to `true`.
-	 */ async destroy() {
-        // Cache the data, then destroy.
-        // It's safe to assume that the model->view conversion will not work after super.destroy().
-        const data = this.getData();
-        this.ui.destroy();
-        await super.destroy();
-        if (this.sourceElement) {
-            this.updateSourceElement(data);
-        }
-        // To satisfy the return type and to keep it backward compatible.
-        // eslint-disable-next-line no-useless-return
-        return;
-    }
-    static async create(sourceElementOrDataOrConfig, config = {}) {
-        const editor = new this(sourceElementOrDataOrConfig, config);
-        await editor.initPlugins();
-        // Roots are created in the editor constructor (before plugins are loaded), but the schema is only fully
-        // built after plugins register their items during init(). Custom root element names (e.g. registered by a
-        // plugin) may not exist in the schema at construction time, so we defer this check until here.
-        verifyRootElements(editor);
-        await editor.ui.init();
-        await editor.data.init(editor.config.get('roots').main.initialData);
-        editor.fire('ready');
-        return editor;
-    }
-}
-function isElement(value) {
-    return isElement$1(value);
+* @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 editor-balloon/ballooneditor
+*/
+const BalloonEditorBase = /* #__PURE__ */ ElementApiMixin(Editor);
+/**
+* The balloon editor implementation (Medium-like editor).
+* It uses an inline editable and a toolbar based on the {@link module:ui/toolbar/balloon/balloontoolbar~BalloonToolbar}.
+* See the {@glink examples/builds/balloon-editor demo}.
+*
+* In order to create a balloon editor instance, use the static
+* {@link module:editor-balloon/ballooneditor~BalloonEditor.create `BalloonEditor.create()`} method.
+*/
+var BalloonEditor = class extends BalloonEditorBase {
+	/**
+	* @inheritDoc
+	*/
+	static get editorName() {
+		return "BalloonEditor";
+	}
+	/**
+	* @inheritDoc
+	*/
+	ui;
+	constructor(sourceElementOrDataOrConfig, config = {}) {
+		const { sourceElementOrData, editorConfig } = normalizeSingleRootEditorConstructorParams(sourceElementOrDataOrConfig, config);
+		super(editorConfig);
+		normalizeRootsConfig(sourceElementOrData, this.config);
+		const editableElement = this.config.get("roots").main.element;
+		if (isElement$1(editableElement)) {
+			this.sourceElement = editableElement;
+			secureSourceElement(this, editableElement);
+		}
+		const plugins = this.config.get("plugins");
+		plugins.push(BalloonToolbar);
+		this.config.set("plugins", plugins);
+		this.config.define("balloonToolbar", this.config.get("toolbar"));
+		this.model.document.createRoot(this.config.get("roots").main.modelElement);
+		registerAndInitializeRootConfigAttributes(this);
+		const view = new BalloonEditorUIView(this.locale, this.editing.view, editableElement, this.config.get("roots").main.label);
+		this.ui = new BalloonEditorUI(this, view);
+		attachToForm(this);
+	}
+	/**
+	* Destroys the editor instance, releasing all resources used by it.
+	*
+	* Updates the original editor element with the data if the
+	* {@link module:core/editor/editorconfig~EditorConfig#updateSourceElementOnDestroy `updateSourceElementOnDestroy`}
+	* configuration option is set to `true`.
+	*/
+	async destroy() {
+		const data = this.getData();
+		this.ui.destroy();
+		await super.destroy();
+		if (this.sourceElement) this.updateSourceElement(data);
+	}
+	static async create(sourceElementOrDataOrConfig, config = {}) {
+		const editor = new this(sourceElementOrDataOrConfig, config);
+		await editor.initPlugins();
+		verifyRootElements(editor);
+		await editor.ui.init();
+		await editor.data.init(editor.config.get("roots").main.initialData);
+		editor.fire("ready");
+		return editor;
+	}
+};
+function isElement$1(value) {
+	return isElement(value);
 }
 
+/**
+* @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
+*/
+
 export { BalloonEditor, BalloonEditorUI, BalloonEditorUIView };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map