@ckeditor/ckeditor5-widget 0.0.0-internal-20241017.0

package/lang/translations/uk.po

@@ -0,0 +1,58 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Ukrainian (https://app.transifex.com/ckeditor/teams/11143/uk/)\n"
+"Language: uk\n"
+"Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3);\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "The label used by assistive technologies describing a toolbar attached to a widget."
+msgid "Widget toolbar"
+msgstr "Панель інструментів віджетів"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph before a block."
+msgid "Insert paragraph before block"
+msgstr "Додати абзац перед блоком"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph after a block."
+msgid "Insert paragraph after block"
+msgstr "Додати абзац після блока"
+
+msgctxt "Information to be read by screen reader about shortcuts to type around a widget."
+msgid "Press Enter to type after or press Shift + Enter to type before the widget"
+msgstr "Натисніть Enter, щоб друкувати після або натисніть Shift + Enter, щоб друкувати перед віджетом"
+
+msgctxt "Accessibility help dialog section title for widget plugin keystrokes."
+msgid "Keystrokes that can be used when a widget is selected (for example: image, table, etc.)"
+msgstr "Натискання клавіш, які можна використовувати, коли вибрано віджет (наприклад: зображення, таблиця тощо)"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph after a widget."
+msgid "Insert a new paragraph directly after a widget"
+msgstr "Вставити новий абзац безпосередньо після віджета"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph before a widget."
+msgid "Insert a new paragraph directly before a widget"
+msgstr "Вставити новий абзац безпосередньо перед віджетом"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret before a widget."
+msgid "Move the caret to allow typing directly before a widget"
+msgstr "Перемістіть курсор, щоб дозволити введення безпосередньо перед віджетом"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret after a widget."
+msgid "Move the caret to allow typing directly after a widget"
+msgstr "Перемістіть курсор, щоб дозволити введення безпосередньо після віджета"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves selection from a nested editable area back to the parent widget."
+msgid "Move focus from an editable area back to the parent widget"
+msgstr "Переміщення фокусу з області редагування назад до батьківського віджета"

package/lang/translations/ur.po

@@ -0,0 +1,58 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Urdu (https://app.transifex.com/ckeditor/teams/11143/ur/)\n"
+"Language: ur\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "The label used by assistive technologies describing a toolbar attached to a widget."
+msgid "Widget toolbar"
+msgstr "آلہ جات برائے وجٹ"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph before a block."
+msgid "Insert paragraph before block"
+msgstr "پیراگراف سے پہلے کوڈ خانہ نصب کریں"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph after a block."
+msgid "Insert paragraph after block"
+msgstr "پیراگراف کے بعد کوڈ خانہ نصب کریں"
+
+msgctxt "Information to be read by screen reader about shortcuts to type around a widget."
+msgid "Press Enter to type after or press Shift + Enter to type before the widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog section title for widget plugin keystrokes."
+msgid "Keystrokes that can be used when a widget is selected (for example: image, table, etc.)"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph after a widget."
+msgid "Insert a new paragraph directly after a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph before a widget."
+msgid "Insert a new paragraph directly before a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret before a widget."
+msgid "Move the caret to allow typing directly before a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret after a widget."
+msgid "Move the caret to allow typing directly after a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves selection from a nested editable area back to the parent widget."
+msgid "Move focus from an editable area back to the parent widget"
+msgstr ""

package/lang/translations/uz.po

@@ -0,0 +1,58 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Uzbek (https://app.transifex.com/ckeditor/teams/11143/uz/)\n"
+"Language: uz\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "The label used by assistive technologies describing a toolbar attached to a widget."
+msgid "Widget toolbar"
+msgstr "Vidjet asboblar paneli"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph before a block."
+msgid "Insert paragraph before block"
+msgstr "Blokdan oldin paragrafni kiritish"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph after a block."
+msgid "Insert paragraph after block"
+msgstr "Вblokdan keyin paragraf qo'yish"
+
+msgctxt "Information to be read by screen reader about shortcuts to type around a widget."
+msgid "Press Enter to type after or press Shift + Enter to type before the widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog section title for widget plugin keystrokes."
+msgid "Keystrokes that can be used when a widget is selected (for example: image, table, etc.)"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph after a widget."
+msgid "Insert a new paragraph directly after a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph before a widget."
+msgid "Insert a new paragraph directly before a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret before a widget."
+msgid "Move the caret to allow typing directly before a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret after a widget."
+msgid "Move the caret to allow typing directly after a widget"
+msgstr ""
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves selection from a nested editable area back to the parent widget."
+msgid "Move focus from an editable area back to the parent widget"
+msgstr ""

package/lang/translations/vi.po

@@ -0,0 +1,58 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Vietnamese (https://app.transifex.com/ckeditor/teams/11143/vi/)\n"
+"Language: vi\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "The label used by assistive technologies describing a toolbar attached to a widget."
+msgid "Widget toolbar"
+msgstr "Thanh công cụ tiện ích"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph before a block."
+msgid "Insert paragraph before block"
+msgstr "Chèn đoạn trước khối"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph after a block."
+msgid "Insert paragraph after block"
+msgstr "Chèn đoạn sau khối"
+
+msgctxt "Information to be read by screen reader about shortcuts to type around a widget."
+msgid "Press Enter to type after or press Shift + Enter to type before the widget"
+msgstr "Nhấn Enter để nhập vào sau hoặc nhấn Shift + Enter để nhập vào trước tiện ích"
+
+msgctxt "Accessibility help dialog section title for widget plugin keystrokes."
+msgid "Keystrokes that can be used when a widget is selected (for example: image, table, etc.)"
+msgstr "Tổ hợp phím mà bạn có thể dùng khi một tiện ích được chọn (ví dụ: hình ảnh, bảng, v.v.)"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph after a widget."
+msgid "Insert a new paragraph directly after a widget"
+msgstr "Chèn đoạn văn mới ngay sau tiện ích"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph before a widget."
+msgid "Insert a new paragraph directly before a widget"
+msgstr "Chèn đoạn văn mới ngay trước tiện ích"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret before a widget."
+msgid "Move the caret to allow typing directly before a widget"
+msgstr "Di chuyển dấu sót để cho phép nhập ngay trước một tiện ích"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret after a widget."
+msgid "Move the caret to allow typing directly after a widget"
+msgstr "Di chuyển dấu sót để cho phép nhập ngay sau một tiện ích"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves selection from a nested editable area back to the parent widget."
+msgid "Move focus from an editable area back to the parent widget"
+msgstr "Di chuyển tiêu điểm từ vùng có thể chỉnh sửa trở lại tiện ích gốc"

package/lang/translations/zh-cn.po

@@ -0,0 +1,58 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Chinese (China) (https://app.transifex.com/ckeditor/teams/11143/zh_CN/)\n"
+"Language: zh_CN\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "The label used by assistive technologies describing a toolbar attached to a widget."
+msgid "Widget toolbar"
+msgstr "小部件工具栏"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph before a block."
+msgid "Insert paragraph before block"
+msgstr "在前面插入段落"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph after a block."
+msgid "Insert paragraph after block"
+msgstr "在后面插入段落"
+
+msgctxt "Information to be read by screen reader about shortcuts to type around a widget."
+msgid "Press Enter to type after or press Shift + Enter to type before the widget"
+msgstr "按下“Enter”键，在小组件后输入；按下“Shift+Enter”键，在小组件前输入"
+
+msgctxt "Accessibility help dialog section title for widget plugin keystrokes."
+msgid "Keystrokes that can be used when a widget is selected (for example: image, table, etc.)"
+msgstr "当小组件被选中时（例如：图片、表格等）可以使用的按键"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph after a widget."
+msgid "Insert a new paragraph directly after a widget"
+msgstr "直接在小组件之后插入新段落"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph before a widget."
+msgid "Insert a new paragraph directly before a widget"
+msgstr "直接在小组件之前插入新段落"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret before a widget."
+msgid "Move the caret to allow typing directly before a widget"
+msgstr "移动插入符，以允许在小组件之前直接输入文字"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret after a widget."
+msgid "Move the caret to allow typing directly after a widget"
+msgstr "移动插入符，以允许在小组件之后直接输入文字"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves selection from a nested editable area back to the parent widget."
+msgid "Move focus from an editable area back to the parent widget"
+msgstr "将焦点从可编辑区域移回父窗口小组件"

package/lang/translations/zh.po

@@ -0,0 +1,58 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Chinese (Taiwan) (https://app.transifex.com/ckeditor/teams/11143/zh_TW/)\n"
+"Language: zh_TW\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "The label used by assistive technologies describing a toolbar attached to a widget."
+msgid "Widget toolbar"
+msgstr "小工具"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph before a block."
+msgid "Insert paragraph before block"
+msgstr "在這個區塊前面插入一個段落"
+
+msgctxt "The title displayed when a mouse is over a button that inserts a paragraph after a block."
+msgid "Insert paragraph after block"
+msgstr "在這個區塊後面插入一個段落"
+
+msgctxt "Information to be read by screen reader about shortcuts to type around a widget."
+msgid "Press Enter to type after or press Shift + Enter to type before the widget"
+msgstr "按下 Enter 在小工具後輸入，或按下 Shift + Enter 在小工具前輸入"
+
+msgctxt "Accessibility help dialog section title for widget plugin keystrokes."
+msgid "Keystrokes that can be used when a widget is selected (for example: image, table, etc.)"
+msgstr "小工具選取時可使用的按鍵（例如：圖片、表格等）"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph after a widget."
+msgid "Insert a new paragraph directly after a widget"
+msgstr "在小工具後直接插入新段落"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that inserts a paragraph before a widget."
+msgid "Insert a new paragraph directly before a widget"
+msgstr "在小工具前直接插入新段落"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret before a widget."
+msgid "Move the caret to allow typing directly before a widget"
+msgstr "移動插入符號，以便在小工具前直接輸入"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves the caret after a widget."
+msgid "Move the caret to allow typing directly after a widget"
+msgstr "移動插入符號，以便在小工具後直接輸入"
+
+msgctxt "Accessibility help dialog entry explaining the meaning of the keystroke that moves selection from a nested editable area back to the parent widget."
+msgid "Move focus from an editable area back to the parent widget"
+msgstr "將焦點從可編輯區域移回上層小工具"

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@ckeditor/ckeditor5-widget",
+  "version": "0.0.0-internal-20241017.0",
+  "description": "Widget API for CKEditor 5.",
+  "keywords": [
+    "ckeditor",
+    "ckeditor5",
+    "ckeditor 5",
+    "ckeditor5-lib",
+    "ckeditor5-dll"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "dependencies": {
+    "@ckeditor/ckeditor5-core": "0.0.0-internal-20241017.0",
+    "@ckeditor/ckeditor5-engine": "0.0.0-internal-20241017.0",
+    "@ckeditor/ckeditor5-enter": "0.0.0-internal-20241017.0",
+    "@ckeditor/ckeditor5-ui": "0.0.0-internal-20241017.0",
+    "@ckeditor/ckeditor5-utils": "0.0.0-internal-20241017.0",
+    "@ckeditor/ckeditor5-typing": "0.0.0-internal-20241017.0",
+    "lodash-es": "4.17.21"
+  },
+  "author": "CKSource (http://cksource.com/)",
+  "license": "GPL-2.0-or-later",
+  "homepage": "https://ckeditor.com/ckeditor-5",
+  "bugs": "https://github.com/ckeditor/ckeditor5/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ckeditor/ckeditor5.git",
+    "directory": "packages/ckeditor5-widget"
+  },
+  "files": [
+    "dist",
+    "lang",
+    "src/**/*.js",
+    "src/**/*.d.ts",
+    "theme",
+    "ckeditor5-metadata.json",
+    "CHANGELOG.md"
+  ],
+  "types": "src/index.d.ts"
+}

package/src/augmentation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @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 { Widget, WidgetResize, WidgetToolbarRepository, WidgetTypeAround } from './index.js';
+declare module '@ckeditor/ckeditor5-core' {
+    interface PluginsMap {
+        [Widget.pluginName]: Widget;
+        [WidgetResize.pluginName]: WidgetResize;
+        [WidgetToolbarRepository.pluginName]: WidgetToolbarRepository;
+        [WidgetTypeAround.pluginName]: WidgetTypeAround;
+    }
+}

package/src/augmentation.js

@@ -0,0 +1,5 @@
+/**
+ * @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/highlightstack.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @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 { DowncastWriter, HighlightDescriptor } from '@ckeditor/ckeditor5-engine';
+declare const HighlightStack_base: {
+    new (): import("@ckeditor/ckeditor5-utils").Emitter;
+    prototype: import("@ckeditor/ckeditor5-utils").Emitter;
+};
+/**
+ * Class used to handle the correct order of highlights on elements.
+ *
+ * When different highlights are applied to same element the correct order should be preserved:
+ *
+ * * highlight with highest priority should be applied,
+ * * if two highlights have same priority - sort by CSS class provided in
+ * {@link module:engine/conversion/downcasthelpers~HighlightDescriptor}.
+ *
+ * This way, highlight will be applied with the same rules it is applied on texts.
+ */
+export default class HighlightStack extends /* #__PURE__ */ HighlightStack_base {
+    private readonly _stack;
+    /**
+     * Adds highlight descriptor to the stack.
+     *
+     * @fires change:top
+     */
+    add(descriptor: HighlightDescriptor, writer: DowncastWriter): void;
+    /**
+     * Removes highlight descriptor from the stack.
+     *
+     * @fires change:top
+     * @param id Id of the descriptor to remove.
+     */
+    remove(id: string, writer: DowncastWriter): void;
+    /**
+     * Inserts a given descriptor in correct place in the stack. It also takes care about updating information
+     * when descriptor with same id is already present.
+     */
+    private _insertDescriptor;
+    /**
+     * Removes descriptor with given id from the stack.
+     *
+     * @param id Descriptor's id.
+     */
+    private _removeDescriptor;
+}
+/**
+ * Fired when top element on {@link module:widget/highlightstack~HighlightStack} has been changed
+ *
+ * @eventName ~HighlightStack#change:top
+ */
+export type HighlightStackChangeEvent = {
+    name: 'change' | 'change:top';
+    args: [HighlightStackChangeEventData];
+};
+/**
+ * Additional information about the change.
+ */
+export type HighlightStackChangeEventData = {
+    /**
+     * Old highlight descriptor. It will be `undefined` when first descriptor is added to the stack.
+     */
+    oldDescriptor: HighlightDescriptor;
+    /**
+     * New highlight descriptor. It will be `undefined` when last descriptor is removed from the stack.
+     */
+    newDescriptor: HighlightDescriptor;
+    /**
+     * View writer that can be used to modify element.
+     */
+    writer: DowncastWriter;
+};
+export {};

package/src/highlightstack.js

@@ -0,0 +1,129 @@
+/**
+ * @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 widget/highlightstack
+ */
+import { EmitterMixin } from '@ckeditor/ckeditor5-utils';
+/**
+ * Class used to handle the correct order of highlights on elements.
+ *
+ * When different highlights are applied to same element the correct order should be preserved:
+ *
+ * * highlight with highest priority should be applied,
+ * * if two highlights have same priority - sort by CSS class provided in
+ * {@link module:engine/conversion/downcasthelpers~HighlightDescriptor}.
+ *
+ * This way, highlight will be applied with the same rules it is applied on texts.
+ */
+export default class HighlightStack extends /* #__PURE__ */ EmitterMixin() {
+    constructor() {
+        super(...arguments);
+        this._stack = [];
+    }
+    /**
+     * Adds highlight descriptor to the stack.
+     *
+     * @fires change:top
+     */
+    add(descriptor, writer) {
+        const stack = this._stack;
+        // Save top descriptor and insert new one. If top is changed - fire event.
+        const oldTop = stack[0];
+        this._insertDescriptor(descriptor);
+        const newTop = stack[0];
+        // When new object is at the top and stores different information.
+        if (oldTop !== newTop && !compareDescriptors(oldTop, newTop)) {
+            this.fire('change:top', {
+                oldDescriptor: oldTop,
+                newDescriptor: newTop,
+                writer
+            });
+        }
+    }
+    /**
+     * Removes highlight descriptor from the stack.
+     *
+     * @fires change:top
+     * @param id Id of the descriptor to remove.
+     */
+    remove(id, writer) {
+        const stack = this._stack;
+        const oldTop = stack[0];
+        this._removeDescriptor(id);
+        const newTop = stack[0];
+        // When new object is at the top and stores different information.
+        if (oldTop !== newTop && !compareDescriptors(oldTop, newTop)) {
+            this.fire('change:top', {
+                oldDescriptor: oldTop,
+                newDescriptor: newTop,
+                writer
+            });
+        }
+    }
+    /**
+     * Inserts a given descriptor in correct place in the stack. It also takes care about updating information
+     * when descriptor with same id is already present.
+     */
+    _insertDescriptor(descriptor) {
+        const stack = this._stack;
+        const index = stack.findIndex(item => item.id === descriptor.id);
+        // Inserting exact same descriptor - do nothing.
+        if (compareDescriptors(descriptor, stack[index])) {
+            return;
+        }
+        // If descriptor with same id but with different information is on the stack - remove it.
+        if (index > -1) {
+            stack.splice(index, 1);
+        }
+        // Find correct place to insert descriptor in the stack.
+        // It has different information (for example priority) so it must be re-inserted in correct place.
+        let i = 0;
+        while (stack[i] && shouldABeBeforeB(stack[i], descriptor)) {
+            i++;
+        }
+        stack.splice(i, 0, descriptor);
+    }
+    /**
+     * Removes descriptor with given id from the stack.
+     *
+     * @param id Descriptor's id.
+     */
+    _removeDescriptor(id) {
+        const stack = this._stack;
+        const index = stack.findIndex(item => item.id === id);
+        // If descriptor with same id is on the list - remove it.
+        if (index > -1) {
+            stack.splice(index, 1);
+        }
+    }
+}
+/**
+ * Compares two descriptors by checking their priority and class list.
+ *
+ * @returns Returns true if both descriptors are defined and have same priority and classes.
+ */
+function compareDescriptors(a, b) {
+    return a && b && a.priority == b.priority && classesToString(a.classes) == classesToString(b.classes);
+}
+/**
+ * Checks whenever first descriptor should be placed in the stack before second one.
+ */
+function shouldABeBeforeB(a, b) {
+    if (a.priority > b.priority) {
+        return true;
+    }
+    else if (a.priority < b.priority) {
+        return false;
+    }
+    // When priorities are equal and names are different - use classes to compare.
+    return classesToString(a.classes) > classesToString(b.classes);
+}
+/**
+ * Converts CSS classes passed with {@link module:engine/conversion/downcasthelpers~HighlightDescriptor} to
+ * sorted string.
+ */
+function classesToString(classes) {
+    return Array.isArray(classes) ? classes.sort().join(',') : classes;
+}

package/src/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @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 widget
+ */
+export { default as Widget } from './widget.js';
+export { default as WidgetToolbarRepository } from './widgettoolbarrepository.js';
+export { default as WidgetResize } from './widgetresize.js';
+export { default as WidgetTypeAround } from './widgettypearound/widgettypearound.js';
+export * from './utils.js';
+import './augmentation.js';

package/src/index.js

@@ -0,0 +1,13 @@
+/**
+ * @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 widget
+ */
+export { default as Widget } from './widget.js';
+export { default as WidgetToolbarRepository } from './widgettoolbarrepository.js';
+export { default as WidgetResize } from './widgetresize.js';
+export { default as WidgetTypeAround } from './widgettypearound/widgettypearound.js';
+export * from './utils.js';
+import './augmentation.js';