html-minifier-next 6.2.9 → 6.2.11

package/README.md

@@ -34,7 +34,8 @@ Use `npx html-minifier-next --help` to check all available options:
 | `--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: `npx html-minifier-next 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` |
+| `--input <file>`, `-i <file>` | Specify input file (alternative to positional argument; pair with `--output` for file output) | `npx html-minifier-next -i input.html -o output.html` |
+| `--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.json` |
@@ -179,7 +180,7 @@ Options can be used in config files (camelCase) or via CLI flags (kebab-case wit
 
 ### Sorting attributes and style classes
 
-Minifier options like `sortAttributes` and `sortClassNames` won’t impact the plain‑text size of the output. However, using these options for more consistent ordering improves the compression ratio for Gzip and Brotli used over HTTP.
+Minifier options like `sortAttributes` and `sortClassNames` won’t impact the plain-text size of the output. However, using these options for more consistent ordering improves the compression ratio for Gzip and Brotli used over HTTP.
 
 ### CSS minification
 

package/cli.js

@@ -58,7 +58,8 @@ 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', 'shtml', 'shtm'];
+const EXTENSIONS_DEFAULT = ['html', 'htm', 'shtml', 'shtm'];
+const EXTENSIONS_NON_HTML = new Set(['css', 'js', 'mjs', 'cjs', 'jsx', 'ts', 'tsx', 'svg']);
 
 const MARK_ERROR = process.stderr.isTTY ? '\x1b[31m' : '';
 const MARK_SUCCESS = process.stderr.isTTY ? '\x1b[32m' : '';
@@ -171,7 +172,8 @@ mainOptionKeys.forEach(function (key) {
     program.option(cliFlag, description, parser);
   }
 });
-program.option('-o --output <file>', 'Specify output file (reads from file arguments or STDIN; outputs to STDOUT if not specified)');
+program.option('-i --input <file>', 'Specify input file (alternative to positional argument; pair with `--output` for output)');
+program.option('-o --output <file>', 'Specify output file (reads from `--input` file argument or STDIN; outputs to STDOUT if not specified)');
 program.option('-v --verbose', 'Show detailed processing information');
 program.option('-d --dry', 'Dry run: Process and report statistics without writing output');
 program.addHelpText('after', '\nBoolean options support a `--no-<flag>` form to disable them, overriding a preset or config file (e.g., `--preset=comprehensive --no-collapse-whitespace`).');
@@ -318,7 +320,11 @@ program.helpOption('-h, --help', 'Display help for command');
     }
   }
 
-  // Defer reading files—multi-file mode will process per-file later
+  // If `--input` was specified, treat it as a positional file argument
+  if (programOptions.input) {
+    capturedFiles.unshift(programOptions.input);
+    filesProvided = true;
+  }
 
   // Handle zero config mode (standalone in-place minification of the current folder)
   if (programOptions.zero) {
@@ -357,7 +363,7 @@ program.helpOption('-h, --help', 'Display help for command');
       programOptions.preset = 'comprehensive';
 
       const inputDirResolved = await fs.promises.realpath(cwd).catch(() => cwd);
-      const extensions = DEFAULT_FILE_EXTENSIONS;
+      const extensions = EXTENSIONS_DEFAULT;
       const ignorePatterns = ['node_modules'];
 
       const showProgress = process.stderr.isTTY;
@@ -727,7 +733,7 @@ program.helpOption('-h, --help', 'Display help for command');
 
   // Resolve file extensions: CLI argument > config file > defaults
   const hasCliFileExt = program.getOptionValueSource('fileExt') === 'cli';
-  const resolvedFileExt = hasCliFileExt ? (fileExt || '*') : (config.fileExt || DEFAULT_FILE_EXTENSIONS);
+  const resolvedFileExt = hasCliFileExt ? (fileExt || '*') : (config.fileExt || EXTENSIONS_DEFAULT);
 
   // Resolve ignore patterns: CLI argument takes priority over config file
   const hasCliIgnoreDir = program.getOptionValueSource('ignoreDir') === 'cli';
@@ -735,11 +741,21 @@ program.helpOption('-h, --help', 'Display help for command');
 
   if (inputDir || outputDir) {
     if (!inputDir) {
-      fatal('The option `output-dir` needs to be used with the option `input-dir`—if you are working with a single file, use `-o`');
+      fatal('The option `output-dir` needs to be used with the option `input-dir`—if you are working with a single file, use `--input`/`--output`');
     } else if (!outputDir) {
       fatal('You need to specify where to write the output files with the option `--output-dir`');
     }
 
+    {
+      const extList = Array.isArray(resolvedFileExt) ? resolvedFileExt : parseFileExtensions(String(resolvedFileExt || ''));
+      const isWildcard = extList.includes('*');
+      const nonHtmlExts = isWildcard ? [] : extList.filter(e => EXTENSIONS_NON_HTML.has(e));
+      if (isWildcard || nonHtmlExts.length > 0) {
+        const label = isWildcard ? 'all file types' : nonHtmlExts.map(e => `.${e}`).join(', ');
+        console.error(`${MARK_WARNING}Warning: Processing ${label}—HTML Minifier Next processes CSS, JavaScript, and SVG only when embedded in HTML. Non-HTML files may produce incomplete or broken output.${MARK_RESET}`);
+      }
+    }
+
     await (async () => {
       // `--dry` automatically enables verbose mode
       const isVerbose = programOptions.verbose || programOptions.dry;
@@ -780,7 +796,7 @@ program.helpOption('-h, --help', 'Display help for command');
       try {
         const stat = await fs.promises.stat(inputDir);
         if (!stat.isDirectory()) {
-          fatal(inputDir + ' is not a directory');
+          fatal(`${inputDir} is not a directory—to minify a single file, use \`--input\`/\`--output\`: html-minifier-next [options] -i ${inputDir} -o <output-file>`);
         }
       } catch (err) {
         fatal('Cannot read directory ' + inputDir + '\n' + err.message);
@@ -835,6 +851,13 @@ program.helpOption('-h, --help', 'Display help for command');
       getActiveOptionsDisplay(minifierOptions);
     }
 
+    for (const file of capturedFiles) {
+      const ext = path.extname(file).replace(/^\./, '').toLowerCase();
+      if (EXTENSIONS_NON_HTML.has(ext)) {
+        console.error(`${MARK_WARNING}Warning: “${path.basename(file)}” does not appear to be an HTML file—HTML Minifier Next processes CSS, JavaScript, and SVG only when embedded in HTML. The output may be incomplete or broken.${MARK_RESET}`);
+      }
+    }
+
     const concurrency = Math.max(1, Math.min(os.cpus().length || 4, 8));
     const inputs = capturedFiles.slice();
 

package/package.json

@@ -16,7 +16,7 @@
   "devDependencies": {
     "@commitlint/cli": "^21.0.1",
     "@eslint/js": "^10.0.1",
-    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@swc/core": "^1.15.40",
@@ -98,5 +98,5 @@
   },
   "type": "module",
   "types": "./dist/types/htmlminifier.d.ts",
-  "version": "6.2.9"
+  "version": "6.2.11"
 }