jodit 4.2.50 → 4.3.2

package/es5/plugins/debug/debug.css

@@ -1,7 +1,7 @@
 /*!
  * jodit - Jodit is an awesome and useful wysiwyg editor with filebrowser
  * Author: Chupurnov <chupurnov@gmail.com> (https://xdsoft.net/jodit/)
- * Version: v4.2.50
+ * Version: v4.3.2
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/debug/debug.js

@@ -1,7 +1,7 @@
 /*!
  * jodit - Jodit is an awesome and useful wysiwyg editor with filebrowser
  * Author: Chupurnov <chupurnov@gmail.com> (https://xdsoft.net/jodit/)
- * Version: v4.2.50
+ * Version: v4.3.2
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/debug/debug.min.js

@@ -1,7 +1,7 @@
 /*!
  * jodit - Jodit is an awesome and useful wysiwyg editor with filebrowser
  * Author: Chupurnov <chupurnov@gmail.com> (https://xdsoft.net/jodit/)
- * Version: v4.2.50
+ * Version: v4.3.2
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/speech-recognize/speech-recognize.css

@@ -1,7 +1,7 @@
 /*!
  * jodit - Jodit is an awesome and useful wysiwyg editor with filebrowser
  * Author: Chupurnov <chupurnov@gmail.com> (https://xdsoft.net/jodit/)
- * Version: v4.2.50
+ * Version: v4.3.2
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/speech-recognize/speech-recognize.js

@@ -1,7 +1,7 @@
 /*!
  * jodit - Jodit is an awesome and useful wysiwyg editor with filebrowser
  * Author: Chupurnov <chupurnov@gmail.com> (https://xdsoft.net/jodit/)
- * Version: v4.2.50
+ * Version: v4.3.2
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/speech-recognize/speech-recognize.min.js

@@ -1,7 +1,7 @@
 /*!
  * jodit - Jodit is an awesome and useful wysiwyg editor with filebrowser
  * Author: Chupurnov <chupurnov@gmail.com> (https://xdsoft.net/jodit/)
- * Version: v4.2.50
+ * Version: v4.3.2
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/esm/config.d.ts

@@ -686,6 +686,10 @@ declare class Config implements IViewOptions {
      * Buttons in toolbat without SVG - only texts
      */
     textIcons: boolean;
+    /**
+     * Element for dialog container
+     */
+    popupRoot: Nullable<HTMLElement>;
     /**
      * shows a INPUT[type=color] to open the browser color picker, on the right bottom of widget color picker
      */

package/esm/config.js

