jodit 4.11.15 → 4.12.3

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.11.15
+ * Version: v4.12.3
  * 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.11.15
+ * Version: v4.12.3
  * 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.11.15
+ * Version: v4.12.3
  * 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.11.15
+ * Version: v4.12.3
  * 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.11.15
+ * Version: v4.12.3
  * 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.11.15
+ * Version: v4.12.3
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/polyfills.fat.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.11.15
+ * Version: v4.12.3
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/polyfills.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.11.15
+ * Version: v4.12.3
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/polyfills.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.11.15
+ * Version: v4.12.3
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/esm/config.d.ts

@@ -619,18 +619,62 @@ declare class Config implements IViewOptions {
      */
     disablePlugins: string[] | string;
     /**
-     * Init and download extra plugins
+     * Init and download extra plugins that are **not** already bundled/registered.
+     *
+     * For every name in this list that is not found in the plugin registry, Jodit
+     * loads it **at runtime over the network** from:
+     *
+     * ```text
+     * <basePath>plugins/<name>/<name>(.min).js
+     * ```
+     *
+     * (see {@link Config.basePath} and {@link Config.minified}). If the plugin is
+     * already registered — e.g. you imported it statically, or you use a bundle
+     * that ships it (such as the `jodit-pro` / `jodit-pro-react` "all plugins"
+     * build) — it is **skipped** and no request is made; in that case you don't
+     * need `extraPlugins` at all, just add the plugin's button.
      *
      * ```typescript
-     * var editor = Jodit.make('.editor', {
+     * // Dynamic loading: fetches <basePath>plugins/emoji/emoji.js
+     * const editor = Jodit.make('.editor', {
      *    extraPlugins: ['emoji']
      * });
      * ```
-     * It will try load %SCRIPT_PATH%/plugins/emoji/emoji.js and after load will try init it
+     *
+     * You can also pass an explicit URL to bypass the `basePath` convention:
+     *
+     * ```typescript
+     * const editor = Jodit.make('.editor', {
+     *    extraPlugins: [{ name: 'emoji', url: 'https://cdn.example.com/emoji.js' }]
+     * });
+     * ```
+     *
+     * Note: if you see a request to a malformed URL (e.g. `.../src/main.tsx?t=...plugins/emoji/emoji.js`),
+     * it means `basePath` was auto-detected incorrectly under your bundler — set
+     * {@link Config.basePath} explicitly. See the Plugin System docs for details.
      */
     extraPlugins: Array<string | IExtraPlugin>;
     /**
-     * Base path for download extra plugins
+     * Base path used to build the URL for dynamically loaded {@link Config.extraPlugins}
+     * (and their styles): `<basePath>plugins/<name>/<name>(.min).js`.
+     *
+     * When not set, Jodit auto-detects it from `document.currentScript`, then the
+     * last `<script src>` on the page, then `location.href`. That detection works
+     * for classic `<script>` includes, but **fails under ESM bundlers / dev
+     * servers** (Vite, Webpack dev, etc.) where there is no script tag for the
+     * bundle — it falls back to the entry module URL (e.g. `main.tsx`) and produces
+     * a broken plugin URL.
+     *
+     * Fix: host the plugin files at a public location and point `basePath` there
+     * (note the trailing slash):
+     *
+     * ```typescript
+     * const editor = Jodit.make('.editor', {
+     *    basePath: 'https://your-site.com/jodit-assets/',
+     *    extraPlugins: ['emoji']
+     *    // → loads https://your-site.com/jodit-assets/plugins/emoji/emoji.js
+     * });
+     * ```
      */
     basePath?: string;
     /**

package/esm/config.js

@@ -729,14 +729,39 @@ class Config {
          */
         this.disablePlugins = [];
         /**
-         * Init and download extra plugins
+         * Init and download extra plugins that are **not** already bundled/registered.
+         *
+         * For every name in this list that is not found in the plugin registry, Jodit
+         * loads it **at runtime over the network** from:
+         *
+         * ```text
+         * <basePath>plugins/<name>/<name>(.min).js
+         * ```
+         *
+         * (see {@link Config.basePath} and {@link Config.minified}). If the plugin is
+         * already registered — e.g. you imported it statically, or you use a bundle
+         * that ships it (such as the `jodit-pro` / `jodit-pro-react` "all plugins"
+         * build) — it is **skipped** and no request is made; in that case you don't
+         * need `extraPlugins` at all, just add the plugin's button.
          *
          * ```typescript
-         * var editor = Jodit.make('.editor', {
+         * // Dynamic loading: fetches <basePath>plugins/emoji/emoji.js
+         * const editor = Jodit.make('.editor', {
          *    extraPlugins: ['emoji']
          * });
          * ```
-         * It will try load %SCRIPT_PATH%/plugins/emoji/emoji.js and after load will try init it
+         *
+         * You can also pass an explicit URL to bypass the `basePath` convention:
+         *
+         * ```typescript
+         * const editor = Jodit.make('.editor', {
+         *    extraPlugins: [{ name: 'emoji', url: 'https://cdn.example.com/emoji.js' }]
+         * });
+         * ```
+         *
+         * Note: if you see a request to a malformed URL (e.g. `.../src/main.tsx?t=...plugins/emoji/emoji.js`),
+         * it means `basePath` was auto-detected incorrectly under your bundler — set
+         * {@link Config.basePath} explicitly. See the Plugin System docs for details.
          */
         this.extraPlugins = [];
         /**

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-2026 Valerii Chupurnov. All rights reserved. https://xdsoft.net
  */
-export const APP_VERSION = "4.11.15";
+export const APP_VERSION = "4.12.3";
 // prettier-ignore
 export const ES = "es2020";
 export const IS_ES_MODERN = true;

package/esm/core/helpers/utils/config-proto.d.ts

@@ -56,4 +56,25 @@ export declare function ConfigFlatten(obj: IDictionary): IDictionary;
  * console.log(JSON.stringify(plain)); // {"dialogWidth":500, "openOnDblClick": true, "editSrc": true, ...}
  * ```
  */
+/**
+ * Deep-merges `source` into `target` in-place.
+ * Uses the same merge semantics as {@link ConfigProto}:
+ * - Nested plain objects are merged recursively
+ * - {@link isAtom | Atomic} values replace the target entirely
+ * - Everything else (primitives, arrays, class instances) replaces the target value
+ *
+ * Designed for patching `Config.defaultOptions` without losing existing keys:
+ *
+ * ```js
+ * Jodit.configure({
+ *   controls: {
+ *     someButton: { group: 'custom' }
+ *   }
+ * });
+ * // Only `controls.someButton` is touched — all other controls remain intact.
+ * ```
+ *
+ * @see {@link ConfigProto} for the prototype-chain variant used at editor creation time
+ */
+export declare function ConfigMerge(target: IDictionary, source: IDictionary): void;
 export declare function ConfigDeepFlatten(obj: IDictionary): IDictionary;

package/esm/core/helpers/utils/config-proto.js

@@ -97,6 +97,38 @@ export function ConfigFlatten(obj) {
  * console.log(JSON.stringify(plain)); // {"dialogWidth":500, "openOnDblClick": true, "editSrc": true, ...}
  * ```
  */
+/**
+ * Deep-merges `source` into `target` in-place.
+ * Uses the same merge semantics as {@link ConfigProto}:
+ * - Nested plain objects are merged recursively
+ * - {@link isAtom | Atomic} values replace the target entirely
+ * - Everything else (primitives, arrays, class instances) replaces the target value
+ *
+ * Designed for patching `Config.defaultOptions` without losing existing keys:
+ *
+ * ```js
+ * Jodit.configure({
+ *   controls: {
+ *     someButton: { group: 'custom' }
+ *   }
+ * });
+ * // Only `controls.someButton` is touched — all other controls remain intact.
+ * ```
+ *
+ * @see {@link ConfigProto} for the prototype-chain variant used at editor creation time
+ */
+export function ConfigMerge(target, source) {
+    Object.keys(source).forEach(key => {
+        const srcVal = source[key];
+        const tgtVal = target[key];
+        if (isPlainObject(srcVal) && isPlainObject(tgtVal) && !isAtom(srcVal)) {
+            ConfigMerge(tgtVal, srcVal);
+        }
+        else {
+            target[key] = srcVal;
+        }
+    });
+}
 export function ConfigDeepFlatten(obj) {
     return keys(obj, false).reduce((app, key) => {
         app[key] = isPlainObject(obj[key])

package/esm/core/ui/icon.d.ts

@@ -27,4 +27,14 @@ export declare class Icon {
      * Make icon html element
      */
     static makeIcon(jodit: IViewBased, icon: IUIIconState): CanUndef<Node>;
+    /**
+     * Turn a raw icon string into an element with a `classList`.
+     *
+     * A plain-text icon (e.g. an emoji/text glyph) makes `fromHTML` return a
+     * Text node, which has no `classList`; wrap it in a span so classes/styles
+     * can be applied and `makeIcon` never crashes on `iconElement.classList`.
+     * Note: SVG icons are `SVGElement` (not `HTMLElement`) but are still Element
+     * nodes with a `classList`, so we check `isElement`, not `isHTMLElement`.
+     */
+    private static toIconElement;
 }

package/esm/core/ui/icon.js

@@ -4,6 +4,7 @@
  * Copyright (c) 2013-2026 Valerii Chupurnov. All rights reserved. https://xdsoft.net
  */
 import { IS_PROD } from "../constants.js";
+import { Dom } from "../dom/dom.js";
 import { camelCase, kebabCase } from "../helpers/index.js";
 import { css } from "../helpers/utils/css.js";
 export class Icon {
@@ -71,7 +72,7 @@ export class Icon {
                 Icon.get(name, '') ||
                 ((_d = jodit.o.extraIcons) === null || _d === void 0 ? void 0 : _d[name]);
             if (svg) {
-                iconElement = jodit.c.fromHTML(svg.trim());
+                iconElement = Icon.toIconElement(jodit, svg.trim());
                 if (!/^<svg/i.test(name)) {
                     iconElement.classList.add('jodit-icon_' + clearName);
                 }
@@ -88,6 +89,21 @@ export class Icon {
         }
         return iconElement;
     }
+    /**
+     * Turn a raw icon string into an element with a `classList`.
+     *
+     * A plain-text icon (e.g. an emoji/text glyph) makes `fromHTML` return a
+     * Text node, which has no `classList`; wrap it in a span so classes/styles
+     * can be applied and `makeIcon` never crashes on `iconElement.classList`.
+     * Note: SVG icons are `SVGElement` (not `HTMLElement`) but are still Element
+     * nodes with a `classList`, so we check `isElement`, not `isHTMLElement`.
+     */
+    static toIconElement(jodit, svg) {
+        const node = jodit.c.fromHTML(svg);
+        return Dom.isElement(node)
+            ? node
+            : jodit.c.span('jodit-icon_text', node);
+    }
 }
 Icon.icons = {};
 Icon.__cache = new Map();

package/esm/jodit.d.ts

@@ -79,6 +79,50 @@ export declare class Jodit extends ViewWithToolbar implements IJodit, Dlgs {
      * Default settings
      */
     static get defaultOptions(): Config;
+    /**
+     * Deep-merges partial options into the global defaults without replacing
+     * top-level objects. This lets you patch nested settings (e.g. a single
+     * button inside `controls`) without losing the rest:
+     *
+     * ```js
+     * // Add a custom button — all existing controls remain untouched
+     * Jodit.configure({
+     *   controls: {
+     *     myButton: {
+     *       icon: 'pencil',
+     *       command: 'selectall'
+     *     }
+     *   }
+     * });
+     *
+     * // Override only the `group` of an existing button
+     * Jodit.configure({
+     *   controls: {
+     *     someButton: { group: 'custom' }
+     *   }
+     * });
+     *
+     * // Works with any nested option
+     * Jodit.configure({
+     *   createAttributes: {
+     *     div: { class: 'my-class' }
+     *   }
+     * });
+     *
+     * // Use Jodit.atom() to replace a nested value entirely instead of merging
+     * Jodit.configure({
+     *   controls: {
+     *     fontsize: {
+     *       list: Jodit.atom([8, 9, 10])
+     *     }
+     *   }
+     * });
+     * ```
+     *
+     * @see {@link ConfigMerge} for the merge algorithm
+     * @see {@link ConfigProto} for per-instance prototype-based merge used at editor creation time
+     */
+    static configure(options: IDictionary): void;
     static fatMode: boolean;
     static readonly plugins: IPluginSystem;
     static modules: typeof Modules;

package/esm/jodit.js

@@ -18,7 +18,7 @@ import * as constants from "./core/constants.js";
 import { FAT_MODE, IS_PROD, lang } from "./core/constants.js";
 import { autobind, cache, cached, derive, throttle, watch } from "./core/decorators/index.js";
 import { eventEmitter, instances, modules, pluginSystem } from "./core/global.js";
-import { asArray, attr, callPromise, ConfigProto, css, error, isFunction, isJoditObject, isNumber, isPromise, isString, isVoid, kebabCase, markAsAtomic, normalizeKeyAliases, resolveElement, toArray, ucfirst } from "./core/helpers/index.js";
+import { asArray, attr, callPromise, ConfigMerge, ConfigProto, css, error, isFunction, isJoditObject, isNumber, isPromise, isString, isVoid, kebabCase, markAsAtomic, normalizeKeyAliases, resolveElement, toArray, ucfirst } from "./core/helpers/index.js";
 import { Ajax } from "./core/request/index.js";
 import { Dlgs } from "./core/traits/dlgs.js";
 import { Config } from "./config.js";
@@ -116,6 +116,52 @@ let Jodit = Jodit_1 = class Jodit extends ViewWithToolbar {
     static get defaultOptions() {
         return Config.defaultOptions;
     }
+    /**
+     * Deep-merges partial options into the global defaults without replacing
+     * top-level objects. This lets you patch nested settings (e.g. a single
+     * button inside `controls`) without losing the rest:
+     *
+     * ```js
+     * // Add a custom button — all existing controls remain untouched
+     * Jodit.configure({
+     *   controls: {
+     *     myButton: {
+     *       icon: 'pencil',
+     *       command: 'selectall'
+     *     }
+     *   }
+     * });
+     *
+     * // Override only the `group` of an existing button
+     * Jodit.configure({
+     *   controls: {
+     *     someButton: { group: 'custom' }
+     *   }
+     * });
+     *
+     * // Works with any nested option
+     * Jodit.configure({
+     *   createAttributes: {
+     *     div: { class: 'my-class' }
+     *   }
+     * });
+     *
+     * // Use Jodit.atom() to replace a nested value entirely instead of merging
+     * Jodit.configure({
+     *   controls: {
+     *     fontsize: {
+     *       list: Jodit.atom([8, 9, 10])
+     *     }
+     *   }
+     * });
+     * ```
+     *
+     * @see {@link ConfigMerge} for the merge algorithm
+     * @see {@link ConfigProto} for per-instance prototype-based merge used at editor creation time
+     */
+    static configure(options) {
+        ConfigMerge(Jodit_1.defaultOptions, options);
+    }
     get createInside() {
         return new Create(() => this.ed, this.o.createAttributes);
     }

package/esm/modules/widget/file-selector/file-selector.js

@@ -66,7 +66,8 @@ export const FileSelectorWidget = (editor, callbacks, elm, close, isImage = true
             type: 'submit',
             variant: 'primary',
             text: 'Insert'
-        }), form = new UIForm(editor, [
+        });
+        const form = new UIForm(editor, [
             new UIInput(editor, {
                 required: true,
                 label: 'URL',

package/esm/plugins/link/link.js

@@ -105,7 +105,8 @@ export class link extends Plugin {
     }
     __generateForm(current, close) {
         const { jodit } = this;
-        const i18n = jodit.i18n.bind(jodit), { openInNewTabCheckbox, openInNewTabCheckboxDefaultChecked, noFollowCheckbox, formTemplate, formClassName, modeClassName } = jodit.o.link;
+        const i18n = jodit.i18n.bind(jodit);
+        const { openInNewTabCheckbox, openInNewTabCheckboxDefaultChecked, noFollowCheckbox, formTemplate, formClassName, modeClassName } = jodit.o.link;
         const html = formTemplate(jodit);
         const form = isString(html)
             ? jodit.c.fromHTML(html, {

package/esm/typings.d.ts

@@ -10,3 +10,4 @@ declare module '*.svg' {
     const content: string;
     export default content;
 }
+declare module '*.less';

package/package.json

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

package/types/config.d.ts

@@ -619,18 +619,62 @@ declare class Config implements IViewOptions {
      */
     disablePlugins: string[] | string;
     /**
-     * Init and download extra plugins
+     * Init and download extra plugins that are **not** already bundled/registered.
+     *
+     * For every name in this list that is not found in the plugin registry, Jodit
+     * loads it **at runtime over the network** from:
+     *
+     * ```text
+     * <basePath>plugins/<name>/<name>(.min).js
+     * ```
+     *
+     * (see {@link Config.basePath} and {@link Config.minified}). If the plugin is
+     * already registered — e.g. you imported it statically, or you use a bundle
+     * that ships it (such as the `jodit-pro` / `jodit-pro-react` "all plugins"
+     * build) — it is **skipped** and no request is made; in that case you don't
+     * need `extraPlugins` at all, just add the plugin's button.
      *
      * ```typescript
-     * var editor = Jodit.make('.editor', {
+     * // Dynamic loading: fetches <basePath>plugins/emoji/emoji.js
+     * const editor = Jodit.make('.editor', {
      *    extraPlugins: ['emoji']
      * });
      * ```
-     * It will try load %SCRIPT_PATH%/plugins/emoji/emoji.js and after load will try init it
+     *
+     * You can also pass an explicit URL to bypass the `basePath` convention:
+     *
+     * ```typescript
+     * const editor = Jodit.make('.editor', {
+     *    extraPlugins: [{ name: 'emoji', url: 'https://cdn.example.com/emoji.js' }]
+     * });
+     * ```
+     *
+     * Note: if you see a request to a malformed URL (e.g. `.../src/main.tsx?t=...plugins/emoji/emoji.js`),
+     * it means `basePath` was auto-detected incorrectly under your bundler — set
+     * {@link Config.basePath} explicitly. See the Plugin System docs for details.
      */
     extraPlugins: Array<string | IExtraPlugin>;
     /**
-     * Base path for download extra plugins
+     * Base path used to build the URL for dynamically loaded {@link Config.extraPlugins}
+     * (and their styles): `<basePath>plugins/<name>/<name>(.min).js`.
+     *
+     * When not set, Jodit auto-detects it from `document.currentScript`, then the
+     * last `<script src>` on the page, then `location.href`. That detection works
+     * for classic `<script>` includes, but **fails under ESM bundlers / dev
+     * servers** (Vite, Webpack dev, etc.) where there is no script tag for the
+     * bundle — it falls back to the entry module URL (e.g. `main.tsx`) and produces
+     * a broken plugin URL.
+     *
+     * Fix: host the plugin files at a public location and point `basePath` there
+     * (note the trailing slash):
+     *
+     * ```typescript
+     * const editor = Jodit.make('.editor', {
+     *    basePath: 'https://your-site.com/jodit-assets/',
+     *    extraPlugins: ['emoji']
+     *    // → loads https://your-site.com/jodit-assets/plugins/emoji/emoji.js
+     * });
+     * ```
      */
     basePath?: string;
     /**

package/types/core/helpers/utils/config-proto.d.ts

@@ -56,4 +56,25 @@ export declare function ConfigFlatten(obj: IDictionary): IDictionary;
  * console.log(JSON.stringify(plain)); // {"dialogWidth":500, "openOnDblClick": true, "editSrc": true, ...}
  * ```
  */
+/**
+ * Deep-merges `source` into `target` in-place.
+ * Uses the same merge semantics as {@link ConfigProto}:
+ * - Nested plain objects are merged recursively
+ * - {@link isAtom | Atomic} values replace the target entirely
+ * - Everything else (primitives, arrays, class instances) replaces the target value
+ *
+ * Designed for patching `Config.defaultOptions` without losing existing keys:
+ *
+ * ```js
+ * Jodit.configure({
+ *   controls: {
+ *     someButton: { group: 'custom' }
+ *   }
+ * });
+ * // Only `controls.someButton` is touched — all other controls remain intact.
+ * ```
+ *
+ * @see {@link ConfigProto} for the prototype-chain variant used at editor creation time
+ */
+export declare function ConfigMerge(target: IDictionary, source: IDictionary): void;
 export declare function ConfigDeepFlatten(obj: IDictionary): IDictionary;

package/types/core/ui/icon.d.ts

@@ -27,4 +27,14 @@ export declare class Icon {
      * Make icon html element
      */
     static makeIcon(jodit: IViewBased, icon: IUIIconState): CanUndef<Node>;
+    /**
+     * Turn a raw icon string into an element with a `classList`.
+     *
+     * A plain-text icon (e.g. an emoji/text glyph) makes `fromHTML` return a
+     * Text node, which has no `classList`; wrap it in a span so classes/styles
+     * can be applied and `makeIcon` never crashes on `iconElement.classList`.
+     * Note: SVG icons are `SVGElement` (not `HTMLElement`) but are still Element
+     * nodes with a `classList`, so we check `isElement`, not `isHTMLElement`.
+     */
+    private static toIconElement;
 }

package/types/jodit.d.ts

@@ -79,6 +79,50 @@ export declare class Jodit extends ViewWithToolbar implements IJodit, Dlgs {
      * Default settings
      */
     static get defaultOptions(): Config;
+    /**
+     * Deep-merges partial options into the global defaults without replacing
+     * top-level objects. This lets you patch nested settings (e.g. a single
+     * button inside `controls`) without losing the rest:
+     *
+     * ```js
+     * // Add a custom button — all existing controls remain untouched
+     * Jodit.configure({
+     *   controls: {
+     *     myButton: {
+     *       icon: 'pencil',
+     *       command: 'selectall'
+     *     }
+     *   }
+     * });
+     *
+     * // Override only the `group` of an existing button
+     * Jodit.configure({
+     *   controls: {
+     *     someButton: { group: 'custom' }
+     *   }
+     * });
+     *
+     * // Works with any nested option
+     * Jodit.configure({
+     *   createAttributes: {
+     *     div: { class: 'my-class' }
+     *   }
+     * });
+     *
+     * // Use Jodit.atom() to replace a nested value entirely instead of merging
+     * Jodit.configure({
+     *   controls: {
+     *     fontsize: {
+     *       list: Jodit.atom([8, 9, 10])
+     *     }
+     *   }
+     * });
+     * ```
+     *
+     * @see {@link ConfigMerge} for the merge algorithm
+     * @see {@link ConfigProto} for per-instance prototype-based merge used at editor creation time
+     */
+    static configure(options: IDictionary): void;
     static fatMode: boolean;
     static readonly plugins: IPluginSystem;
     static modules: typeof Modules;

package/types/typings.d.ts

@@ -10,3 +10,4 @@ declare module '*.svg' {
     const content: string;
     export default content;
 }
+declare module '*.less';