jodit 4.11.15 → 4.12.3

package/es2021.en/jodit.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
  */
@@ -717,17 +717,61 @@ let ConfigPrototype = {};
 	 * ```
 	 */ (0,_swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_0__._)(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.
 	 */ (0,_swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_0__._)(this, "extraPlugins", []);
         /**
-	 * 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
+	 * });
+	 * ```
 	 */ (0,_swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_0__._)(this, "basePath", void 0);
         /**
 	 * Additional buttons appended to the {@link Config.buttons} list
@@ -1758,7 +1802,7 @@ __webpack_require__.r(__webpack_exports__);
  * ```
  * @packageDocumentation
  * @module constants
- */ const APP_VERSION = "4.11.15";
+ */ const APP_VERSION = "4.12.3";
 // prettier-ignore
 const ES = "es2021";
 const IS_ES_MODERN = true;
@@ -7512,6 +7556,7 @@ const completeUrl = (url)=>{
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   ConfigDeepFlatten: function() { return /* binding */ ConfigDeepFlatten; },
 /* harmony export */   ConfigFlatten: function() { return /* binding */ ConfigFlatten; },
+/* harmony export */   ConfigMerge: function() { return /* binding */ ConfigMerge; },
 /* harmony export */   ConfigProto: function() { return /* binding */ ConfigProto; }
 /* harmony export */ });
 /* harmony import */ var jodit_core_helpers_checker_is_array__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(17312);
