jodit 4.16.1 → 4.17.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jodit",
-	"version": "4.16.1",
+	"version": "4.17.1",
 	"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

@@ -8,9 +8,10 @@ import type { HTMLTagNames } from "./types/index";
 import type { AiAssistantSettings } from "./plugins/ai-assistant/interface";
 import type { IDictionary } from "./types/index";
 import type { Nullable } from "./types/index";
+import type { IJodit } from "./types/index";
+import type { IUploaderData } from "./types/index";
 import type { ImagePropertiesOptions } from "./plugins/image-properties/interface";
 import type { IControlType } from "./types/index";
-import type { IJodit } from "./types/index";
 import type { formTemplate } from "./plugins/link/template";
 import type { IUIForm } from "./types/index";
 import type { IUIOption } from "./types/index";
@@ -1264,6 +1265,27 @@ interface Config {
         blockLimits: IDictionary<1>;
     };
 }
+interface Config {
+    file: {
+        /**
+         * Inserts the files uploaded from the file popup's Upload tab. By default
+         * each one goes in as a link, an image as well, the way
+         * `uploader.defaultHandlerSuccess` inserts a file that isn't an image.
+         * ```javascript
+         * Jodit.make('#editor', {
+         * 		file: {
+         * 			defaultHandlerSuccess(data) {
+         * 				data.files.forEach(file => {
+         * 					this.s.insertHTML(`<a class="file" href="${data.baseurl + file}">${file}</a>`);
+         * 				});
+         * 			}
+         * 		}
+         * });
+         * ```
+         */
+        defaultHandlerSuccess?: (this: IJodit, data: IUploaderData) => void;
+    };
+}
 interface Config {
     autofocus: boolean;
     cursorAfterAutofocus: 'start' | 'end';
@@ -1971,6 +1993,23 @@ interface Config {
          * Default height for video iframe. Default: 345
          */
         defaultHeight?: number;
+        /**
+         * Inserts the videos uploaded from the popup's Upload tab, which is shown
+         * when `uploader.url` or `uploader.customUploadFunction` is set. By default
+         * each one goes in as `<video controls src="…">`.
+         * ```javascript
+         * Jodit.make('#editor', {
+         * 		video: {
+         * 			defaultHandlerSuccess(data) {
+         * 				data.files.forEach(file => {
+         * 					this.s.insertHTML(`<video controls preload="metadata" src="${data.baseurl + file}"></video>`);
+         * 				});
+         * 			}
+         * 		}
+         * });
+         * ```
+         */
+        defaultHandlerSuccess?: (this: IJodit, data: IUploaderData) => void;
     };
 }
 interface Config {

package/types/core/helpers/html/safe-html.d.ts

@@ -13,4 +13,4 @@ export type safeOptions = {
  * Removes dangerous constructs from HTML
  */
 export declare function safeHTML(box: HTMLElement | DocumentFragment, options: safeOptions): void;
-export declare function sanitizeHTMLElement(elm: Element | DocumentFragment, { safeJavaScriptLink, removeOnError }?: safeOptions): boolean;
+export declare function sanitizeHTMLElement(elm: Element | DocumentFragment, { safeJavaScriptLink, removeOnError, removeEventAttributes }?: safeOptions): boolean;

package/types/modules/widget/file-selector/file-selector.d.ts

@@ -8,7 +8,8 @@
  * @packageDocumentation
  * @module modules/widget/file-selector
  */
-import type { IFileBrowserCallBackData, IJodit } from "../../../types/index";
+import type { IFileBrowserCallBackData, IJodit, IUploaderData } from "../../../types/index";
+import { type TabOption } from "../tabs/tabs";
 interface ImageSelectorCallbacks {
     /**
      * Function that will be called when the user enters the URL of the tab image and alternative text for images
@@ -34,4 +35,12 @@ interface ImageSelectorCallbacks {
  * functions with different parameters
  */
 export declare const FileSelectorWidget: (editor: IJodit, callbacks: ImageSelectorCallbacks, elm: HTMLElement | null, close: () => void, isImage?: boolean) => HTMLDivElement;
+/**
+ * The Upload tab: a box that uploads the files dropped on it or chosen in its
+ * file input, then passes the uploader's answer to `onSuccess` and closes the popup
+ */
+export declare const UploadTab: (editor: IJodit, onSuccess: (this: IJodit, data: IUploaderData) => void, { label, accept }: {
+    label: string;
+    accept: string;
+}) => TabOption;
 export {};

package/types/plugins/file/file.d.ts

@@ -8,5 +8,28 @@
  * @packageDocumentation
  * @module plugins/file
  */
-import type { IJodit } from "../../types/index";
+import type { IJodit, IUploaderData } from "../../types/index";
+declare module 'jodit/config' {
+    interface Config {
+        file: {
+            /**
+             * Inserts the files uploaded from the file popup's Upload tab. By default
+             * each one goes in as a link, an image as well, the way
+             * `uploader.defaultHandlerSuccess` inserts a file that isn't an image.
+             * ```javascript
+             * Jodit.make('#editor', {
+             * 		file: {
+             * 			defaultHandlerSuccess(data) {
+             * 				data.files.forEach(file => {
+             * 					this.s.insertHTML(`<a class="file" href="${data.baseurl + file}">${file}</a>`);
+             * 				});
+             * 			}
+             * 		}
+             * });
+             * ```
+             */
+            defaultHandlerSuccess?: (this: IJodit, data: IUploaderData) => void;
+        };
+    }
+}
 export declare function file(editor: IJodit): void;

package/types/plugins/source/source.d.ts

@@ -21,6 +21,11 @@ export declare class source extends Plugin {
     private mirrorContainer;
     private __lock;
     private __oldMirrorValue;
+    /**
+     * What the source view was last filled with from WYSIWYG, read back from
+     * the editor; while the view still holds it, nothing has been typed there
+     */
+    private __filledValue;
     private tempMarkerStart;
     private tempMarkerStartReg;
     private tempMarkerEnd;
@@ -50,6 +55,18 @@ export declare class source extends Plugin {
     afterInit(editor: IJodit): void;
     private syncValueFromWYSIWYG;
     private initSourceEditor;
+    /**
+     * Replaces the source editor (the textarea shown while ACE loads) with
+     * the one that just became ready, carrying its text, selection and focus
+     * over. Filling the new editor from WYSIWYG instead would drop what was
+     * typed since the last, debounced, sync and normalise half-typed markup.
+     */
+    private takeOver;
+    /**
+     * The beautifier arrived after the source view was opened: format the
+     * view if nothing has been typed into it, otherwise leave the typing alone
+     */
+    private beautifyUntouched;
     /** @override */
     beforeDestruct(): void;
 }

package/types/plugins/video/config.d.ts

@@ -3,6 +3,10 @@
  * 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
  */
+/**
+ * @module plugins/video
+ */
+import type { IJodit, IUploaderData } from "../../types/index";
 declare module 'jodit/config' {
     interface Config {
         video: {
@@ -29,7 +33,23 @@ declare module 'jodit/config' {
              * Default height for video iframe. Default: 345
              */
             defaultHeight?: number;
+            /**
+             * Inserts the videos uploaded from the popup's Upload tab, which is shown
+             * when `uploader.url` or `uploader.customUploadFunction` is set. By default
+             * each one goes in as `<video controls src="…">`.
+             * ```javascript
+             * Jodit.make('#editor', {
+             * 		video: {
+             * 			defaultHandlerSuccess(data) {
+             * 				data.files.forEach(file => {
+             * 					this.s.insertHTML(`<video controls preload="metadata" src="${data.baseurl + file}"></video>`);
+             * 				});
+             * 			}
+             * 		}
+             * });
+             * ```
+             */
+            defaultHandlerSuccess?: (this: IJodit, data: IUploaderData) => void;
         };
     }
 }
-export {};