@ckeditor/ckeditor5-image 41.3.0 → 41.4.0-alpha.0

package/dist/translations/tt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/tt.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"tt":{"dictionary":{"image widget":"","Wrap text":"","Break text":"","In line":"","Side image":"","Full size image":"","Left aligned image":"","Centered image":"","Right aligned image":"","Change image text alternative":"","Text alternative":"","Enter image caption":"","Insert image":"","Replace image":"","Upload from computer":"","Replace from computer":"","Upload image from computer":"","Image from computer":"","Replace image from computer":"","Upload failed":"","Image toolbar":"","Resize image":"","Resize image to %0":"","Resize image to the original size":"","Original":"","Image resize list":"","Insert":"","Update":"Яңарт","Insert image via URL":"","Update image URL":"","Caption for the image":"","Caption for image: %0":""},getPluralForm(n){return 0;}}}

package/dist/translations/ug.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/ug.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"ug":{"dictionary":{"image widget":"رەسىمچىك","Wrap text":"","Break text":"","In line":"","Side image":"يان رەسىم","Full size image":"ئەسلى چوڭلۇقتىكى رەسىم","Left aligned image":"سولغا توغۇرلانغان رەسىم","Centered image":"ئوتتۇردىكى رەسىم","Right aligned image":"ئوڭغا توغۇرلانغان رەسىم","Change image text alternative":"رەسىملىك تېكىست تاللىغۇچنى ئۆزگەرتىش","Text alternative":"تېكىست ئاملاشتۇرۇش","Enter image caption":"رەسىمنىڭ تېمىسىنى كىرگۈزۈڭ","Insert image":"رەسىم قىستۇرۇش","Replace image":"","Upload from computer":"","Replace from computer":"","Upload image from computer":"","Image from computer":"","Replace image from computer":"","Upload failed":"چىقىرىش مەغلۇپ بولدى","Image toolbar":"","Resize image":"","Resize image to %0":"","Resize image to the original size":"","Original":"","Image resize list":"","Insert":"قىستۇر","Update":"","Insert image via URL":"","Update image URL":"","Caption for the image":"","Caption for image: %0":""},getPluralForm(n){return (n != 1);}}}

package/dist/translations/uk.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/uk.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"uk":{"dictionary":{"image widget":"Віджет зображення","Wrap text":"Обернути текст","Break text":"Розірвати тексту","In line":"В тексті","Side image":"Бокове зображення","Full size image":"Повний розмір зображення","Left aligned image":"Зображення ліворуч","Centered image":"Зображення по центру","Right aligned image":"Зображення праворуч","Change image text alternative":"Змінити текстову альтернативу зображення","Text alternative":"Текстова альтернатива","Enter image caption":"Введіть підпис зображення","Insert image":"Вставити зображення","Replace image":"Замінити зображення","Upload from computer":"Завантажити з комп'ютера","Replace from computer":"Замінити з комп'ютера","Upload image from computer":"Завантажити зображення з комп'ютера","Image from computer":"Зображення з комп'ютера","Replace image from computer":"Замінити зображення з комп'ютера","Upload failed":"Завантаження не вдалось","Image toolbar":"Панелі інструментів зображення","Resize image":"Розтягнути зображення","Resize image to %0":"Розтягнути зображення до %0","Resize image to the original size":"Розтягнути зображення до оригінального розміру","Original":"Оригінал","Image resize list":"Перелік розмірів","Insert":"Вставити","Update":"Оновити","Insert image via URL":"Вставити зображення через посилання","Update image URL":"Оновити посилання на зображення","Caption for the image":"Підпис до зображення","Caption for image: %0":"Підпис до зображення: %0"},getPluralForm(n){return (n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3);}}}

