@ckeditor/ckeditor5-ui 40.1.0 → 41.0.0

package/lang/translations/sr-latn.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -31,11 +31,11 @@ msgstr "Blok uređivač"
 
 msgctxt "First part of the label of the block toolbar icon when functionality of drag and drop is available (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Click to edit block"
-msgstr ""
+msgstr "Kliknite da biste uredili blok"
 
 msgctxt "Second part of the label of the block toolbar icon when functionality of drag and drop is available (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Drag to move"
-msgstr ""
+msgstr "Prevucite da biste premestili"
 
 msgctxt "Label for a button showing the next thing (tab, page, etc.)."
 msgid "Next"
@@ -123,16 +123,24 @@ msgstr "Kontekstualna traka sa alatkama Editor"
 
 msgctxt "Label of an input field for typing colors in the HEX color format."
 msgid "HEX"
-msgstr ""
+msgstr "HEX"
 
 msgctxt "Label of the button closing the color picker and confirming the changes done in the color selector component."
 msgid "Accept"
-msgstr ""
+msgstr "Prihvati"
 
 msgctxt "The main text of the message shown to the user when given query does not match any results."
 msgid "No results found"
-msgstr ""
+msgstr "Nije pronađen nijedan rezultat"
 
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
+msgstr "Nema stavki koje se mogu pretražiti"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr ""
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
 msgstr ""

package/lang/translations/sr.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "Nije pronađen nijedan rezultat"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "Nema stavki koje se mogu pretražiti"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "Dijalog za uređivanje"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "Zatvori"

package/lang/translations/sv.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "Inga resultat hittades"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "Inga sökbara objekt"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "Ordbehandlardialog"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "Stäng"

package/lang/translations/th.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "ไม่พบผลลัพธ์"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "ไม่มีรายการที่สามารถค้นหาได้"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "การสนทนาของบรรณาธิการ"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "ปิด"

package/lang/translations/tk.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr ""
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr ""
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr ""
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr ""

package/lang/translations/tr.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "Sonuç bulunamadı"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "Aranabilir öge yok"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "Düzenleyici iletişim kutusu"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "Kapat"

package/lang/translations/tt.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr ""
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr ""
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr ""
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr ""

package/lang/translations/ug.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "ھېچقانداق نەتىجە تېپىلمىدى"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "ئىزدىگۈدەك تۈر يوق"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr ""
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr ""

package/lang/translations/uk.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "Нічого не знайдено"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "Немає шуканих об'єктів"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "Діалогове вікно редактора"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "Закрити"

package/lang/translations/ur.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr ""
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr ""
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr ""
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr ""

package/lang/translations/uz.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr ""
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr ""
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr ""
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr ""

package/lang/translations/vi.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "Không tìm thấy kết quả"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "Không có mục nào tìm kiếm được"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "Hộp thoại trình biên tập"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "Đóng"

package/lang/translations/zh-cn.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "未找到结果"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "没有可搜索的项目"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "编辑器对话框"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "关闭"

package/lang/translations/zh.po

@@ -1,4 +1,4 @@
-# Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
 #
 #                                     !!! IMPORTANT !!!
 #
@@ -136,3 +136,11 @@ msgstr "找不到結果"
 msgctxt "The main text of the message shown to the user when no results are available."
 msgid "No searchable items"
 msgstr "沒有可搜尋的項目"
+
+msgctxt "A default label of a dialog window displayed on top the editor."
+msgid "Editor dialog"
+msgstr "編輯工具對話框"
+
+msgctxt "The label and the tooltip for the close button in the dialog header."
+msgid "Close"
+msgstr "關閉"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-ui",
-  "version": "40.1.0",
+  "version": "41.0.0",
   "description": "The UI framework and standard UI library of CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -9,10 +9,11 @@
     "ckeditor5-lib",
     "ckeditor5-dll"
   ],
+  "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "40.1.0",
-    "@ckeditor/ckeditor5-utils": "40.1.0",
+    "@ckeditor/ckeditor5-core": "41.0.0",
+    "@ckeditor/ckeditor5-utils": "41.0.0",
     "color-convert": "2.0.1",
     "color-parse": "1.4.2",
     "lodash-es": "4.17.21",

package/src/arialiveannouncer.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
@@ -7,18 +7,22 @@
  */
 import type { Editor } from '@ckeditor/ckeditor5-core';
 import type { Locale } from '@ckeditor/ckeditor5-utils';
