jodit 4.6.6 → 4.6.10

package/es5/plugins/debug/debug.css

@@ -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.6.6
+ * Version: v4.6.10
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/debug/debug.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.6.6
+ * Version: v4.6.10
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/debug/debug.min.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.6.6
+ * Version: v4.6.10
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/speech-recognize/speech-recognize.css

@@ -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.6.6
+ * Version: v4.6.10
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/speech-recognize/speech-recognize.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.6.6
+ * Version: v4.6.10
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/es5/plugins/speech-recognize/speech-recognize.min.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.6.6
+ * Version: v4.6.10
  * Url: https://xdsoft.net/jodit/
  * License(s): MIT
  */

package/esm/core/constants.js

@@ -3,7 +3,7 @@
  * Released under MIT see LICENSE.txt in the project root for license information.
  * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
-export const APP_VERSION = "4.6.6";
+export const APP_VERSION = "4.6.10";
 // prettier-ignore
 export const ES = "es2020";
 export const IS_ES_MODERN = true;

package/esm/core/helpers/array/index.d.ts

@@ -7,5 +7,6 @@
  * @module helpers/array
  */
 export { asArray } from "./as-array";
+export { applyArrayReconciliation, reconcileArrays, type ReconcileResult } from "./reconcile-arrays";
 export { splitArray } from "./split-array";
 export { toArray } from "./to-array";

package/esm/core/helpers/array/index.js

@@ -7,5 +7,6 @@
  * @module helpers/array
  */
 export { asArray } from "./as-array.js";
+export { applyArrayReconciliation, reconcileArrays } from "./reconcile-arrays.js";
 export { splitArray } from "./split-array.js";
 export { toArray } from "./to-array.js";

package/esm/core/helpers/array/reconcile-arrays.d.ts

@@ -0,0 +1,54 @@
+/*!
+ * Jodit Editor (https://xdsoft.net/jodit/)
+ * Released under MIT see LICENSE.txt in the project root for license information.
+ * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+/**
+ * @module helpers/array
+ */
+export interface ReconcileResult<T> {
+    added: T[];
+    removed: T[];
+    kept: T[];
+    moved: Array<{
+        item: T;
+        from: number;
+        to: number;
+    }>;
+}
+/**
+ * Reconciles two arrays and returns the differences
+ * @param oldArray - The original array
+ * @param newArray - The new array to compare against
+ * @param keyFn - Optional function to generate unique keys for items (for object comparison)
+ * @returns Object containing added, removed, kept and moved items
+ *
+ * @example
+ * ```typescript
+ * const old = [1, 2, 3, 4];
+ * const new = [2, 4, 5, 1];
+ * const result = reconcileArrays(old, new);
+ * // result.added = [5]
+ * // result.removed = [3]
+ * // result.kept = [2, 4, 1]
+ * // result.moved = [{item: 1, from: 0, to: 3}]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const old = [{id: 1, name: 'a'}, {id: 2, name: 'b'}];
+ * const new = [{id: 2, name: 'b'}, {id: 3, name: 'c'}];
+ * const result = reconcileArrays(old, new, item => item.id);
+ * // result.added = [{id: 3, name: 'c'}]
+ * // result.removed = [{id: 1, name: 'a'}]
+ * ```
+ */
+export declare function reconcileArrays<T>(oldArray: T[], newArray: T[], keyFn?: (item: T) => string | number): ReconcileResult<T>;
+/**
+ * Applies reconciliation patches to transform one array into another
+ * @param oldArray - The original array to transform
+ * @param newArray - The target array structure
+ * @param keyFn - Optional function to generate unique keys for items
+ * @returns New array matching the structure of newArray
+ */
+export declare function applyArrayReconciliation<T>(oldArray: T[], newArray: T[], keyFn?: (item: T) => string | number): T[];

package/esm/core/helpers/array/reconcile-arrays.js