package/dist/translations/ur.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/ur.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"ur":{"dictionary":{"image widget":"آلۂ عکس","Wrap text":"ملفوف متن","Break text":"متن تقسیم کریں","In line":"","Side image":"عکس بہ پہلو","Full size image":"مکمل پہمائش کا عکس","Left aligned image":"","Centered image":"","Right aligned image":"","Change image text alternative":"","Text alternative":"","Enter image caption":"","Insert image":"","Replace image":"","Upload from computer":"","Replace from computer":"","Upload image from computer":"","Image from computer":"","Replace image from computer":"","Upload failed":"","Image toolbar":"آلہ جات برائے عکس","Resize image":"","Resize image to %0":"","Resize image to the original size":"","Original":"","Image resize list":"","Insert":"","Update":"","Insert image via URL":"","Update image URL":"","Caption for the image":"","Caption for image: %0":""},getPluralForm(n){return (n != 1);}}}

package/dist/translations/uz.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/uz.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"uz":{"dictionary":{"image widget":"Tasvirlar vidjeti","Wrap text":"","Break text":"","In line":"","Side image":"Yon tasvir","Full size image":"Asl rasm hajmi","Left aligned image":"Chapga tekislash","Centered image":"Markazga tekislash","Right aligned image":"O'ngga tekislash","Change image text alternative":"Muqobil matnni tahrirlash","Text alternative":"Muqobil matn","Enter image caption":"Rasm sarlavhasi","Insert image":"Rasm kiritish","Replace image":"","Upload from computer":"","Replace from computer":"","Upload image from computer":"","Image from computer":"","Replace image from computer":"","Upload failed":"Yuklab olinmadi","Image toolbar":"Rasm asboblari paneli","Resize image":"Rasm hajmini o'zgartirish","Resize image to %0":"Rasm hajmini %0 ga o‘zgartirish","Resize image to the original size":"Rasmning o'lchamini asl o'lchamiga o'zgartiring","Original":"Asl","Image resize list":"Hajmlar ro'yxati","Insert":"Kiritish","Update":"O'zgartirish","Insert image via URL":"Rasmni URL orqali kiritish","Update image URL":"Rasm URL manzilini o'zgartirish","Caption for the image":"","Caption for image: %0":""},getPluralForm(n){return 0;}}}

package/dist/translations/vi.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/vi.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"vi":{"dictionary":{"image widget":"tiện ích ảnh","Wrap text":"Bọc văn bản","Break text":"Ngắt văn bản","In line":"Nội dòng","Side image":"Ảnh một bên","Full size image":"Ảnh đầy đủ","Left aligned image":"Ảnh canh trái","Centered image":"Ảnh canh giữa","Right aligned image":"Ảnh canh phải","Change image text alternative":"Đổi chữ alt của ảnh","Text alternative":"Chữ alt","Enter image caption":"Nhập mô tả ảnh","Insert image":"Chèn ảnh","Replace image":"Thay thế hình ảnh","Upload from computer":"Tải lên từ máy tính","Replace from computer":"Thay thế từ máy tính","Upload image from computer":"Tải hình ảnh lên từ máy tính","Image from computer":"Hình ảnh từ máy tính","Replace image from computer":"Thay thế hình ảnh từ máy tính","Upload failed":"Tải thất bại","Image toolbar":"Thanh công cụ hình ảnh","Resize image":"Chỉnh kích cỡ ảnh","Resize image to %0":"Chỉnh kích cỡ ảnh về %0","Resize image to the original size":"Chỉnh về ảnh kích cỡ nguyên gốc","Original":"Nguyên bản","Image resize list":"Danh sách ảnh đã chỉnh kích thước","Insert":"Chèn","Update":"Cập nhật","Insert image via URL":"Chèn ảnh từ URL","Update image URL":"Cập nhật ảnh từ URL","Caption for the image":"Chú thích cho hình ảnh","Caption for image: %0":"Chú thích cho hình ảnh: %0"},getPluralForm(n){return 0;}}}

