@ckeditor/ckeditor5-track-changes 38.1.0 → 38.1.1

package/src/trackchanges.d.ts

@@ -1,240 +1,240 @@
-/**
- * @module track-changes/trackchanges
- * @publicApi
- */
-import { Plugin } from 'ckeditor5/src/core';
-import TrackChangesUI from './trackchangesui';
-import TrackChangesEditing from './trackchangesediting';
-import 'ckeditor5-collaboration/src/collaboration-core';
-import type { default as Suggestion, SuggestionJSON } from './suggestion';
-import type SuggestionThreadView from './ui/view/suggestionthreadview';
-/**
- * A plugin that provides track changes mode for the editor. In track changes mode, all insertions are visually marked and all deletions
- * are not deleted but also visually marked. Unsupported commands are disabled when the editor is in the track changes mode.
- *
- * To learn how to integrate the track changes feature with your editor, refer to the
- * {@glink features/collaboration/track-changes/track-changes-integration Track changes integration} guide.
- *
- * Basic API:
- *
- * ```ts
- * // Get the track changes plugin:
- * const trackChangesPlugin = editor.plugins.get( 'TrackChanges' );
- *
- * // Add a suggestion:
- * trackChangesPlugin.addSuggestion( suggestionData );
- *
- * // Get all suggestions:
- * trackChangesPlugin.getSuggestions();
- *
- * // Set the adapter:
- * trackChangesPlugin.adapter = {
- * 		// ...
- * }
- * ```
- *
- * The plugin registers several commands:
- *
- * * `trackChanges` – Toggles the track changes mode in the editor.
- * * `acceptSuggestion` – Accepts a suggestion with the specified ID.
- * * `discardSuggestion` – Discards a suggestion with the specified ID.
- * * `acceptAllSuggestions` – Accepts all suggestions.
- * * `discardAllSuggestions` – Discards all suggestions.
- * * `acceptSelectedSuggestions` – Accepts all suggestions in the current selection.
- * * `discardSelectedSuggestions` – Discards all suggestions in the current selection.
- *
- * Examples:
- *
- * ```ts
- * editor.execute( 'trackChanges' );
- * editor.execute( 'acceptSuggestion', 'suggestion-1' );
- * editor.execute( 'discardSuggestion', 'suggestion-1' );
- * editor.execute( 'acceptAllSuggestions' );
- * editor.execute( 'discardAllSuggestions' );
- * editor.execute( 'acceptSelectedSuggestions' );
- * editor.execute( 'discardSelectedSuggestions' )
- * ```
- *
- * Note that there is no command to add a suggestion. This is because suggestions
- * are added automatically when editing commands are executed while the editor is in track
- * changes mode. For instance:
- *
- * ```ts
- * // Turn on the track changes mode:
- * editor.execute( 'trackChanges' );
- *
- * // Insert some text. It will be automatically inserted as a suggestion:
- * editor.execute( 'input', { text: 'foo' } );
- * ```
- */
-export default class TrackChanges extends Plugin {
-    static get requires(): readonly [typeof TrackChangesEditing, typeof TrackChangesUI, "Comments"];
-    static get pluginName(): "TrackChanges";
-    /**
-     * An adapter object that should communicate with the data source to fetch or save the suggestion data.
-     *
-     * This is a shorthand to {@link module:track-changes/trackchangesediting~TrackChangesEditing#adapter `TrackChangesEditing#adapter`}.
-     */
-    set adapter(adapter: TrackChangesAdapter | null);
-    get adapter(): TrackChangesAdapter | null;
-    /**
-     * Adds suggestion data.
-     *
-     * Use this method to load the suggestion data during the editor initialization if you do not use the adapter integration.
-     */
-    addSuggestion(suggestionData: SuggestionData): Suggestion;
-    getSuggestions(options: {
-        skipNotAttached?: boolean;
-        toJSON: true;
-    }): Array<SuggestionJSON>;
-    getSuggestions(options?: {
-        skipNotAttached?: boolean;
-        toJSON?: false;
-    }): Array<Suggestion>;
-    getSuggestions(options: {
-        skipNotAttached?: boolean;
-        toJSON: boolean;
-    }): Array<Suggestion> | Array<SuggestionJSON>;
-    /**
-     * Returns the suggestion instance for a given ID.
-     */
-    getSuggestion(id: string): Suggestion;
-}
-/**
- * The configuration of the track changes feature.
- *
- * Example:
- *
- * ```ts
- * ClassicEditor
- *			.create( {
- *				// Track changes feature configuration.
- *				trackChanges: {
- *					// Do not allow users to comment suggestions (default is `false`).
- *					disableComments: true,
- *					// Do not track styling and formatting changes (default is `default`).
- *					trackFormatChanges: 'never',
- * 				    // Merges suggestion changes inside a block. (default is `true`).
- * 					mergeNestedSuggestions: true
- *				}
- *			} )
- *			.then( ... )
- *			.catch( ... );
- * ```
- *
- * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
- */
-export interface TrackChangesConfig {
-    /**
-     * A property that specifies if the comments for suggestions are enabled or disabled.
-     * When the option is set to `true`, the comment thread UI for suggestions will be hidden
-     * and commenting suggestions will be disabled.
-     *
-     * Suggestion thread views will be marked with the additional `ck-suggestion--disabled-comments` class when the suggestion comments
-     * are disabled.
-     */
-    disableComments: boolean;
-    /**
-     * A property that specifies whether format changes should be tracked.
-     *
-     * Format changes are all changes other than insertions and deletions, including: styling, structure, widgets properties, etc.
-     *
-     * Possible values are:
-     *
-     * * `'always'` - all changes are going to be tracked independently (without merging).
-     * * `'default'` - format changes made inside your own insertion suggestion will be merged with it.
-     * * `'never'` - format changes will not be tracked.
-     *
-     * Defaults to `'default'`.
-     */
-    trackFormatChanges: 'never' | 'default' | 'always';
-    /**
-     * Specifies whether suggestions on an object (e.g. image, table) should be automatically merged
-     * with suggestions inside the object (e.g. image caption, table cell).
-     *
-     * For example, when set to `true`, creating a table and writing some text inside the table will result in one suggestion.
-     * When set to `false`, it will be two separate suggestions, one for the inserted table and one for the inserted text.
-     *
-     * Keep in mind that only suggestions from the same author and of the same type are merged this way.
-     */
-    mergeNestedSuggestions: boolean;
-    /**
-     * A view class to be used to create suggestion thread views.
-     *
-     * {@link module:track-changes/ui/view/suggestionthreadview~SuggestionThreadView} is used by default
-     *  when this property is not set.
-     */
-    SuggestionThreadView?: typeof SuggestionThreadView;
-}
-/**
- * Track changes adapter.
- *
- * The track changes adapter is an object that communicates asynchronously with the data source to fetch or save the suggestion data.
- * It is used internally by the track changes feature whenever a suggestion is loaded, created or deleted.
- *
- * The adapter is optional. You might need to provide it if you are {@glink features/collaboration/track-changes/track-changes-integration}
- * using the track changes feature without real-time collaboration.
- *
- * To set the adapter, overwrite {@link module:track-changes/trackchanges~TrackChanges#adapter the `TrackChanges#adapter` property}.
- */
-export interface TrackChangesAdapter {
-    /**
-     * Called each time the suggestion data is needed.
-     *
-     * The method should return a promise that resolves with the suggestion data object.
-     *
-     * @param id The ID of the suggestion to get.
-     */
-    getSuggestion(id: string): Promise<SuggestionData>;
-    /**
-     * Called each time a new suggestion is created.
-     *
-     * The method should save the suggestion data in the database
-     * and return a promise that should be resolved when the save is
-     * completed.
-     *
-     * If the promise resolves with an object with the `createdAt` property,
-     * this suggestion property will be updated in the suggestion in the editor.
-     * This lets you update the suggestion data with server-side information.
-     *
-     * The `suggestionData` object does not expect the `authorId` property.
-     * For security reasons, the author of the suggestion should be set
-     * on the server side.
-     *
-     * If `suggestionData.originalSuggestionId` is set, the new suggestion should
-     * have the `authorId` property set to the same as the suggestion with
-     * `originalSuggestionId`. This happens when one user splits
-     * another user's suggestion, creating a new suggestion as a result. See
-     * {@glink features/collaboration/track-changes/track-changes-integration#implementation Track changes integration} guide.
-     *
-     * **Note:** Failure to properly handle this property will result in editor crash in some scenarios.
-     *
-     * In any other case, use the current (local) user to set `authorId`.
-     *
-     * The `suggestionData` object does not expect the `createdAt` property either.
-     * You should use the server-side time generator to ensure that all users
-     * see the same date.
-     *
-     * It is recommended to stringify `suggestionData.attributes` value to JSON and save it as a string in your database,
-     * and then to parse the strings when loading suggestions.
-     */
-    addSuggestion(suggestionData: AddSuggestionInput): Promise<SuggestionData>;
-    /**
-     * Called each time the suggestion properties change.
-     *
-     * The method should update the suggestion properties in the database
-     * and return a promise that should be resolved when the save is
-     * completed.
-     *
-     * Keep in mind that the `data` parameter only contains those
-     * properties of a suggestion which changed.
-     */
-    updateSuggestion(id: string, suggestionData: UpdateSuggestionInput): Promise<void>;
-}
-export type SuggestionData = SuggestionJSON & {
-    originalSuggestionId?: string | null;
-};
-export type AddSuggestionInput = Omit<SuggestionData, 'authorId' | 'createdAt'>;
-export type UpdateSuggestionInput = Partial<Pick<SuggestionJSON, 'hasComments' | 'attributes'>> & {
-    state?: 'open' | 'accepted' | 'rejected';
-};
+/**
+ * @module track-changes/trackchanges
+ * @publicApi
+ */
+import { Plugin } from 'ckeditor5/src/core';
+import TrackChangesUI from './trackchangesui';
+import TrackChangesEditing from './trackchangesediting';
+import 'ckeditor5-collaboration/src/collaboration-core';
+import type { default as Suggestion, SuggestionJSON } from './suggestion';
+import type SuggestionThreadView from './ui/view/suggestionthreadview';
+/**
+ * A plugin that provides track changes mode for the editor. In track changes mode, all insertions are visually marked and all deletions
+ * are not deleted but also visually marked. Unsupported commands are disabled when the editor is in the track changes mode.
+ *
+ * To learn how to integrate the track changes feature with your editor, refer to the
+ * {@glink features/collaboration/track-changes/track-changes-integration Track changes integration} guide.
+ *
+ * Basic API:
+ *
+ * ```ts
+ * // Get the track changes plugin:
+ * const trackChangesPlugin = editor.plugins.get( 'TrackChanges' );
+ *
+ * // Add a suggestion:
+ * trackChangesPlugin.addSuggestion( suggestionData );
+ *
+ * // Get all suggestions:
+ * trackChangesPlugin.getSuggestions();
+ *
+ * // Set the adapter:
+ * trackChangesPlugin.adapter = {
+ * 		// ...
+ * }
+ * ```
+ *
+ * The plugin registers several commands:
+ *
+ * * `trackChanges` &ndash; Toggles the track changes mode in the editor.
+ * * `acceptSuggestion` &ndash; Accepts a suggestion with the specified ID.
+ * * `discardSuggestion` &ndash; Discards a suggestion with the specified ID.
+ * * `acceptAllSuggestions` &ndash; Accepts all suggestions.
+ * * `discardAllSuggestions` &ndash; Discards all suggestions.
+ * * `acceptSelectedSuggestions` &ndash; Accepts all suggestions in the current selection.
+ * * `discardSelectedSuggestions` &ndash; Discards all suggestions in the current selection.
+ *
+ * Examples:
+ *
+ * ```ts
+ * editor.execute( 'trackChanges' );
+ * editor.execute( 'acceptSuggestion', 'suggestion-1' );
+ * editor.execute( 'discardSuggestion', 'suggestion-1' );
+ * editor.execute( 'acceptAllSuggestions' );
+ * editor.execute( 'discardAllSuggestions' );
+ * editor.execute( 'acceptSelectedSuggestions' );
+ * editor.execute( 'discardSelectedSuggestions' )
+ * ```
+ *
+ * Note that there is no command to add a suggestion. This is because suggestions
+ * are added automatically when editing commands are executed while the editor is in track
+ * changes mode. For instance:
+ *
+ * ```ts
+ * // Turn on the track changes mode:
+ * editor.execute( 'trackChanges' );
+ *
+ * // Insert some text. It will be automatically inserted as a suggestion:
+ * editor.execute( 'input', { text: 'foo' } );
+ * ```
+ */
+export default class TrackChanges extends Plugin {
+    static get requires(): readonly [typeof TrackChangesEditing, typeof TrackChangesUI, "Comments"];
+    static get pluginName(): "TrackChanges";
+    /**
+     * An adapter object that should communicate with the data source to fetch or save the suggestion data.
+     *
+     * This is a shorthand to {@link module:track-changes/trackchangesediting~TrackChangesEditing#adapter `TrackChangesEditing#adapter`}.
+     */
+    set adapter(adapter: TrackChangesAdapter | null);
+    get adapter(): TrackChangesAdapter | null;
+    /**
+     * Adds suggestion data.
+     *
+     * Use this method to load the suggestion data during the editor initialization if you do not use the adapter integration.
+     */
+    addSuggestion(suggestionData: SuggestionData): Suggestion;
+    getSuggestions(options: {
+        skipNotAttached?: boolean;
+        toJSON: true;
+    }): Array<SuggestionJSON>;
+    getSuggestions(options?: {
+        skipNotAttached?: boolean;
+        toJSON?: false;
+    }): Array<Suggestion>;
+    getSuggestions(options: {
+        skipNotAttached?: boolean;
+        toJSON: boolean;
+    }): Array<Suggestion> | Array<SuggestionJSON>;
+    /**
+     * Returns the suggestion instance for a given ID.
+     */
+    getSuggestion(id: string): Suggestion;
+}
+/**
+ * The configuration of the track changes feature.
+ *
+ * Example:
+ *
+ * ```ts
+ * ClassicEditor
+ *			.create( {
+ *				// Track changes feature configuration.
+ *				trackChanges: {
+ *					// Do not allow users to comment suggestions (default is `false`).
+ *					disableComments: true,
+ *					// Do not track styling and formatting changes (default is `default`).
+ *					trackFormatChanges: 'never',
+ * 				    // Merges suggestion changes inside a block. (default is `true`).
+ * 					mergeNestedSuggestions: true
+ *				}
+ *			} )
+ *			.then( ... )
+ *			.catch( ... );
+ * ```
+ *
+ * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
+ */
+export interface TrackChangesConfig {
+    /**
+     * A property that specifies if the comments for suggestions are enabled or disabled.
+     * When the option is set to `true`, the comment thread UI for suggestions will be hidden
+     * and commenting suggestions will be disabled.
+     *
+     * Suggestion thread views will be marked with the additional `ck-suggestion--disabled-comments` class when the suggestion comments
+     * are disabled.
+     */
+    disableComments: boolean;
+    /**
+     * A property that specifies whether format changes should be tracked.
+     *
+     * Format changes are all changes other than insertions and deletions, including: styling, structure, widgets properties, etc.
+     *
+     * Possible values are:
+     *
+     * * `'always'` - all changes are going to be tracked independently (without merging).
+     * * `'default'` - format changes made inside your own insertion suggestion will be merged with it.
+     * * `'never'` - format changes will not be tracked.
+     *
+     * Defaults to `'default'`.
+     */
+    trackFormatChanges: 'never' | 'default' | 'always';
+    /**
+     * Specifies whether suggestions on an object (e.g. image, table) should be automatically merged
+     * with suggestions inside the object (e.g. image caption, table cell).
+     *
+     * For example, when set to `true`, creating a table and writing some text inside the table will result in one suggestion.
+     * When set to `false`, it will be two separate suggestions, one for the inserted table and one for the inserted text.
+     *
+     * Keep in mind that only suggestions from the same author and of the same type are merged this way.
+     */
+    mergeNestedSuggestions: boolean;
+    /**
+     * A view class to be used to create suggestion thread views.
+     *
+     * {@link module:track-changes/ui/view/suggestionthreadview~SuggestionThreadView} is used by default
+     *  when this property is not set.
+     */
+    SuggestionThreadView?: typeof SuggestionThreadView;
+}
+/**
+ * Track changes adapter.
+ *
+ * The track changes adapter is an object that communicates asynchronously with the data source to fetch or save the suggestion data.
+ * It is used internally by the track changes feature whenever a suggestion is loaded, created or deleted.
+ *
+ * The adapter is optional. You might need to provide it if you are {@glink features/collaboration/track-changes/track-changes-integration}
+ * using the track changes feature without real-time collaboration.
+ *
+ * To set the adapter, overwrite {@link module:track-changes/trackchanges~TrackChanges#adapter the `TrackChanges#adapter` property}.
+ */
+export interface TrackChangesAdapter {
+    /**
+     * Called each time the suggestion data is needed.
+     *
+     * The method should return a promise that resolves with the suggestion data object.
+     *
+     * @param id The ID of the suggestion to get.
+     */
+    getSuggestion(id: string): Promise<SuggestionData>;
+    /**
+     * Called each time a new suggestion is created.
+     *
+     * The method should save the suggestion data in the database
+     * and return a promise that should be resolved when the save is
+     * completed.
+     *
+     * If the promise resolves with an object with the `createdAt` property,
+     * this suggestion property will be updated in the suggestion in the editor.
+     * This lets you update the suggestion data with server-side information.
+     *
+     * The `suggestionData` object does not expect the `authorId` property.
+     * For security reasons, the author of the suggestion should be set
+     * on the server side.
+     *
+     * If `suggestionData.originalSuggestionId` is set, the new suggestion should
+     * have the `authorId` property set to the same as the suggestion with
+     * `originalSuggestionId`. This happens when one user splits
+     * another user's suggestion, creating a new suggestion as a result. See
+     * {@glink features/collaboration/track-changes/track-changes-integration#implementation Track changes integration} guide.
+     *
+     * **Note:** Failure to properly handle this property will result in editor crash in some scenarios.
+     *
+     * In any other case, use the current (local) user to set `authorId`.
+     *
+     * The `suggestionData` object does not expect the `createdAt` property either.
+     * You should use the server-side time generator to ensure that all users
+     * see the same date.
+     *
+     * It is recommended to stringify `suggestionData.attributes` value to JSON and save it as a string in your database,
+     * and then to parse the strings when loading suggestions.
+     */
+    addSuggestion(suggestionData: AddSuggestionInput): Promise<SuggestionData>;
+    /**
+     * Called each time the suggestion properties change.
+     *
+     * The method should update the suggestion properties in the database
+     * and return a promise that should be resolved when the save is
+     * completed.
+     *
+     * Keep in mind that the `data` parameter only contains those
+     * properties of a suggestion which changed.
+     */
+    updateSuggestion(id: string, suggestionData: UpdateSuggestionInput): Promise<void>;
+}
+export type SuggestionData = SuggestionJSON & {
+    originalSuggestionId?: string | null;
+};
+export type AddSuggestionInput = Omit<SuggestionData, 'authorId' | 'createdAt'>;
+export type UpdateSuggestionInput = Partial<Pick<SuggestionJSON, 'hasComments' | 'attributes'>> & {
+    state?: 'open' | 'accepted' | 'rejected';
+};

