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

package/esm2022/editor.component.mjs

@@ -72,6 +72,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>
+ * ```
  */
 export class EditorComponent {
     dialogService;
@@ -84,6 +91,7 @@ export 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);
@@ -101,7 +109,7 @@ export 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;
@@ -124,6 +132,7 @@ export class EditorComponent {
     /**
      * Sets the read-only state of the component.
      *
+     * When `true`, users cannot edit the content.
      * @default false
      */
     set readonly(value) {
@@ -163,13 +172,14 @@ export 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);
@@ -178,12 +188,12 @@ export 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) {
@@ -200,9 +210,8 @@ export 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) {
@@ -219,7 +228,8 @@ export 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) {
@@ -231,41 +241,40 @@ export 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;
@@ -315,14 +324,14 @@ export 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(this._view.state) : '';

package/esm2022/editor.module.mjs

@@ -56,21 +56,22 @@ import * as i43 from "./tools/tables/editor-split-cell-button.directive";
 import * as i44 from "@progress/kendo-angular-toolbar";
 // 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 {}
- *
  * ```
  */
 export class EditorModule {

package/esm2022/localization/custom-messages.component.mjs

@@ -8,8 +8,17 @@ import { MessagesDirective } from './messages';
 import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 /**
- * 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>
+ * ```
  */
 export class CustomMessagesComponent extends MessagesDirective {
     service;

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749820759,
-    version: '19.1.2-develop.2',
+    publishDate: 1750152829,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };

package/esm2022/preventable-events/paste-event.mjs

@@ -4,19 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from "./preventable-event";
 /**
- * The Editor [`paste`]({% slug api_editor_editorcomponent %}#toc-paste) event.
+ * Fires when the Editor [`paste`]({% slug api_editor_editorcomponent %}#toc-paste) event occurs.
  */
 export 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;
     /**

package/esm2022/tools/alignment/editor-align-center-button.directive.mjs

@@ -14,10 +14,10 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/alignment/editor-align-justify-button.directive.mjs

@@ -14,10 +14,10 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/alignment/editor-align-left-button.directive.mjs

@@ -14,10 +14,10 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/alignment/editor-align-right-button.directive.mjs

@@ -14,10 +14,10 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/blockquote/editor-blockquote-button.directive.mjs

@@ -14,9 +14,8 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/colorpicker/editor-back-color.directive.mjs

@@ -8,12 +8,11 @@ import { commandIcons, commandSVGIcons } from '../../config/command-icons';
 import * as i0 from "@angular/core";
 import * as i1 from "./editor-colorpicker.component";
 /**
- * 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>
  * ```
  */
 export class EditorBackColorDirective {

package/esm2022/tools/colorpicker/editor-colorpicker.component.mjs

@@ -18,45 +18,55 @@ import * as i1 from "../../localization/editor-localization.service";
 import * as i2 from "@progress/kendo-angular-dialog";
 import * as i3 from "../../common/provider.service";
 /**
- * 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>
+ * ```
  */
 export 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']
      */

package/esm2022/tools/colorpicker/editor-fore-color.directive.mjs

@@ -8,12 +8,11 @@ import { commandIcons, commandSVGIcons } from '../../config/command-icons';
 import * as i0 from "@angular/core";
 import * as i1 from "./editor-colorpicker.component";
 /**
- * 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>
  * ```
  */
 export class EditorForeColorDirective {

package/esm2022/tools/editor-clean-formatting-button.directive.mjs

@@ -14,9 +14,9 @@ import * as i2 from "../localization/editor-localization.service";
 import * as i3 from "../common/provider.service";
 import * as i4 from "./tools.service";
 /**
- * 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

package/esm2022/tools/fontfamily/editor-fontfamily.component.mjs

@@ -20,13 +20,12 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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>
  * ```
  */

package/esm2022/tools/fontsize/editor-fontsize.component.mjs

@@ -20,13 +20,13 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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>
  * ```
  */
@@ -40,7 +40,7 @@ export 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;

package/esm2022/tools/format/editor-format.component.mjs

@@ -20,13 +20,13 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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>
  * ```
  */
@@ -41,7 +41,7 @@ export 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;
@@ -50,7 +50,7 @@ export 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;

package/esm2022/tools/history/editor-redo-button.directive.mjs

@@ -14,10 +14,10 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/history/editor-undo-button.directive.mjs

@@ -14,10 +14,10 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/image/editor-insert-image-button.directive.mjs

@@ -14,9 +14,9 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/indentation/editor-indent-button.directive.mjs

@@ -14,10 +14,9 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/indentation/editor-outdent-button.directive.mjs

@@ -14,10 +14,9 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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

package/esm2022/tools/link/editor-create-link-button.directive.mjs

@@ -14,10 +14,9 @@ import * as i2 from "../../localization/editor-localization.service";
 import * as i3 from "../../common/provider.service";
 import * as i4 from "../tools.service";
 /**
- * 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