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

package/dist/widgettoolbarrepository.d.ts

@@ -1,101 +1,101 @@
 /**
- * @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 widget/widgettoolbarrepository
- */
-import { Plugin, type ToolbarConfigItem } from '@ckeditor/ckeditor5-core';
-import type { ViewDocumentSelection, ViewElement } from '@ckeditor/ckeditor5-engine';
-import { ContextualBalloon } from '@ckeditor/ckeditor5-ui';
-import { type PositioningFunction } from '@ckeditor/ckeditor5-utils';
+* @module widget/widgettoolbarrepository
+*/
+import { Plugin, type ToolbarConfigItem, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import type { ViewDocumentSelection, ViewElement } from "@ckeditor/ckeditor5-engine";
+import { ContextualBalloon } from "@ckeditor/ckeditor5-ui";
+import { type PositioningFunction } from "@ckeditor/ckeditor5-utils";
 /**
- * Widget toolbar repository plugin. A central point for registering widget toolbars. This plugin handles the whole
- * toolbar rendering process and exposes a concise API.
- *
- * To add a toolbar for your widget use the {@link ~WidgetToolbarRepository#register `WidgetToolbarRepository#register()`} method.
- *
- * The following example comes from the {@link module:image/imagetoolbar~ImageToolbar} plugin:
- *
- * ```ts
- * class ImageToolbar extends Plugin {
- * 	static get requires() {
- * 		return [ WidgetToolbarRepository ];
- * 	}
- *
- * 	afterInit() {
- * 		const editor = this.editor;
- * 		const widgetToolbarRepository = editor.plugins.get( WidgetToolbarRepository );
- *
- * 		widgetToolbarRepository.register( 'image', {
- * 			items: editor.config.get( 'image.toolbar' ),
- * 			getRelatedElement: getClosestSelectedImageWidget
- * 		} );
- * 	}
- * }
- * ```
- */
+* Widget toolbar repository plugin. A central point for registering widget toolbars. This plugin handles the whole
+* toolbar rendering process and exposes a concise API.
+*
+* To add a toolbar for your widget use the {@link ~WidgetToolbarRepository#register `WidgetToolbarRepository#register()`} method.
+*
+* The following example comes from the {@link module:image/imagetoolbar~ImageToolbar} plugin:
+*
+* ```ts
+* class ImageToolbar extends Plugin {
+* 	static get requires(): PluginDependenciesOf<[ WidgetToolbarRepository ]> {
+* 		return [ WidgetToolbarRepository ];
+* 	}
+*
+* 	afterInit() {
+* 		const editor = this.editor;
+* 		const widgetToolbarRepository = editor.plugins.get( WidgetToolbarRepository );
+*
+* 		widgetToolbarRepository.register( 'image', {
+* 			items: editor.config.get( 'image.toolbar' ),
+* 			getRelatedElement: getClosestSelectedImageWidget
+* 		} );
+* 	}
+* }
+* ```
+*/
 export declare class WidgetToolbarRepository extends Plugin {
-    /**
-     * A map of toolbar definitions.
-     */
-    private _toolbarDefinitions;
-    private _balloon;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ContextualBalloon];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "WidgetToolbarRepository";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    destroy(): void;
-    /**
-     * Registers toolbar in the WidgetToolbarRepository. It renders it in the `ContextualBalloon` based on the value of the invoked
-     * `getRelatedElement` function. Toolbar items are gathered from `items` array.
-     * The balloon's CSS class is by default `ck-toolbar-container` and may be override with the `balloonClassName` option.
-     *
-     * Note: This method should be called in the {@link module:core/plugin~PluginInterface#afterInit `Plugin#afterInit()`}
-     * callback (or later) to make sure that the given toolbar items were already registered by other plugins.
-     *
-     * @param toolbarId An id for the toolbar. Used to
-     * @param options Detailed options
-     * @param options.ariaLabel Label used by assistive technologies to describe this toolbar element.
-     * @param options.items Array of toolbar items.
-     * @param options.getRelatedElement Callback which returns an element the toolbar should be attached to.
-     * @param options.balloonClassName CSS class for the widget balloon.
-     */
-    register(toolbarId: string, { ariaLabel, items, getRelatedElement, balloonClassName, positions }: {
-        ariaLabel?: string;
-        items: Array<ToolbarConfigItem>;
-        getRelatedElement: (selection: ViewDocumentSelection) => (ViewElement | null);
-        balloonClassName?: string;
-        positions?: ReadonlyArray<PositioningFunction>;
-    }): void;
-    /**
-     * Iterates over stored toolbars and makes them visible or hidden.
-     */
-    private _updateToolbarsVisibility;
-    /**
-     * Hides the given toolbar.
-     */
-    private _hideToolbar;
-    /**
-     * Shows up the toolbar if the toolbar is not visible.
-     * Otherwise, repositions the toolbar's balloon when toolbar's view is the most top view in balloon stack.
-     *
-     * It might happen here that the toolbar's view is under another view. Then do nothing as the other toolbar view
-     * should be still visible after the {@link module:ui/editorui/editorui~EditorUI#event:update}.
-     */
-    private _showToolbar;
-    private _isToolbarVisible;
-    private _isToolbarInBalloon;
+	/**
+	* A map of toolbar definitions.
+	*/
+	private _toolbarDefinitions;
+	private _balloon;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[ContextualBalloon]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "WidgetToolbarRepository";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	override destroy(): void;
+	/**
+	* Registers toolbar in the WidgetToolbarRepository. It renders it in the `ContextualBalloon` based on the value of the invoked
+	* `getRelatedElement` function. Toolbar items are gathered from `items` array.
+	* The balloon's CSS class is by default `ck-toolbar-container` and may be override with the `balloonClassName` option.
+	*
+	* Note: This method should be called in the {@link module:core/plugin~PluginInterface#afterInit `Plugin#afterInit()`}
+	* callback (or later) to make sure that the given toolbar items were already registered by other plugins.
+	*
+	* @param toolbarId An id for the toolbar. Used to
+	* @param options Detailed options
+	* @param options.ariaLabel Label used by assistive technologies to describe this toolbar element.
+	* @param options.items Array of toolbar items.
+	* @param options.getRelatedElement Callback which returns an element the toolbar should be attached to.
+	* @param options.balloonClassName CSS class for the widget balloon.
+	*/
+	register(toolbarId: string, { ariaLabel, items, getRelatedElement, balloonClassName, positions }: {
+		ariaLabel?: string;
+		items: Array<ToolbarConfigItem>;
+		getRelatedElement: (selection: ViewDocumentSelection) => (ViewElement | null);
+		balloonClassName?: string;
+		positions?: ReadonlyArray<PositioningFunction>;
+	}): void;
+	/**
+	* Iterates over stored toolbars and makes them visible or hidden.
+	*/
+	private _updateToolbarsVisibility;
+	/**
+	* Hides the given toolbar.
+	*/
+	private _hideToolbar;
+	/**
+	* Shows up the toolbar if the toolbar is not visible.
+	* Otherwise, repositions the toolbar's balloon when toolbar's view is the most top view in balloon stack.
+	*
+	* It might happen here that the toolbar's view is under another view. Then do nothing as the other toolbar view
+	* should be still visible after the {@link module:ui/editorui/editorui~EditorUI#event:update}.
+	*/
+	private _showToolbar;
+	private _isToolbarVisible;
+	private _isToolbarInBalloon;
 }

package/dist/widgettypearound/utils.d.ts

@@ -1,46 +1,79 @@
 /**
- * @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 { ModelDocumentSelection, ViewDomConverter, ModelElement, ModelSchema, ModelSelection, ViewElement } from '@ckeditor/ckeditor5-engine';
-/**
- * The name of the type around model selection attribute responsible for
- * displaying a fake caret next to a selected widget.
- *
- * @internal
- */
+* @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 { ModelDocumentSelection, type ViewDomConverter, type ModelElement, type ModelSchema, type ModelSelection, type ViewElement } from "@ckeditor/ckeditor5-engine";
+/**
+* The name of the type around model selection attribute responsible for
+* displaying a fake caret next to a selected widget.
+*
+* @internal
+*/
 export declare const TYPE_AROUND_SELECTION_ATTRIBUTE = "widget-type-around";
 /**
- * Checks if an element is a widget that qualifies to get the widget type around UI.
- */
+* Checks if an element is a widget that qualifies to get the widget type around UI.
+*/
 export declare function isTypeAroundWidget(viewElement: ViewElement | undefined, modelElement: ModelElement, schema: ModelSchema): boolean;
 /**
- * For the passed HTML element, this helper finds the closest widget type around button ancestor.
- *
- * @internal
- */
+* For the passed HTML element, this helper finds the closest widget type around button ancestor.
+*
+* @internal
+*/
 export declare function getClosestTypeAroundDomButton(domElement: HTMLElement): HTMLElement | null;
 /**
- * For the passed widget type around button element, this helper determines at which position
- * the paragraph would be inserted into the content if, for instance, the button was
- * clicked by the user.
- *
- * @internal
- * @returns The position of the button.
- */
-export declare function getTypeAroundButtonPosition(domElement: HTMLElement): 'before' | 'after';
-/**
- * For the passed HTML element, this helper returns the closest view widget ancestor.
- *
- * @internal
- */
+* For the passed widget type around button element, this helper determines at which position
+* the paragraph would be inserted into the content if, for instance, the button was
+* clicked by the user.
+*
+* @internal
+* @returns The position of the button.
+*/
+export declare function getTypeAroundButtonPosition(domElement: HTMLElement): "before" | "after";
+/**
+* For the passed HTML element, this helper returns the closest view widget ancestor.
+*
+* @internal
+*/
 export declare function getClosestWidgetViewElement(domElement: HTMLElement, domConverter: ViewDomConverter): ViewElement;
 /**
- * For the passed selection instance, it returns the position of the fake caret displayed next to a widget.
- *
- * **Note**: If the fake caret is not currently displayed, `null` is returned.
- *
- * @internal
- * @returns The position of the fake caret or `null` when none is present.
- */
-export declare function getTypeAroundFakeCaretPosition(selection: ModelSelection | ModelDocumentSelection): 'before' | 'after' | null;
+* For the passed selection instance, it returns the position of the fake caret displayed next to a widget.
+*
+* **Note**: If the fake caret is not currently displayed, `null` is returned.
+*
+* @internal
+* @returns The position of the fake caret or `null` when none is present.
+*/
+export declare function getTypeAroundFakeCaretPosition(selection: ModelSelection | ModelDocumentSelection): "before" | "after" | null;
+/**
+* Looks for the `copyOnEnter` text formatting attributes (e.g. bold, font color) carried by the last piece
+* of inline content on the sibling that directly precedes a run of one or more consecutive block widgets.
+*
+* Used when the user inserts a new paragraph next to a widget (e.g. an image or a table) via the type-around
+* UI: the new, empty paragraph should continue whatever formatting was active right before the widget,
+* instead of starting unformatted:
+*
+* ```
+* <paragraph><$text bold="true">Bar</$text></paragraph><imageBlock></imageBlock>
+* ```
+*
+* Only the attributes carried by the *last* inline child of that sibling are considered - whatever precedes
+* it doesn't matter, because it's the last piece of content that reflects what the user was typing right
+* before reaching the widget:
+*
+* ```
+* // "bold" IS recovered here: "Bar", the last child, is bold. "Foo" not being bold is irrelevant.
+* <paragraph>Foo<$text bold="true">Bar</$text></paragraph><imageBlock></imageBlock>
+* ```
+*
+* If there is more than one widget in a row, the search continues past all of them until a sibling with
+* actual content (or the boundary of the parent) is found:
+*
+* ```
+* <paragraph><$text bold="true">Bar</$text></paragraph><imageBlock></imageBlock><imageBlock></imageBlock>
+* ```
+*
+* @param schema Model's schema.
+* @param widgetElement The widget model element.
+* @internal
+*/
+export declare function getCopyOnEnterTextAttributesBeforeWidgets(schema: ModelSchema, widgetElement: ModelElement): Array<[string, unknown]>;