feat: drop support for Deno 1.x and add support for Deno 2.0+, backported from 3.18.0-beta.0

Author: webdiscus

.github/workflows/test.yml

@@ -122,3 +122,25 @@ jobs:
         run: npx vitest
         env:
           NODE_OPTIONS: --unhandled-rejections=strict
+
+  deno:
+    name: Test Deno
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        deno-version: [ 2.0.x, 2.1.x, 2.2.x ]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Set up Deno ${{ matrix.deno-version }}
+        uses: denoland/setup-deno@v1
+        with:
+          deno-version: ${{ matrix.deno-version }}
+
+      - name: Run Deno tests
+        run: deno test --config=deno.json --allow-env

CHANGELOG.md

@@ -1,11 +1,17 @@
 # Changelog
 
-
 ## Pre release note: ✨ Ansis v4 - Smaller package, and cleaner API
 
 Ansis v4 drops legacy baggage and unused artifacts.
 This release brings a stable and more compact ANSI library.
 
+## 4.0.0-beta.21 (2025-04-24)
+
+### ⚠️ BREAKING CHANGE
+
+- feat: drop support for Deno 1.x (EOL - 9 Oct 2024) and add support for Deno 2.0+, #37
+  Backported from 3.18.0-beta.0
+
 ## 4.0.0-beta.20 (2025-04-21)
 
 ### ⚠️ BREAKING CHANGE
@@ -74,10 +80,10 @@ This change ensures compatibility with the latest version of Ansis, where `AnsiC
 
 The following legacy method aliases have been removed:
 
-| ❌ Removed Method  | ✅ Use Instead  |
-|-------------------|----------------|
-| `ansi256(code)`   | `fg(code)`     |
-| `bgAnsi256(code)` | `bg(code)`     |
+| ❌ Removed Method  | ✅ Use Instead |
+|-------------------|---------------|
+| `ansi256(code)`   | `fg(code)`    |
+| `bgAnsi256(code)` | `bg(code)`    |
 
 These aliases were originally added for compatibility with Chalk.
 Starting with this release, Ansis focuses on a cleaner and compact API, free from duplicated methods and legacy layers.
@@ -325,6 +331,11 @@ Deprecated.
 
 ---
 
+## 3.18.0-beta.0 (2025-04-22)
+
+- feat: drop support for Deno 1.x (EOL - 9 Oct 2024) and add support for Deno 2.0+, #37
+- test: add Deno tests on GitHub
+
 ## 3.17.0 (2025-03-02)
 
 - feat: add support for `typescript` < `5.6` to fix TS2526 error:

README.md

@@ -45,9 +45,6 @@ Ansis is focused on [small size](#compare-size) and [speed](#benchmark) while pr
 - Reliable [CLI testing](#cli-testing) by forcing specific [color levels](#color-levels): no color, 16, 256 or truecolor
 - [Replacement](#why-ansis) for [`chalk`](#replacing-chalk) [`ansi-colors`](#replacing-ansi-colors) [`colorette`](#replacing-colorette) [`picocolors`](#replacing-picocolors)
 
-<!--  - Chromium-based browsers can display truecolor text in console.
-  - Browsers that do not support ANSI codes will display black/white text in console. -->
-
 ## 🛠️ Usage
 
 ```js

deno.json

@@ -0,0 +1,11 @@
+{
+  "lint": {
+    "files": {
+      "exclude": ["node_modules", "test"]
+    }
+  },
+  "test": {
+    "include": ["test-deno/cases/**/*.test.js"],
+    "exclude": ["node_modules"]
+  }
+}

deno.lock

