@ckeditor/ckeditor5-ui 44.1.0 → 44.2.0-alpha.1

package/dist/index.js

@@ -1,6 +1,6 @@
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { Collection, CKEditorError, EmitterMixin, isNode, toArray, DomEmitterMixin, ObservableMixin, isIterable, uid, env, delay, getEnvKeystrokeText, isVisible, global, KeystrokeHandler, FocusTracker, Rect, toUnit, createElement, ResizeObserver, getBorderWidths, logWarning, getOptimalPosition, isText, isRange, priorities, first, parseBase64EncodedObject, getAncestors } from '@ckeditor/ckeditor5-utils/dist/index.js';
 import { cloneDeepWith, isObject, isElement, debounce, throttle, cloneDeep, extend, escapeRegExp, escape } from 'lodash-es';
@@ -1892,7 +1892,7 @@ const xhtmlNs = 'http://www.w3.org/1999/xhtml';
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/bindings/clickoutsidehandler
@@ -1929,7 +1929,7 @@ const xhtmlNs = 'http://www.w3.org/1999/xhtml';
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/bindings/injectcsstransitiondisabler
@@ -2001,7 +2001,7 @@ const xhtmlNs = 'http://www.w3.org/1999/xhtml';
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/bindings/csstransitiondisablermixin
@@ -2057,7 +2057,7 @@ const xhtmlNs = 'http://www.w3.org/1999/xhtml';
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/bindings/submithandler
@@ -2107,7 +2107,7 @@ const xhtmlNs = 'http://www.w3.org/1999/xhtml';
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/bindings/addkeyboardhandlingforgrid
@@ -3389,7 +3389,7 @@ const toPx$6 = /* #__PURE__ */ toUnit('px');
 	 */ _focusCycler;
     /**
 	 * @inheritDoc
-	 */ constructor(locale, { getCurrentDomRoot, getViewportOffset }){
+	 */ constructor(locale, { getCurrentDomRoot, getViewportOffset, keystrokeHandlerOptions }){
         super(locale);
         const bind = this.bindTemplate;
         const t = locale.t;
@@ -3417,7 +3417,8 @@ const toPx$6 = /* #__PURE__ */ toUnit('px');
                 focusPrevious: 'shift + tab',
                 // Navigate form fields forwards using the Tab key.
                 focusNext: 'tab'
-            }
+            },
+            keystrokeHandlerOptions
         });
         this.setTemplate({
             tag: 'div',
@@ -3841,7 +3842,9 @@ const toPx$6 = /* #__PURE__ */ toUnit('px');
 	 * @inheritDoc
 	 */ destroy() {
         super.destroy();
-        this._unlockBodyScroll();
+        if (Dialog._visibleDialogPlugin === this) {
+            this._unlockBodyScroll();
+        }
     }
     /**
 	 * Initiates listeners for the `show` and `hide` events emitted by this plugin.
@@ -3998,7 +4001,7 @@ const toPx$6 = /* #__PURE__ */ toUnit('px');
     }
     /**
 	 * Handles creating the {@link module:ui/dialog/dialogview~DialogView} instance and making it visible.
-	 */ _show({ id, icon, title, hasCloseButton = true, content, actionButtons, className, isModal, position, onHide }) {
+	 */ _show({ id, icon, title, hasCloseButton = true, content, actionButtons, className, isModal, position, onHide, keystrokeHandlerOptions }) {
         const editor = this.editor;
         this.view = new DialogView(editor.locale, {
             getCurrentDomRoot: ()=>{
@@ -4006,7 +4009,8 @@ const toPx$6 = /* #__PURE__ */ toUnit('px');
             },
             getViewportOffset: ()=>{
                 return editor.ui.viewportOffset;
-            }
+            },
+            keystrokeHandlerOptions
         });
         const view = this.view;
         view.on('close', ()=>{
@@ -4891,7 +4895,7 @@ var dropdownArrowIcon = "<svg viewBox=\"0 0 10 10\" xmlns=\"http://www.w3.org/20
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/colorgrid/utils
@@ -5123,7 +5127,7 @@ var checkIcon = "<svg viewBox=\"0 0 20 20\" xmlns=\"http://www.w3.org/2000/svg\"
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/colorpicker/utils
@@ -6705,7 +6709,7 @@ function getTextareaElementClone(element, value) {
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/dropdown/menu/utils
@@ -8439,7 +8443,7 @@ const POSITION_OFF_SCREEN = {
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/bindings/preventdefault
@@ -8474,7 +8478,7 @@ const POSITION_OFF_SCREEN = {
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/toolbar/normalizetoolbarconfig
@@ -8595,6 +8599,7 @@ const NESTED_TOOLBAR_ICONS = /* #__PURE__ */ (()=>({
         this.options = options || {};
         this.set('ariaLabel', t('Editor toolbar'));
         this.set('maxWidth', 'auto');
+        this.set('role', 'toolbar');
         this.items = this.createCollection();
         this.focusTracker = new FocusTracker();
         this.keystrokes = new KeystrokeHandler();
@@ -8635,7 +8640,7 @@ const NESTED_TOOLBAR_ICONS = /* #__PURE__ */ (()=>({
             tag: 'div',
             attributes: {
                 class: classes,
-                role: 'toolbar',
+                role: bind.to('role'),
                 'aria-label': bind.to('ariaLabel'),
                 style: {
                     maxWidth: bind.to('maxWidth')
@@ -11446,13 +11451,21 @@ const BALLOON_CLASS = 'ck-tooltip';
  *
  * # Disabling tooltips
  *
- * In order to disable the tooltip  temporarily, use the `data-cke-tooltip-disabled` attribute:
+ * In order to disable the tooltip temporarily, use the `data-cke-tooltip-disabled` attribute:
  *
  * ```ts
  * domElement.dataset.ckeTooltipText = 'Disabled. For now.';
  * domElement.dataset.ckeTooltipDisabled = 'true';
  * ```
  *
+ * # Instant tooltips
+ *
+ * To remove the delay before showing or hiding the tooltip, use the `data-cke-tooltip-instant` attribute:
+ *
+ * ```ts
+ * domElement.dataset.ckeTooltipInstant = 'true';
+ * ```
+ *
  * # Styling tooltips
  *
  * By default, the tooltip has `.ck-tooltip` class and its text inner `.ck-tooltip__text`.
@@ -11656,13 +11669,17 @@ const BALLOON_CLASS = 'ck-tooltip';
         // * a tooltip is displayed for a focused element, then the same element gets mouseentered,
         // * a tooltip is displayed for an element via mouseenter, then the focus moves to the same element.
         if (elementWithTooltipAttribute === this._currentElementWithTooltip) {
+            this._unpinTooltipDebounced.cancel();
             return;
         }
         this._unpinTooltip();
         // The tooltip should be pinned immediately when the element gets focused using keyboard.
         // If it is focused using the mouse, the tooltip should be pinned after a delay to prevent flashing.
         // See https://github.com/ckeditor/ckeditor5/issues/16383
-        if (evt.name === 'focus' && !elementWithTooltipAttribute.matches(':hover')) {
+        // Also, if the element has an attribute `data-cke-tooltip-instant`, the tooltip should be pinned immediately.
+        // This is useful for elements that have their content partially hidden (e.g. a long text in a small container)
+        // and should show a tooltip on hover, like merge field.
+        if (evt.name === 'focus' && !elementWithTooltipAttribute.matches(':hover') || elementWithTooltipAttribute.matches('[data-cke-tooltip-instant]')) {
             this._pinTooltip(elementWithTooltipAttribute, getTooltipData(elementWithTooltipAttribute));
         } else {
             this._pinTooltipDebounced(elementWithTooltipAttribute, getTooltipData(elementWithTooltipAttribute));
@@ -11700,7 +11717,13 @@ const BALLOON_CLASS = 'ck-tooltip';
             // Note that this should happen whether the tooltip is already visible or not, for instance,
             // it could be invisible but queued (debounced): it should get canceled.
             if (isLeavingBalloon || descendantWithTooltip && descendantWithTooltip !== relatedDescendantWithTooltip) {
-                this._unpinTooltipDebounced();
+                this._pinTooltipDebounced.cancel();
+                // If the currently visible tooltip is instant, unpin it immediately.
+                if (this._currentElementWithTooltip && this._currentElementWithTooltip.matches('[data-cke-tooltip-instant]') || descendantWithTooltip && descendantWithTooltip.matches('[data-cke-tooltip-instant]')) {
+                    this._unpinTooltip();
+                } else {
+                    this._unpinTooltipDebounced();
+                }
             }
         } else {
             // If a tooltip is currently visible, don't act for a targets other than the one it is attached to.
@@ -11710,6 +11733,7 @@ const BALLOON_CLASS = 'ck-tooltip';
             }
             // Note that unpinning should happen whether the tooltip is already visible or not, for instance, it could be invisible but
             // queued (debounced): it should get canceled (e.g. quick focus then quick blur using the keyboard).
+            this._pinTooltipDebounced.cancel();
             this._unpinTooltipDebounced();
         }
     }
@@ -12878,6 +12902,12 @@ const NESTED_PANEL_HORIZONTAL_OFFSET = 5;
  * 		label: 'View',
  * 		groups: [
  * 			{
+ * 				groupId: 'sourceEditingEnhanced',
+ * 				items: [
+ * 					'menuBar:sourceEditingEnhanced'
+ * 				]
+ * 			},
+ * 			{
  * 				groupId: 'sourceEditing',
  * 				items: [
  * 					'menuBar:sourceEditing'
@@ -12922,7 +12952,8 @@ const NESTED_PANEL_HORIZONTAL_OFFSET = 5;
  * 					'menuBar:link',
  * 					'menuBar:bookmark',
  * 					'menuBar:comment',
- * 					'menuBar:insertMergeField'
+ * 					'menuBar:insertMergeField',
+ * 					'menuBar:emoji'
  * 				]
  * 			},
  * 			{
@@ -13134,6 +13165,12 @@ const DefaultMenuBarItems = [
         menuId: 'view',
         label: 'View',
         groups: [
+            {
+                groupId: 'sourceEditingEnhanced',
+                items: [
+                    'menuBar:sourceEditingEnhanced'
+                ]
+            },
             {
                 groupId: 'sourceEditing',
                 items: [
@@ -13179,7 +13216,8 @@ const DefaultMenuBarItems = [
                     'menuBar:link',
                     'menuBar:bookmark',
                     'menuBar:comment',
-                    'menuBar:insertMergeField'
+                    'menuBar:insertMergeField',
+                    'menuBar:emoji'
                 ]
             },
             {
@@ -14609,7 +14647,7 @@ function isMenuDefinition(definition) {
 }
 
 /**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module ui/search/filtergroupanditemnames
@@ -17781,5 +17819,5 @@ const EVENT_NAME_DELEGATES = [
     }
 }
 
-export { AccessibilityHelp, AutocompleteView, BalloonPanelView, BalloonToolbar, BlockToolbar, BodyCollection, BoxedEditorUIView, ButtonLabelView, ButtonLabelWithHighlightView, ButtonView, CollapsibleView, ColorGridView, ColorPickerView, ColorSelectorView, ColorTileView, ComponentFactory, ContextualBalloon, CssTransitionDisablerMixin, DefaultMenuBarItems, Dialog, DialogView, DialogViewPosition, DropdownButtonView, DropdownMenuListItemButtonView, DropdownMenuListItemView, DropdownMenuListView, DropdownMenuNestedMenuView, DropdownMenuPanelPositioningFunctions, DropdownMenuRootListView, DropdownPanelView, DropdownView, EditorUI, EditorUIView, FileDialogButtonView, FileDialogListItemButtonView, FocusCycler, FormHeaderView, HighlightedTextView, IconView, IframeView, InlineEditableUIView, InputNumberView, InputTextView, InputView, LabelView, LabelWithHighlightView, LabeledFieldView, ListItemButtonView, ListItemGroupView, ListItemView, ListSeparatorView, ListView, MenuBarMenuListItemButtonView, MenuBarMenuListItemFileDialogButtonView, MenuBarMenuListItemView, MenuBarMenuListView, MenuBarMenuView, MenuBarView, Notification, SearchInfoView, SearchTextView, SpinnerView, SplitButtonView, StickyPanelView, SwitchButtonView, Template, TextareaView, ToolbarLineBreakView, ToolbarSeparatorView, ToolbarView, TooltipManager, View, ViewCollection, Model as ViewModel, addKeyboardHandlingForGrid, addListToDropdown, addMenuToDropdown, addToolbarToDropdown, clickOutsideHandler, createDropdown, createLabeledDropdown, createLabeledInputNumber, createLabeledInputText, createLabeledTextarea, filterGroupAndItemNames, focusChildOnDropdownOpen, getLocalizedColorOptions, injectCssTransitionDisabler, isFocusable, isViewWithFocusCycler, normalizeColorOptions, normalizeMenuBarConfig, normalizeSingleColorDefinition, normalizeToolbarConfig, submitHandler };
+export { AccessibilityHelp, AutocompleteView, BalloonPanelView, BalloonToolbar, BlockToolbar, BodyCollection, BoxedEditorUIView, ButtonLabelView, ButtonLabelWithHighlightView, ButtonView, CollapsibleView, ColorGridView, ColorPickerView, ColorSelectorView, ColorTileView, ComponentFactory, ContextualBalloon, CssTransitionDisablerMixin, DefaultMenuBarItems, Dialog, DialogView, DialogViewPosition, DocumentColorCollection, DropdownButtonView, DropdownMenuListItemButtonView, DropdownMenuListItemView, DropdownMenuListView, DropdownMenuNestedMenuView, DropdownMenuPanelPositioningFunctions, DropdownMenuRootListView, DropdownPanelView, DropdownView, EditorUI, EditorUIView, FileDialogButtonView, FileDialogListItemButtonView, FocusCycler, FormHeaderView, HighlightedTextView, IconView, IframeView, InlineEditableUIView, InputNumberView, InputTextView, InputView, LabelView, LabelWithHighlightView, LabeledFieldView, ListItemButtonView, ListItemGroupView, ListItemView, ListSeparatorView, ListView, MenuBarMenuListItemButtonView, MenuBarMenuListItemFileDialogButtonView, MenuBarMenuListItemView, MenuBarMenuListView, MenuBarMenuView, MenuBarView, Notification, SearchInfoView, SearchTextView, SpinnerView, SplitButtonView, StickyPanelView, SwitchButtonView, Template, TextareaView, ToolbarLineBreakView, ToolbarSeparatorView, ToolbarView, TooltipManager, View, ViewCollection, Model as ViewModel, addKeyboardHandlingForGrid, addListToDropdown, addMenuToDropdown, addToolbarToDropdown, clickOutsideHandler, createDropdown, createLabeledDropdown, createLabeledInputNumber, createLabeledInputText, createLabeledTextarea, filterGroupAndItemNames, focusChildOnDropdownOpen, getLocalizedColorOptions, injectCssTransitionDisabler, isFocusable, isViewWithFocusCycler, normalizeColorOptions, normalizeMenuBarConfig, normalizeSingleColorDefinition, normalizeToolbarConfig, submitHandler };
 //# sourceMappingURL=index.js.map