@ckeditor/ckeditor5-image 47.6.1-alpha.1 → 48.0.0-alpha.0

package/lang/translations/zh.po

@@ -1,196 +0,0 @@
-# Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
-#
-# Want to contribute to this file? Submit your changes via a GitHub Pull Request.
-#
-# Check out the official contributor's guide:
-# https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
-#
-msgid ""
-msgstr ""
-"Language: zh_TW\n"
-"Plural-Forms: nplurals=1; plural=0;\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-
-msgctxt "The label for the image widget."
-msgid "image widget"
-msgstr "圖片小工具"
-
-msgctxt "The label for the image style button that wraps text around the image."
-msgid "Wrap text"
-msgstr "文繞圖"
-
-msgctxt "The label for the image style button that breaks the text around the image."
-msgid "Break text"
-msgstr "上及下"
-
-msgctxt "The label for the image style button that places the image inside the line of text."
-msgid "In line"
-msgstr "行中"
-
-msgctxt "The label for the Side image option."
-msgid "Side image"
-msgstr "側邊圖片"
-
-msgctxt "The label for the Full size image option."
-msgid "Full size image"
-msgstr "完整尺寸圖片"
-
-msgctxt "The label for the Left aligned image option."
-msgid "Left aligned image"
-msgstr "向左對齊圖片"
-
-msgctxt "The label for the Centered image option."
-msgid "Centered image"
-msgstr "置中圖片"
-
-msgctxt "The label for the Right aligned image option."
-msgid "Right aligned image"
-msgstr "向右對齊圖片"
-
-msgctxt "The label for the Change image text alternative button."
-msgid "Change image text alternative"
-msgstr "修改圖片的替代文字"
-
-msgctxt "The label for the image text alternative input."
-msgid "Text alternative"
-msgstr "替代文字"
-
-msgctxt "The placeholder text for the image caption displayed when the caption is empty."
-msgid "Enter image caption"
-msgstr "輸入圖片說明"
-
-msgctxt "The label for the insert image toolbar button."
-msgid "Insert image"
-msgstr "插入圖片"
-
-msgctxt "The label for the replace image toolbar button."
-msgid "Replace image"
-msgstr "替換圖片"
-
-msgctxt "The label for the upload image from computer toolbar button with visible label in insert image dropdown."
-msgid "Upload from computer"
-msgstr "從電腦上傳"
-
-msgctxt "The label for the replace image by upload from computer toolbar button with visible label in insert image dropdown."
-msgid "Replace from computer"
-msgstr "從電腦替換"
-
-msgctxt "The label for the upload image from computer toolbar button."
-msgid "Upload image from computer"
-msgstr "從電腦上傳圖片"
-
-msgctxt "The label for the upload image from computer menu bar button (standalone button)."
-msgid "Image from computer"
-msgstr "來自電腦的圖片"
-
-msgctxt "The label for the upload image from computer menu bar button (inside 'Image' menu)."
-msgid "From computer"
-msgstr "從電腦"
-
-msgctxt "The label for the replace image by upload from computer toolbar button."
-msgid "Replace image from computer"
-msgstr "從電腦替換圖片"
-
-msgctxt "The title of the notification displayed when upload fails."
-msgid "Upload failed"
-msgstr "上傳失敗"
-
-msgctxt "The title of the notification displayed when there is no permission to upload assets."
-msgid "You have no image upload permissions."
-msgstr "您沒有圖片上傳權限。"
-
-msgctxt "The label used by assistive technologies describing an image toolbar attached to an image widget."
-msgid "Image toolbar"
-msgstr "圖片工具"
-
-msgctxt "The label used for the dropdown in the image toolbar containing defined resize options."
-msgid "Resize image"
-msgstr "縮放圖片"
-
-msgctxt "The label used for the standalone resize options buttons in the image toolbar."
-msgid "Resize image to %0"
-msgstr "縮放圖片到 %0"
-
-msgctxt "The accessibility label of the standalone image resize reset option button in the image toolbar for screen readers."
-msgid "Resize image to the original size"
-msgstr "縮放圖片到原始尺寸"
-
-msgctxt "The label for image resize balloon input."
-msgid "Resize image (in %0)"
-msgstr "調整圖片大小（單位為 %0）"
-
-msgctxt "The default label for the resize option that resets the size of the image."
-msgid "Original"
-msgstr "原始圖片"
-
-msgctxt "The accessibility label of the standalone image resize custom option button in the image toolbar for screen readers."
-msgid "Custom image size"
-msgstr "自訂圖片大小"
-
-msgctxt "The label for the resize option that allows user to enter custom size of the image."
-msgid "Custom"
-msgstr "自訂"
-
-msgctxt "The accessibility label of the image resize dropdown for screen readers."
-msgid "Image resize list"
-msgstr "圖片縮放清單"
-
-msgctxt "The input label for the Insert image via URL form."
-msgid "Insert image via URL"
-msgstr "使用連結插入圖片"
-
-msgctxt "The label for the insert image via url dropdown button."
-msgid "Insert via URL"
-msgstr "透過網址插入"
-
-msgctxt "The label for the insert image via url menu bar button (standalone button)."
-msgid "Image via URL"
-msgstr "透過網址插入圖片"
-
-msgctxt "The label for the insert image via url menu bar button (inside 'Image' menu)."
-msgid "Via URL"
-msgstr "透過網址"
-
-msgctxt "The input label for the Insert image via URL form for a pre-existing image."
-msgid "Update image URL"
-msgstr "更新圖片連結"
-
-msgctxt "Text used by screen readers do describe an image when the image has no text alternative."
-msgid "Caption for the image"
-msgstr "影像的標題"
-
-msgctxt "Text used by screen readers do describe an image when there is a text alternative available, e.g. 'Caption for image: this is a description of the image.'"
-msgid "Caption for image: %0"
-msgstr "影像標題：%0"
-
-msgctxt "Text used as error label when user submitted custom image resize form with blank value."
-msgid "The value must not be empty."
-msgstr "數值不得為空白。"
-
-msgctxt "Text used as error label when user submitted custom image resize form with incorrect value."
-msgid "The value should be a plain number."
-msgstr "數值應為純數字。"
-
-msgctxt "Aria status message indicating that the image is being uploaded. Example: 'Uploading image'."
-msgid "Uploading image"
-msgstr "正在上傳圖片"
-
-msgctxt "Aria status message indicating that the image has been uploaded successfully. Example: 'Image upload complete'."
-msgid "Image upload complete"
-msgstr "圖片上傳完成"
-
-msgctxt "Aria status message indicating that an error has occurred during image upload. Example: 'Error during image upload'."
-msgid "Error during image upload"
-msgstr "圖片上傳期間發生錯誤"
-
-msgctxt "Label for the widget inserted by the image feature (as in 'insert image')"
-msgid "Image"
-msgstr "圖片"
-
-msgctxt "The label for the header of the image resize balloon."
-msgid "Image Resize"
-msgstr "圖片調整大小"
-
-msgctxt "The label of the input field for the text alternative of the image."
-msgid "Text Alternative"
-msgstr "文字替代"

