Remove html-webpack-tags-plugin, inject preflight tag from template

The plugin was unmaintained since 2021 and pulled in deprecated
glob@7/inflight transitive deps that surfaced as install warnings.
It was used in a single spot to inject the preflight.js script tag;
that tag now lives in static/index.html directly, with a preflightHash
template parameter (compilation hash) preserving cache-busting.

Also bumps terser-webpack-plugin 5.5 → 5.6 and adds a note to CLAUDE.md
documenting that this repo uses yarn (classic) as its package manager.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: amcclain

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## v13.0.0-SNAPSHOT
+
+### ⚙️ Technical
+
+* Removed `html-webpack-tags-plugin` dependency. It was used in a single spot to inject the
+  `preflight.js` script tag and has been unmaintained since 2021, pulling in deprecated
+  transitive deps (`glob@7`, `inflight`) that surfaced as warnings on install. The preflight
+  tag is now emitted directly from the `static/index.html` template, with a `preflightHash`
+  template parameter (sourced from the webpack compilation hash) preserving cache-busting.
+
+### 📚 Libraries
+
+* html-webpack-tags-plugin `3.0 → removed`
+* terser-webpack-plugin `5.5 → 5.6`
+
 ## v12.1.0 - 2026-04-29
 
 ### 🎁 New Features
@@ -12,7 +27,7 @@
 
 ### 📚 Libraries
 
-* terser-webpack-plugin `5.4 → 5.5`
+* terser-webpack-plugin `5.4 → 5.5`we u
 
 ## v12.0.1 - 2026-04-18
 

CLAUDE.md

@@ -37,6 +37,11 @@ Key behaviors:
 There is no build step — the package ships `configureWebpack.js` and `static/**/*` directly.
 There are no tests in this repo.
 
+**Package manager: yarn (classic, v1.x).** `yarn.lock` is the source of truth — do not invoke
+`npm install` or create a `package-lock.json`. If you need to inspect transitive-dep deprecation
+warnings (which yarn 1.x suppresses), use `yarn why <pkg>` or `npm ls <pkg>` in read-only fashion
+without reinstalling.
+
 ### Commands
 
 ```bash

configureWebpack.js

@@ -15,7 +15,6 @@ const _ = require('lodash'),
     CopyWebpackPlugin = require('copy-webpack-plugin'),
     MiniCssExtractPlugin = require('mini-css-extract-plugin'),
     HtmlWebpackPlugin = require('html-webpack-plugin'),
-    HtmlWebpackTagsPlugin = require('html-webpack-tags-plugin'),
     TerserPlugin = require('terser-webpack-plugin'),
     WebpackBar = require('webpackbar'),
     parseChangelogMarkdown = require('changelog-parser'),
@@ -660,7 +659,10 @@ async function configureWebpack(env) {
                             scriptTags,
                             clientAppName,
                             preloadBackgroundColor,
-                            preloadSpinnerColor
+                            preloadSpinnerColor,
+                            // Compilation hash used to cache-bust the (unbundled) preflight script
+                            // copied in from hoist-react via CopyWebpackPlugin.
+                            preflightHash: compilation.hash
                         };
                     },
                     // No need to minify the HTML itself
@@ -687,14 +689,6 @@ async function configureWebpack(env) {
                 });
             }),
 
-            // Insert a script tag for the (unbundled) preflight script, before all other scripts.
-            new HtmlWebpackTagsPlugin({
-                // Script available at this path via CopyWebpackPlugin above.
-                scripts: ['public/preflight.js'],
-                append: false,
-                hash: true
-            }),
-
             // Support an optional post-build/run interactive treemap of output bundles and their sizes / contents.
             analyzeBundles
                 ? new BundleAnalyzerPlugin({

package.json

@@ -33,7 +33,6 @@
         "css-loader": "~7.1.2",
         "file-loader": "~6.2.0",
         "html-webpack-plugin": "~5.6.0",
-        "html-webpack-tags-plugin": "~3.0.2",
         "lodash": "4.x",
         "mini-css-extract-plugin": "~2.10.1",
         "postcss": "~8.5.3",
@@ -44,7 +43,7 @@
         "sass-loader": "~16.0.4",
         "sass-material-colors": "~0.0.5",
         "style-loader": "~4.0.0",
-        "terser-webpack-plugin": "~5.5.0",
+        "terser-webpack-plugin": "~5.6.0",
         "type-fest": "5.x",
         "url-loader": "~4.1.1",
         "webpack": "~5.106.2",

static/index.html

@@ -21,6 +21,8 @@
 </head>
 <body class="xh-app" style="margin: 0">
 
+<script src="<%= webpackConfig.output.publicPath %>public/preflight.js?<%= preflightHash %>"></script>
+
 <noscript>
     This application requires that JavaScript be enabled for this site in your browser.
 </noscript>