`;\n\n// default widow word removal libs are not aware of HTML:\n// -----------------------------------------------------------------------------\n\nassert.equal(\n removeWidows(someHtml).res,\n `The quick brown fox jumps of the lazy dog.` // 😱\n);\n\n// luckily, removeWidows() consumes optional HTML tag locations\nassert.equal(\n removeWidows(someHtml, {\n tagRanges: stripHtml(someHtml)\n // remove the third argument, what to insert (\" \" string in these cases)\n .ranges.map(([from, to]) => [from, to]),\n }).res,\n `The quick brown fox jumps of the lazy dog.

` // ✅\n);"}} \ No newline at end of file diff --git a/includes/external/school/node_modules/string-strip-html/examples/cb-which-does-nothing.js b/includes/external/school/node_modules/string-strip-html/examples/cb-which-does-nothing.js new file mode 100644 index 0000000..2145c46 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/cb-which-does-nothing.js @@ -0,0 +1,33 @@ +// A Bypass Callback and a Do-Nothing Callback + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +// this callback just pushes proposed result to "rangesArr", +// that's what gets used in the result calculation: +const cb1 = ({ + tag, + deleteFrom, + deleteTo, + insert, + rangesArr, + proposedReturn, +}) => { + rangesArr.push(deleteFrom, deleteTo, insert); +}; +const result1 = stripHtml("abc

def", { cb: cb1 }).result; +assert.equal(result1, `abc def`); + +// to prove it works, don't do anything: +const cb2 = ({ + tag, + deleteFrom, + deleteTo, + insert, + rangesArr, + proposedReturn, +}) => { + // nothing here 🙈 +}; +const result2 = stripHtml("abc

def", { cb: cb2 }).result; +assert.equal(result2, "abc

def"); diff --git a/includes/external/school/node_modules/string-strip-html/examples/extract-html-head-contents.js b/includes/external/school/node_modules/string-strip-html/examples/extract-html-head-contents.js new file mode 100644 index 0000000..5c09d52 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/extract-html-head-contents.js @@ -0,0 +1,42 @@ +// Extract HTML `` contents + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +const someHtml = ` + + + + the title + + + the content + +`; + +// The task asks not to include and . +// First, extract head tag-to-head tag, including contents +const headWithHeadTags = stripHtml(someHtml, { + onlyStripTags: ["head"], + stripTogetherWithTheirContents: ["head"], +}) + .filteredTagLocations.reduce( + (acc, [from, to]) => `${acc}${someHtml.slice(from, to)}`, + "" + ) + .trim(); + +assert.equal( + headWithHeadTags, + ` + + the title + ` +); + +const headContents = headWithHeadTags.replace(/<\/?head>/g, "").trim(); +assert.equal( + headContents, + ` + the title` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/inline-tags.js b/includes/external/school/node_modules/string-strip-html/examples/inline-tags.js new file mode 100644 index 0000000..622999a --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/inline-tags.js @@ -0,0 +1,23 @@ +// Just deletes inline tags + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +const someHtml = `This has an unbold word.`; + +// default behaviour: +assert.equal(stripHtml(someHtml).result, `This has an un bold word.`); + +// let's tackle inline tags: +assert.equal( + stripHtml(someHtml, { + cb: ({ tag, deleteFrom, deleteTo, insert, rangesArr }) => { + if (["b", "strong"].includes(tag.name)) { + rangesArr.push(tag.lastOpeningBracketAt, tag.lastClosingBracketAt + 1); + } else { + rangesArr.push(deleteFrom, deleteTo, insert); + } + }, + }).result, + `This has an unbold word.` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/leave-only-html.js b/includes/external/school/node_modules/string-strip-html/examples/leave-only-html.js new file mode 100644 index 0000000..93e21a8 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/leave-only-html.js @@ -0,0 +1,24 @@ +// Leave only HTML + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +const someHtml = ` + + + + + + +

Title

+ Some text. + +`; + +assert.equal( + stripHtml(someHtml).allTagLocations.reduce( + (acc, [from, to]) => `${acc}${someHtml.slice(from, to)}`, + "" + ), + `

` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/leave-only-opening-td.js b/includes/external/school/node_modules/string-strip-html/examples/leave-only-opening-td.js new file mode 100644 index 0000000..e8ba37f --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/leave-only-opening-td.js @@ -0,0 +1,62 @@ +// Leave only opening `td` tags + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +const someHtml = ` + + + + + + + + +

+ cell1 +	+ cell2 +
+ cell3 +	+ cell4 +

`; + +// the first way +// ----------------------------------------------------------------------------- + +assert.equal( + stripHtml(someHtml, { + // notice there's no: onlyStripTags: ["td"] + // we operate purely via callback + cb: ({ tag, deleteFrom, deleteTo, insert, rangesArr, proposedReturn }) => { + if (tag.name === "td" && !tag.slashPresent) { + rangesArr.push(proposedReturn); + } + }, + }).ranges.reduce( + (acc, [from, to]) => `${acc}${someHtml.slice(from, to).trim()}`, + "" + ), + `` +); + +// the second way: +// ----------------------------------------------------------------------------- + +let resultStr = ""; +// notice we don't even assign stripHtml() output to anything - we rely only +// on the callback, it mutates the "resultStr" in the upper scope +stripHtml(someHtml, { + // notice there's no: onlyStripTags: ["td"] + // we operate purely via callback + cb: ({ tag, deleteFrom, deleteTo, insert, rangesArr, proposedReturn }) => { + if (tag.name === "td" && !tag.slashPresent) { + resultStr += someHtml.slice(deleteFrom, deleteTo).trim(); + } + }, +}); +assert.equal( + resultStr, + `` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/leave-only-td.js b/includes/external/school/node_modules/string-strip-html/examples/leave-only-td.js new file mode 100644 index 0000000..af0b2cd --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/leave-only-td.js @@ -0,0 +1,33 @@ +// Leave only `td` tags + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +const someHtml = ` + + + + + + + + +

+ cell1 +	+ cell2 +
+ cell3 +	+ cell4 +

`; + +assert.equal( + stripHtml(someHtml, { + onlyStripTags: ["td"], + }).filteredTagLocations.reduce( + (acc, [from, to]) => `${acc}${someHtml.slice(from, to)}`, + "" + ), + `` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/minimal-ranges.js b/includes/external/school/node_modules/string-strip-html/examples/minimal-ranges.js new file mode 100644 index 0000000..91dcbf7 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/minimal-ranges.js @@ -0,0 +1,33 @@ +// Minimal example using Ranges + +// We strip tags and fix apostrophes +// that's part of what https://codsen.com/os/detergent/ does + +import { strict as assert } from "assert"; +import { rApply } from "../../ranges-apply"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; +import { convertAll } from "../../string-apostrophes"; + +function stripAndFixApos(str) { + if (!str || typeof str !== "string") { + return ""; + } + // Keep in mind, Ranges are array of 2-3 element arrays. + // But absent Ranges are marked as null, not empty array. + // It's so that we could test in "if-else" easily - null + // is falsy but empty array is truthy. + // That's why below we take precautions with "|| []". + return rApply( + str, + (stripHtml(str).ranges || []).concat(convertAll(str).ranges || []) + ); +} + +// strips tags and fixes apostrophes: +assert.equal( + stripAndFixApos(`Let's Go Larval`), + `Let’s Go Larval` +); + +// no tags, no apostrophes: +assert.equal(stripAndFixApos(`zzz`), `zzz`); diff --git a/includes/external/school/node_modules/string-strip-html/examples/remove-html.js b/includes/external/school/node_modules/string-strip-html/examples/remove-html.js new file mode 100644 index 0000000..b45894e --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/remove-html.js @@ -0,0 +1,18 @@ +// Remove all HTML from a string + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +const someHtml = ` + + + + + + +

Title

