@ckeditor/ckeditor5-ckfinder 36.0.1 → 37.0.0-alpha.0

package/build/ckfinder.js

@@ -2,4 +2,4 @@
 /*!
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
- */(()=>{var e={704:(e,i,t)=>{e.exports=t(79)("./src/core.js")},273:(e,i,t)=>{e.exports=t(79)("./src/ui.js")},209:(e,i,t)=>{e.exports=t(79)("./src/utils.js")},79:e=>{"use strict";e.exports=CKEditor5.dll}},i={};function t(n){var o=i[n];if(void 0!==o)return o.exports;var r=i[n]={exports:{}};return e[n](r,r.exports,t),r.exports}t.d=(e,i)=>{for(var n in i)t.o(i,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:i[n]})},t.o=(e,i)=>Object.prototype.hasOwnProperty.call(e,i),t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};(()=>{"use strict";t.r(n),t.d(n,{CKFinder:()=>c,CKFinderEditing:()=>d,CKFinderUI:()=>o});var e=t(704),i=t(273);class o extends e.Plugin{static get pluginName(){return"CKFinderUI"}init(){const e=this.editor,t=e.ui.componentFactory,n=e.t;t.add("ckfinder",(t=>{const o=e.commands.get("ckfinder"),r=new i.ButtonView(t);return r.set({label:n("Insert image or file"),icon:'<svg viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><path d="M11.627 16.5zm5.873-.196zm0-7.001V8h-13v8.5h4.341c.191.54.457 1.044.785 1.5H2a1.5 1.5 0 0 1-1.5-1.5v-13A1.5 1.5 0 0 1 2 2h4.5a1.5 1.5 0 0 1 1.06.44L9.122 4H16a1.5 1.5 0 0 1 1.5 1.5v1A1.5 1.5 0 0 1 19 8v2.531a6.027 6.027 0 0 0-1.5-1.228zM16 6.5v-1H8.5l-2-2H2v13h1V8a1.5 1.5 0 0 1 1.5-1.5H16z"/><path d="M14.5 19.5a5 5 0 1 1 0-10 5 5 0 0 1 0 10zM15 14v-2h-1v2h-2v1h2v2h1v-2h2v-1h-2z"/></svg>',tooltip:!0}),r.bind("isEnabled").to(o),r.on("execute",(()=>{e.execute("ckfinder"),e.editing.view.focus()})),r}))}}var r=t(209);class s extends e.Command{constructor(e){super(e),this._affectsData=!1,this.stopListening(this.editor.model.document,"change"),this.listenTo(this.editor.model.document,"change",(()=>this.refresh()),{priority:"low"})}refresh(){const e=this.editor.commands.get("insertImage"),i=this.editor.commands.get("link");this.isEnabled=e.isEnabled||i.isEnabled}execute(){const e=this.editor,i=this.editor.config.get("ckfinder.openerMethod")||"modal";if("popup"!=i&&"modal"!=i)throw new r.CKEditorError("ckfinder-unknown-openermethod",e);const t=this.editor.config.get("ckfinder.options")||{};t.chooseFiles=!0;const n=t.onInit;t.language||(t.language=e.locale.uiLanguage),t.onInit=i=>{n&&n(i),i.on("files:choose",(t=>{const n=t.data.files.toArray(),o=n.filter((e=>!e.isImage())),r=n.filter((e=>e.isImage()));for(const i of o)e.execute("link",i.getUrl());const s=[];for(const e of r){const t=e.getUrl();s.push(t||i.request("file:getProxyUrl",{file:e}))}s.length&&a(e,s)})),i.on("file:choose:resizedImage",(i=>{const t=i.data.resizedUrl;if(t)a(e,[t]);else{const i=e.plugins.get("Notification"),t=e.locale.t;i.showWarning(t("Could not obtain resized image URL."),{title:t("Selecting resized image failed"),namespace:"ckfinder"})}}))},window.CKFinder[i](t)}}function a(e,i){if(e.commands.get("insertImage").isEnabled)e.execute("insertImage",{source:i});else{const i=e.plugins.get("Notification"),t=e.locale.t;i.showWarning(t("Could not insert image at the current position."),{title:t("Inserting image failed"),namespace:"ckfinder"})}}class d extends e.Plugin{static get pluginName(){return"CKFinderEditing"}static get requires(){return[i.Notification,"LinkEditing"]}init(){const e=this.editor;if(!e.plugins.has("ImageBlockEditing")&&!e.plugins.has("ImageInlineEditing"))throw new r.CKEditorError("ckfinder-missing-image-plugin",e);e.commands.add("ckfinder",new s(e))}}class c extends e.Plugin{static get pluginName(){return"CKFinder"}static get requires(){return["Link","CKFinderUploadAdapter",d,o]}}})(),(window.CKEditor5=window.CKEditor5||{}).ckfinder=n})();
+ */(()=>{var e={704:(e,i,t)=>{e.exports=t(79)("./src/core.js")},273:(e,i,t)=>{e.exports=t(79)("./src/ui.js")},209:(e,i,t)=>{e.exports=t(79)("./src/utils.js")},79:e=>{"use strict";e.exports=CKEditor5.dll}},i={};function t(n){var o=i[n];if(void 0!==o)return o.exports;var r=i[n]={exports:{}};return e[n](r,r.exports,t),r.exports}t.d=(e,i)=>{for(var n in i)t.o(i,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:i[n]})},t.o=(e,i)=>Object.prototype.hasOwnProperty.call(e,i),t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};(()=>{"use strict";t.r(n),t.d(n,{CKFinder:()=>c,CKFinderEditing:()=>d,CKFinderUI:()=>o});var e=t(704),i=t(273);class o extends e.Plugin{static get pluginName(){return"CKFinderUI"}init(){const e=this.editor,t=e.ui.componentFactory,n=e.t;t.add("ckfinder",(t=>{const o=e.commands.get("ckfinder"),r=new i.ButtonView(t);return r.set({label:n("Insert image or file"),icon:'<svg viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><path d="M11.627 16.5zm5.873-.196zm0-7.001V8h-13v8.5h4.341c.191.54.457 1.044.785 1.5H2a1.5 1.5 0 0 1-1.5-1.5v-13A1.5 1.5 0 0 1 2 2h4.5a1.5 1.5 0 0 1 1.06.44L9.122 4H16a1.5 1.5 0 0 1 1.5 1.5v1A1.5 1.5 0 0 1 19 8v2.531a6.027 6.027 0 0 0-1.5-1.228zM16 6.5v-1H8.5l-2-2H2v13h1V8a1.5 1.5 0 0 1 1.5-1.5H16z"/><path d="M14.5 19.5a5 5 0 1 1 0-10 5 5 0 0 1 0 10zM15 14v-2h-1v2h-2v1h2v2h1v-2h2v-1h-2z"/></svg>',tooltip:!0}),r.bind("isEnabled").to(o),r.on("execute",(()=>{e.execute("ckfinder"),e.editing.view.focus()})),r}))}}var r=t(209);class s extends e.Command{constructor(e){super(e),this.affectsData=!1,this.stopListening(this.editor.model.document,"change"),this.listenTo(this.editor.model.document,"change",(()=>this.refresh()),{priority:"low"})}refresh(){const e=this.editor.commands.get("insertImage"),i=this.editor.commands.get("link");this.isEnabled=e.isEnabled||i.isEnabled}execute(){const e=this.editor,i=this.editor.config.get("ckfinder.openerMethod")||"modal";if("popup"!=i&&"modal"!=i)throw new r.CKEditorError("ckfinder-unknown-openermethod",e);const t=this.editor.config.get("ckfinder.options")||{};t.chooseFiles=!0;const n=t.onInit;t.language||(t.language=e.locale.uiLanguage),t.onInit=i=>{n&&n(i),i.on("files:choose",(t=>{const n=t.data.files.toArray(),o=n.filter((e=>!e.isImage())),r=n.filter((e=>e.isImage()));for(const i of o)e.execute("link",i.getUrl());const s=[];for(const e of r){const t=e.getUrl();s.push(t||i.request("file:getProxyUrl",{file:e}))}s.length&&a(e,s)})),i.on("file:choose:resizedImage",(i=>{const t=i.data.resizedUrl;if(t)a(e,[t]);else{const i=e.plugins.get("Notification"),t=e.locale.t;i.showWarning(t("Could not obtain resized image URL."),{title:t("Selecting resized image failed"),namespace:"ckfinder"})}}))},window.CKFinder[i](t)}}function a(e,i){if(e.commands.get("insertImage").isEnabled)e.execute("insertImage",{source:i});else{const i=e.plugins.get("Notification"),t=e.locale.t;i.showWarning(t("Could not insert image at the current position."),{title:t("Inserting image failed"),namespace:"ckfinder"})}}class d extends e.Plugin{static get pluginName(){return"CKFinderEditing"}static get requires(){return[i.Notification,"LinkEditing"]}init(){const e=this.editor;if(!e.plugins.has("ImageBlockEditing")&&!e.plugins.has("ImageInlineEditing"))throw new r.CKEditorError("ckfinder-missing-image-plugin",e);e.commands.add("ckfinder",new s(e))}}class c extends e.Plugin{static get pluginName(){return"CKFinder"}static get requires(){return["Link","CKFinderUploadAdapter",d,o]}}})(),(window.CKEditor5=window.CKEditor5||{}).ckfinder=n})();

