Remove helpers.ts, sort into different files

core/string.ts

@@ -0,0 +1,96 @@
+/**
+ * HTML escape sequences for unsafe characters
+ */
+ export const HTML_ESCAPES = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#x27;",
+    "/": "&#x2F;",
+} as const
+
+/**
+ * Removes indentation from multiline strings.
+ * @since 2021-08-07
+ */
+export function dedent(
+    templ: TemplateStringsArray | string,
+    ...values: unknown[]
+): string {
+    let strings = Array.from(typeof templ === 'string' ? [templ] : templ)
+
+    // 1. Remove trailing whitespace.
+    strings[strings.length - 1] = strings[strings.length - 1].trimRight()
+
+    // 2. Find all line breaks to determine the highest common indentation level.
+    const indentLengths = strings.reduce((arr, str) => {
+        const matches = str.match(/\n([\t ]+|(?!\s).)/g)
+        if (matches) {
+            return arr.concat(
+                matches.map((match) => match.match(/[\t ]/g)?.length ?? 0)
+            )
+        }
+        return arr
+    }, <number[]>[])
+
+    // 3. Remove the common indentation from all strings.
+    if (indentLengths.length) {
+        const pattern = new RegExp(`\n[\t ]{${Math.min(...indentLengths)}}`, 'g')
+
+        strings = strings.map((str) => str.replace(pattern, '\n'))
+    }
+
+    // 4. Remove leading whitespace.
+    strings[0] = strings[0].trimStart()
+
+    // 5. Perform interpolation.
+    let string = strings[0]
+
+    values.forEach((value, i) => {
+        // 5.1 Read current indentation level
+        const endentations = string.match(/(?:^|\n)( *)$/)
+        const endentation = endentations ? endentations[1] : ''
+        let indentedValue = value
+        // 5.2 Add indentation to values with multiline strings
+        if (typeof value === 'string' && value.includes('\n')) {
+            indentedValue = String(value)
+                .split('\n')
+                .map((str, i) => i === 0 ? str : `${endentation}${str}`)
+                .join('\n')
+        }
+
+        string += indentedValue + strings[i + 1]
+    })
+
+    return string
+}
+
+/**
+ * A no-operation function for tagged template string literals
+ * @author MindfulMinun
+ * @since 2022-05-20
+ */
+export function templateNoop(
+    templ: TemplateStringsArray | string,
+    ...values: unknown[]
+): string {
+    if (typeof templ === 'string') return templ
+    return templ.reduce((result, currentString, i) =>
+        result + currentString + (typeof values[i] !== 'undefined' ? values[i] : ''),
+        '' // Start with the empty string
+    )
+}
+
+/**
+ * Escapes unsafe strings for use in HTML
+ * 
+ * ```js
+ * xss(`<img src="/bogus/path" onerror="alert('xss')">`)
+ * ```
+ * @author MindfulMinun
+ * @since 2020-06-23
+ */
+ export function xss(unsafe: string): string {
+    return unsafe.replace(/[&<>"'\/]/g, key => HTML_ESCAPES[key as keyof typeof HTML_ESCAPES])
+}