@ckeditor/ckeditor5-upload 41.3.1 → 41.4.0

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":{"Upload in progress":"آپلوڈ جاری ہے"},getPluralForm(n){return (n != 1);}}}

package/dist/translations/ur.umd.js

@@ -0,0 +1,11 @@
+/**
+ * @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
+ */
+
+( e => {
+const { [ 'ur' ]: { dictionary, getPluralForm } } = {"ur":{"dictionary":{"Upload in progress":"آپلوڈ جاری ہے"},getPluralForm(n){return (n != 1);}}};
+e[ 'ur' ] ||= { dictionary: {}, getPluralForm: null };
+e[ 'ur' ].dictionary = Object.assign( e[ 'ur' ].dictionary, dictionary );
+e[ 'ur' ].getPluralForm = getPluralForm;
+} )( window.CKEDITOR_TRANSLATIONS ||= {} );

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":{"Upload in progress":"Yuklanmoqda"},getPluralForm(n){return 0;}}}

package/dist/translations/uz.umd.js

@@ -0,0 +1,11 @@
+/**
+ * @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
+ */
+
+( e => {
+const { [ 'uz' ]: { dictionary, getPluralForm } } = {"uz":{"dictionary":{"Upload in progress":"Yuklanmoqda"},getPluralForm(n){return 0;}}};
+e[ 'uz' ] ||= { dictionary: {}, getPluralForm: null };
+e[ 'uz' ].dictionary = Object.assign( e[ 'uz' ].dictionary, dictionary );
+e[ 'uz' ].getPluralForm = getPluralForm;
+} )( window.CKEDITOR_TRANSLATIONS ||= {} );

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":{"Upload in progress":"Đang tải lên"},getPluralForm(n){return 0;}}}

package/dist/translations/vi.umd.js

@@ -0,0 +1,11 @@
+/**
+ * @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
+ */
+
+( e => {
+const { [ 'vi' ]: { dictionary, getPluralForm } } = {"vi":{"dictionary":{"Upload in progress":"Đang tải lên"},getPluralForm(n){return 0;}}};
+e[ 'vi' ] ||= { dictionary: {}, getPluralForm: null };
+e[ 'vi' ].dictionary = Object.assign( e[ 'vi' ].dictionary, dictionary );
+e[ 'vi' ].getPluralForm = getPluralForm;
+} )( window.CKEDITOR_TRANSLATIONS ||= {} );

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":{"Upload in progress":"正在上传"},getPluralForm(n){return 0;}}}

package/dist/translations/zh-cn.umd.js

@@ -0,0 +1,11 @@
+/**
+ * @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
+ */
+
+( e => {
+const { [ 'zh-cn' ]: { dictionary, getPluralForm } } = {"zh-cn":{"dictionary":{"Upload in progress":"正在上传"},getPluralForm(n){return 0;}}};
+e[ 'zh-cn' ] ||= { dictionary: {}, getPluralForm: null };
+e[ 'zh-cn' ].dictionary = Object.assign( e[ 'zh-cn' ].dictionary, dictionary );
+e[ 'zh-cn' ].getPluralForm = getPluralForm;
+} )( window.CKEDITOR_TRANSLATIONS ||= {} );

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":{"Upload in progress":"正在上傳"},getPluralForm(n){return 0;}}}

package/dist/translations/zh.umd.js

