@ckeditor/ckeditor5-clipboard 38.1.1 → 38.2.0-alpha.1

package/src/utils/plaintexttohtml.js

@@ -1,37 +1,37 @@
-/**
- * @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 clipboard/utils/plaintexttohtml
- */
-/**
- * Converts plain text to its HTML-ized version.
- *
- * @param text The plain text to convert.
- * @returns HTML generated from the plain text.
- */
-export default function plainTextToHtml(text) {
-    text = text
-        // Encode <>.
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        // Creates a paragraph for each double line break.
-        .replace(/\r?\n\r?\n/g, '</p><p>')
-        // Creates a line break for each single line break.
-        .replace(/\r?\n/g, '<br>')
-        // Replace tabs with four spaces.
-        .replace(/\t/g, '&nbsp;&nbsp;&nbsp;&nbsp;')
-        // Preserve trailing spaces (only the first and last one – the rest is handled below).
-        .replace(/^\s/, '&nbsp;')
-        .replace(/\s$/, '&nbsp;')
-        // Preserve other subsequent spaces now.
-        .replace(/\s\s/g, ' &nbsp;');
-    if (text.includes('</p><p>') || text.includes('<br>')) {
-        // If we created paragraphs above, add the trailing ones.
-        text = `<p>${text}</p>`;
-    }
-    // TODO:
-    // * What about '\nfoo' vs ' foo'?
-    return text;
-}
+/**
+ * @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 clipboard/utils/plaintexttohtml
+ */
+/**
+ * Converts plain text to its HTML-ized version.
+ *
+ * @param text The plain text to convert.
+ * @returns HTML generated from the plain text.
+ */
+export default function plainTextToHtml(text) {
+    text = text
+        // Encode <>.
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        // Creates a paragraph for each double line break.
+        .replace(/\r?\n\r?\n/g, '</p><p>')
+        // Creates a line break for each single line break.
+        .replace(/\r?\n/g, '<br>')
+        // Replace tabs with four spaces.
+        .replace(/\t/g, '&nbsp;&nbsp;&nbsp;&nbsp;')
+        // Preserve trailing spaces (only the first and last one – the rest is handled below).
+        .replace(/^\s/, '&nbsp;')
+        .replace(/\s$/, '&nbsp;')
+        // Preserve other subsequent spaces now.
+        .replace(/\s\s/g, ' &nbsp;');
+    if (text.includes('</p><p>') || text.includes('<br>')) {
+        // If we created paragraphs above, add the trailing ones.
+        text = `<p>${text}</p>`;
+    }
+    // TODO:
+    // * What about '\nfoo' vs ' foo'?
+    return text;
+}

package/src/utils/viewtoplaintext.d.ts

@@ -1,15 +1,15 @@
-/**
- * @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 clipboard/utils/viewtoplaintext
- */
-import type { ViewDocumentFragment, ViewItem } from '@ckeditor/ckeditor5-engine';
-/**
- * Converts {@link module:engine/view/item~Item view item} and all of its children to plain text.
- *
- * @param viewItem View item to convert.
- * @returns Plain text representation of `viewItem`.
- */
-export default function viewToPlainText(viewItem: ViewItem | ViewDocumentFragment): string;
+/**
+ * @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 clipboard/utils/viewtoplaintext
+ */
+import type { ViewDocumentFragment, ViewItem } from '@ckeditor/ckeditor5-engine';
+/**
+ * Converts {@link module:engine/view/item~Item view item} and all of its children to plain text.
+ *
+ * @param viewItem View item to convert.
+ * @returns Plain text representation of `viewItem`.
+ */
+export default function viewToPlainText(viewItem: ViewItem | ViewDocumentFragment): string;

package/src/utils/viewtoplaintext.js

@@ -1,50 +1,50 @@
-/**
- * @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
- */
-// Elements which should not have empty-line padding.
-// Most `view.ContainerElement` want to be separate by new-line, but some are creating one structure
-// together (like `<li>`) so it is better to separate them by only one "\n".
-const smallPaddingElements = ['figcaption', 'li'];
-/**
- * Converts {@link module:engine/view/item~Item view item} and all of its children to plain text.
- *
- * @param viewItem View item to convert.
- * @returns Plain text representation of `viewItem`.
- */
-export default function viewToPlainText(viewItem) {
-    let text = '';
-    if (viewItem.is('$text') || viewItem.is('$textProxy')) {
-        // If item is `Text` or `TextProxy` simple take its text data.
-        text = viewItem.data;
-    }
-    else if (viewItem.is('element', 'img') && viewItem.hasAttribute('alt')) {
-        // Special case for images - use alt attribute if it is provided.
-        text = viewItem.getAttribute('alt');
-    }
-    else if (viewItem.is('element', 'br')) {
-        // A soft break should be converted into a single line break (#8045).
-        text = '\n';
-    }
-    else {
-        // Other elements are document fragments, attribute elements or container elements.
-        // They don't have their own text value, so convert their children.
-        let prev = null;
-        for (const child of viewItem.getChildren()) {
-            const childText = viewToPlainText(child);
-            // Separate container element children with one or more new-line characters.
-            if (prev && (prev.is('containerElement') || child.is('containerElement'))) {
-                if (smallPaddingElements.includes(prev.name) ||
-                    smallPaddingElements.includes(child.name)) {
-                    text += '\n';
-                }
-                else {
-                    text += '\n\n';
-                }
-            }
-            text += childText;
-            prev = child;
-        }
-    }
-    return text;
-}
+/**
+ * @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
+ */
+// Elements which should not have empty-line padding.
+// Most `view.ContainerElement` want to be separate by new-line, but some are creating one structure
+// together (like `<li>`) so it is better to separate them by only one "\n".
+const smallPaddingElements = ['figcaption', 'li'];
+/**
+ * Converts {@link module:engine/view/item~Item view item} and all of its children to plain text.
+ *
+ * @param viewItem View item to convert.
+ * @returns Plain text representation of `viewItem`.
+ */
+export default function viewToPlainText(viewItem) {
+    let text = '';
+    if (viewItem.is('$text') || viewItem.is('$textProxy')) {
+        // If item is `Text` or `TextProxy` simple take its text data.
+        text = viewItem.data;
+    }
+    else if (viewItem.is('element', 'img') && viewItem.hasAttribute('alt')) {
+        // Special case for images - use alt attribute if it is provided.
+        text = viewItem.getAttribute('alt');
+    }
+    else if (viewItem.is('element', 'br')) {
+        // A soft break should be converted into a single line break (#8045).
+        text = '\n';
+    }
+    else {
+        // Other elements are document fragments, attribute elements or container elements.
+        // They don't have their own text value, so convert their children.
+        let prev = null;
+        for (const child of viewItem.getChildren()) {
+            const childText = viewToPlainText(child);
+            // Separate container element children with one or more new-line characters.
+            if (prev && (prev.is('containerElement') || child.is('containerElement'))) {
+                if (smallPaddingElements.includes(prev.name) ||
+                    smallPaddingElements.includes(child.name)) {
+                    text += '\n';
+                }
+                else {
+                    text += '\n\n';
+                }
+            }
+            text += childText;
+            prev = child;
+        }
+    }
+    return text;
+}