@ckeditor/ckeditor5-track-changes 42.0.2-alpha.2 → 43.0.0-alpha.0

package/dist/translations/zh.umd.js

@@ -20,4 +20,4 @@
  *
  *
  */
-(_0x3b03aa=>{const {zh:{dictionary:_0xa6c35,getPluralForm:_0x426143}}={'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':'正在進入插入建議。','LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT':'正在離開刪除建議。','ENTER_DELETION_SUGGESTION_ANNOUNCEMENT':'正在進入刪除建議。','LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在離開格式建議。','ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在進入格式建議。','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':'多層次清單','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':_0x1338e9=>0x0}};_0x3b03aa['zh']||={'dictionary':{},'getPluralForm':null},_0x3b03aa['zh']['dictionary']=Object['assign'](_0x3b03aa['zh']['dictionary'],_0xa6c35),_0x3b03aa['zh']['getPluralForm']=_0x426143;})(window['CKEDITOR_TRANSLATIONS']||={});
+(_0x23e145=>{const {zh:{dictionary:_0x462e3d,getPluralForm:_0x322485}}={'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':'','LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT':'正在離開刪除建議。','ENTER_DELETION_SUGGESTION_ANNOUNCEMENT':'','LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT':'正在離開格式建議。','ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT':'','SUGGESTION_THREAD_ARIA_LABEL':'','SUGGESTION_THREAD_DESCRIPTION':'','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':_0x401243=>0x0}};_0x23e145['zh']||={'dictionary':{},'getPluralForm':null},_0x23e145['zh']['dictionary']=Object['assign'](_0x23e145['zh']['dictionary'],_0x462e3d),_0x23e145['zh']['getPluralForm']=_0x322485;})(window['CKEDITOR_TRANSLATIONS']||={});

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

@@ -10,12 +10,12 @@
  * @module track-changes/ui/view/basesuggestionthreadview
  * @publicApi
  */
-import { View } from 'ckeditor5/src/ui.js';
-import type { Locale } from 'ckeditor5/src/utils.js';
+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 type { User } from 'ckeditor5-collaboration/src/collaboration-core.js';
+import { AriaDescriptionView, type User } from 'ckeditor5-collaboration/src/collaboration-core.js';
 import type { Description } from '../../suggestiondescriptionfactory.js';
 /**
  * An abstract suggestion thread view class that should be used as a base for suggestion thread view implementations.
@@ -38,6 +38,11 @@ export default abstract class BaseSuggestionThreadView extends View {
      * 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.
@@ -122,7 +127,31 @@ export default abstract class BaseSuggestionThreadView extends View {
      * @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.
      */

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

@@ -7,9 +7,9 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 import { default as BaseSuggestionThreadView, type SuggestionThreadConfig } from './basesuggestionthreadview.js';
-import { ButtonView, type TemplateDefinition } from 'ckeditor5/src/ui.js';
-import { UserView, type User } from 'ckeditor5-collaboration/src/collaboration-core.js';
-import type { Locale } from 'ckeditor5/src/utils.js';
+import { type TemplateDefinition, type ViewWithFocusCycler } from 'ckeditor5/src/ui.js';
+import { LateFocusButtonView, UserView, type User } from 'ckeditor5-collaboration/src/collaboration-core.js';
+import { type Locale } from 'ckeditor5/src/utils.js';
 import type Suggestion from '../../suggestion.js';
 /**
  * The default view for a suggestion thread.
@@ -17,7 +17,7 @@ import type Suggestion from '../../suggestion.js';
  * 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 {
+export default class SuggestionThreadView extends BaseSuggestionThreadView implements ViewWithFocusCycler {
     /**
      * The suggestion thread view type.
      *
@@ -40,11 +40,11 @@ export default class SuggestionThreadView extends BaseSuggestionThreadView {
     /**
      * A button view for the button that accepts the suggestion.
      */
-    acceptButton: ButtonView | null;
+    acceptButton: LateFocusButtonView | null;
     /**
      * A button view for the button that discards the suggestion.
      */
