jodit 4.9.9 → 4.9.11

package/esm/config.d.ts

@@ -26,18 +26,112 @@ import type { IUIButtonState } from "./types/index";
 import type { IViewOptions } from "./types/index";
 import type { NodeFunction } from "./types/index";
 /**
- * Default Editor's Configuration
+ * Default Editor's Configuration.
+ *
+ * This class holds all default option values for the Jodit editor.
+ * It uses a **private constructor** and a **lazy singleton** pattern — the single instance
+ * is created on the first access to {@link Config.defaultOptions} (also available as `Jodit.defaultOptions`).
+ *
+ * ## How options are resolved
+ *
+ * When you create an editor with `Jodit.make('#editor', userOptions)`, the library
+ * calls {@link ConfigProto}(userOptions, Config.defaultOptions). `ConfigProto` does
+ * **not** deep-clone the defaults. Instead it creates a new object whose JavaScript
+ * prototype is `Config.defaultOptions`:
+ *
+ * ```
+ * userOptions  ──[[Prototype]]──►  Config.defaultOptions
+ * ```
+ *
+ * Any key present in `userOptions` shadows the default;
+ * any key **not** present falls through to `Config.defaultOptions` via the prototype chain.
+ * Nested plain objects are recursively prototyped in the same way, so partial overrides
+ * of nested options work automatically:
+ *
+ * ```js
+ * // Only override `dialogWidth`; all other `image.*` defaults are still available
+ * Jodit.make('#editor', {
+ *   image: { dialogWidth: 500 }
+ * });
+ * ```
+ *
+ * ## How plugins extend the config
+ *
+ * Each plugin adds its own defaults by assigning to `Config.prototype` and augmenting
+ * the TypeScript type with `declare module`:
+ *
+ * ```ts
+ * // 1. Type augmentation (compile-time)
+ * declare module 'jodit/config' {
+ *   interface Config {
+ *     toolbarSticky: boolean;
+ *   }
+ * }
+ *
+ * // 2. Runtime default
+ * Config.prototype.toolbarSticky = true;
+ * ```
+ *
+ * Because the constructor runs `Object.assign(this, ConfigPrototype)` (where
+ * `ConfigPrototype` is captured as `Config.prototype` after the class definition),
+ * all prototype-level values — including those added by plugins — are materialized
+ * as own properties on the singleton. This means `Config.defaultOptions` always
+ * contains every registered option as an own, enumerable property.
+ *
+ * ## Changing global defaults
+ *
+ * You can modify `Jodit.defaultOptions` **before** creating editors to change
+ * defaults globally:
+ *
+ * ```js
+ * Jodit.defaultOptions.language = 'de';
+ * Jodit.defaultOptions.theme = 'dark';
+ *
+ * // Both editors inherit the new defaults
+ * Jodit.make('#editor1');
+ * Jodit.make('#editor2');
+ * ```
+ *
+ * ## `Jodit.atom` — preventing deep merge
+ *
+ * By default, `ConfigProto` deep-merges nested plain objects and arrays.
+ * Wrap a value with `Jodit.atom(value)` to make it **atomic** — it will completely
+ * replace the default instead of being merged:
+ *
+ * ```js
+ * Jodit.make('#editor', {
+ *   controls: {
+ *     fontsize: {
+ *       // Replace the entire list rather than merging with the default one
+ *       list: Jodit.atom([8, 9, 10])
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * `Jodit.atom` calls {@link markAsAtomic}, which sets a non-enumerable
+ * `isAtom` flag on the object. `ConfigProto` checks this flag and skips
+ * recursive merging when it is present. Note: top-level arrays (depth 0)
+ * are always treated as atomic — they replace rather than merge.
+ *
+ * @see {@link ConfigProto} for the full merge algorithm
+ * @see {@link markAsAtomic} / {@link isAtom} for the atom marker implementation
  */
 declare class Config implements IViewOptions {
     private constructor();
     /**
-     * Use cache for heavy methods
+     * When enabled, the editor caches the results of expensive computations (e.g. toolbar rebuilds)
+     * to improve performance. Disable for debugging or when options change frequently at runtime.
      */
     cache: boolean;
     /**
      * Timeout of all asynchronous methods
      */
     defaultTimeout: number;
+    /**
+     * Prefix used for CSS class names and local-storage keys to avoid collisions
+     * when multiple editor instances or applications share the same page.
+     */
     namespace: string;
     /**
      * Editor loads completely without plugins. Useful when debugging your own plugin.
@@ -46,19 +140,16 @@ declare class Config implements IViewOptions {
     /**
      * Editor's width
      *
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    width: '100%',
      * })
      * ```
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    width: 600, // equivalent for '600px'
      * })
      * ```
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    width: 'auto', // autosize
@@ -69,19 +160,16 @@ declare class Config implements IViewOptions {
     /**
      * Editor's height
      *
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    height: '100%',
      * })
      * ```
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    height: 600, // equivalent for '600px'
      * })
      * ```
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    height: 'auto', // default - autosize
@@ -116,7 +204,37 @@ declare class Config implements IViewOptions {
      * ```
      */
     preset: string;
+    /**
+     * Dictionary of named configuration presets. Each key is a preset name and the value
+     * is a partial options object that will be merged into the editor config when
+     * {@link Config.preset} matches the key.
+     *
+     * ```javascript
+     * // Use a built-in preset
+     * Jodit.make('#editor', {
+     *     preset: 'inline'
+     * });
+     * ```
+     *
+     * ```javascript
+     * // Define and use a custom preset
+     * Jodit.defaultOptions.presets.myCompact = {
+     *     toolbarButtonSize: 'small',
+     *     showCharsCounter: false,
+     *     showWordsCounter: false,
+     *     showXPathInStatusbar: false
+     * };
+     *
+     * Jodit.make('#editor', {
+     *     preset: 'myCompact'
+     * });
+     * ```
+     */
     presets: IDictionary;
+    /**
+     * The Document object the editor operates within. Defaults to the current `document`.
+     * Override when the editor is created inside an iframe or a different browsing context.
+     */
     ownerDocument: Document;
     /**
      * Allows you to specify the window in which the editor will be created. Default - window
@@ -150,7 +268,9 @@ declare class Config implements IViewOptions {
      */
     shadowRoot: Nullable<ShadowRoot>;
     /**
-     * z-index For editor
+     * Base CSS `z-index` for the editor UI (toolbar, popups, dialogs).
+     * Set to a higher value when other page elements overlap the editor.
+     * `0` means no explicit z-index is applied.
      */
     zIndex: number;
     /**
@@ -180,7 +300,6 @@ declare class Config implements IViewOptions {
     /**
      * Size of icons in the toolbar (can be "small", "middle", "large")
      *
-     * @example
      * ```javascript
      * const editor = Jodit.make(".dark_editor", {
      *      toolbarButtonSize: "small"
@@ -193,12 +312,14 @@ declare class Config implements IViewOptions {
      */
     allowTabNavigation: boolean;
     /**
-     * Inline editing mode
+     * When enabled, the editor renders without its own container chrome (toolbar, borders, statusbar).
+     * The editable area becomes the element itself. Typically combined with
+     * `toolbarInline: true` so a floating toolbar appears on selection.
      */
     inline: boolean;
     /**
      * Theme (can be "dark")
-     * @example
+     *
      * ```javascript
      * const editor = Jodit.make(".dark_editor", {
      *      theme: "dark"
@@ -213,10 +334,9 @@ declare class Config implements IViewOptions {
     /**
      * Class name that can be appended to the editable area
      *
-     * @see [[Config.iframeCSSLinks]]
-     * @see [[Config.iframeStyle]]
+     * @see {@link Config.iframeCSSLinks}
+     * @see {@link Config.iframeStyle}
      *
-     * @example
      * ```javascript
      * Jodit.make('#editor', {
      *    editorClassName: 'some_my_class'
@@ -233,7 +353,7 @@ declare class Config implements IViewOptions {
     editorClassName: false | string;
     /**
      * Class name that can be appended to the main editor container
-     * @example
+     *
      * ```javascript
      * const jodit = Jodit.make('#editor', {
      *    className: 'some_my_class'
@@ -254,7 +374,7 @@ declare class Config implements IViewOptions {
     /**
      * The internal styles of the editable area. They are intended to change
      * not the appearance of the editor, but to change the appearance of the content.
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor', {
      * 		style: {
@@ -266,13 +386,14 @@ declare class Config implements IViewOptions {
      */
     style: false | IDictionary;
     /**
+     * Inline CSS styles applied to the outer editor container element.
+     * Use this to style the editor wrapper (borders, background, etc.) without affecting content.
      *
-     * @example
      * ```javascript
      * Jodit.make('#editor', {
-     * 		editorStyle: {
-     * 		 font: '12px Arial',
-     * 		 color: '#0c0c0c'
+     * 		containerStyle: {
+     * 		 border: '1px solid #ccc',
+     * 		 background: '#f9f9f9'
      * 		}
      * });
      * ```
@@ -282,7 +403,6 @@ declare class Config implements IViewOptions {
      * Dictionary of variable values in css, a complete list can be found here
      * https://github.com/xdan/jodit/blob/main/src/styles/variables.less#L25
      *
-     * @example
      * ```js
      * const editor = Jodit.make('#editor', {
      *   styleValues: {
@@ -295,9 +415,9 @@ declare class Config implements IViewOptions {
      */
     styleValues: IDictionary;
     /**
-     * After all, changes in editors for textarea will call change trigger
+     * When enabled, the editor dispatches a native `change` event on the original
+     * `<textarea>` element whenever the content changes, so standard DOM listeners work.
      *
-     * @example
      * ```javascript
      * const editor = Jodit.make('#editor');
      * document.getElementById('editor').addEventListener('change', function () {
@@ -312,7 +432,6 @@ declare class Config implements IViewOptions {
      * the page element direction. 'ltr' – Indicates a Left-To-Right text direction (like in English).
      * 'rtl' – Indicates a Right-To-Left text direction (like in Arabic).
      *
-     * @example
      * ```javascript
      * Jodit.make('.editor', {
      *    direction: 'rtl'
@@ -325,7 +444,6 @@ declare class Config implements IViewOptions {
      * (navigator.language && navigator.language.substr(0, 2)) ||
      * (navigator.browserLanguage && navigator.browserLanguage.substr(0, 2)) || 'en'
      *
-     * @example
      * ```html
      * <!-- include in you page lang file -->
      * <script src="jodit/lang/de.js"></script>
@@ -340,7 +458,6 @@ declare class Config implements IViewOptions {
     /**
      * if true all Lang.i18n(key) return `{key}`
      *
-     * @example
      * ```html
      * <script>
      * var editor = Jodit.make('.editor', {
@@ -355,7 +472,6 @@ declare class Config implements IViewOptions {
     /**
      * Collection of language pack data `{en: {'Type something': 'Type something', ...}}`
      *
-     * @example
      * ```javascript
      * const editor = Jodit.make('#editor', {
      *     language: 'ru',
@@ -393,12 +509,12 @@ declare class Config implements IViewOptions {
      */
     showTooltipDelay: number;
     /**
-     * Instead of create custop tooltip - use native title tooltips
+     * Instead of creating a custom tooltip, use the browser's native title tooltips
      */
     useNativeTooltip: boolean;
     /**
-     * Default insert method
-     * @default insert_as_html
+     * How pasted content is inserted into the editor by default.
+     * Possible values: `insert_as_html`, `insert_as_text`, `insert_only_text`, `insert_clear_html`.
      */
     defaultActionOnPaste: InsertMode;
     /**
@@ -408,7 +524,6 @@ declare class Config implements IViewOptions {
     /**
      * When this option is enabled, the editor's content will be placed in an iframe and isolated from the rest of the page.
      *
-     * @example
      * ```javascript
      * Jodit.make('#editor', {
      *    iframe: true,
@@ -421,7 +536,7 @@ declare class Config implements IViewOptions {
     /**
      * Allow editing the entire HTML document(html, head)
      * \> Works together with the iframe option.
-     * @example
+     *
      * ```js
      * const editor = Jodit.make('#editor', {
      *   iframe: true,
@@ -442,7 +557,7 @@ declare class Config implements IViewOptions {
     /**
      * Jodit.MODE_WYSIWYG The HTML editor allows you to write like MSWord,
      * Jodit.MODE_SOURCE syntax highlighting source editor
-     * @example
+     *
      * ```javascript
      * var editor = Jodit.make('#editor', {
      *     defaultMode: Jodit.MODE_SPLIT
@@ -452,12 +567,12 @@ declare class Config implements IViewOptions {
      */
     defaultMode: number;
     /**
-     * Use split mode
+     * When enabled, the editor displays both the WYSIWYG view and the source-code view side by side.
      */
     useSplitMode: boolean;
     /**
      * The colors in HEX representation to select a color for the background and for the text in colorpicker
-     * @example
+     *
      * ```javascript
      *  Jodit.make('#editor', {
      *     colors: ['#ff0000', '#00ff00', '#0000ff']
@@ -467,7 +582,7 @@ declare class Config implements IViewOptions {
     colors: IDictionary<string[]> | string[];
     /**
      * The default tab color picker
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor2', {
      *     colorPickerDefaultTab: 'color'
@@ -476,12 +591,12 @@ declare class Config implements IViewOptions {
      */
     colorPickerDefaultTab: 'background' | 'color';
     /**
-     * Image size defaults to a larger image
+     * Default width (in pixels) applied to images inserted into the editor
      */
     imageDefaultWidth: number;
     /**
      * Do not display these buttons that are on the list
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor2', {
      *     removeButtons: ['hr', 'source']
@@ -491,7 +606,7 @@ declare class Config implements IViewOptions {
     removeButtons: string[];
     /**
      * Do not init these plugins
-     * @example
+     *
      * ```typescript
      * var editor = Jodit.make('.editor', {
      *    disablePlugins: 'table,iframe'
@@ -505,7 +620,7 @@ declare class Config implements IViewOptions {
     disablePlugins: string[] | string;
     /**
      * Init and download extra plugins
-     * @example
+     *
      * ```typescript
      * var editor = Jodit.make('.editor', {
      *    extraPlugins: ['emoji']
@@ -519,7 +634,7 @@ declare class Config implements IViewOptions {
      */
     basePath?: string;
     /**
-     * These buttons list will be added to the option. Buttons
+     * Additional buttons appended to the {@link Config.buttons} list
      */
     extraButtons: Array<string | IControlType>;
     /**
@@ -527,7 +642,6 @@ declare class Config implements IViewOptions {
      * You can add your icon to the set using the `Jodit.modules.Icon.set (name, svg Code)` method.
      * But for a declarative declaration, you can use this option.
      *
-     * @example
      * ```js
      * Jodit.modules.Icon.set('someIcon', '<svg><path.../></svg>');
      * const editor = Jodit.make({
@@ -536,8 +650,9 @@ declare class Config implements IViewOptions {
      *     icon: 'someIcon'
      *   }]
      * });
+     * ```
      *
-     * @example
+     * ```js
      * const editor = Jodit.make({
      *   extraIcons: {
      *     someIcon: '<svg><path.../></svg>'
@@ -548,7 +663,7 @@ declare class Config implements IViewOptions {
      *   }]
      * });
      * ```
-     * @example
+     *
      * ```js
      * const editor = Jodit.make({
      *   extraButtons: [{
@@ -561,7 +676,7 @@ declare class Config implements IViewOptions {
     extraIcons: IDictionary<string>;
     /**
      * Default attributes for created inside editor elements
-     * @example
+     *
      * ```js
      * const editor2 = Jodit.make('#editor', {
      * 	createAttributes: {
@@ -581,7 +696,7 @@ declare class Config implements IViewOptions {
      * expect(ul.className).equals('ui-test');
      * ```
      * Or JSX in React
-     * @example
+     *
      * ```jsx
      * import React, {useState, useRef} from 'react';
      * import JoditEditor from "jodit-react";
@@ -613,7 +728,7 @@ declare class Config implements IViewOptions {
     /**
      * The list of buttons that appear in the editor's toolbar on large places (≥ options.sizeLG).
      * Note - this is not the width of the device, the width of the editor
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor', {
      *     buttons: ['bold', 'italic', 'source'],
@@ -621,7 +736,7 @@ declare class Config implements IViewOptions {
      *     buttonsXS: ['bold', 'fullsize'],
      * });
      * ```
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor2', {
      *     buttons: [{
@@ -645,7 +760,7 @@ declare class Config implements IViewOptions {
      *     }]
      * });
      * ```
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor2', {
      *     buttons: Jodit.defaultOptions.buttons.concat([{
@@ -674,7 +789,8 @@ declare class Config implements IViewOptions {
      */
     buttons: ButtonsOption;
     /**
-     * Behavior for buttons
+     * Map of toolbar button names to their control definitions (icon, tooltip, exec handler, etc.).
+     * Plugins extend this object with their own button definitions via `Config.prototype.controls`.
      */
     controls: Controls;
     /**
@@ -704,7 +820,7 @@ declare class Config implements IViewOptions {
      */
     events: IDictionary<(...args: any[]) => any>;
     /**
-     * Buttons in toolbat without SVG - only texts
+     * Buttons in toolbar without SVG - only texts
      */
     textIcons: boolean;
     /**
@@ -756,16 +872,17 @@ interface Config {
 }
 interface Config {
     /**
-     * Create helper
+     * Show a green "add paragraph" bar when the cursor hovers near the top or bottom
+     * edge of certain block elements (tables, images, iframes, etc.)
      */
     addNewLine: boolean;
     /**
-     * What kind of tags it will be impact
+     * Block-level tag names near which the "add new line" bar will appear
      */
     addNewLineTagsTriggers: HTMLTagNames[];
     /**
      * On dbl click on empty space of editor it add new P element
-     * @example
+     *
      * ```js
      * Jodit.make('#editor', {
      *   addNewLineOnDBLClick: false // disable
@@ -783,6 +900,9 @@ interface Config {
     aiAssistant: AiAssistantSettings;
 }
 interface Config {
+    /**
+     * Keyboard hotkey mappings for delete and backspace operations (character, word, sentence).
+     */
     delete: {
         hotkeys: {
             delete: string[];
@@ -837,7 +957,7 @@ interface Config {
         /**
          * The allowTags option defines which elements will remain in the
          * edited text when the editor saves. You can use this limit the returned HTML.
-         * @example
+         *
          * ```javascript
          * const jodit = new Jodit.make('#editor', {
          *    cleanHTML: {
@@ -845,7 +965,7 @@ interface Config {
          *    }
          * });
          * ```
-         * @example
+         *
          * ```javascript
          * const editor = Jodit.make('#editor', {
          *     cleanHTML: {
@@ -858,7 +978,6 @@ interface Config {
          * console.log(editor.value); //Sorry! <a href="https://xdsoft.net">Freeman</a>
          * ```
          *
-         * @example
          * ```javascript
          * const editor = Jodit.make('#editor', {
          *     cleanHTML: {
@@ -921,13 +1040,13 @@ interface Config {
 interface Config {
     /**
      * Open WYSIWYG in full screen
-     * @example
+     *
      * ```javascript
      * var editor = Jodit.make({
      *     fullsize: true // fullsize editor
      * });
      * ```
-     * @example
+     *
      * ```javascript
      * var editor = Jodit.make();
      * editor.e.fire('toggleFullSize');
@@ -945,7 +1064,6 @@ interface Config {
     /**
      * You can redefine hotkeys for some command
      *
-     * @example
      * ```js
      * const jodit = Jodit.make('#editor', {
      *  commandToHotkeys: {
@@ -961,7 +1079,6 @@ interface Config {
     /**
      * You can redefine default page
      *
-     * @example
      * ```javascript
      * Jodit.make('#editor', {
      *    iframe: true,
@@ -971,9 +1088,8 @@ interface Config {
      */
     iframeDefaultSrc: string;
     /**
-     * Base URL where the root directory for [[Config.iframe]] mode
+     * Base URL where the root directory for {@link Config.iframe} mode
      *
-     * @example
      * ```javascript
      * Jodit.make('#editor', {
      *    iframe: true,
@@ -992,7 +1108,7 @@ interface Config {
     iframeDoctype: string;
     /**
      * Custom style to be used inside the iframe to display content.
-     * @example
+     *
      * ```javascript
      * Jodit.make('#editor', {
      *    iframe: true,
@@ -1004,7 +1120,6 @@ interface Config {
     /**
      * Custom stylesheet files to be used inside the iframe to display content.
      *
-     * @example
      * ```javascript
      * Jodit.make('#editor', {
      *    iframe: true,
@@ -1027,11 +1142,18 @@ interface Config {
     iframeSandbox: string | null;
 }
 interface Config {
+    /**
+     * Options for processing images inserted into the editor (e.g. converting base64 data URIs to Blob URLs).
+     */
     imageProcessor: {
         replaceDataURIToBlobIdInView: boolean;
     };
 }
 interface Config {
+    /**
+     * Configuration for the image properties dialog (opened on double-click).
+     * Controls which editing tabs are available: src, alt, title, link, size, margins, classes, styles, etc.
+     */
     image: ImagePropertiesOptions;
 }
 interface Config {
@@ -1041,23 +1163,39 @@ interface Config {
     indentMargin: number;
 }
 interface Config {
+    /**
+     * Element-specific popup toolbars. Keys are tag names (e.g. `img`, `a`, `cells`)
+     * and values are button lists or factory functions that return them.
+     */
     popup: IDictionary<Array<IControlType | string> | ((editor: IJodit, target: HTMLElement | undefined, close: () => void) => Array<IControlType | string> | HTMLElement | string)>;
+    /**
+     * List of button names to exclude from the inline toolbar
+     */
     toolbarInlineDisabledButtons: string[];
+    /**
+     * Show an inline toolbar when the user clicks inside the editor area (e.g. near images, links)
+     */
     toolbarInline: boolean;
+    /**
+     * Show an inline toolbar when the user selects text
+     */
     toolbarInlineForSelection: boolean;
+    /**
+     * CSS selector or array of selectors for elements that should not trigger the inline toolbar
+     */
     toolbarInlineDisableFor: string | string[];
 }
 interface Config {
     /**
-     * limit words count
+     * Maximum number of words allowed in the editor. Set to `false` to disable the limit.
      */
     limitWords: false | number;
     /**
-     * limit chars count
+     * Maximum number of characters allowed in the editor. Set to `false` to disable the limit.
      */
     limitChars: false | number;
     /**
-     * limit html chars count
+     * Maximum number of characters counted from the raw HTML source. Set to `false` to disable the limit.
      */
     limitHTML: false;
 }
@@ -1217,7 +1355,7 @@ interface Config {
 interface Config {
     /**
      * Show placeholder
-     * @example
+     *
      * ```javascript
      * const editor = Jodit.make('#editor', {
      *    showPlaceholder: false
@@ -1227,7 +1365,7 @@ interface Config {
     showPlaceholder: boolean;
     /**
      * Use a placeholder from original input field, if it was set
-     * @example
+     *
      * ```javascript
      * //<textarea id="editor" placeholder="start typing text ..." cols="30" rows="10"></textarea>
      * const editor = Jodit.make('#editor', {
@@ -1238,7 +1376,7 @@ interface Config {
     useInputsPlaceholder: boolean;
     /**
      * Default placeholder
-     * @example
+     *
      * ```javascript
      * const editor = Jodit.make('#editor', {
      *    placeholder: 'start typing text ...'
@@ -1254,15 +1392,24 @@ interface Config {
     hidePoweredByJodit: boolean;
 }
 interface Config {
+    /**
+     * Allow users to resize table cells by dragging the cell borders
+     */
     tableAllowCellResize: boolean;
 }
 interface Config {
+    /**
+     * Allow the user to resize the editor horizontally by dragging the resize handle
+     */
     allowResizeX: boolean;
+    /**
+     * Allow the user to resize the editor vertically by dragging the resize handle
+     */
     allowResizeY: boolean;
 }
 interface Config {
     /**
-     * Use true frame for editing iframe size
+     * Set of HTML tag names whose elements can be resized by the user via drag handles (e.g. images, iframes, tables)
      */
     allowResizeTags: Set<HTMLTagNames>;
     resizer: {
@@ -1342,7 +1489,6 @@ interface Config {
         normalizeSelectionBeforeCutAndCopy: boolean;
         /**
          * Normalize selection after triple click
-         * @example
          *
          * `<ul><li>|test</li><li>|pop</li></ul>` will be `<ul><li>|test|</li><li>pop</li</ul>|`
          */
@@ -1350,6 +1496,9 @@ interface Config {
     };
 }
 interface Config {
+    /**
+     * Allow users to select multiple table cells by clicking and dragging
+     */
     tableAllowCellSelection: boolean;
 }
 interface Config {
@@ -1360,20 +1509,24 @@ interface Config {
     maxHeight: number | string;
 }
 interface Config {
+    /**
+     * Which source-code editor to use: `'area'` for a plain textarea, `'ace'` to load the Ace editor,
+     * or a factory function that returns a custom source editor instance.
+     */
     sourceEditor: 'area' | 'ace' | ((jodit: IJodit) => ISourceEditor);
     /**
-         * Options for [ace](https://ace.c9.io/#config) editor
-         * @example
-         * ```js
-         * Jodit.make('#editor', {
-         * 	showGutter: true,
-         * 	theme: 'ace/theme/idle_fingers',
-         * 	mode: 'ace/mode/html',
-         * 	wrap: true,
-§		 * 	highlightActiveLine: true
-         * })
-         * ```
-         */
+     * Options for [ace](https://ace.c9.io/#config) editor
+     *
+     * ```js
+     * Jodit.make('#editor', {
+     * 	showGutter: true,
+     * 	theme: 'ace/theme/idle_fingers',
+     * 	mode: 'ace/mode/html',
+     * 	wrap: true,
+     * 	highlightActiveLine: true
+     * })
+     * ```
+     */
     sourceEditorNativeOptions: {
         showGutter: boolean;
         theme: string;
@@ -1450,14 +1603,27 @@ interface Config {
     spellcheck: boolean;
 }
 interface Config {
+    /**
+     * Display a character counter in the statusbar
+     */
     showCharsCounter: boolean;
+    /**
+     * When true, count characters from the raw HTML source instead of visible text only
+     */
     countHTMLChars: boolean;
+    /**
+     * When true, include whitespace characters in the character count
+     */
     countTextSpaces: boolean;
+    /**
+     * Display a word counter in the statusbar
+     */
     showWordsCounter: boolean;
 }
 interface Config {
     /**
-     * @example
+     * Keep the toolbar visible at the top of the viewport when scrolling past the editor
+     *
      * ```javascript
      * var editor = Jodit.make('#someid', {
      *  toolbarSticky: false
@@ -1465,12 +1631,14 @@ interface Config {
      * ```
      */
     toolbarSticky: boolean;
+    /**
+     * Disable sticky toolbar on mobile devices to save screen space
+     */
     toolbarDisableStickyForMobile: boolean;
     /**
      * For example, in Joomla, the top menu bar closes Jodit toolbar when scrolling. Therefore, it is necessary to
      * move the toolbar Jodit by this amount [more](https://xdsoft.net/jodit/docs/#2.5.57)
      *
-     * @example
      * ```javascript
      * var editor = Jodit.make('#someid', {
      *  toolbarStickyOffset: 100
@@ -1480,7 +1648,13 @@ interface Config {
     toolbarStickyOffset: number;
 }
 interface Config {
+    /**
+     * Array of HTML entities or characters displayed in the special-characters picker
+     */
     specialCharacters: string[];
+    /**
+     * When true, show the special-characters picker as a toolbar popup instead of a modal dialog
+     */
     usePopupForSpecialCharacters: boolean;
 }
 interface Config {
@@ -1492,6 +1666,9 @@ interface Config {
     };
 }
 interface Config {
+    /**
+     * Options for table insertion and behavior.
+     */
     table: {
         splitBlockOnInsertTable: boolean;
         selectionCellStyle: string;
@@ -1547,5 +1724,8 @@ interface Config {
     };
 }
 interface Config {
+    /**
+     * Show the element breadcrumb path (e.g. `body > p > strong`) in the statusbar
+     */
     showXPathInStatusbar: boolean;
 }