package/ckeditor5-metadata.json

@@ -4,7 +4,7 @@
 			"name": "CKFinder",
 			"className": "CKFinder",
 			"description": "An image upload tool. It provides a full, server-side and client-side integration with CKFinder and all its features, including multiple file uploads, image editor and file management.",
-			"docs": "features/images/image-upload/ckfinder.html",
+			"docs": "features/file-management/ckfinder.html",
 			"path": "src/ckfinder.js",
 			"requires": [
 				"CKFinderUploadAdapter",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-ckfinder",
-  "version": "36.0.1",
+  "version": "37.0.0-alpha.0",
   "description": "CKFinder integration for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,21 +12,22 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "ckeditor5": "^36.0.1"
+    "ckeditor5": "^37.0.0-alpha.0"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-adapter-ckfinder": "^36.0.1",
-    "@ckeditor/ckeditor5-clipboard": "^36.0.1",
-    "@ckeditor/ckeditor5-core": "^36.0.1",
-    "@ckeditor/ckeditor5-dev-utils": "^32.0.0",
-    "@ckeditor/ckeditor5-editor-classic": "^36.0.1",
-    "@ckeditor/ckeditor5-engine": "^36.0.1",
-    "@ckeditor/ckeditor5-image": "^36.0.1",
-    "@ckeditor/ckeditor5-link": "^36.0.1",
-    "@ckeditor/ckeditor5-paragraph": "^36.0.1",
-    "@ckeditor/ckeditor5-theme-lark": "^36.0.1",
-    "@ckeditor/ckeditor5-ui": "^36.0.1",
-    "@ckeditor/ckeditor5-utils": "^36.0.1",
+    "@ckeditor/ckeditor5-adapter-ckfinder": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-clipboard": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-core": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-dev-utils": "^34.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-engine": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-image": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-link": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-paragraph": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-theme-lark": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-ui": "^37.0.0-alpha.0",
+    "@ckeditor/ckeditor5-utils": "^37.0.0-alpha.0",
+    "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"
   },