-    discardButton: ButtonView | null;
+    discardButton: LateFocusButtonView | null;
     constructor(locale: Locale, model: Suggestion, localUser: User, config: SuggestionThreadConfig);
     /**
      * Returns a template definition that will be passed to {@link module:ui/view~View#setTemplate}.
@@ -58,6 +58,8 @@ export default class SuggestionThreadView extends BaseSuggestionThreadView {
      *		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 }` ),
@@ -67,7 +69,10 @@ export default class SuggestionThreadView extends BaseSuggestionThreadView {
      *			'data-thread-id': this._model.commentThread.id,
      *			'data-author-id': this._model.author.id,
      *			// Needed for managing focus after adding a new comment.
-     *			tabindex: -1
+     *			tabindex: 0,
+     *			role: 'listitem',
+     *			'aria-label': bind.to( 'ariaLabel' ),
+     *			'aria-describedby': this.ariaDescriptionView.id
      *		},
      *		children: [
      *			{
@@ -86,7 +91,8 @@ export default class SuggestionThreadView extends BaseSuggestionThreadView {
      *						tag: 'div',
      *
      *						attributes: {
-     *							class: [ 'ck-suggestion__main', 'ck-annotation__main' ]
+     *							class: [ 'ck-suggestion__main', 'ck-annotation__main' ],
+     *							role: 'presentation'
      *						},
      *
      *						children: [
@@ -161,7 +167,8 @@ export default class SuggestionThreadView extends BaseSuggestionThreadView {
      * 								} ]
      * 							}
      *						]
-     *					}
+     *					},
+     *					this.ariaDescriptionView
      *				]
      *			},
      *			this.commentsListView,

package/dist/utils/utils.d.ts

@@ -17,6 +17,13 @@ import type { Description } from '../suggestiondescriptionfactory.js';
  * Used in tests for easy suggestion comparison.
  */
 export declare function normalizeDescription(description: Array<Description> | Description): string;
