headson 0.5.4__tar.gz → 0.6.1__tar.gz

{headson-0.5.4 → headson-0.6.1}/Cargo.lock

@@ -266,7 +266,7 @@ dependencies = [
 
 [[package]]
 name = "headson"
-version = "0.5.4"
+version = "0.6.1"
 dependencies = [
  "anyhow",
  "assert_cmd",

{headson-0.5.4 → headson-0.6.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "headson"
-version = "0.5.4"
+version = "0.6.1"
 edition = "2024"
 description = "Budget‑constrained JSON preview renderer"
 readme = "README.md"

{headson-0.5.4 → headson-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: headson
-Version: 0.5.4
+Version: 0.6.1
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
@@ -14,7 +14,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 
 <h1 align="center">
-  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/logo.svg" alt="headson" width="600" height="99" />
+  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/logo.svg" alt="headson" width="221" />
 </h1>
 <p align="center">
   <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/tapes/demo.gif" alt="Terminal demo" width="1560" height="900" />

{headson-0.5.4 → headson-0.6.1}/README.md

@@ -1,5 +1,5 @@
 <h1 align="center">
-  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/logo.svg" alt="headson" width="600" height="99" />
+  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/logo.svg" alt="headson" width="221" />
 </h1>
 <p align="center">
   <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/tapes/demo.gif" alt="Terminal demo" width="1560" height="900" />

headson-0.6.1/docs/assets/logo.svg

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="631"
+   height="120"
+   viewBox="0 0 10.660864 2.0288198"
+   version="1.1"
+   id="svg1"
+   inkscape:version="1.4.2 (ebf0e940d0, 2025-05-08)"
+   sodipodi:docname="logo.svg"
+   inkscape:export-filename="logo.png"
+   inkscape:export-xdpi="500"
+   inkscape:export-ydpi="500"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="mm"
+     inkscape:zoom="27.623569"
+     inkscape:cx="29.449489"
+     inkscape:cy="-1.8100485"
+     inkscape:window-width="3840"
+     inkscape:window-height="2124"
+     inkscape:window-x="1080"
+     inkscape:window-y="748"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="text1"
+     inkscape:export-bgcolor="#ffffffff" />
+  <defs
+     id="defs1">
+    <style
+       type="text/css"
+       id="style1"><![CDATA[
+      .wordmark { fill: #000000; }
+      .wordmark .primary { fill: #000000; }
+      .accent { fill: #ff0000; }
+      @media (prefers-color-scheme: dark) {
+        .wordmark { fill: #ffffff; }
+        .wordmark .primary { fill: #ffffff; }
+      }
+    ]]></style>
+  </defs>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-66.186972,-133.80171)">
+    <g
+       id="text1"
+       class="wordmark"
+       style="font-size:3.175px;stroke-width:0.244"
+       aria-label="head{…}son">
+      <g
+         id="text2"
+         class="accent"
+         style="font-size:2.11667px;font-family:'Roboto Mono';-inkscape-font-specification:'Roboto Mono'"
+         aria-label="head{…}son">
+        <path class="primary"
+           style="font-family:Roboto;-inkscape-font-specification:Roboto;opacity:1"
+           d="m 66.378175,133.86475 v 1.58751 h -0.191203 v -1.58751 z m -0.04547,0.98599 -0.07958,-0.003 q 0.001,-0.11472 0.03411,-0.21187 0.03307,-0.0982 0.09302,-0.17054 0.05994,-0.0723 0.142628,-0.11162 0.08372,-0.0403 0.185001,-0.0403 0.08268,0 0.148829,0.0227 0.06615,0.0217 0.112655,0.0703 0.04754,0.0486 0.07235,0.12609 0.0248,0.0765 0.0248,0.18707 v 0.73278 H 66.87427 v -0.73484 q 0,-0.0879 -0.02584,-0.14056 -0.02584,-0.0538 -0.07545,-0.0775 -0.04961,-0.0248 -0.121957,-0.0248 -0.07131,0 -0.130224,0.03 -0.05788,0.03 -0.100253,0.0827 -0.04134,0.0527 -0.06511,0.12092 -0.02274,0.0672 -0.02274,0.14263 z m 1.484149,0.62219 q -0.116788,0 -0.211873,-0.0393 -0.09405,-0.0403 -0.162264,-0.11265 -0.06718,-0.0724 -0.103353,-0.17157 -0.03617,-0.0992 -0.03617,-0.21704 v -0.0434 q 0,-0.13642 0.04031,-0.24288 0.04031,-0.10749 0.109554,-0.1819 0.06925,-0.0744 0.157096,-0.11265 0.08785,-0.0383 0.181902,-0.0383 0.119889,0 0.206706,0.0413 0.08785,0.0413 0.143661,0.11575 0.05581,0.0734 0.08268,0.17363 0.02687,0.0992 0.02687,0.21705 v 0.0858 h -0.835093 v -0.15606 h 0.64389 v -0.0145 q -0.0041,-0.0744 -0.03101,-0.1447 -0.02584,-0.0703 -0.08268,-0.11575 -0.05684,-0.0455 -0.155029,-0.0455 -0.06511,0 -0.11989,0.0279 -0.05478,0.0269 -0.09405,0.0806 -0.03927,0.0537 -0.06098,0.13126 -0.0217,0.0775 -0.0217,0.1788 v 0.0434 q 0,0.0796 0.0217,0.14986 0.02274,0.0693 0.06511,0.12196 0.04341,0.0527 0.104387,0.0827 0.06201,0.03 0.14056,0.03 0.101286,0 0.171566,-0.0413 0.07028,-0.0413 0.12299,-0.11059 l 0.115755,0.092 q -0.03617,0.0548 -0.09198,0.10438 -0.05581,0.0496 -0.137459,0.0806 -0.08062,0.031 -0.191204,0.031 z m 1.317752,-0.21188 v -0.57567 q 0,-0.0662 -0.02687,-0.11473 -0.02584,-0.0496 -0.07855,-0.0765 -0.05271,-0.0269 -0.130225,-0.0269 -0.07235,0 -0.127124,0.0248 -0.05374,0.0248 -0.08475,0.0651 -0.02997,0.0403 -0.02997,0.0868 h -0.191203 q 0,-0.0599 0.03101,-0.11885 0.031,-0.0589 0.08888,-0.10645 0.05891,-0.0486 0.14056,-0.0765 0.08268,-0.0289 0.183969,-0.0289 0.121956,0 0.214974,0.0413 0.09405,0.0413 0.146761,0.12505 0.05374,0.0827 0.05374,0.20774 v 0.5209 q 0,0.0558 0.0093,0.11886 0.01033,0.063 0.02997,0.10852 v 0.0165 h -0.199471 q -0.01447,-0.0331 -0.02274,-0.0879 -0.0083,-0.0558 -0.0083,-0.10336 z m 0.03307,-0.48679 0.0021,0.13436 h -0.19327 q -0.08165,0 -0.145728,0.0134 -0.06408,0.0124 -0.107487,0.0382 -0.04341,0.0258 -0.06615,0.0651 -0.02274,0.0382 -0.02274,0.0899 0,0.0527 0.02377,0.0961 0.02377,0.0434 0.07131,0.0692 0.04858,0.0248 0.118856,0.0248 0.08785,0 0.155029,-0.0372 0.06718,-0.0372 0.106454,-0.091 0.04031,-0.0537 0.04341,-0.10439 l 0.08165,0.092 q -0.0072,0.0434 -0.03927,0.0961 -0.03204,0.0527 -0.08578,0.10129 -0.05271,0.0475 -0.126091,0.0796 -0.07235,0.031 -0.163297,0.031 -0.113689,0 -0.199472,-0.0444 -0.08475,-0.0444 -0.132292,-0.11885 -0.04651,-0.0754 -0.04651,-0.16847 0,-0.0899 0.03514,-0.15813 0.03514,-0.0692 0.101286,-0.11472 0.06615,-0.0465 0.159164,-0.0703 0.09302,-0.0238 0.20774,-0.0238 z m 1.163754,0.46095 v -1.37046 h 0.192237 v 1.58751 h -0.1757 z m -0.75241,-0.32969 v -0.0217 q 0,-0.12815 0.03101,-0.23254 0.03204,-0.10542 0.08992,-0.18087 0.05891,-0.0755 0.139527,-0.11575 0.08165,-0.0413 0.181901,-0.0413 0.10542,0 0.183969,0.0372 0.07958,0.0362 0.134359,0.10646 0.05581,0.0692 0.08785,0.16743 0.03204,0.0982 0.04444,0.22221 v 0.0951 q -0.01137,0.12299 -0.04444,0.22118 -0.03204,0.0982 -0.08785,0.16743 -0.05478,0.0693 -0.134359,0.10645 -0.07958,0.0362 -0.186036,0.0362 -0.09819,0 -0.179834,-0.0424 -0.08061,-0.0424 -0.139527,-0.11885 -0.05788,-0.0765 -0.08992,-0.17984 -0.03101,-0.10439 -0.03101,-0.22634 z m 0.192237,-0.0217 v 0.0217 q 0,0.0837 0.01654,0.15709 0.01757,0.0734 0.05374,0.1292 0.03617,0.0558 0.09198,0.0879 0.05581,0.031 0.133326,0.031 0.09508,0 0.156063,-0.0403 0.06201,-0.0403 0.09922,-0.10645 0.03721,-0.0662 0.05788,-0.14366 v -0.24908 q -0.0124,-0.0568 -0.03617,-0.10956 -0.02274,-0.0537 -0.05994,-0.0951 -0.03617,-0.0424 -0.08992,-0.0672 -0.05271,-0.0248 -0.125057,-0.0248 -0.07855,0 -0.135393,0.0331 -0.05581,0.032 -0.09198,0.0889 -0.03617,0.0558 -0.05374,0.13023 -0.01654,0.0734 -0.01654,0.15709 z m 1.556497,-1.0821 0.04031,0.11782 q -0.12299,0.0382 -0.169499,0.13746 -0.04651,0.0982 -0.04651,0.22531 v 0.21394 q 0,0.10335 -0.04237,0.1881 -0.04134,0.0837 -0.132292,0.13333 -0.08992,0.0496 -0.236679,0.0496 v -0.12609 q 0.116789,0 0.167432,-0.0661 0.05168,-0.0661 0.05168,-0.1788 v -0.21394 q 0,-0.10852 0.03307,-0.20257 0.03411,-0.0951 0.113688,-0.1664 0.08062,-0.0724 0.221176,-0.11162 z m 0.04031,1.90996 -0.04031,0.11886 q -0.14056,-0.0403 -0.221176,-0.11162 -0.07958,-0.0713 -0.113688,-0.1664 -0.03307,-0.0941 -0.03307,-0.20257 v -0.21291 q 0,-0.0755 -0.02274,-0.13023 -0.02274,-0.0548 -0.07131,-0.0847 -0.04754,-0.031 -0.125058,-0.031 v -0.12609 q 0.146762,0 0.236679,0.0496 0.09095,0.0496 0.132292,0.13436 0.04237,0.0837 0.04237,0.1881 v 0.21291 q 0,0.0847 0.01964,0.15709 0.02067,0.0724 0.06718,0.12506 0.04754,0.0537 0.129191,0.0796 z"
+           id="path1" />
+        <path
+           style="font-family:Roboto;-inkscape-font-specification:Roboto"
+           d="m 71.54376,135.35097 q 0,-0.0486 0.02997,-0.0816 0.03101,-0.0341 0.08888,-0.0341 0.05788,0 0.08785,0.0341 0.03101,0.0331 0.03101,0.0816 0,0.0475 -0.03101,0.0806 -0.02997,0.0331 -0.08785,0.0331 -0.05788,0 -0.08888,-0.0331 -0.02997,-0.0331 -0.02997,-0.0806 z m 0.451652,0 q 0,-0.0486 0.02997,-0.0816 0.03101,-0.0341 0.08888,-0.0341 0.05788,0 0.08785,0.0341 0.03101,0.0331 0.03101,0.0816 0,0.0475 -0.03101,0.0806 -0.02997,0.0331 -0.08785,0.0331 -0.05788,0 -0.08888,-0.0331 -0.02997,-0.0331 -0.02997,-0.0806 z m 0.428915,0 q 0,-0.0486 0.02997,-0.0816 0.03101,-0.0341 0.08888,-0.0341 0.05788,0 0.08785,0.0341 0.03101,0.0331 0.03101,0.0816 0,0.0475 -0.03101,0.0806 -0.02997,0.0331 -0.08785,0.0331 -0.05788,0 -0.08888,-0.0331 -0.02997,-0.0331 -0.02997,-0.0806 z"
+           id="path2" />
+        <path class="primary"
+           style="font-family:Roboto;-inkscape-font-specification:Roboto;opacity:1"
+           d="m 72.827404,133.91953 0.04031,-0.11782 q 0.141594,0.0393 0.221176,0.11162 0.08061,0.0713 0.113688,0.1664 0.03307,0.094 0.03307,0.20257 v 0.21394 q 0,0.0744 0.02274,0.13022 0.02274,0.0548 0.07028,0.0847 0.04858,0.03 0.126091,0.03 v 0.11679 q -0.145728,0 -0.236679,-0.0465 -0.09095,-0.0476 -0.133325,-0.12919 -0.04134,-0.0827 -0.04134,-0.18604 v -0.21394 q 0,-0.0847 -0.01964,-0.1571 -0.01964,-0.0734 -0.06718,-0.12609 -0.04651,-0.0537 -0.129191,-0.0796 z m 0.04031,1.911 -0.04031,-0.11886 q 0.08165,-0.0258 0.128157,-0.0796 0.04754,-0.0527 0.06718,-0.12506 0.02067,-0.0723 0.02067,-0.15709 v -0.21291 q 0,-0.10439 0.04134,-0.18604 0.04237,-0.0816 0.133325,-0.12815 0.09095,-0.0476 0.236679,-0.0476 v 0.11576 q -0.115756,0 -0.167432,0.0672 -0.05168,0.0661 -0.05168,0.1788 v 0.21291 q 0,0.10852 -0.03307,0.20257 -0.03307,0.0951 -0.113688,0.1664 -0.07958,0.0713 -0.221176,0.11162 z m 1.452111,-0.6749 q 0,-0.0413 -0.0186,-0.0765 -0.01757,-0.0362 -0.07338,-0.0651 -0.05478,-0.03 -0.165365,-0.0517 -0.09302,-0.0196 -0.168465,-0.0465 -0.07441,-0.0269 -0.127124,-0.0651 -0.05168,-0.0382 -0.07958,-0.0899 -0.02791,-0.0517 -0.02791,-0.12092 0,-0.0662 0.02894,-0.12506 0.02997,-0.0589 0.08372,-0.10438 0.05478,-0.0455 0.131258,-0.0713 0.07648,-0.0258 0.170532,-0.0258 0.134359,0 0.229444,0.0476 0.09508,0.0475 0.145728,0.12712 0.05064,0.0786 0.05064,0.17467 h -0.191203 q 0,-0.0465 -0.02791,-0.0899 -0.02687,-0.0444 -0.07958,-0.0734 -0.05168,-0.0289 -0.127125,-0.0289 -0.07958,0 -0.129191,0.0248 -0.04858,0.0238 -0.07131,0.061 -0.0217,0.0372 -0.0217,0.0785 0,0.031 0.01034,0.0558 0.01137,0.0238 0.03927,0.0445 0.02791,0.0196 0.07855,0.0372 0.05064,0.0176 0.129191,0.0351 0.13746,0.031 0.226343,0.0744 0.08888,0.0434 0.132292,0.10645 0.04341,0.0631 0.04341,0.15296 0,0.0734 -0.03101,0.13436 -0.02997,0.061 -0.08785,0.10542 -0.05684,0.0434 -0.136426,0.0682 -0.07855,0.0238 -0.176734,0.0238 -0.147795,0 -0.250114,-0.0527 -0.10232,-0.0527 -0.15503,-0.13643 -0.05271,-0.0837 -0.05271,-0.17673 h 0.192237 q 0.0041,0.0785 0.04548,0.12505 0.04134,0.0455 0.101286,0.0651 0.05994,0.0186 0.118856,0.0186 0.07855,0 0.131258,-0.0207 0.05374,-0.0207 0.08165,-0.0568 0.02791,-0.0362 0.02791,-0.0827 z m 0.390675,-0.25011 v -0.0238 q 0,-0.12093 0.03514,-0.22428 0.03514,-0.10439 0.101286,-0.18087 0.06614,-0.0775 0.160197,-0.11989 0.09405,-0.0434 0.21084,-0.0434 0.117822,0 0.211874,0.0434 0.09508,0.0424 0.16123,0.11989 0.06718,0.0765 0.10232,0.18087 0.03514,0.10335 0.03514,0.22428 v 0.0238 q 0,0.12092 -0.03514,0.22427 -0.03514,0.10336 -0.10232,0.18087 -0.06615,0.0765 -0.160197,0.11989 -0.09302,0.0424 -0.21084,0.0424 -0.117823,0 -0.211874,-0.0424 -0.09405,-0.0434 -0.16123,-0.11989 -0.06615,-0.0775 -0.101286,-0.18087 -0.03514,-0.10335 -0.03514,-0.22427 z m 0.191203,-0.0238 v 0.0238 q 0,0.0837 0.01964,0.15813 0.01964,0.0734 0.05891,0.13022 0.04031,0.0568 0.100252,0.0899 0.05994,0.032 0.139527,0.032 0.07855,0 0.137459,-0.032 0.05994,-0.0331 0.09922,-0.0899 0.03928,-0.0568 0.05891,-0.13022 0.02067,-0.0744 0.02067,-0.15813 v -0.0238 q 0,-0.0827 -0.02067,-0.15607 -0.01964,-0.0744 -0.05994,-0.13125 -0.03927,-0.0579 -0.09922,-0.091 -0.05891,-0.0331 -0.138493,-0.0331 -0.07855,0 -0.138493,0.0331 -0.05891,0.0331 -0.09922,0.091 -0.03927,0.0568 -0.05891,0.13125 -0.01964,0.0734 -0.01964,0.15607 z m 1.257805,-0.30903 v 0.87954 h -0.191203 v -1.11828 h 0.180868 z m -0.04547,0.27802 -0.07958,-0.003 q 0.001,-0.11472 0.03411,-0.21187 0.03307,-0.0982 0.09302,-0.17054 0.05994,-0.0723 0.142627,-0.11162 0.08372,-0.0403 0.185002,-0.0403 0.08268,0 0.148828,0.0227 0.06615,0.0217 0.112655,0.0703 0.04754,0.0486 0.07235,0.12609 0.02481,0.0765 0.02481,0.18707 v 0.73278 H 76.6556 v -0.73484 q 0,-0.0879 -0.02584,-0.14056 -0.02584,-0.0538 -0.07545,-0.0775 -0.04961,-0.0248 -0.121957,-0.0248 -0.07131,0 -0.130224,0.03 -0.05788,0.03 -0.100253,0.0827 -0.04134,0.0527 -0.06511,0.12092 -0.02274,0.0672 -0.02274,0.14263 z"
+           id="path3" />
+      </g>
+    </g>
+  </g>
+</svg>

{headson-0.5.4 → headson-0.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "headson"
-version = "0.5.4"
+version = "0.6.1"
 description = "Budget‑constrained JSON preview renderer (Python bindings)"
 readme = "README.md"
 requires-python = ">=3.10"

{headson-0.5.4 → headson-0.6.1}/python/Cargo.lock

@@ -169,7 +169,7 @@ dependencies = [
 
 [[package]]
 name = "headson"
-version = "0.5.4"
+version = "0.6.1"
 dependencies = [
  "anyhow",
  "clap",
@@ -182,7 +182,7 @@ dependencies = [
 
 [[package]]
 name = "headson-python"
-version = "0.5.4"
+version = "0.6.1"
 dependencies = [
  "anyhow",
  "headson",

{headson-0.5.4 → headson-0.6.1}/python/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "headson-python"
-version = "0.5.4"
+version = "0.6.1"
 edition = "2021"
 publish = false
 readme = "README.md"

{headson-0.5.4 → headson-0.6.1}/python/src/lib.rs

@@ -2,7 +2,7 @@ use anyhow::{bail, Result};
 use pyo3::exceptions::PyRuntimeError;
 use pyo3::prelude::*;
 use pyo3::types::PyModule;
-use headson_core::{ArraySamplerStrategy, OutputTemplate, PriorityConfig, RenderConfig};
+use headson_core::{ArraySamplerStrategy, ColorMode, OutputTemplate, PriorityConfig, RenderConfig};
 
 fn to_template(s: &str) -> Result<OutputTemplate> {
     match s.to_ascii_lowercase().as_str() {
@@ -22,7 +22,7 @@ fn render_config_with_sampler(
     let newline = "\n".to_string();
     let indent_unit = "  ".to_string();
     let prefer_tail_arrays = matches!(sampler, ArraySamplerStrategy::Tail);
-    Ok(RenderConfig { template: t, indent_unit, space, newline, prefer_tail_arrays })
+    Ok(RenderConfig { template: t, indent_unit, space, newline, prefer_tail_arrays, color_mode: ColorMode::Auto, color_enabled: false })
 }
 
 fn parse_skew(skew: &str) -> Result<ArraySamplerStrategy> {

{headson-0.5.4 → headson-0.6.1}/src/json_ingest/samplers/default.rs

@@ -21,7 +21,6 @@ struct SampleAccumulator<'a> {
     indices: &'a mut Vec<usize>,
 }
 
-#[inline]
 fn mix64(mut x: u64) -> u64 {
     x ^= x >> 30;
     x = x.wrapping_mul(0xbf58_476d_1ce4_e5b9);
@@ -30,7 +29,6 @@ fn mix64(mut x: u64) -> u64 {
     x ^ (x >> 31)
 }
 
-#[inline]
 fn accept_index(i: u64) -> bool {
     let h = mix64(i ^ RANDOM_ACCEPT_SEED);
     ((h >> 32) as u32) < RANDOM_ACCEPT_THRESHOLD

{headson-0.5.4 → headson-0.6.1}/src/lib.rs

@@ -25,7 +25,8 @@ pub use order::{
     NodeId, NodeKind, PriorityConfig, PriorityOrder, RankedNode, build_order,
 };
 
-pub use serialization::types::{OutputTemplate, RenderConfig};
+pub use serialization::color::resolve_color_enabled;
+pub use serialization::types::{ColorMode, OutputTemplate, RenderConfig};
 
 pub fn headson(
     input: Vec<u8>,
@@ -76,7 +77,11 @@ fn find_largest_render_under_budget(
     let mut inclusion_flags: Vec<u32> = vec![0; total];
     // Each render attempt bumps this non-zero identifier to create a fresh inclusion set.
     let mut render_set_id: u32 = 1;
-    let mut best_str: Option<String> = None;
+    // Measure length without color so ANSI escapes do not count toward the
+    // character budget. Then render once more with the requested color setting.
+    let mut best_k: Option<usize> = None;
+    let mut measure_cfg = config.clone();
+    measure_cfg.color_enabled = false;
 
     let _ = crate::utils::search::binary_search_max(lo, hi, |mid| {
         let s = crate::serialization::render_top_k(
@@ -84,19 +89,26 @@ fn find_largest_render_under_budget(
             mid,
             &mut inclusion_flags,
             render_set_id,
-            config,
+            &measure_cfg,
         );
         render_set_id = render_set_id.wrapping_add(1).max(1);
         if s.len() <= char_budget {
-            best_str = Some(s);
+            best_k = Some(mid);
             true
         } else {
             false
         }
     });
 
-    if let Some(s) = best_str {
-        s
+    if let Some(k) = best_k {
+        // Final render with original color settings
+        crate::serialization::render_top_k(
+            order_build,
+            k,
+            &mut inclusion_flags,
+            render_set_id,
+            config,
+        )
     } else {
         // Fallback: always render a single node (k=1) to produce the
         // shortest possible preview, even if it exceeds the byte budget.

{headson-0.5.4 → headson-0.6.1}/src/main.rs

@@ -1,9 +1,10 @@
 use std::fs::File;
+use std::io::IsTerminal as _;
 use std::io::{self, Read};
 use std::path::{Path, PathBuf};
 
 use anyhow::{Context, Result};
-use clap::{Parser, ValueEnum};
+use clap::{ArgAction, Parser, ValueEnum};
 use content_inspector::{ContentType, inspect};
 
 type InputEntry = (String, Vec<u8>);
@@ -65,6 +66,20 @@ struct Cli {
         help = "Prefer the beginning of arrays when truncating (keep first N)."
     )]
     head: bool,
+    #[arg(
+        long = "color",
+        action = ArgAction::SetTrue,
+        conflicts_with = "no_color",
+        help = "Force enable ANSI colors in output"
+    )]
+    color: bool,
+    #[arg(
+        long = "no-color",
+        action = ArgAction::SetTrue,
+        conflicts_with = "color",
+        help = "Disable ANSI colors in output"
+    )]
+    no_color: bool,
     #[arg(
         value_name = "INPUT",
         value_hint = clap::ValueHint::FilePath,
@@ -85,6 +100,9 @@ fn main() -> Result<()> {
     let cli = Cli::parse();
 
     let render_cfg = get_render_config_from(&cli);
+    // Resolve color auto-detection now (stdout is the surface for user output).
+    let _color_enabled =
+        render_cfg.color_mode.effective(io::stdout().is_terminal());
     let (output, ignore_notices) = if cli.inputs.is_empty() {
         (run_from_stdin(&cli, &render_cfg)?, Vec::new())
     } else {
@@ -222,11 +240,24 @@ fn ingest_paths(paths: &[PathBuf]) -> Result<(InputEntries, IgnoreNotices)> {
 }
 
 fn get_render_config_from(cli: &Cli) -> headson::RenderConfig {
-    let template = match cli.template {
-        Template::Json => headson::OutputTemplate::Json,
-        Template::Pseudo => headson::OutputTemplate::Pseudo,
-        Template::Js => headson::OutputTemplate::Js,
-    };
+    fn to_output_template(t: Template) -> headson::OutputTemplate {
+        match t {
+            Template::Json => headson::OutputTemplate::Json,
+            Template::Pseudo => headson::OutputTemplate::Pseudo,
+            Template::Js => headson::OutputTemplate::Js,
+        }
+    }
+    fn color_mode_from_flags(cli: &Cli) -> headson::ColorMode {
+        if cli.color {
+            headson::ColorMode::On
+        } else if cli.no_color {
+            headson::ColorMode::Off
+        } else {
+            headson::ColorMode::Auto
+        }
+    }
+
+    let template = to_output_template(cli.template);
     let space = if cli.compact || cli.no_space { "" } else { " " }.to_string();
     let newline = if cli.compact || cli.no_newline {
         ""
@@ -239,6 +270,8 @@ fn get_render_config_from(cli: &Cli) -> headson::RenderConfig {
     } else {
         cli.indent.clone()
     };
+    let color_mode = color_mode_from_flags(cli);
+    let color_enabled = headson::resolve_color_enabled(color_mode);
 
     headson::RenderConfig {
         template,
@@ -246,6 +279,8 @@ fn get_render_config_from(cli: &Cli) -> headson::RenderConfig {
         space,
         newline,
         prefer_tail_arrays: cli.tail,
+        color_mode,
+        color_enabled,
     }
 }
 

headson-0.6.1/src/serialization/color.rs

@@ -0,0 +1,113 @@
+use std::io::IsTerminal as _;
+
+use crate::serialization::types::ColorMode;
+
+// ANSI SGR fragments
+const RESET: &str = "\u{001b}[0m";
+const BOLD_BLUE: &str = "\u{001b}[1;34m";
+const GREEN: &str = "\u{001b}[32m";
+const CYAN: &str = "\u{001b}[36m";
+const BRIGHT_GRAY: &str = "\u{001b}[37m";
+const DARK_GRAY: &str = "\u{001b}[90m";
+
+#[derive(Copy, Clone, Debug, Eq, PartialEq)]
+pub enum ColorRole {
+    Key,
+    String,
+    Number,
+    Bool,
+    Null,
+}
+
+pub fn wrap_role<S: Into<String>>(
+    s: S,
+    role: ColorRole,
+    enabled: bool,
+) -> String {
+    let s: String = s.into();
+    if !enabled {
+        return s;
+    }
+    let prefix = match role {
+        ColorRole::Key => BOLD_BLUE,
+        ColorRole::String => GREEN,
+        ColorRole::Number => CYAN,
+        ColorRole::Bool | ColorRole::Null => BRIGHT_GRAY,
+    };
+    let mut out = String::with_capacity(8 + 8 + s.len());
+    out.push_str(prefix);
+    out.push_str(&s);
+    out.push_str(RESET);
+    out
+}
+
+pub fn omission_marker(enabled: bool) -> &'static str {
+    if enabled {
+        "\u{001b}[90m…\u{001b}[0m"
+    } else {
+        "…"
+    }
+}
+
+pub fn color_comment<S: Into<String>>(body: S, enabled: bool) -> String {
+    if !enabled {
+        return body.into();
+    }
+    let b = body.into();
+    let mut out = String::with_capacity(b.len() + 8 + 4);
+    out.push_str(DARK_GRAY);
+    out.push_str(&b);
+    out.push_str(RESET);
+    out
+}
+
+fn env_bool(var: &str) -> Option<bool> {
+    std::env::var_os(var).map(|v| {
+        let s = v.to_string_lossy();
+        !(s == "0" || s.is_empty())
+    })
+}
+
+struct ColorEnv {
+    force: bool,            // CLICOLOR_FORCE=1
+    force_color: bool,      // FORCE_COLOR=1
+    no_color: bool,         // NO_COLOR present
+    dumb: bool,             // TERM=dumb
+    clicolor: Option<bool>, // CLICOLOR=0/1
+    is_tty: bool,
+}
+
+fn read_color_env() -> ColorEnv {
+    let term_dumb = std::env::var_os("TERM")
+        .map(|t| t.to_string_lossy() == "dumb")
+        .unwrap_or(false);
+    ColorEnv {
+        force: matches!(env_bool("CLICOLOR_FORCE"), Some(true)),
+        force_color: matches!(env_bool("FORCE_COLOR"), Some(true)),
+        no_color: std::env::var_os("NO_COLOR").is_some(),
+        dumb: term_dumb,
+        clicolor: env_bool("CLICOLOR"),
+        is_tty: std::io::stdout().is_terminal(),
+    }
+}
+
+fn auto_color_enabled(env: &ColorEnv) -> bool {
+    if env.force || env.force_color {
+        return true;
+    }
+    if env.no_color || env.dumb {
+        return false;
+    }
+    if let Some(b) = env.clicolor {
+        return b && env.is_tty;
+    }
+    env.is_tty
+}
+
+pub fn resolve_color_enabled(mode: ColorMode) -> bool {
+    match mode {
+        ColorMode::On => true,
+        ColorMode::Off => false,
+        ColorMode::Auto => auto_color_enabled(&read_color_env()),
+    }
+}

{headson-0.5.4 → headson-0.6.1}/src/serialization/fileset.rs

@@ -17,7 +17,7 @@ impl<'a> RenderScope<'a> {
         out.push_str("// ");
         out.push_str(raw_key);
         out.push_str(nl);
-        let rendered = self.serialize_node(child_pq_id, depth, false);
+        let rendered = self.render_node_to_string(child_pq_id, depth, false);
         out.push_str(&rendered);
         out.push(';');
         out.push_str(nl);
@@ -58,7 +58,7 @@ impl<'a> RenderScope<'a> {
         out.push_str(raw_key);
         out.push_str(" <==");
         out.push_str(nl);
-        let rendered = self.serialize_node(child_pq_id, depth, false);
+        let rendered = self.render_node_to_string(child_pq_id, depth, false);
         out.push_str(&rendered);
     }