html-minifier-next 5.1.6 → 5.2.0

package/README.md

@@ -14,12 +14,14 @@ From npm for use as a command-line app:
 npm i -g html-minifier-next
 ```
 
-Directly with npx (no installation required):
+Directly with npx:
 
 ```shell
 npx html-minifier-next --help
 ```
 
+(For immediate, zero-config use in the current folder: `npx html-minifier-next --zero`)
+
 From npm for programmatic use:
 
 ```shell
@@ -34,11 +36,12 @@ Use `html-minifier-next --help` to check all available options:
 
 | Option | Description | Example |
 | --- | --- | --- |
+| `--zero`, `-z` | Minify all HTML files in the current folder and its subfolders in place (except node_modules), using comprehensive settings (standalone—flag is ignored when combined with other options) | `html-minifier-next --zero` |
 | `--input-dir <dir>`, `-I <dir>` | Specify an input directory | `--input-dir=src` |
 | `--ignore-dir <patterns>`, `-X <patterns>` | Exclude directories—relative to input directory—from processing (comma-separated, overrides config file setting) | `--ignore-dir=libs`, `--ignore-dir=libs,vendor,node_modules` |
 | `--output-dir <dir>`, `-O <dir>` | Specify an output directory | `--output-dir=dist` |
 | `--output <file>`, `-o <file>` | Specify output file (reads from file arguments or STDIN) | File to file: `html-minifier-next input.html -o output.html`<br>Pipe to file: `cat input.html \| html-minifier-next -o output.html`<br>File to STDOUT: `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,xhtml,shtml`; use `*` for all files | `--file-ext=html,php`, `--file-ext='*'` |
+| `--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.json` |
 | `--verbose`, `-v` | Show detailed processing information (active options, file statistics) | `html-minifier-next --input-dir=src --output-dir=dist --verbose --collapse-whitespace` |