+/**
+ * Renders a rich HTML description out of primitive description string.
+ */
+export declare function renderDescription(description: string, color?: {
+    value: string;
+    title: string;
+}): string;
 export declare function sortSuggestions(suggestions: Array<Suggestion>): Array<Suggestion>;
 /**
  * From the list of passed `suggestions` returns those that are selected by given `selection`.

package/lang/contexts.json

@@ -55,6 +55,8 @@
   "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT": "A message read out by assistive technologies the moment the user selection enters a deletion suggestion.",
   "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT": "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion.",
   "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT": "A message read out by assistive technologies the moment the user selection enters a formatting suggestion.",
+  "SUGGESTION_THREAD_ARIA_LABEL": "A text label for assistive technologies describing the suggestion thread.",
+  "SUGGESTION_THREAD_DESCRIPTION": "A text label for assistive technologies providing additional information about navigation in the suggestion thread.",
   "ELEMENT_BLOCK_QUOTE": "The block quote element name displayed in the suggestion.",
   "ELEMENT_DEFAULT_LIST_DEFAULT": "The default styled list element name displayed in the suggestion.",
   "ELEMENT_BULLETED_LIST": "The bulleted list element name displayed in the suggestion.",
@@ -94,6 +96,7 @@
   "ELEMENT_TITLE": "The title element name displayed in the suggestion.",
   "ELEMENT_TODO_LIST": "The to-do list element name displayed in the suggestion.",
   "ELEMENT_MULTI_LEVEL_LIST": "The multi-level list element name displayed in the suggestion.",
+  "ELEMENT_MERGE_FIELD": "The merge field element name displayed in the suggestion.",
   "FORMAT_ALIGNMENT": "The alignment format name displayed in a format suggestion.",
   "FORMAT_ALIGN_TO_CENTER": "The align to center format name displayed in a format suggestion.",
   "FORMAT_ALIGN_TO_LEFT": "The align to left format name displayed in a format suggestion.",

package/lang/translations/ar.po

@@ -223,7 +223,7 @@ msgstr "مغادرة اقتراح الإدراج."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "إدخال اقتراح الإدراج."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -231,7 +231,7 @@ msgstr "مغادرة اقتراح الحذف."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "إدخال اقتراح الحذف."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -239,7 +239,21 @@ msgstr "مغادرة اقتراح التنسيق."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "إدخال اقتراح التنسيق."
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+msgstr[2] ""
+msgstr[3] ""
+msgstr[4] ""
+msgstr[5] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -511,6 +525,16 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "قائمة متعددة المستويات"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+msgstr[2] ""
+msgstr[3] ""
+msgstr[4] ""
+msgstr[5] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "محاذاة"

package/lang/translations/az.po

@@ -241,6 +241,16 @@ msgctxt "A message read out by assistive technologies the moment the user select
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
 msgstr ""
 
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
+
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
 msgstr ""
@@ -435,6 +445,12 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr ""
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr ""

package/lang/translations/bg.po

@@ -223,7 +223,7 @@ msgstr "Оставяне на предложението за вмъкване."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Въвеждане на предложение за вмъкване."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -231,7 +231,7 @@ msgstr "Оставяне на предложението за изтриване
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Въвеждане на предложението за изтриване."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -239,7 +239,17 @@ msgstr "Оставяне на предложеното форматиране."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "Въвеждане на предложеното форматиране."
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -435,6 +445,12 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "многостепенен списък"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "подравняване"

package/lang/translations/bn.po

@@ -249,7 +249,7 @@ msgstr "সন্নিবিষ্ট পরামর্শ ছেড়ে দ
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "সন্নিবিষ্ট পরামর্শ প্রবেশ করানো হচ্ছে।"
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -257,7 +257,7 @@ msgstr "মুছে ফেলার পরামর্শ ছেড়ে দ
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "মুছে ফেলার পরামর্শ প্রবেশ করানো হচ্ছে।"
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -265,7 +265,17 @@ msgstr "বিন্যাস পরামর্শ ছেড়ে দেওয
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "বিন্যাস পরামর্শ প্রবেশ করা হচ্ছে।"
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -461,6 +471,12 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "মাল্টি-লেভেল লিস্ট"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "প্রান্তিককরণ"

package/lang/translations/ca.po

@@ -223,7 +223,7 @@ msgstr "S'està deixant el suggeriment d'inserció."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "S'està introduint el suggeriment d'inserció."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -231,7 +231,7 @@ msgstr "S'està deixant el suggeriment d'eliminació."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "S'està introduint el suggeriment d'eliminació."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -239,7 +239,17 @@ msgstr "S'està deixant el suggeriment de format."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "S'està introduint un suggeriment de format."
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -435,6 +445,12 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "llista multinivell"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "alineació"

package/lang/translations/cs.po

@@ -223,7 +223,7 @@ msgstr "Opustit návrh na vložení."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Zadávání návrhu na vložení."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -231,7 +231,7 @@ msgstr "Opustit návrh na smazání."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Zadávání návrhu na smazání."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -239,7 +239,19 @@ msgstr "Opouští se návrh na formátování."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "Zadávání návrhu na formátování."
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+msgstr[2] ""
+msgstr[3] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -473,6 +485,14 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "víceúrovňový seznam"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+msgstr[2] ""
+msgstr[3] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "zarovnání"

package/lang/translations/da.po

@@ -223,7 +223,7 @@ msgstr "Indsender forslag om indsætning."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Indtaster forslag om indsætning."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -231,7 +231,7 @@ msgstr "Indsender forslag om sletning."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Indsætter forslag om sletning."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -239,7 +239,17 @@ msgstr "Indsender forslag om formatering."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "Indtaster forslag om formatering."
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -435,6 +445,12 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "liste med flere niveauer"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "justering"

package/lang/translations/de.po

@@ -223,7 +223,7 @@ msgstr "Einfügevorschlag wird hinterlassen."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters an insertion suggestion."
 msgid "ENTER_INSERTION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Einfügevorschlag wird eingegeben."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a deletion suggestion."
 msgid "LEAVE_DELETION_SUGGESTION_ANNOUNCEMENT"
@@ -231,7 +231,7 @@ msgstr "Löschvorschlag wird hinterlassen."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a deletion suggestion."
 msgid "ENTER_DELETION_SUGGESTION_ANNOUNCEMENT"
-msgstr "Löschvorschlag wird eingegeben."
+msgstr ""
 
 msgctxt "A message read out by assistive technologies the moment the user selection leaves a formatting suggestion."
 msgid "LEAVE_FORMATTING_SUGGESTION_ANNOUNCEMENT"
@@ -239,7 +239,17 @@ msgstr "Formatierungsvorschlag wird hinterlassen."
 
 msgctxt "A message read out by assistive technologies the moment the user selection enters a formatting suggestion."
 msgid "ENTER_FORMATTING_SUGGESTION_ANNOUNCEMENT"
-msgstr "Formatierungsvorschlag wird eingegeben."
+msgstr ""
+
+msgctxt "A text label for assistive technologies describing the suggestion thread."
+msgid "SUGGESTION_THREAD_ARIA_LABEL"
+msgid_plural "Suggestion by %1. Created on %2. %0 replies. %3"
+msgstr[0] ""
+msgstr[1] ""
+
+msgctxt "A text label for assistive technologies providing additional information about navigation in the suggestion thread."
+msgid "SUGGESTION_THREAD_DESCRIPTION"
+msgstr ""
 
 msgctxt "The block quote element name displayed in the suggestion."
 msgid "ELEMENT_BLOCK_QUOTE"
@@ -435,6 +445,12 @@ msgctxt "The multi-level list element name displayed in the suggestion."
 msgid "ELEMENT_MULTI_LEVEL_LIST"
 msgstr "Liste mit mehreren Ebenen"
 
+msgctxt "The merge field element name displayed in the suggestion."
+msgid "ELEMENT_MERGE_FIELD"
+msgid_plural "%0 merge fields"
+msgstr[0] ""
+msgstr[1] ""
+
 msgctxt "The alignment format name displayed in a format suggestion."
 msgid "FORMAT_ALIGNMENT"
 msgstr "Ausrichtung"