@@ -45,13 +46,17 @@
   },
   "files": [
     "lang",
-    "src",
+    "src/**/*.js",
+    "src/**/*.d.ts",
     "theme",
     "build",
     "ckeditor5-metadata.json",
     "CHANGELOG.md"
   ],
   "scripts": {
-    "dll:build": "webpack"
-  }
+    "dll:build": "webpack",
+    "build": "tsc -p ./tsconfig.release.json",
+    "postversion": "npm run build"
+  },
+  "types": "src/index.d.ts"
 }

package/src/ckfinder.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ckfinder/ckfinder
+ */
+import { Plugin, type PluginDependencies } from 'ckeditor5/src/core';
+/**
+ * The CKFinder feature, a bridge between the CKEditor 5 WYSIWYG editor and the
+ * [CKFinder](https://ckeditor.com/ckfinder) file manager and uploader.
+ *
+ * This is a "glue" plugin which enables:
+ *
+ * * {@link module:ckfinder/ckfinderediting~CKFinderEditing},
+ * * {@link module:ckfinder/ckfinderui~CKFinderUI},
+ * * {@link module:adapter-ckfinder/uploadadapter~CKFinderUploadAdapter}.
+ *
+ * See the {@glink features/images/image-upload/ckfinder "CKFinder integration" guide} to learn how to configure
+ * and use this feature.
+ *
+ * Check out the {@glink features/images/image-upload/image-upload comprehensive "Image upload" guide} to learn about
+ * other ways to upload images into CKEditor 5.
+ */
+export default class CKFinder extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'CKFinder';
+    /**
+     * @inheritDoc
+     */
+    static get requires(): PluginDependencies;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface PluginsMap {
+        [CKFinder.pluginName]: CKFinder;
+    }
+}

