cssgrep 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.5.0] - 2026-07-12
+
+### Added
+- `--json` records now include `attribs`, the matched element's attribute
+  object (names lowercased by the parser) — the same field the library's
+  `Match` exposes, so scraping pipelines get attribute data without a second
+  pass (e.g. `jq -r .attribs.href`).
+
 ## [1.4.0] - 2026-07-07
 
 ### Fixed
@@ -125,7 +133,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.4.0...HEAD
+[Unreleased]: https://github.com/msbatarce/cssgrep/compare/v1.5.0...HEAD
+[1.5.0]: https://github.com/msbatarce/cssgrep/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/msbatarce/cssgrep/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/msbatarce/cssgrep/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/msbatarce/cssgrep/compare/v1.1.0...v1.2.0

package/README.md

@@ -90,7 +90,7 @@ own `line:col` locator (that per-match precision is the point of the tool). A
 | `-p`, `--print` | Pretty-print the matched node's HTML, re-indented from scratch (works on minified input). No `line:col` locator is shown. |
 | `--attr <name>` | Print the value of attribute `<name>` for each match (nodes without it are skipped; if every match is skipped the exit status is 1). The name is matched case-insensitively. Honors `-n` and `-w`. |
 | `--text` | Print the matched node's text content, whitespace collapsed. Honors `-n` and `-w`. |
-| `--json` | Print one JSON object per match (NDJSON), with `file`, `line`, `col`, `html`, `text` — plus `label` when `-e` is used. |
+| `--json` | Print one JSON object per match (NDJSON), with `file`, `line`, `col`, `attribs` (the element's attributes, names lowercased), `html`, `text` — plus `label` when `-e` is used. |
 | `--parent <n>` | Report the `n`-th element ancestor of each match instead of the match itself (de-duplicated). Pairs well with `-p`. |
 | `-w`, `--max-width <n>` | Truncate the shown line to `n` columns (adds `…`). Value attaches or follows: `-w100`, `-w 100`, `--max-width=100`. |
 | `-A`, `--after-context <n>` | Print `n` source lines after each match. |
@@ -187,8 +187,8 @@ $ cssgrep -n -e 'title=h1' -e 'price=.card .price' page.html
 9:12 [price] <span class="price">$4.99</span>
 
 $ cssgrep --json -e 'title=h1' -e 'price=.card .price' page.html
-{"file":"page.html","line":3,"col":5,"label":"title","html":"<h1>Widget</h1>","text":"Widget"}
-{"file":"page.html","line":9,"col":12,"label":"price","html":"...","text":"$4.99"}
+{"file":"page.html","line":3,"col":5,"label":"title","attribs":{},"html":"<h1>Widget</h1>","text":"Widget"}
+{"file":"page.html","line":9,"col":12,"label":"price","attribs":{"class":"price"},"html":"...","text":"$4.99"}
 ```
 
 The label is anything matching `[A-Za-z_][A-Za-z0-9_-]*` before a `=`; since a

package/cli.js

@@ -23,7 +23,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.4.0';
+const VERSION = '1.5.0';
 
 const USAGE = `cssgrep - search HTML by CSS selector, grep-style.
 
@@ -58,7 +58,7 @@ Options:
       --attr <name>      Print the value of attribute <name> (skips nodes without it).
       --text             Print the matched node's text content (whitespace collapsed).
       --json             Print one JSON record per match (NDJSON: file,line,col,
-                         html,text; plus label with -e).
+                         attribs,html,text; plus label with -e).
       --parent <n>       Report the n-th ancestor of each match instead (dedup'd).
   -w, --max-width <n>    Truncate the shown line to <n> columns (ellipsis added).
   -A, --after-context <n>    Print <n> source lines after each match.
@@ -668,10 +668,11 @@ function searchSource(src, name, showLabel, opts, out, limit = Infinity) {
   // matches lacking the attribute, and --parent dedup can merge several
   // matches into one printed ancestor.
   if (opts.json) {
-    // NDJSON: one self-contained record per match. `html` is the exact source
-    // slice; newlines are escaped by JSON.stringify, so each record stays on
-    // one line. Ignores --color and -n (line/col are always present). `label`
-    // appears only with -e.
+    // NDJSON: one self-contained record per match. `attribs` mirrors the lib
+    // Match's field (names lowercased by the parser) so scraping never needs
+    // a second pass; `html` is the exact source slice; newlines are escaped
+    // by JSON.stringify, so each record stays on one line. Ignores --color
+    // and -n (line/col are always present). `label` appears only with -e.
     const posState = {};
     for (const { el, label: selLabel } of targets) {
       const off = el.startIndex == null ? 0 : el.startIndex;
@@ -682,6 +683,7 @@ function searchSource(src, name, showLabel, opts, out, limit = Infinity) {
         line: pos.line,
         col: pos.bcol,
         ...(selLabel !== null && { label: selLabel }),
+        attribs: el.attribs || {},
         html: src.slice(off, nodeEnd),
         text: collapseWs(textOf(el)),
       }));

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-07" "cssgrep 1.4.0" "User Commands"
+.TH CSSGREP 1 "2026-07-12" "cssgrep 1.5.0" "User Commands"
 .SH NAME
 cssgrep \- search HTML by CSS selector, grep-style
 .SH SYNOPSIS
@@ -159,11 +159,13 @@ Print the matched node's text content, whitespace collapsed.
 .TP
 .B \-\-json
 Print one JSON object per match (NDJSON) with
-.IR file ", " line ", " col ", " html ", " text
+.IR file ", " line ", " col ", " attribs ", " html ", " text
 (plus
 .I label
 with
 .BR \-e ).
+.I attribs
+is the element's attribute object, names lowercased by the parser.
 .TP
 .BI \-\-parent " n"
 Report the

package/package.json

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