html-minifier-next 7.3.0 → 7.4.0

package/README.md

@@ -8,7 +8,7 @@ The project was based on [HTML Minifier Terser (HMT)](https://github.com/terser/
 
 ## Installation
 
-HTML Minifier Next is ESM-only and requires Node.js ≥22.
+HTML Minifier Next is ESM-only and requires Node.js ≥22.13.
 
 For use as a command-line app, use npx:
 
@@ -40,13 +40,13 @@ Use `npx html-minifier-next --help` to check all available options:
 | `--output <file>`, `-o <file>` | Specify output file (reads from `--input` file argument or STDIN; outputs to STDOUT if not specified) | File to file: `npx html-minifier-next input.html -o output.html`<br>File to file (explicit): `npx html-minifier-next -i input.html -o output.html`<br>Pipe to file: `cat input.html \| npx html-minifier-next -o output.html`<br>File to STDOUT: `npx html-minifier-next input.html` |
 | `--file-ext <extensions>`, `-f <extensions>` | Specify file extension(s) to process (comma-separated, overrides config file setting); defaults to `html,htm,shtml,shtm`; use `*` for all files | `--file-ext=html,php`, `--file-ext='*'` |
 | `--preset <name>`, `-p <name>` | Use a preset configuration (conservative or comprehensive) | `--preset=conservative` |
-| `--config-file <file>`, `-c <file>` | Use a configuration file | `--config-file=html-minifier-next.json` |
+| `--config-file <file>`, `-c <file>` | Use a configuration file (defaults to `html-minifier-next.config.json` in the working directory, if present) | `--config-file=path/to/config.json` |
 | `--verbose`, `-v` | Show detailed processing information (active options, file statistics) | `npx html-minifier-next --input-dir=src --output-dir=dist --verbose --collapse-whitespace` |
 | `--dry`, `-d` | Dry run: Process and report statistics without writing output | `npx html-minifier-next input.html --dry --collapse-whitespace` |
 
 ### Configuration file
 
-You can use a configuration file to specify options. The file can be either in JSON format or a JavaScript module that exports the configuration object:
+You can use a configuration file to specify options. If an `html-minifier-next.config.json` file is present in the current working directory—only there; subfolders (including `--input-dir`) and parent folders are not searched—the CLI picks it up automatically, with a note on STDERR confirming this. An explicit `--config-file` takes precedence. (The standalone `--zero` mode is deliberately config-free and ignores default config files.) The file can be either in JSON format or a JavaScript module that exports the configuration object:
 
 **JSON configuration example:**
 
@@ -112,8 +112,8 @@ To review the specific options set, [presets.js](https://github.com/j9t/html-min
 npx html-minifier-next --preset conservative input.html
 
 # Via config file
-npx html-minifier-next --config-file=html-minifier-next.json input.html
-# where html-minifier-next.json contains: { "preset": "conservative" }
+npx html-minifier-next --config-file=path/to/config.json input.html
+# where config.json contains `{ "preset": "conservative" }`
 
 # Override preset options
 npx html-minifier-next --preset conservative --remove-empty-attributes input.html
@@ -432,8 +432,8 @@ npx html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist
 # Process only specific extensions
 npx html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist --file-ext=html,php
 
-# Using configuration file that sets `fileExt` (e.g., `"fileExt": "html,php"`)
-npx html-minifier-next --config-file=html-minifier-next.json --input-dir=src --output-dir=dist
+# Using a configuration file that sets `fileExt` (e.g., `"fileExt": "html,php"`)
+npx html-minifier-next --config-file=path/to/config.json --input-dir=src --output-dir=dist
 
 # Process all files (explicit wildcard)
 npx html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist --file-ext='*'
@@ -584,7 +584,7 @@ ignoreCustomFragments: [/\{%[\s\S]{0,1000}?%\}/, /\{\{[\s\S]{0,500}?\}\}/]
 **CLI (via config file—recommended):**
 
 ```shell
-npx html-minifier-next --config-file=config.json input.html
+npx html-minifier-next --config-file=path/to/config.json input.html
 ```
 
 **CLI (inline—not recommended due to complex escaping):**
@@ -645,7 +645,7 @@ Parameters:
 * `--save`: Saves the run as the baseline (e.g., on `main` before switching to a branch)
 * `--core`: Disables the external minifiers (CSS, JS, SVG, URLs) to isolate HMN’s own processing time
 * `--iterations=N`: Sets the number of timed iterations (default 5; the median is reported)
-* `--config=PATH`: Uses an alternative options file (default `html-minifier-next.json`)
+* `--config=PATH`: Uses an alternative options file (default `html-minifier-next.config.json`)
 
 To compare branches (A/B run), execute `npm run benchmark -- --save` on `main`, then `npm run benchmark` on the branch to see the deltas. Add `--core` on both ends when measuring changes to HMN’s own code rather than the bundled minifiers.
 

package/cli.js

@@ -229,6 +229,10 @@ async function loadConfigFromPath(configPath) {
 // Config keys the CLI handles itself, beyond the options in `optionDefinitions`
 const CONFIG_KEYS_EXTRA = new Set(['$schema', 'preset', 'fileExt', 'ignoreDir']);
 
+// Default config files, looked up in the working directory in this order when
+// `--config-file` isn’t specified
+const CONFIG_FILES_DEFAULT = ['html-minifier-next.config.json', 'htmlminifier.config.json'];
+
 /**
  * Normalize and validate config object by applying parsers and transforming values.
  * @param {object} config - Raw config object
@@ -387,10 +391,17 @@ program.helpOption('-h, --help', 'Display help for command');
     }
   }
 
-  // Load and normalize config if `--config-file` was specified
+  // Load and normalize config if `--config-file` was specified; otherwise look
+  // for a default config file in the working directory
   if (programOptions.configFile) {
     config = await loadConfigFromPath(programOptions.configFile);
     config = normalizeConfig(config);
+  } else {
+    const configFileDefault = CONFIG_FILES_DEFAULT.find(name => fs.existsSync(path.resolve(name)));
+    if (configFileDefault) {
+      console.error(`Using config file “${configFileDefault}”`);
+      config = normalizeConfig(await loadConfigFromPath(configFileDefault));
+    }
   }
 
   function createOptions() {

package/package.json

@@ -9,21 +9,21 @@
     "commander": "^15.0.0",
     "entities": "^8.0.0",
     "lightningcss": "^1.32.0",
-    "svgo": "^4.0.1",
-    "terser": "^5.47.1"
+    "svgo": "^4.0.2",
+    "terser": "^5.49.0"
   },
   "description": "Super-configurable and well-tested web page minifier (enhanced successor to HTML Minifier)",
   "devDependencies": {
-    "@commitlint/cli": "^21.2.0",
+    "@commitlint/cli": "^21.2.1",
     "@eslint/js": "^10.0.1",
-    "@swc/core": "^1.15.41",
+    "@swc/core": "^1.15.43",
     "@types/node": "^26.1.1",
-    "eslint": "^10.6.0",
+    "eslint": "^10.7.0",
     "typescript": "^7.0.2",
-    "vite": "^8.0.16"
+    "vite": "^8.1.5"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.13"
   },
   "exports": {
     ".": {
@@ -93,5 +93,5 @@
     "test:watch": "node --test --watch tests/*.spec.js"
   },
   "type": "module",
-  "version": "7.3.0"
+  "version": "7.4.0"
 }