@@ -400,7 +403,7 @@ npx html-minifier-next --input-dir=test --preset comprehensive --output-dir exam
 **Process specific files and directories:**
 
 ```shell
-# Process default extensions (html, htm, xhtml, shtml)
+# Process default extensions (html, htm, shtml, shtm)
 html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist
 
 # Process only specific extensions

package/cli.js

@@ -32,6 +32,7 @@ import fs from 'fs';
 import path from 'path';
 import { pathToFileURL } from 'url';
 import os from 'os';
+import readline from 'readline';
 import { createRequire } from 'module';
 import { Command } from 'commander';
 
@@ -47,13 +48,18 @@ import { optionDefinitions } from './src/lib/option-definitions.js';
 const require = createRequire(import.meta.url);
 const pkg = require('./package.json');
 
-const DEFAULT_FILE_EXTENSIONS = ['html', 'htm', 'xhtml', 'shtml'];
+const DEFAULT_FILE_EXTENSIONS = ['html', 'htm', 'shtml', 'shtm'];
+
+const MARK_ERROR   = process.stderr.isTTY ? '\x1b[31m' : '';
+const MARK_SUCCESS = process.stderr.isTTY ? '\x1b[32m' : '';
+const MARK_WARNING = process.stderr.isTTY ? '\x1b[33m' : '';
+const MARK_RESET   = process.stderr.isTTY ? '\x1b[0m'  : '';
 
 const program = new Command();
 program.name(pkg.name);
 
 function fatal(message) {
-  console.error(message);
+  console.error(`${MARK_ERROR}${message}${MARK_RESET}`);
   process.exit(1);
 }
 
@@ -237,10 +243,11 @@ function normalizeConfig(config) {
 }
 
 let config = {};
+program.option('-z, --zero', 'Minify all HTML files in the current folder and its subfolders in place (except node_modules), using comprehensive settings (standalone—flag is ignored when combined with other options)');
 program.option('-I --input-dir <dir>', 'Specify an input directory');
 program.option('-X --ignore-dir <patterns>', 'Exclude directories—relative to input directory—from processing (comma-separated), e.g., “libs” or “libs,vendor,node_modules”');
 program.option('-O --output-dir <dir>', 'Specify an output directory');
-program.option('-f --file-ext <extensions>', 'Specify file extension(s) to process (comma-separated); defaults to “html,htm,xhtml,shtml”; use “*” for all files');
+program.option('-f --file-ext <extensions>', 'Specify file extension(s) to process (comma-separated); defaults to “html,htm,shtml,shtm”; use “*” for all files');
 program.option('-p --preset <name>', `Use a preset configuration (${getPresetNames().join(', ')})`);
 program.option('-c --config-file <file>', 'Use config file');
 program.option('--cache-css <size>', 'Set CSS minification cache size (number of entries, default: 500)', parseValidInt('cacheCSS'));
@@ -266,8 +273,8 @@ program.helpOption('-h, --help', 'Display help for command');
   const jsonOptionKeys = ['minifyCss', 'minifyJs', 'minifyUrls'];
   for (const key of jsonOptionKeys) {
     const value = programOptions[key];
-    if (typeof value === 'string' && /\.(html?|php|xml|svg|xhtml|jsx|tsx|vue|ejs|hbs|mustache|twig)$/i.test(value)) {
-      // The option consumed a filename - inject it back
+    if (typeof value === 'string' && /\.(html?|shtml?|xhtml?|php|xml|svg|jsx|tsx|vue|ejs|hbs|mustache|twig)$/i.test(value)) {
+      // The option consumed a filename—inject it back
       programOptions[key] = true;
       capturedFiles.push(value);
       filesProvided = true;
@@ -276,6 +283,76 @@ program.helpOption('-h, --help', 'Display help for command');
 
   // Defer reading files—multi-file mode will process per-file later
 
+  // Handle zero config mode (standalone in-place minification of the current folder)
+  if (programOptions.zero) {
+    const hasOtherArgs = process.argv.slice(2).some(arg => arg !== '--zero' && arg !== '-z');
+    if (hasOtherArgs) {
+      console.error('Note: `--zero` was ignored—it can only be used on its own, to minify the current folder at comprehensive settings.');
+    } else {
+      const cwd = process.cwd();
+      const commandName = process.env.npm_command === 'exec'
+        ? 'npx html-minifier-next'
+        : process.argv[1].endsWith('.js')
+          ? `${path.basename(process.argv[0])} ${process.argv[1]}`
+          : path.basename(process.argv[1]);
+
+      process.stderr.write(
+        `${MARK_WARNING}Zero-config mode minifies all HTML files in the current folder and its subfolders (${cwd}) in place, using comprehensive settings. If you want to compare results and be able to revert, do this under version control.${MARK_RESET}\n` +
+        `Equivalent to: ${commandName} --input-dir=. --output-dir=. --ignore-dir=node_modules --preset=comprehensive\n\n` +
+        `Do you want to continue? [y/N] `
+      );
+
+      const answer = await new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: null });
+        rl.once('line', (line) => {
+          resolve(line.trim().toLowerCase());
+          rl.close();
+        });
+        rl.once('close', () => resolve(''));
+      });
+
+      if (answer !== 'y') {
+        process.stderr.write(`${MARK_ERROR}In-place minification aborted.${MARK_RESET}\n`);
+        process.exit(0);
+      }
+
+      // Apply comprehensive preset for all processing
+      programOptions.preset = 'comprehensive';
+
+      const inputDirResolved = await fs.promises.realpath(cwd).catch(() => cwd);
+      const extensions = DEFAULT_FILE_EXTENSIONS;
+      const ignorePatterns = ['node_modules'];
+
+      const showProgress = process.stderr.isTTY;
+      let progress = null;
+      if (showProgress) {
+        progress = { current: 0, total: null };
+      }
+
+      const allFiles = await collectFiles(cwd, extensions, undefined, ignorePatterns, inputDirResolved);
+      const concurrency = Math.max(1, Math.min(os.cpus().length || 4, 8));
+
+      if (progress) {
+        progress.total = allFiles.length;
+      }
+
+      await runWithConcurrency(allFiles, concurrency, async (file) => {
+        await processFile(file, file, false, false);
+        if (progress) {
+          progress.current++;
+          updateProgress(progress.current, progress.total);
+        }
+      });
+
+      if (progress) {
+        clearProgress();
+      }
+      console.error(`${MARK_SUCCESS}Processed ${allFiles.length.toLocaleString()} file${allFiles.length === 1 ? '' : 's'}.${MARK_RESET}`);
+
+      process.exit(0);
+    }
+  }
+
   // Load and normalize config if `--config-file` was specified
   if (programOptions.configFile) {
     config = await loadConfigFromPath(programOptions.configFile);
@@ -353,7 +430,7 @@ program.helpOption('-h, --help', 'Display help for command');
 
     // Show stats if dry run or verbose mode
     if (isDryRun || isVerbose) {
-      console.error(`  ✓ ${path.relative(process.cwd(), inputFile)}: ${stats.originalSize.toLocaleString()} → ${stats.minifiedSize.toLocaleString()} bytes (${stats.sign}${Math.abs(stats.saved).toLocaleString()}, ${stats.percentage}%)`);
+      console.error(`  ${MARK_SUCCESS}✓${MARK_RESET} ${path.relative(process.cwd(), inputFile)}: ${stats.originalSize.toLocaleString()} → ${stats.minifiedSize.toLocaleString()} bytes (${stats.sign}${Math.abs(stats.saved).toLocaleString()}, ${stats.percentage}%)`);
     }
 
     if (isDryRun) {
@@ -588,7 +665,7 @@ program.helpOption('-h, --help', 'Display help for command');
     // Show stats if verbose
     if (programOptions.verbose) {
       const inputSource = program.args.length > 0 ? program.args.join(', ') : 'STDIN';
-      console.error(`  ✓ ${inputSource}: ${stats.originalSize.toLocaleString()} → ${stats.minifiedSize.toLocaleString()} bytes (${stats.sign}${Math.abs(stats.saved).toLocaleString()}, ${stats.percentage}%)`);
+      console.error(`  ${MARK_SUCCESS}✓${MARK_RESET} ${inputSource}: ${stats.originalSize.toLocaleString()} → ${stats.minifiedSize.toLocaleString()} bytes (${stats.sign}${Math.abs(stats.saved).toLocaleString()}, ${stats.percentage}%)`);
     }
 
     if (programOptions.output) {
@@ -641,8 +718,8 @@ program.helpOption('-h, --help', 'Display help for command');
         outputReal = path.resolve(outputDir);
       }
       let skipRootAbs;
-      if (inputReal && outputReal && (outputReal === inputReal || outputReal.startsWith(inputReal + path.sep))) {
-        // Instead of aborting, skip traversing into the output directory
+      if (inputReal && outputReal && outputReal !== inputReal && outputReal.startsWith(inputReal + path.sep)) {
+        // Skip traversing into the output directory when it is nested inside the input directory
         skipRootAbs = outputReal;
       }
 
@@ -694,7 +771,7 @@ program.helpOption('-h, --help', 'Display help for command');
       // Show completion message and clear progress indicator
       if (progress) {
         clearProgress();
-        console.error(`Processed ${progress.current.toLocaleString()} file${progress.current === 1 ? '' : 's'}`);
+        console.error(`${MARK_SUCCESS}Processed ${progress.current.toLocaleString()} file${progress.current === 1 ? '' : 's'}.${MARK_RESET}`);
       }
 
       if (isVerbose && stats && stats.length > 0) {
@@ -753,7 +830,7 @@ program.helpOption('-h, --help', 'Display help for command');
 
     if (programOptions.verbose) {
       const inputSource = capturedFiles.join(', ');
-      console.error(`  ✓ ${inputSource}: ${stats.originalSize.toLocaleString()} → ${stats.minifiedSize.toLocaleString()} bytes (${stats.sign}${Math.abs(stats.saved).toLocaleString()}, ${stats.percentage}%)`);
+      console.error(`  ${MARK_SUCCESS}✓${MARK_RESET} ${inputSource}: ${stats.originalSize.toLocaleString()} → ${stats.minifiedSize.toLocaleString()} bytes (${stats.sign}${Math.abs(stats.saved).toLocaleString()}, ${stats.percentage}%)`);
     }
 
     if (programOptions.output) {

package/package.json

@@ -95,5 +95,5 @@
   },
   "type": "module",
   "types": "./dist/types/htmlminifier.d.ts",
-  "version": "5.1.6"
+  "version": "5.2.0"
 }