-import type ViewCollection from './viewcollection';
-import View from './view';
+import type ViewCollection from './viewcollection.js';
+import View from './view.js';
 import '../theme/components/arialiveannouncer/arialiveannouncer.css';
 /**
  * The politeness level of an `aria-live` announcement.
  *
- * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Live_Regions#Politeness_levels
+ * Available keys are:
+ * * `AriaLiveAnnouncerPoliteness.POLITE`,
+ * * `AriaLiveAnnouncerPoliteness.ASSERTIVE`
+ *
+ * [Learn more](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Live_Regions#Politeness_levels).
  */
-export declare enum AriaLiveAnnouncerPoliteness {
-    POLITE = "polite",
-    ASSERTIVE = "assertive"
-}
+export declare const AriaLiveAnnouncerPoliteness: {
+    readonly POLITE: "polite";
+    readonly ASSERTIVE: "assertive";
+};
 /**
  * An accessibility helper that manages all ARIA live regions associated with an editor instance. ARIA live regions announce changes
  * to the state of the editor features.
@@ -62,7 +66,7 @@ export default class AriaLiveAnnouncer {
      * editor.ui.ariaLiveAnnouncer.announce( 'network', 'Connection lost. Reconnecting.' );
      * ```
      */
-    announce(regionName: string, announcementText: string, politeness?: AriaLiveAnnouncerPoliteness): void;
+    announce(regionName: string, announcementText: string, politeness?: typeof AriaLiveAnnouncerPoliteness[keyof typeof AriaLiveAnnouncerPoliteness]): void;
 }
 /**
  * The view that aggregates all `aria-live` regions.
@@ -85,7 +89,7 @@ export declare class AriaLiveAnnouncerRegionView extends View {
     /**
      * Current politeness level of the region.
      */
-    politeness: AriaLiveAnnouncerPoliteness;
+    politeness: typeof AriaLiveAnnouncerPoliteness[keyof typeof AriaLiveAnnouncerPoliteness];
     /**
      * A unique name of the region, usually associated with a specific editor feature or system.
      */

package/src/arialiveannouncer.js

@@ -1,19 +1,22 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import View from './view';
+import View from './view.js';
 import '../theme/components/arialiveannouncer/arialiveannouncer.css';
 /**
  * The politeness level of an `aria-live` announcement.
  *
- * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Live_Regions#Politeness_levels
+ * Available keys are:
+ * * `AriaLiveAnnouncerPoliteness.POLITE`,
+ * * `AriaLiveAnnouncerPoliteness.ASSERTIVE`
+ *
+ * [Learn more](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Live_Regions#Politeness_levels).
  */
-export var AriaLiveAnnouncerPoliteness;
-(function (AriaLiveAnnouncerPoliteness) {
-    AriaLiveAnnouncerPoliteness["POLITE"] = "polite";
-    AriaLiveAnnouncerPoliteness["ASSERTIVE"] = "assertive";
-})(AriaLiveAnnouncerPoliteness || (AriaLiveAnnouncerPoliteness = {}));
+export const AriaLiveAnnouncerPoliteness = {
+    POLITE: 'polite',
+    ASSERTIVE: 'assertive'
+};
 /**
  * An accessibility helper that manages all ARIA live regions associated with an editor instance. ARIA live regions announce changes
  * to the state of the editor features.

package/src/augmentation.d.ts

@@ -1,8 +1,8 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import type { BalloonToolbar, BlockToolbar, ContextualBalloon, Notification } from './index';
+import type { BalloonToolbar, BlockToolbar, ContextualBalloon, Notification, Dialog } from './index.js';
 import type { ToolbarConfig } from '@ckeditor/ckeditor5-core';
 declare module '@ckeditor/ckeditor5-core' {
     interface EditorConfig {
@@ -81,6 +81,7 @@ declare module '@ckeditor/ckeditor5-core' {
         [BalloonToolbar.pluginName]: BalloonToolbar;
         [BlockToolbar.pluginName]: BlockToolbar;
         [ContextualBalloon.pluginName]: ContextualBalloon;
+        [Dialog.pluginName]: Dialog;
         [Notification.pluginName]: Notification;
     }
 }

package/src/augmentation.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 export {};

package/src/autocomplete/autocompleteview.d.ts

@@ -1,14 +1,14 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
  * @module ui/autocomplete/autocompleteview
 */
 import { type PositioningFunction, type Locale } from '@ckeditor/ckeditor5-utils';