package/src/trackchanges.js

@@ -20,4 +20,4 @@
  *
  *
  */
-var _0x32a5=['pluginName','getSuggestion','plugins','requires','addSuggestion','getSuggestions','get','TrackChanges','adapter','editor'];(function(_0x2afac3,_0x32a5fd){var _0x43b55a=function(_0x2dddf9){while(--_0x2dddf9){_0x2afac3['push'](_0x2afac3['shift']());}};_0x43b55a(++_0x32a5fd);}(_0x32a5,0x118));var _0x43b5=function(_0x2afac3,_0x32a5fd){_0x2afac3=_0x2afac3-0x0;var _0x43b55a=_0x32a5[_0x2afac3];return _0x43b55a;};import{Plugin as _0x4af75f}from'ckeditor5/src/core';import _0x346dc1 from'./trackchangesui';import _0x2d2f09 from'./trackchangesediting';import'ckeditor5-collaboration/src/collaboration-core';export default class k extends _0x4af75f{static get[_0x43b5('0x3')](){return[_0x2d2f09,_0x346dc1,'Comments'];}static get[_0x43b5('0x0')](){return _0x43b5('0x7');}set[_0x43b5('0x8')](_0x5d3bcd){this[_0x43b5('0x9')][_0x43b5('0x2')]['get'](_0x2d2f09)[_0x43b5('0x8')]=_0x5d3bcd;}get[_0x43b5('0x8')](){return this[_0x43b5('0x9')][_0x43b5('0x2')][_0x43b5('0x6')](_0x2d2f09)[_0x43b5('0x8')];}[_0x43b5('0x4')](_0x1dee39){return this[_0x43b5('0x9')][_0x43b5('0x2')][_0x43b5('0x6')](_0x2d2f09)['addSuggestionData'](_0x1dee39);}[_0x43b5('0x5')]({skipNotAttached:_0x10744d=!0x1,toJSON:_0x5c8295=!0x1}={}){return this[_0x43b5('0x9')][_0x43b5('0x2')][_0x43b5('0x6')](_0x2d2f09)[_0x43b5('0x5')]({'skipNotAttached':_0x10744d,'toJSON':_0x5c8295});}[_0x43b5('0x1')](_0xa5c54f){return this[_0x43b5('0x9')][_0x43b5('0x2')][_0x43b5('0x6')](_0x2d2f09)[_0x43b5('0x1')](_0xa5c54f);}}
+var _0x184c=['getSuggestion','addSuggestion','pluginName','plugins','getSuggestions','get','editor','addSuggestionData','Comments','TrackChanges','requires','adapter'];(function(_0x13f1cf,_0x184c00){var _0x6c6678=function(_0x29aeea){while(--_0x29aeea){_0x13f1cf['push'](_0x13f1cf['shift']());}};_0x6c6678(++_0x184c00);}(_0x184c,0xb7));var _0x6c66=function(_0x13f1cf,_0x184c00){_0x13f1cf=_0x13f1cf-0x0;var _0x6c6678=_0x184c[_0x13f1cf];return _0x6c6678;};import{Plugin as _0x546198}from'ckeditor5/src/core';import _0x5a382b from'./trackchangesui';import _0x56dee6 from'./trackchangesediting';import'ckeditor5-collaboration/src/collaboration-core';export default class k extends _0x546198{static get[_0x6c66('0x7')](){return[_0x56dee6,_0x5a382b,_0x6c66('0x5')];}static get[_0x6c66('0xb')](){return _0x6c66('0x6');}set['adapter'](_0x4fa274){this[_0x6c66('0x3')][_0x6c66('0x0')]['get'](_0x56dee6)[_0x6c66('0x8')]=_0x4fa274;}get[_0x6c66('0x8')](){return this['editor'][_0x6c66('0x0')][_0x6c66('0x2')](_0x56dee6)[_0x6c66('0x8')];}[_0x6c66('0xa')](_0x520088){return this[_0x6c66('0x3')][_0x6c66('0x0')][_0x6c66('0x2')](_0x56dee6)[_0x6c66('0x4')](_0x520088);}[_0x6c66('0x1')]({skipNotAttached:_0x3c0df2=!0x1,toJSON:_0x131ac0=!0x1}={}){return this[_0x6c66('0x3')][_0x6c66('0x0')][_0x6c66('0x2')](_0x56dee6)['getSuggestions']({'skipNotAttached':_0x3c0df2,'toJSON':_0x131ac0});}[_0x6c66('0x9')](_0x448cc7){return this[_0x6c66('0x3')][_0x6c66('0x0')][_0x6c66('0x2')](_0x56dee6)[_0x6c66('0x9')](_0x448cc7);}}