package/src/ckfinder.js

@@ -2,16 +2,12 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module ckfinder/ckfinder
  */
-
 import { Plugin } from 'ckeditor5/src/core';
-
 import CKFinderUI from './ckfinderui';
 import CKFinderEditing from './ckfinderediting';
-
 /**
  * The CKFinder feature, a bridge between the CKEditor 5 WYSIWYG editor and the
  * [CKFinder](https://ckeditor.com/ckfinder) file manager and uploader.
@@ -27,93 +23,18 @@ import CKFinderEditing from './ckfinderediting';
  *
  * Check out the {@glink features/images/image-upload/image-upload comprehensive "Image upload" guide} to learn about
  * other ways to upload images into CKEditor 5.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class CKFinder extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'CKFinder';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	static get requires() {
-		return [ 'Link', 'CKFinderUploadAdapter', CKFinderEditing, CKFinderUI ];
-	}
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CKFinder';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return ['Link', 'CKFinderUploadAdapter', CKFinderEditing, CKFinderUI];
+    }
 }
-
-/**
- * The configuration of the {@link module:ckfinder/ckfinder~CKFinder CKFinder feature}.
- *
- * Read more in {@link module:ckfinder/ckfinder~CKFinderConfig}.
- *
- * @member {module:ckfinder/ckfinder~CKFinderConfig} module:core/editor/editorconfig~EditorConfig#ckfinder
- */
-
-/**
- * The configuration of the {@link module:ckfinder/ckfinder~CKFinder CKFinder feature}
- * and its {@link module:adapter-ckfinder/uploadadapter~CKFinderUploadAdapter upload adapter}.
- *
- *		ClassicEditor
- *			.create( editorElement, {
- *				ckfinder: {
- *					options: {
- *						resourceType: 'Images'
- *					}
- *				}
- *			} )
- *			.then( ... )
- *			.catch( ... );
- *
- * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
- *
- * @interface CKFinderConfig
- */
-
-/**
- * The configuration options passed to the CKFinder file manager instance.
- *
- * Check the file manager [documentation](https://ckeditor.com/docs/ckfinder/ckfinder3/#!/api/CKFinder.Config-cfg-language)
- * for the complete list of options.
- *
- * @member {Object} module:ckfinder/ckfinder~CKFinderConfig#options
- */
-
-/**
- * The type of the CKFinder opener method.
- *
- * Supported types are:
- *
- * * `'modal'` – Opens CKFinder in a modal,
- * * `'popup'` – Opens CKFinder in a new "pop-up" window.
- *
- * Defaults to `'modal'`.
- *
- * @member {String} module:ckfinder/ckfinder~CKFinderConfig#openerMethod
- */
-
-/**
- * The path (URL) to the connector which handles the file upload in CKFinder file manager.
- * When specified, it enables the automatic upload of resources such as images inserted into the content.
- *
- * For instance, to use CKFinder's
- * [quick upload](https://ckeditor.com/docs/ckfinder/ckfinder3-php/commands.html#command_quick_upload)
- * command, your can use the following (or similar) path:
- *
- *		ClassicEditor
- *			.create( editorElement, {
- *				ckfinder: {
- *					uploadUrl: '/ckfinder/core/connector/php/connector.php?command=QuickUpload&type=Files&responseType=json'
- *				}
- *			} )
- *			.then( ... )
- *			.catch( ... );
- *
- * Used by the {@link module:adapter-ckfinder/uploadadapter~CKFinderUploadAdapter upload adapter}.
- *
- * @member {String} module:ckfinder/ckfinder~CKFinderConfig#uploadUrl
- */

package/src/ckfindercommand.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ckfinder/ckfindercommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+import './ckfinderconfig';
+/**
+ * The CKFinder command. It is used by the {@link module:ckfinder/ckfinderediting~CKFinderEditing CKFinder editing feature}
+ * to open the CKFinder file manager to insert an image or a link to a file into the editor content.
+ *
+ * ```ts
+ * editor.execute( 'ckfinder' );
+ * ```
+ *
+ * **Note:** This command uses other features to perform tasks:
+ * - To insert images the {@link module:image/image/insertimagecommand~InsertImageCommand 'insertImage'} command
+ * from the {@link module:image/image~Image Image feature}.
+ * - To insert links to files the {@link module:link/linkcommand~LinkCommand 'link'} command
+ * from the {@link module:link/link~Link Link feature}.
+ */
+export default class CKFinderCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    constructor(editor: Editor);
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * @inheritDoc
+     */
+    execute(): void;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface CommandsMap {
+        ckfinder: CKFinderCommand;
+    }
+}

