@ckeditor/ckeditor5-image 48.0.1 → 48.1.0-alpha.0

package/dist/image/replaceimagesourcecommand.d.ts

@@ -2,11 +2,11 @@
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { Command, type Editor } from '@ckeditor/ckeditor5-core';
-import type { ModelWriter, ModelElement } from '@ckeditor/ckeditor5-engine';
 /**
  * @module image/image/replaceimagesourcecommand
  */
+import { Command, type Editor } from '@ckeditor/ckeditor5-core';
+import type { ModelWriter, ModelElement } from '@ckeditor/ckeditor5-engine';
 /**
  * Replace image source command.
  *

package/dist/imagestyle/converters.d.ts

@@ -5,9 +5,6 @@
 import type { DowncastAttributeEvent, UpcastElementEvent } from '@ckeditor/ckeditor5-engine';
 import { type GetCallback } from '@ckeditor/ckeditor5-utils';
 import type { ImageStyleOptionDefinition } from '../imageconfig.js';
-/**
- * @module image/imagestyle/converters
- */
 /**
  * Returns a converter for the `imageStyle` attribute. It can be used for adding, changing and removing the attribute.
  *

package/dist/imagestyle/utils.d.ts

@@ -50,6 +50,12 @@ export declare const DEFAULT_ICONS: Record<string, string>;
  * @internal
  */
 export declare const DEFAULT_DROPDOWN_DEFINITIONS: Array<ImageStyleDropdownDefinition>;
+/**
+ * Returns the style with a given `name` from an array of styles.
+ *
+ * @internal
+ */
+export declare function getStyleDefinitionByName(name: string, styles: Array<ImageStyleOptionDefinition>): ImageStyleOptionDefinition | undefined;
 /**
  * Returns a list of the normalized and validated image style options.
  *

package/dist/imageupload/uploadimagecommand.d.ts

@@ -4,9 +4,6 @@
  */
 import { Command, type Editor } from '@ckeditor/ckeditor5-core';
 import { type ArrayOrItem } from '@ckeditor/ckeditor5-utils';
-/**
- * @module image/imageupload/uploadimagecommand
- */
 /**
  * The upload image command.
  *

package/dist/index.js

@@ -382,7 +382,7 @@ const IMAGE_WIDGETS_CLASSES_MATCH_REGEXP = /^(image|image-inline)$/;
  */ function getInsertImageParent(selection, model) {
     const insertionRange = findOptimalInsertionRange(selection, model);
     const parent = insertionRange.start.parent;
-    if (parent.isEmpty && !parent.is('element', '$root')) {
+    if (parent.isEmpty && !parent.is('rootElement')) {
         return parent.parent;
     }
     return parent;
@@ -1419,8 +1419,6 @@ const IMAGE_URL_REGEXP = new RegExp(String(/^(http(s)?:\/\/)?[\w-]+\.[\w.~:/[\]@
 }
 
 /**
- * @module image/image/replaceimagesourcecommand
- */ /**
  * Replace image source command.
  *
  * Changes image source to the one provided. Can be executed as follows:
@@ -3481,8 +3479,6 @@ const IMAGE_URL_REGEXP = new RegExp(String(/^(http(s)?:\/\/)?[\w-]+\.[\w.~:/[\]@
 }
 
 /**
- * @module image/imageupload/uploadimagecommand
- */ /**
  * The upload image command.
  *
  * The command is registered by the {@link module:image/imageupload/imageuploadediting~ImageUploadEditing} plugin as `uploadImage`
@@ -5877,6 +5873,17 @@ const RESIZED_IMAGE_CLASS = 'image_resized';
         ]
     }
 ];
+/**
+ * Returns the style with a given `name` from an array of styles.
+ *
+ * @internal
+ */ function getStyleDefinitionByName(name, styles) {
+    for (const style of styles){
+        if (style.name === name) {
+            return style;
+        }
+    }
+}
 /**
  * Returns a list of the normalized and validated image style options.
  *
@@ -6063,8 +6070,6 @@ const RESIZED_IMAGE_CLASS = 'image_resized';
 };
 
 /**
- * @module image/imagestyle/converters
- */ /**
  * Returns a converter for the `imageStyle` attribute. It can be used for adding, changing and removing the attribute.
  *
  * @param styles An array containing available image style options.
@@ -6169,15 +6174,6 @@ const RESIZED_IMAGE_CLASS = 'image_resized';
         ]
     });
 }
-/**
- * Returns the style with a given `name` from an array of styles.
- */ function getStyleDefinitionByName(name, styles) {
-    for (const style of styles){
-        if (style.name === name) {
-            return style;
-        }
-    }
-}
 
 /**
  * The image style engine plugin. It sets the default configuration, creates converters and registers
@@ -6246,7 +6242,8 @@ const RESIZED_IMAGE_CLASS = 'image_resized';
                 allowAttributes: 'imageStyle'
             });
             schema.setAttributeProperties('imageStyle', {
-                isFormatting: true
+                isFormatting: true,
+                blockAlignment: getBlockAlignmentAttributeProperty(this.normalizedStyles)
             });
             // Converter for figure element from view to model.
             editor.data.upcastDispatcher.on('element:figure', viewToModelConverter, {
@@ -6303,6 +6300,47 @@ const RESIZED_IMAGE_CLASS = 'image_resized';
         });
     }
 }
+/**
+ * Returns a mapping of generic alignment values ('left', 'right', 'center') to their corresponding
+ * block image alignment style names.
+ *
+ * This function is particularly useful for scenarios like `td[align]` conversion, which needs to know
+ * exactly how to map a generic `align` attribute to the correct alignment value. This mapping is necessary
+ * because the actual alignment value can differ depending on the target element type (e.g., block images
+ * vs. tables).
+ *
+ * @param styles An array of available image style option definitions.
+ * @returns A record mapping basic alignments to their valid, block-specific style names.
+ */ function getBlockAlignmentAttributeProperty(styles) {
+    const pickFirstSupported = (...names)=>{
+        const found = names.map((name)=>getStyleDefinitionByName(name, styles)).find((definition)=>definition?.modelElements.includes('imageBlock'));
+        if (!found) {
+            return;
+        }
+        return {
+            isDefault: !!found.isDefault,
+            value: found.name
+        };
+    };
+    const candidates = {
+        left: [
+            'alignBlockLeft',
+            'alignLeft'
+        ],
+        right: [
+            'alignBlockRight',
+            'alignRight'
+        ],
+        center: [
+            'block',
+            'alignCenter'
+        ]
+    };
+    return Object.fromEntries(Object.entries(candidates).map(([align, names])=>[
+            align,
+            pickFirstSupported(...names)
+        ]).filter(([, resolved])=>resolved !== undefined));
+}
 
 /**
  * The image style UI plugin.