package/src/augmentation.js

@@ -1,5 +0,0 @@
-/**
- * @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
- */
-export {};

package/src/autoimage.js

@@ -1,148 +0,0 @@
-/**
- * @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
- */
-/**
- * @module image/autoimage
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { Clipboard } from 'ckeditor5/src/clipboard.js';
-import { ModelLivePosition, ModelLiveRange } from 'ckeditor5/src/engine.js';
-import { Undo } from 'ckeditor5/src/undo.js';
-import { Delete } from 'ckeditor5/src/typing.js';
-import { global } from 'ckeditor5/src/utils.js';
-import { ImageUtils } from './imageutils.js';
-// Implements the pattern: http(s)://(www.)example.com/path/to/resource.ext?query=params&maybe=too.
-const IMAGE_URL_REGEXP = new RegExp(String(/^(http(s)?:\/\/)?[\w-]+\.[\w.~:/[\]@!$&'()*+,;=%-]+/.source +
-    /\.(jpg|jpeg|png|gif|ico|webp|JPG|JPEG|PNG|GIF|ICO|WEBP)/.source +
-    /(\?[\w.~:/[\]@!$&'()*+,;=%-]*)?/.source +
-    /(#[\w.~:/[\]@!$&'()*+,;=%-]*)?$/.source));
-/**
- * The auto-image plugin. It recognizes image links in the pasted content and embeds
- * them shortly after they are injected into the document.
- */
-export class AutoImage extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [Clipboard, ImageUtils, Undo, Delete];
-    }
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'AutoImage';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin() {
-        return true;
-    }
-    /**
-     * The paste–to–embed `setTimeout` ID. Stored as a property to allow
-     * cleaning of the timeout.
-     */
-    _timeoutId;
-    /**
-     * The position where the `<imageBlock>` element will be inserted after the timeout,
-     * determined each time a new content is pasted into the document.
-     */
-    _positionToInsert;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor) {
-        super(editor);
-        this._timeoutId = null;
-        this._positionToInsert = null;
-    }
-    /**
-     * @inheritDoc
-     */
-    init() {
-        const editor = this.editor;
-        const modelDocument = editor.model.document;
-        const clipboardPipeline = editor.plugins.get('ClipboardPipeline');
-        // We need to listen on `Clipboard#inputTransformation` because we need to save positions of selection.
-        // After pasting, the content between those positions will be checked for a URL that could be transformed
-        // into an image.
-        this.listenTo(clipboardPipeline, 'inputTransformation', () => {
-            const firstRange = modelDocument.selection.getFirstRange();
-            const leftLivePosition = ModelLivePosition.fromPosition(firstRange.start);
-            leftLivePosition.stickiness = 'toPrevious';
-            const rightLivePosition = ModelLivePosition.fromPosition(firstRange.end);
-            rightLivePosition.stickiness = 'toNext';
-            modelDocument.once('change:data', () => {
-                this._embedImageBetweenPositions(leftLivePosition, rightLivePosition);
-                leftLivePosition.detach();
-                rightLivePosition.detach();
-            }, { priority: 'high' });
-        });
-        editor.commands.get('undo').on('execute', () => {
-            if (this._timeoutId) {
-                global.window.clearTimeout(this._timeoutId);
-                this._positionToInsert.detach();
-                this._timeoutId = null;
-                this._positionToInsert = null;
-            }
-        }, { priority: 'high' });
-    }
-    /**
-     * 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.
-     */
-    _embedImageBetweenPositions(leftPosition, rightPosition) {
-        const editor = this.editor;
-        // TODO: Use a marker instead of ModelLiveRange & LivePositions.
-        const urlRange = new ModelLiveRange(leftPosition, rightPosition);
-        const walker = urlRange.getWalker({ ignoreElementEnd: true });
-        const selectionAttributes = Object.fromEntries(editor.model.document.selection.getAttributes());
-        const imageUtils = this.editor.plugins.get('ImageUtils');
-        let src = '';
-        for (const node of walker) {
-            if (node.item.is('$textProxy')) {
-                src += node.item.data;
-            }
-        }
-        src = src.trim();
-        // If the URL does not match the image URL regexp, let's skip that.
-        if (!src.match(IMAGE_URL_REGEXP)) {
-            urlRange.detach();
-            return;
-        }
-        // Position will not be available in the `setTimeout` function so let's clone it.
-        this._positionToInsert = ModelLivePosition.fromPosition(leftPosition);
-        // This action mustn't be executed if undo was called between pasting and auto-embedding.
-        this._timeoutId = setTimeout(() => {
-            // Do nothing if image element cannot be inserted at the current position.
-            // See https://github.com/ckeditor/ckeditor5/issues/2763.
-            // Condition must be checked after timeout - pasting may take place on an element, replacing it. The final position matters.
-            const imageCommand = editor.commands.get('insertImage');
-            if (!imageCommand.isEnabled) {
-                urlRange.detach();
-                return;
-            }
-            editor.model.change(writer => {
-                this._timeoutId = null;
-                writer.remove(urlRange);
-                urlRange.detach();
-                let insertionPosition;
-                // Check if the position where the element should be inserted is still valid.
-                // Otherwise leave it as undefined to use the logic of insertImage().
-                if (this._positionToInsert.root.rootName !== '$graveyard') {
-                    insertionPosition = this._positionToInsert.toPosition();
-                }
-                imageUtils.insertImage({ ...selectionAttributes, src }, insertionPosition);
-                this._positionToInsert.detach();
-                this._positionToInsert = null;
-            });
-            const deletePlugin = editor.plugins.get('Delete');
-            deletePlugin.requestUndoOnBackspace();
-        }, 100);
-    }
-}

