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

package/localization/custom-messages.component.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-editor",
-  "version": "19.1.2-develop.2",
+  "version": "19.1.2-develop.3",
   "description": "Kendo UI Editor for Angular",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -17,7 +17,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749820759,
+      "publishDate": 1750152829,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -29,23 +29,23 @@
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-drawing": "^1.21.0",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.1.2-develop.2",
-    "@progress/kendo-angular-common": "19.1.2-develop.2",
-    "@progress/kendo-angular-dialog": "19.1.2-develop.2",
-    "@progress/kendo-angular-dropdowns": "19.1.2-develop.2",
-    "@progress/kendo-angular-inputs": "19.1.2-develop.2",
-    "@progress/kendo-angular-intl": "19.1.2-develop.2",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.2",
-    "@progress/kendo-angular-label": "19.1.2-develop.2",
-    "@progress/kendo-angular-layout": "19.1.2-develop.2",
-    "@progress/kendo-angular-icons": "19.1.2-develop.2",
-    "@progress/kendo-angular-popup": "19.1.2-develop.2",
-    "@progress/kendo-angular-toolbar": "19.1.2-develop.2",
+    "@progress/kendo-angular-buttons": "19.1.2-develop.3",
+    "@progress/kendo-angular-common": "19.1.2-develop.3",
+    "@progress/kendo-angular-dialog": "19.1.2-develop.3",
+    "@progress/kendo-angular-dropdowns": "19.1.2-develop.3",
+    "@progress/kendo-angular-inputs": "19.1.2-develop.3",
+    "@progress/kendo-angular-intl": "19.1.2-develop.3",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.3",
+    "@progress/kendo-angular-label": "19.1.2-develop.3",
+    "@progress/kendo-angular-layout": "19.1.2-develop.3",
+    "@progress/kendo-angular-icons": "19.1.2-develop.3",
+    "@progress/kendo-angular-popup": "19.1.2-develop.3",
+    "@progress/kendo-angular-toolbar": "19.1.2-develop.3",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.2-develop.2",
+    "@progress/kendo-angular-schematics": "19.1.2-develop.3",
     "@progress/kendo-editor-common": "1.12.3"
   },
   "schematics": "./schematics/collection.json",

package/preventable-events/paste-event.d.ts

@@ -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 declare 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: string;
     /**
-     * The raw pasted content.
+     * Contains the raw pasted content.
      */
     originalHtml: string;
     /**
-     * The original DOM event.
+     * Contains the original DOM event.
      */
     originalEvent: ClipboardEvent;
     /**

package/schematics/ngAdd/index.js

@@ -4,12 +4,12 @@ const schematics_1 = require("@angular-devkit/schematics");
 function default_1(options) {
     const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'EditorModule', package: 'editor', peerDependencies: {
             // peer dependencies of kendo-angular-dropdowns
-            '@progress/kendo-angular-navigation': '19.1.2-develop.2',
-            '@progress/kendo-angular-treeview': '19.1.2-develop.2',
+            '@progress/kendo-angular-navigation': '19.1.2-develop.3',
+            '@progress/kendo-angular-treeview': '19.1.2-develop.3',
             // peer dependency of kendo-angular-layout
-            '@progress/kendo-angular-progressbar': '19.1.2-develop.2',
+            '@progress/kendo-angular-progressbar': '19.1.2-develop.3',
             // peer dependency of kendo-angular-inputs
-            '@progress/kendo-angular-dialog': '19.1.2-develop.2',
+            '@progress/kendo-angular-dialog': '19.1.2-develop.3',
             // Peer dependency of icons
             '@progress/kendo-svg-icons': '^4.0.0'
         } });

package/tools/alignment/editor-align-center-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/alignment/editor-align-justify-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/alignment/editor-align-left-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/alignment/editor-align-right-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/blockquote/editor-blockquote-button.directive.d.ts

@@ -9,9 +9,8 @@ import { EditorToolsService } from '../tools.service';
 import { ProviderService } from '../../common/provider.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/colorpicker/editor-back-color.directive.d.ts

@@ -5,12 +5,11 @@
 import { EditorColorPickerComponent } from './editor-colorpicker.component';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class EditorBackColorDirective {

package/tools/colorpicker/editor-colorpicker.component.d.ts

@@ -11,45 +11,55 @@ import { EditorLocalizationService } from '../../localization/editor-localizatio
 import { ProviderService } from '../../common/provider.service';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class EditorColorPickerComponent extends ToolBarToolComponent {
     private localization;
     private dialogService;
     private ngZone;
     private renderer;
+    /**
+     * Specifies the tab index of the component.
+     *
+     * @default -1
+     */
     tabindex: number;
     /**
      * Specifies the initial value of the color picker.
      */
     value: string;
     /**
-     * Specifies the Kendo UI font icon that will be used.
+     * Specifies the Kendo UI font icon that the component uses.
      */
     icon: string;
     /**
-     * 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: SVGIcon;
     /**
-     * Overrides the default [color palette settings]({% slug api_inputs_palettesettings %}).
+     * Overrides the default color palette settings.
      */
     paletteSettings: PaletteSettings;
     /**
-     * Specifies the color-related command that will be executed.
+     * Specifies the color-related command that the component executes.
      */
     editorCommand: 'foreColor' | 'backColor';
     /**
-     * Specifies if the component should be disabled.
+     * Specifies if the component is disabled.
      *
      * @default false
      */
     disabled: boolean;
     /**
-     * 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/tools/colorpicker/editor-fore-color.directive.d.ts

@@ -5,12 +5,11 @@
 import { EditorColorPickerComponent } from './editor-colorpicker.component';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class EditorForeColorDirective {

package/tools/editor-clean-formatting-button.directive.d.ts

@@ -9,9 +9,9 @@ import { ProviderService } from '../common/provider.service';
 import { EditorToolsService } from './tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/fontfamily/editor-fontfamily.component.d.ts

@@ -13,13 +13,12 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/fontsize/editor-fontsize.component.d.ts

@@ -14,13 +14,13 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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>
  * ```
  */