package/dist/translations/zh-cn.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/zh-cn.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"zh-cn":{"dictionary":{"image widget":"图片组件","Wrap text":"文字环绕","Break text":"文字断行","In line":"行内","Side image":"图片侧边显示","Full size image":"全尺寸图片","Left aligned image":"图片左侧对齐","Centered image":"图片居中","Right aligned image":"图片右侧对齐","Change image text alternative":"更改图片替换文本","Text alternative":"替换文本","Enter image caption":"输入图片标题","Insert image":"插入图像","Replace image":"替换图片","Upload from computer":"从电脑上传","Replace from computer":"从电脑替换","Upload image from computer":"从电脑上传图片","Image from computer":"从计算机中选择图片","Replace image from computer":"从电脑替换图片","Upload failed":"上传失败","Image toolbar":"图片工具栏","Resize image":"调整图像大小","Resize image to %0":"调整图像大小为%0","Resize image to the original size":"调整图像大小为原始大小","Original":"原始大小","Image resize list":"图片大小列表","Insert":"插入","Update":"更新","Insert image via URL":"通过URL地址插入图片","Update image URL":"更新图片URL地址","Caption for the image":"图片说明：","Caption for image: %0":"图片说明：%0"},getPluralForm(n){return 0;}}}

package/dist/translations/zh.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+
+import type { Translations } from 'ckeditor5';
+declare const translations: Translations;
+export default translations;

package/dist/translations/zh.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export default {"zh":{"dictionary":{"image widget":"圖片小工具","Wrap text":"文繞圖","Break text":"上及下","In line":"行中","Side image":"側邊圖片","Full size image":"完整尺寸圖片","Left aligned image":"向左對齊圖片","Centered image":"置中圖片","Right aligned image":"向右對齊圖片","Change image text alternative":"修改圖片的替代文字","Text alternative":"替代文字","Enter image caption":"輸入圖片說明","Insert image":"插入圖片","Replace image":"替換圖片","Upload from computer":"從電腦上傳","Replace from computer":"從電腦替換","Upload image from computer":"從電腦上傳圖片","Image from computer":"來自電腦的圖片","Replace image from computer":"從電腦替換圖片","Upload failed":"上傳失敗","Image toolbar":"圖片工具","Resize image":"縮放圖片","Resize image to %0":"縮放圖片到 %0","Resize image to the original size":"縮放圖片到原始尺寸","Original":"原始圖片","Image resize list":"圖片縮放清單","Insert":"插入","Update":"更新","Insert image via URL":"使用連結插入圖片","Update image URL":"更新圖片連結","Caption for the image":"影像的標題","Caption for image: %0":"影像標題：%0"},getPluralForm(n){return 0;}}}