@@ -7622,7 +7667,37 @@ function ConfigFlatten(obj) {
  * const plain = Jodit.modules.Helpers.ConfigDeepFlatten(editor.o.image);
  * console.log(JSON.stringify(plain)); // {"dialogWidth":500, "openOnDblClick": true, "editSrc": true, ...}
  * ```
- */ function ConfigDeepFlatten(obj) {
+ */ /**
+ * 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
+ */ function ConfigMerge(target, source) {
+    Object.keys(source).forEach((key)=>{
+        const srcVal = source[key];
+        const tgtVal = target[key];
+        if ((0,jodit_core_helpers_checker_is_plain_object__WEBPACK_IMPORTED_MODULE_1__.isPlainObject)(srcVal) && (0,jodit_core_helpers_checker_is_plain_object__WEBPACK_IMPORTED_MODULE_1__.isPlainObject)(tgtVal) && !(0,_extend__WEBPACK_IMPORTED_MODULE_5__.isAtom)(srcVal)) {
+            ConfigMerge(tgtVal, srcVal);
+        } else {
+            target[key] = srcVal;
+        }
+    });
+}
+function ConfigDeepFlatten(obj) {
     return (0,_utils__WEBPACK_IMPORTED_MODULE_6__.keys)(obj, false).reduce((app, key)=>{
         app[key] = (0,jodit_core_helpers_checker_is_plain_object__WEBPACK_IMPORTED_MODULE_1__.isPlainObject)(obj[key]) ? ConfigDeepFlatten(obj[key]) : obj[key];
         return app;
@@ -8207,6 +8282,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   $$: function() { return /* reexport safe */ _selector__WEBPACK_IMPORTED_MODULE_23__.$$; },
 /* harmony export */   ConfigDeepFlatten: function() { return /* reexport safe */ _config_proto__WEBPACK_IMPORTED_MODULE_7__.ConfigDeepFlatten; },
 /* harmony export */   ConfigFlatten: function() { return /* reexport safe */ _config_proto__WEBPACK_IMPORTED_MODULE_7__.ConfigFlatten; },
+/* harmony export */   ConfigMerge: function() { return /* reexport safe */ _config_proto__WEBPACK_IMPORTED_MODULE_7__.ConfigMerge; },
 /* harmony export */   ConfigProto: function() { return /* reexport safe */ _config_proto__WEBPACK_IMPORTED_MODULE_7__.ConfigProto; },
 /* harmony export */   ConnectionError: function() { return /* reexport safe */ _error__WEBPACK_IMPORTED_MODULE_13__.ConnectionError; },
 /* harmony export */   LimitedStack: function() { return /* reexport safe */ _stack__WEBPACK_IMPORTED_MODULE_25__.LimitedStack; },
@@ -15367,8 +15443,9 @@ UISpacer = (0,_swc_helpers_ts_decorate__WEBPACK_IMPORTED_MODULE_0__.__decorate)(
 /* harmony export */ });
 /* harmony import */ var _swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(25045);
 /* harmony import */ var jodit_core_constants__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(81937);
-/* harmony import */ var jodit_core_helpers__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(65946);
-/* harmony import */ var jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(80991);
+/* harmony import */ var jodit_core_dom_dom__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(23211);
+/* harmony import */ var jodit_core_helpers__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(65946);
+/* harmony import */ var jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(80991);
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
@@ -15379,12 +15456,13 @@ UISpacer = (0,_swc_helpers_ts_decorate__WEBPACK_IMPORTED_MODULE_0__.__decorate)(
 
 
 
+
 class Icon {
     static getIcon(name) {
         if (/<svg/i.test(name)) {
             return name;
         }
-        const icon = Icon.icons[name] || Icon.icons[name.replace(/-/g, '_')] || Icon.icons[name.replace(/_/g, '-')] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_2__.camelCase)(name)] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_2__.kebabCase)(name)] || Icon.icons[name.toLowerCase()];
+        const icon = Icon.icons[name] || Icon.icons[name.replace(/-/g, '_')] || Icon.icons[name.replace(/_/g, '-')] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_3__.camelCase)(name)] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_3__.kebabCase)(name)] || Icon.icons[name.toLowerCase()];
         if (!jodit_core_constants__WEBPACK_IMPORTED_MODULE_1__.IS_PROD && !icon) {
             console.warn(`Icon "${name}" not found`);
         }
@@ -15425,11 +15503,11 @@ class Icon {
         }
         if (iconURL) {
             iconElement = jodit.c.span();
-            (0,jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_3__.css)(iconElement, 'backgroundImage', 'url(' + iconURL.replace('{basePath}', jodit?.basePath || '') + ')');
+            (0,jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_4__.css)(iconElement, 'backgroundImage', 'url(' + iconURL.replace('{basePath}', jodit?.basePath || '') + ')');
         } else {
             const svg = iconFromEvent || Icon.get(name, '') || jodit.o.extraIcons?.[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);
                 }
@@ -15445,6 +15523,18 @@ 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 jodit_core_dom_dom__WEBPACK_IMPORTED_MODULE_2__.Dom.isElement(node) ? node : jodit.c.span('jodit-icon_text', node);
+    }
 }
 (0,_swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_0__._)(Icon, "icons", {});
 (0,_swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_0__._)(Icon, "__cache", new Map());
@@ -16532,6 +16622,51 @@ class Jodit extends jodit_modules__WEBPACK_IMPORTED_MODULE_9__.ViewWithToolbar {
 	 */ static get defaultOptions() {
         return jodit_config__WEBPACK_IMPORTED_MODULE_8__.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) {
+        (0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_5__.ConfigMerge)(Jodit.defaultOptions, options);
+    }
     get createInside() {
         return new jodit_modules__WEBPACK_IMPORTED_MODULE_9__.Create(()=>this.ed, this.o.createAttributes);
     }
@@ -24613,7 +24748,8 @@ jodit_core_ui__WEBPACK_IMPORTED_MODULE_2__.Icon.set('palette', (_palette_svg__WE
             type: 'submit',
             variant: 'primary',
             text: 'Insert'
-        }), form = new jodit_core_ui__WEBPACK_IMPORTED_MODULE_2__.UIForm(editor, [
+        });
+        const form = new jodit_core_ui__WEBPACK_IMPORTED_MODULE_2__.UIForm(editor, [
             new jodit_core_ui__WEBPACK_IMPORTED_MODULE_2__.UIInput(editor, {
                 required: true,
                 label: 'URL',
@@ -34061,7 +34197,8 @@ jodit_config__WEBPACK_IMPORTED_MODULE_2__.Config.prototype.controls.link = {
     }
     __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 = (0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_5__.isString)(html) ? jodit.c.fromHTML(html, {
             target_checkbox_box: openInNewTabCheckbox,