@ckeditor/ckeditor5-track-changes 0.0.0-internal-20241017.0

package/dist/translations/zh.js

@@ -0,0 +1,23 @@
+/*
+ *             Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ *
+ *
+ *
+ *
+ *          +---------------------------------------------------------------------------------+
+ *          |                                                                                 |
+ *          |                                 Hello stranger!                                 |
+ *          |                                                                                 |
+ *          |                                                                                 |
+ *          |   What you're currently looking at is the source code of a legally protected,   |
+ *          |    proprietary software. Any attempts to deobfuscate / disassemble this code    |
+ *          |               are forbidden and will result in legal consequences.              |
+ *          |                                                                                 |
+ *          |                                                                                 |
+ *          +---------------------------------------------------------------------------------+
+ *
+ *
+ *
+ *
+ */
+export default{'zh':{'dictionary':{'*Change\x20to:*\x20%0':'*更改成：*%0','*Change\x20%0\x20content*':'*變更\x20%0\x20內容*','*Check\x20item*':'*勾選項目*','*Format:*\x20%0':'*格式：*%0','*Indent:*\x20%0':'*縮排：*%0','*Insert:*\x20%0':'*插入：*%0','*Format:*\x20change\x20table\x20properties':'*格式：*變更表格屬性','*Format:*\x20change\x20table\x20cell\x20properties':'*格式：*變更表格的儲存格屬性','*Format:*\x20insert\x20into\x20%0':'*格式：*插入\x20%0','*Format:*\x20remove\x20from\x20%0':'*格式：*從\x20%0\x20移除','*Replace\x20image\x20URL*':'*替換圖片網址*','*Format:*\x20resize\x20table':'*格式：*調整表格大小','*Format:*\x20set\x20order\x20to\x20reversed':'*格式：*反向排序','*Format:*\x20set\x20order\x20to\x20regular':'*格式：*依標準排序','*Format:*\x20set\x20start\x20index\x20to\x20%0':'*格式：*將起始索引設定為\x20%0','*Merge\x20cells*':'*合併儲存格*','*Merge:*\x20%0':'*合併：*%0','*Outdent:*\x20%0':'*凸排：*%0','*Remove\x20all\x20formatting*':'*清除格式設定*','*Remove\x20format:*\x20%0':'*移除格式：*%0','*Remove\x20highlight*':'*刪除亮顯*','*Remove\x20image\x20text\x20alternative*':'*移除圖片替代文字*','*Remove\x20link*':'*移除連結*','*Remove:*\x20%0':'*移除：*%0','*Replace\x20table\x20cells*':'*取代儲存格*','*Reset\x20font\x20background\x20color*':'*重設文字背景顏色*','*Reset\x20font\x20color*':'*重設文字顏色*','*Reset\x20font\x20family*':'*重設字型*','*Reset\x20font\x20size*':'*重設字體大小*','*Reset\x20image\x20width*':'*重設圖片寬度*','*Set\x20font\x20background\x20color:*\x20%0':'*設定文字背景顏色：*%0','*Set\x20font\x20color:*\x20%0':'*設定字型顏色：*\x20%0','*Set\x20font\x20family:*\x20%0':'*設定字型家族：*%0','*Set\x20font\x20size:*\x20%0':'*設定字型大小：*%0','*Set\x20format:*\x20%0':'*設定格式：*\x20%0','*Set\x20format\x20to:*\x20%0':'*設定格式為：*%0','*Set\x20highlight:*\x20%0':'*設定亮顯：*%0','*Set\x20image\x20text\x20alternative:*\x20%0':'*設定影像替代文字：*%0','*Set\x20image\x20width:*\x20%0':'*設定影像寬度：*%0','*Set\x20link:*\x20%0':'*設定連結：*%0','*Split\x20cell:*\x20horizontally':'*分割儲存格：*\x20水平','*Split\x20cell:*\x20vertically':'*分割儲存格：*\x20垂直','*Split:*\x20%0':'*分割：*%0','*Uncheck\x20item*':'*取消勾選項目*','Accept\x20all\x20selected\x20suggestions':'接受所有已選取的建議','Accept\x20all\x20suggestions':'接受所有建議','Accept\x20suggestion':'接受建議','Discard\x20all\x20selected\x20suggestions':'捨棄所有選取的建議','Discard\x20all\x20suggestions':'捨棄所有建議','Discard\x20suggestion':'捨棄建議','LEAVE_INSERTION_SUGGESTION_ANNOUNCEMENT':'正在離開插入建議。','ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT':'正在進入插入建議。按\x20%0\x20即可前往討論區。','LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT':'正在離開刪除建議。','ENTER_DELETION_SUGGESTION_ANNOUNCEMENT':'正在進入刪除建議。按\x20%0\x20即可前往討論區。','LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在離開格式建議。','ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在進入格式設定建議。按\x20%0\x20即可前往討論區。','SUGGESTION_THREAD_ARIA_LABEL':'建議者：%1。建立時間：%2。%0\x20則回覆。%3','SUGGESTION_THREAD_DESCRIPTION':'按\x20Enter\x20鍵可取得更多選項。按\x20Esc\x20鍵即可退出。','ELEMENT_BLOCK_QUOTE':'區塊引述','ELEMENT_DEFAULT_LIST_DEFAULT':'預設清單樣式','ELEMENT_BULLETED_LIST':'項目符號清單','ELEMENT_BULLETED_LIST_DEFAULT':'項目符號清單（預設）','ELEMENT_BULLETED_LIST_CIRCLE':'項目符號列表（空心圓）','ELEMENT_BULLETED_LIST_DISC':'項目符號列表（實心圓）','ELEMENT_BULLETED_LIST_SQUARE':'項目符號列表（方塊）','ELEMENT_CAPTION':'標號','ELEMENT_CODE_BLOCK':'代碼區塊','ELEMENT_HEADING':'標題（層級\x20%1）','ELEMENT_HEADING_CUSTOM':'標題\x20(%1)','ELEMENT_HORIZONTAL_LINE':'水平線','ELEMENT_HTML_EMBED':'HTML\x20內嵌','ELEMENT_IMAGE':'影像','ELEMENT_INLINE_IMAGE':'影像','ELEMENT_LINE_BREAK':'分行符號','ELEMENT_LIST_ITEM':'清單項目','ELEMENT_MEDIA':'媒體項目','ELEMENT_NUMBERED_LIST':'編號清單','ELEMENT_NUMBERED_LIST_DEFAULT':'編號清單（預設）','ELEMENT_NUMBERED_LIST_DECIMAL':'編號列表（阿拉伯數字）','ELEMENT_NUMBERED_LIST_DECIMAL_LEADING_ZERO':'編號列表（零開頭的阿拉伯數字）','ELEMENT_NUMBERED_LIST_LOWER_LATIN':'編號列表（小寫拉丁字元）','ELEMENT_NUMBERED_LIST_LOWER_ROMAN':'編號列表（小寫羅馬數字）','ELEMENT_NUMBERED_LIST_UPPER_LATIN':'編號列表（大寫拉丁字元）','ELEMENT_NUMBERED_LIST_UPPER_ROMAN':'編號列表（大寫羅馬數字）','ELEMENT_PAGE_BREAK':'分頁符號','ELEMENT_PARAGRAPH':'段落','ELEMENT_SPACE':'間距','ELEMENT_TABLE':'表格','ELEMENT_TABLE_COLUMN':'表格行','ELEMENT_TABLE_COLUMN_WITH_TEXT':'表格行*帶文字*\x20%1','ELEMENT_TABLE_OF_CONTENTS':'內容目錄','ELEMENT_TABLE_ROW':'表格列','ELEMENT_TABLE_ROW_WITH_TEXT':'表格列*帶文字*\x20%1','ELEMENT_TABLE_WITH_TEXT':'表格*帶文字*\x20%0','ELEMENT_TITLE':'大標題','ELEMENT_TODO_LIST':'待辦事項清單','ELEMENT_MULTI_LEVEL_LIST':'多層次清單','ELEMENT_MERGE_FIELD':'合併欄位','FORMAT_ALIGNMENT':'對齊','FORMAT_ALIGN_TO_CENTER':'置中','FORMAT_ALIGN_TO_LEFT':'靠左對齊','FORMAT_ALIGN_TO_RIGHT':'靠右對齊','FORMAT_BOLD':'粗體','FORMAT_CODE':'代碼','FORMAT_HEADER_COLUMN':'標題行','FORMAT_HEADER_ROW':'標題列','FORMAT_HIGHLIGHT':'亮顯','FORMAT_ITALIC':'斜體','FORMAT_JUSTIFY_TEXT':'左右對齊','FORMAT_REGULAR_COLUMN':'標準行','FORMAT_REGULAR_ROW':'標準列','FORMAT_RESTRICTED_DISABLED':'*在受限編輯模式下禁用*','FORMAT_RESTRICTED_ENABLED':'*在受限編輯模式下啟用*','FORMAT_SIDE_IMAGE':'側邊影像','FORMAT_STRIKETHROUGH':'刪除線','FORMAT_SUBSCRIPT':'下標','FORMAT_SUPERSCRIPT':'上標','FORMAT_UNDERLINE':'底線','FORMAT_INDENT':'縮排','FORMAT_LIST_REVERSED':'清單反轉','FORMAT_LIST_START':'清單起始','FORMAT_FONT_SIZE':'字型大小','FORMAT_FONT_FAMILY':'字型家族','FORMAT_FONT_COLOR':'字型顏色','FORMAT_FONT_BACKGROUND':'字型背景顏色','FORMAT_IMAGE_SIZE':'圖片大小','FORMAT_STYLE':'樣式','PENDING_ACTION_SUGGESTION':'建議中未儲存的變更。','REPLACE_TEXT':'*取代：*%0\x20*變更為*\x20%1','Track\x20changes':'追蹤變更','EXTERNAL_SUGGESTION':'此建議來自外部來源。','EXTERNAL_IMPORT_WORD_SUGGESTION':'此建議來自匯入的\x20Word\x20檔案。'},'getPluralForm':_0x5b349f=>0x0}};

