cssgrep 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.8.0] - 2026-07-13
+
+### Changed
+- The `-n` locator is now colon-separated from the text —
+  `file:line:col:text` instead of `file:line:col text` — matching grep's
+  separator and making the output byte-compatible with `rg --vimgrep`. Vim
+  users can use the standard `grepformat=%f:%l:%c:%m` (docs updated); scripts
+  parsing the old space-separated form need the one-character change.
+
 ## [1.7.0] - 2026-07-12
 
 ### Added
@@ -152,7 +161,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `-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.7.0...HEAD
+[Unreleased]: https://github.com/msbatarce/cssgrep/compare/v1.8.0...HEAD
+[1.8.0]: https://github.com/msbatarce/cssgrep/compare/v1.7.0...v1.8.0
 [1.7.0]: https://github.com/msbatarce/cssgrep/compare/v1.6.0...v1.7.0
 [1.6.0]: https://github.com/msbatarce/cssgrep/compare/v1.5.0...v1.6.0
 [1.5.0]: https://github.com/msbatarce/cssgrep/compare/v1.4.0...v1.5.0

package/README.md

@@ -63,14 +63,15 @@ cat page.html | cssgrep <selector> # read from stdin
 
 Like `grep`, each matching line is printed on its own, once — however many
 matches sit on it. With `-n` there is one record *per match*, each with its
-own `line:col` locator (that per-match precision is the point of the tool). A
+own `line:col` locator (that per-match precision is the point of the tool),
+colon-separated from the text — byte-compatible with `rg --vimgrep`. A
 `file:` prefix is added when searching multiple files:
 
 ```
 {line contents}                         # default; stdin or single file
 {file}:{line contents}                  # default; multiple files
-{line}:{col} {line contents}            # -n; stdin or single file
-{file}:{line}:{col} {line contents}     # -n; multiple files
+{line}:{col}:{line contents}            # -n; stdin or single file
+{file}:{line}:{col}:{line contents}     # -n; multiple files
 ```
 
 ### Options
@@ -324,12 +325,13 @@ message pointing back to these recipes, rather than a bare "unknown option".
 
 ## Vim / Neovim integration
 
-The `file:line:col text` format produced by `-n` is `:grep`-compatible. Point
+The `file:line:col:text` format produced by `-n` is byte-compatible with
+`rg --vimgrep`, so the standard ripgrep `grepformat` works as-is. Point
 `grepprg` at `cssgrep -n -r` and hits land in the quickfix list:
 
 ```vim
 set grepprg=cssgrep\ -n\ -r
-set grepformat=%f:%l:%c\ %m
+set grepformat=%f:%l:%c:%m
 
 " :grep 'div.card' src/   then  :copen
 ```

package/cli.js

@@ -29,7 +29,7 @@ function loadPrettyPrinter() {
 // 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.7.0';
+const VERSION = '1.8.0';
 
 const USAGE = `cssgrep - search HTML by CSS selector, grep-style.
 
@@ -39,11 +39,12 @@ Usage:
   cssgrep -e '[label=]<sel>' [-e ...] [file ...]
   cat file.html | cssgrep <selector>
 
-Output (each matching line once, like grep; with -n, one record per match):
+Output (each matching line once, like grep; with -n, one record per match,
+byte-compatible with rg --vimgrep):
   {line contents}                           (default; stdin or single file)
   {file}:{line contents}                    (default; multiple files)
-  {line}:{col} {line contents}              (with -n; stdin or single file)
-  {file}:{line}:{col} {line contents}       (with -n; multiple files)
+  {line}:{col}:{line contents}              (with -n; stdin or single file)
+  {file}:{line}:{col}:{line contents}       (with -n; multiple files)
 
 Options:
   -e, --selector <[label=]sel>   Add a selector (repeatable). Matches from all
@@ -647,7 +648,7 @@ function emitContext(src, starts, name, showLabel, targets, opts, out) {
       if (label) prefix += c(COLORS.file, label) + (opts.nul ? '\0' : sepColored);
       if (opts.lineNumber) {
         prefix += c(COLORS.line, String(L));
-        prefix += m ? c(COLORS.sep, ':') + c(COLORS.line, String(m.pos.bcol)) + ' '
+        prefix += m ? c(COLORS.sep, ':') + c(COLORS.line, String(m.pos.bcol)) + c(COLORS.sep, ':')
                     : c(COLORS.sep, '-');
       }
       const tag = m && m.selLabel != null ? c(COLORS.label, `[${m.selLabel}]`) + ' ' : '';
@@ -821,8 +822,8 @@ function searchSource(src, name, showLabel, opts, out, limit = Infinity, embedde
       text = renderText(pos, off, nodeEnd, opts);
     }
     // grep-style: a `file:` prefix appears with multiple files; the line:col
-    // locator only with -n. The locator is separated from the text by a space
-    // so the output stays :grep-compatible (grepformat %f:%l:%c %m).
+    // locator only with -n, colon-separated from the text — byte-compatible
+    // with `rg --vimgrep` (grepformat %f:%l:%c:%m).
     const sep = c(COLORS.sep, ':');
     // -0/--null: the char after the file name becomes NUL (grep -Z), for
     // unambiguous machine parsing (e.g. xargs -0).
@@ -830,7 +831,7 @@ function searchSource(src, name, showLabel, opts, out, limit = Infinity, embedde
     let prefix = '';
     if (label) prefix += c(COLORS.file, label) + fileSep;
     if (opts.lineNumber) {
-      prefix += c(COLORS.line, String(pos.line)) + sep + c(COLORS.line, String(pos.bcol)) + ' ';
+      prefix += c(COLORS.line, String(pos.line)) + sep + c(COLORS.line, String(pos.bcol)) + sep;
     }
     out.push(prefix + tag + text);
     emitted++;

package/man/cssgrep.1

@@ -1,6 +1,6 @@
 .\" Man page for cssgrep. Keep the OPTIONS section in sync with the USAGE
 .\" string in cli.js.
-.TH CSSGREP 1 "2026-07-12" "cssgrep 1.7.0" "User Commands"
+.TH CSSGREP 1 "2026-07-13" "cssgrep 1.8.0" "User Commands"
 .SH NAME
 cssgrep \- search HTML by CSS selector, grep-style
 .SH SYNOPSIS
@@ -443,7 +443,7 @@ locator:
 .RS
 .nf
 set grepprg=cssgrep\e \-n\e \-r
-set grepformat=%f:%l:%c\e %m
+set grepformat=%f:%l:%c:%m
 .fi
 .RE
 .SH SEE ALSO

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cssgrep",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Search HTML by CSS selector and print matches grep-style (file:line:col with -n).",
   "main": "lib.js",
   "types": "index.d.ts",