package/src/trackchangesconfig.d.ts

@@ -1,71 +1,71 @@
-/**
- * @module track-changes/trackchangesconfig
- * @publicApi
- */
-import type SuggestionThreadView from './ui/view/suggestionthreadview';
-/**
- * The configuration of the track changes feature.
- *
- * Example:
- *
- * ```ts
- *		ClassicEditor
- *			.create( {
- *				// Track changes feature configuration.
- *				trackChanges: {
- *					// Do not allow users to comment suggestions (default is `false`).
- *					disableComments: true,
- *					// Do not track styling and formatting changes (default is `default`).
- *					trackFormatChanges: 'never',
- *				    // Merges suggestion changes inside a block. (default is `true`).
- *					mergeNestedSuggestions: true
- *				}
- *			} )
- *			.then( ... )
- *			.catch( ... );
- * ```
- *
- * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
- */
-export interface TrackChangesConfig {
-    /**
-     * A property that specifies if the comments for suggestions are enabled or disabled.
-     * When the option is set to `true`, the comment thread UI for suggestions will be hidden
-     * and commenting suggestions will be disabled.
-     *
-     * Suggestion thread views will be marked with the additional `ck-suggestion--disabled-comments` class when the suggestion comments
-     * are disabled.
-     */
-    disableComments: boolean;
-    /**
-     * A property that specifies whether format changes should be tracked.
-     *
-     * Format changes are all changes other than insertions and deletions, including: styling, structure, widgets properties, etc.
-     *
-     * Possible values are:
-     *
-     * * `'always'` - all changes are going to be tracked independently (without merging).
-     * * `'default'` - format changes made inside your own insertion suggestion will be merged with it.
-     * * `'never'` - format changes will not be tracked.
-     *
-     * Defaults to `'default'`.
-     */
-    trackFormatChanges: 'never' | 'default' | 'always';
-    /**
-     * Specifies whether suggestions on an object (e.g. image, table) should be automatically merged
-     * with suggestions inside the object (e.g. image caption, table cell).
-     *
-     * For example, when set to `true`, creating a table and writing some text inside the table will result in one suggestion.
-     * When set to `false`, it will be two separate suggestions, one for the inserted table and one for the inserted text.
-     *
-     * Keep in mind that only suggestions from the same author and of the same type are merged this way.
-     */
-    mergeNestedSuggestions: boolean;
-    /**
-     * A view class to be used to create suggestion thread views.
-     *
-     * {@link module:track-changes/ui/view/suggestionthreadview~SuggestionThreadView} is used by default
-     *  when this property is not set.
-     */
-    SuggestionThreadView?: typeof SuggestionThreadView;
-}
+/**
+ * @module track-changes/trackchangesconfig
+ * @publicApi
+ */
+import type SuggestionThreadView from './ui/view/suggestionthreadview';
+/**
+ * The configuration of the track changes feature.
+ *
+ * Example:
+ *
+ * ```ts
+ *		ClassicEditor
+ *			.create( {
+ *				// Track changes feature configuration.
+ *				trackChanges: {
+ *					// Do not allow users to comment suggestions (default is `false`).
+ *					disableComments: true,
+ *					// Do not track styling and formatting changes (default is `default`).
+ *					trackFormatChanges: 'never',
+ *				    // Merges suggestion changes inside a block. (default is `true`).
+ *					mergeNestedSuggestions: true
+ *				}
+ *			} )
+ *			.then( ... )
+ *			.catch( ... );
+ * ```
+ *
+ * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
+ */
+export interface TrackChangesConfig {
+    /**
+     * A property that specifies if the comments for suggestions are enabled or disabled.
+     * When the option is set to `true`, the comment thread UI for suggestions will be hidden
+     * and commenting suggestions will be disabled.
+     *
+     * Suggestion thread views will be marked with the additional `ck-suggestion--disabled-comments` class when the suggestion comments
+     * are disabled.
+     */
+    disableComments: boolean;
+    /**
+     * A property that specifies whether format changes should be tracked.
+     *
+     * Format changes are all changes other than insertions and deletions, including: styling, structure, widgets properties, etc.
+     *
+     * Possible values are:
+     *
+     * * `'always'` - all changes are going to be tracked independently (without merging).
+     * * `'default'` - format changes made inside your own insertion suggestion will be merged with it.
+     * * `'never'` - format changes will not be tracked.
+     *
+     * Defaults to `'default'`.
+     */
+    trackFormatChanges: 'never' | 'default' | 'always';
+    /**
+     * Specifies whether suggestions on an object (e.g. image, table) should be automatically merged
+     * with suggestions inside the object (e.g. image caption, table cell).
+     *
+     * For example, when set to `true`, creating a table and writing some text inside the table will result in one suggestion.
+     * When set to `false`, it will be two separate suggestions, one for the inserted table and one for the inserted text.
+     *
+     * Keep in mind that only suggestions from the same author and of the same type are merged this way.
+     */
+    mergeNestedSuggestions: boolean;
+    /**
+     * A view class to be used to create suggestion thread views.
+     *
+     * {@link module:track-changes/ui/view/suggestionthreadview~SuggestionThreadView} is used by default
+     *  when this property is not set.
+     */
+    SuggestionThreadView?: typeof SuggestionThreadView;
+}