jodit 4.17.6 → 4.18.0

package/types/plugins/media/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/media
+ */
+import type { IDictionary, MediaWrapper } from "../../types/index";
 declare module 'jodit/config' {
     interface Config {
         /**
@@ -17,6 +21,27 @@ declare module 'jodit/config' {
          * Media tags
          */
         mediaBlocks: string[];
+        /**
+         * Wrappers that media keep in the content, by the media's tag name, such as
+         * Froala's `<span class="fr-video">` around video, audio and embeds. An
+         * element with a wrapper for its tag:
+         * - is wrapped in it instead of the editor-only `mediaFakeTag` when its tag
+         * is one of `mediaBlocks`, or left in it when it's already in one
+         * - goes in inside it when the video popup inserts it, as an upload, a
+         * link's embed or embed code that is one element
+         * - opens the media popup for its wrapper when clicked, whose Align and
+         * Delete act on the wrapper
+         *
+         * A wrapper is given `contenteditable="false"` and `draggable="true"`,
+         * which stay in the value.
+         * ```javascript
+         * const frVideo = { tag: 'span', className: 'fr-video' };
+         *
+         * Jodit.make('#editor', {
+         *   mediaWrappers: { video: frVideo, audio: frVideo, iframe: frVideo }
+         * });
+         * ```
+         */
+        mediaWrappers: IDictionary<MediaWrapper>;
     }
 }
-export {};

package/types/types/toolbar.d.ts

@@ -193,6 +193,8 @@ interface IControlType<T extends IViewBased = IJodit | IViewBased | IFileBrowser
     childTemplate?: (jodit: T, key: string, value: string, button: IToolbarButton) => string;
     /**
      * After click on the button it will show popup element which consist value that this function returned
+     * For a control with a `list`, the returned content replaces the list's buttons in its dropdown,
+     * and `false` keeps them
      * @example
      * ```javascript
      * var editor = Jodit.make('.editor', {

package/types/types/types.d.ts

@@ -187,10 +187,22 @@ export interface ImageEditorOptions {
 export type InsertMode = 'insert_as_html' | 'insert_as_text' | 'insert_clear_html' | 'insert_only_text';
 export type ImageAction = 'resize' | 'crop';
 export type ImageHAlign = 'normal' | 'left' | 'right' | 'center' | '';
+/**
+ * Class names for each alignment, see `alignClasses`. An alignment can list
+ * several sets of class names to recognise; aligning writes the first
+ */
+export type HAlignClasses = Partial<Record<Exclude<ImageHAlign, ''>, string | string[]>>;
 /**
  * Class names for each image alignment, see `imageAlignClasses`
  */
-export type ImageAlignClasses = Partial<Record<Exclude<ImageHAlign, ''>, string>>;
+export type ImageAlignClasses = HAlignClasses;
+/**
+ * A wrapper that media keep in the content, see `mediaWrappers`
+ */
+export interface MediaWrapper {
+    tag: string;
+    className: string;
+}
 export interface ImageBox {
     w: number;
     h: number;