package/dist/translations/zh.umd.js

@@ -0,0 +1,23 @@
+/*
+ *             Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ *
+ *
+ *
+ *
+ *          +---------------------------------------------------------------------------------+
+ *          |                                                                                 |
+ *          |                                 Hello stranger!                                 |
+ *          |                                                                                 |
+ *          |                                                                                 |
+ *          |   What you're currently looking at is the source code of a legally protected,   |
+ *          |    proprietary software. Any attempts to deobfuscate / disassemble this code    |
+ *          |               are forbidden and will result in legal consequences.              |
+ *          |                                                                                 |
+ *          |                                                                                 |
+ *          +---------------------------------------------------------------------------------+
+ *
+ *
+ *
+ *
+ */
+(_0x48c7c8=>{const {zh:{dictionary:_0x2ac92b,getPluralForm:_0x537800}}={'zh':{'dictionary':{'*Change\x20to:*\x20%0':'*更改成：*%0','*Change\x20%0\x20content*':'*變更\x20%0\x20內容*','*Check\x20item*':'*勾選項目*','*Format:*\x20%0':'*格式：*%0','*Indent:*\x20%0':'*縮排：*%0','*Insert:*\x20%0':'*插入：*%0','*Format:*\x20change\x20table\x20properties':'*格式：*變更表格屬性','*Format:*\x20change\x20table\x20cell\x20properties':'*格式：*變更表格的儲存格屬性','*Format:*\x20insert\x20into\x20%0':'*格式：*插入\x20%0','*Format:*\x20remove\x20from\x20%0':'*格式：*從\x20%0\x20移除','*Replace\x20image\x20URL*':'*替換圖片網址*','*Format:*\x20resize\x20table':'*格式：*調整表格大小','*Format:*\x20set\x20order\x20to\x20reversed':'*格式：*反向排序','*Format:*\x20set\x20order\x20to\x20regular':'*格式：*依標準排序','*Format:*\x20set\x20start\x20index\x20to\x20%0':'*格式：*將起始索引設定為\x20%0','*Merge\x20cells*':'*合併儲存格*','*Merge:*\x20%0':'*合併：*%0','*Outdent:*\x20%0':'*凸排：*%0','*Remove\x20all\x20formatting*':'*清除格式設定*','*Remove\x20format:*\x20%0':'*移除格式：*%0','*Remove\x20highlight*':'*刪除亮顯*','*Remove\x20image\x20text\x20alternative*':'*移除圖片替代文字*','*Remove\x20link*':'*移除連結*','*Remove:*\x20%0':'*移除：*%0','*Replace\x20table\x20cells*':'*取代儲存格*','*Reset\x20font\x20background\x20color*':'*重設文字背景顏色*','*Reset\x20font\x20color*':'*重設文字顏色*','*Reset\x20font\x20family*':'*重設字型*','*Reset\x20font\x20size*':'*重設字體大小*','*Reset\x20image\x20width*':'*重設圖片寬度*','*Set\x20font\x20background\x20color:*\x20%0':'*設定文字背景顏色：*%0','*Set\x20font\x20color:*\x20%0':'*設定字型顏色：*\x20%0','*Set\x20font\x20family:*\x20%0':'*設定字型家族：*%0','*Set\x20font\x20size:*\x20%0':'*設定字型大小：*%0','*Set\x20format:*\x20%0':'*設定格式：*\x20%0','*Set\x20format\x20to:*\x20%0':'*設定格式為：*%0','*Set\x20highlight:*\x20%0':'*設定亮顯：*%0','*Set\x20image\x20text\x20alternative:*\x20%0':'*設定影像替代文字：*%0','*Set\x20image\x20width:*\x20%0':'*設定影像寬度：*%0','*Set\x20link:*\x20%0':'*設定連結：*%0','*Split\x20cell:*\x20horizontally':'*分割儲存格：*\x20水平','*Split\x20cell:*\x20vertically':'*分割儲存格：*\x20垂直','*Split:*\x20%0':'*分割：*%0','*Uncheck\x20item*':'*取消勾選項目*','Accept\x20all\x20selected\x20suggestions':'接受所有已選取的建議','Accept\x20all\x20suggestions':'接受所有建議','Accept\x20suggestion':'接受建議','Discard\x20all\x20selected\x20suggestions':'捨棄所有選取的建議','Discard\x20all\x20suggestions':'捨棄所有建議','Discard\x20suggestion':'捨棄建議','LEAVE_INSERTION_SUGGESTION_ANNOUNCEMENT':'正在離開插入建議。','ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT':'正在進入插入建議。按\x20%0\x20即可前往討論區。','LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT':'正在離開刪除建議。','ENTER_DELETION_SUGGESTION_ANNOUNCEMENT':'正在進入刪除建議。按\x20%0\x20即可前往討論區。','LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在離開格式建議。','ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在進入格式設定建議。按\x20%0\x20即可前往討論區。','SUGGESTION_THREAD_ARIA_LABEL':'建議者：%1。建立時間：%2。%0\x20則回覆。%3','SUGGESTION_THREAD_DESCRIPTION':'按\x20Enter\x20鍵可取得更多選項。按\x20Esc\x20鍵即可退出。','ELEMENT_BLOCK_QUOTE':'區塊引述','ELEMENT_DEFAULT_LIST_DEFAULT':'預設清單樣式','ELEMENT_BULLETED_LIST':'項目符號清單','ELEMENT_BULLETED_LIST_DEFAULT':'項目符號清單（預設）','ELEMENT_BULLETED_LIST_CIRCLE':'項目符號列表（空心圓）','ELEMENT_BULLETED_LIST_DISC':'項目符號列表（實心圓）','ELEMENT_BULLETED_LIST_SQUARE':'項目符號列表（方塊）','ELEMENT_CAPTION':'標號','ELEMENT_CODE_BLOCK':'代碼區塊','ELEMENT_HEADING':'標題（層級\x20%1）','ELEMENT_HEADING_CUSTOM':'標題\x20(%1)','ELEMENT_HORIZONTAL_LINE':'水平線','ELEMENT_HTML_EMBED':'HTML\x20內嵌','ELEMENT_IMAGE':'影像','ELEMENT_INLINE_IMAGE':'影像','ELEMENT_LINE_BREAK':'分行符號','ELEMENT_LIST_ITEM':'清單項目','ELEMENT_MEDIA':'媒體項目','ELEMENT_NUMBERED_LIST':'編號清單','ELEMENT_NUMBERED_LIST_DEFAULT':'編號清單（預設）','ELEMENT_NUMBERED_LIST_DECIMAL':'編號列表（阿拉伯數字）','ELEMENT_NUMBERED_LIST_DECIMAL_LEADING_ZERO':'編號列表（零開頭的阿拉伯數字）','ELEMENT_NUMBERED_LIST_LOWER_LATIN':'編號列表（小寫拉丁字元）','ELEMENT_NUMBERED_LIST_LOWER_ROMAN':'編號列表（小寫羅馬數字）','ELEMENT_NUMBERED_LIST_UPPER_LATIN':'編號列表（大寫拉丁字元）','ELEMENT_NUMBERED_LIST_UPPER_ROMAN':'編號列表（大寫羅馬數字）','ELEMENT_PAGE_BREAK':'分頁符號','ELEMENT_PARAGRAPH':'段落','ELEMENT_SPACE':'間距','ELEMENT_TABLE':'表格','ELEMENT_TABLE_COLUMN':'表格行','ELEMENT_TABLE_COLUMN_WITH_TEXT':'表格行*帶文字*\x20%1','ELEMENT_TABLE_OF_CONTENTS':'內容目錄','ELEMENT_TABLE_ROW':'表格列','ELEMENT_TABLE_ROW_WITH_TEXT':'表格列*帶文字*\x20%1','ELEMENT_TABLE_WITH_TEXT':'表格*帶文字*\x20%0','ELEMENT_TITLE':'大標題','ELEMENT_TODO_LIST':'待辦事項清單','ELEMENT_MULTI_LEVEL_LIST':'多層次清單','ELEMENT_MERGE_FIELD':'合併欄位','FORMAT_ALIGNMENT':'對齊','FORMAT_ALIGN_TO_CENTER':'置中','FORMAT_ALIGN_TO_LEFT':'靠左對齊','FORMAT_ALIGN_TO_RIGHT':'靠右對齊','FORMAT_BOLD':'粗體','FORMAT_CODE':'代碼','FORMAT_HEADER_COLUMN':'標題行','FORMAT_HEADER_ROW':'標題列','FORMAT_HIGHLIGHT':'亮顯','FORMAT_ITALIC':'斜體','FORMAT_JUSTIFY_TEXT':'左右對齊','FORMAT_REGULAR_COLUMN':'標準行','FORMAT_REGULAR_ROW':'標準列','FORMAT_RESTRICTED_DISABLED':'*在受限編輯模式下禁用*','FORMAT_RESTRICTED_ENABLED':'*在受限編輯模式下啟用*','FORMAT_SIDE_IMAGE':'側邊影像','FORMAT_STRIKETHROUGH':'刪除線','FORMAT_SUBSCRIPT':'下標','FORMAT_SUPERSCRIPT':'上標','FORMAT_UNDERLINE':'底線','FORMAT_INDENT':'縮排','FORMAT_LIST_REVERSED':'清單反轉','FORMAT_LIST_START':'清單起始','FORMAT_FONT_SIZE':'字型大小','FORMAT_FONT_FAMILY':'字型家族','FORMAT_FONT_COLOR':'字型顏色','FORMAT_FONT_BACKGROUND':'字型背景顏色','FORMAT_IMAGE_SIZE':'圖片大小','FORMAT_STYLE':'樣式','PENDING_ACTION_SUGGESTION':'建議中未儲存的變更。','REPLACE_TEXT':'*取代：*%0\x20*變更為*\x20%1','Track\x20changes':'追蹤變更','EXTERNAL_SUGGESTION':'此建議來自外部來源。','EXTERNAL_IMPORT_WORD_SUGGESTION':'此建議來自匯入的\x20Word\x20檔案。'},'getPluralForm':_0xb75b30=>0x0}};_0x48c7c8['zh']||={'dictionary':{},'getPluralForm':null},_0x48c7c8['zh']['dictionary']=Object['assign'](_0x48c7c8['zh']['dictionary'],_0x2ac92b),_0x48c7c8['zh']['getPluralForm']=_0x537800;})(window['CKEDITOR_TRANSLATIONS']||={});

