jodit-pro 4.12.6 → 4.12.7

package/es2021/jodit.js

@@ -1,7 +1,7 @@
 /*!
  * jodit-pro - PRO Version of Jodit Editor
  * Author: Chupurnov Valerii <chupurnov@gmail.com>
- * Version: v4.12.6
+ * Version: v4.12.7
  * Url: https://xdsoft.net/jodit/pro/
  * License(s): SEE LICENSE IN LICENSE.md
  */
@@ -714,14 +714,39 @@ let ConfigPrototype = {};
          * ```
          */ 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 = [];
         /**
          * Additional buttons appended to the {@link Config.buttons} list
@@ -1721,7 +1746,7 @@ __webpack_require__.r(__webpack_exports__);
  * ```
  * @packageDocumentation
  * @module constants
- */ const APP_VERSION = "4.12.6";
+ */ const APP_VERSION = "4.12.7";
 // prettier-ignore
 const ES = "es2021";
 const IS_ES_MODERN = true;
@@ -15113,8 +15138,9 @@ UISpacer = __decorate([
 /* harmony export */   Icon: function() { return /* binding */ Icon; }
 /* harmony export */ });
 /* harmony import */ var _constants_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(82758);
-/* harmony import */ var _helpers_index_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(21537);
-/* harmony import */ var _helpers_utils_css_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(41180);
+/* harmony import */ var _dom_dom_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(2748);
+/* harmony import */ var _helpers_index_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(21537);
+/* harmony import */ var _helpers_utils_css_js__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(41180);
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
@@ -15122,12 +15148,13 @@ UISpacer = __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,_helpers_index_js__WEBPACK_IMPORTED_MODULE_1__.camelCase)(name)] || Icon.icons[(0,_helpers_index_js__WEBPACK_IMPORTED_MODULE_1__.kebabCase)(name)] || Icon.icons[name.toLowerCase()];
+        const icon = Icon.icons[name] || Icon.icons[name.replace(/-/g, '_')] || Icon.icons[name.replace(/_/g, '-')] || Icon.icons[(0,_helpers_index_js__WEBPACK_IMPORTED_MODULE_2__.camelCase)(name)] || Icon.icons[(0,_helpers_index_js__WEBPACK_IMPORTED_MODULE_2__.kebabCase)(name)] || Icon.icons[name.toLowerCase()];
         if (!_constants_js__WEBPACK_IMPORTED_MODULE_0__.IS_PROD && !icon) {
             console.warn(`Icon "${name}" not found`);
         }
@@ -15169,11 +15196,11 @@ class Icon {
         }
         if (iconURL) {
             iconElement = jodit.c.span();
-            (0,_helpers_utils_css_js__WEBPACK_IMPORTED_MODULE_2__.css)(iconElement, 'backgroundImage', 'url(' + iconURL.replace('{basePath}', (jodit === null || jodit === void 0 ? void 0 : jodit.basePath) || '') + ')');
+            (0,_helpers_utils_css_js__WEBPACK_IMPORTED_MODULE_3__.css)(iconElement, 'backgroundImage', 'url(' + iconURL.replace('{basePath}', (jodit === null || jodit === void 0 ? void 0 : jodit.basePath) || '') + ')');
         } else {
             const svg = iconFromEvent || 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);
                 }
@@ -15189,6 +15216,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 _dom_dom_js__WEBPACK_IMPORTED_MODULE_1__.Dom.isElement(node) ? node : jodit.c.span('jodit-icon_text', node);
+    }
 }
 Icon.icons = {};
 Icon.__cache = new Map();