vanilla-jet 1.6.1 → 1.6.2

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable project changes are documented in this file.
 
 The format follows a structure inspired by Keep a Changelog and semantic versioning.
 
+## [1.6.2] - 2026-06-30
+
+### Fixed
+
+- **Template externalization now self-cleans:** disabling `externalize_templates` (or never enabling it)
+  removes any previously generated `public/scripts/templates.js` (+ `.gz`/`.br`), so toggling the flag
+  never leaves a stale 749 KB file behind (which the service worker would otherwise precache).
+
+### Notes
+
+- **`externalize_templates` caveat (WebView):** it shrinks the initial HTML for web browsers, but it injects
+  all templates via one synchronous `innerHTML`. On slower JS engines (native WebViews — WKWebView /
+  Android WebView) that block can stall the boot. **Prefer it OFF for apps loaded primarily inside a
+  WebView**; keep it ON only for pure-web apps that benefit from a smaller first byte.
+
 ## [1.6.1] - 2026-06-29
 
 ### Security

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-jet",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "VannilaJet framework",
   "main": "index.js",
   "bin": {

package/scripts/compile_html.js

@@ -201,6 +201,10 @@ async function createHTMLFile(content, filePath) {
   // bundle (defer + document order), so views still find their templates in the DOM at boot.
   if (opts.externalize_templates) {
     minified = externalizeTemplates(minified);
+  } else {
+    // Feature off: remove any previously generated templates.js so a stale 749KB file
+    // isn't left behind (and isn't precached by the service worker).
+    removeStaleTemplatesFile();
   }
 
   const publicPath = path.join(processCwd(), '/public/pages');
@@ -218,6 +222,22 @@ async function createHTMLFile(content, filePath) {
   console.log(chalk.green(`Created gzipped version at: ${absolutePath}.gz`));
 }
 
+// -- Remove a previously generated public/scripts/templates.js (+ compressed siblings)
+// when externalization is disabled, so toggling the flag never leaves a stale file behind.
+function removeStaleTemplatesFile() {
+  const base = path.join(processCwd(), 'public', 'scripts', 'templates.js');
+  ['', '.gz', '.br'].forEach((ext) => {
+    try {
+      if (fs.existsSync(base + ext)) {
+        fs.unlinkSync(base + ext);
+        console.log(chalk.green(`VanillaJet - removed stale public/scripts/templates.js${ext}`));
+      }
+    } catch (err) {
+      // Non-fatal: never fail the build over cleanup.
+    }
+  });
+}
+
 // -- Move all <script type="text/template"> blocks out of the page into
 // public/scripts/templates.js (a tiny injector that adds them to the DOM). Returns the
 // page HTML with those blocks replaced by a single deferred <script> tag (placed where the