@cjser/supports-color 10.2.2-cjser.2 → 11.0.0-cjser.2

package/browser.js

@@ -1,19 +1,17 @@
-/* eslint-env browser */
-/* eslint-disable n/no-unsupported-features/node-builtins */
-
 const level = (() => {
 	if (!('navigator' in globalThis)) {
 		return 0;
 	}
 
-	if (globalThis.navigator.userAgentData) {
+	if (navigator.userAgentData) {
 		const brand = navigator.userAgentData.brands.find(({brand}) => brand === 'Chromium');
 		if (brand?.version > 93) {
 			return 3;
 		}
 	}
 
-	if (/\b(Chrome|Chromium)\//.test(globalThis.navigator.userAgent)) {
+	// eslint-disable-next-line require-unicode-regexp -- This entry point supports browsers without Unicode Sets.
+	if (/\b(?:Chrome|Chromium)\//.test(navigator.userAgent)) {
 		return 1;
 	}
 

package/dist-cjser/index.cjs

@@ -16,7 +16,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/@cjser/supports-color/browser.js
+// packages/@cjser/supports-color.tmp-26-1785083390585/browser.js
 var browser_exports = {};
 __export(browser_exports, {
   default: () => browser_default
@@ -26,13 +26,13 @@ var level = (() => {
   if (!("navigator" in globalThis)) {
     return 0;
   }
-  if (globalThis.navigator.userAgentData) {
+  if (navigator.userAgentData) {
     const brand = navigator.userAgentData.brands.find(({ brand: brand2 }) => brand2 === "Chromium");
     if ((brand == null ? void 0 : brand.version) > 93) {
       return 3;
     }
   }
-  if (/\b(Chrome|Chromium)\//.test(globalThis.navigator.userAgent)) {
+  if (/\b(?:Chrome|Chromium)\//.test(navigator.userAgent)) {
     return 1;
   }
   return 0;

package/index.js

@@ -47,7 +47,11 @@ function envForceColor() {
 		return 1;
 	}
 
-	const level = Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
+	if (!/^\d+$/v.test(env.FORCE_COLOR)) {
+		return;
+	}
+
+	const level = Math.min(Number(env.FORCE_COLOR), 3);
 
 	if (![0, 1, 2, 3].includes(level)) {
 		return;
@@ -69,6 +73,7 @@ function translateLevel(level) {
 	};
 }
 
+// eslint-disable-next-line complexity -- Color support detection necessarily handles multiple environments.
 function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	const noFlagForceColor = envForceColor();
 	if (noFlagForceColor !== undefined) {
@@ -93,6 +98,11 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 		}
 	}
 
+	// A numeric `FORCE_COLOR` requests an exact level, while `FORCE_COLOR=true` and `FORCE_COLOR=` only enable color and let the level be detected.
+	if (forceColor !== undefined && /^\d+$/v.test(env.FORCE_COLOR)) {
+		return forceColor;
+	}
+
 	// Check for Azure DevOps pipelines.
 	// Has to be above the `!streamIsTTY` check.
 	if ('TF_BUILD' in env && 'AGENT_NAME' in env) {
@@ -124,11 +134,11 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	}
 
 	if ('CI' in env) {
-		if (['GITHUB_ACTIONS', 'GITEA_ACTIONS', 'CIRCLECI'].some(key => key in env)) {
+		if (['GITHUB_ACTIONS', 'GITEA_ACTIONS', 'CIRCLECI'].some(key => Object.hasOwn(env, key))) {
 			return 3;
 		}
 
-		if (['TRAVIS', 'APPVEYOR', 'GITLAB_CI', 'BUILDKITE', 'DRONE'].some(sign => sign in env) || env.CI_NAME === 'codeship') {
+		if (['TRAVIS', 'APPVEYOR', 'GITLAB_CI', 'BUILDKITE', 'DRONE'].some(sign => Object.hasOwn(env, sign)) || env.CI_NAME === 'codeship') {
 			return 1;
 		}
 
@@ -136,7 +146,7 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	}
 
 	if ('TEAMCITY_VERSION' in env) {
-		return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
+		return /^(?:9\.0*[1-9]\d*\.|\d{2,}\.)/v.test(env.TEAMCITY_VERSION) ? 1 : 0;
 	}
 
 	if (env.COLORTERM === 'truecolor') {
@@ -156,7 +166,7 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	}
 
 	if ('TERM_PROGRAM' in env) {
-		const version = Number.parseInt((env.TERM_PROGRAM_VERSION || '').split('.')[0], 10);
+		const version = Number((env.TERM_PROGRAM_VERSION || '').split('.', 1)[0]);
 
 		switch (env.TERM_PROGRAM) {
 			case 'iTerm.app': {
@@ -170,11 +180,11 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 		}
 	}
 
-	if (/-256(color)?$/i.test(env.TERM)) {
+	if (/-256(?:color)?$/iv.test(env.TERM)) {
 		return 2;
 	}
 
-	if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
+	if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/iv.test(env.TERM)) {
 		return 1;
 	}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjser/supports-color",
-  "version": "10.2.2-cjser.2",
+  "version": "11.0.0-cjser.2",
   "description": "Detect whether a terminal supports color",
   "license": "MIT",
   "repository": {
@@ -22,7 +22,7 @@
   },
   "sideEffects": false,
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "scripts": {
     "test": "xo && ava && tsd"
@@ -57,10 +57,10 @@
     "16m"
   ],
   "devDependencies": {
-    "@types/node": "^22.10.2",
-    "ava": "^6.2.0",
-    "tsd": "^0.31.2",
-    "xo": "^0.60.0"
+    "@types/node": "^26.1.1",
+    "ava": "^8.0.1",
+    "tsd": "^0.33.0",
+    "xo": "^4.0.0"
   },
   "ava": {
     "serial": true,
@@ -69,11 +69,11 @@
   "types": "./index.d.ts",
   "main": "./dist-cjser/index.cjs",
   "cjser": {
-    "sourceVersion": "10.2.2",
+    "sourceVersion": "11.0.0",
     "cjserVersion": 2,
     "original": {
       "name": "supports-color",
-      "version": "10.2.2",
+      "version": "11.0.0",
       "exports": {
         "types": "./index.d.ts",
         "node": "./index.js",

package/readme.md

@@ -58,13 +58,15 @@ The options object supports a single boolean property `sniffFlags`. By default i
 
 It obeys the `--color` and `--no-color` CLI flags.
 
-For situations where using `--color` is not possible, use the environment variable `FORCE_COLOR=1` (level 1), `FORCE_COLOR=2` (level 2), or `FORCE_COLOR=3` (level 3) to forcefully enable color, or `FORCE_COLOR=0` to forcefully disable. The use of `FORCE_COLOR` overrides all other color support checks.
+For situations where using `--color` is not possible, use the environment variable `FORCE_COLOR=1` (level 1), `FORCE_COLOR=2` (level 2), or `FORCE_COLOR=3` (level 3) to forcefully enable color, or `FORCE_COLOR=0` to forcefully disable. A numeric `FORCE_COLOR` overrides the detected color support and sets the level directly, meaning the terminal cannot raise it to a higher level. Use `FORCE_COLOR=true` to instead only enable color and let the level be detected.
 
-Explicit 256/Truecolor mode can be enabled using the `--color=256` and `--color=16m` flags, respectively.
+Explicit 256/Truecolor mode can be enabled using the `--color=256` and `--color=16m` flags, respectively. These take precedence over a non-zero numeric `FORCE_COLOR`.
 
 ## Related
 
 - [supports-color-cli](https://github.com/chalk/supports-color-cli) - CLI for this module
+- [supports-hyperlinks](https://github.com/chalk/supports-hyperlinks) - Detect whether a terminal supports hyperlinks
+- [supports-terminal-graphics](https://github.com/sindresorhus/supports-terminal-graphics) - Detect which terminal graphics protocols are supported
 - [chalk](https://github.com/chalk/chalk) - Terminal string styling done right
 - [is-unicode-supported](https://github.com/sindresorhus/is-unicode-supported) - Detect whether the terminal supports Unicode
 - [is-interactive](https://github.com/sindresorhus/is-interactive) - Check if stdout or stderr is interactive