package/src/image/converters.js

@@ -1,236 +0,0 @@
-/**
- * @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 { first } from 'ckeditor5/src/utils.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 function upcastImageFigure(imageUtils) {
-    const converter = (evt, data, conversionApi) => {
-        // Do not convert if this is not an "image figure".
-        if (!conversionApi.consumable.test(data.viewItem, { name: true, classes: 'image' })) {
-            return;
-        }
-        // Find an image element inside the figure element.
-        const viewImage = imageUtils.findViewImgElement(data.viewItem);
-        // Do not convert if image element is absent or was already converted.
-        if (!viewImage || !conversionApi.consumable.test(viewImage, { name: true })) {
-            return;
-        }
-        // Consume the figure to prevent other converters from processing it again.
-        conversionApi.consumable.consume(data.viewItem, { name: true, classes: 'image' });
-        // Convert view image to model image.
-        const conversionResult = conversionApi.convertItem(viewImage, data.modelCursor);
-        // Get image element from conversion result.
-        const modelImage = first(conversionResult.modelRange.getItems());
-        // When image wasn't successfully converted then finish conversion.
-        if (!modelImage) {
-            // Revert consumed figure so other features can convert it.
-            conversionApi.consumable.revert(data.viewItem, { name: true, classes: 'image' });
-            return;
-        }
-        // Convert rest of the figure element's children as an image children.
-        conversionApi.convertChildren(data.viewItem, modelImage);
-        conversionApi.updateConversionResult(modelImage, data);
-    };
-    return dispatcher => {
-        dispatcher.on('element:figure', converter);
-    };
-}
-/**
- * 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 function upcastPicture(imageUtils) {
-    const sourceAttributeNames = ['srcset', 'media', 'type', 'sizes'];
-    const converter = (evt, data, conversionApi) => {
-        const pictureViewElement = data.viewItem;
-        // Do not convert <picture> if already consumed.
-        if (!conversionApi.consumable.test(pictureViewElement, { name: true })) {
-            return;
-        }
-        const sources = new Map();
-        // Collect all <source /> elements attribute values.
-        for (const childSourceElement of pictureViewElement.getChildren()) {
-            if (childSourceElement.is('element', 'source')) {
-                const attributes = {};
-                for (const name of sourceAttributeNames) {
-                    if (childSourceElement.hasAttribute(name)) {
-                        // Don't collect <source /> attribute if already consumed somewhere else.
-                        if (conversionApi.consumable.test(childSourceElement, { attributes: name })) {
-                            attributes[name] = childSourceElement.getAttribute(name);
-                        }
-                    }
-                }
-                if (Object.keys(attributes).length) {
-                    sources.set(childSourceElement, attributes);
-                }
-            }
-        }
-        const imgViewElement = imageUtils.findViewImgElement(pictureViewElement);
-        // Don't convert when a picture has no <img/> inside (it is broken).
-        if (!imgViewElement) {
-            return;
-        }
-        let modelImage = data.modelCursor.parent;
-        // - In case of an inline image (cursor parent in a <paragraph>), the <img/> must be converted right away
-        // because no converter handled it yet and otherwise there would be no model element to set the sources attribute on.
-        // - In case of a block image, the <figure class="image"> converter (in ImageBlockEditing) converts the
-        // <img/> right away on its own and the modelCursor is already inside an imageBlock and there's nothing special
-        // to do here.
-        if (!modelImage.is('element', 'imageBlock')) {
-            const conversionResult = conversionApi.convertItem(imgViewElement, data.modelCursor);
-            // Set image range as conversion result.
-            data.modelRange = conversionResult.modelRange;
-            // Continue conversion where image conversion ends.
-            data.modelCursor = conversionResult.modelCursor;
-            modelImage = first(conversionResult.modelRange.getItems());
-        }
-        conversionApi.consumable.consume(pictureViewElement, { name: true });
-        // Consume only these <source/> attributes that were actually collected and will be passed on
-        // to the image model element.
-        for (const [sourceElement, attributes] of sources) {
-            conversionApi.consumable.consume(sourceElement, { attributes: Object.keys(attributes) });
-        }
-        if (sources.size) {
-            conversionApi.writer.setAttribute('sources', Array.from(sources.values()), modelImage);
-        }
-        // Convert rest of the <picture> children as an image children. Other converters may want to consume them.
-        conversionApi.convertChildren(pictureViewElement, modelImage);
-    };
-    return dispatcher => {
-        dispatcher.on('element:picture', converter);
-    };
-}
-/**
- * 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 function downcastSrcsetAttribute(imageUtils, imageType) {
-    const converter = (evt, data, conversionApi) => {
-        if (!conversionApi.consumable.consume(data.item, evt.name)) {
-            return;
-        }
-        const writer = conversionApi.writer;
-        const element = conversionApi.mapper.toViewElement(data.item);
-        const img = imageUtils.findViewImgElement(element);
-        if (data.attributeNewValue === null) {
-            writer.removeAttribute('srcset', img);
-            writer.removeAttribute('sizes', img);
-        }
-        else {
-            if (data.attributeNewValue) {
-                writer.setAttribute('srcset', data.attributeNewValue, img);
-                // Always outputting `100vw`. See https://github.com/ckeditor/ckeditor5-image/issues/2.
-                writer.setAttribute('sizes', '100vw', img);
-            }
-        }
-    };
-    return dispatcher => {
-        dispatcher.on(`attribute:srcset:${imageType}`, converter);
-    };
-}
-/**
- * Converts the `source` model attribute to the `<picture><source /><source />...<img /></picture>`
- * view structure.
- *
- * @internal
- */
-export function downcastSourcesAttribute(imageUtils) {
-    const converter = (evt, data, conversionApi) => {
-        if (!conversionApi.consumable.consume(data.item, evt.name)) {
-            return;
-        }
-        const viewWriter = conversionApi.writer;
-        const element = conversionApi.mapper.toViewElement(data.item);
-        const imgElement = imageUtils.findViewImgElement(element);
-        const attributeNewValue = data.attributeNewValue;
-        if (attributeNewValue && attributeNewValue.length) {
-            // Collect all wrapping attribute elements.
-            const attributeElements = [];
-            let viewElement = imgElement.parent;
-            while (viewElement && viewElement.is('attributeElement')) {
-                const parentElement = viewElement.parent;
-                viewWriter.unwrap(viewWriter.createRangeOn(imgElement), viewElement);
-                attributeElements.unshift(viewElement);
-                viewElement = parentElement;
-            }
-            const hasPictureElement = imgElement.parent.is('element', 'picture');
-            // Reuse existing <picture> element (ckeditor5#17192) or create a new one.
-            const pictureElement = hasPictureElement ? imgElement.parent : viewWriter.createContainerElement('picture', null);
-            if (!hasPictureElement) {
-                viewWriter.insert(viewWriter.createPositionBefore(imgElement), pictureElement);
-            }
-            viewWriter.remove(viewWriter.createRangeIn(pictureElement));
-            viewWriter.insert(viewWriter.createPositionAt(pictureElement, 'end'), attributeNewValue.map(sourceAttributes => {
-                return viewWriter.createEmptyElement('source', sourceAttributes);
-            }));
-            viewWriter.move(viewWriter.createRangeOn(imgElement), viewWriter.createPositionAt(pictureElement, 'end'));
-            // Apply collected attribute elements over the new picture element.
-            for (const attributeElement of attributeElements) {
-                viewWriter.wrap(viewWriter.createRangeOn(pictureElement), attributeElement);
-            }
-        }
-        // Both setting "sources" to an empty array and removing the attribute should unwrap the <img />.
-        // Unwrap once if the latter followed the former, though.
-        else if (imgElement.parent.is('element', 'picture')) {
-            const pictureElement = imgElement.parent;
-            viewWriter.move(viewWriter.createRangeOn(imgElement), viewWriter.createPositionBefore(pictureElement));
-            viewWriter.remove(pictureElement);
-        }
-    };
-    return dispatcher => {
-        dispatcher.on('attribute:sources:imageBlock', converter);
-        dispatcher.on('attribute:sources:imageInline', converter);
-    };
-}
-/**
- * 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 function downcastImageAttribute(imageUtils, imageType, attributeKey) {
-    const converter = (evt, data, conversionApi) => {
-        if (!conversionApi.consumable.consume(data.item, evt.name)) {
-            return;
-        }
-        const viewWriter = conversionApi.writer;
-        const element = conversionApi.mapper.toViewElement(data.item);
-        const img = imageUtils.findViewImgElement(element);
-        viewWriter.setAttribute(data.attributeKey, data.attributeNewValue || '', img);
-    };
-    return dispatcher => {
-        dispatcher.on(`attribute:${attributeKey}:${imageType}`, converter);
-    };
-}