+ Some text. + +`; + +assert.equal(stripHtml(someHtml).result, `Title\nSome text.`); diff --git a/includes/external/school/node_modules/string-strip-html/examples/strip-from-json.js b/includes/external/school/node_modules/string-strip-html/examples/strip-from-json.js new file mode 100644 index 0000000..95d8bd0 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/strip-from-json.js @@ -0,0 +1,41 @@ +// Strip HTML from a raw JSON string + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; +import { traverse } from "../../ast-monkey-traverse"; + +const stripFromJsonStr = (str) => { + return traverse(JSON.parse(str), (key, val) => { + // if currently an object is traversed, you get both "key" and "val" + // if it's array, only "key" is present, "val" is undefined + const current = val !== undefined ? val : key; + if ( + // ensure it's a plain object, not array (monkey will report only "key" in + // arrays and "val" will be undefined) + // also ensure object's value a string, not boolean or number, because we + // don't strip HTML from booleans or numbers or anything else than strings + typeof val === "string" + ) { + // monkey's callback is like Array.map - whatever you return gets written: + return stripHtml(val).result; + } + // default return, do nothing: + return current; + }); +}; + +// nothing to strip, "<" is false alarm: +assert.equal( + JSON.stringify(stripFromJsonStr(`{"Operator":"<","IsValid":true}`), null, 0), + `{"Operator":"<","IsValid":true}` +); + +// some HTML within one of key values, monkey will skip the boolean: +assert.equal( + JSON.stringify( + stripFromJsonStr(`{"Operator":"a

c","IsValid":true}`), + null, + 0 + ), + `{"Operator":"a b c","IsValid":true}` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/title-case-with-tag-skipping.js b/includes/external/school/node_modules/string-strip-html/examples/title-case-with-tag-skipping.js new file mode 100644 index 0000000..c248346 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/title-case-with-tag-skipping.js @@ -0,0 +1,54 @@ +// Set the title case using `title` package + +// This program will not touch any single tags (
for example) +// or in case of paired tags, paired tags and content between + +import { strict as assert } from "assert"; +import title from "title"; +import { rInvert } from "../../ranges-invert"; +import { rApply } from "../../ranges-apply"; +import { rRegex } from "../../ranges-regex"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; + +function tagAwareTitle(str) { + const whitelist = ["eslint", "readme", "npm"]; + const { filteredTagLocations } = stripHtml(str, { + stripTogetherWithTheirContents: ["*"], + }); + const inverted = rInvert( + filteredTagLocations.concat( + whitelist.reduce((acc, curr) => { + const rangesFindings = rRegex(new RegExp(curr, "gi"), str); + if (rangesFindings) { + return acc.concat(rangesFindings); + } + return acc; + }, []) + ), + str.length + ); + + if (Array.isArray(inverted) && inverted.length) { + // take inverted ranges, for example, [[3, 4], [10, 15]] + // and add third element, replacement, which is same character + // indexes only processed through "title": + return rApply( + str, + inverted.map(([from, to]) => [from, to, title(str.slice(from, to))]) + ); + } + // otherwise, just apply title() on the whole string: + return title(str); +} + +// middle: +assert.equal( + tagAwareTitle(`This is a title with some code in it`), + `This Is a Title with Some code In It` +); + +// leading: +assert.equal( + tagAwareTitle(`abc defgh ESLint`), + `abc Defgh ESLint` +); diff --git a/includes/external/school/node_modules/string-strip-html/examples/widow-word-removal-from-html.js b/includes/external/school/node_modules/string-strip-html/examples/widow-word-removal-from-html.js new file mode 100644 index 0000000..bcc07b1 --- /dev/null +++ b/includes/external/school/node_modules/string-strip-html/examples/widow-word-removal-from-html.js @@ -0,0 +1,25 @@ +// Widow word removal from text within HTML + +import { strict as assert } from "assert"; +import { stripHtml } from "../dist/string-strip-html.esm.js"; +import { removeWidows } from "../../string-remove-widows"; + +const someHtml = `The quick brown fox jumps of the lazy dog.

`; + +// default widow word removal libs are not aware of HTML: +// ----------------------------------------------------------------------------- + +assert.equal( + removeWidows(someHtml).res, + `The quick brown fox jumps of the lazy dog.` // 😱 +); + +// luckily, removeWidows() consumes optional HTML tag locations +assert.equal( + removeWidows(someHtml, { + tagRanges: stripHtml(someHtml) + // remove the third argument, what to insert (" " string in these cases) + .ranges.map(([from, to]) => [from, to]), + }).res, + `The quick brown fox jumps of the lazy dog.

` // ✅ +); -- cgit

\n cell1\n	\n cell2\n
\n cell3\n	\n cell4\n

\n cell1\n	\n cell2\n
\n cell3\n	\n cell4\n