-import SearchTextView, { type SearchTextViewConfig } from '../search/text/searchtextview';
-import type SearchResultsView from '../search/searchresultsview';
-import type InputBase from '../input/inputbase';
+import SearchTextView, { type SearchTextViewConfig } from '../search/text/searchtextview.js';
+import type SearchResultsView from '../search/searchresultsview.js';
+import type InputBase from '../input/inputbase.js';
 import '../../theme/components/autocomplete/autocomplete.css';
 /**
  * The autocomplete component's view class. It extends the {@link module:ui/search/text/searchtextview~SearchTextView} class

package/src/autocomplete/autocompleteview.js

@@ -1,19 +1,19 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
  * @module ui/autocomplete/autocompleteview
 */
 import { getOptimalPosition, global, toUnit, Rect } from '@ckeditor/ckeditor5-utils';
-import SearchTextView from '../search/text/searchtextview';
+import SearchTextView from '../search/text/searchtextview.js';
 import '../../theme/components/autocomplete/autocomplete.css';
 /**
  * The autocomplete component's view class. It extends the {@link module:ui/search/text/searchtextview~SearchTextView} class
  * with a floating {@link #resultsView} that shows up when the user starts typing and hides when they blur
  * the component.
  */
-export default class AutocompleteView extends SearchTextView {
+class AutocompleteView extends SearchTextView {
     /**
      * @inheritDoc
      */
@@ -151,3 +151,4 @@ AutocompleteView.defaultResultsPositions = [
  * A function used to calculate the optimal position for the dropdown panel.
  */
 AutocompleteView._getOptimalPosition = getOptimalPosition;
+export default AutocompleteView;

package/src/bindings/addkeyboardhandlingforgrid.d.ts

@@ -1,12 +1,12 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
  * @module ui/bindings/addkeyboardhandlingforgrid
  */
 import type { FocusTracker, KeystrokeHandler } from '@ckeditor/ckeditor5-utils';
-import type ViewCollection from '../viewcollection';
+import type ViewCollection from '../viewcollection.js';
 /**
  * A helper that adds a keyboard navigation support (arrow up/down/left/right) for grids.
  *

package/src/bindings/addkeyboardhandlingforgrid.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/bindings/clickoutsidehandler.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/bindings/clickoutsidehandler.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /* global document */

package/src/bindings/csstransitiondisablermixin.d.ts

@@ -1,12 +1,12 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
  * @module ui/bindings/csstransitiondisablermixin
  */
 import type { Constructor, Mixed } from '@ckeditor/ckeditor5-utils';
-import type View from '../view';
+import type View from '../view.js';
 /**
  * A mixin that brings the possibility to temporarily disable CSS transitions using
  * {@link module:ui/view~View} methods. It is helpful when, for instance, the transitions should not happen

package/src/bindings/csstransitiondisablermixin.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/bindings/draggableviewmixin.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @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
+ */
+/**
+ * @module ui/bindings/draggableviewmixin
+ */
+import type View from '../view.js';
+import { type Constructor, type Mixed } from '@ckeditor/ckeditor5-utils';
+/**
+ * A mixin that brings the possibility to observe dragging of the view element.
+ * The view has to implement the {@link ~DraggableView} interface to use it:
+ *
+ * ```js
+ * export default class MyDraggableView extends DraggableViewMixin( View ) implements DraggableView {
+ * 		// ...
+ * }
+ * ```
+ *
+ * Creating a class extending it attaches a set of mouse and touch listeners allowing to observe dragging of the view element:
+ * * `mousedown` and `touchstart` on the view element - starting the dragging,
+ * * `mousemove` and `touchmove` on the document - updating the view coordinates,
+ * * `mouseup` and `touchend` on the document - stopping the dragging.
+ *
+ * The mixin itself doesn't provide a visual feedback (i.e. the dragged element doesn't change its position) -
+ * it's up to the developer to implement it.
+ */
+export default function DraggableViewMixin<Base extends Constructor<View>>(view: Base): Mixed<Base, DraggableView>;
+/**
+ * An interface that should be implemented by views that want to be draggable.
+ */
+export interface DraggableView extends View {
+    get dragHandleElement(): HTMLElement | null;
+}
+/**
+ * An event data object for the {@link ~DraggableView} `drag` event. Fired when the view is dragged.
+ */
+export type DraggableViewDragEvent = {
+    name: 'drag';
+    args: [
+        {
+            deltaX: number;
+            deltaY: number;
+        }
+    ];
+};