DOC-3224: powerpaste_emf_processor function that takes an emf blob and should return a promise of a png blob. (#3932)

* DOC-3224:  function that takes an emf blob and should return a promise of a png blob.

* DOC-3224: Fixed xref link.

* DOC-3224: Added the note to the option documentation as well.

* Update modules/ROOT/partials/configuration/powerpaste_emf_processor.adoc

Co-authored-by: Millie <[email protected]>

---------

Co-authored-by: Karl Kemister-Sheppard <[email protected]>
Co-authored-by: Millie <[email protected]>

Author: 3 people

modules/ROOT/pages/8.3.0-release-notes.adoc

@@ -28,6 +28,28 @@ include::partial$misc/admon-releasenotes-for-stable.adoc[]
 
 The following premium plugin updates were released alongside {productname} {release-version}.
 
+=== PowerPaste
+
+The {productname} {release-version} release includes an accompanying release of the **PowerPaste** premium plugin.
+
+**PowerPaste** includes the following addition.
+
+==== `powerpaste_emf_processor` function that takes an `emf` blob and returns a promise of a `png` blob.
+
+Before October 2025, copying and pasting content from Microsoft Word containing `emf` images resulted in those images not being pasted and an error message being displayed. After October 2025, this behavior changed where the images began appearing in the editor, but only at low resolution, accompanied by an error message in Chrome and Firefox. Safari displayed the low-resolution images without showing an error message.
+
+This change negatively affected the user experience. After October 2025, users would see a low-quality image alongside an error message stating `Some images failed to import`, which caused confusion since the image was, in fact, visible in the editor—albeit with degraded quality.
+
+{productname} {release-version} introduces a new option, xref:powerpaste-options.adoc#powerpaste_emf_processor[powerpaste_emf_processor], to address this issue. This option accepts a function that receives an `emf` blob and returns a promise resolving to a `png` blob (i.e. `(blob: Blob) => Promise<Blob>`).
+
+* If this option is provided, the editor will invoke the supplied function to convert `emf` image blobs into `png` image blobs before inserting them into the editor.
+
+* If this option is **not** provided, the editor will remove the low-quality images and display an error message, restoring the pre–October 2025 behavior.
+
+NOTE: If only the image is selected, pasting it will succeed and the image will be inserted correctly. However, if the image is selected together with other types of content, such as text, the image will not be pasted and an error message will be displayed.
+
+For information on the **PowerPaste** plugin, see: xref:introduction-to-powerpaste.adoc[PowerPaste].
+
 === Media Optimizer
 
 The {productname} {release-version} release includes an accompanying release of the **Media Optimizer** premium plugin.

modules/ROOT/pages/powerpaste-options.adoc

@@ -23,6 +23,8 @@ include::partial$configuration/powerpaste_autolink_urls.adoc[leveloffset=+1]
 
 include::partial$configuration/powerpaste_allow_local_images.adoc[leveloffset=+1]
 
+include::partial$configuration/powerpaste_emf_processor.adoc[leveloffset=+1]
+
 include::partial$configuration/paste_block_drop.adoc[leveloffset=+1]
 
 include::partial$configuration/powerpaste_clean_filtered_inline_elements.adoc[leveloffset=+1]

modules/ROOT/partials/configuration/powerpaste_emf_processor.adoc

@@ -0,0 +1,22 @@
+[[powerpaste_emf_processor]]
+== `+powerpaste_emf_processor+`
+
+This option controls how `emf` images are handled. If this option **is** provided, `emf` image blobs will be converted into `png` image blobs using the supplied function, which will then be pasted into the editor. If this option is **not** provided, the editor will remove the poor quality images, and show an error message.
+
+*Type:* `+Function+`
+
+=== Example: `+powerpaste_emf_processor+`
+
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',  // change this value according to your HTML
+  plugins: 'powerpaste',
+  powerpaste_word_import: 'clean',
+  powerpaste_emf_processor: (blob) => {
+	  return fetch('YOUR_IMAGE_URL').then(res => res.blob())
+	}
+  });
+----
+
+NOTE: If only the image is selected, pasting it will succeed and the image will be inserted correctly. However, if the image is selected together with other types of content, such as text, the image will not be pasted and an error message will be displayed.