@@ -0,0 +1,11 @@
+/**
+ * @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
+ */
+
+( e => {
+const { [ 'zh' ]: { dictionary, getPluralForm } } = {"zh":{"dictionary":{"Upload in progress":"正在上傳"},getPluralForm(n){return 0;}}};
+e[ 'zh' ] ||= { dictionary: {}, getPluralForm: null };
+e[ 'zh' ].dictionary = Object.assign( e[ 'zh' ].dictionary, dictionary );
+e[ 'zh' ].getPluralForm = getPluralForm;
+} )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/types/adapters/base64uploadadapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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 upload/adapters/base64uploadadapter
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import FileRepository from '../filerepository.js';
+/**
+ * A plugin that converts images inserted into the editor into [Base64 strings](https://en.wikipedia.org/wiki/Base64)
+ * in the {@glink installation/getting-started/getting-and-setting-data editor output}.
+ *
+ * This kind of image upload does not require server processing – images are stored with the rest of the text and
+ * displayed by the web browser without additional requests.
+ *
+ * Check out the {@glink features/images/image-upload/image-upload comprehensive "Image upload overview"} to learn about
+ * other ways to upload images into CKEditor 5.
+ */
+export default class Base64UploadAdapter extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof FileRepository];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "Base64UploadAdapter";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/dist/types/adapters/simpleuploadadapter.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 upload/adapters/simpleuploadadapter
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import FileRepository from '../filerepository.js';
+/**
+ * The Simple upload adapter allows uploading images to an application running on your server using
+ * the [`XMLHttpRequest`](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest) API with a
+ * minimal {@link module:upload/uploadconfig~SimpleUploadConfig editor configuration}.
+ *
+ * ```ts
+ * ClassicEditor
+ * 	.create( document.querySelector( '#editor' ), {
+ * 		simpleUpload: {
+ * 			uploadUrl: 'http://example.com',
+ * 			headers: {
+ * 				...
+ * 			}
+ * 		}
+ * 	} )
+ * 	.then( ... )
+ * 	.catch( ... );
+ * ```
+ *
+ * See the {@glink features/images/image-upload/simple-upload-adapter "Simple upload adapter"} guide to learn how to
+ * learn more about the feature (configuration, server–side requirements, etc.).
+ *
+ * Check out the {@glink features/images/image-upload/image-upload comprehensive "Image upload overview"} to learn about
+ * other ways to upload images into CKEditor 5.
+ */
+export default class SimpleUploadAdapter extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof FileRepository];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "SimpleUploadAdapter";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/dist/types/augmentation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @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 { SimpleUploadConfig, FileRepository, SimpleUploadAdapter, Base64UploadAdapter } from './index.js';
+declare module '@ckeditor/ckeditor5-core' {
+    interface EditorConfig {
+        /**
+         * The configuration of the {@link module:upload/adapters/simpleuploadadapter~SimpleUploadAdapter simple upload adapter}.
+         *
+         * Read more in {@link module:upload/uploadconfig~SimpleUploadConfig}.
+         */
+        simpleUpload?: SimpleUploadConfig;
+    }
+    interface PluginsMap {
+        [FileRepository.pluginName]: FileRepository;
+        [SimpleUploadAdapter.pluginName]: SimpleUploadAdapter;
+        [Base64UploadAdapter.pluginName]: Base64UploadAdapter;
+    }
+}

package/dist/types/filereader.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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
+ */
+declare const FileReader_base: {
+    new (): import("@ckeditor/ckeditor5-utils").Observable;
+    prototype: import("@ckeditor/ckeditor5-utils").Observable;
+};
+/**
+ * Wrapper over the native `FileReader`.
+ */
+export default class FileReader extends FileReader_base {
+    total: number;
+    /**
+     * Instance of native FileReader.
+     */
+    private readonly _reader;
+    /**
+     * Holds the data of an already loaded file. The file must be first loaded
+     * by using {@link module:upload/filereader~FileReader#read `read()`}.
+     */
+    private _data?;
+    /**
+     * Number of bytes loaded.
+     *
+     * @readonly
+     * @observable
+     */
+    loaded: number;
+    /**
+     * Creates an instance of the FileReader.
+     */
+    constructor();
+    /**
+     * Returns error that occurred during file reading.
+     */
+    get error(): DOMException | null;
+    /**
+     * Holds the data of an already loaded file. The file must be first loaded
+     * by using {@link module:upload/filereader~FileReader#read `read()`}.
+     */
+    get data(): string | undefined;
+    /**
+     * Reads the provided file.
+     *
+     * @param file Native File object.
+     * @returns Returns a promise that will be resolved with file's content.
+     * The promise will be rejected in case of an error or when the reading process is aborted.
+     */
+    read(file: File): Promise<string>;
+    /**
+     * Aborts file reader.
+     */
+    abort(): void;
+}
+export {};