package/dist/types/augmentation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { ImageConfig, AutoImage, Image, ImageBlock, ImageCaption, ImageInline, ImageInsert, ImageInsertViaUrl, ImageResize, ImageStyle, ImageTextAlternative, ImageToolbar, ImageUpload, ImageUtils, ImageBlockEditing, ImageEditing, ImageCaptionEditing, ImageCaptionUI, ImageCaptionUtils, ImageInsertUI, ImageResizeEditing, ImageCustomResizeUI, ImageSizeAttributes, ImageStyleEditing, ImageStyleUI, ImageTextAlternativeEditing, ImageTextAlternativeUI, ImageUploadEditing, ImageUploadProgress, ImageUploadUI, ImageTypeCommand, InsertImageCommand, ReplaceImageSourceCommand, ToggleImageCaptionCommand, ResizeImageCommand, ImageStyleCommand, ImageTextAlternativeCommand, UploadImageCommand } from './index.js';
+declare module '@ckeditor/ckeditor5-core' {
+    interface EditorConfig {
+        /**
+         * The configuration of the image features. Used by the image features in the `@ckeditor/ckeditor5-image` package.
+         *
+         * Read more in {@link module:image/imageconfig~ImageConfig}.
+         */
+        image?: ImageConfig;
+    }
+    interface PluginsMap {
+        [AutoImage.pluginName]: AutoImage;
+        [Image.pluginName]: Image;
+        [ImageBlock.pluginName]: ImageBlock;
+        [ImageCaption.pluginName]: ImageCaption;
+        [ImageInline.pluginName]: ImageInline;
+        [ImageInsert.pluginName]: ImageInsert;
+        [ImageInsertViaUrl.pluginName]: ImageInsertViaUrl;
+        [ImageResize.pluginName]: ImageResize;
+        [ImageStyle.pluginName]: ImageStyle;
+        [ImageTextAlternative.pluginName]: ImageTextAlternative;
+        [ImageToolbar.pluginName]: ImageToolbar;
+        [ImageUpload.pluginName]: ImageUpload;
+        [ImageUtils.pluginName]: ImageUtils;
+        [ImageBlockEditing.pluginName]: ImageBlockEditing;
+        [ImageEditing.pluginName]: ImageEditing;
+        [ImageCaptionEditing.pluginName]: ImageCaptionEditing;
+        [ImageCaptionUI.pluginName]: ImageCaptionUI;
+        [ImageCaptionUtils.pluginName]: ImageCaptionUtils;
+        [ImageInsertUI.pluginName]: ImageInsertUI;
+        [ImageResizeEditing.pluginName]: ImageResizeEditing;
+        [ImageCustomResizeUI.pluginName]: ImageCustomResizeUI;
+        [ImageSizeAttributes.pluginName]: ImageSizeAttributes;
+        [ImageStyleEditing.pluginName]: ImageStyleEditing;
+        [ImageStyleUI.pluginName]: ImageStyleUI;
+        [ImageTextAlternativeEditing.pluginName]: ImageTextAlternativeEditing;
+        [ImageTextAlternativeUI.pluginName]: ImageTextAlternativeUI;
+        [ImageUploadEditing.pluginName]: ImageUploadEditing;
+        [ImageUploadProgress.pluginName]: ImageUploadProgress;
+        [ImageUploadUI.pluginName]: ImageUploadUI;
+    }
+    interface CommandsMap {
+        imageTypeBlock: ImageTypeCommand;
+        imageTypeInline: ImageTypeCommand;
+        insertImage: InsertImageCommand;
+        replaceImageSource: ReplaceImageSourceCommand;
+        toggleImageCaption: ToggleImageCaptionCommand;
+        resizeImage: ResizeImageCommand;
+        imageStyle: ImageStyleCommand;
+        imageTextAlternative: ImageTextAlternativeCommand;
+        uploadImage: UploadImageCommand;
+    }
+}

package/dist/types/autoimage.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/autoimage
+ */
+import { Plugin, type Editor } from 'ckeditor5/src/core.js';
+import { Clipboard } from 'ckeditor5/src/clipboard.js';
+import { Undo } from 'ckeditor5/src/undo.js';
+import { Delete } from 'ckeditor5/src/typing.js';
+import ImageUtils from './imageutils.js';
+/**
+ * The auto-image plugin. It recognizes image links in the pasted content and embeds
+ * them shortly after they are injected into the document.
+ */
+export default class AutoImage extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof Clipboard, typeof ImageUtils, typeof Undo, typeof Delete];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "AutoImage";
+    /**
+     * The paste–to–embed `setTimeout` ID. Stored as a property to allow
+     * cleaning of the timeout.
+     */
+    private _timeoutId;
+    /**
+     * The position where the `<imageBlock>` element will be inserted after the timeout,
+     * determined each time a new content is pasted into the document.
+     */
+    private _positionToInsert;
+    /**
+     * @inheritDoc
+     */
+    constructor(editor: Editor);
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Analyzes the part of the document between provided positions in search for a URL representing an image.
+     * When the URL is found, it is automatically converted into an image.
+     *
+     * @param leftPosition Left position of the selection.
+     * @param rightPosition Right position of the selection.
+     */
+    private _embedImageBetweenPositions;
+}

