@stryke/env 0.20.85 → 0.20.86

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 # Changelog for Stryke - Env
 
+## [0.20.86](https://github.com/storm-software/stryke/releases/tag/env%400.20.86) (04/26/2026)
+
+### Miscellaneous
+
+- **monorepo:** Update Nx packages to v22.7.0 ([08918e3c](https://github.com/storm-software/stryke/commit/08918e3c))
+
+### Updated Dependencies
+
+- Updated **string-format** to **v0.17.12**
+- Updated **convert** to **v0.7.2**
+- Updated **path** to **v0.28.1**
+- Updated **fs** to **v0.33.69**
+
 ## [0.20.85](https://github.com/storm-software/stryke/releases/tag/env%400.20.85) (04/26/2026)
 
 ### Updated Dependencies

package/dist/environment-checks.cjs

@@ -69,6 +69,18 @@ function isDevelopmentMode(mode$1) {
 }
 /** Detect if `NODE_ENV` environment variable is `dev` or `development` */
 const isDevelopment = isDevelopmentMode(mode) || isDebug;
+/**
+* Convert a mode string to a standardized mode value of "production", "development", or "test".
+*
+* @param mode - The mode string to convert.
+* @returns The standardized mode value.
+*/
+function toMode(mode$1) {
+	if (isProductionMode(mode$1)) return "production";
+	else if (isTestMode(mode$1)) return "test";
+	else if (isDevelopmentMode(mode$1)) return "development";
+	return "production";
+}
 /** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */
 const isMinimal = Boolean(process.env.MINIMAL) || require_ci_checks.isCI() || isTest || !hasTTY;
 /** Detect if process.platform is Windows */
@@ -153,4 +165,5 @@ exports.isTestMode = isTestMode;
 exports.isWindows = isWindows;
 exports.nodeMajorVersion = nodeMajorVersion;
 exports.nodeVersion = nodeVersion;
-exports.platform = platform;
+exports.platform = platform;
+exports.toMode = toMode;

package/dist/environment-checks.d.cts

@@ -34,6 +34,13 @@ declare const isTest: boolean;
 declare function isDevelopmentMode(mode: string): boolean;
 /** Detect if `NODE_ENV` environment variable is `dev` or `development` */
 declare const isDevelopment: boolean;
+/**
+ * Convert a mode string to a standardized mode value of "production", "development", or "test".
+ *
+ * @param mode - The mode string to convert.
+ * @returns The standardized mode value.
+ */
+declare function toMode(mode: string): "production" | "development" | "test";
 /** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */
 declare const isMinimal: boolean;
 /** Detect if process.platform is Windows */
@@ -55,5 +62,5 @@ declare function isHyperlinkSupported(stream?: NodeJS.WriteStream): boolean;
 declare const nodeVersion: string | null;
 declare const nodeMajorVersion: number | null;
 //#endregion
-export { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform };
+export { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform, toMode };
 //# sourceMappingURL=environment-checks.d.cts.map

package/dist/environment-checks.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-checks.d.cts","names":[],"sources":["../src/environment-checks.ts"],"sourcesContent":[],"mappings":";;AAqBa,cAAA,QAAQ,EAAA,MAAA,CAAA,QAA0B;AAG/C;AAGa,cAHA,MAGoC,EAAA,OAAA;AAUjD;AAUgB,cApBH,OAoBmB,EAAA,OAAA;AAchC;AAQgB,cAhCH,SAgCa,EAAA,OAAA;AAe1B;AASA;AAOA;AAGA;AAIA;AAGA;AAGa,iBAlEG,gBAAA,CAkEgC,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAGhD;AAkCgB,cAzFH,YAyFuB,EAAA,OAC1B;AA8EV;AAGA;;;;;iBAnKgB,UAAA;;cAeH;;;;;;;iBASG,iBAAA;;cAOH;;cAGA;;cAIA;;cAGA;;cAGA;;cAGA;;;;;;;iBAkCG,oBAAA,UACN,MAAA,CAAO;;cA8EJ;cAGA"}
+{"version":3,"file":"environment-checks.d.cts","names":[],"sources":["../src/environment-checks.ts"],"sourcesContent":[],"mappings":";;AAqBa,cAAA,QAAQ,EAAA,MAAA,CAAA,QAA0B;AAG/C;AAGa,cAHA,MAGoC,EAAA,OAAA;AAUjD;AAUgB,cApBH,OAoBmB,EAAA,OAAA;AAchC;AAQgB,cAhCH,SAgCa,EAAA,OAAA;AAe1B;AASA;AAOA;AAQA;AAaA;AAIA;AAGa,iBAjFG,gBAAA,CAiF+B,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAG/C;AAGa,cAzEA,YA6EF,EAAA,OAAA;AA8BX;AA+EA;AAGA;;;;iBArLgB,UAAA;;cAeH;;;;;;;iBASG,iBAAA;;cAOH;;;;;;;iBAQG,MAAA;;cAaH;;cAIA;;cAGA;;cAGA;;cAGA;;;;;;;iBAkCG,oBAAA,UACN,MAAA,CAAO;;cA8EJ;cAGA"}

package/dist/environment-checks.d.mts

@@ -34,6 +34,13 @@ declare const isTest: boolean;
 declare function isDevelopmentMode(mode: string): boolean;
 /** Detect if `NODE_ENV` environment variable is `dev` or `development` */
 declare const isDevelopment: boolean;
+/**
+ * Convert a mode string to a standardized mode value of "production", "development", or "test".
+ *
+ * @param mode - The mode string to convert.
+ * @returns The standardized mode value.
+ */
+declare function toMode(mode: string): "production" | "development" | "test";
 /** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */
 declare const isMinimal: boolean;
 /** Detect if process.platform is Windows */
@@ -55,5 +62,5 @@ declare function isHyperlinkSupported(stream?: NodeJS.WriteStream): boolean;
 declare const nodeVersion: string | null;
 declare const nodeMajorVersion: number | null;
 //#endregion
-export { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform };
+export { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform, toMode };
 //# sourceMappingURL=environment-checks.d.mts.map

package/dist/environment-checks.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-checks.d.mts","names":[],"sources":["../src/environment-checks.ts"],"sourcesContent":[],"mappings":";;AAqBa,cAAA,QAAQ,EAAA,MAAA,CAAA,QAA0B;AAG/C;AAGa,cAHA,MAGoC,EAAA,OAAA;AAUjD;AAUgB,cApBH,OAoBmB,EAAA,OAAA;AAchC;AAQgB,cAhCH,SAgCa,EAAA,OAAA;AAe1B;AASA;AAOA;AAGA;AAIA;AAGA;AAGa,iBAlEG,gBAAA,CAkEgC,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAGhD;AAkCgB,cAzFH,YAyFuB,EAAA,OAC1B;AA8EV;AAGA;;;;;iBAnKgB,UAAA;;cAeH;;;;;;;iBASG,iBAAA;;cAOH;;cAGA;;cAIA;;cAGA;;cAGA;;cAGA;;;;;;;iBAkCG,oBAAA,UACN,MAAA,CAAO;;cA8EJ;cAGA"}
+{"version":3,"file":"environment-checks.d.mts","names":[],"sources":["../src/environment-checks.ts"],"sourcesContent":[],"mappings":";;AAqBa,cAAA,QAAQ,EAAA,MAAA,CAAA,QAA0B;AAG/C;AAGa,cAHA,MAGoC,EAAA,OAAA;AAUjD;AAUgB,cApBH,OAoBmB,EAAA,OAAA;AAchC;AAQgB,cAhCH,SAgCa,EAAA,OAAA;AAe1B;AASA;AAOA;AAQA;AAaA;AAIA;AAGa,iBAjFG,gBAAA,CAiF+B,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAG/C;AAGa,cAzEA,YA6EF,EAAA,OAAA;AA8BX;AA+EA;AAGA;;;;iBArLgB,UAAA;;cAeH;;;;;;;iBASG,iBAAA;;cAOH;;;;;;;iBAQG,MAAA;;cAaH;;cAIA;;cAGA;;cAGA;;cAGA;;;;;;;iBAkCG,oBAAA,UACN,MAAA,CAAO;;cA8EJ;cAGA"}

package/dist/environment-checks.mjs

@@ -69,6 +69,18 @@ function isDevelopmentMode(mode$1) {
 }
 /** Detect if `NODE_ENV` environment variable is `dev` or `development` */
 const isDevelopment = isDevelopmentMode(mode) || isDebug;
+/**
+* Convert a mode string to a standardized mode value of "production", "development", or "test".
+*
+* @param mode - The mode string to convert.
+* @returns The standardized mode value.
+*/
+function toMode(mode$1) {
+	if (isProductionMode(mode$1)) return "production";
+	else if (isTestMode(mode$1)) return "test";
+	else if (isDevelopmentMode(mode$1)) return "development";
+	return "production";
+}
 /** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */
 const isMinimal = Boolean(process.env.MINIMAL) || isCI() || isTest || !hasTTY;
 /** Detect if process.platform is Windows */
@@ -136,5 +148,5 @@ const nodeVersion = (process?.versions?.node || "").replace(/^v/, "") || null;
 const nodeMajorVersion = Number(nodeVersion?.split(".")[0]) || null;
 
 //#endregion
-export { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform };
+export { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform, toMode };
 //# sourceMappingURL=environment-checks.mjs.map

package/dist/environment-checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"environment-checks.mjs","names":["mode"],"sources":["../src/environment-checks.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isCI } from \"./ci-checks\";\n\n/** Value of process.platform */\nexport const platform = process?.platform || \"\";\n\n/** Detect if stdout.TTY is available */\nexport const hasTTY = Boolean(process?.stdout && process?.stdout.isTTY);\n\n/** Detect if `DEBUG` environment variable is set */\nexport const isDebug = Boolean(process.env.DEBUG);\n\n/** Detect the `NODE_ENV` environment variable */\nconst mode =\n  process.env.STORM_MODE ||\n  process.env.NEXT_PUBLIC_VERCEL_ENV ||\n  process.env.NODE_ENV ||\n  \"production\";\n\n/** Detect if the application is running in a staging environment */\nexport const isStaging = [\"stg\", \"stage\", \"staging\"].includes(\n  mode?.toLowerCase()\n);\n\n/**\n * Check if the current environment is production.\n *\n * @param mode - The mode string to check.\n * @returns Whether the environment is production\n */\nexport function isProductionMode(mode: string) {\n  return [\n    \"prd\",\n    \"prod\",\n    \"production\",\n\n    \"preprod\",\n\n    \"preproduction\",\n    \"uat\"\n  ].includes(mode?.toLowerCase()?.replace(/[\\s\\-_]/g, \"\"));\n}\n\n/** Detect if `NODE_ENV` environment variable is `production` */\nexport const isProduction = isProductionMode(mode);\n\n/**\n * Check if the current environment is test.\n *\n * @param mode - The mode string to check.\n * @returns Whether the environment is test\n */\nexport function isTestMode(mode: string) {\n  return [\n    \"tst\",\n    \"test\",\n    \"testing\",\n    \"stg\",\n    \"stage\",\n    \"staging\",\n    \"qa\",\n\n    \"qualityassurance\"\n  ].includes(mode?.toLowerCase()?.replace(/[\\s\\-_]/g, \"\"));\n}\n\n/** Detect if `NODE_ENV` environment variable is `test` */\nexport const isTest =\n  isTestMode(mode) || isStaging || Boolean(process.env.TEST);\n\n/**\n * Check if the current environment is development.\n *\n * @param mode - The mode string to check.\n * @returns Whether the environment is development\n */\nexport function isDevelopmentMode(mode: string) {\n  return [\"dev\", \"development\", \"int\", \"integration\"].includes(\n    mode?.toLowerCase()?.replace(/[\\s\\-_]/g, \"\")\n  );\n}\n\n/** Detect if `NODE_ENV` environment variable is `dev` or `development` */\nexport const isDevelopment = isDevelopmentMode(mode) || isDebug;\n\n/** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */\nexport const isMinimal =\n  Boolean(process.env.MINIMAL) || isCI() || isTest || !hasTTY;\n\n/** Detect if process.platform is Windows */\nexport const isWindows = /^win/i.test(platform);\n\n/** Detect if process.platform is Linux */\nexport const isLinux = /^linux/i.test(platform);\n\n/** Detect if process.platform is macOS (darwin kernel) */\nexport const isMacOS = /^darwin/i.test(platform);\n\n/** Color Support */\nexport const isColorSupported =\n  !process.env.NO_COLOR &&\n  (Boolean(process.env.FORCE_COLOR) ||\n    ((hasTTY || isWindows) && process.env.TERM !== \"dumb\") ||\n    isCI());\n\nfunction parseVersion(versionString = \"\") {\n  if (/^\\d{3,4}$/.test(versionString)) {\n    const match = /(\\d{1,2})(\\d{2})/.exec(versionString) ?? [];\n\n    return {\n      major: 0,\n      minor: Number.parseInt(match[1]!, 10),\n      patch: Number.parseInt(match[2]!, 10)\n    };\n  }\n\n  const versions = (versionString ?? \"\")\n    .split(\".\")\n    .map(n => Number.parseInt(n, 10));\n\n  return {\n    major: versions[0],\n    minor: versions[1],\n    patch: versions[2]\n  };\n}\n\n/**\n * Check if the current environment supports hyperlinks in the terminal.\n *\n * @param stream - The stream to check for TTY support (default: process.stdout)\n * @returns Whether hyperlinks are supported\n */\nexport function isHyperlinkSupported(\n  stream: NodeJS.WriteStream = process.stdout\n): boolean {\n  if (process.env.FORCE_HYPERLINK) {\n    return !(\n      process.env.FORCE_HYPERLINK.length > 0 &&\n      Number.parseInt(process.env.FORCE_HYPERLINK, 10) === 0\n    );\n  }\n\n  // Netlify does not run a TTY, it does not need `supportsColor` check\n  if (process.env.NETLIFY) {\n    return true;\n  } else if (!isColorSupported) {\n    return false;\n  } else if (stream && !stream.isTTY) {\n    return false;\n  } else if (\"WT_SESSION\" in process.env) {\n    return true;\n  } else if (process.platform === \"win32\") {\n    return false;\n  } else if (isCI()) {\n    return false;\n  } else if (process.env.TEAMCITY_VERSION) {\n    return false;\n  } else if (process.env.TERM_PROGRAM) {\n    const version = parseVersion(process.env.TERM_PROGRAM_VERSION);\n\n    switch (process.env.TERM_PROGRAM) {\n      case \"iTerm.app\": {\n        if (version.major === 3) {\n          return version.minor !== undefined && version.minor >= 1;\n        }\n\n        return version.major !== undefined && version.major > 3;\n      }\n      case \"WezTerm\": {\n        return version.major !== undefined && version.major >= 20_200_620;\n      }\n      case \"vscode\": {\n        // Cursor forked VS Code and supports hyperlinks in 0.x.x\n        if (process.env.CURSOR_TRACE_ID) {\n          return true;\n        }\n\n        return (\n          version.minor !== undefined &&\n          version.major !== undefined &&\n          (version.major > 1 || (version.major === 1 && version.minor >= 72))\n        );\n      }\n      case \"ghostty\": {\n        return true;\n      }\n    }\n  }\n\n  if (process.env.VTE_VERSION) {\n    // 0.50.0 was supposed to support hyperlinks, but throws a segfault\n    if (process.env.VTE_VERSION === \"0.50.0\") {\n      return false;\n    }\n\n    const version = parseVersion(process.env.VTE_VERSION);\n\n    return (\n      (version.major !== undefined && version.major > 0) ||\n      (version.minor !== undefined && version.minor >= 50)\n    );\n  }\n\n  if (process.env.TERM === \"alacritty\") {\n    return true;\n  }\n\n  return false;\n}\n\n/** Node.js versions */\nexport const nodeVersion =\n  (process?.versions?.node || \"\").replace(/^v/, \"\") || null;\n\nexport const nodeMajorVersion = Number(nodeVersion?.split(\".\")[0]) || null;\n"],"mappings":"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"}
+{"version":3,"file":"environment-checks.mjs","names":["mode"],"sources":["../src/environment-checks.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isCI } from \"./ci-checks\";\n\n/** Value of process.platform */\nexport const platform = process?.platform || \"\";\n\n/** Detect if stdout.TTY is available */\nexport const hasTTY = Boolean(process?.stdout && process?.stdout.isTTY);\n\n/** Detect if `DEBUG` environment variable is set */\nexport const isDebug = Boolean(process.env.DEBUG);\n\n/** Detect the `NODE_ENV` environment variable */\nconst mode =\n  process.env.STORM_MODE ||\n  process.env.NEXT_PUBLIC_VERCEL_ENV ||\n  process.env.NODE_ENV ||\n  \"production\";\n\n/** Detect if the application is running in a staging environment */\nexport const isStaging = [\"stg\", \"stage\", \"staging\"].includes(\n  mode?.toLowerCase()\n);\n\n/**\n * Check if the current environment is production.\n *\n * @param mode - The mode string to check.\n * @returns Whether the environment is production\n */\nexport function isProductionMode(mode: string) {\n  return [\n    \"prd\",\n    \"prod\",\n    \"production\",\n\n    \"preprod\",\n\n    \"preproduction\",\n    \"uat\"\n  ].includes(mode?.toLowerCase()?.replace(/[\\s\\-_]/g, \"\"));\n}\n\n/** Detect if `NODE_ENV` environment variable is `production` */\nexport const isProduction = isProductionMode(mode);\n\n/**\n * Check if the current environment is test.\n *\n * @param mode - The mode string to check.\n * @returns Whether the environment is test\n */\nexport function isTestMode(mode: string) {\n  return [\n    \"tst\",\n    \"test\",\n    \"testing\",\n    \"stg\",\n    \"stage\",\n    \"staging\",\n    \"qa\",\n\n    \"qualityassurance\"\n  ].includes(mode?.toLowerCase()?.replace(/[\\s\\-_]/g, \"\"));\n}\n\n/** Detect if `NODE_ENV` environment variable is `test` */\nexport const isTest =\n  isTestMode(mode) || isStaging || Boolean(process.env.TEST);\n\n/**\n * Check if the current environment is development.\n *\n * @param mode - The mode string to check.\n * @returns Whether the environment is development\n */\nexport function isDevelopmentMode(mode: string) {\n  return [\"dev\", \"development\", \"int\", \"integration\"].includes(\n    mode?.toLowerCase()?.replace(/[\\s\\-_]/g, \"\")\n  );\n}\n\n/** Detect if `NODE_ENV` environment variable is `dev` or `development` */\nexport const isDevelopment = isDevelopmentMode(mode) || isDebug;\n\n/**\n * Convert a mode string to a standardized mode value of \"production\", \"development\", or \"test\".\n *\n * @param mode - The mode string to convert.\n * @returns The standardized mode value.\n */\nexport function toMode(mode: string): \"production\" | \"development\" | \"test\" {\n  if (isProductionMode(mode)) {\n    return \"production\";\n  } else if (isTestMode(mode)) {\n    return \"test\";\n  } else if (isDevelopmentMode(mode)) {\n    return \"development\";\n  }\n\n  return \"production\";\n}\n\n/** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */\nexport const isMinimal =\n  Boolean(process.env.MINIMAL) || isCI() || isTest || !hasTTY;\n\n/** Detect if process.platform is Windows */\nexport const isWindows = /^win/i.test(platform);\n\n/** Detect if process.platform is Linux */\nexport const isLinux = /^linux/i.test(platform);\n\n/** Detect if process.platform is macOS (darwin kernel) */\nexport const isMacOS = /^darwin/i.test(platform);\n\n/** Color Support */\nexport const isColorSupported =\n  !process.env.NO_COLOR &&\n  (Boolean(process.env.FORCE_COLOR) ||\n    ((hasTTY || isWindows) && process.env.TERM !== \"dumb\") ||\n    isCI());\n\nfunction parseVersion(versionString = \"\") {\n  if (/^\\d{3,4}$/.test(versionString)) {\n    const match = /(\\d{1,2})(\\d{2})/.exec(versionString) ?? [];\n\n    return {\n      major: 0,\n      minor: Number.parseInt(match[1]!, 10),\n      patch: Number.parseInt(match[2]!, 10)\n    };\n  }\n\n  const versions = (versionString ?? \"\")\n    .split(\".\")\n    .map(n => Number.parseInt(n, 10));\n\n  return {\n    major: versions[0],\n    minor: versions[1],\n    patch: versions[2]\n  };\n}\n\n/**\n * Check if the current environment supports hyperlinks in the terminal.\n *\n * @param stream - The stream to check for TTY support (default: process.stdout)\n * @returns Whether hyperlinks are supported\n */\nexport function isHyperlinkSupported(\n  stream: NodeJS.WriteStream = process.stdout\n): boolean {\n  if (process.env.FORCE_HYPERLINK) {\n    return !(\n      process.env.FORCE_HYPERLINK.length > 0 &&\n      Number.parseInt(process.env.FORCE_HYPERLINK, 10) === 0\n    );\n  }\n\n  // Netlify does not run a TTY, it does not need `supportsColor` check\n  if (process.env.NETLIFY) {\n    return true;\n  } else if (!isColorSupported) {\n    return false;\n  } else if (stream && !stream.isTTY) {\n    return false;\n  } else if (\"WT_SESSION\" in process.env) {\n    return true;\n  } else if (process.platform === \"win32\") {\n    return false;\n  } else if (isCI()) {\n    return false;\n  } else if (process.env.TEAMCITY_VERSION) {\n    return false;\n  } else if (process.env.TERM_PROGRAM) {\n    const version = parseVersion(process.env.TERM_PROGRAM_VERSION);\n\n    switch (process.env.TERM_PROGRAM) {\n      case \"iTerm.app\": {\n        if (version.major === 3) {\n          return version.minor !== undefined && version.minor >= 1;\n        }\n\n        return version.major !== undefined && version.major > 3;\n      }\n      case \"WezTerm\": {\n        return version.major !== undefined && version.major >= 20_200_620;\n      }\n      case \"vscode\": {\n        // Cursor forked VS Code and supports hyperlinks in 0.x.x\n        if (process.env.CURSOR_TRACE_ID) {\n          return true;\n        }\n\n        return (\n          version.minor !== undefined &&\n          version.major !== undefined &&\n          (version.major > 1 || (version.major === 1 && version.minor >= 72))\n        );\n      }\n      case \"ghostty\": {\n        return true;\n      }\n    }\n  }\n\n  if (process.env.VTE_VERSION) {\n    // 0.50.0 was supposed to support hyperlinks, but throws a segfault\n    if (process.env.VTE_VERSION === \"0.50.0\") {\n      return false;\n    }\n\n    const version = parseVersion(process.env.VTE_VERSION);\n\n    return (\n      (version.major !== undefined && version.major > 0) ||\n      (version.minor !== undefined && version.minor >= 50)\n    );\n  }\n\n  if (process.env.TERM === \"alacritty\") {\n    return true;\n  }\n\n  return false;\n}\n\n/** Node.js versions */\nexport const nodeVersion =\n  (process?.versions?.node || \"\").replace(/^v/, \"\") || null;\n\nexport const nodeMajorVersion = Number(nodeVersion?.split(\".\")[0]) || null;\n"],"mappings":"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"}

package/dist/index.cjs

@@ -45,4 +45,5 @@ exports.platform = require_environment_checks.platform;
 exports.provider = require_providers.provider;
 exports.providerInfo = require_providers.providerInfo;
 exports.runtime = require_runtime_checks.runtime;
-exports.runtimeInfo = require_runtime_checks.runtimeInfo;
+exports.runtimeInfo = require_runtime_checks.runtimeInfo;
+exports.toMode = require_environment_checks.toMode;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { isCI, isInteractive } from "./ci-checks.cjs";
-import { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform } from "./environment-checks.cjs";
+import { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform, toMode } from "./environment-checks.cjs";
 import { EnvPaths, GetEnvPathsOptions, getEnvPaths } from "./get-env-paths.cjs";
 import { DotenvParseOutput, ENV_PREFIXES } from "./types.cjs";
 import { getEnvFilesForMode, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv } from "./load-env.cjs";
 import { ProviderInfo, ProviderName, provider, providerInfo } from "./providers.cjs";
 import { RuntimeInfo, RuntimeName, isBun, isDeno, isEdgeLight, isFastly, isNetlify, isNode, isRuntimeClient, isRuntimeServer, isWorkerd, runtime, runtimeInfo } from "./runtime-checks.cjs";
-export { DotenvParseOutput, ENV_PREFIXES, EnvPaths, GetEnvPathsOptions, ProviderInfo, ProviderName, RuntimeInfo, RuntimeName, getEnvFilesForMode, getEnvPaths, hasTTY, isBun, isCI, isColorSupported, isDebug, isDeno, isDevelopment, isDevelopmentMode, isEdgeLight, isFastly, isHyperlinkSupported, isInteractive, isLinux, isMacOS, isMinimal, isNetlify, isNode, isProduction, isProductionMode, isRuntimeClient, isRuntimeServer, isStaging, isTest, isTestMode, isWindows, isWorkerd, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv, nodeMajorVersion, nodeVersion, platform, provider, providerInfo, runtime, runtimeInfo };
+export { DotenvParseOutput, ENV_PREFIXES, EnvPaths, GetEnvPathsOptions, ProviderInfo, ProviderName, RuntimeInfo, RuntimeName, getEnvFilesForMode, getEnvPaths, hasTTY, isBun, isCI, isColorSupported, isDebug, isDeno, isDevelopment, isDevelopmentMode, isEdgeLight, isFastly, isHyperlinkSupported, isInteractive, isLinux, isMacOS, isMinimal, isNetlify, isNode, isProduction, isProductionMode, isRuntimeClient, isRuntimeServer, isStaging, isTest, isTestMode, isWindows, isWorkerd, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv, nodeMajorVersion, nodeVersion, platform, provider, providerInfo, runtime, runtimeInfo, toMode };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { isCI, isInteractive } from "./ci-checks.mjs";
-import { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform } from "./environment-checks.mjs";
+import { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform, toMode } from "./environment-checks.mjs";
 import { EnvPaths, GetEnvPathsOptions, getEnvPaths } from "./get-env-paths.mjs";
 import { DotenvParseOutput, ENV_PREFIXES } from "./types.mjs";
 import { getEnvFilesForMode, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv } from "./load-env.mjs";
 import { ProviderInfo, ProviderName, provider, providerInfo } from "./providers.mjs";
 import { RuntimeInfo, RuntimeName, isBun, isDeno, isEdgeLight, isFastly, isNetlify, isNode, isRuntimeClient, isRuntimeServer, isWorkerd, runtime, runtimeInfo } from "./runtime-checks.mjs";
-export { DotenvParseOutput, ENV_PREFIXES, EnvPaths, GetEnvPathsOptions, ProviderInfo, ProviderName, RuntimeInfo, RuntimeName, getEnvFilesForMode, getEnvPaths, hasTTY, isBun, isCI, isColorSupported, isDebug, isDeno, isDevelopment, isDevelopmentMode, isEdgeLight, isFastly, isHyperlinkSupported, isInteractive, isLinux, isMacOS, isMinimal, isNetlify, isNode, isProduction, isProductionMode, isRuntimeClient, isRuntimeServer, isStaging, isTest, isTestMode, isWindows, isWorkerd, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv, nodeMajorVersion, nodeVersion, platform, provider, providerInfo, runtime, runtimeInfo };
+export { DotenvParseOutput, ENV_PREFIXES, EnvPaths, GetEnvPathsOptions, ProviderInfo, ProviderName, RuntimeInfo, RuntimeName, getEnvFilesForMode, getEnvPaths, hasTTY, isBun, isCI, isColorSupported, isDebug, isDeno, isDevelopment, isDevelopmentMode, isEdgeLight, isFastly, isHyperlinkSupported, isInteractive, isLinux, isMacOS, isMinimal, isNetlify, isNode, isProduction, isProductionMode, isRuntimeClient, isRuntimeServer, isStaging, isTest, isTestMode, isWindows, isWorkerd, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv, nodeMajorVersion, nodeVersion, platform, provider, providerInfo, runtime, runtimeInfo, toMode };

package/dist/index.mjs

@@ -1,9 +1,9 @@
 import { isCI, isInteractive } from "./ci-checks.mjs";
-import { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform } from "./environment-checks.mjs";
+import { hasTTY, isColorSupported, isDebug, isDevelopment, isDevelopmentMode, isHyperlinkSupported, isLinux, isMacOS, isMinimal, isProduction, isProductionMode, isStaging, isTest, isTestMode, isWindows, nodeMajorVersion, nodeVersion, platform, toMode } from "./environment-checks.mjs";
 import { getEnvPaths } from "./get-env-paths.mjs";
 import { ENV_PREFIXES } from "./types.mjs";
 import { getEnvFilesForMode, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv } from "./load-env.mjs";
 import { provider, providerInfo } from "./providers.mjs";
 import { isBun, isDeno, isEdgeLight, isFastly, isNetlify, isNode, isRuntimeClient, isRuntimeServer, isWorkerd, runtime, runtimeInfo } from "./runtime-checks.mjs";
 
-export { ENV_PREFIXES, getEnvFilesForMode, getEnvPaths, hasTTY, isBun, isCI, isColorSupported, isDebug, isDeno, isDevelopment, isDevelopmentMode, isEdgeLight, isFastly, isHyperlinkSupported, isInteractive, isLinux, isMacOS, isMinimal, isNetlify, isNode, isProduction, isProductionMode, isRuntimeClient, isRuntimeServer, isStaging, isTest, isTestMode, isWindows, isWorkerd, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv, nodeMajorVersion, nodeVersion, platform, provider, providerInfo, runtime, runtimeInfo };
+export { ENV_PREFIXES, getEnvFilesForMode, getEnvPaths, hasTTY, isBun, isCI, isColorSupported, isDebug, isDeno, isDevelopment, isDevelopmentMode, isEdgeLight, isFastly, isHyperlinkSupported, isInteractive, isLinux, isMacOS, isMinimal, isNetlify, isNode, isProduction, isProductionMode, isRuntimeClient, isRuntimeServer, isStaging, isTest, isTestMode, isWindows, isWorkerd, loadClientEnv, loadEnv, loadEnvFile, loadServerEnv, nodeMajorVersion, nodeVersion, platform, provider, providerInfo, runtime, runtimeInfo, toMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/env",
-  "version": "0.20.85",
+  "version": "0.20.86",
   "private": false,
   "description": "A package containing utility functions to handle environment specific processes",
   "repository": {
@@ -43,13 +43,13 @@
   "types": "./dist/index.d.cts",
   "dependencies": {
     "@dotenvx/dotenvx": "1.35.0",
-    "@stryke/convert": "^0.7.1",
-    "@stryke/fs": "^0.33.68",
-    "@stryke/path": "^0.28.0",
-    "@stryke/string-format": "^0.17.11",
+    "@stryke/convert": "^0.7.2",
+    "@stryke/fs": "^0.33.69",
+    "@stryke/path": "^0.28.1",
+    "@stryke/string-format": "^0.17.12",
     "defu": "^6.1.7"
   },
   "devDependencies": { "@types/node": "^24.12.2", "tsdown": "^0.17.2" },
   "publishConfig": { "access": "public" },
-  "gitHead": "b5ad57036344bd65a3e0945111b387e23a82c8ba"
+  "gitHead": "d934face11e0511f16942786bd609d4cec659ec6"
 }