jodit 4.12.23 → 4.12.25

package/types/plugins/backspace/cases/index.d.ts

@@ -3,9 +3,25 @@
  * 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
  */
-import { checkRemoveChar } from "./check-remove-char";
-import { checkRemoveContentNotEditable } from "./check-remove-content-not-editable";
+/**
+ * @module plugins/backspace
+ */
+import type { IJodit } from "../../../types/index";
+import type { DeleteMode } from "../interface";
+type CaseFn = (jodit: IJodit, fakeNode: any, backspace: boolean, mode: DeleteMode) => void | boolean;
+/**
+ * Ordered delete/backspace cases with stable keys. The first one returning
+ * `true` wins. The keys are stable across minified builds (function names are
+ * mangled by terser) so they can be referenced by `delete.disableCases`.
+ * @private
+ */
+export declare const casesMap: ReadonlyArray<readonly [
+    string,
+    CaseFn
+]>;
 /**
  * @private
+ * @deprecated Use `casesMap` to also get the stable case keys.
  */
-export declare const cases: (typeof checkRemoveContentNotEditable | typeof checkRemoveChar)[];
+export declare const cases: CaseFn[];
+export {};

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

@@ -17,6 +17,21 @@ declare module 'jodit/config' {
                 backspaceWord: string[];
                 backspaceSentence: string[];
             };
+            /**
+             * Disable specific Backspace/Delete cleanup cases by their stable
+             * key, so the plugin no longer applies that particular behavior.
+             * Available keys: `remove-unbreakable`, `remove-not-editable`,
+             * `remove-char`, `table-cell`, `remove-empty-parent`,
+             * `remove-empty-neighbor`, `join-two-lists`, `join-neighbors`,
+             * `unwrap-first-list-item`.
+             *
+             * ```javascript
+             * Jodit.make('#editor', {
+             * 	 delete: { disableCases: new Set(['remove-empty-parent']) }
+             * });
+             * ```
+             */
+            disableCases?: Set<string>;
         };
     }
 }

package/types/plugins/clean-html/clean-html.d.ts

@@ -34,6 +34,14 @@ export declare class cleanHtml extends Plugin {
     protected onBeforeSetNativeEditorValue(data: {
         value: string;
     }): boolean;
+    /**
+     * Collapse a value that holds only a single empty block (e.g.
+     * `<p><br></p>` left after deleting all content) to an empty string —
+     * opt-in via `cleanHTML.collapseEmptyValueToEmptyString`. See #1149
+     */
+    protected onAfterGetValueFromEditor(data: {
+        value: string;
+    }): void;
     protected onSafeHTML(sandBox: HTMLElement): void;
     /** @override */
     protected beforeDestruct(): void;

package/types/plugins/clean-html/config.d.ts

@@ -23,6 +23,15 @@ declare module 'jodit/config' {
              * Remove empty elements
              */
             removeEmptyElements: boolean;
+            /**
+             * Return an empty string from `editor.value` (and the synced source
+             * element) when the editor holds only a single empty block — e.g.
+             * `<p><br></p>` left after the user deletes all the content.
+             * `contenteditable` keeps that caret container in the DOM, so by
+             * default the value getter returns it as-is; enable this to collapse
+             * it to `''` for form submission.
+             */
+            collapseEmptyValueToEmptyString: boolean;
             /**
              * Replace old tags to new eg. <i> to <em>, <b> to <strong>
              */

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

@@ -39,6 +39,12 @@ declare module 'jodit/config' {
              * Default value for the `Open in new tab` checkbox when inserting a new link.
              */
             openInNewTabCheckboxDefaultChecked: boolean;
+            /**
+             * Show an `aria-label` text input in the link dialog so an
+             * accessible name can be set on the `<a>` (useful when several
+             * links share the same visible text, e.g. "here"). Default: false.
+             */
+            ariaLabelInput: boolean;
             /**
              * Use an input text to ask the classname or a select or not ask
              */

package/types/plugins/select-cells/select-cells.d.ts

@@ -29,7 +29,7 @@ export declare class selectCells extends Plugin {
     /**
      * Mouse click inside the table
      */
-    protected onStartSelection(cell: HTMLTableCellElement): void | false;
+    protected onStartSelection(cell: HTMLTableCellElement, event?: MouseEvent): void | false;
     protected onOutsideClick(): void;
     protected onChange(): void;
     /**

package/types/types/uploader.d.ts

@@ -80,6 +80,29 @@ export interface IUploaderOptions<T> {
     getDisplayName(this: T, baseurl: string, filename: string): string;
     pathVariableName: string;
     withCredentials: boolean;
+    /**
+     * Called with the list of files right before they are uploaded (or read as
+     * base64). Return `false` to abort the whole upload — useful for client
+     * side validation (size, type, count). Throwing an Error also aborts and
+     * routes the message through the uploader error handler.
+     *
+     * ```javascript
+     * Jodit.make('#editor', {
+     * 	uploader: {
+     * 		url: '...',
+     * 		beforeUpload(files) {
+     * 			for (const file of files) {
+     * 				if (file.size > 2 * 1024 * 1024) {
+     * 					this.jodit.message.error('Max 2MB');
+     * 					return false;
+     * 				}
+     * 			}
+     * 		}
+     * 	}
+     * });
+     * ```
+     */
+    beforeUpload?: (this: T, files: File[]) => boolean | void;
     prepareData: (this: T, formData: FormData) => any;
     buildData?: (this: T, formData: any) => BuildDataResult;
     queryBuild?: (obj: string | IDictionary<string | object> | FormData, prefix?: string) => string | FormData;