package/src/ckfindercommand.js

@@ -2,156 +2,122 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /* global window */
-
 /**
  * @module ckfinder/ckfindercommand
  */
-
 import { Command } from 'ckeditor5/src/core';
 import { CKEditorError } from 'ckeditor5/src/utils';
-
+import './ckfinderconfig';
 /**
  * The CKFinder command. It is used by the {@link module:ckfinder/ckfinderediting~CKFinderEditing CKFinder editing feature}
  * to open the CKFinder file manager to insert an image or a link to a file into the editor content.
  *
- *		editor.execute( 'ckfinder' );
+ * ```ts
+ * editor.execute( 'ckfinder' );
+ * ```
  *
  * **Note:** This command uses other features to perform tasks:
  * - To insert images the {@link module:image/image/insertimagecommand~InsertImageCommand 'insertImage'} command
  * from the {@link module:image/image~Image Image feature}.
  * - To insert links to files the {@link module:link/linkcommand~LinkCommand 'link'} command
  * from the {@link module:link/link~Link Link feature}.
- *
- * @extends module:core/command~Command
  */
 export default class CKFinderCommand extends Command {
-	/**
-	 * @inheritDoc
-	 */
-	constructor( editor ) {
-		super( editor );
-
-		// The CKFinder command does not affect data by itself.
-		this._affectsData = false;
-
-		// Remove default document listener to lower its priority.
-		this.stopListening( this.editor.model.document, 'change' );
-
-		// Lower this command listener priority to be sure that refresh() will be called after link & image refresh.
-		this.listenTo( this.editor.model.document, 'change', () => this.refresh(), { priority: 'low' } );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	refresh() {
-		const imageCommand = this.editor.commands.get( 'insertImage' );
-		const linkCommand = this.editor.commands.get( 'link' );
-
-		// The CKFinder command is enabled when one of image or link command is enabled.
-		this.isEnabled = imageCommand.isEnabled || linkCommand.isEnabled;
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	execute() {
-		const editor = this.editor;
-
-		const openerMethod = this.editor.config.get( 'ckfinder.openerMethod' ) || 'modal';
-
-		if ( openerMethod != 'popup' && openerMethod != 'modal' ) {
-			/**
-			 * The `ckfinder.openerMethod` must be one of: "popup" or "modal".
-			 *
-			 * @error ckfinder-unknown-openermethod
-			 */
-			throw new CKEditorError( 'ckfinder-unknown-openermethod', editor );
-		}
-
-		const options = this.editor.config.get( 'ckfinder.options' ) || {};
-
-		options.chooseFiles = true;
-
-		// Cache the user-defined onInit method
-		const originalOnInit = options.onInit;
-
-		// Pass the lang code to the CKFinder if not defined by user.
-		if ( !options.language ) {
-			options.language = editor.locale.uiLanguage;
-		}
-
-		// The onInit method allows to extend CKFinder's behavior. It is used to attach event listeners to file choosing related events.
-		options.onInit = finder => {
-			// Call original options.onInit if it was defined by user.
-			if ( originalOnInit ) {
-				originalOnInit( finder );
-			}
-
-			finder.on( 'files:choose', evt => {
-				const files = evt.data.files.toArray();
-
-				// Insert links
-				const links = files.filter( file => !file.isImage() );
-				const images = files.filter( file => file.isImage() );
-
-				for ( const linkFile of links ) {
-					editor.execute( 'link', linkFile.getUrl() );
-				}
-
-				const imagesUrls = [];
-
-				for ( const image of images ) {
-					const url = image.getUrl();
-
-					imagesUrls.push( url ? url : finder.request( 'file:getProxyUrl', { file: image } ) );
-				}
-
-				if ( imagesUrls.length ) {
-					insertImages( editor, imagesUrls );
-				}
-			} );
-
-			finder.on( 'file:choose:resizedImage', evt => {
-				const resizedUrl = evt.data.resizedUrl;
-
-				if ( !resizedUrl ) {
-					const notification = editor.plugins.get( 'Notification' );
-					const t = editor.locale.t;
-
-					notification.showWarning( t( 'Could not obtain resized image URL.' ), {
-						title: t( 'Selecting resized image failed' ),
-						namespace: 'ckfinder'
-					} );
-
-					return;
-				}
-
-				insertImages( editor, [ resizedUrl ] );
-			} );
-		};
-
-		window.CKFinder[ openerMethod ]( options );
-	}
+    /**
+     * @inheritDoc
+     */
+    constructor(editor) {
+        super(editor);
+        // The CKFinder command does not affect data by itself.
+        this.affectsData = false;
+        // Remove default document listener to lower its priority.
+        this.stopListening(this.editor.model.document, 'change');
+        // Lower this command listener priority to be sure that refresh() will be called after link & image refresh.
+        this.listenTo(this.editor.model.document, 'change', () => this.refresh(), { priority: 'low' });
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const imageCommand = this.editor.commands.get('insertImage');
+        const linkCommand = this.editor.commands.get('link');
+        // The CKFinder command is enabled when one of image or link command is enabled.
+        this.isEnabled = imageCommand.isEnabled || linkCommand.isEnabled;
+    }
+    /**
+     * @inheritDoc
+     */
+    execute() {
+        const editor = this.editor;
+        const openerMethod = this.editor.config.get('ckfinder.openerMethod') || 'modal';
+        if (openerMethod != 'popup' && openerMethod != 'modal') {
+            /**
+             * The `ckfinder.openerMethod` must be one of: "popup" or "modal".
+             *
+             * @error ckfinder-unknown-openermethod
+             */
+            throw new CKEditorError('ckfinder-unknown-openermethod', editor);
+        }
+        const options = this.editor.config.get('ckfinder.options') || {};
+        options.chooseFiles = true;
+        // Cache the user-defined onInit method
+        const originalOnInit = options.onInit;
+        // Pass the lang code to the CKFinder if not defined by user.
+        if (!options.language) {
+            options.language = editor.locale.uiLanguage;
+        }
+        // The onInit method allows to extend CKFinder's behavior. It is used to attach event listeners to file choosing related events.
+        options.onInit = finder => {
+            // Call original options.onInit if it was defined by user.
+            if (originalOnInit) {
+                originalOnInit(finder);
+            }
+            finder.on('files:choose', (evt) => {
+                const files = evt.data.files.toArray();
+                // Insert links
+                const links = files.filter((file) => !file.isImage());
+                const images = files.filter((file) => file.isImage());
+                for (const linkFile of links) {
+                    editor.execute('link', linkFile.getUrl());
+                }
+                const imagesUrls = [];
+                for (const image of images) {
+                    const url = image.getUrl();
+                    imagesUrls.push(url ? url : finder.request('file:getProxyUrl', { file: image }));
+                }
+                if (imagesUrls.length) {
+                    insertImages(editor, imagesUrls);
+                }
+            });
+            finder.on('file:choose:resizedImage', (evt) => {
+                const resizedUrl = evt.data.resizedUrl;
+                if (!resizedUrl) {
+                    const notification = editor.plugins.get('Notification');
+                    const t = editor.locale.t;
+                    notification.showWarning(t('Could not obtain resized image URL.'), {
+                        title: t('Selecting resized image failed'),
+                        namespace: 'ckfinder'
+                    });
+                    return;
+                }
+                insertImages(editor, [resizedUrl]);
+            });
+        };
+        window.CKFinder[openerMethod](options);
+    }
 }
-
-function insertImages( editor, urls ) {
-	const imageCommand = editor.commands.get( 'insertImage' );
-
-	// Check if inserting an image is actually possible - it might be possible to only insert a link.
-	if ( !imageCommand.isEnabled ) {
-		const notification = editor.plugins.get( 'Notification' );
-		const t = editor.locale.t;
-
-		notification.showWarning( t( 'Could not insert image at the current position.' ), {
-			title: t( 'Inserting image failed' ),
-			namespace: 'ckfinder'
-		} );
-
-		return;
-	}
-
-	editor.execute( 'insertImage', { source: urls } );
+function insertImages(editor, urls) {
+    const imageCommand = editor.commands.get('insertImage');
+    // Check if inserting an image is actually possible - it might be possible to only insert a link.
+    if (!imageCommand.isEnabled) {
+        const notification = editor.plugins.get('Notification');
+        const t = editor.locale.t;
+        notification.showWarning(t('Could not insert image at the current position.'), {
+            title: t('Inserting image failed'),
+            namespace: 'ckfinder'
+        });
+        return;
+    }
+    editor.execute('insertImage', { source: urls });
 }

package/src/ckfinderconfig.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ckfinder/ckfinder
+ */
+/**
+ * The configuration of the {@link module:ckfinder/ckfinder~CKFinder CKFinder feature}
+ * and its {@link module:adapter-ckfinder/uploadadapter~CKFinderUploadAdapter upload adapter}.
+ *
+ * ```
+ * ClassicEditor
+ * 	.create( editorElement, {
+ * 		ckfinder: {
+ * 			options: {
+ * 				resourceType: 'Images'
+ * 			}
+ * 		}
+ * 	} )
+ * 	.then( ... )
+ * 	.catch( ... );
+ * ```
+ *
+ * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
+ */
+export interface CKFinderConfig {
+    /**
+     * The configuration options passed to the CKFinder file manager instance.
+     *
+     * Check the file manager [documentation](https://ckeditor.com/docs/ckfinder/ckfinder3/#!/api/CKFinder.Config-cfg-language)
+     * for the complete list of options.
+     */
+    options?: CKFinderOptions;
+    /**
+     * The type of the CKFinder opener method.
+     *
+     * Supported types are:
+     *
+     * * `'modal'` – Opens CKFinder in a modal,
+     * * `'popup'` – Opens CKFinder in a new "pop-up" window.
+     *
+     * Defaults to `'modal'`.
+     */
+    openerMethod?: 'modal' | 'popup';
+    /**
+     * The path (URL) to the connector which handles the file upload in CKFinder file manager.
+     * When specified, it enables the automatic upload of resources such as images inserted into the content.
+     *
+     * For instance, to use CKFinder's
+     * [quick upload](https://ckeditor.com/docs/ckfinder/ckfinder3-php/commands.html#command_quick_upload)
+     * command, your can use the following (or similar) path:
+     *
+     * ```ts
+     * ClassicEditor
+     * 	.create( editorElement, {
+     * 		ckfinder: {
+     * 			uploadUrl: '/ckfinder/core/connector/php/connector.php?command=QuickUpload&type=Files&responseType=json'
+     * 		}
+     * 	} )
+     * 	.then( ... )
+     * 	.catch( ... );
+     * ```
+     *
+     * Used by the {@link module:adapter-ckfinder/uploadadapter~CKFinderUploadAdapter upload adapter}.
+     */
+    uploadUrl?: string;
+}
+export interface CKFinderOptions extends Record<string, unknown> {
+    chooseFiles?: boolean;
+    onInit?: (finder: any) => void;
+    language?: string;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface EditorConfig {
+        /**
+         * The configuration of the {@link module:ckfinder/ckfinder~CKFinder CKFinder feature}.
+         *
+         * Read more in {@link module:ckfinder/ckfinder~CKFinderConfig}.
+         */
+        ckfinder?: CKFinderConfig;
+    }
+}

package/src/ckfinderconfig.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export {};

package/src/ckfinderediting.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ckfinder/ckfinderediting
+ */
+import { Plugin, type PluginDependencies } from 'ckeditor5/src/core';
+/**
+ * The CKFinder editing feature. It introduces the {@link module:ckfinder/ckfindercommand~CKFinderCommand CKFinder command}.
+ */
+export default class CKFinderEditing extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'CKFinderEditing';
+    /**
+     * @inheritDoc
+     */
+    static get requires(): PluginDependencies;
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface PluginsMap {
+        [CKFinderEditing.pluginName]: CKFinderEditing;
+    }
+}

package/src/ckfinderediting.js

@@ -2,59 +2,49 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module ckfinder/ckfinderediting
  */
-
 import { Plugin } from 'ckeditor5/src/core';
 import { Notification } from 'ckeditor5/src/ui';
 import { CKEditorError } from 'ckeditor5/src/utils';
-
 import CKFinderCommand from './ckfindercommand';
-
 /**
  * The CKFinder editing feature. It introduces the {@link module:ckfinder/ckfindercommand~CKFinderCommand CKFinder command}.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class CKFinderEditing extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'CKFinderEditing';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	static get requires() {
-		return [ Notification, 'LinkEditing' ];
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	init() {
-		const editor = this.editor;
-
-		if ( !editor.plugins.has( 'ImageBlockEditing' ) && !editor.plugins.has( 'ImageInlineEditing' ) ) {
-			/**
-			 * CKFinder requires at least one plugin providing support for images loaded in the editor. Please
-			 * make sure either:
-			 *
-			 * * {@link module:image/image~Image} (which loads both types of images),
-			 * * or {@link module:image/imageblock~ImageBlock},
-			 * * or {@link module:image/imageinline~ImageInline}.
-			 *
-			 * is loaded in your editor configuration.
-			 *
-			 * @error ckfinder-missing-image-plugin
-			 */
-			throw new CKEditorError( 'ckfinder-missing-image-plugin', editor );
-		}
-
-		editor.commands.add( 'ckfinder', new CKFinderCommand( editor ) );
-	}
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CKFinderEditing';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [Notification, 'LinkEditing'];
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        if (!editor.plugins.has('ImageBlockEditing') && !editor.plugins.has('ImageInlineEditing')) {
+            /**
+             * CKFinder requires at least one plugin providing support for images loaded in the editor. Please
+             * make sure either:
+             *
+             * * {@link module:image/image~Image} (which loads both types of images),
+             * * or {@link module:image/imageblock~ImageBlock},
+             * * or {@link module:image/imageinline~ImageInline}.
+             *
+             * is loaded in your editor configuration.
+             *
+             * @error ckfinder-missing-image-plugin
+             */
+            throw new CKEditorError('ckfinder-missing-image-plugin', editor);
+        }
+        editor.commands.add('ckfinder', new CKFinderCommand(editor));
+    }
 }