@@ -0,0 +1,103 @@
+/*!
+ * Jodit Editor (https://xdsoft.net/jodit/)
+ * Released under MIT see LICENSE.txt in the project root for license information.
+ * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+/**
+ * Reconciles two arrays and returns the differences
+ * @param oldArray - The original array
+ * @param newArray - The new array to compare against
+ * @param keyFn - Optional function to generate unique keys for items (for object comparison)
+ * @returns Object containing added, removed, kept and moved items
+ *
+ * @example
+ * ```typescript
+ * const old = [1, 2, 3, 4];
+ * const new = [2, 4, 5, 1];
+ * const result = reconcileArrays(old, new);
+ * // result.added = [5]
+ * // result.removed = [3]
+ * // result.kept = [2, 4, 1]
+ * // result.moved = [{item: 1, from: 0, to: 3}]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const old = [{id: 1, name: 'a'}, {id: 2, name: 'b'}];
+ * const new = [{id: 2, name: 'b'}, {id: 3, name: 'c'}];
+ * const result = reconcileArrays(old, new, item => item.id);
+ * // result.added = [{id: 3, name: 'c'}]
+ * // result.removed = [{id: 1, name: 'a'}]
+ * ```
+ */
+export function reconcileArrays(oldArray, newArray, keyFn) {
+    const getKey = keyFn || ((item) => item);
+    const oldMap = new Map();
+    const newMap = new Map();
+    oldArray.forEach((item, index) => {
+        oldMap.set(getKey(item), { item, index });
+    });
+    newArray.forEach((item, index) => {
+        newMap.set(getKey(item), { item, index });
+    });
+    const added = [];
+    const removed = [];
+    const kept = [];
+    const moved = [];
+    // Find removed items
+    oldMap.forEach((value, key) => {
+        if (!newMap.has(key)) {
+            removed.push(value.item);
+        }
+    });
+    // Find added items and track kept/moved items
+    newMap.forEach((value, key) => {
+        const oldItem = oldMap.get(key);
+        if (!oldItem) {
+            added.push(value.item);
+        }
+        else {
+            kept.push(value.item);
+            if (oldItem.index !== value.index) {
+                moved.push({
+                    item: value.item,
+                    from: oldItem.index,
+                    to: value.index
+                });
+            }
+        }
+    });
+    return {
+        added,
+        removed,
+        kept,
+        moved
+    };
+}
+/**
+ * Applies reconciliation patches to transform one array into another
+ * @param oldArray - The original array to transform
+ * @param newArray - The target array structure
+ * @param keyFn - Optional function to generate unique keys for items
+ * @returns New array matching the structure of newArray
+ */
+export function applyArrayReconciliation(oldArray, newArray, keyFn) {
+    const result = reconcileArrays(oldArray, newArray, keyFn);
+    const output = [];
+    // Build the new array based on newArray order
+    newArray.forEach(item => {
+        const key = keyFn ? keyFn(item) : item;
+        const isNew = result.added.some(addedItem => (keyFn ? keyFn(addedItem) : addedItem) === key);
+        if (isNew) {
+            output.push(item);
+        }
+        else {
+            // Use the old item reference if it exists
+            const oldItem = oldArray.find(oldItem => (keyFn ? keyFn(oldItem) : oldItem) === key);
+            if (oldItem !== undefined) {
+                output.push(oldItem);
+            }
+        }
+    });
+    return output;
+}

package/esm/core/ui/group/group.d.ts

@@ -30,13 +30,15 @@ export declare class UIGroup<T extends IViewBased = IViewBased> extends UIElemen
     /**
      * Append new element into group
      */
-    append(elm: IUIElement | IUIElement[], distElement?: string): this;
+    append(elm: IUIElement, index?: number): this;
+    append(elm: IUIElement, distElement?: string): this;
+    append(elm: IUIElement[], distElement?: string): this;
     /** @override */
     afterSetMod(name: string, value: ModType): void;
     /**
      * Allow set another container for the box of all children
      */
