@effected/env 0.1.2 → 0.2.0

package/TerminalEnv.js

@@ -30,7 +30,7 @@ const snapshot = (options, columns) => Effect.gen(function* () {
 	const stdio = yield* Stdio.Stdio;
 	const stdin = yield* stdio.stdinIsTerminal;
 	const stdout = yield* stdio.stdoutIsTerminal;
-	const stderr = yield* options?.stderrIsTerminal ?? Effect.succeed(stdout);
+	const stderr = yield* options?.stderrIsTerminal ?? stdio.stderrIsTerminal;
 	const env = yield* readEnv([...allKeys, "COLUMNS"]);
 	return make(env, {
 		stdin,
@@ -71,7 +71,7 @@ var TerminalEnv = class TerminalEnv extends Context.Service()("@effected/env/Ter
 	* Build the snapshot from `Stdio`, `Terminal` and the ambient `ConfigProvider`.
 	*
 	* @remarks
-	* `Stdio` reports only stdout, so stderr mirrors it unless `options.stderrIsTerminal` supplies its own answer.
+	* Every stream's terminal check comes from `Stdio`; `options.stderrIsTerminal` replaces stderr's alone.
 	* A layer-returning function mints a fresh layer per call: call it once and bind the result to a constant.
 	*
 	* @param options - `stderrIsTerminal` overrides the stderr TTY check
@@ -128,7 +128,7 @@ var TerminalEnv = class TerminalEnv extends Context.Service()("@effected/env/Ter
 	* requires only `Stdio`, never `Terminal` or `TerminalEnv`, so a caller that only decides colour (a CLI's
 	* output formatter) keeps a `Stdio`-only requirement.
 	*
-	* @param _stream - the stream to decide for; only `stdout` is available, since `Stdio` reports no other
+	* @param _stream - the stream to decide for; only `stdout` is offered, the stream an output formatter paints
 	*/
 	static colorLevel(_stream) {
 		return Effect.gen(function* () {

package/index.d.ts

@@ -335,7 +335,13 @@ interface StreamEnv {
  * @public
  */
 interface TerminalEnvOptions {
-  /** Overrides the stderr TTY check; `Stdio` reports only stdout, so stderr mirrors stdout when this is omitted. */
+  /**
+   * Overrides the stderr terminal check; omitted, `Stdio.stderrIsTerminal` answers.
+   *
+   * @remarks
+   * The platform `Stdio` layers answer from the host (`process.stderr.isTTY` on Node), and a `Stdio` built with
+   * `Stdio.make` without the field answers `false`. Pass this only for a host whose `Stdio` cannot say.
+   */
   readonly stderrIsTerminal?: Effect.Effect<boolean>;
 }
 /**
@@ -397,7 +403,7 @@ export declare class TerminalEnv extends TerminalEnv_base {
    * Build the snapshot from `Stdio`, `Terminal` and the ambient `ConfigProvider`.
    *
    * @remarks
-   * `Stdio` reports only stdout, so stderr mirrors it unless `options.stderrIsTerminal` supplies its own answer.
+   * Every stream's terminal check comes from `Stdio`; `options.stderrIsTerminal` replaces stderr's alone.
    * A layer-returning function mints a fresh layer per call: call it once and bind the result to a constant.
    *
    * @param options - `stderrIsTerminal` overrides the stderr TTY check
@@ -433,7 +439,7 @@ export declare class TerminalEnv extends TerminalEnv_base {
    * requires only `Stdio`, never `Terminal` or `TerminalEnv`, so a caller that only decides colour (a CLI's
    * output formatter) keeps a `Stdio`-only requirement.
    *
-   * @param _stream - the stream to decide for; only `stdout` is available, since `Stdio` reports no other
+   * @param _stream - the stream to decide for; only `stdout` is offered, the stream an output formatter paints
    */
   static colorLevel(_stream: "stdout"): Effect.Effect<ColorLevel, never, Stdio.Stdio>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/env",
-	"version": "0.1.2",
+	"version": "0.2.0",
 	"private": false,
 	"description": "Effect-native environment detection: agent, CI, terminal colour level, hyperlinks, columns and audience — read once through Config, swapped in tests with layerTest",
 	"keywords": [
@@ -40,7 +40,7 @@
 		"./package.json": "./package.json"
 	},
 	"peerDependencies": {
-		"effect": "4.0.2"
+		"effect": "^4.0.0"
 	},
 	"engines": {
 		"node": ">=24.11.0"