@ckeditor/ckeditor5-track-changes 40.0.0 → 40.2.0

package/src/integrations/utils.js

@@ -20,4 +20,4 @@
  *
  *
  */
-const _0x2987=['name','createRangeOn','get','activeMarkers','markerRange','writer','element','listIndent','push','toViewElement','TrackChangesEditing','createUIElement','type','getItems','listItem','mapper','test','elementEnd','insert','includes','markerName','nextSibling','getCustomProperty','item','addClass','isAtEnd','isContent','getWalker','bindElementToMarker','plugins','model'];(function(_0xba327,_0x2987c7){const _0x5cd508=function(_0x5a57e9){while(--_0x5a57e9){_0xba327['push'](_0xba327['shift']());}};_0x5cd508(++_0x2987c7);}(_0x2987,0x67));const _0x5cd5=function(_0xba327,_0x2987c7){_0xba327=_0xba327-0x0;let _0x5cd508=_0x2987[_0xba327];return _0x5cd508;};export function getRangesWithAttribute(_0x27256a,_0x4ec76e,_0x529c17){const _0x113a58=[];for(const _0xcff14 of _0x4ec76e[_0x5cd5('0x3')]())_0xcff14['hasAttribute'](_0x27256a)&&_0x113a58[_0x5cd5('0x1d')](_0x529c17[_0x5cd5('0x16')](_0xcff14));return _0x113a58;}export function getElementsAffectedByListItemRename(_0x2d6300){const _0x25595d=[];if(_0x2d6300['is'](_0x5cd5('0x1b'),'listItem')){let _0x4ea83b=_0x2d6300[_0x5cd5('0xb')];for(;_0x4ea83b&&_0x4ea83b['is'](_0x5cd5('0x1b'),_0x5cd5('0x4'))&&_0x4ea83b['getAttribute'](_0x5cd5('0x1c'))>0x0;)_0x25595d[_0x5cd5('0x1d')](_0x4ea83b),_0x4ea83b=_0x4ea83b[_0x5cd5('0xb')];}return _0x25595d;}export function downcastSplitMergeMarker(_0x1db6b8,_0x21f513,{showActiveMarker:_0x31c1f8=!0x0}={}){const _0x5205fe=_0x1db6b8[_0x5cd5('0x13')][_0x5cd5('0x17')](_0x5cd5('0x0'));return(_0x5e90ba,_0x107237,_0xb5b61a)=>{if(!_0xb5b61a['consumable'][_0x5cd5('0x6')](_0x107237[_0x5cd5('0x19')],_0x5e90ba[_0x5cd5('0x15')]))return;const _0x93379f=_0x107237['markerRange'][_0x5cd5('0x11')](),_0x5e9a3a=_0x107237['markerRange']['start'],_0x56149f=_0x1db6b8[_0x5cd5('0x14')]['schema'];let _0x4862ba=null,_0x555d22=null,_0x22fd77=!0x1,_0x350f7f=!0x1;for(const _0x2586a8 of _0x93379f){const _0x5929ad=_0x2586a8[_0x5cd5('0xd')];_0x22fd77=_0x22fd77||_0x56149f[_0x5cd5('0x10')](_0x5929ad);const _0x116190=_0xb5b61a[_0x5cd5('0x5')][_0x5cd5('0x1e')](_0x5929ad);if(_0x116190&&_0x116190[_0x5cd5('0xc')]('addHighlight'))return;_0x5cd5('0x7')==_0x2586a8[_0x5cd5('0x2')]&&(_0x56149f['isBlock'](_0x5929ad)&&!_0x56149f['isLimit'](_0x5929ad)&&(_0x5929ad[_0x5cd5('0xb')]||_0x5e9a3a[_0x5cd5('0xf')]?_0x4862ba&&_0x4862ba['parent']==_0x5929ad||(_0x4862ba=_0x5929ad,_0x2a1c57(_0x2586a8['previousPosition']),_0x350f7f=!0x0):_0x555d22=_0x555d22||_0x2586a8['previousPosition']));}function _0x2a1c57(_0x5b2720){const _0x9f1078=_0xb5b61a[_0x5cd5('0x1a')][_0x5cd5('0x1')]('span',{'class':'ck-suggestion-marker-'+_0x21f513}),_0x140632=_0xb5b61a[_0x5cd5('0x5')]['toViewPosition'](_0x5b2720);_0x31c1f8&&_0x5205fe[_0x5cd5('0x18')][_0x5cd5('0x9')](_0x107237[_0x5cd5('0xa')])&&_0xb5b61a[_0x5cd5('0x1a')][_0x5cd5('0xe')]('ck-suggestion-marker--active',_0x9f1078),_0xb5b61a['writer'][_0x5cd5('0x8')](_0x140632,_0x9f1078),_0xb5b61a['mapper'][_0x5cd5('0x12')](_0x9f1078,_0x107237[_0x5cd5('0xa')]);}_0x22fd77||_0x350f7f||!_0x555d22||_0x2a1c57(_0x555d22);};}
+const _0x24ba=['plugins','writer','activeMarkers','push','schema','getAttribute','getWalker','isAtEnd','ck-suggestion-marker--active','mapper','addClass','isContent','consumable','name','element','nextSibling','createUIElement','test','insert','type','elementEnd','get','markerName','getItems','isLimit','createRangeOn','toViewPosition','includes','parent','markerRange','previousPosition','listItem','item','getCustomProperty'];(function(_0x573cd9,_0x24ba71){const _0x4920d1=function(_0x42eb05){while(--_0x42eb05){_0x573cd9['push'](_0x573cd9['shift']());}};_0x4920d1(++_0x24ba71);}(_0x24ba,0x1d2));const _0x4920=function(_0x573cd9,_0x24ba71){_0x573cd9=_0x573cd9-0x0;let _0x4920d1=_0x24ba[_0x573cd9];return _0x4920d1;};export function getRangesWithAttribute(_0x417211,_0x1f5a50,_0xd96e01){const _0x1bb612=[];for(const _0x2a5d75 of _0x1f5a50[_0x4920('0x21')]())_0x2a5d75['hasAttribute'](_0x417211)&&_0x1bb612[_0x4920('0xd')](_0xd96e01[_0x4920('0x1')](_0x2a5d75));return _0x1bb612;}export function getElementsAffectedByListItemRename(_0x4775ac){const _0xcf7fb3=[];if(_0x4775ac['is'](_0x4920('0x18'),_0x4920('0x7'))){let _0x4a20a1=_0x4775ac[_0x4920('0x19')];for(;_0x4a20a1&&_0x4a20a1['is'](_0x4920('0x18'),_0x4920('0x7'))&&_0x4a20a1[_0x4920('0xf')]('listIndent')>0x0;)_0xcf7fb3[_0x4920('0xd')](_0x4a20a1),_0x4a20a1=_0x4a20a1['nextSibling'];}return _0xcf7fb3;}export function downcastSplitMergeMarker(_0x1320f8,_0x875cd6,{showActiveMarker:_0x54e40b=!0x0}={}){const _0x1aad58=_0x1320f8[_0x4920('0xa')][_0x4920('0x1f')]('TrackChangesEditing');return(_0x2f42e2,_0x33a0cc,_0x2312db)=>{if(!_0x2312db[_0x4920('0x16')][_0x4920('0x1b')](_0x33a0cc['markerRange'],_0x2f42e2[_0x4920('0x17')]))return;const _0x5887da=_0x33a0cc[_0x4920('0x5')][_0x4920('0x10')](),_0x4146d3=_0x33a0cc[_0x4920('0x5')]['start'],_0x3a9cde=_0x1320f8['model'][_0x4920('0xe')];let _0x4d1db5=null,_0x4f7b9f=null,_0x596b7f=!0x1,_0x5a4591=!0x1;for(const _0x408a3c of _0x5887da){const _0x4b44cc=_0x408a3c[_0x4920('0x8')];_0x596b7f=_0x596b7f||_0x3a9cde[_0x4920('0x15')](_0x4b44cc);const _0x342862=_0x2312db[_0x4920('0x13')]['toViewElement'](_0x4b44cc);if(_0x342862&&_0x342862[_0x4920('0x9')]('addHighlight'))return;_0x4920('0x1e')==_0x408a3c[_0x4920('0x1d')]&&(_0x3a9cde['isBlock'](_0x4b44cc)&&!_0x3a9cde[_0x4920('0x0')](_0x4b44cc)&&(_0x4b44cc[_0x4920('0x19')]||_0x4146d3[_0x4920('0x11')]?_0x4d1db5&&_0x4d1db5[_0x4920('0x4')]==_0x4b44cc||(_0x4d1db5=_0x4b44cc,_0x527016(_0x408a3c[_0x4920('0x6')]),_0x5a4591=!0x0):_0x4f7b9f=_0x4f7b9f||_0x408a3c[_0x4920('0x6')]));}function _0x527016(_0x4d97fa){const _0x96e38d=_0x2312db[_0x4920('0xb')][_0x4920('0x1a')]('span',{'class':'ck-suggestion-marker-'+_0x875cd6}),_0x2db5df=_0x2312db[_0x4920('0x13')][_0x4920('0x2')](_0x4d97fa);_0x54e40b&&_0x1aad58[_0x4920('0xc')][_0x4920('0x3')](_0x33a0cc[_0x4920('0x20')])&&_0x2312db['writer'][_0x4920('0x14')](_0x4920('0x12'),_0x96e38d),_0x2312db[_0x4920('0xb')][_0x4920('0x1c')](_0x2db5df,_0x96e38d),_0x2312db[_0x4920('0x13')]['bindElementToMarker'](_0x96e38d,_0x33a0cc[_0x4920('0x20')]);}_0x596b7f||_0x5a4591||!_0x4f7b9f||_0x527016(_0x4f7b9f);};}

