cssgrep 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.1.0] - 2026-07-02
+
+### Added
+- `-H`/`--with-filename` and `--no-filename` to force the `file:` prefix on or off.
+- `-s`/`--no-messages` to suppress errors for unreadable or missing files.
+- `--include`/`--exclude` file globs with brace alternation (`{a,b,c}`).
+  `--exclude` is an alias of `--ignore`; `--include` replaces the `--ext` filter.
+- `--max-depth <n>` to cap `-r` recursion depth.
+- Automatic skipping of binary files (NUL byte / control-byte heuristic), with a
+  note on stderr suppressible by `-s`/`-q`.
+
+### Changed
+- CI now runs on Linux, macOS and Windows across Node 20 and 22.
+- Releases publish to npm with provenance and smoke-test the built binary.
+
+## [1.0.0] - 2026-06-29
+
+### Added
+- Initial release: match a CSS selector against HTML and print each hit
+  grep-style, with byte-accurate `line:col` via `-n` (works on minified HTML).
+- Recursive search: `-r`/`--recursive`, `--ext`, `-i`/`--ignore`, `--ignore-file`.
+- Print modes: default line, `-p`/`--print`, `--attr`, `--text`, `--json`.
+- `--parent <n>` structural context; line context `-A`/`-B`/`-C`.
+- Limits `-m`/`--max-count`, `-M`/`--max-total`; aggregates `-c`, `-l`/`-L`, `-q`.
+- `-0`/`--null`, `--color`, `-w`/`--max-width`, `-V`/`--version`.
+- Standalone binaries (Bun, Node SEA), shell completions, and a man page.
+
+[Unreleased]: https://github.com/msbatarce/cssgrep/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/msbatarce/cssgrep/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/msbatarce/cssgrep/releases/tag/v1.0.0

package/README.md

@@ -1,5 +1,9 @@
 # cssgrep
 
