@ckeditor/ckeditor5-widget 0.0.0-nightly-next-20250225.0 → 0.0.0-nightly-next-20250226.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-widget",
-  "version": "0.0.0-nightly-next-20250225.0",
+  "version": "0.0.0-nightly-next-20250226.0",
   "description": "Widget API for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,13 +12,13 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "0.0.0-nightly-next-20250225.0",
-    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-next-20250225.0",
-    "@ckeditor/ckeditor5-enter": "0.0.0-nightly-next-20250225.0",
-    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-next-20250225.0",
-    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-next-20250225.0",
-    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-next-20250225.0",
-    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-next-20250225.0",
+    "@ckeditor/ckeditor5-core": "0.0.0-nightly-next-20250226.0",
+    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-next-20250226.0",
+    "@ckeditor/ckeditor5-enter": "0.0.0-nightly-next-20250226.0",
+    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-next-20250226.0",
+    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-next-20250226.0",
+    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-next-20250226.0",
+    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-next-20250226.0",
     "es-toolkit": "1.32.0"
   },
   "author": "CKSource (http://cksource.com/)",

package/src/widgettoolbarrepository.d.ts

@@ -8,6 +8,7 @@
 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';
 /**
  * Widget toolbar repository plugin. A central point for registering widget toolbars. This plugin handles the whole
  * toolbar rendering process and exposes a concise API.
@@ -71,11 +72,12 @@ export default class WidgetToolbarRepository extends Plugin {
      * @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 }: {
+    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.

package/src/widgettoolbarrepository.js

@@ -105,7 +105,7 @@ export default class WidgetToolbarRepository extends Plugin {
      * @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, { ariaLabel, items, getRelatedElement, balloonClassName = 'ck-toolbar-container' }) {
+    register(toolbarId, { ariaLabel, items, getRelatedElement, balloonClassName = 'ck-toolbar-container', positions }) {
         // Trying to register a toolbar without any item.
         if (!items.length) {
             /**
@@ -143,6 +143,7 @@ export default class WidgetToolbarRepository extends Plugin {
             getRelatedElement,
             balloonClassName,
             itemsConfig: items,
+            positions,
             initialized: false
         };
         // Register the toolbar so it becomes available for Alt+F10 and Esc navigation.
@@ -212,7 +213,7 @@ export default class WidgetToolbarRepository extends Plugin {
      */
     _showToolbar(toolbarDefinition, relatedElement) {
         if (this._isToolbarVisible(toolbarDefinition)) {
-            repositionContextualBalloon(this.editor, relatedElement);
+            repositionContextualBalloon(this.editor, relatedElement, toolbarDefinition.positions);
         }
         else if (!this._isToolbarInBalloon(toolbarDefinition)) {
             if (!toolbarDefinition.initialized) {
@@ -221,7 +222,7 @@ export default class WidgetToolbarRepository extends Plugin {
             }
             this._balloon.add({
                 view: toolbarDefinition.view,
-                position: getBalloonPositionData(this.editor, relatedElement),
+                position: getBalloonPositionData(this.editor, relatedElement, toolbarDefinition.positions),
                 balloonClassName: toolbarDefinition.balloonClassName
             });
             // Update toolbar position each time stack with toolbar view is switched to visible.
@@ -232,7 +233,7 @@ export default class WidgetToolbarRepository extends Plugin {
                 for (const definition of this._toolbarDefinitions.values()) {
                     if (this._isToolbarVisible(definition)) {
                         const relatedElement = definition.getRelatedElement(this.editor.editing.view.document.selection);
-                        repositionContextualBalloon(this.editor, relatedElement);
+                        repositionContextualBalloon(this.editor, relatedElement, toolbarDefinition.positions);
                     }
                 }
             });
@@ -245,17 +246,17 @@ export default class WidgetToolbarRepository extends Plugin {
         return this._balloon.hasView(toolbar.view);
     }
 }
-function repositionContextualBalloon(editor, relatedElement) {
+function repositionContextualBalloon(editor, relatedElement, positions) {
     const balloon = editor.plugins.get('ContextualBalloon');
-    const position = getBalloonPositionData(editor, relatedElement);
+    const position = getBalloonPositionData(editor, relatedElement, positions);
     balloon.updatePosition(position);
 }
-function getBalloonPositionData(editor, relatedElement) {
+function getBalloonPositionData(editor, relatedElement, positions) {
     const editingView = editor.editing.view;
     const defaultPositions = BalloonPanelView.defaultPositions;
     return {
         target: editingView.domConverter.mapViewToDom(relatedElement),
-        positions: [
+        positions: positions || [
             defaultPositions.northArrowSouth,
             defaultPositions.northArrowSouthWest,
             defaultPositions.northArrowSouthEast,