Add color to error formatting (#746)

* Add color to error formatting

* Apply suggestions from code review

Co-authored-by: Daniel Chao <daniel.h.chao@gmail.com>

* Address reviewer comments

* Apply suggestions from code review

Co-authored-by: Daniel Chao <daniel.h.chao@gmail.com>

* Define style choices as operations on formatter (abandon semantic API)

* Adjust margin styling

* Review feedback

* Documentation nits

---------

Co-authored-by: Daniel Chao <daniel.h.chao@gmail.com>

docs/modules/pkl-cli/partials/cli-common-options.adoc

@@ -19,6 +19,19 @@ Patterns are matched against the beginning of resource URIs.
 At least one pattern needs to match for a resource to be readable.
 ====
 
+[[color]]
+.--color
+[%collapsible]
+====
+Default: `auto` +
+When to format messages with ANSI color codes.
+Possible values:
+
+- `"never"`: Never format
+- `"auto"`: Format if `stdin`, `stdout`, or `stderr` are connected to a console.
+- `"always"`: Always format
+====
+
 [[cache-dir]]
 .--cache-dir
 [%collapsible]

docs/modules/pkl-gradle/partials/gradle-common-properties.adoc

@@ -67,6 +67,13 @@ The cache directory for storing packages.
 If `null`, defaults to `~/.pkl/cache`.
 ====
 
+.color: Property<Boolean>
+[%collapsible]
+====
+Default: `false` +
+Format messages using ANSI color.
+====
+
 .noCache: Property<Boolean>
 [%collapsible]
 ====

docs/src/test/kotlin/DocSnippetTests.kt

@@ -96,7 +96,8 @@ class DocSnippetTestsEngine : HierarchicalTestEngine<DocSnippetTestsEngine.Execu
       null,
       null,
       IoUtils.getCurrentWorkingDir(),
-      StackFrameTransformers.defaultTransformer
+      StackFrameTransformers.defaultTransformer,
+      false,
     )
     return ExecutionContext(replServer)
   }