jodit 4.9.9 → 4.9.11

package/esm/modules/file-browser/builders/utils.js

@@ -1,3 +1,8 @@
+/*!
+ * Jodit Editor (https://xdsoft.net/jodit/)
+ * Released under MIT see LICENSE.txt in the project root for license information.
+ * Copyright (c) 2013-2026 Valerii Chupurnov. All rights reserved. https://xdsoft.net
+ */
 import { Dom } from "../../../core/dom/dom.js";
 /**
  * @private

package/esm/modules/toolbar/button/button.d.ts

@@ -14,6 +14,7 @@ export declare class ToolbarButton<T extends IViewBased = IViewBased> extends UI
     readonly control: IControlTypeStrong;
     readonly target: Nullable<HTMLElement>;
     className(): string;
+    getRole(): string;
     readonly state: {
         theme: string;
         currentValue: string;

package/esm/modules/toolbar/button/button.js

@@ -38,6 +38,9 @@ let ToolbarButton = class ToolbarButton extends UIButton {
     className() {
         return 'ToolbarButton';
     }
+    getRole() {
+        return 'listitem';
+    }
     /**
      * Get parent toolbar
      */
@@ -111,7 +114,6 @@ let ToolbarButton = class ToolbarButton extends UIButton {
         const cn = this.componentName;
         const container = this.j.c.span(cn);
         const button = super.createContainer();
-        attr(container, 'role', 'listitem');
         button.classList.remove(cn);
         button.classList.add(cn + '__button');
         Object.defineProperty(button, 'component', {

package/esm/plugins/add-new-line/config.d.ts

@@ -10,16 +10,17 @@ import type { HTMLTagNames } from "../../types/index";
 declare module 'jodit/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

package/esm/plugins/backspace/config.d.ts

@@ -5,6 +5,9 @@
  */
 declare module 'jodit/config' {
     interface Config {
+        /**
+         * Keyboard hotkey mappings for delete and backspace operations (character, word, sentence).
+         */
         delete: {
             hotkeys: {
                 delete: string[];

package/esm/plugins/clean-html/config.d.ts

@@ -51,7 +51,7 @@ declare module 'jodit/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: {
@@ -59,7 +59,7 @@ declare module 'jodit/config' {
              *    }
              * });
              * ```
-             * @example
+             *
              * ```javascript
              * const editor = Jodit.make('#editor', {
              *     cleanHTML: {
@@ -72,7 +72,6 @@ declare module 'jodit/config' {
              * console.log(editor.value); //Sorry! <a href="https://xdsoft.net">Freeman</a>
              * ```
              *
-             * @example
              * ```javascript
              * const editor = Jodit.make('#editor', {
              *     cleanHTML: {

package/esm/plugins/fullsize/config.d.ts

@@ -7,13 +7,13 @@ declare module 'jodit/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');

package/esm/plugins/hotkeys/config.d.ts

@@ -12,7 +12,6 @@ declare module 'jodit/config' {
         /**
          * You can redefine hotkeys for some command
          *
-         * @example
          * ```js
          * const jodit = Jodit.make('#editor', {
          *  commandToHotkeys: {

package/esm/plugins/iframe/config.d.ts

@@ -8,7 +8,6 @@ declare module 'jodit/config' {
         /**
          * You can redefine default page
          *
-         * @example
          * ```javascript
          * Jodit.make('#editor', {
          *    iframe: true,
@@ -18,9 +17,8 @@ declare module 'jodit/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,
@@ -39,7 +37,7 @@ declare module 'jodit/config' {
         iframeDoctype: string;
         /**
          * Custom style to be used inside the iframe to display content.
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor', {
          *    iframe: true,
@@ -51,7 +49,6 @@ declare module 'jodit/config' {
         /**
          * Custom stylesheet files to be used inside the iframe to display content.
          *
-         * @example
          * ```javascript
          * Jodit.make('#editor', {
          *    iframe: true,

package/esm/plugins/image-processor/config.d.ts

@@ -8,6 +8,9 @@
  */
 declare module 'jodit/config' {
     interface Config {
+        /**
+         * Options for processing images inserted into the editor (e.g. converting base64 data URIs to Blob URLs).
+         */
         imageProcessor: {
             replaceDataURIToBlobIdInView: boolean;
         };

package/esm/plugins/image-properties/config.d.ts

@@ -9,6 +9,10 @@
 import type { ImagePropertiesOptions } from "./interface";
 declare module 'jodit/config' {
     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;
     }
 }

package/esm/plugins/inline-popup/config/config.d.ts

@@ -9,10 +9,26 @@
 import type { IControlType, IDictionary, IJodit } from "../../../types/index";
 declare module 'jodit/config' {
     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[];
     }
 }

package/esm/plugins/limit/config.d.ts

@@ -6,15 +6,15 @@
 declare module 'jodit/config' {
     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;
     }

package/esm/plugins/placeholder/config.d.ts

@@ -10,7 +10,7 @@ declare module 'jodit/config' {
     interface Config {
         /**
          * Show placeholder
-         * @example
+         *
          * ```javascript
          * const editor = Jodit.make('#editor', {
          *    showPlaceholder: false
@@ -20,7 +20,7 @@ declare module 'jodit/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', {
@@ -31,7 +31,7 @@ declare module 'jodit/config' {
         useInputsPlaceholder: boolean;
         /**
          * Default placeholder
-         * @example
+         *
          * ```javascript
          * const editor = Jodit.make('#editor', {
          *    placeholder: 'start typing text ...'

package/esm/plugins/resize-cells/config.d.ts

@@ -5,6 +5,9 @@
  */
 declare module 'jodit/config' {
     interface Config {
+        /**
+         * Allow users to resize table cells by dragging the cell borders
+         */
         tableAllowCellResize: boolean;
     }
 }

package/esm/plugins/resize-handler/config.d.ts

@@ -5,7 +5,13 @@
  */
 declare module 'jodit/config' {
     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;
     }
 }

package/esm/plugins/resizer/config.d.ts

@@ -10,7 +10,7 @@ import type { HTMLTagNames } from "../../types/index";
 declare module 'jodit/config' {
     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: {

package/esm/plugins/select/config.d.ts

@@ -17,7 +17,6 @@ declare module 'jodit/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>|`
              */

package/esm/plugins/select-cells/config.d.ts

@@ -5,6 +5,9 @@
  */
 declare module 'jodit/config' {
     interface Config {
+        /**
+         * Allow users to select multiple table cells by clicking and dragging
+         */
         tableAllowCellSelection: boolean;
     }
 }

package/esm/plugins/size/config.js

@@ -12,13 +12,12 @@ Config.prototype.maxWidth = '100%';
 /**
  * Editor's min-height
  *
- * @example
  * ```javascript
  * Jodit.make('.editor', {
  *    minHeight: '30%' //min-height: 30%
  * })
  * ```
- * @example
+ *
  * ```javascript
  * Jodit.make('.editor', {
  *    minHeight: 200 //min-height: 200px

package/esm/plugins/source/config.d.ts

@@ -9,17 +9,21 @@
 import type { IJodit, ISourceEditor } from "../../types/index";
 declare module 'jodit/config' {
     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
+         * 	highlightActiveLine: true
          * })
          * ```
          */

package/esm/plugins/stat/config.d.ts

@@ -5,9 +5,21 @@
  */
 declare module 'jodit/config' {
     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;
     }
 }

package/esm/plugins/sticky/config.d.ts

@@ -6,7 +6,8 @@
 declare module 'jodit/config' {
     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
@@ -14,12 +15,14 @@ declare module 'jodit/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

package/esm/plugins/symbols/config.d.ts

@@ -5,7 +5,13 @@
  */
 declare module 'jodit/config' {
     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;
     }
 }

package/esm/plugins/table/config.d.ts

@@ -5,6 +5,9 @@
  */
 declare module 'jodit/config' {
     interface Config {
+        /**
+         * Options for table insertion and behavior.
+         */
         table: {
             splitBlockOnInsertTable: boolean;
             selectionCellStyle: string;

package/esm/plugins/xpath/config.d.ts

@@ -5,6 +5,9 @@
  */
 declare module 'jodit/config' {
     interface Config {
+        /**
+         * Show the element breadcrumb path (e.g. `body > p > strong`) in the statusbar
+         */
         showXPathInStatusbar: boolean;
     }
 }

package/esm/types/ui.d.ts

@@ -15,6 +15,7 @@ export interface IUIElement extends IViewComponent, IContainer, IDestructible, I
     parentElement: Nullable<IUIElement>;
     container: HTMLElement;
     name: string;
+    getRole(): string;
     /**
      * Apply callback for all parents
      */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jodit",
-	"version": "4.9.9",
+	"version": "4.9.11",
 	"description": "Jodit is an awesome and useful wysiwyg editor with filebrowser",
 	"main": "esm/index.js",
 	"types": "types/index.d.ts",