@progress/kendo-angular-editor 19.1.2-develop.1 → 19.1.2-develop.3

package/fesm2022/progress-kendo-angular-editor.mjs

@@ -36,8 +36,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749804506,
-    version: '19.1.2-develop.1',
+    publishDate: 1750152829,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -611,20 +611,21 @@ const conditionallyExecute = (fn) => (condition) => (param) => (condition ? fn(p
 const pipe = (...fns) => x => fns.reduce((y, f) => f(y), x);
 // This re-declaration is necessary for proper API generation
 /**
- * A method for extracting the text from the current editor state's selection ([see example]({% slug plugins_editor %}#toc-popup-tools)).
+ * Extracts the text from the current editor state's selection ([see example]({% slug plugins_editor %}#toc-popup-tools)).
  *
+ * @example
  * ```ts
- * import {getSelectionText} from '@progress/kendo-angular-editor';
+ * import { getSelectionText } from '@progress/kendo-angular-editor';
  *
  * export class AppComponent {
  *     @ViewChild('editor') public editor;
- *     public onClick(){
- *         const selection = getSelectionText(this.editor.view.state)
+ *     public onClick() {
+ *         const selection = getSelectionText(this.editor.view.state);
  *     }
  * }
  * ```
- * @param state
- * @returns the selection text.
+ * @param state The current `EditorState`.
+ * @returns The selected text.
  */
 const getSelectionText = (state) => getSelectionText$1(state);
 /**
@@ -1524,7 +1525,7 @@ const EditorErrorMessages = {
     pastedContentCallbackType: (arg) => `pastedContent must be a function, but received ${JSON.stringify(arg)}.`,
     setPluginsOnce: 'The plugins cannot be changed dynamically. See https://www.telerik.com/kendo-angular-ui/components/editor/plugins/',
     setPlaceHolderOnce: 'The placeholder cannot be changed dynamically. See https://www.telerik.com/kendo-angular-ui/components/editor/plugins/#toc-custom-plugins/',
-    printTool: 'The Print tool and functionality are supported only in iframe mode. See https://www.telerik.com/kendo-angular-ui-develop/components/editor/api/EditorPrintDirective/'
+    printTool: 'The Print tool and functionality are supported only in iframe mode. See https://www.telerik.com/kendo-angular-ui/components/editor/api/EditorPrintDirective/'
 };
 
 /**
@@ -1578,19 +1579,19 @@ class PreventableEvent {
 }
 
 /**
- * The Editor [`paste`]({% slug api_editor_editorcomponent %}#toc-paste) event.
+ * Fires when the Editor [`paste`]({% slug api_editor_editorcomponent %}#toc-paste) event occurs.
  */
 class EditorPasteEvent extends PreventableEvent {
     /**
-     * The HTML content cleaned in accordance with the [`PasteCleanupSettings`]({% slug paste_cleanup %}).
+     * Contains the HTML content cleaned according to the [`PasteCleanupSettings`]({% slug paste_cleanup %}).
      */
     cleanedHtml;
     /**
-     * The raw pasted content.
+     * Contains the raw pasted content.
      */
     originalHtml;
     /**
-     * The original DOM event.
+     * Contains the original DOM event.
      */
     originalEvent;
     /**
@@ -1787,9 +1788,9 @@ class EditorCommandDialog extends EditorCommandBaseDirective {
 }
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **InsertImage** tool
+ * Configures a `ToolBarButtonComponent` as an Editor **InsertImage** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * Sets the SVG icon and `click` event handlers of the button.
  *
  * @example
  * ```html
@@ -1844,10 +1845,9 @@ class EditorCommandButton extends EditorCommandBaseDirective {
 }
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Unlink** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * Configures a ToolBarButtonComponent as an Editor **Unlink** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -1870,10 +1870,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **CreateLink** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * Configures a ToolBarButtonComponent as an Editor **CreateLink** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -1896,10 +1895,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Outdent** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * Configures a ToolBarButtonComponent as an Editor **Outdent** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -1922,10 +1920,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Indent** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * Configures a ToolBarButtonComponent as an Editor **Indent** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -1948,10 +1945,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **InsertOrderedList** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * Configures a ToolBarButtonComponent as an Editor **InsertOrderedList** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -1974,10 +1970,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **InsertUnorderedList** tool
+ * Configures a ToolBarButtonComponent as an Editor **InsertUnorderedList** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * It also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2000,10 +1996,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignJustify** tool
+ * Use this directive to turn a ToolBarButtonComponent into an Editor **AlignJustify** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * It also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2026,10 +2022,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignRight** tool
+ * Use this directive to turn a ToolBarButtonComponent into an Editor **AlignRight** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * It also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2052,10 +2048,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignCenter** tool
+ * Use this directive to turn a ToolBarButtonComponent into an Editor **AlignCenter** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * It also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2078,10 +2074,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignLeft** tool
+ * Use this directive to turn a ToolBarButtonComponent into an Editor **AlignLeft** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * It also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2399,13 +2395,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A component which configures an existing `DropDownListComponent` as an Editor tool
+ * Configures a DropDownListComponent as an Editor tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The component associates a `kendo-dropdownlist` with an Editor command that changes the format of a content block and
- * automatically defines the options of the drop-down list and sets its values ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
+ * Associates a `kendo-dropdownlist` with an Editor command that changes the format of a content block.
+ * Automatically sets the options and values of the DropDownList ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <kendo-toolbar-dropdownlist kendoEditorFormat></kendo-toolbar-dropdownlist>
  * ```
  */
@@ -2420,7 +2416,7 @@ class EditorFormatComponent extends ToolBarToolComponent {
     disabled = false;
     tabindex = -1;
     /**
-     * Overrides the default format items list.
+     * Sets the format items list. Use this property to override the default list.
      */
     set data(formatItems) {
         this._data = formatItems || this._data;
@@ -2429,7 +2425,7 @@ class EditorFormatComponent extends ToolBarToolComponent {
         return this._data;
     }
     /**
-     * Fires when the user updates the value of the drop-down list.
+     * Emits when the value of the DropDownList changes.
      */
     valueChange = new EventEmitter();
     formatDropDownList;
@@ -2655,10 +2651,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Underline** tool
+ * Configures a ToolBarButtonComponent as an Editor **Underline** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2681,10 +2677,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Italic** tool
+ * Configures a ToolBarButtonComponent as an Editor **Italic** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -2707,10 +2703,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Bold** tool
+ * Configures a ToolBarButtonComponent as an Editor **Bold** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -3141,6 +3137,13 @@ const getPasteCleanupAttributes = (config) => {
 };
 /**
  * Represents the [Kendo UI Editor component for Angular]({% slug overview_editor %}).
+ *
+ * Use the Editor to create and edit rich text content in your Angular applications.
+ *
+ * @example
+ * ```html
+ * <kendo-editor [(value)]="editorValue"></kendo-editor>
+ * ```
  */
 class EditorComponent {
     dialogService;
@@ -3153,6 +3156,7 @@ class EditorComponent {
     renderer;
     /**
      * Sets the value of the Editor ([see example](slug:overview_editor)).
+     * Use this property to update the Editor content programmatically.
      */
     set value(value) {
         this.changeValue(value);
@@ -3170,7 +3174,7 @@ class EditorComponent {
         }
     }
     /**
-     * Sets the disabled state of the component. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_editor#toc-managing-the-editor-disabled-state-in-reactive-forms).
+     * Sets the disabled state of the component. To disable the Editor in reactive forms, see [Forms Support](slug:formssupport_editor#toc-managing-the-editor-disabled-state-in-reactive-forms).
      */
     set disabled(value) {
         this._disabled = value || false;
@@ -3193,6 +3197,7 @@ class EditorComponent {
     /**
      * Sets the read-only state of the component.
      *
+     * When `true`, users cannot edit the content.
      * @default false
      */
     set readonly(value) {
@@ -3232,13 +3237,14 @@ class EditorComponent {
         return this._readonly;
     }
     /**
-     * If set to `false`, the Editor will run in style non-encapsulated mode. This means
-     * that the styles of the page will be persisted in the Editor and its content will be affected by them.
+     * If set to `false`, the Editor runs in non-encapsulated style mode.
+     * The Editor content inherits styles from the page.
      * @default true
      */
     iframe = true;
     /**
-     * Allows applying custom CSS styles to the Editor in iframe mode.
+     * Applies custom CSS styles to the Editor in iframe mode.
+     * Use this property to provide additional CSS for the Editor content.
      */
     set iframeCss(settings) {
         this._iframeCss = Object.assign(this._iframeCss, settings);
@@ -3247,12 +3253,12 @@ class EditorComponent {
         return this._iframeCss;
     }
     /**
-     * If set to `true` or `ApplyToWordOptions` object, commands that apply emphasis or inline styles will be applied to the whole word the cursor is in.
+     * When set to `true` or an `ApplyToWordOptions` object, emphasis or inline style commands apply to the whole word at the cursor.
      * @default false
      */
     applyToWord = false;
     /**
-     * Allows providing a custom schema. ([see example]({% slug schema_editor %}))
+     * Provides a custom schema for the Editor ([see example]({% slug schema_editor %})).
      */
     set schema(value) {
         if (isDevMode) {
@@ -3269,9 +3275,8 @@ class EditorComponent {
         return this._schema;
     }
     /**
-     * Defines a function which determines the plugins that will be used when initializing the Editor.
-     * It exposes the default plugins collection as an argument, and returns
-     * the plugins collection that will be used when creating the Editor component. ([see example]({% slug plugins_editor %}))
+     * Defines a function to customize the plugins used by the Editor.
+     * The function receives the default plugins and returns the plugins to use ([see example]({% slug plugins_editor %})).
      */
     set plugins(fn) {
         if (isDevMode) {
@@ -3288,7 +3293,8 @@ class EditorComponent {
         return this._plugins;
     }
     /**
-     * The hint, which is displayed when the component is empty.
+     * Sets the hint text displayed when the Editor is empty.
+     * Use this property to provide guidance to users.
      */
     set placeholder(value) {
         if (isDevMode && this._view) {
@@ -3300,41 +3306,40 @@ class EditorComponent {
         return this._placeholder;
     }
     /**
-     * By default, whitespace is collapsed as per HTML's rules.
-     * Set to `true` to preserve whitespace, but normalize newlines to spaces.
-     * Set to `'full'` to preserve whitespace entirely. In this case the default ProseMirror behavior is to parse white space into nodes.
-     *
+     * Controls whitespace handling in the Editor content.
+     * Set to `true` to preserve whitespace and normalize newlines to spaces.
+     * Set to `'full'` to preserve all whitespace.
      * @default false
      */
     preserveWhitespace = false;
     /**
-     * Configures how pasted content is modified before it is added to the Editor ([see example]({% slug paste_cleanup %})).
+     * Configures how pasted content is cleaned before it is added to the Editor ([see example]({% slug paste_cleanup %})).
+     * Use this property to remove unwanted HTML, styles, or attributes from pasted content.
      */
     pasteCleanupSettings;
     /**
      * Determines whether the Editor can be resized ([see example](slug:resizing_editor#toc-resizing-the-editor)).
+     * Set to `true` or provide an object with resizing options.
      * @default false
      */
     resizable = false;
     /**
-     * Fires each time the value of the Editor is changed upon user interaction&mdash;
-     * for example, when the value is updated through typing in the content area or using some of the Editor tools ([see example](slug:events_editor)).
-     * When the value of the Editor is programmatically changed through its API (`ngModel`) or form binding (`formControl`),
-     * the `valueChange` event is not triggered because it might cause a mix-up with the
-     * built-in `valueChange` mechanisms of the `ngModel` or `formControl` bindings.
+     * Fires when the Editor value changes due to user interaction.
+     * This event does not fire when the value changes programmatically through `ngModel` or form bindings
+     * ([see example](slug:events_editor)).
      */
     valueChange = new EventEmitter();
     /**
-     * Fires when the content area of the Editor is focused ([see example](slug:events_editor)).
+     * Fires when the Editor content area receives focus ([see example](slug:events_editor)).
      */
     onFocus = new EventEmitter();
     /**
-     * Fires when the user performs paste in the content area of the Editor ([see example](slug:events_editor)).
-     * The event is preventable. If you cancel it, the Editor content will not change.
+     * Fires when the user paste content into the Editor ([see example](slug:events_editor)).
+     * This event is preventable. If you cancel it, the Editor content does not change.
      */
     paste = new EventEmitter();
     /**
-     * Fires when the content area of the Editor is blurred ([see example](slug:events_editor)).
+     * Fires when the Editor content area is blurred ([see example](slug:events_editor)).
      */
     onBlur = new EventEmitter();
     hostClass = true;
@@ -3384,14 +3389,14 @@ class EditorComponent {
         return this.defaultToolbar || this.userToolBarElement;
     }
     /**
-     * Returns the ProseMirror [EditorView](https://prosemirror.net/docs/ref/#view.EditorView) object
-     * that manages the DOM structure that represents an editable document.
+     * Returns the ProseMirror [EditorView](https://prosemirror.net/docs/ref/#view.EditorView) object.
+     * Use this property to access the underlying `EditorView` instance.
      */
     get view() {
         return this._view;
     }
     /**
-     * Returns the text which the current Editor selection contains ([see example]({% slug selection_editor %}#toc-retrieve-the-selected-text)).
+     * Returns the text currently selected in the Editor ([see example]({% slug selection_editor %}#toc-retrieve-the-selected-text)).
      */
     get selectionText() {
         return this._view && this._view.state ? getSelectionText$1(this._view.state) : '';
@@ -4557,13 +4562,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A component which configures an existing `DropDownListComponent` as an Editor tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The component associates a `kendo-dropdownlist` with an Editor command that changes the font size of a content block and
- * automatically defines the options of the drop-down list and sets its values ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
+ * Configures a DropDownListComponent as an Editor tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * Use this component to associate a `kendo-dropdownlist` with an Editor command that changes the font size of a content block.
+ * The component automatically sets the options and values of the drop-down list.
+ * ([see example]({% slug toolbartools_editor %}#toc-dropdownlists))
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <kendo-toolbar-dropdownlist kendoEditorFontSize></kendo-toolbar-dropdownlist>
  * ```
  */
@@ -4577,7 +4582,7 @@ class EditorFontSizeComponent extends ToolBarToolComponent {
     tabindex = -1;
     /**
      * Overrides the default font size list.
-     * Numeric values are treated as pixels.
+     * Treat numeric values as pixels.
      */
     set data(sizes) {
         let normalizedSizes;
@@ -5039,13 +5044,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A component which configures an existing `DropDownListComponent` as an Editor tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The component associates a `kendo-toolbar-dropdownlist` with an Editor command that changes the font family of a content block and
- * automatically defines the options of the drop-down list and sets its values ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
+ * Configures a DropDownListComponent as an Editor tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * Use this component to associate a kendo-toolbar-dropdownlist with an Editor command that changes the font family of a content block.
+ * The component automatically sets the options and values of the drop-down list ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <kendo-toolbar-dropdownlist kendoEditorFontFamily></kendo-toolbar-dropdownlist>
  * ```
  */
@@ -5438,45 +5442,55 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A component which configures an existing ColorPickerComponent as a ToolBar tool.
- * To associate a `kendo-toolbar-colorpicker` with an Editor command that changes the
- * foreground or the background color of the text, use the `kendoEditorForeColor` or `kendoEditorBackColor` directivе ([more information]({% slug toolbartools_editor %}#toc-colorpickers)).
+ * Configures a ColorPickerComponent as a ToolBar tool.
+ * Use this component to associate a `kendo-toolbar-colorpicker` with an Editor command that changes the foreground or background color of the text.
+ * Use the `kendoEditorForeColor` or `kendoEditorBackColor` directive ([more information]({% slug toolbartools_editor %}#toc-colorpickers)).
+ *
+ * @example
+ * ```html
+ * <kendo-toolbar-colorpicker kendoEditorForeColor></kendo-toolbar-colorpicker>
+ * ```
  */
 class EditorColorPickerComponent extends ToolBarToolComponent {
     localization;
     dialogService;
     ngZone;
     renderer;
+    /**
+     * Specifies the tab index of the component.
+     *
+     * @default -1
+     */
     tabindex = -1;
     /**
      * Specifies the initial value of the color picker.
      */
     value;
     /**
-     * Specifies the Kendo UI font icon that will be used.
+     * Specifies the Kendo UI font icon that the component uses.
      */
     icon;
     /**
-     * Defines an SVGIcon to be rendered within the ColorPicker button.
-     * The input can take either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
+     * Defines an SVGIcon to render within the ColorPicker button.
+     * The input can take either an existing Kendo SVG icon or a custom one.
      */
     svgIcon;
     /**
-     * Overrides the default [color palette settings]({% slug api_inputs_palettesettings %}).
+     * Overrides the default color palette settings.
      */
     paletteSettings;
     /**
-     * Specifies the color-related command that will be executed.
+     * Specifies the color-related command that the component executes.
      */
     editorCommand;
     /**
-     * Specifies if the component should be disabled.
+     * Specifies if the component is disabled.
      *
      * @default false
      */
     disabled = false;
     /**
-     * Specifies whether the ColorPicker will render a gradient, palette, or both in its popup.
+     * Specifies whether the ColorPicker renders a gradient, palette, or both in its popup.
      *
      * @default ['palette']
      */
@@ -5968,7 +5982,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 const popupWrapperWidth = '190px';
 const popupWrapperHeight = '164px'; // Set to '192px' when TableWizard button is added;
 /**
- * A toolbar component which allows the user to create and insert a table in the Editor's content.
+ * Represents toolbar component which allows creating and insertig a table in the Editor's content.
+ *
+ * Use this toolbar component to let users create and insert a table in the Editor's content.
  *
  * @example
  * ```html
@@ -6247,9 +6263,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Blockquote** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * Configures a ToolBarButtonComponent as an Editor **Blockquote** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive predefines the SVG icon and `click` event handlers of the button.
  *
  * @example
  * ```html
@@ -6272,10 +6287,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Redo** tool
+ * Configures a ToolBarButtonComponent as an Editor **Redo** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * Sets the SVG icon and `click` event handlers of the button.
+ * Updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6298,10 +6313,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Undo** tool
+ * Configures a ToolBarButtonComponent as an Editor **Undo** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * Sets the SVG icon and `click` event handlers of the button.
+ * Updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6324,9 +6339,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **ViewSource** tool
+ * Configures a ToolBarButtonComponent as an Editor **ViewSource** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * The directive sets the SVG icon and `click` event handlers for the button.
  *
  * @example
  * ```html
@@ -6349,10 +6364,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Strikethrough** tool
+ * Configures a ToolBarButtonComponent as an Editor **Strikethrough** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6375,10 +6390,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Subscript** tool
+ * Configures a ToolBarButtonComponent as an Editor **Subscript** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6401,10 +6416,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Superscript** tool
+ * Configures a ToolBarButtonComponent as an Editor **Superscript** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
+ * This directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `selected` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6427,9 +6442,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Insert File** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * Configures a ToolBarButtonComponent as an Editor **Insert File** tool ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * The directive sets the SVG icon and `click` event handlers for the button.
  *
  * @example
  * ```html
@@ -6452,12 +6466,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an `EditorColorPickerComponent`
- * for manipulating the foreground color of the text
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * Configures an EditorColorPickerComponent for manipulating the foreground color of the text ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
  *
+ * @example
  * ```html
- * <kendo-toolbar-colorpicker kendoEditorForeColor ></kendo-toolbar-colorpicker>
+ * <kendo-toolbar-colorpicker kendoEditorForeColor></kendo-toolbar-colorpicker>
  * ```
  */
 class EditorForeColorDirective {
@@ -6480,12 +6493,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: EditorColorPickerComponent }]; } });
 
 /**
- * A directive which configures an `EditorColorPickerComponent`
- * for manipulating the background color of the text
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
+ * Configures an EditorColorPickerComponent for manipulating the background color of the text ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
  *
+ * @example
  * ```html
- * <kendo-toolbar-colorpicker kendoEditorBackColor view="gradient"> </kendo-toolbar-colorpicker>
+ * <kendo-toolbar-colorpicker kendoEditorBackColor view="gradient"></kendo-toolbar-colorpicker>
  * ```
  */
 class EditorBackColorDirective {
@@ -6508,9 +6520,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: EditorColorPickerComponent }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Clean Formatting** tool
- * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * A directive that configures a ToolBarButtonComponent as an Editor **Clean Formatting** tool.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools))
  *
  * @example
  * ```html
@@ -6533,10 +6545,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddColumnBefore** tool
+ * Configures a ToolBarButtonComponent as an Editor **AddColumnBefore** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6559,10 +6571,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddColumnAfter** tool
+ * Configures a ToolBarButtonComponent as an Editor **AddColumnAfter** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6585,10 +6597,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddRowBefore** tool
+ * Configures a ToolBarButtonComponent as an Editor **AddRowBefore** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6611,10 +6623,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddRowAfter** tool
+ * Configures a ToolBarButtonComponent as an Editor **AddRowAfter** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6637,10 +6649,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **DeleteColumn** tool
+ * Configures a ToolBarButtonComponent as an Editor **DeleteColumn** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6663,10 +6675,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **DeleteRow** tool
+ * Configures a ToolBarButtonComponent as an Editor **DeleteRow** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6689,10 +6701,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **DeleteTable** tool
+ * Configures a ToolBarButtonComponent as an Editor **DeleteTable** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive sets the SVG icon and `click` event handlers for the button.
+ * The directive also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
  * ```html
@@ -6715,8 +6727,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * Custom component messages override default component messages
+ * Use this component to override the default component messages
  * ([see example]({% slug globalization_editor %}#toc-custom-messages)).
+ * @example
+ * ```html
+ * <kendo-editor>
+ *   <kendo-editor-messages
+ *     bold="Custom Bold"
+ *    italic="Custom Italic">
+ *   </kendo-editor-messages>
+ * </kendo-editor>
+ * ```
  */
 class CustomMessagesComponent extends MessagesDirective {
     service;
@@ -6751,11 +6772,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Print** tool
+ * Configures a ToolBarButtonComponent as an Editor **Print** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * This directive sets the SVG icon and `click` event handlers for the button.
  *
- * > The Editor Print tool is supported in the default [`iframe`](slug:api_editor_editorcomponent#iframe) mode only.
+ * The Editor Print tool works only in the default [`iframe`](slug:api_editor_editorcomponent#iframe) mode.
  *
  * @example
  * ```html
@@ -6796,9 +6817,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor **SelectAll** tool
+ * Configures a ToolBarButtonComponent as an Editor **SelectAll** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the SVG icon and `click` event handlers of the button.
+ * This directive sets the SVG icon and `click` event handlers for the button.
  *
  * @example
  * ```html
@@ -6827,13 +6848,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 /**
  * @hidden
  *
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor SplitCell tool
+ * Configures an existing ToolBarButtonComponent as an Editor SplitCell tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the `icon` and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive predefines the `icon` and `click` event handlers of the button.
+ * It also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <kendo-toolbar-button kendoEditorSplitCellButton></kendo-toolbar-button>
  * ```
  */
@@ -6855,13 +6876,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 /**
  * @hidden
  *
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor MergeCells tool
+ * Configures an existing ToolBarButtonComponent as an Editor **MergeCells** tool
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
- * The directive will predefine the `icon` and `click` event handlers of the button.
- * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
+ * The directive predefines the `icon` and `click` event handlers of the button.
+ * It also updates the `disabled` state of the button based on the cursor position in the editing area.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <kendo-toolbar-button kendoEditorMergeCellsButton></kendo-toolbar-button>
  * ```
  */
@@ -6881,7 +6902,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$2.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
 
 /**
- * Utility array that contains all `Editor` related components and directives
+ * Utility array that contains all `Editor` related components and directives.
  */
 const KENDO_EDITOR = [
     EditorComponent,
@@ -6931,21 +6952,22 @@ const KENDO_EDITOR = [
 
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Editor component.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Editor component.
+ * Use this module to import the Editor and its related directives and services into your NgModule-based Angular application.
  *
- * ```ts-no-run
+ * @example
+ * ```ts
  * import { NgModule } from '@angular/core';
  * import { EditorModule } from '@progress/kendo-angular-editor';
  * import { BrowserModule } from "@angular/platform-browser";
  * import { AppComponent } from './app.component';
  *
- * _@NgModule({
+ * @NgModule({
  *     declarations: [AppComponent],
  *     imports:      [BrowserModule, EditorModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
- *
  * ```
  */
 class EditorModule {