+[![npm](https://img.shields.io/npm/v/cssgrep.svg)](https://www.npmjs.com/package/cssgrep)
+[![test](https://github.com/msbatarce/cssgrep/actions/workflows/test.yml/badge.svg)](https://github.com/msbatarce/cssgrep/actions/workflows/test.yml)
+[![license](https://img.shields.io/npm/l/cssgrep.svg)](LICENSE)
+
 Search HTML by CSS selector and print each match, grep-style — add `-n` to
 report it as `file:line:col`.
 
@@ -73,8 +77,11 @@ locator appears only with `-n`:
 | Flag | Description |
 |------|-------------|
 | `-r`, `--recursive` | Recurse into directory arguments (defaults to `.` if none given). |
+| `--max-depth <n>` | Limit `-r` recursion depth (`1` = the given directory only, no subdirectories). |
 | `--ext <list>` | Extensions to scan with `-r` (default `html,htm`). Value attaches with `=`: `--ext htm` or `--ext=htm`. |
+| `--include <glob>` | Only search files whose name/path matches `<glob>` while recursing (repeatable). Replaces `--ext` — the two can't be combined. e.g. `--include '*.{html,htm,xhtml}'`. |
 | `-i`, `--ignore <glob>` | Skip files/dirs matching `<glob>` while recursing (repeatable). `node_modules`, `*.min.html`, `build/` (dir-only), or path globs like `src/vendor/**`. |
+| `--exclude <glob>` | Alias for `--ignore` (grep's name for the same thing). |
 | `--ignore-file <path>` | Load ignore globs from a file, one per line (`#` comments and blank lines ignored) — like a `.gitignore`. |
 | `-n`, `--line-number` | Prefix each match with its `line:col` locator. Mutually exclusive with `-c` and `-p`. |
 | `-p`, `--print` | Pretty-print the matched node's HTML, re-indented from scratch (works on minified input). No `line:col` locator is shown. |
@@ -92,7 +99,10 @@ locator appears only with `-n`:
 | `-l`, `--files-with-matches` | Print only the names of files that contain a match. |
 | `-L`, `--files-without-match` | Print only the names of files with no match. |
 | `-q`, `--quiet` | Print nothing; exit `0` on the first match, `1` if none. Stops early. |
+| `-s`, `--no-messages` | Suppress error messages for unreadable or missing files (handy with `-r`). |
 | `-0`, `--null` | Output a NUL after each file name instead of `:` (or, with `-l`/`-L`, instead of the newline) — pipe to `xargs -0`. |
+| `-H`, `--with-filename` | Always print the `file:` prefix, even for a single file or stdin. |
+| `--no-filename` | Never print the `file:` prefix, even when searching multiple files. |
 | `--color[=<when>]` | Colorize output: `auto` (default — color only when stdout is a terminal), `always`, or `never`. A bare `--color` means `always`. |
 | `-h`, `--help` | Show help. |
 | `-V`, `--version` | Print the version and exit. |
@@ -100,6 +110,15 @@ locator appears only with `-n`:
 Boolean short flags can be combined into one token (`-rn` is `-r -n`), and a
 value-taking flag may close such a cluster (`-rnw100`).
 
+Globs for `--include`/`--ignore`/`--exclude` support `*` (within a path
+segment), `**` (across `/`), `?` (one non-slash char), and brace alternation
+like `*.{html,htm}`. A trailing `/` matches directories only; a pattern with a
+`/` matches against the path, otherwise the basename — gitignore-flavored.
+
+Binary files are detected (a NUL byte or a high ratio of control bytes in the
+first 8 KB) and skipped with a note on stderr — parsing them as HTML is never
+useful. Suppress the note with `-s` (or `-q`).
+
 When coloring is on, the matched node is highlighted within its line (grep's
 bold-red); the `file:` prefix and `line:col` locator get their own colors
 (magenta and green, like grep). Plain `-p` prints no color (the whole block is

package/completions/_cssgrep

@@ -6,8 +6,11 @@
 _cssgrep() {
   _arguments -s -S \
     '(-r --recursive)'{-r,--recursive}'[recurse into directory arguments]' \
+    '--max-depth[limit -r recursion depth (1 = given dir only)]:depth:' \
     '--ext[extensions to scan with -r]:extensions (comma-separated):' \
+    '*--include[only search files matching glob (replaces --ext)]:glob:' \
     '*'{-i,--ignore}'[skip files/dirs matching glob while recursing]:glob:' \
+    '*--exclude[alias for --ignore]:glob:' \
     '--ignore-file[read ignore globs from a file]:file:_files' \
     '(-n --line-number)'{-n,--line-number}'[prefix each match with line:col]' \
     '(-p --print)'{-p,--print}'[pretty-print the matched node HTML]' \
@@ -25,7 +28,10 @@ _cssgrep() {
     '(-l --files-with-matches)'{-l,--files-with-matches}'[print only names of files with a match]' \
     '(-L --files-without-match)'{-L,--files-without-match}'[print only names of files without a match]' \
     '(-q --quiet)'{-q,--quiet}'[print nothing; exit on first match]' \
+    '(-s --no-messages)'{-s,--no-messages}'[suppress errors for unreadable/missing files]' \
     '(-0 --null)'{-0,--null}'[separate the file name with a NUL byte]' \
+    '(--no-filename)'{-H,--with-filename}'[always print the file name prefix]' \
+    '(-H --with-filename)--no-filename[never print the file name prefix]' \
     '--color=-[colorize output]::when:(auto always never)' \
     '(-h --help)'{-h,--help}'[show help and exit]' \
     '(-V --version)'{-V,--version}'[show version and exit]' \

package/completions/cssgrep.bash

@@ -6,11 +6,12 @@ _cssgrep() {
     cur="${COMP_WORDS[COMP_CWORD]}"
     prev="${COMP_WORDS[COMP_CWORD-1]}"
 
-    opts="-r --recursive --ext -i --ignore --ignore-file -n --line-number \
+    opts="-r --recursive --max-depth --ext --include -i --ignore --exclude --ignore-file -n --line-number \
 -p --print --attr --text --json --parent -w --max-width \
 -A --after-context -B --before-context -C --context \
 -m --max-count -M --max-total -c --count \
--l --files-with-matches -L --files-without-match -q --quiet -0 --null \
+-l --files-with-matches -L --files-without-match -q --quiet -s --no-messages -0 --null \
+-H --with-filename --no-filename \
 --color -h --help -V --version"
 
     case "$prev" in
@@ -22,7 +23,7 @@ _cssgrep() {
             COMPREPLY=( $(compgen -f -- "$cur") )
             return 0
             ;;
-        --ext|-i|--ignore|--attr|--parent|-w|--max-width|-A|--after-context|\
+        --max-depth|--ext|--include|-i|--ignore|--exclude|--attr|--parent|-w|--max-width|-A|--after-context|\
 -B|--before-context|-C|--context|-m|--max-count|-M|--max-total)
             # value-taking flag with no enumerable completion; offer nothing
             return 0

package/completions/cssgrep.fish

@@ -2,8 +2,11 @@
 # Install: place this file in ~/.config/fish/completions/ (named cssgrep.fish).
 
 complete -c cssgrep -s r -l recursive -d 'Recurse into directory arguments'
+complete -c cssgrep -l max-depth -x -d 'Limit -r recursion depth (1 = given dir only)'
 complete -c cssgrep -l ext -x -d 'Extensions to scan with -r (comma-separated)'
+complete -c cssgrep -l include -x -d 'Only search files matching glob (replaces --ext)'
 complete -c cssgrep -s i -l ignore -x -d 'Skip files/dirs matching glob while recursing'
+complete -c cssgrep -l exclude -x -d 'Alias for --ignore'
 complete -c cssgrep -l ignore-file -r -F -d 'Read ignore globs from a file'
 complete -c cssgrep -s n -l line-number -d 'Prefix each match with line:col'
 complete -c cssgrep -s p -l print -d 'Pretty-print the matched node HTML'
@@ -21,7 +24,10 @@ complete -c cssgrep -s c -l count -d 'Print only a count of matches'
 complete -c cssgrep -s l -l files-with-matches -d 'Print only names of files with a match'
 complete -c cssgrep -s L -l files-without-match -d 'Print only names of files without a match'
 complete -c cssgrep -s q -l quiet -d 'Print nothing; exit on first match'
+complete -c cssgrep -s s -l no-messages -d 'Suppress errors for unreadable/missing files'
 complete -c cssgrep -s 0 -l null -d 'Separate the file name with a NUL byte'
+complete -c cssgrep -s H -l with-filename -d 'Always print the file name prefix'
+complete -c cssgrep -l no-filename -d 'Never print the file name prefix'
 complete -c cssgrep -l color -x -a 'auto always never' -d 'Colorize output'
 complete -c cssgrep -s h -l help -d 'Show help and exit'
 complete -c cssgrep -s V -l version -d 'Show version and exit'

package/index.js

@@ -12,7 +12,7 @@ const { html: beautify } = require('js-beautify');
 // package.json, so it survives compilation into a standalone binary (Bun
 // --compile / Node SEA), where package.json won't sit next to the executable.
 // Keep in sync with package.json on release.
-const VERSION = '1.0.0';
+const VERSION = '1.1.0';
 
 const USAGE = `cssgrep - search HTML by CSS selector, grep-style.
 
@@ -29,8 +29,11 @@ Output (one line per match):
 
 Options:
   -r, --recursive        Recurse into directory arguments.
+      --max-depth <n>    Limit -r recursion depth (1 = the given dir only).
       --ext <list>       Comma-separated extensions for -r (default: html,htm).
+      --include <glob>   Only search files matching <glob> (replaces --ext; repeatable).
   -i, --ignore <glob>    Skip files/dirs matching <glob> when recursing (repeatable).
+      --exclude <glob>   Alias for --ignore.
       --ignore-file <path>   Read ignore globs from <path> (one per line, # comments).
   -n, --line-number      Prefix each match with its line:col (excludes -c, -p).
   -p, --print            Pretty-print the matched node's HTML above its location.
@@ -48,7 +51,10 @@ Options:
   -l, --files-with-matches   Print only the names of files that have a match.
   -L, --files-without-match  Print only the names of files with no match.
   -q, --quiet            Print nothing; exit 0 on first match, 1 if none.
+  -s, --no-messages      Suppress error messages for unreadable/missing files.
   -0, --null             Separate the file name with a NUL byte (for xargs -0).
+  -H, --with-filename    Always print the file name prefix (even for one file).
+      --no-filename      Never print the file name prefix (even for many files).
       --color[=<when>]   Colorize output: auto (default), always or never.
   -h, --help             Show this help.
   -V, --version          Show version and exit.
@@ -57,6 +63,9 @@ Short flags combine (-rn) and a value attaches to its flag (-w100) or follows it
 (-w 100); a value-taking flag may close a cluster (-rnw100). Long options take a
 value with = or as the next word (--max-width=100, --ext htm).
 
+Globs (--include/--ignore/--exclude) support *, ** (crosses /), ?, and brace
+alternation like *.{html,htm}.
+
 Exit status: 0 if any match was found, 1 if none, 2 on error.`;
 
 function fail(msg) {
@@ -84,6 +93,8 @@ function parseArgs(argv) {
     paths: [],
     recursive: false,
     exts: ['html', 'htm'],
+    extGiven: false,
+    maxDepth: 0,
     lineNumber: false,
     print: false,
     maxWidth: 0,
@@ -101,9 +112,14 @@ function parseArgs(argv) {
     before: 0,
     after: 0,
     ignore: [],
+    include: [],
+    withFilename: false,
+    noFilename: false,
+    noMessages: false,
     color: 'auto',
   };
   const setExts = v => {
+    opts.extGiven = true;
     opts.exts = (v || '').split(',').map(s => s.trim().replace(/^\./, '')).filter(Boolean);
   };
   const boundedInt = (v, what, min) => {
@@ -115,11 +131,13 @@ function parseArgs(argv) {
   const setMaxWidth = v => { opts.maxWidth = positiveInt(v, '--max-width'); };
   const setMaxCount = v => { opts.maxCount = positiveInt(v, '--max-count'); };
   const setMaxTotal = v => { opts.maxTotal = positiveInt(v, '--max-total'); };
+  const setMaxDepth = v => { opts.maxDepth = positiveInt(v, '--max-depth'); };
   const setParent = v => { opts.parent = positiveInt(v, '--parent'); };
   const setAfter = v => { opts.after = boundedInt(v, '--after-context', 0); };
   const setBefore = v => { opts.before = boundedInt(v, '--before-context', 0); };
   const setContext = v => { opts.after = opts.before = boundedInt(v, '--context', 0); };
   const addIgnore = v => { const c = compileIgnore(v); if (c) opts.ignore.push(c); };
+  const addInclude = v => { const c = compileIgnore(v); if (c) opts.include.push(c); };
   const addIgnoreFile = v => {
     let content;
     try { content = fs.readFileSync(v, 'utf8'); }
@@ -152,12 +170,17 @@ function parseArgs(argv) {
         case '--files-without-match': opts.filesWithoutMatch = true; break;
         case '--quiet': case '--silent': opts.quiet = true; break;
         case '--null': opts.nul = true; break;
+        case '--with-filename': opts.withFilename = true; break;
+        case '--no-filename': opts.noFilename = true; break;
+        case '--no-messages': opts.noMessages = true; break;
         case '--ext': setExts(value()); break;
-        case '--ignore': addIgnore(value()); break;
+        case '--ignore': case '--exclude': addIgnore(value()); break;
         case '--ignore-file': addIgnoreFile(value()); break;
+        case '--include': addInclude(value()); break;
         case '--max-width': setMaxWidth(value()); break;
         case '--max-count': setMaxCount(value()); break;
         case '--max-total': setMaxTotal(value()); break;
+        case '--max-depth': setMaxDepth(value()); break;
         case '--attr': opts.attr = value(); break;
         case '--text': opts.text = true; break;
         case '--json': opts.json = true; break;
@@ -193,6 +216,8 @@ function parseArgs(argv) {
           case 'L': opts.filesWithoutMatch = true; break;
           case 'q': opts.quiet = true; break;
           case '0': case 'Z': opts.nul = true; break;
+          case 'H': opts.withFilename = true; break;
+          case 's': opts.noMessages = true; break;
           default: fail(`unknown option: -${ch}`);
         }
       }
@@ -206,6 +231,10 @@ function parseArgs(argv) {
   const aggregates = [opts.count, opts.filesWithMatches, opts.filesWithoutMatch, opts.quiet]
     .filter(Boolean).length;
   if (aggregates > 1) fail('only one of -c, -l, -L, -q may be given');
+  // Filename prefix can be forced on or off, but not both (grep -H / -h).
+  if (opts.withFilename && opts.noFilename) fail('-H cannot be combined with --no-filename');
+  // --include fully replaces the extension filter, so the two can't coexist.
+  if (opts.extGiven && opts.include.length) fail('--ext and --include cannot be combined');
   // Per-match print modes choose what is printed for each match; only one.
   const printModes = [opts.print, opts.attr != null, opts.text, opts.json].filter(Boolean).length;
   if (printModes > 1) fail('only one of -p, --attr, --text, --json may be given');
@@ -594,9 +623,11 @@ function searchSource(src, name, showLabel, opts, out, limit = Infinity) {
 }
 
 // Translate a glob to a regex body. `*` matches within a path segment, `**`
-// across segments, `?` a single non-slash char; everything else is literal.
+// across segments, `?` a single non-slash char, `{a,b,c}` alternation; every
+// other char is literal.
 function globToRegex(glob) {
   let re = '';
+  let depth = 0;                            // open `{` alternation groups
   for (let i = 0; i < glob.length; i++) {
     const c = glob[i];
     if (c === '*') {
@@ -609,12 +640,21 @@ function globToRegex(glob) {
       }
     } else if (c === '?') {
       re += '[^/]';
-    } else if (/[.+^${}()|[\]\\]/.test(c)) {
+    } else if (c === '{') {
+      re += '(';
+      depth++;
+    } else if (c === '}' && depth > 0) {
+      re += ')';
+      depth--;
+    } else if (c === ',' && depth > 0) {
+      re += '|';
+    } else if (/[.+^$()|[\]\\]/.test(c)) {  // note: { } handled above
       re += '\\' + c;
     } else {
       re += c;
     }
   }
+  while (depth-- > 0) re += ')';            // close any unbalanced `{`
   return re;
 }
 
@@ -631,7 +671,9 @@ function compileIgnore(pattern) {
   return { re, dirOnly, hasSlash };
 }
 
-function isIgnored(name, full, isDir, matchers) {
+// True if name/path matches any compiled glob matcher (shared by --ignore/
+// --exclude and --include).
+function matchesAny(name, full, isDir, matchers) {
   for (const m of matchers) {
     if (m.dirOnly && !isDir) continue;
     if (m.re.test(m.hasSlash ? full : name)) return true;
@@ -639,23 +681,29 @@ function isIgnored(name, full, isDir, matchers) {
   return false;
 }
 
-function* walk(dir, opts) {
+function* walk(dir, opts, depth = 1) {
   let entries;
   try {
     entries = fs.readdirSync(dir, { withFileTypes: true });
   } catch (e) {
-    process.stderr.write(`cssgrep: ${dir}: ${e.code || e.message}\n`);
+    if (!opts.noMessages) process.stderr.write(`cssgrep: ${dir}: ${e.code || e.message}\n`);
     return;
   }
   for (const e of entries) {
     const full = path.join(dir, e.name);
     const isDir = e.isDirectory();
-    if (opts.ignore.length && isIgnored(e.name, full, isDir, opts.ignore)) continue;
+    if (opts.ignore.length && matchesAny(e.name, full, isDir, opts.ignore)) continue;
     if (isDir) {
-      yield* walk(full, opts);
+      // --max-depth caps how far we descend; depth 1 = the target's children.
+      if (!opts.maxDepth || depth < opts.maxDepth) yield* walk(full, opts, depth + 1);
     } else if (e.isFile()) {
-      const ext = path.extname(e.name).slice(1).toLowerCase();
-      if (opts.exts.includes(ext)) yield full;
+      // --include replaces the extension filter; otherwise filter by --ext.
+      if (opts.include.length) {
+        if (matchesAny(e.name, full, false, opts.include)) yield full;
+      } else {
+        const ext = path.extname(e.name).slice(1).toLowerCase();
+        if (opts.exts.includes(ext)) yield full;
+      }
     }
   }
 }
@@ -664,6 +712,23 @@ function readStdin() {
   return fs.readFileSync(0, 'utf8');
 }
 
+// Heuristic binary-file detector (grep/git style). A NUL byte in the first 8 KB
+// is a decisive binary signal; failing that, a high ratio of non-text control
+// bytes flags binary content that happens to lack NULs. HTML is text, so binary
+// files are never worth parsing and are skipped. (stat() can't tell us this —
+// only the bytes can.)
+const BINARY_SNIFF_BYTES = 8192;
+function looksBinary(buf) {
+  const n = Math.min(buf.length, BINARY_SNIFF_BYTES);
+  let suspicious = 0;
+  for (let i = 0; i < n; i++) {
+    const b = buf[i];
+    if (b === 0) return true;                       // NUL: definitely binary
+    if (b < 9 || (b > 13 && b < 32)) suspicious++;  // control char (not \t\n\v\f\r)
+  }
+  return n > 0 && suspicious / n > 0.3;
+}
+
 function main() {
   const opts = parseArgs(process.argv.slice(2));
   resolveSelectorAndPaths(opts);
@@ -676,7 +741,7 @@ function main() {
     const targets = opts.paths.length ? opts.paths : ['.'];
     for (const p of targets) {
       const st = fs.statSync(p, { throwIfNoEntry: false });
-      if (!st) { process.stderr.write(`cssgrep: ${p}: no such file or directory\n`); continue; }
+      if (!st) { if (!opts.noMessages) process.stderr.write(`cssgrep: ${p}: no such file or directory\n`); continue; }
       if (st.isDirectory()) files.push(...walk(p, opts));
       else files.push(p);
     }
@@ -686,8 +751,11 @@ function main() {
     useStdin = true;
   }
 
-  // A label (file prefix) is shown when searching more than one file.
-  const showLabel = !useStdin && files.length > 1;
+  // A label (file prefix) is shown when searching more than one file; -H forces
+  // it on (even for one file or stdin) and --no-filename forces it off.
+  const showLabel = opts.withFilename ? true
+    : opts.noFilename ? false
+    : (!useStdin && files.length > 1);
 
   const out = [];
   let total = 0;
@@ -697,18 +765,24 @@ function main() {
 
   try {
     if (useStdin) {
-      total += searchSource(readStdin(), '(standard input)', false, opts, out, room());
+      total += searchSource(readStdin(), '(standard input)', showLabel, opts, out, room());
     } else {
       for (const f of files) {
         if (room() <= 0) break;               // -M: global budget exhausted
-        let src;
+        let buf;
         try {
-          src = fs.readFileSync(f, 'utf8');
+          buf = fs.readFileSync(f);           // Buffer: sniff before decoding
         } catch (e) {
-          process.stderr.write(`cssgrep: ${f}: ${e.code || e.message}\n`);
+          if (!opts.noMessages) process.stderr.write(`cssgrep: ${f}: ${e.code || e.message}\n`);
+          continue;
+        }
+        if (looksBinary(buf)) {
+          if (!opts.noMessages && !opts.quiet) {
+            process.stderr.write(`cssgrep: ${f}: binary file (skipped)\n`);
+          }
           continue;
         }
-        total += searchSource(src, f, showLabel, opts, out, room());
+        total += searchSource(buf.toString('utf8'), f, showLabel, opts, out, room());
         if (opts.quiet && total > 0) break;   // -q: first match decides the status
       }
     }

package/man/cssgrep.1

@@ -1,6 +1,6 @@
 .\" Man page for cssgrep. Keep the OPTIONS section in sync with the USAGE
 .\" string in index.js.
-.TH CSSGREP 1 "2026-06-29" "cssgrep 1.0.0" "User Commands"
+.TH CSSGREP 1 "2026-07-02" "cssgrep 1.1.0" "User Commands"
 .SH NAME
 cssgrep \- search HTML by CSS selector, grep-style
 .SH SYNOPSIS
@@ -33,7 +33,13 @@ Input is read from the
 .I file
 arguments, recursively from directories with
 .BR \-r ,
-or from standard input when no path is given. One line is printed per match.
+or from standard input when no path is given. Binary files (a NUL byte or a
+high ratio of control bytes in the first 8 KB) are skipped with a note on
+standard error, suppressible with
+.B \-s
+or
+.BR \-q .
+One line is printed per match.
 As with
 .BR grep ,
 the matched line is printed on its own; a
@@ -48,17 +54,35 @@ locator appears only with
 Recurse into directory arguments (defaults to the current directory if none
 are given).
 .TP
+.BI \-\-max\-depth " n"
+Limit
+.B \-r
+recursion depth.
+.I 1
+means the given directory only (no subdirectories).
+.TP
 .BI \-\-ext " list"
 Comma-separated extensions to scan with
 .B \-r
 (default:
 .IR html,htm ).
 .TP
+.BI \-\-include " glob"
+Only search files whose name/path matches
+.I glob
+while recursing (repeatable). Replaces
+.BR \-\-ext ;
+the two cannot be combined.
+.TP
 .BR \-i ", " \-\-ignore " \fIglob\fR"
 Skip files/dirs matching
 .I glob
 while recursing (repeatable).
 .TP
+.BI \-\-exclude " glob"
+Alias for
+.BR \-\-ignore .
+.TP
 .BI \-\-ignore\-file " path"
 Read ignore globs from
 .IR path ,
@@ -139,10 +163,19 @@ Print only the names of files with no match.
 .BR \-q ", " \-\-quiet
 Print nothing; exit 0 on the first match, 1 if none.
 .TP
+.BR \-s ", " \-\-no\-messages
+Suppress error messages for unreadable or missing files.
+.TP
 .BR \-0 ", " \-\-null
 Separate the file name with a NUL byte (for
 .BR "xargs \-0" ).
 .TP
+.BR \-H ", " \-\-with\-filename
+Always print the file name prefix, even for a single file or standard input.
+.TP
+.B \-\-no\-filename
+Never print the file name prefix, even when searching multiple files.
+.TP
 .BR \-\-color [ =\fIwhen\fR ]
 Colorize output:
 .I auto
@@ -169,6 +202,12 @@ Long options take a value with
 .B =
 or as the next word
 .RB ( \-\-max\-width=100 ", " "\-\-ext htm" ).
+.PP
+Globs for
+.BR \-\-include ", " \-\-ignore ", and " \-\-exclude
+support
+.BR * " (within a path segment), " ** " (across " / ),
+.BR ? " (one non-slash char), and brace alternation like " *.{html,htm} .
 .SH EXIT STATUS
 .TP
 .B 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cssgrep",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Search HTML by CSS selector and print matches grep-style (file:line:col with -n).",
   "main": "index.js",
   "bin": {
@@ -10,6 +10,7 @@
   "files": [
     "index.js",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "man/cssgrep.1",
     "completions/"