@@ -880,6 +880,10 @@ class Config {
          * Buttons in toolbat without SVG - only texts
          */
         this.textIcons = false;
+        /**
+         * Element for dialog container
+         */
+        this.popupRoot = null;
         /**
          * shows a INPUT[type=color] to open the browser color picker, on the right bottom of widget color picker
          */

package/esm/core/async/index.d.ts

@@ -6,4 +6,4 @@
 /**
  * @module async
  */
-export * from "./async";
+export * from "./async.d.ts";

package/esm/core/component/index.d.ts

@@ -6,6 +6,6 @@
 /**
  * @module component
  */
-export * from "./component";
-export * from "./statuses";
-export * from "./view-component";
+export * from "./component.d.ts";
+export * from "./statuses.d.ts";
+export * from "./view-component.d.ts";

package/esm/core/component/view-component.d.ts

@@ -7,7 +7,7 @@
  * @module component
  */
 import type { IViewBased, IViewComponent } from "../../types";
-import { Component } from "./component";
+import { Component } from "./component.d.ts";
 export declare abstract class ViewComponent<T extends IViewBased = IViewBased> extends Component implements IViewComponent<T> {
     /**
      * Parent View element

package/esm/core/constants.js

@@ -3,7 +3,7 @@
  * Released under MIT see LICENSE.txt in the project root for license information.
  * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
-export const APP_VERSION = "4.2.50";
+export const APP_VERSION = "4.3.2";
 // prettier-ignore
 export const ES = "es2020";
 export const IS_ES_MODERN = true;

package/esm/core/create/index.d.ts

@@ -6,4 +6,4 @@
 /**
  * @module create
  */
-export * from "./create";
+export * from "./create.d.ts";

package/esm/core/decorators/cache/cache.d.ts

@@ -12,6 +12,106 @@ import type { IDictionary, Nullable } from "../../../types";
 export interface CachePropertyDescriptor<T, R> extends PropertyDescriptor {
     get?: (this: T) => R;
 }
+/**
+ * Retrieves a cached property value from an object if it exists; otherwise, returns `null`.
+ *
+ * This utility is particularly useful when working with properties that are lazily initialized
+ * or dynamically created, such as getters or cached computations. It ensures you can safely
+ * access the value without triggering initialization or creating a new instance.
+ *
+ * ### Usage Example:
+ * ```typescript
+ * import type { IUIElement } from "jodit";
+ *
+ * const { component, cache, cached } = Jodit.decorators;
+ * const { UIElement } = Jodit.modules;
+ *
+ * @component
+ * class SomeComponent extends UIElement {
+ *   @cache
+ *   get someElement(): IUIElement {
+ *     return new UIElement(this.jodit);
+ *   }
+ *
+ *   destruct() {
+ *     // Use the cached utility to clean up only if the property is initialized
+ *     cached(this, 'someElement')?.destruct();
+ *     super.destruct();
+ *   }
+ * }
+ * ```
+ *
+ * @param object - The object containing the property to check.
+ * @param property - The name of the property to retrieve from the cache.
+ * @returns The cached value of the property if it exists; otherwise, `null`.
+ *
+ * ### Notes:
+ * - If the property is defined as a getter, the function will return `null`
+ *   instead of invoking the getter.
+ * - This function is non-destructive and does not alter the object's state.
+ */
 export declare function cached<T>(object: object, property: string): Nullable<T>;
+/**
+ * A decorator that caches the result of a getter method. Once the getter is accessed for the first time,
+ * its computed value is stored as a property of the object. Subsequent accesses return the cached value
+ * without recalculating it, improving performance and avoiding redundant computations.
+ *
+ * ### Key Features:
+ * - **Lazy Initialization**: The original getter is invoked only once, the first time the property is accessed.
+ * - **Immutability**: After caching, the value is stored as a non-writable, non-configurable property, preventing accidental modifications.
+ * - **Conditional Caching**: If the returned value has a property `noCache` set to `true`, the caching mechanism is bypassed, and the getter is invoked each time.
+ *
+ * ### Usage Example 1: Basic Caching
+ * ```typescript
+ * import { cache } from './decorators';
+ *
+ * class Example {
+ *   private counter = 0;
+ *
+ *   @cache
+ *   get expensiveComputation(): number {
+ *     console.log('Calculating...');
+ *     return ++this.counter;
+ *   }
+ * }
+ *
+ * const instance = new Example();
+ * console.log(instance.expensiveComputation); // Logs "Calculating..." and returns 1
+ * console.log(instance.expensiveComputation); // Returns 1 (cached value, no calculation)
+ * ```
+ *
+ * ### Usage Example 2: Integration with Cached Utilities
+ * ```typescript
+ * import { cache, cached } from './decorators';
+ * import type { IUIElement } from "jodit";
+ *
+ * const { component } = Jodit.decorators;
+ * const { UIElement } = Jodit.modules;
+ *
+ * @component
+ * class SomeComponent extends UIElement {
+ *   @cache
+ *   get someElement(): IUIElement {
+ *     return new UIElement(this.jodit);
+ *   }
+ *
+ *   destruct() {
+ *     // Use the cached utility to clean up only if the property is initialized
+ *     cached(this, 'someElement')?.destruct();
+ *     super.destruct();
+ *   }
+ * }
+ * ```
+ *
+ * @param _ - The target object (not used directly).
+ * @param name - The name of the property to decorate.
+ * @param descriptor - The property descriptor, which must include a getter method.
+ * @throws Will throw an error if the descriptor does not include a getter.
+ *
+ * ### Notes:
+ * - **Performance**: Ideal for properties that are computationally expensive and do not change after the initial computation.
+ * - **Flexibility**: Supports conditional caching via the `noCache` property in the returned value.
+ * - **Compatibility**: Designed to work seamlessly with objects and classes in TypeScript or JavaScript.
+ */
 export declare function cache<T, R>(_: object, name: PropertyKey, descriptor: CachePropertyDescriptor<T, R>): void;
 export declare function cacheHTML<T extends Function, R>(target: IDictionary, _: string, descriptor: CachePropertyDescriptor<T, R>): void;

package/esm/core/decorators/cache/cache.js

@@ -4,9 +4,48 @@
  * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 import { STATUSES } from "../../component/statuses.js";
+import { IS_PROD } from "../../constants.js";
 import { Dom } from "../../dom/dom.js";
 import { isFunction, isViewObject } from "../../helpers/checker/index.js";
 import { error } from "../../helpers/utils/error/error.js";
+/**
+ * Retrieves a cached property value from an object if it exists; otherwise, returns `null`.
+ *
+ * This utility is particularly useful when working with properties that are lazily initialized
+ * or dynamically created, such as getters or cached computations. It ensures you can safely
+ * access the value without triggering initialization or creating a new instance.
+ *
+ * ### Usage Example:
+ * ```typescript
+ * import type { IUIElement } from "jodit";
+ *
+ * const { component, cache, cached } = Jodit.decorators;
+ * const { UIElement } = Jodit.modules;
+ *
+ * @component
+ * class SomeComponent extends UIElement {
+ *   @cache
+ *   get someElement(): IUIElement {
+ *     return new UIElement(this.jodit);
+ *   }
+ *
+ *   destruct() {
+ *     // Use the cached utility to clean up only if the property is initialized
+ *     cached(this, 'someElement')?.destruct();
+ *     super.destruct();
+ *   }
+ * }
+ * ```
+ *
+ * @param object - The object containing the property to check.
+ * @param property - The name of the property to retrieve from the cache.
+ * @returns The cached value of the property if it exists; otherwise, `null`.
+ *
+ * ### Notes:
+ * - If the property is defined as a getter, the function will return `null`
+ *   instead of invoking the getter.
+ * - This function is non-destructive and does not alter the object's state.
+ */
 export function cached(object, property) {
     const descriptor = Object.getOwnPropertyDescriptor(object, property);
     if (!descriptor || isFunction(descriptor.get)) {
@@ -14,12 +53,79 @@ export function cached(object, property) {
     }
     return descriptor.value;
 }
+/**
+ * A decorator that caches the result of a getter method. Once the getter is accessed for the first time,
+ * its computed value is stored as a property of the object. Subsequent accesses return the cached value
+ * without recalculating it, improving performance and avoiding redundant computations.
+ *
+ * ### Key Features:
+ * - **Lazy Initialization**: The original getter is invoked only once, the first time the property is accessed.
+ * - **Immutability**: After caching, the value is stored as a non-writable, non-configurable property, preventing accidental modifications.
+ * - **Conditional Caching**: If the returned value has a property `noCache` set to `true`, the caching mechanism is bypassed, and the getter is invoked each time.
+ *
+ * ### Usage Example 1: Basic Caching
+ * ```typescript
+ * import { cache } from './decorators';
+ *
+ * class Example {
+ *   private counter = 0;
+ *
+ *   @cache
+ *   get expensiveComputation(): number {
+ *     console.log('Calculating...');
+ *     return ++this.counter;
+ *   }
+ * }
+ *
+ * const instance = new Example();
+ * console.log(instance.expensiveComputation); // Logs "Calculating..." and returns 1
+ * console.log(instance.expensiveComputation); // Returns 1 (cached value, no calculation)
+ * ```
+ *
+ * ### Usage Example 2: Integration with Cached Utilities
+ * ```typescript
+ * import { cache, cached } from './decorators';
+ * import type { IUIElement } from "jodit";
+ *
+ * const { component } = Jodit.decorators;
+ * const { UIElement } = Jodit.modules;
+ *
+ * @component
+ * class SomeComponent extends UIElement {
+ *   @cache
+ *   get someElement(): IUIElement {
+ *     return new UIElement(this.jodit);
+ *   }
+ *
+ *   destruct() {
+ *     // Use the cached utility to clean up only if the property is initialized
+ *     cached(this, 'someElement')?.destruct();
+ *     super.destruct();
+ *   }
+ * }
+ * ```
+ *
+ * @param _ - The target object (not used directly).
+ * @param name - The name of the property to decorate.
+ * @param descriptor - The property descriptor, which must include a getter method.
+ * @throws Will throw an error if the descriptor does not include a getter.
+ *
+ * ### Notes:
+ * - **Performance**: Ideal for properties that are computationally expensive and do not change after the initial computation.
+ * - **Flexibility**: Supports conditional caching via the `noCache` property in the returned value.
+ * - **Compatibility**: Designed to work seamlessly with objects and classes in TypeScript or JavaScript.
+ */
 export function cache(_, name, descriptor) {
     const getter = descriptor.get;
     if (!getter) {
         throw error('Getter property descriptor expected');
     }
     descriptor.get = function () {
+        if (!IS_PROD) {
+            if (this.isInDestruct) {
+                console.error('Trying to access property in destructed component');
+            }
+        }
         const value = getter.call(this);
         if (value && value.noCache === true) {
             return value;

package/esm/core/decorators/index.d.ts

@@ -8,14 +8,14 @@
  * @packageDocumentation
  * @module decorators
  */
-export * from "./autobind/autobind";
-export * from "./cache/cache";
-export * from "./component/component";
-export * from "./debounce/debounce";
-export * from "./derive/derive";
-export * from "./hook/hook";
-export * from "./idle/idle";
-export * from "./nonenumerable/nonenumerable";
-export * from "./persistent/persistent";
-export * from "./wait/wait";
-export * from "./watch/watch";
+export * from "./autobind/autobind.d.ts";
+export * from "./cache/cache.d.ts";
+export * from "./component/component.d.ts";
+export * from "./debounce/debounce.d.ts";
+export * from "./derive/derive.d.ts";
+export * from "./hook/hook.d.ts";
+export * from "./idle/idle.d.ts";
+export * from "./nonenumerable/nonenumerable.d.ts";
+export * from "./persistent/persistent.d.ts";
+export * from "./wait/wait.d.ts";
+export * from "./watch/watch.d.ts";

package/esm/core/dom/index.d.ts

@@ -6,5 +6,5 @@
 /**
  * @module dom
  */
-export * from "./dom";
-export * from "./lazy-walker";
+export * from "./dom.d.ts";
+export * from "./lazy-walker.d.ts";

package/esm/core/dom/lazy-walker.d.ts

@@ -7,7 +7,7 @@
  * @module dom
  */
 import type { IAsync, IDestructible } from "../../types";
-import { Eventify } from "../event-emitter/eventify";
+import { Eventify } from "../event-emitter/eventify.d.ts";
 export declare class LazyWalker extends Eventify<{
     visit: (node: Node) => boolean;
     break: (reason?: string) => void;

package/esm/core/event-emitter/index.d.ts

@@ -6,7 +6,7 @@
 /**
  * @module event-emitter
  */
-export * from "./event-emitter";
-export * from "./eventify";
-export * from "./observable";
-export * from "./store";
+export * from "./event-emitter.d.ts";
+export * from "./eventify.d.ts";
+export * from "./observable.d.ts";
+export * from "./store.d.ts";

package/esm/core/global.d.ts

@@ -6,8 +6,8 @@
 /**
  * @module global
  */
-import type { HTMLTagNames, IDictionary, IJodit, IViewBased, IViewComponent } from "../types";
-import { PluginSystem } from "./plugin/plugin-system";
+import type { HTMLTagNames, IDictionary, IJodit, IViewBased, IViewComponent, IViewOptions } from "../types";
+import { PluginSystem } from "./plugin/plugin-system.d.ts";
 import { EventEmitter } from "./event-emitter";
 export declare const instances: IDictionary<IJodit>;
 /**
@@ -21,6 +21,11 @@ export declare const extendLang: (langs: IDictionary) => void;
  * Create unique box(HTMLCotainer) and remove it after destroy
  */
 export declare function getContainer<T extends HTMLTagNames = HTMLTagNames>(jodit: IViewBased | IViewComponent, classFunc?: Function | string, tag?: T, createInsideEditor?: boolean): HTMLElementTagNameMap[T];
+/**
+ * Get root element for view
+ * @internal
+ */
+export declare function getPopupViewRoot(o: IViewOptions, container: HTMLElement, defaultRoot: HTMLElement): HTMLElement;
 /**
  * Global event emitter
  */

package/esm/core/global.js

@@ -3,6 +3,7 @@
  * Released under MIT see LICENSE.txt in the project root for license information.
  * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
+import { css } from "./helpers/index.js";
 import { isJoditObject } from "./helpers/checker/is-jodit-object.js";
 import { isString } from "./helpers/checker/is-string.js";
 import { isViewObject } from "./helpers/checker/is-view-object.js";
@@ -54,21 +55,10 @@ export function getContainer(jodit, classFunc, tag = 'div', createInsideEditor =
             : 'jodit-utils';
     const data = boxes.get(jodit) || {}, key = name + tag;
     const view = isViewObject(jodit) ? jodit : jodit.j;
+    let body = null;
     if (!data[key]) {
         let c = view.c;
-        let body;
-        if (isJoditObject(jodit) && jodit.o.shadowRoot) {
-            body = jodit.o.shadowRoot;
-        }
-        else {
-            body = jodit.od.body;
-            if (isJoditObject(jodit)) {
-                const dialog = Dom.closest(jodit.container, 'dialog', jodit.od.body);
-                if (dialog) {
-                    body = dialog;
-                }
-            }
-        }
+        body = getPopupViewRoot(view.o, view.container, jodit.od.body);
         if (createInsideEditor &&
             isJoditObject(jodit) &&
             jodit.od !== jodit.ed) {
@@ -100,6 +90,18 @@ export function getContainer(jodit, classFunc, tag = 'div', createInsideEditor =
     data[key].classList.add(`jodit_theme_${view.o.theme || 'default'}`);
     return data[key];
 }
+/**
+ * Get root element for view
+ * @internal
+ */
+export function getPopupViewRoot(o, container, defaultRoot) {
+    return (o.popupRoot ??
+        o.shadowRoot ??
+        Dom.closest(container, parentElement => Dom.isHTMLElement(parentElement) &&
+            (Dom.isTag(parentElement, 'dialog') ||
+                ['fixed', 'absolute'].includes(css(parentElement, 'position'))), defaultRoot) ??
+        defaultRoot);
+}
 /**
  * Global event emitter
  */

package/esm/core/helpers/array/index.d.ts

@@ -6,6 +6,6 @@
 /**
  * @module helpers/array
  */
-export { asArray } from "./as-array";
-export { splitArray } from "./split-array";
-export { toArray } from "./to-array";
+export { asArray } from "./as-array.d.ts";
+export { splitArray } from "./split-array.d.ts";
+export { toArray } from "./to-array.d.ts";

package/esm/core/helpers/async/index.d.ts

@@ -6,4 +6,4 @@
 /**
  * @module helpers/async
  */
-export * from "./set-timeout";
+export * from "./set-timeout.d.ts";

package/esm/core/helpers/checker/index.d.ts

@@ -6,28 +6,28 @@
 /**
  * @module helpers/checker
  */
-export * from "./has-browser-color-picker";
-export * from "./is-abort-error";
-export * from "./is-array";
-export * from "./is-boolean";
-export * from "./is-equal";
-export * from "./is-function";
-export * from "./is-html";
-export * from "./is-html-from-word";
-export * from "./is-imp-interface";
-export * from "./is-int";
-export * from "./is-jodit-object";
-export * from "./is-license";
-export * from "./is-marker";
-export * from "./is-native-function";
-export * from "./is-number";
-export * from "./is-numeric";
-export * from "./is-plain-object";
-export * from "./is-promise";
-export * from "./is-set";
-export * from "./is-string";
-export * from "./is-url";
-export * from "./is-valid-name";
-export * from "./is-view-object";
-export * from "./is-void";
-export * from "./is-window";
+export * from "./has-browser-color-picker.d.ts";
+export * from "./is-abort-error.d.ts";
+export * from "./is-array.d.ts";
+export * from "./is-boolean.d.ts";
+export * from "./is-equal.d.ts";
+export * from "./is-function.d.ts";
+export * from "./is-html.d.ts";
+export * from "./is-html-from-word.d.ts";
+export * from "./is-imp-interface.d.ts";
+export * from "./is-int.d.ts";
+export * from "./is-jodit-object.d.ts";
+export * from "./is-license.d.ts";
+export * from "./is-marker.d.ts";
+export * from "./is-native-function.d.ts";
+export * from "./is-number.d.ts";
+export * from "./is-numeric.d.ts";
+export * from "./is-plain-object.d.ts";
+export * from "./is-promise.d.ts";
+export * from "./is-set.d.ts";
+export * from "./is-string.d.ts";
+export * from "./is-url.d.ts";
+export * from "./is-valid-name.d.ts";
+export * from "./is-view-object.d.ts";
+export * from "./is-void.d.ts";
+export * from "./is-window.d.ts";

package/esm/core/helpers/checker/is-abort-error.d.ts

@@ -6,5 +6,5 @@
 /**
  * @module helpers/checker
  */
-import type { AbortError } from "../utils/error/errors/abort-error";
+import type { AbortError } from "../utils/error/errors/abort-error.d.ts";
 export declare function isAbortError(error: unknown): error is AbortError;

package/esm/core/helpers/color/index.d.ts

@@ -6,4 +6,4 @@
 /**
  * @module helpers/color
  */
-export * from "./color-to-hex";
+export * from "./color-to-hex.d.ts";

package/esm/core/helpers/html/index.d.ts

@@ -6,9 +6,9 @@
 /**
  * @module helpers/html
  */
-export * from "./apply-styles";
-export * from "./clean-from-word";
-export * from "./htmlspecialchars";
-export * from "./nl2br";
-export * from "./safe-html";
-export * from "./strip-tags";
+export * from "./apply-styles.d.ts";
+export * from "./clean-from-word.d.ts";
+export * from "./htmlspecialchars.d.ts";
+export * from "./nl2br.d.ts";
+export * from "./safe-html.d.ts";
+export * from "./strip-tags.d.ts";

package/esm/core/helpers/normalize/index.d.ts

@@ -6,11 +6,11 @@
 /**
  * @module helpers/normalize
  */
-export * from "./normalize-color";
-export * from "./normalize-css-value";
-export * from "./normalize-key-aliases";
-export * from "./normalize-license";
-export * from "./normalize-path";
-export * from "./normalize-relative-path";
-export * from "./normalize-size";
-export * from "./normalize-url";
+export * from "./normalize-color.d.ts";
+export * from "./normalize-css-value.d.ts";
+export * from "./normalize-key-aliases.d.ts";
+export * from "./normalize-license.d.ts";
+export * from "./normalize-path.d.ts";
+export * from "./normalize-relative-path.d.ts";
+export * from "./normalize-size.d.ts";
+export * from "./normalize-url.d.ts";

package/esm/core/helpers/size/index.d.ts

@@ -6,9 +6,9 @@
 /**
  * @module helpers/size
  */
-export * from "./get-content-width";
-export * from "./get-scroll-parent";
-export * from "./inner-width";
-export * from "./object-size";
-export * from "./offset";
-export * from "./position";
+export * from "./get-content-width.d.ts";
+export * from "./get-scroll-parent.d.ts";
+export * from "./inner-width.d.ts";
+export * from "./object-size.d.ts";
+export * from "./offset.d.ts";
+export * from "./position.d.ts";