@@ -34,7 +34,7 @@ export declare class EditorFontSizeComponent extends ToolBarToolComponent {
     tabindex: number;
     /**
      * Overrides the default font size list.
-     * Numeric values are treated as pixels.
+     * Treat numeric values as pixels.
      */
     set data(sizes: FontSizeItem[]);
     get data(): FontSizeItem[];

package/tools/format/editor-format.component.d.ts

@@ -14,13 +14,13 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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>
  * ```
  */
@@ -35,12 +35,12 @@ export declare class EditorFormatComponent extends ToolBarToolComponent {
     disabled: boolean;
     tabindex: number;
     /**
-     * Overrides the default format items list.
+     * Sets the format items list. Use this property to override the default list.
      */
     set data(formatItems: FormatItem[]);
     get data(): FormatItem[];
     /**
-     * Fires when the user updates the value of the drop-down list.
+     * Emits when the value of the DropDownList changes.
      */
     valueChange: EventEmitter<FormatItem>;
     formatDropDownList: FormatDropDownListComponent;

package/tools/history/editor-redo-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/history/editor-undo-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/image/editor-insert-image-button.directive.d.ts

@@ -9,9 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/indentation/editor-indent-button.directive.d.ts

@@ -9,10 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/indentation/editor-outdent-button.directive.d.ts

@@ -9,10 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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/tools/link/editor-create-link-button.directive.d.ts

@@ -9,10 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/link/editor-insert-file-button.directive.d.ts

@@ -9,9 +9,8 @@ import { ProviderService } from "../../common/provider.service";
 import { EditorToolsService } from "../tools.service";
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/link/editor-unlink-button.directive.d.ts

@@ -9,10 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/list/editor-insert-ordered-list-button.directive.d.ts

@@ -9,10 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/list/editor-insert-unordered-list-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/print/editor-print-button.directive.d.ts

@@ -9,11 +9,11 @@ import { EditorToolsService } from '../tools.service';
 import { ProviderService } from '../../common/provider.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/select-all/select-all-button.directive.d.ts

@@ -9,9 +9,9 @@ import { EditorToolsService } from '../tools.service';
 import { ProviderService } from '../../common/provider.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/source/editor-view-source-button.directive.d.ts

@@ -9,9 +9,9 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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

package/tools/tables/editor-add-column-after-button.directive.d.ts

@@ -9,10 +9,10 @@ import { ProviderService } from '../../common/provider.service';
 import { EditorToolsService } from '../tools.service';
 import * as i0 from "@angular/core";
 /**
- * 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