feat: Export stripWhitespace function for direct string minification (

#237)

README.md

@@ -115,8 +115,12 @@ codeEditor.setContent(`
 
 ## Standalone minification
 
+### Template literals
+
 You can also do template literal minification separately. The `minify` function takes JavaScript source code as input and will minify template literals within it. It also takes the same options as `minifyTemplates` as a second argument.
 
+Also note that this exports a `MagicString` instance, so you need to call [magicstring's `.toString()`](https://github.com/Rich-Harris/magic-string#stostring) on it.
+
 ```js
 import { minify } from 'esbuild-minify-templates';
 
@@ -125,6 +129,18 @@ const result = minify('let a = `x     y`;');
 console.log(result.toString()); // 'let a = `x y`;'
 ```
 
+### HTML code strings
+
+In situations where you have HTML code as a plain string, this package also exports a `stripWhitespace` function for standalone use.
+
+```js
+import { stripWhitespace } from 'esbuild-minify-templates';
+
+const result = stripWhitespace('x     y');
+
+console.log(result); // 'x y'
+```
+
 ## Changelog
 
 See [releases on GitHub](https://github.com/maxmilton/esbuild-minify-templates/releases).

src/index.ts

@@ -29,6 +29,26 @@ const decoder = new TextDecoder();
 export const encodeUTF8 = (text: string): Uint8Array => encoder.encode(text);
 export const decodeUTF8 = (bytes: Uint8Array): string => decoder.decode(bytes);
 
+export function stripWhitespace(html: string, keepComments?: boolean): string {
+  let out = html
+    // reduce whitespace to a single space
+    .replace(/\s+/gm, ' ')
+    // remove space between tags
+    .replace(/> </g, '><')
+    // remove space between edge and start/end tags
+    .replace(/^ </g, '<')
+    .replace(/> $/g, '>')
+    // remove space around stage1 "node ref tags"
+    // https://github.com/MaxMilton/stage1
+    .replace(/> #(\w+) </g, '>#$1<');
+
+  if (!keepComments) {
+    out = out.replace(/<!--.*?-->/gs, '');
+  }
+
+  return out;
+}
+
 export function minify(code: string, opts: MinifyOptions = {}): MagicString {
   const out = new MagicString(code);
   const ignoreLines: number[] = [];
@@ -61,23 +81,11 @@ export function minify(code: string, opts: MinifyOptions = {}): MagicString {
       const { start, end } = node.loc;
 
       if (start.line !== end.line || start.column !== end.column) {
-        let content = node.value.raw
-          // reduce whitespace to a single space
-          .replace(/\s+/gm, ' ')
-          // remove space between tags
-          .replace(/> </g, '><')
-          // remove space between edge and start/end tags
-          .replace(/^ </g, '<')
-          .replace(/> $/g, '>')
-          // remove space around stage1 "node ref tags"
-          // https://github.com/MaxMilton/stage1
-          .replace(/> #(\w+) </g, '>#$1<');
-
-        if (!opts.keepComments) {
-          content = content.replace(/<!--.*?-->/gs, '');
-        }
-
-        out.overwrite(node.start, node.end, content);
+        out.overwrite(
+          node.start,
+          node.end,
+          stripWhitespace(node.value.raw, opts.keepComments),
+        );
       }
     },
   });

test/exports.test.ts

@@ -5,6 +5,7 @@ import * as assert from 'uvu/assert';
 import * as allExports from '../src/index';
 
 const publicExports = [
+  ['stripWhitespace', 'function'],
   ['minify', 'function'],
   ['minifyTemplates', 'function'],
   ['writeFiles', 'function'],