package/dist/ui/suggestioncontroller.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @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-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 { Editor } from 'ckeditor5/src/core.js';
+import type Suggestion from '../suggestion.js';
+import type { default as BaseSuggestionThreadView } from './view/basesuggestionthreadview.js';
+import type { CommentThreadController } from '@ckeditor/ckeditor5-comments';
+declare const SuggestionController_base: {
+    new (): import("ckeditor5/src/utils.js").Observable;
+    prototype: import("ckeditor5/src/utils.js").Observable;
+};
+/**
+ * A controller for a suggestion.
+ *
+ * It takes a suggestion thread view, listens to events fired by that view and based on them performs actions
+ * on the provided suggestion model.
+ */
+export default class SuggestionController extends /* #__PURE__ -- @preserve */ SuggestionController_base {
+    model: Suggestion;
+    view: BaseSuggestionThreadView;
+    commentThreadController: CommentThreadController;
+    constructor(editor: Editor, model: Suggestion, view: BaseSuggestionThreadView, commentThreadController: CommentThreadController);
+    /**
+     * Accepts the suggestion that belongs to this controller.
+     */
+    acceptSuggestion(): void;
+    /**
+     * Discards the suggestion that belongs to this controller.
+     */
+    discardSuggestion(): void;
+    /**
+     * Destroys `SuggestionController` instance.
+     */
+    destroy(): void;
+}
+export {};