package/src/ckfinderui.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ckfinder/ckfinderui
+ */
+import { Plugin } from 'ckeditor5/src/core';
+/**
+ * The CKFinder UI plugin. It introduces the `'ckfinder'` toolbar button.
+ */
+export default class CKFinderUI extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'CKFinderUI';
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/src/ckfinderui.js

@@ -2,56 +2,43 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module ckfinder/ckfinderui
  */
-
 import { Plugin } from 'ckeditor5/src/core';
 import { ButtonView } from 'ckeditor5/src/ui';
-
 import browseFilesIcon from '../theme/icons/browse-files.svg';
-
 /**
  * The CKFinder UI plugin. It introduces the `'ckfinder'` toolbar button.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class CKFinderUI extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'CKFinderUI';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	init() {
-		const editor = this.editor;
-		const componentFactory = editor.ui.componentFactory;
-		const t = editor.t;
-
-		componentFactory.add( 'ckfinder', locale => {
-			const command = editor.commands.get( 'ckfinder' );
-
-			const button = new ButtonView( locale );
-
-			button.set( {
-				label: t( 'Insert image or file' ),
-				icon: browseFilesIcon,
-				tooltip: true
-			} );
-
-			button.bind( 'isEnabled' ).to( command );
-
-			button.on( 'execute', () => {
-				editor.execute( 'ckfinder' );
-				editor.editing.view.focus();
-			} );
-
-			return button;
-		} );
-	}
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CKFinderUI';
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        const componentFactory = editor.ui.componentFactory;
+        const t = editor.t;
+        componentFactory.add('ckfinder', locale => {
+            const command = editor.commands.get('ckfinder');
+            const button = new ButtonView(locale);
+            button.set({
+                label: t('Insert image or file'),
+                icon: browseFilesIcon,
+                tooltip: true
+            });
+            button.bind('isEnabled').to(command);
+            button.on('execute', () => {
+                editor.execute('ckfinder');
+                editor.editing.view.focus();
+            });
+            return button;
+        });
+    }
 }

package/src/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ckfinder
+ */
+export { default as CKFinder } from './ckfinder';
+export { default as CKFinderEditing } from './ckfinderediting';
+export { default as CKFinderUI } from './ckfinderui';
+export type { CKFinderConfig } from './ckfinderconfig';

package/src/index.js

@@ -2,11 +2,9 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module ckfinder
  */
-
 export { default as CKFinder } from './ckfinder';
 export { default as CKFinderEditing } from './ckfinderediting';
 export { default as CKFinderUI } from './ckfinderui';