package/dist/types/image/converters.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/image/converters
+ */
+import type { DowncastDispatcher, UpcastDispatcher } from 'ckeditor5/src/engine.js';
+import type ImageUtils from '../imageutils.js';
+/**
+ * Returns a function that converts the image view representation:
+ *
+ * ```html
+ * <figure class="image"><img src="..." alt="..."></img></figure>
+ * ```
+ *
+ * to the model representation:
+ *
+ * ```html
+ * <imageBlock src="..." alt="..."></imageBlock>
+ * ```
+ *
+ * The entire content of the `<figure>` element except the first `<img>` is being converted as children
+ * of the `<imageBlock>` model element.
+ *
+ * @internal
+ */
+export declare function upcastImageFigure(imageUtils: ImageUtils): (dispatcher: UpcastDispatcher) => void;
+/**
+ * Returns a function that converts the image view representation:
+ *
+ * ```html
+ * <picture><source ... /><source ... />...<img ... /></picture>
+ * ```
+ *
+ * to the model representation as the `sources` attribute:
+ *
+ * ```html
+ * <image[Block|Inline] ... sources="..."></image[Block|Inline]>
+ * ```
+ *
+ * @internal
+ */
+export declare function upcastPicture(imageUtils: ImageUtils): (dispatcher: UpcastDispatcher) => void;
+/**
+ * Converter used to convert the `srcset` model image attribute to the `srcset` and `sizes` attributes in the view.
+ *
+ * @internal
+ * @param imageType The type of the image.
+ */
+export declare function downcastSrcsetAttribute(imageUtils: ImageUtils, imageType: 'imageBlock' | 'imageInline'): (dispatcher: DowncastDispatcher) => void;
+/**
+ * Converts the `source` model attribute to the `<picture><source /><source />...<img /></picture>`
+ * view structure.
+ *
+ * @internal
+ */
+export declare function downcastSourcesAttribute(imageUtils: ImageUtils): (dispatcher: DowncastDispatcher) => void;
+/**
+ * Converter used to convert a given image attribute from the model to the view.
+ *
+ * @internal
+ * @param imageType The type of the image.
+ * @param attributeKey The name of the attribute to convert.
+ */
+export declare function downcastImageAttribute(imageUtils: ImageUtils, imageType: 'imageBlock' | 'imageInline', attributeKey: string): (dispatcher: DowncastDispatcher) => void;

package/dist/types/image/imageblockediting.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/image/imageblockediting
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import { ClipboardPipeline } from 'ckeditor5/src/clipboard.js';
+import ImageEditing from './imageediting.js';
+import ImageSizeAttributes from '../imagesizeattributes.js';
+import ImageUtils from '../imageutils.js';
+import ImagePlaceholder from './imageplaceholder.js';
+/**
+ * The image block plugin.
+ *
+ * It registers:
+ *
+ * * `<imageBlock>` as a block element in the document schema, and allows `alt`, `src` and `srcset` attributes.
+ * * converters for editing and data pipelines.,
+ * * {@link module:image/image/imagetypecommand~ImageTypeCommand `'imageTypeBlock'`} command that converts inline images into
+ * block images.
+ */
+export default class ImageBlockEditing extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ImageEditing, typeof ImageSizeAttributes, typeof ImageUtils, typeof ImagePlaceholder, typeof ClipboardPipeline];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "ImageBlockEditing";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Configures conversion pipelines to support upcasting and downcasting
+     * block images (block image widgets) and their attributes.
+     */
+    private _setupConversion;
+    /**
+     * Integrates the plugin with the clipboard pipeline.
+     *
+     * Idea is that the feature should recognize the user's intent when an **inline** image is
+     * pasted or dropped. If such an image is pasted/dropped:
+     *
+     * * into an empty block (e.g. an empty paragraph),
+     * * on another object (e.g. some block widget).
+     *
+     * it gets converted into a block image on the fly. We assume this is the user's intent
+     * if they decided to put their image there.
+     *
+     * See the `ImageInlineEditing` for the similar integration that works in the opposite direction.
+     *
+     * The feature also sets image `width` and `height` attributes on paste.
+     */
+    private _setupClipboardIntegration;
+}

