jodit 4.12.2 → 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.12.2
+ * 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.12.2";
+ */ const APP_VERSION = "4.12.3";
 // prettier-ignore
 const ES = "es2021";
 const IS_ES_MODERN = true;
@@ -15399,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.
@@ -15411,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`);
         }
@@ -15457,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);
                 }
@@ -15477,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());