v11: release major (Node 22 baseline, lockfile repair)

.changeset/fix-minify-html-esm-interop.md

@@ -0,0 +1,9 @@
+---
+"@node-minify/minify-html": patch
+---
+
+Fix `minify-html` throwing `minifyHtmlLib.minify is not a function` at runtime.
+
+`@minify-html/node` is a CommonJS native addon, so under Node's ESM loader its exports are reachable only through the default export. The compressor called `minify` off the namespace object, which is always `undefined` there, making the package fail on every input when consumed from real Node.
+
+The bug was masked in CI: the error test mocked `@minify-html/node` with a flat `{ minify }` shape that does not match the real module, and Vitest's CommonJS interop resolved the namespace differently than Node does. The mock now mirrors the real default-export shape, and a regression test asserts the interop directly.

.changeset/v11-cleanup-major.md

@@ -0,0 +1,24 @@
+---
+"@node-minify/core": major
+---
+
+v11: cleanup major release.
+
+### Breaking changes
+
+- **Minimum Node.js is now 22**: `engines.node` moved from `>=20.0.0` to `>=22.0.0` across all packages. Node 20 reached end-of-life on 2026-04-30 and is no longer covered by CI (the test matrix runs 22.x and 24.x). Upgrade to Node 22 or later.
+- **Removed 5 deprecated compressor packages**: `@node-minify/babel-minify`, `@node-minify/uglify-es`, `@node-minify/yui`, `@node-minify/sqwish`, `@node-minify/crass`. Use the recommended replacements (terser/oxc/swc/esbuild for JS, lightningcss/cssnano for CSS).
+- **Removed `@node-minify/run`**: internal Java/process-spawn helper, no longer used by any compressor.
+- **Removed deprecated type aliases** from `@node-minify/types`: `CompressorReturnType` (use `CompressorResult`) and `MinifyOptions` (use `Settings`).
+- **Google Closure Compiler now uses the `google-closure-compiler` npm API** instead of invoking the Java JAR through `@node-minify/run`. Same flags and output. Note: the npm package still bundles `google-closure-compiler-java`, so Java may still be invoked under the hood — this change removes node-minify's custom Java plumbing, not Java itself.
+
+### New features
+
+- **Compressor support tiers**: shared status registry in `@node-minify/utils` (`recommended` / `supported` / `legacy` / `removed`), surfaced in CLI help and the GitHub Action.
+- **`node-minify doctor`**: read-only CLI command covering every v11 break. Scans `package.json`, source imports, `compressor:` values and workflow YAML for removed/legacy compressors, the removed `@node-minify/run` package, the removed `CompressorReturnType`/`MinifyOptions` type aliases, and `engines.node` ranges that still allow Node below 22. Exits non-zero on errors so it can gate CI.
+- **CLI and Action fail early** when a removed compressor is requested, pointing at the replacement.
+- **GCC runtime controls**: configurable `buffer` limit (kills the child process when stdout/stderr exceeds it) plus hardened process/timeout/error handling.
+
+### Migration
+
+See the [v11 migration guide](https://github.com/srod/node-minify/blob/main/docs/src/content/docs/guides/v11-migration.md), or run `npx --package=@node-minify/cli -- node-minify doctor` in your project.

.gitattributes

@@ -0,0 +1,3 @@
+# Shell scripts must keep LF endings: the Windows CI legs run them through Git
+# Bash, which fails to parse `set -euo pipefail\r` if Git checks them out CRLF.
+*.sh text eol=lf

.github/actions/node-minify/README.md

@@ -47,7 +47,7 @@ The following inputs are **not supported** in the new action and must be removed
 
 #### Java Compressors Migration
 
-If you use `gcc` or `yui` compressors that require Java:
+If you use the `gcc` compressor that requires Java:
 
 **Before (deprecated):**
 ```yaml
@@ -99,7 +99,7 @@ The following documentation is for the deprecated composite action.
 | `options` | Compressor options (JSON) | No | `{}` |
 | `report-summary` | Add results to job summary | No | `true` |
 | `include-gzip` | Include gzip sizes | No | `true` |
-| `java-version` | Java version for gcc/yui | No | - |
+| `java-version` | Java version for gcc | No | - |
 
 ### Outputs
 

.github/actions/node-minify/action.yml

@@ -13,14 +13,14 @@ inputs:
     description: |
       Compressor to use.
       Recommended: terser, esbuild, swc (fast, no Java).
-      Note: 'gcc' and 'yui' require Java (pre-installed on GitHub runners).
+      Note: 'gcc' may invoke Java (pre-installed on GitHub runners).
     required: false
     default: "terser"
   output:
     description: "Output file path"
     required: true
   type:
-    description: "File type: js or css (required for esbuild, yui)"
+    description: "File type: js or css (required for esbuild)"
     required: false
   options:
     description: "Compressor-specific options (JSON string)"
@@ -35,7 +35,7 @@ inputs:
     required: false
     default: "true"
   java-version:
-    description: "Java version for gcc/yui compressors (optional)"
+    description: "Java version for gcc compressor (optional)"
     required: false
 
 outputs:
@@ -72,23 +72,17 @@ runs:
       run: |
         echo "::warning::This action (.github/actions/node-minify) is DEPRECATED. Please migrate to 'uses: srod/node-minify@v1' for the new bundled action with more features (PR comments, annotations, benchmarking)."
 
-    - name: Setup Java (for gcc/yui)
-      if: contains(fromJSON('["gcc", "google-closure-compiler", "yui"]'), inputs.compressor)
+    - name: Setup Java (for gcc)
+      if: contains(fromJSON('["gcc", "google-closure-compiler"]'), inputs.compressor)
       uses: actions/setup-java@v4
       with:
         distribution: "temurin"
         java-version: ${{ inputs.java-version || '17' }}
 
-    - name: Deprecation warning (yui)
-      if: inputs.compressor == 'yui'
-      shell: bash
-      run: |
-        echo "::warning::YUI Compressor was deprecated by Yahoo in 2013. Consider using 'terser' for JS or 'lightningcss' for CSS."
-
     - name: Setup Bun
       uses: oven-sh/setup-bun@v2
       with:
-        bun-version: "1.3.10"
+        bun-version: "1.4.0"
 
     - name: Install dependencies
       shell: bash
@@ -100,7 +94,12 @@ runs:
         mkdir -p "$TEMP_DIR"
         cd "$TEMP_DIR"
         bun init -y
-        bun add @node-minify/core @node-minify/utils "@node-minify/${COMPRESSOR}"
+        # Map friendly compressor aliases to their package name (mirrors resolveAlias in @node-minify/utils).
+        PACKAGE="$COMPRESSOR"
+        case "$COMPRESSOR" in
+          gcc) PACKAGE="google-closure-compiler" ;;
+        esac
+        bun add @node-minify/core @node-minify/utils "@node-minify/${PACKAGE}"
         cp "$ACTION_PATH/minify.ts" "$TEMP_DIR/"
         echo "NODE_MINIFY_ACTION_DIR=$TEMP_DIR" >> $GITHUB_ENV
 

.github/actions/node-minify/minify.ts

@@ -109,7 +109,7 @@ async function run(): Promise<void> {
 
         console.log(`Minifying ${inputFile} with ${label}...`);
 
-        const requiresType = ["esbuild", "yui"].includes(compressorName);
+        const requiresType = compressorName === "esbuild";
         if (requiresType && !fileType) {
             console.error(
                 `::error::Compressor '${compressorName}' requires the 'type' input (js or css)`

.github/workflows/codeql.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.10"
+          bun-version: "1.4.0"
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

.github/workflows/publish.yml

@@ -27,7 +27,7 @@ jobs:
       - name: 📦 Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.10"
+          bun-version: "1.4.0"
 
       - name: ⚙️ Setup Node
         uses: actions/setup-node@v6

.github/workflows/release-action.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.10"
+          bun-version: "1.4.0"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/test-action.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.10"
+          bun-version: "1.4.0"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/test.yml

@@ -18,15 +18,15 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest]
-        node-version: [20.x, 22.x, 24.x]
+        node-version: [22.x, 24.x]
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.10"
+          bun-version: "1.4.0"
 
       - name: Set up JDK 11
         uses: actions/setup-java@v5
@@ -45,6 +45,12 @@ jobs:
       - name: Run tests
         run: bun run ci
 
+      - name: Guard - no removed compressor references
+        # Static grep over source, docs and action files: OS- and Node-version
+        # independent, so one leg is enough.
+        if: runner.os == 'Linux' && matrix.node-version == '22.x'
+        run: bash scripts/ci-guard-removed-compressors.sh
+
       - name: Upload coverage to Codecov
         if: runner.os == 'Linux'
         uses: codecov/codecov-action@v5

AGENTS.md

@@ -5,21 +5,22 @@ This file provides guidance to AI coding assistants when working with code in th
 **Generated:** 2026-01-28 | **Commit:** 9b0b0f5f | **Branch:** develop
 
 ## Requirements
-- **Node.js**: >=20.0.0
+- **Node.js**: >=22.0.0
 - **Bun**: 1.3.5+ (package manager & runtime)
 
 ## Commands
 | Task | Command |
 |------|---------|
 | Install | `bun install` |
 | Build all | `bun run build` |
-| Build deps first | `bun run build:deps` (utils + run) |
+| Build deps first | `bun run build:deps` (utils) |
 | Lint | `bun run lint` |
 | Format | `bun run format` |
 | Typecheck | `bun run typecheck` |
 | Test all | `bun run test` |
 | Test package | `bun run test packages/<name>` |
 | Test file | `bun run test packages/core/__tests__/core.test.ts` |
+| Doctor | `node-minify doctor` |
 | CI (full) | `bun run ci` |
 | Add changeset | `bun run changeset` |
 
@@ -42,7 +43,6 @@ packages/
 ├── core/           # Main minify() function
 ├── utils/          # Shared utilities (see packages/utils/AGENTS.md)
 ├── types/          # TypeScript definitions (no build, exports src/types.d.ts)
-├── run/            # Java process wrapper (YUI, GCC)
 ├── cli/            # Commander.js CLI
 ├── benchmark/      # Compressor comparison tool
 ├── action/         # GitHub Action (see packages/action/AGENTS.md)
@@ -59,7 +59,7 @@ packages/
 | **JSON** | `jsonminify` | - |
 | **Images** | `sharp` (WebP/AVIF), `svgo` (SVG), `imagemin` (PNG/JPEG/GIF) | - |
 
-**Deprecated** (emit warnings): `babel-minify`, `uglify-es`, `yui`, `crass`, `sqwish`
+**Removed** (v11): `babel-minify`, `uglify-es`, `yui`, `crass`, `sqwish`
 
 ### Dependencies
 ```
@@ -70,7 +70,7 @@ benchmark → core + utils
 compressors → utils + types
 ```
 
-**Build order**: `utils` + `run` first → all others parallel
+**Build order**: `utils` first → all others parallel
 
 ### Package Pattern
 ```
@@ -130,7 +130,7 @@ export async function myCompressor({ settings, content }: MinifierOptions): Prom
 
 **Convention**: Tests auto-isolate to `tests/tmp/` when using `replaceInPlace` or `$1` output patterns.
 
-**Timeouts**: Core/YUI packages use 60s timeout for slow Java compressors.
+**Timeouts**: Some packages use 60s timeout for slow compressors.
 
 ## Changesets
 
@@ -197,4 +197,3 @@ cd docs && bun run build  # Production build
 | Type errors | Run `bun run build` (types from `dist/`) |
 | Test isolation | Uses `tests/tmp/` (gitignored) |
 | Clean rebuild | `bun run clean && bun run build` |
-| Java compressors | Ensure Java installed for `yui`/`gcc` |

Readme.md

@@ -23,9 +23,6 @@ It allows you to compress JavaScript, CSS, HTML, and image files.
 - [swc](https://node-minify.2clics.net/compressors/swc)
 - [terser](https://node-minify.2clics.net/compressors/terser)
 - [uglify-js](https://node-minify.2clics.net/compressors/uglify-js)
-- [babel-minify](https://node-minify.2clics.net/compressors/babel-minify) _(deprecated)_
-- [uglify-es](https://node-minify.2clics.net/compressors/uglify-es) _(deprecated)_
-- [YUI Compressor](https://node-minify.2clics.net/compressors/yui) _(deprecated)_
 
 **CSS:**
 
@@ -34,12 +31,10 @@ It allows you to compress JavaScript, CSS, HTML, and image files.
 - [CSSO](https://node-minify.2clics.net/compressors/csso)
 - [esbuild](https://node-minify.2clics.net/compressors/esbuild)
 - [lightningcss](https://node-minify.2clics.net/compressors/lightningcss)
-- [crass](https://node-minify.2clics.net/compressors/crass) _(deprecated)_
-- [sqwish](https://node-minify.2clics.net/compressors/sqwish) _(deprecated)_
-- [YUI Compressor](https://node-minify.2clics.net/compressors/yui) _(deprecated)_
 
 **HTML:**
 
+- [minify-html](https://node-minify.2clics.net/compressors/minify-html) - Rust-based, recommended
 - [html-minifier](https://node-minify.2clics.net/compressors/html-minifier)
 
 **JSON:**
@@ -64,6 +59,15 @@ It allows you to compress JavaScript, CSS, HTML, and image files.
 
 - [Benchmark](https://node-minify.2clics.net/benchmark) - Compare compressor performance
 
+**Upgrading:**
+
+- [v11 Migration Guide](https://node-minify.2clics.net/guides/v11-migration) - Run `npx --package=@node-minify/cli -- node-minify doctor` to scan your project
+
+## Requirements
+
+- **Node.js**: 22 or higher
+- **Module System**: ESM only (`"type": "module"` in package.json)
+
 ## Installation
 
 ```bash
@@ -82,36 +86,37 @@ And install the compressor(s) you want:
 
 ```bash
 npm install @node-minify/terser        # Recommended - modern, fast, well-maintained
-npm install @node-minify/esbuild       # Extremely fast, also handles CSS
-npm install @node-minify/swc           # Rust-based, very fast
-npm install @node-minify/oxc           # Rust-based, cutting-edge
-npm install @node-minify/uglify-js     # Classic, battle-tested
-npm install @node-minify/google-closure-compiler  # Advanced optimizations
+npm install @node-minify/esbuild       # Recommended - extremely fast, also handles CSS
+npm install @node-minify/swc           # Recommended - Rust-based, very fast
+npm install @node-minify/oxc           # Recommended - Rust-based, cutting-edge
+npm install @node-minify/uglify-js     # Supported - classic, battle-tested
+npm install @node-minify/google-closure-compiler  # Supported - advanced optimizations
 ```
 
 ### CSS Compressors
 
 ```bash
 npm install @node-minify/lightningcss  # Recommended - Rust-based, fastest
-npm install @node-minify/esbuild       # Also handles JS
-npm install @node-minify/clean-css     # Feature-rich, reliable
-npm install @node-minify/cssnano       # PostCSS-based, customizable
-npm install @node-minify/csso          # Structural optimizations
+npm install @node-minify/cssnano       # Recommended - PostCSS-based, customizable
+npm install @node-minify/esbuild       # Recommended - also handles JS
+npm install @node-minify/clean-css     # Supported - feature-rich, reliable
+npm install @node-minify/csso          # Supported - structural optimizations
 ```
 
 ### HTML & Other
 
 ```bash
-npm install @node-minify/html-minifier # HTML minification
-npm install @node-minify/jsonminify    # JSON minification
+npm install @node-minify/minify-html   # Recommended - Rust-based, fastest
+npm install @node-minify/html-minifier # Supported - feature-rich HTML minification
+npm install @node-minify/jsonminify    # Legacy - JSON minification
 ```
 
 ### Image Compressors
 
 ```bash
-npm install @node-minify/sharp         # WebP/AVIF conversion, high performance
-npm install @node-minify/svgo          # SVG optimization
-npm install @node-minify/imagemin      # PNG/JPEG/GIF compression
+npm install @node-minify/sharp         # Recommended - WebP/AVIF conversion, high performance
+npm install @node-minify/svgo          # Recommended - SVG optimization
+npm install @node-minify/imagemin      # Supported - PNG/JPEG/GIF compression
 ```
 
 ## Quick Start

SKILL.md

@@ -49,7 +49,7 @@ const result = await minify({
 | **Images** | `sharp` (WebP/AVIF) | `svgo` (SVG), `imagemin` (PNG/JPEG/GIF) |
 | **Utility** | `no-compress` | Pass-through for concatenation without minification |
 
-**Deprecated (avoid)**: `babel-minify`, `uglify-es`, `yui`, `crass`, `sqwish`
+**Removed in v11** (will fail; use a replacement above): `babel-minify`, `uglify-es`, `yui`, `crass`, `sqwish`
 
 ## API Reference
 
@@ -62,7 +62,7 @@ type Settings = {
   output?: string | string[];       // Output path(s) or pattern: "$1.min.js"
   content?: string | Buffer;        // In-memory content (skip input/output)
   options?: Record<string, unknown>; // Compressor-specific options
-  type?: "js" | "css";              // Required for esbuild, yui
+  type?: "js" | "css";              // Required for esbuild
   publicFolder?: string;            // Prepend to input paths
   replaceInPlace?: boolean;         // Overwrite input files
   silence?: boolean;                // Suppress console output
@@ -158,7 +158,6 @@ await minify({
 | `esbuild` | Requires `type: "js"` or `type: "css"` |
 | `lightningcss` | Uses Buffer internally, supports `targets: { chrome: 95 }` |
 | `google-closure-compiler` | Requires Java; advanced optimizations available |
-| `yui` | Deprecated; requires Java; needs `type` |
 
 ## Error Handling
 

action.yml

@@ -34,11 +34,11 @@ inputs:
     description: |
       Compressor to use.
       Recommended: terser, esbuild, swc, oxc (fast, no Java).
-      Note: 'gcc' and 'yui' require Java (pre-installed on GitHub runners).
+      Note: 'gcc' may invoke Java (pre-installed on GitHub runners).
     required: false
     default: "terser"
   type:
-    description: "File type: js or css (required for esbuild, yui)"
+    description: "File type: js or css (required for esbuild)"
     required: false
   options:
     description: "Compressor-specific options (JSON string)"