@@ -1,6 +1,6 @@
 {
   "name": "ansis",
-  "version": "4.0.0-beta.20",
+  "version": "4.0.0-beta.21",
   "description": "A small and fast library for applying ANSI colors in terminal or browser console",
   "keywords": [
     "ansi",
@@ -65,7 +65,11 @@
     "test:esm": "node ./test/package/esm/test.mjs",
     "test:tsc": "vitest run ./test/ts-compiler.test.js",
     "test:levels": "vitest run ./test/color-levels.test.js",
-    "test:stackoverflow": "node ./test/rangeErrorTest.js",
+    "test:range": "node ./test/rangeErrorTest.js",
+    "test:deno": "deno test --allow-env",
+    "test-deno:manual": "deno test ./test-deno/manual/nocolor-deny.test.js",
+    "test-deno:debug": "deno ./test-deno/manual/deno-debug.js",
+    "test-deno:truecolor": "deno test ./test-deno/cases/truecolor.test.js --allow-env",
     "test:coverage": "vitest run --coverage",
     "publish:public": "(npm run build) && npm publish ./dist --access public",
     "publish:beta": "(npm run build) && npm publish ./dist --tag beta"

package.json

@@ -1,6 +1,6 @@
 {
 "name":"ansis",
-"version":"4.0.0-beta.20",
+"version":"4.0.0-beta.21",
 "description":"ANSI color lib",
 "keywords":["ansi","color","cli"],
 "license":"ISC",

package.npm.json

@@ -1,8 +1,11 @@
 import { LEVEL_UNDEFINED, LEVEL_BW, LEVEL_16COLORS, LEVEL_256COLORS, LEVEL_TRUECOLOR } from './color-levels.js';
 import { keys, separator } from './misc.js';
 
+// Contains stringified keys of environment variables.
+let envKeys;
+
 /**
- * Detect color level.
+ * Auto detect color level.
  *
  * Truecolor is supported by:
  * - some CI (e.g. GitHub CI)
@@ -17,9 +20,8 @@ import { keys, separator } from './misc.js';
  * @param {boolean} isWin
  * @return {number}
  */
-let detectColors = (env, isTTY, isWin) => {
+let autoDetectLevel = (env, isTTY, isWin) => {
   let term = env.TERM;
-  let envKeys = separator + keys(env).join(separator);
 
   // Note: the order of checks is important!
 
@@ -112,26 +114,24 @@ export const getLevel = (mockThis) => {
    * @param {RegExp} regex The RegEx to match all possible flags.
    * @return {boolean}
    */
-  let hasFlag = (regex) => argv?.some((value) => regex.test(value));
-
-  let _this = mockThis ?? globalThis;
-  let Deno = _this.Deno;
-  let isDeno = !!Deno;
-  let proc = _this.process || Deno || {};
+  let hasFlag = (regex) => argv.some((value) => regex.test(value));
 
-  // Node -> `argv`, Deno -> `args`
-  let argv = proc.argv ?? proc.args;
+  // Note: In Deno 2.0+, the `process` is available globally
+  let thisRef = mockThis ?? globalThis;
+  let proc = thisRef.process ?? {};
+  let argv = proc.argv ?? [];
   let env = proc.env ?? {};
   let colorLevel = LEVEL_UNDEFINED;
 
-  if (isDeno) {
-    try {
-      // Deno requires the permission for the access to env, use the `--allow-env` flag: deno run --allow-env ./app.js
-      env = env.toObject();
-    } catch (e) {
-      // Deno: if interactive permission is not granted, do nothing, no colors
-      colorLevel = LEVEL_BW;
-    }
+  try {
+    // keys(env) triggers a Deno permission request; throws if access is denied
+    // stringify environment variable keys to check for specific ones using a RegExp
+    envKeys = separator + keys(env).join(separator);
+  } catch (error) {
+    // if the permission is not granted, environment variables have no effect, even variables like FORCE_COLOR will be ignored
+    // env now points to a new empty object to avoid Deno requests for every env access in code below
+    env = {};
+    colorLevel = LEVEL_BW;
   }
 
   // PM2 does not set process.stdout.isTTY, but colors may be supported (depends on actual terminal)
@@ -141,7 +141,7 @@ export const getLevel = (mockThis) => {
   // runtime values supported colors: `nodejs`, `edge`, `experimental-edge`
 
   // whether the output is supported
-  let isTTY = isPM2 || env.NEXT_RUNTIME?.includes('edge') || (isDeno ? Deno.isatty(1) : !!proc.stdout?.isTTY);
+  let isTTY = isPM2 || env.NEXT_RUNTIME?.includes('edge') || !!proc.stdout?.isTTY;
 
   // enforce a specific color support:
   // FORCE_COLOR=false   // disables colors
@@ -160,7 +160,7 @@ export const getLevel = (mockThis) => {
   let forceColorValue = env[FORCE_COLOR];
 
   // mapping FORCE_COLOR values to color level values
-  let forceLevel = {
+  let forcedLevel = {
     false: LEVEL_BW,
     0: LEVEL_BW,
     1: LEVEL_16COLORS,
@@ -169,25 +169,29 @@ export const getLevel = (mockThis) => {
   }[forceColorValue] ?? LEVEL_UNDEFINED;
 
   // if FORCE_COLOR is present and is neither 'false' nor '0', OR has one of the flags: --color --color=true --color=always
-  let isForceEnabled = (FORCE_COLOR in env && forceLevel) || hasFlag(/^--color=?(true|always)?$/);
+  let isForced = (FORCE_COLOR in env && forcedLevel) || hasFlag(/^--color=?(true|always)?$/);
 
-  if (isForceEnabled) colorLevel = forceLevel;
+  if (isForced) colorLevel = forcedLevel;
 
   // if colorLevel === LEVEL_UNDEFINED, attempt to detect color level, returns 0, 1, 2 or 3
-  if (!~colorLevel) colorLevel = detectColors(env, isTTY, (isDeno ? Deno.build.os : proc.platform) === 'win32');
+  if (!~colorLevel) colorLevel = autoDetectLevel(env, isTTY, proc.platform === 'win32');
 
   // if force disabled: FORCE_COLOR=0 or FORCE_COLOR=false
-  if (!forceLevel
+  if (!forcedLevel
     || !!env.NO_COLOR
     // --no-color --color=false --color=never
     || hasFlag(/^--(no-color|color=(false|never))$/)) return LEVEL_BW;
 
   // Detect browser support
-  if (!!_this.window?.chrome) return LEVEL_TRUECOLOR;
+  if (!!thisRef.window?.chrome) return LEVEL_TRUECOLOR;
 
   // API Rule: If color output is force enabled but the color level is detected as B&W (e.g., TERM is dumb),
   // enable truecolor since color depth support does not matter.
 
   // Optimisation: `!colorLevel` is equivalent to `colorLevel === LEVEL_BW`
-  return isForceEnabled && !colorLevel ? LEVEL_TRUECOLOR : colorLevel;
+  //return isForced && !colorLevel ? LEVEL_TRUECOLOR : colorLevel;
+
+  // If color output is forced but the environment doesn't support it, allow truecolor anyway,
+  // for example, when saving CLI output snapshots to a file.
+  return isForced && !colorLevel ? LEVEL_TRUECOLOR : colorLevel;
 };

src/color-support.js

@@ -0,0 +1,25 @@
+import { assertEquals } from 'https://deno.land/std/assert/mod.ts';
+
+// import env variables to simulate ANSI 256 color space
+import '../../test/env/ansi256-colors.js';
+
+//import ansis, { hex, fg } from '../../src/index.mjs'; // for debugging only
+import ansis, { hex, fg } from 'ansis';
+
+Deno.test('isSupported()', () => {
+  const received = ansis.isSupported();
+  const expected = true;
+  assertEquals(received, expected);
+});
+
+Deno.test('ansi 256', () => {
+  const received = fg(40)`foo`;
+  const expected = '\x1b[38;5;40mfoo\x1b[39m';
+  assertEquals(received, expected);
+});
+
+Deno.test('fallback to 256', () => {
+  const received = hex('#00c200')`foo`;
+  const expected = '\x1b[38;5;40mfoo\x1b[39m';
+  assertEquals(received, expected);
+});

test-deno/cases/ansi256.test.js

@@ -0,0 +1,22 @@
+import { assertEquals } from 'https://deno.land/std/assert/mod.ts';
+
+// NOTE:
+// Test it with the `--allow-env` flag
+
+// import env variables to simulate no color, it works only with `--allow-env` flag
+import '../../test/env/no-color.js';
+
+//import ansis, { hex } from '../../src/index.mjs';
+import ansis, { hex } from 'ansis';
+
+Deno.test('isSupported()', () => {
+  const received = ansis.isSupported();
+  const expected = false;
+  assertEquals(received, expected);
+});
+
+Deno.test('no color', () => {
+  const received = hex('#00c200')`foo`;
+  const expected = 'foo';
+  assertEquals(received, expected);
+});

test-deno/cases/nocolor.test.js

@@ -0,0 +1,19 @@
+import { assertEquals } from 'https://deno.land/std/assert/mod.ts';
+
+// import env variables to simulate ANSI 256 color space
+import '../../test/env/truecolor.js';
+
+//import ansis, { hex} from '../../src/index.mjs'; // for debugging only
+import ansis, { hex } from 'ansis';
+
+Deno.test('isSupported()', () => {
+  const received = ansis.isSupported();
+  const expected = true;
+  assertEquals(received, expected);
+});
+
+Deno.test('truecolor', () => {
+  const received = hex('#00c200')`foo`;
+  const expected = '\x1b[38;2;0;194;0mfoo\x1b[39m';
+  assertEquals(received, expected);
+});

test-deno/cases/truecolor.test.js

@@ -0,0 +1,8 @@
+// NOTE:
+// Test it w/o the `--allow-env` flag to simulate deny permissions,
+// that should leads to no color output.
+
+import ansis, { hex } from '../../src/index.mjs';
+//import ansis, { hex } from 'ansis';
+
+console.log(hex('#a167fa')('\n>> Deno color output\n'));