enmi-conf.org: comparison wp/wp-includes/js/dist/autop.js

Mercurial Mercurial > enmi-conf.org / comparison

summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help

wp/wp-includes/js/dist/autop.js

changeset 22	8c2e4d02f4ef
parent 21	48c4eec2b7e6

equal deleted inserted replaced

-:48c4eec2b7e6
+:8c2e4d02f4ef
 /* harmony export */   autop: () => (/* binding */ autop),
 /* harmony export */   removep: () => (/* binding */ removep)
 /* harmony export */ });
 /**
 * The regular expression for an HTML element.
-*
-* @type {RegExp}
 */
 const htmlSplitRegex = (() => {
 /* eslint-disable no-multi-spaces */
 const comments = '!' +
 // Start of comment, after the <.
 })();
 /**
 * Separate HTML elements and comments from the text.
 *
-* @param {string} input The text which has to be formatted.
+* @param input The text which has to be formatted.
 *
-* @return {string[]} The formatted text.
+* @return The formatted text.
 */
 function htmlSplit(input) {
 const parts = [];
 let workingInput = input;
 let match;
 while (match = workingInput.match(htmlSplitRegex)) {
 // The `match` result, when invoked on a RegExp with the `g` flag (`/foo/g`) will not include `index`.
 // If the `g` flag is omitted, `index` is included.
 // `htmlSplitRegex` does not have the `g` flag so we can assert it will have an index number.
 // Assert `match.index` is a number.
-const index = /** @type {number} */match.index;
+const index = match.index;
 parts.push(workingInput.slice(0, index));
 parts.push(match[0]);
 workingInput = workingInput.slice(index + match[0].length);
 }
 if (workingInput.length) {
 }
 /**
 * Replace characters or phrases within HTML elements only.
 *
-* @param {string}                haystack     The text which has to be formatted.
+* @param haystack     The text which has to be formatted.
-* @param {Record<string,string>} replacePairs In the form {from: 'to', …}.
+* @param replacePairs In the form {from: 'to', …}.
 *
-* @return {string} The formatted text.
+* @return The formatted text.
 */
 function replaceInHtmlTags(haystack, replacePairs) {
 // Find all elements.
 const textArr = htmlSplit(haystack);
 let changed = false;
 *
 * A group of regex replaces used to identify text formatted with newlines and
 * replace double line-breaks with HTML paragraph tags. The remaining line-
 * breaks after conversion become `<br />` tags, unless br is set to 'false'.
 *
-* @param {string}  text The text which has to be formatted.
+* @param text The text which has to be formatted.
-* @param {boolean} br   Optional. If set, will convert all remaining line-
+* @param br   Optional. If set, will convert all remaining line-
-*                       breaks after paragraphing. Default true.
+*             breaks after paragraphing. Default true.
 *
 * @example
 *```js
 * import { autop } from '@wordpress/autop';
 * autop( 'my text' ); // "<p>my text</p>"
 * ```
 *
-* @return {string} Text which has been converted into paragraph tags.
+* @return Text which has been converted into paragraph tags.
 */
 function autop(text, br = true) {
 const preTags = [];
 if (text.trim() === '') {
 return '';
 * Replaces `<p>` tags with two line breaks. "Opposite" of autop().
 *
 * Replaces `<p>` tags with two line breaks except where the `<p>` has attributes.
 * Unifies whitespace. Indents `<li>`, `<dt>` and `<dd>` for better readability.
 *
-* @param {string} html The content from the editor.
+* @param html The content from the editor.
 *
 * @example
 * ```js
 * import { removep } from '@wordpress/autop';
 * removep( '<p>my text</p>' ); // "my text"
 * ```
 *
-* @return {string} The content with stripped paragraph tags.
+* @return The content with stripped paragraph tags.
 */
 function removep(html) {
 const blocklist = 'blockquote|ul|ol|li|dl|dt|dd|table|thead|tbody|tfoot|tr|th|td|h[1-6]|fieldset|figure';
 const blocklist1 = blocklist + '|div|p';
 const blocklist2 = blocklist + '|pre';
-/** @type {string[]} */
 const preserve = [];
 let preserveLinebreaks = false;
 let preserveBr = false;
 if (!html) {
 return '';
 }
 // Restore preserved tags.
 if (preserve.length) {
 html = html.replace(/<wp-preserve>/g, () => {
-return /** @type {string} */preserve.shift();
+return preserve.shift();
 });
 }
 return html;
 }

enmi-conf.org