-    protected appendChildToContainer(childContainer: HTMLElement): void;
+    protected appendChildToContainer(childContainer: HTMLElement, index?: number): void;
     /**
      * Remove element from group
      */

package/esm/core/ui/group/group.js

@@ -18,7 +18,6 @@ import { Component } from "../../component/component.js";
 import { component, watch } from "../../decorators/index.js";
 import { Dom } from "../../dom/dom.js";
 import { isArray } from "../../helpers/index.js";
-import { assert } from "../../helpers/utils/assert.js";
 import { UIElement } from "../element.js";
 let UIGroup = UIGroup_1 = class UIGroup extends UIElement {
     className() {
@@ -53,25 +52,35 @@ let UIGroup = UIGroup_1 = class UIGroup extends UIElement {
         this.elements.forEach(elm => elm.update());
         this.setMod('size', this.buttonSize);
     }
-    /**
-     * Append new element into group
-     */
-    append(elm, distElement) {
-        if (isArray(elm)) {
-            elm.forEach(item => this.append(item, distElement));
+    append(elms, distElementOrIndex) {
+        if (isArray(elms)) {
+            if (typeof distElementOrIndex === 'number') {
+                throw new Error('You can not use index when append array of elements');
+            }
+            elms.forEach(item => this.append(item, distElementOrIndex));
             return this;
         }
-        this.elements.push(elm);
+        const elm = elms;
+        let index = undefined;
+        if (typeof distElementOrIndex === 'number') {
+            index = Math.min(Math.max(0, distElementOrIndex), this.elements.length);
+            this.elements.splice(index, 0, elm);
+        }
+        else {
+            this.elements.push(elm);
+        }
         if (elm.name) {
             elm.container.classList.add(this.getFullElName(elm.name));
         }
-        if (distElement) {
-            const distElm = this.getElm(distElement);
-            assert(distElm != null, 'Element does not exist');
+        if (distElementOrIndex && typeof distElementOrIndex === 'string') {
+            const distElm = this.getElm(distElementOrIndex);
+            if (distElm == null) {
+                throw new Error('Element does not exist');
+            }
             distElm.appendChild(elm.container);
         }
         else {
-            this.appendChildToContainer(elm.container);
+            this.appendChildToContainer(elm.container, index);
         }
         elm.parentElement = this;
         return this;
@@ -85,8 +94,16 @@ let UIGroup = UIGroup_1 = class UIGroup extends UIElement {
     /**
      * Allow set another container for the box of all children
      */
-    appendChildToContainer(childContainer) {
-        this.container.appendChild(childContainer);
+    appendChildToContainer(childContainer, index) {
+        if (index === undefined ||
+            index < 0 ||
+            index > this.elements.length - 1 ||
+            this.container.children[index] == null) {
+            this.container.appendChild(childContainer);
+        }
+        else {
+            this.container.insertBefore(childContainer, this.container.children[index]);
+        }
     }
     /**
      * Remove element from group

package/esm/types/ui.d.ts

@@ -59,7 +59,10 @@ export interface IUIButton extends IViewComponent, IUIElement, IFocusable {
 export interface IUIGroup extends IUIElement {
     readonly elements: IUIElement[];
     readonly allChildren: IUIElement[];
-    append(elm: IUIElement | IUIElement[], distElement?: string): this;
+    append(elm: IUIElement, index?: number): this;
+    append(elm: IUIElement, distElement?: string): this;
+    append(elms: IUIElement[], distElement?: string): this;
+    append(elm: IUIElement | IUIElement[], distElementOrIndex?: string | number): this;
     remove(elm: IUIElement): this;
     clear(): this;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jodit",
-	"version": "4.6.6",
+	"version": "4.6.10",
 	"description": "Jodit is an awesome and useful wysiwyg editor with filebrowser",
 	"main": "esm/index.js",
 	"types": "types/index.d.ts",

package/types/core/helpers/array/index.d.ts

@@ -7,5 +7,6 @@
  * @module helpers/array
  */
 export { asArray } from "./as-array";
+export { applyArrayReconciliation, reconcileArrays, type ReconcileResult } from "./reconcile-arrays";
 export { splitArray } from "./split-array";
 export { toArray } from "./to-array";

package/types/core/helpers/array/reconcile-arrays.d.ts

@@ -0,0 +1,54 @@
+/*!
+ * Jodit Editor (https://xdsoft.net/jodit/)
+ * Released under MIT see LICENSE.txt in the project root for license information.
+ * Copyright (c) 2013-2025 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+/**
+ * @module helpers/array
+ */
+export interface ReconcileResult<T> {
+    added: T[];
+    removed: T[];
+    kept: T[];
+    moved: Array<{
+        item: T;
+        from: number;
+        to: number;
+    }>;
+}
+/**
+ * Reconciles two arrays and returns the differences
+ * @param oldArray - The original array
+ * @param newArray - The new array to compare against
+ * @param keyFn - Optional function to generate unique keys for items (for object comparison)
+ * @returns Object containing added, removed, kept and moved items
+ *
+ * @example
+ * ```typescript
+ * const old = [1, 2, 3, 4];
+ * const new = [2, 4, 5, 1];
+ * const result = reconcileArrays(old, new);
+ * // result.added = [5]
+ * // result.removed = [3]
+ * // result.kept = [2, 4, 1]
+ * // result.moved = [{item: 1, from: 0, to: 3}]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const old = [{id: 1, name: 'a'}, {id: 2, name: 'b'}];
+ * const new = [{id: 2, name: 'b'}, {id: 3, name: 'c'}];
+ * const result = reconcileArrays(old, new, item => item.id);
+ * // result.added = [{id: 3, name: 'c'}]
+ * // result.removed = [{id: 1, name: 'a'}]
+ * ```
+ */
+export declare function reconcileArrays<T>(oldArray: T[], newArray: T[], keyFn?: (item: T) => string | number): ReconcileResult<T>;
+/**
+ * Applies reconciliation patches to transform one array into another
+ * @param oldArray - The original array to transform
+ * @param newArray - The target array structure
+ * @param keyFn - Optional function to generate unique keys for items
+ * @returns New array matching the structure of newArray
+ */
+export declare function applyArrayReconciliation<T>(oldArray: T[], newArray: T[], keyFn?: (item: T) => string | number): T[];

package/types/core/ui/group/group.d.ts

@@ -30,13 +30,15 @@ export declare class UIGroup<T extends IViewBased = IViewBased> extends UIElemen
     /**
      * Append new element into group
      */
-    append(elm: IUIElement | IUIElement[], distElement?: string): this;
+    append(elm: IUIElement, index?: number): this;
+    append(elm: IUIElement, distElement?: string): this;
+    append(elm: IUIElement[], distElement?: string): this;
     /** @override */
     afterSetMod(name: string, value: ModType): void;
     /**
      * Allow set another container for the box of all children
      */
-    protected appendChildToContainer(childContainer: HTMLElement): void;
+    protected appendChildToContainer(childContainer: HTMLElement, index?: number): void;
     /**
      * Remove element from group
      */

package/types/types/ui.d.ts

@@ -59,7 +59,10 @@ export interface IUIButton extends IViewComponent, IUIElement, IFocusable {
 export interface IUIGroup extends IUIElement {
     readonly elements: IUIElement[];
     readonly allChildren: IUIElement[];
-    append(elm: IUIElement | IUIElement[], distElement?: string): this;
+    append(elm: IUIElement, index?: number): this;
+    append(elm: IUIElement, distElement?: string): this;
+    append(elms: IUIElement[], distElement?: string): this;
+    append(elm: IUIElement | IUIElement[], distElementOrIndex?: string | number): this;
     remove(elm: IUIElement): this;
     clear(): this;
 }