jodit 4.12.2 → 4.12.3

package/es5/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.12.2
+ * Version: v4.12.3
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */
@@ -717,17 +717,61 @@ var ConfigPrototype = {};
 	 * ```
 	 */ (0,_swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_2__._)(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_2__._)(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_2__._)(this, "basePath", void 0);
         /**
 	 * Additional buttons appended to the {@link Config.buttons} list
@@ -2022,7 +2066,7 @@ __webpack_require__.r(__webpack_exports__);
  * @packageDocumentation
  * @module constants
  */ 
-var APP_VERSION = "4.12.2";
+var APP_VERSION = "4.12.3";
 // prettier-ignore
 var ES = "es5";
 var IS_ES_MODERN = false;
@@ -18678,8 +18722,9 @@ UISpacer = (0,_swc_helpers_ts_decorate__WEBPACK_IMPORTED_MODULE_4__.__decorate)(
 /* harmony import */ var _swc_helpers_create_class__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(53429);
 /* harmony import */ var _swc_helpers_define_property__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(25045);
 /* harmony import */ var jodit_core_constants__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(81937);
-/* harmony import */ var jodit_core_helpers__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(65946);
-/* harmony import */ var jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(80991);
+/* harmony import */ var jodit_core_dom_dom__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(23211);
+/* harmony import */ var jodit_core_helpers__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(65946);
+/* harmony import */ var jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(80991);
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
@@ -18692,6 +18737,7 @@ UISpacer = (0,_swc_helpers_ts_decorate__WEBPACK_IMPORTED_MODULE_4__.__decorate)(
 
 
 
+
 var Icon = /*#__PURE__*/ function() {
     "use strict";
     function Icon() {
@@ -18704,7 +18750,7 @@ var Icon = /*#__PURE__*/ function() {
                 if (/<svg/i.test(name)) {
                     return name;
                 }
-                var icon = Icon.icons[name] || Icon.icons[name.replace(/-/g, '_')] || Icon.icons[name.replace(/_/g, '-')] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_4__.camelCase)(name)] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_4__.kebabCase)(name)] || Icon.icons[name.toLowerCase()];
+                var icon = Icon.icons[name] || Icon.icons[name.replace(/-/g, '_')] || Icon.icons[name.replace(/_/g, '-')] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_5__.camelCase)(name)] || Icon.icons[(0,jodit_core_helpers__WEBPACK_IMPORTED_MODULE_5__.kebabCase)(name)] || Icon.icons[name.toLowerCase()];
                 if (!jodit_core_constants__WEBPACK_IMPORTED_MODULE_3__.IS_PROD && !icon) {
                     console.warn('Icon "'.concat(name, '" not found'));
                 }
@@ -18760,12 +18806,12 @@ var Icon = /*#__PURE__*/ function() {
                 }
                 if (iconURL) {
                     iconElement = jodit.c.span();
-                    (0,jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_5__.css)(iconElement, 'backgroundImage', 'url(' + iconURL.replace('{basePath}', (jodit === null || jodit === void 0 ? void 0 : jodit.basePath) || '') + ')');
+                    (0,jodit_core_helpers_utils_css__WEBPACK_IMPORTED_MODULE_6__.css)(iconElement, 'backgroundImage', 'url(' + iconURL.replace('{basePath}', (jodit === null || jodit === void 0 ? void 0 : jodit.basePath) || '') + ')');
                 } else {
                     var _jodit_o_extraIcons;
                     var svg = iconFromEvent || Icon.get(name, '') || ((_jodit_o_extraIcons = jodit.o.extraIcons) === null || _jodit_o_extraIcons === void 0 ? void 0 : _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);
                         }
@@ -18781,6 +18827,21 @@ var Icon = /*#__PURE__*/ function() {
                 }
                 return iconElement;
             }
+        },
+        {
+            key: "toIconElement",
+            value: /**
+	 * 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`.
+	 */ function toIconElement(jodit, svg) {
+                var node = jodit.c.fromHTML(svg);
+                return jodit_core_dom_dom__WEBPACK_IMPORTED_MODULE_4__.Dom.isElement(node) ? node : jodit.c.span('jodit-icon_text', node);
+            }
         }
     ]);
     return Icon;

package/es5/jodit.min.css

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