@lewishowles/cli-style 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.8.1 - 2026-07-15
+
+### Fixed
+
+- Fixed the Python and Swift adapters losing ANSI colour: they now set `FORCE_COLOR=1` for the child process when the caller's own stdout is a TTY, unless the caller has already set `FORCE_COLOR` or `NO_COLOR`.
+- Documented that captured Bash output (command substitution) cannot auto-detect its eventual destination and requires an explicit `FORCE_COLOR=1` to opt into colour.
+
 ## 0.8.0 - 2026-07-05
 
 ### Added

package/README.md

@@ -107,6 +107,14 @@ cli_style_next_step_block "Update helpers scripts" "Wrappers are now available"
 
 The convenience functions build JSON internally, so callers do not need to escape quotes, backslashes, or paths by hand.
 
+Direct Bash calls use `cli-style`'s native stdout detection. When a helper's output is captured, the adapter cannot know where the captured text will be written, so set `FORCE_COLOR=1` explicitly when the destination is an interactive terminal:
+
+```bash
+command="$(FORCE_COLOR=1 cli_style_span "npm run docs:readme" info)"
+```
+
+Python and Swift automatically set `FORCE_COLOR=1` for the child render process when their caller's stdout is an interactive terminal. An existing `FORCE_COLOR` or `NO_COLOR` value is preserved. `FORCE_COLOR=0` does not enable colour, while `NO_COLOR`, `TERM=dumb`, and explicit no-colour flags remain authoritative.
+
 Set `CLI_STYLE_BIN` when `cli-style` is not on `PATH`:
 
 ```bash
@@ -506,7 +514,7 @@ Most renderers accept the same output options:
 | `unicode` | Whether Unicode symbols should be used.                                   |
 | `width`   | Available output width for renderers that adapt layout.                   |
 
-Use `createCliStyle()` to resolve these options from `argv`, `env`, `stdout`, CI, TTY, `NO_COLOR`, and terminal capability.
+Use `createCliStyle()` to resolve these options from `argv`, `env`, `stdout`, CI, TTY, `NO_COLOR`, `FORCE_COLOR`, and terminal capability.
 
 ### CLI and Bash flags
 

package/adapters/python/cli_style.py

@@ -7,6 +7,7 @@ import json
 import os
 import shutil
 import subprocess
+import sys
 from pathlib import Path
 from typing import Any, Sequence
 
@@ -23,6 +24,20 @@ class CliStyleRenderError(CliStyleError):
 	"""Raised when cli-style rejects a render request."""
 
 
+# Resolve the child environment while preserving explicit caller controls.
+def resolve_subprocess_environment() -> dict[str, str]:
+	environment = os.environ.copy()
+
+	if (
+		sys.stdout.isatty()
+		and "FORCE_COLOR" not in environment
+		and "NO_COLOR" not in environment
+	):
+		environment["FORCE_COLOR"] = "1"
+
+	return environment
+
+
 # Render caller data through `cli-style render`.
 #
 # @param  {str}  renderer
@@ -72,6 +87,7 @@ def render(
 		command,
 		capture_output=True,
 		check=False,
+		env=resolve_subprocess_environment(),
 		input=json.dumps(data),
 		text=True,
 	)

package/adapters/swift/CliStyle.swift

@@ -1,4 +1,9 @@
 import Foundation
+#if canImport(Darwin)
+import Darwin
+#elseif canImport(Glibc)
+import Glibc
+#endif
 
 // Error types for cli-style adapter failures.
 enum CliStyleError: Error {
@@ -89,6 +94,7 @@ enum CliStyle {
 		let process = Process()
 		process.executableURL = URL(fileURLWithPath: resolvedBinary)
 		process.arguments = arguments
+		process.environment = resolveProcessEnvironment()
 
 		let stdinPipe = Pipe()
 		let stdoutPipe = Pipe()
@@ -125,6 +131,21 @@ enum CliStyle {
 		return stdoutText.trimmingCharacters(in: .newlines)
 	}
 
+	/**
+	 * Resolve the child environment for a captured render.
+	 */
+	private static func resolveProcessEnvironment() -> [String: String] {
+		var environment = ProcessInfo.processInfo.environment
+
+		if isatty(STDOUT_FILENO) == 1 &&
+			environment["FORCE_COLOR"] == nil &&
+			environment["NO_COLOR"] == nil {
+			environment["FORCE_COLOR"] = "1"
+		}
+
+		return environment
+	}
+
 	/**
 	 Render a result status line.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lewishowles/cli-style",
-	"version": "0.8.0",
+	"version": "0.8.1",
 	"description": "Shared terminal output styles for Lewis Howles tools, diagnostics, and package CLIs.",
 	"license": "MIT",
 	"repository": {

package/src/capability/terminal.js

@@ -23,12 +23,14 @@ export function resolveTerminalCapabilities(options = {}) {
 	const isTty = stdout.isTTY === true;
 	const isCi = env.CI === "true" || env.CI === "1";
 	const isDumb = env.TERM === "dumb";
+	const forceColour = env.FORCE_COLOR !== undefined && env.FORCE_COLOR !== "0";
 	const width = resolveWidth(stdout.columns);
 	const usesPlain = argv.includes("--plain");
 
 	const colour = resolveColour({
 		argv,
 		env,
+		forceColour,
 		isDumb,
 		isTty,
 		usesPlain,
@@ -69,7 +71,7 @@ function resolveColour(options) {
 		return false;
 	}
 
-	return options.isTty;
+	return options.forceColour || options.isTty;
 }
 
 /**