supports-hyperlinks 3.2.0 → 4.1.0

package/browser.js

@@ -1,8 +1,10 @@
-'use strict';
-module.exports = {
-	stdin: false,
-	stderr: false,
-	supportsHyperlink: function () { // eslint-disable-line object-shorthand
-		return false;
-	}
+export function createSupportsHyperlinks() {
+	return false;
+}
+
+const supportsHyperlinks = {
+	stdout: createSupportsHyperlinks(),
+	stderr: createSupportsHyperlinks(),
 };
+
+export default supportsHyperlinks;

package/index.d.ts

@@ -1,6 +1,25 @@
-export function supportsHyperlink(stream: {
-    isTTY?: boolean | undefined;
-}): boolean;
+/**
+Creates a supports hyperlinks check for a given stream.
 
-export declare const stdout: boolean;
-export declare const stderr: boolean;
+@param stream - Optional stream to check for hyperlink support.
+@returns boolean indicating whether hyperlinks are supported.
+*/
+export function createSupportsHyperlinks(stream?: {isTTY?: boolean}): boolean;
+
+/**
+Object containing hyperlink support status for stdout and stderr.
+*/
+type SupportsHyperlinks = {
+	/**
+	Whether stdout supports hyperlinks.
+	*/
+	stdout: boolean;
+	/**
+	Whether stderr supports hyperlinks.
+	*/
+	stderr: boolean;
+};
+
+declare const supportsHyperlinks: SupportsHyperlinks;
+
+export default supportsHyperlinks;

package/index.js

@@ -1,38 +1,31 @@
-'use strict';
-const supportsColor = require('supports-color');
-const hasFlag = require('has-flag');
-
-/**
-@param {string} versionString
-@returns {{ major: number, minor: number, patch: number }}
-*/
-function parseVersion(versionString) {
+import process from 'node:process';
+import {createSupportsColor} from 'supports-color';
+import hasFlag from 'has-flag';
+
+function parseVersion(versionString = '') {
 	if (/^\d{3,4}$/.test(versionString)) {
 		// Env var doesn't always use dots. example: 4601 => 46.1.0
-		const m = /(\d{1,2})(\d{2})/.exec(versionString) || [];
+		const match = /(\d{1,2})(\d{2})/.exec(versionString) ?? [];
 		return {
 			major: 0,
-			minor: parseInt(m[1], 10),
-			patch: parseInt(m[2], 10)
+			minor: Number.parseInt(match[1], 10),
+			patch: Number.parseInt(match[2], 10),
 		};
 	}
 
-	const versions = (versionString || '').split('.').map(n => parseInt(n, 10));
+	const versions = (versionString ?? '').split('.').map(n => Number.parseInt(n, 10));
 	return {
 		major: versions[0],
 		minor: versions[1],
-		patch: versions[2]
+		patch: versions[2],
 	};
 }
 
-/**
-@param {{ isTTY?: boolean | undefined }} stream
-@returns {boolean}
-*/
 // eslint-disable-next-line complexity
-function supportsHyperlink(stream) {
+export function createSupportsHyperlinks(stream) {
 	const {
 		CI,
+		CURSOR_TRACE_ID,
 		FORCE_HYPERLINK,
 		NETLIFY,
 		TEAMCITY_VERSION,
@@ -43,7 +36,7 @@ function supportsHyperlink(stream) {
 	} = process.env;
 
 	if (FORCE_HYPERLINK) {
-		return !(FORCE_HYPERLINK.length > 0 && parseInt(FORCE_HYPERLINK, 10) === 0);
+		return !(FORCE_HYPERLINK.length > 0 && Number.parseInt(FORCE_HYPERLINK, 10) === 0);
 	}
 
 	if (hasFlag('no-hyperlink') || hasFlag('no-hyperlinks') || hasFlag('hyperlink=false') || hasFlag('hyperlink=never')) {
@@ -60,7 +53,7 @@ function supportsHyperlink(stream) {
 	}
 
 	// If they specify no colors, they probably don't want hyperlinks.
-	if (!supportsColor.supportsColor(stream)) {
+	if (!createSupportsColor(stream)) {
 		return false;
 	}
 
@@ -86,22 +79,34 @@ function supportsHyperlink(stream) {
 	}
 
 	if (TERM_PROGRAM) {
-		const version = parseVersion(TERM_PROGRAM_VERSION || '');
+		const version = parseVersion(TERM_PROGRAM_VERSION);
 
 		switch (TERM_PROGRAM) {
-			case 'iTerm.app':
+			case 'iTerm.app': {
 				if (version.major === 3) {
 					return version.minor >= 1;
 				}
 
 				return version.major > 3;
-			case 'WezTerm':
-				return version.major >= 20200620;
-			case 'vscode':
+			}
+
+			case 'WezTerm': {
+				return version.major >= 20_200_620;
+			}
+
+			case 'vscode': {
+				// Cursor forked VS Code and supports hyperlinks in 0.x.x
+				if (CURSOR_TRACE_ID) {
+					return true;
+				}
+
 				// eslint-disable-next-line no-mixed-operators
 				return version.major > 1 || version.major === 1 && version.minor >= 72;
-			case 'ghostty':
+			}
+
+			case 'ghostty': {
 				return true;
+			}
 			// No default
 		}
 	}
@@ -117,17 +122,19 @@ function supportsHyperlink(stream) {
 	}
 
 	switch (TERM) {
-		case 'alacritty':
+		case 'alacritty': {
 			// Support added in v0.11 (2022-10-13)
 			return true;
+		}
 		// No default
 	}
 
 	return false;
 }
 
-module.exports = {
-	supportsHyperlink,
-	stdout: supportsHyperlink(process.stdout),
-	stderr: supportsHyperlink(process.stderr)
+const supportsHyperlinks = {
+	stdout: createSupportsHyperlinks(process.stdout),
+	stderr: createSupportsHyperlinks(process.stderr),
 };
+
+export default supportsHyperlinks;

package/package.json

@@ -1,21 +1,21 @@
 {
 	"name": "supports-hyperlinks",
-	"version": "3.2.0",
+	"version": "4.1.0",
 	"description": "Detect whether a terminal supports hyperlinks",
 	"license": "MIT",
 	"repository": "chalk/supports-hyperlinks",
 	"funding": "https://github.com/chalk/supports-hyperlinks?sponsor=1",
+	"type": "module",
 	"exports": {
 		"types": "./index.d.ts",
 		"default": "./index.js"
 	},
 	"sideEffects": false,
 	"engines": {
-		"node": ">=14.18"
+		"node": ">=20"
 	},
 	"scripts": {
-		"//test": "xo && ava && tsc",
-		"test": "ava"
+		"test": "xo && ava && tsc index.d.ts"
 	},
 	"files": [
 		"index.js",
@@ -35,15 +35,13 @@
 		"console"
 	],
 	"dependencies": {
-		"has-flag": "^4.0.0",
-		"supports-color": "^7.0.0"
+		"has-flag": "^5.0.1",
+		"supports-color": "^10.0.0"
 	},
 	"devDependencies": {
-		"@tsconfig/node14": "^1.0.3",
-		"@types/supports-color": "^8.1.1",
-		"ava": "^3.2.0",
-		"codecov": "^3.5.0",
-		"typescript": "^4.9.5",
-		"xo": "^0.53.0"
+		"ava": "^6.2.0",
+		"codecov": "^3.8.3",
+		"typescript": "^5.8.2",
+		"xo": "^0.60.0"
 	}
 }