package/src/suggestion.d.ts

@@ -1,276 +1,291 @@
-/**
- * @license Copyright (c) 2003-2023, 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/suggestion
- * @publicApi
- */
-import { Element, type Marker, type Model, type Range, type Item } from 'ckeditor5/src/engine';
-import type { User } from 'ckeditor5-collaboration/src/collaboration-core';
-import type { CommentThread } from '@ckeditor/ckeditor5-comments';
-import type { FormatData } from './trackchangesediting';
-declare const Suggestion_base: {
-    new (): import("ckeditor5/src/utils").Observable;
-    prototype: import("ckeditor5/src/utils").Observable; /**
-     * Previous suggestion in suggestions chain.
-     *
-     * Chained suggestions should be handled as one entity.
-     *
-     * @observable
-     */
-};
-/**
- * Represents a singular suggestion that is tracked by track changes plugin.
- *
- * `Suggestion` instances are created and handled by {@link module:track-changes/trackchanges~TrackChanges track changes plugin}.
- */
-export default class Suggestion extends Suggestion_base {
-    /**
-     * Suggestion ID.
-     */
-    readonly id: string;
-    /**
-     * Suggestion type.
-     */
-    type: SuggestionType;
-    /**
-     * Suggestion sub-type.
-     *
-     * This is an additional identifier for suggestions. Two suggestions of the same type may have different sub-types to differentiate
-     * suggestions behavior and handle interactions between suggestions.
-     *
-     * Sub-type is used for:
-     *
-     *  * suggestions joining (only suggestions with the same sub-type can be joined),
-     *  * suggestions custom callbacks (fired when adding, deleting and joining suggestions).
-     */
-    subType: string | null;
-    /**
-     * The author of the change marked by the suggestion.
-     */
-    author: User;
-    /**
-     * The user which saved the suggestion data in the database.
-     *
-     * Usually the same as author but may be different in some cases (e.g. when suggestion was added from an external source).
-     */
-    creator: User;
-    /**
-     * The flag indicating whether the suggestion comes from an external source.
-     */
-    isExternal: boolean;
-    /**
-     * Additional suggestion data.
-     */
-    data: FormatData | null;
-    /**
-     * Date when the suggestion was saved in the database.
-     */
-    createdAt: Date | null;
-    /**
-     * Date when the change marked by the suggestion was made.
-     *
-     * Usually the same as {@link #createdAt `createdAt`} but may be different in some cases
-     * (e.g. when suggestion was added from an external source).
-     *
-     * @observable
-     */
-    authoredAt: Date | null;
-    /**
-     * Custom suggestion attributes. See also {@link #setAttribute} and {@link #removeAttribute}.
-     *
-     * @observable
-     */
-    attributes: {
-        [k: string]: unknown;
-    };
-    /**
-     * Previous suggestion in suggestions chain.
-     *
-     * Chained suggestions should be handled as one entity.
-     *
-     * @observable
-     */
-    previous: Suggestion | null;
-    /**
-     * Next suggestion in suggestions chain.
-     *
-     * Chained suggestions should be handled as one entity.
-     *
-     * @observable
-     */
-    next: Suggestion | null;
-    /**
-     * Comment thread model for comments added to this suggestion.
-     *
-     * @observable
-     */
-    commentThread: CommentThread | null;
-    constructor(model: Model, options: SuggestionOptions);
-    /**
-     * The first (most-previous) suggestion in this suggestion chain.
-     */
-    get head(): Suggestion;
-    /**
-     * Informs whether suggestion has at least one comment.
-     */
-    get hasComments(): boolean;
-    /**
-     * Informs whether the suggestion is a multi-range suggestion or a single-range suggestion.
-     *
-     * This is evaluated basing on the marker name belonging to this suggestion.
-     * Even if only one marker belongs to the suggestion at a given time it can still be a multi range suggestion.
-     */
-    get isMultiRange(): boolean;
-    /**
-     * Informs whether the suggestion is still in the editor content.
-     *
-     * Returns `true` if there is at least one marker suggestion in the editor content.
-     */
-    get isInContent(): boolean;
-    /**
-     * Binds given marker name to this suggestion.
-     */
-    addMarkerName(markerName: string): void;
-    /**
-     * Returns all names of markers belonging to this suggestion.
-     */
-    getMarkerNames(): Array<string>;
-    /**
-     * Returns all markers belonging to this suggestion.
-     */
-    getMarkers(): Array<Marker>;
-    /**
-     * Returns the first marker belonging to this suggestion, i.e the first marker that was added to this suggestion
-     * and not removed yet.
-     *
-     * This method is useful if you know that the suggestion has only one marker and want to process it.
-     */
-    getFirstMarker(): Marker | null;
-    /**
-     * Removes all markers from the suggestion and the editor content.
-     */
-    removeMarkers(): void;
-    /**
-     * Removes marker with the given name from the suggestion and the editor content.
-     */
-    removeMarker(markerName: string): void;
-    /**
-     * Adds a new range to this suggestion. It is assumed that the suggestion is a multi-range suggestion.
-     *
-     * A marker name is generated from this suggestion's properties and a marker with that name is created and set to a given `range`.
-     */
-    addRange(range: Range): void;
-    /**
-     * Checks if given `range` is intersecting with any of the ranges of markers belonging to this suggestion.
-     */
-    isIntersectingWithRange(range: Range): boolean;
-    /**
-     * Returns all ranges of all markers belonging to this suggestion.
-     */
-    getRanges(): Array<Range>;
-    /**
-     * Returns all {@link module:engine/model/item~Item model items} that are in this suggestion.
-     */
-    getItems(): Array<Item>;
-    /**
-     * Returns the first range belonging to this suggestion, i.e. the range of the first marker that was added to
-     * this suggestion and not removed yet.
-     *
-     * This method is useful if you know that the suggestion has only one marker and want to process its range.
-     */
-    getFirstRange(): Range | null;
-    /**
-     * Returns the model element contained in the suggestion.
-     *
-     * A {@link module:engine/model/element~Element model element} is considered as contained if there is exactly
-     * one range in the suggestion, and that range contains exactly one element.
-     *
-     * Returns `null` if there is no contained element.
-     */
-    getContainedElement(): Element | null;
-    /**
-     * Accepts the suggestion.
-     */
-    accept(): void;
-    /**
-     * Discards the suggestion.
-     */
-    discard(): void;
-    /**
-     * Returns all suggestions that are in this suggestion chain.
-     */
-    getAllAdjacentSuggestions(): Array<Suggestion>;
-    /**
-     * Adds suggestion attribute.
-     *
-     * Suggestion attributes are custom data that can be set and used by features
-     * built around suggestions. Use it to store your feature data with other suggestion data.
-     *
-     * ```ts
-     * suggestion.setAttribute( 'isImportant', true );
-     * ```
-     *
-     * You can group multiple values in an object, using dot notation:
-     *
-     * ```ts
-     * suggestion.setAttribute( 'customData.type', 'image' );
-     * suggestion.setAttribute( 'customData.src', 'foo.jpg' );
-     * ```
-     *
-     * Attributes set on the suggestion can be accessed through `attribute` property:
-     *
-     * ```ts
-     * const isImportant = suggestion.attributes.isImportant;
-     * const type = suggestion.attributes.customData.type;
-     * ```
-     *
-     * You can also observe `attributes` property or bind other properties to it:
-     *
-     * ```ts
-     * myObj.bind( 'customData' ).to( suggestion, 'attributes', attributes => attributes.customData );
-     * ```
-     *
-     * Whenever `setAttribute()` or `removeAttribute()` is called, `attributes` property
-     * is re-set and observables are refreshed.
-     */
-    setAttribute(name: string, value: unknown): void;
-    /**
-     * Removes suggestion attribute.
-     *
-     * See also {@link #setAttribute}
-     */
-    removeAttribute(name: string): void;
-    toJSON(): SuggestionJSON;
-    /**
-     * Returns a random string that can be used as additional identifier for the marker name for suggestions that are multi range.
-     */
-    static getMultiRangeId(): string;
-}
-export interface SuggestionOptions {
-    id: string;
-    type: SuggestionType;
-    subType: string | null;
-    attributes: {
-        [k: string]: unknown;
-    };
-    author: User;
-    creator: User;
-    onAccept: Function;
-    onDiscard: Function;
-    onAttributesChange: Function;
-}
-export interface SuggestionJSON {
-    id: string;
-    type: string;
-    authorId: string;
-    createdAt: Date | null;
-    hasComments?: boolean;
-    data?: FormatData | null;
-    attributes: {
-        [k: string]: unknown;
-    };
-}
-export type SuggestionType = 'insertion' | 'deletion' | 'formatInline' | 'formatBlock';
-export {};
+/**
+ * @license Copyright (c) 2003-2023, 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/suggestion
+ * @publicApi
+ */
+import { Element, type Marker, type Model, type Range, type Item } from 'ckeditor5/src/engine';
+import type { User } from 'ckeditor5-collaboration/src/collaboration-core';
+import type { CommentThread } from '@ckeditor/ckeditor5-comments';
+import type { FormatData, AttributeData } from './trackchangesediting';
+declare const Suggestion_base: {
+    new (): import("ckeditor5/src/utils").Observable;
+    prototype: import("ckeditor5/src/utils").Observable;
+};
+/**
+ * Represents a singular suggestion that is tracked by track changes plugin.
+ *
+ * `Suggestion` instances are created and handled by {@link module:track-changes/trackchanges~TrackChanges track changes plugin}.
+ */
+export default class Suggestion extends Suggestion_base {
+    /**
+     * Suggestion ID.
+     */
+    readonly id: string;
+    /**
+     * Suggestion type.
+     */
+    type: SuggestionType;
+    /**
+     * Suggestion sub-type.
+     *
+     * This is an additional identifier for suggestions. Two suggestions of the same type may have different sub-types to differentiate
+     * suggestions behavior and handle interactions between suggestions.
+     *
+     * Sub-type is used for:
+     *
+     *  * suggestions joining (only suggestions with the same sub-type can be joined),
+     *  * suggestions custom callbacks (fired when adding, deleting and joining suggestions).
+     */
+    subType: string | null;
+    /**
+     * The author of the change marked by the suggestion.
+     */
+    author: User;
+    /**
+     * The user which saved the suggestion data in the database.
+     *
+     * Usually the same as author but may be different in some cases (e.g. when suggestion was added from an external source).
+     */
+    creator: User;
+    /**
+     * The flag indicating whether the suggestion comes from an external source.
+     */
+    isExternal: boolean;
+    /**
+     * Additional suggestion data.
+     */
+    data: FormatData | AttributeData | null;
+    /**
+     * Date when the suggestion was saved in the database.
+     */
+    createdAt: Date | null;
+    /**
+     * Date when the change marked by the suggestion was made.
+     *
+     * Usually the same as {@link #createdAt `createdAt`} but may be different in some cases
+     * (e.g. when suggestion was added from an external source).
+     *
+     * @observable
+     */
+    authoredAt: Date | null;
+    /**
+     * Custom suggestion attributes. See also {@link #setAttribute} and {@link #removeAttribute}.
+     *
+     * @observable
+     */
+    attributes: {
+        [k: string]: unknown;
+    };
+    /**
+     * Previous suggestion in suggestions chain.
+     *
+     * Chained suggestions should be handled as one entity.
+     *
+     * @observable
+     */
+    previous: Suggestion | null;
+    /**
+     * Next suggestion in suggestions chain.
+     *
+     * Chained suggestions should be handled as one entity.
+     *
+     * @observable
+     */
+    next: Suggestion | null;
+    /**
+     * Comment thread model for comments added to this suggestion.
+     *
+     * @observable
+     */
+    commentThread: CommentThread | null;
+    constructor(model: Model, options: SuggestionOptions);
+    /**
+     * The first (most-previous) suggestion in this suggestion chain.
+     */
+    get head(): Suggestion;
+    /**
+     * Informs whether suggestion has at least one comment.
+     */
+    get hasComments(): boolean;
+    /**
+     * Informs whether the suggestion is a multi-range suggestion or a single-range suggestion.
+     *
+     * This is evaluated basing on the marker name belonging to this suggestion.
+     * Even if only one marker belongs to the suggestion at a given time it can still be a multi range suggestion.
+     */
+    get isMultiRange(): boolean;
+    /**
+     * Informs whether the suggestion is still in the editor content.
+     *
+     * Returns `true` if there is at least one marker suggestion in the editor content.
+     */
+    get isInContent(): boolean;
+    /**
+     * Binds given marker name to this suggestion.
+     */
+    addMarkerName(markerName: string): void;
+    /**
+     * Returns all names of markers belonging to this suggestion.
+     */
+    getMarkerNames(): Array<string>;
+    /**
+     * Returns all markers belonging to this suggestion.
+     */
+    getMarkers(): Array<Marker>;
+    /**
+     * Returns the first marker belonging to this suggestion, i.e the first marker that was added to this suggestion
+     * and not removed yet.
+     *
+     * This method is useful if you know that the suggestion has only one marker and want to process it.
+     */
+    getFirstMarker(): Marker | null;
+    /**
+     * Removes all markers from the suggestion and the editor content.
+     */
+    removeMarkers(): void;
+    /**
+     * Removes marker with the given name from the suggestion and the editor content.
+     */
+    removeMarker(markerName: string): void;
+    /**
+     * Adds a new range to this suggestion. It is assumed that the suggestion is a multi-range suggestion.
+     *
+     * A marker name is generated from this suggestion's properties and a marker with that name is created and set to a given `range`.
+     */
+    addRange(range: Range): void;
+    /**
+     * Checks if given `range` is intersecting with any of the ranges of markers belonging to this suggestion.
+     */
+    isIntersectingWithRange(range: Range): boolean;
+    /**
+     * Returns all ranges of all markers belonging to this suggestion.
+     */
+    getRanges(): Array<Range>;
+    /**
+     * Returns all {@link module:engine/model/item~Item model items} that are in this suggestion.
+     */
+    getItems(): Array<Item>;
+    /**
+     * Returns the first range belonging to this suggestion, i.e. the range of the first marker that was added to
+     * this suggestion and not removed yet.
+     *
+     * This method is useful if you know that the suggestion has only one marker and want to process its range.
+     */
+    getFirstRange(): Range | null;
+    /**
+     * Returns the model element contained in the suggestion.
+     *
+     * A {@link module:engine/model/element~Element model element} is considered as contained if there is exactly
+     * one range in the suggestion, and that range contains exactly one element.
+     *
+     * Returns `null` if there is no contained element.
+     */
+    getContainedElement(): Element | null;
+    /**
+     * Accepts the suggestion.
+     */
+    accept(): void;
+    /**
+     * Discards the suggestion.
+     */
+    discard(): void;
+    /**
+     * Returns all suggestions that are in this suggestion chain.
+     */
+    getAllAdjacentSuggestions(): Array<Suggestion>;
+    /**
+     * Adds suggestion attribute.
+     *
+     * Suggestion attributes are custom data that can be set and used by features
+     * built around suggestions. Use it to store your feature data with other suggestion data.
+     *
+     * ```ts
+     * suggestion.setAttribute( 'isImportant', true );
+     * ```
+     *
+     * You can group multiple values in an object, using dot notation:
+     *
+     * ```ts
+     * suggestion.setAttribute( 'customData.type', 'image' );
+     * suggestion.setAttribute( 'customData.src', 'foo.jpg' );
+     * ```
+     *
+     * Attributes set on the suggestion can be accessed through `attribute` property:
+     *
+     * ```ts
+     * const isImportant = suggestion.attributes.isImportant;
+     * const type = suggestion.attributes.customData.type;
+     * ```
+     *
+     * You can also observe `attributes` property or bind other properties to it:
+     *
+     * ```ts
+     * myObj.bind( 'customData' ).to( suggestion, 'attributes', attributes => attributes.customData );
+     * ```
+     *
+     * Whenever `setAttribute()` or `removeAttribute()` is called, `attributes` property
+     * is re-set and observables are refreshed.
+     */
+    setAttribute(name: string, value: unknown): void;
+    /**
+     * Removes suggestion attribute.
+     *
+     * See also {@link #setAttribute}
+     */
+    removeAttribute(name: string): void;
+    toJSON(): SuggestionJSON;
+    /**
+     * Returns a random string that can be used as additional identifier for the marker name for suggestions that are multi range.
+     */
+    static getMultiRangeId(): string;
+}
+export interface SuggestionOptions {
+    id: string;
+    type: SuggestionType;
+    subType: string | null;
+    attributes: {
+        [k: string]: unknown;
+    };
+    author: User;
+    creator: User;
+    onAccept: Function;
+    onDiscard: Function;
+    onAttributesChange: Function;
+}
+export interface SuggestionJSON {
+    /**
+     * Suggestion ID.
+     */
+    id: string;
+    /**
+     * Contains the information about the type and subtype of the suggestion.
+     */
+    type: string;
+    /**
+     * The ID of the author.
+     */
+    authorId: string;
+    /**
+     * Date when the suggestion was saved in the database.
+     */
+    createdAt: Date | null;
+    /**
+     * Informs whether suggestion has at least one comment.
+     */
+    hasComments?: boolean;
+    /**
+     * Additional suggestion data.
+     */
+    data?: FormatData | AttributeData | null;
+    /**
+     * Custom suggestion attributes.
+     */
+    attributes: {
+        [k: string]: unknown;
+    };
+}
+export type SuggestionType = 'insertion' | 'deletion' | 'formatInline' | 'formatBlock' | 'attribute';
+export {};