package/dist/types/image/imageediting.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/image/imageediting
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import ImageUtils from '../imageutils.js';
+/**
+ * The image engine plugin. This module loads common code shared between
+ * {@link module:image/image/imageinlineediting~ImageInlineEditing} and
+ * {@link module:image/image/imageblockediting~ImageBlockEditing} plugins.
+ *
+ * This plugin registers the {@link module:image/image/insertimagecommand~InsertImageCommand 'insertImage'} command.
+ */
+export default class ImageEditing extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ImageUtils];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "ImageEditing";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/dist/types/image/imageinlineediting.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/image/imageinlineediting
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import { ClipboardPipeline } from 'ckeditor5/src/clipboard.js';
+import ImageEditing from './imageediting.js';
+import ImageSizeAttributes from '../imagesizeattributes.js';
+import ImageUtils from '../imageutils.js';
+import ImagePlaceholder from './imageplaceholder.js';
+/**
+ * The image inline plugin.
+ *
+ * It registers:
+ *
+ * * `<imageInline>` as an inline element in the document schema, and allows `alt`, `src` and `srcset` attributes.
+ * * converters for editing and data pipelines.
+ * * {@link module:image/image/imagetypecommand~ImageTypeCommand `'imageTypeInline'`} command that converts block images into
+ * inline images.
+ */
+export default class ImageInlineEditing extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ImageEditing, typeof ImageSizeAttributes, typeof ImageUtils, typeof ImagePlaceholder, typeof ClipboardPipeline];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "ImageInlineEditing";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Configures conversion pipelines to support upcasting and downcasting
+     * inline images (inline image widgets) and their attributes.
+     */
+    private _setupConversion;
+    /**
+     * Integrates the plugin with the clipboard pipeline.
+     *
+     * Idea is that the feature should recognize the user's intent when an **block** image is
+     * pasted or dropped. If such an image is pasted/dropped into a non-empty block
+     * (e.g. a paragraph with some text) it gets converted into an inline image on the fly.
+     *
+     * We assume this is the user's intent if they decided to put their image there.
+     *
+     * **Note**: If a block image has a caption, it will not be converted to an inline image
+     * to avoid the confusion. Captions are added on purpose and they should never be lost
+     * in the clipboard pipeline.
+     *
+     * See the `ImageBlockEditing` for the similar integration that works in the opposite direction.
+     *
+     * The feature also sets image `width` and `height` attributes when pasting.
+     */
+    private _setupClipboardIntegration;
+}

package/dist/types/image/imageloadobserver.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/image/imageloadobserver
+ */
+import { Observer } from 'ckeditor5/src/engine.js';
+/**
+ * Observes all new images added to the {@link module:engine/view/document~Document},
+ * fires {@link module:engine/view/document~Document#event:imageLoaded} and
+ * {@link module:engine/view/document~Document#event:layoutChanged} event every time when the new image
+ * has been loaded.
+ *
+ * **Note:** This event is not fired for images that has been added to the document and rendered as `complete` (already loaded).
+ */
+export default class ImageLoadObserver extends Observer {
+    /**
+     * @inheritDoc
+     */
+    observe(domRoot: HTMLElement): void;
+    /**
+     * @inheritDoc
+     */
+    stopObserving(domRoot: HTMLElement): void;
+    /**
+     * Fires {@link module:engine/view/document~Document#event:layoutChanged} and
+     * {@link module:engine/view/document~Document#event:imageLoaded}
+     * if observer {@link #isEnabled is enabled}.
+     *
+     * @param domEvent The DOM event.
+     */
+    private _fireEvents;
+}
+/**
+ * Fired when an <img/> DOM element has been loaded in the DOM root.
+ *
+ * Introduced by {@link module:image/image/imageloadobserver~ImageLoadObserver}.
+ *
+ * @see module:image/image/imageloadobserver~ImageLoadObserver
+ *
+ * @eventName module:engine/view/document~Document#imageLoaded
+ * @param data Event data.
+ */
+export type ImageLoadedEvent = {
+    name: 'imageLoaded';
+    args: [Event];
+};

package/dist/types/image/imageplaceholder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module image/image/imageplaceholder
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import ImageUtils from '../imageutils.js';
+import '../../theme/imageplaceholder.css';
+/**
+ * Adds support for image placeholder that is automatically removed when the image is loaded.
+ */
+export default class ImagePlaceholder extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ImageUtils];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "ImagePlaceholder";
+    /**
+     * @inheritDoc
+     */
+    afterInit(): void;
+    /**
+     * Extends model schema.
+     */
+    private _setupSchema;
+    /**
+     * Registers converters.
+     */
+    private _setupConversion;
+    /**
+     * Prepares listener for image load.
+     */
+    private _setupLoadListener;
+}