package/dist/ui/view/basesuggestionthreadview.d.ts

@@ -0,0 +1,209 @@
+/**
+ * @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-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module track-changes/ui/view/basesuggestionthreadview
+ * @publicApi
+ */
+import { FocusCycler, View, ViewCollection, type FocusableView } from 'ckeditor5/src/ui.js';
+import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
+import type { EditorConfig } from 'ckeditor5/src/core.js';
+import type Suggestion from '../../suggestion.js';
+import type { CommentsListView, CommentThreadInputView, CommentView } from '@ckeditor/ckeditor5-comments';
+import { AriaDescriptionView, type User } from 'ckeditor5-collaboration/src/collaboration-core.js';
+import type { Description } from '../../suggestiondescriptionfactory.js';
+import type SuggestionView from './suggestionview.js';
+/**
+ * An abstract suggestion thread view class that should be used as a base for suggestion thread view implementations.
+ * It provides some behaviors, flags and building blocks to use when creating a custom suggestion thread view class.
+ *
+ * All events fired by {@link module:comments/comments/ui/view/basecommentview~BaseCommentView}
+ * are delegated to {@link module:track-changes/ui/view/basesuggestionthreadview~BaseSuggestionThreadView}.
+ * This means that {@link module:track-changes/ui/view/basesuggestionthreadview~BaseSuggestionThreadView} can also fire these
+ * events to communicate with CKEditor 5 collaboration features.
+ *
+ * For the usage examples check the {@glink features/collaboration/annotations/annotations-custom-view
+ * Annotations custom view} guide.
+ */
+export default abstract class BaseSuggestionThreadView extends View {
+    /**
+     * The list of comment views. It should be used as a part of the view template when present.
+     */
+    commentsListView: CommentsListView | null;
+    /**
+     * The comment input area view. It should be used as a part of the view template when present.
+     */
+    commentThreadInputView: CommentThreadInputView | null;
+    /**
+     * A helper view that provides an ARIA description for the comment thread used by
+     * assistive technologies.
+     */
+    readonly ariaDescriptionView: AriaDescriptionView;
+    /**
+     * A boolean value that informs if the comment thread view is in the active state ("highlighted").
+     * A comment thread view is in this state when it is focused or was activated by the user in any different way.
+     *
+     * @observable
+     */
+    isActive: boolean;
+    /**
+     * Suggestion creation date.
+     *
+     * @observable
+     */
+    authoredAt: Date | null;
+    /**
+     * Flag that indicates whether suggestion acceptation is possible.
+     *
+     * @observable
+     */
+    canAccept: boolean;
+    /**
+     * Flag that indicates whether suggestion discarding is possible.
+     *
+     * @observable
+     */
+    canDiscard: boolean;
+    /**
+     * Stores description entries generated for this suggestion that describe what is the suggested change.
+     * They are used to create the final description presented in the suggestion view to the user.
+     *
+     * Note that one suggestion may include multiple changes.
+     *
+     * Most cases are simple and include just one description item:
+     *
+     *  ```ts
+     * [
+     *		{ type: 'insertion', content: '*Insert:* "Foo"' }
+     * ]
+     *	```
+     *
+     * This description item represents a suggestion for inserting the "Foo" text. The `type` property describes the performed action
+     * while the `content` property contains additional information about the action and is optional.
+     *
+     * A more complex example is presented below:
+     *
+     * ```ts
+     * [
+     *		{ type: 'insertion', content: '*Insert:* 2 paragraphs' },
+     *		{ type: 'insertion', content: '*Insert:* image' },
+     *		{ type: 'replace', content: '*Replace:* "Foo" *with* "Bar"' }
+     * ]
+     * ```
+     *
+     * In this example, there are three description instances (or lines). Two new (empty) paragraphs were added,
+     * an image was added and then "Foo" text was replaced by "Bar". The above structure could be rendered as:
+     *
+     *  ```html
+     *	<p><strong>Insert:</strong> 2 paragraphs</p>
+     *	<p><strong>Insert:</strong> image</p>
+     *	<p><strong>Replace:</strong> "Foo" <strong>with</strong> "Bar"</p>
+     *	```
+     *
+     * @observable
+     */
+    descriptionParts: Array<Description>;
+    /**
+     * Informs whether the suggestion thread has any changes that have not been saved.
+     *
+     * @observable
+     */
+    isDirty: boolean;
+    /**
+     * Informs whether the suggestion can be accepted or discarded.
+     *
+     * @observable
+     */
+    isEnabled: boolean;
+    /**
+     * The number of items in the view, where the suggestion itself counts as one.
+     *
+     * In other words, it is equal to the number of comments in the suggestion thread view plus one.
+     *
+     * @observable
+     */
+    readonly length: number;
+    /**
+     * An accessible thread label text exposed to assistive technologies.
+     */
+    ariaLabel: string;
+    /**
+     * A collection of focusable child views.
+     */
+    readonly focusables: ViewCollection<FocusableView>;
+    /**
+     * Tracks information about DOM focus in the thread.
+     */
+    readonly focusTracker: FocusTracker;
+    /**
+     * Instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+     */
+    readonly keystrokes: KeystrokeHandler;
+    /**
+     * Helps cycling over focusable views in the thread.
+     */
+    readonly focusCycler: FocusCycler;
+    constructor(locale: Locale, model: Suggestion, localUser: User, config: SuggestionThreadConfig);
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+    /**
+     * Focuses the view.
+     */
+    focus(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+}
+/**
+ * Fired when a user performed an action that should lead to accepting the suggestion.
+ *
+ * This event is not fired by default by any component created by `BaseSuggestionThreadView`.
+ * If you create a view class extending `BaseSuggestionCommentView`, you should provide
+ * a UI element that will fire this event.
+ *
+ * @eventName ~BaseSuggestionThreadView#acceptSuggestion
+ */
+export type AcceptSuggestionEvent = {
+    name: 'acceptSuggestion';
+    args: [
+        id: string
+    ];
+};
+/**
+ * Fired when a user performed an action that should lead to discarding the suggestion.
+ *
+ * This event is not fired by default by any component created by `BaseSuggestionThreadView`.
+ * If you create a view class extending `BaseSuggestionCommentView`, you should provide
+ * a UI element that will fire this event.
+ *
+ * @eventName ~BaseSuggestionThreadView#discardSuggestion
+ */
+export type DiscardSuggestionEvent = {
+    name: 'discardSuggestion';
+    args: [
+        id: string
+    ];
+};
+/**
+ * Config used for suggestion thread views.
+ */
+export interface SuggestionThreadConfig {
+    disableComments: boolean;
+    editorConfig: EditorConfig;
+    maxCommentsWhenCollapsed: number;
+    maxThreadTotalWeight: number;
+    maxCommentCharsWhenCollapsed: number;
+    formatDateTime: (date: Date | string) => string;
+    CommentView: typeof CommentView;
+    CommentsListView: typeof CommentsListView;
+    CommentThreadInputView: typeof CommentThreadInputView;
+    SuggestionView: typeof SuggestionView;
+}

package/dist/ui/view/suggestionthreadview.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @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-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module track-changes/ui/view/suggestionthreadview
+ * @publicApi
+ */
+import { default as BaseSuggestionThreadView, type SuggestionThreadConfig } from './basesuggestionthreadview.js';
+import { type TemplateDefinition, type ViewWithFocusCycler } from 'ckeditor5/src/ui.js';
+import { type User } from 'ckeditor5-collaboration/src/collaboration-core.js';
+import { type Locale } from 'ckeditor5/src/utils.js';
+import type Suggestion from '../../suggestion.js';
+import type SuggestionView from './suggestionview.js';
+/**
+ * The default view for a suggestion thread.
+ *
+ * This view can be replaced by other view by overwriting the
+ * {@link module:track-changes/trackchangesconfig~TrackChangesConfig#SuggestionThreadView} configuration.
+ */
+export default class SuggestionThreadView extends BaseSuggestionThreadView implements ViewWithFocusCycler {
+    /**
+     * The suggestion thread view type.
+     *
+     * This value is not equal to the suggestion (model) type. It is evaluated based on the type of the first suggestion for
+     * the suggestion thread view template purposes.
+     *
+     * @observable
+     */
+    type: 'format' | 'replace' | 'deletion' | 'insertion' | '';
+    /**
+     * A suggestion description explaining what has been changed. To be presented to the user.
+     *
+     * @observable
+     */
+    description: string;
+    /**
+     * A view displaying a detailed information about the suggestion as well as controls to accept or discard it.
+     */
+    suggestionView: SuggestionView;
+    constructor(locale: Locale, model: Suggestion, localUser: User, config: SuggestionThreadConfig);
+    /**
+     * Returns a template definition that will be passed to {@link module:ui/view~View#setTemplate}.
+     *
+     * Overwrite this method if you want to set a custom template for the suggestion thread view.
+     *
+     * The template looks as follows:
+     *
+     * ```ts
+     * const bind = this.bindTemplate;
+     * const suggestionThreadChildren = [
+     * 	this.suggestionView
+     * ];
+     *
+     * if ( this.commentsListView ) {
+     * 	suggestionThreadChildren.push( this.commentsListView );
+     * }
+     *
+     * if ( this.commentThreadInputView ) {
+     * 	suggestionThreadChildren.push( this.commentThreadInputView );
+     * }
+     *
+     * suggestionThreadChildren.push( this.ariaDescriptionView );
+     *
+     * return {
+     * 	tag: 'div',
+     * 	attributes: {
+     * 		class: [
+     * 			'ck',
+     * 			'ck-rounded-corners',
+     * 			'ck-suggestion-wrapper',
+     * 			bind.if( 'isActive', 'ck-suggestion-wrapper--active' ),
+     * 			bind.to( 'type', value => `ck-suggestion-${ value }` ),
+     * 			this._config.disableComments && 'ck-suggestion--disabled-comments'
+     * 		],
+     * 		'data-suggestion-id': this._model.id,
+     * 		'data-thread-id': this._model.commentThread!.id,
+     * 		'data-author-id': this._model.author.id,
+     * 		// Needed for managing focus after adding new comment.
+     * 		tabindex: 0,
+     * 		role: 'listitem',
+     * 		'aria-label': bind.to( 'ariaLabel' ),
+     * 		'aria-describedby': this.ariaDescriptionView.id
+     * 	},
+     * 	children: suggestionThreadChildren
+     * };
+     * ```
+     */
+    getTemplate(): TemplateDefinition;
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+}

package/dist/ui/view/suggestionview.d.ts

@@ -0,0 +1,194 @@
+/**
+ * @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-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module track-changes/ui/view/suggestionview
+ * @publicApi
+ */
+import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
+import { View, type TemplateDefinition, type FocusableView, ViewCollection, FocusCycler } from 'ckeditor5/src/ui.js';
+import { LateFocusButtonView, UserView } from 'ckeditor5-collaboration/src/collaboration-core.js';
+import type Suggestion from '../../suggestion.js';
+/**
+ * A view displaying a detailed information about the suggestion as well as controls to accept or discard it.
+ *
+ * This view can be replaced by other view by overwriting the
+ * {@link module:track-changes/trackchangesconfig~TrackChangesConfig#SuggestionView} configuration.
+ */
+export default class SuggestionView extends View implements FocusableView {
+    /**
+     * A suggestion description explaining what has been changed. To be presented to the user.
+     *
+     * @observable
+     */
+    description: string;
+    /**
+     * A user view for the suggestion author.
+     */
+    userView: UserView;
+    /**
+     * A button view for the button that accepts the suggestion.
+     */
+    acceptButton: LateFocusButtonView;
+    /**
+     * A button view for the button that discards the suggestion.
+     */
+    discardButton: LateFocusButtonView;
+    /**
+     * A collection of focusable child views.
+     */
+    readonly focusables: ViewCollection<FocusableView>;
+    /**
+     * Tracks information about DOM focus in the suggestion.
+     */
+    readonly focusTracker: FocusTracker;
+    /**
+     * Instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+     */
+    readonly keystrokes: KeystrokeHandler;
+    /**
+     * Helps cycling over focusable views in the suggestion.
+     */
+    readonly focusCycler: FocusCycler;
+    /**
+     * Suggestion creation date.
+     *
+     * @observable
+     */
+    authoredAt: Date | null;
+    constructor(locale: Locale, model: Suggestion, config: SuggestionConfig);
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+    /**
+     * Returns a template definition that will be passed to {@link module:ui/view~View#setTemplate}.
+     *
+     * Overwrite this method if you want to set a custom template for the suggestion view.
+     *
+     * The template looks as follows:
+     *
+     * ```ts
+     * const bind = this.bindTemplate;
+     * const suggestionContentElements = [
+     * 	{
+     * 		tag: 'div',
+     *
+     * 		attributes: {
+     * 			class: [ 'ck-suggestion__info', 'ck-annotation__info' ]
+     * 		},
+     *
+     * 		children: [
+     * 			{
+     * 				tag: 'span',
+     *
+     * 				children: [
+     * 					{
+     * 						text: this.userView.name
+     * 					}
+     * 				],
+     *
+     * 				attributes: {
+     * 					class: [ 'ck-suggestion__info-name', 'ck-annotation__info-name' ]
+     * 				}
+     * 			},
+     * 			{
+     * 				tag: 'time',
+     *
+     * 				attributes: {
+     * 					datetime: bind.to( 'authoredAt' ),
+     * 					class: [ 'ck-comment__info-time', 'ck-annotation__info-time' ]
+     * 				},
+     *
+     * 				children: [
+     * 					{
+     * 						text: bind.to( 'authoredAt', value => this._config.formatDateTime( value ) )
+     * 					}
+     * 				]
+     * 			}
+     * 		]
+     * 	},
+     * 	{
+     * 		tag: 'div',
+     *
+     * 		attributes: {
+     * 			class: [ 'ck-suggestion__actions', 'ck-annotation__actions' ]
+     * 		},
+     *
+     * 		children: [
+     * 			this.acceptButton,
+     * 			this.discardButton
+     * 		]
+     * 	},
+     * 	{
+     * 		tag: 'div',
+     *
+     * 		attributes: {
+     * 			class: [ 'ck-annotation__content-wrapper' ]
+     * 		}
+     * 	}
+     * ];
+     *
+     * if ( this._model.isExternal ) {
+     * 	suggestionContentElements.push( {
+     * 		tag: 'div',
+     *
+     * 		attributes: {
+     * 			class: [ 'ck-comment__external' ]
+     * 		},
+     *
+     * 		children: [ {
+     * 			text: this.getExternalSuggestionNote()
+     * 		} ]
+     * 	} );
+     * }
+     *
+     * return {
+     * 	tag: 'div',
+     *
+     * 	attributes: {
+     * 		class: [
+     * 			'ck-suggestion',
+     * 			'ck-annotation'
+     * 		],
+     * 		tabindex: -1
+     * 	},
+     *
+     * 	children: [
+     * 		this.userView,
+     * 		{
+     * 			tag: 'div',
+     *
+     * 			attributes: {
+     * 				class: [ 'ck-suggestion__main', 'ck-annotation__main' ],
+     * 				role: 'presentation'
+     * 			},
+     *
+     * 			children: suggestionContentElements
+     * 		}
+     * 	]
+     * };
+     * ```
+     */
+    getTemplate(): TemplateDefinition;
+    /**
+     * @inheritDoc
+     */
+    focus(): void;
+    /**
+     * Gets the translated notification text which indicates that the author name comes from an external source.
+     */
+    getUserViewNotificationText(): string | null;
+    /**
+     * Gets the translated note which indicates that the suggestion comes from an external source.
+     */
+    getExternalSuggestionNote(): string;
+}
+export interface SuggestionConfig {
+    formatDateTime: (date: Date | string) => string;
+}

package/dist/utils/common-translations.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
+ */
+/**
+ * @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 track-changes/utils/common-translations
+ */
+import { type Locale } from 'ckeditor5/src/utils.js';
+export declare function getTranslation(locale: Locale, id: string, values?: number | string | ReadonlyArray<number | string>): string;