package/dist/types/filerepository.d.ts

@@ -0,0 +1,346 @@
+/**
+ * @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 upload/filerepository
+ */
+import { Plugin, PendingActions } from '@ckeditor/ckeditor5-core';
+import { Collection } from '@ckeditor/ckeditor5-utils';
+/**
+ * File repository plugin. A central point for managing file upload.
+ *
+ * To use it, first you need an upload adapter. Upload adapter's job is to handle communication with the server
+ * (sending the file and handling server's response). You can use one of the existing plugins introducing upload adapters
+ * (e.g. {@link module:easy-image/cloudservicesuploadadapter~CloudServicesUploadAdapter} or
+ * {@link module:adapter-ckfinder/uploadadapter~CKFinderUploadAdapter}) or write your own one – see
+ * the {@glink framework/deep-dive/upload-adapter Custom image upload adapter deep-dive} guide.
+ *
+ * Then, you can use {@link module:upload/filerepository~FileRepository#createLoader `createLoader()`} and the returned
+ * {@link module:upload/filerepository~FileLoader} instance to load and upload files.
+ */
+export default class FileRepository extends Plugin {
+    /**
+     * Collection of loaders associated with this repository.
+     */
+    loaders: Collection<FileLoader>;
+    /**
+     * A factory function which should be defined before using `FileRepository`.
+     *
+     * It should return a new instance of {@link module:upload/filerepository~UploadAdapter} that will be used to upload files.
+     * {@link module:upload/filerepository~FileLoader} instance associated with the adapter
+     * will be passed to that function.
+     *
+     * For more information and example see {@link module:upload/filerepository~UploadAdapter}.
+     */
+    createUploadAdapter?: (loader: FileLoader) => UploadAdapter;
+    /**
+     * Loaders mappings used to retrieve loaders references.
+     */
+    private _loadersMap;
+    /**
+     * Reference to a pending action registered in a {@link module:core/pendingactions~PendingActions} plugin
+     * while upload is in progress. When there is no upload then value is `null`.
+     */
+    private _pendingAction;
+    /**
+     * Number of bytes uploaded.
+     *
+     * @readonly
+     * @observable
+     */
+    uploaded: number;
+    /**
+     * Number of total bytes to upload.
+     *
+     * It might be different than the file size because of headers and additional data.
+     * It contains `null` if value is not available yet, so it's better to use {@link #uploadedPercent} to monitor
+     * the progress.
+     *
+     * @readonly
+     * @observable
+     */
+    uploadTotal: number | null;
+    /**
+     * Upload progress in percents.
+     *
+     * @readonly
+     * @observable
+     */
+    uploadedPercent: number;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "FileRepository";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof PendingActions];
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Returns the loader associated with specified file or promise.
+     *
+     * To get loader by id use `fileRepository.loaders.get( id )`.
+     *
+     * @param fileOrPromise Native file or promise handle.
+     */
+    getLoader(fileOrPromise: File | Promise<File>): FileLoader | null;
+    /**
+     * Creates a loader instance for the given file.
+     *
+     * Requires {@link #createUploadAdapter} factory to be defined.
+     *
+     * @param fileOrPromise Native File object or native Promise object which resolves to a File.
+     */
+    createLoader(fileOrPromise: File | Promise<File>): FileLoader | null;
+    /**
+     * Destroys the given loader.
+     *
+     * @param fileOrPromiseOrLoader File or Promise associated with that loader or loader itself.
+     */
+    destroyLoader(fileOrPromiseOrLoader: File | Promise<File> | FileLoader): void;
+    /**
+     * Registers or deregisters pending action bound with upload progress.
+     */
+    private _updatePendingAction;
+}
+declare const FileLoader_base: {
+    new (): import("@ckeditor/ckeditor5-utils").Observable;
+    prototype: import("@ckeditor/ckeditor5-utils").Observable;
+};
+/**
+ * File loader class.
+ *
+ * It is used to control the process of reading the file and uploading it using the specified upload adapter.
+ */
+declare class FileLoader extends FileLoader_base {
+    /**
+     * Unique id of FileLoader instance.
+     *
+     * @readonly
+     */
+    readonly id: string;
+    /**
+     * Additional wrapper over the initial file promise passed to this loader.
+     */
+    private _filePromiseWrapper;
+    /**
+     * Adapter instance associated with this file loader.
+     */
+    private _adapter;
+    /**
+     * FileReader used by FileLoader.
+     */
+    private _reader;
+    /**
+     * Current status of FileLoader. It can be one of the following:
+     *
+     * * 'idle',
+     * * 'reading',
+     * * 'uploading',
+     * * 'aborted',
+     * * 'error'.
+     *
+     * When reading status can change in a following way:
+     *
+     * `idle` -> `reading` -> `idle`
+     * `idle` -> `reading -> `aborted`
+     * `idle` -> `reading -> `error`
+     *
+     * When uploading status can change in a following way:
+     *
+     * `idle` -> `uploading` -> `idle`
+     * `idle` -> `uploading` -> `aborted`
+     * `idle` -> `uploading` -> `error`
+     *
+     * @readonly
+     * @observable
+     */
+    status: 'idle' | 'reading' | 'uploading' | 'aborted' | 'error';
+    /**
+     * Number of bytes uploaded.
+     *
+     * @readonly
+     * @observable
+     */
+    uploaded: number;
+    /**
+     * Number of total bytes to upload.
+     *
+     * @readonly
+     * @observable
+     */
+    uploadTotal: number | null;
+    /**
+     * Upload progress in percents.
+     *
+     * @readonly
+     * @observable
+     */
+    uploadedPercent: number;
+    /**
+     * Response of the upload.
+     *
+     * @readonly
+     * @observable
+     */
+    uploadResponse?: UploadResponse | null;
+    /**
+     * Creates a new instance of `FileLoader`.
+     *
+     * @param filePromise A promise which resolves to a file instance.
+     * @param uploadAdapterCreator The function which returns {@link module:upload/filerepository~UploadAdapter} instance.
+     */
+    constructor(filePromise: Promise<File>, uploadAdapterCreator: (loader: FileLoader) => UploadAdapter);
+    /**
+     * A `Promise` which resolves to a `File` instance associated with this file loader.
+     */
+    get file(): Promise<File | null>;
+    /**
+     * Returns the file data. To read its data, you need for first load the file
+     * by using the {@link module:upload/filerepository~FileLoader#read `read()`} method.
+     */
+    get data(): string | undefined;
+    /**
+     * Reads file using {@link module:upload/filereader~FileReader}.
+     *
+     * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `filerepository-read-wrong-status` when status
+     * is different than `idle`.
+     *
+     * Example usage:
+     *
+     * ```ts
+     * fileLoader.read()
+     * 	.then( data => { ... } )
+     * 	.catch( err => {
+     * 		if ( err === 'aborted' ) {
+     * 			console.log( 'Reading aborted.' );
+     * 		} else {
+     * 			console.log( 'Reading error.', err );
+     * 		}
+     * 	} );
+     * ```
+     *
+     * @returns Returns promise that will be resolved with read data. Promise will be rejected if error
+     * occurs or if read process is aborted.
+     */
+    read(): Promise<string>;
+    /**
+     * Reads file using the provided {@link module:upload/filerepository~UploadAdapter}.
+     *
+     * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `filerepository-upload-wrong-status` when status
+     * is different than `idle`.
+     * Example usage:
+     *
+     * ```ts
+     * fileLoader.upload()
+     * 	.then( data => { ... } )
+     * 	.catch( e => {
+     * 		if ( e === 'aborted' ) {
+     * 			console.log( 'Uploading aborted.' );
+     * 		} else {
+     * 			console.log( 'Uploading error.', e );
+     * 		}
+     * 	} );
+     * ```
+     *
+     * @returns Returns promise that will be resolved with response data. Promise will be rejected if error
+     * occurs or if read process is aborted.
+     */
+    upload(): Promise<UploadResponse>;
+    /**
+     * Aborts loading process.
+     */
+    abort(): void;
+    /**
+     * Performs cleanup.
+     *
+     * @internal
+     */
+    _destroy(): void;
+    /**
+     * Wraps a given file promise into another promise giving additional
+     * control (resolving, rejecting, checking if fulfilled) over it.
+     *
+     * @param filePromise The initial file promise to be wrapped.
+     */
+    private _createFilePromiseWrapper;
+}
+export type { FileLoader };
+/**
+ * Upload adapter interface used by the {@link module:upload/filerepository~FileRepository file repository}
+ * to handle file upload. An upload adapter is a bridge between the editor and server that handles file uploads.
+ * It should contain a logic necessary to initiate an upload process and monitor its progress.
+ *
+ * Learn how to develop your own upload adapter for CKEditor 5 in the
+ * {@glink framework/deep-dive/upload-adapter "Custom upload adapter"} guide.
+ *
+ * @interface UploadAdapter
+ */
+export interface UploadAdapter {
+    /**
+     * Executes the upload process.
+     * This method should return a promise that will resolve when data will be uploaded to server. Promise should be
+     * resolved with an object containing information about uploaded file:
+     *
+     * ```json
+     * {
+     * 	default: 'http://server/default-size.image.png'
+     * }
+     * ```
+     *
+     * Additionally, other image sizes can be provided:
+     *
+     * ```json
+     * {
+     * 	default: 'http://server/default-size.image.png',
+     * 	'160': 'http://server/size-160.image.png',
+     * 	'500': 'http://server/size-500.image.png',
+     * 	'1000': 'http://server/size-1000.image.png',
+     * 	'1052': 'http://server/default-size.image.png'
+     * }
+     * ```
+     *
+     * You can also pass additional properties from the server. In this case you need to wrap URLs
+     * in the `urls` object and pass additional properties along the `urls` property.
+     *
+     * ```json
+     * {
+     * 	myCustomProperty: 'foo',
+     * 	urls: {
+     * 		default: 'http://server/default-size.image.png',
+     * 		'160': 'http://server/size-160.image.png',
+     * 		'500': 'http://server/size-500.image.png',
+     * 		'1000': 'http://server/size-1000.image.png',
+     * 		'1052': 'http://server/default-size.image.png'
+     * 	}
+     * }
+     * ```
+     *
+     * NOTE: When returning multiple images, the widest returned one should equal the default one. It is essential to
+     * correctly set `width` attribute of the image. See this discussion:
+     * https://github.com/ckeditor/ckeditor5-easy-image/issues/4 for more information.
+     *
+     * Take a look at {@link module:upload/filerepository~UploadAdapter example Adapter implementation} and
+     * {@link module:upload/filerepository~FileRepository#createUploadAdapter createUploadAdapter method}.
+     *
+     * @returns Promise that should be resolved when data is uploaded.
+     */
+    upload(): Promise<UploadResponse>;
+    /**
+     * Aborts the upload process.
+     * After aborting it should reject promise returned from {@link #upload upload()}.
+     *
+     * Take a look at {@link module:upload/filerepository~UploadAdapter example Adapter implementation} and
+     * {@link module:upload/filerepository~FileRepository#createUploadAdapter createUploadAdapter method}.
+     */
+    abort?(): void;
+}
+export type UploadResponse = Record<string, unknown>;

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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 upload
+ */
+export { default as FileRepository, type UploadAdapter, type UploadResponse, type FileLoader } from './filerepository.js';
+export { default as Base64UploadAdapter } from './adapters/base64uploadadapter.js';
+export { default as SimpleUploadAdapter } from './adapters/simpleuploadadapter.js';
+export type { SimpleUploadConfig } from './uploadconfig.js';
+import './augmentation.js';